RETURNING cümlesi INSERT, UPDATE ve DELETE ifadelerinin etkiledikleri satırlar hakkında veri döndürmesine izin verir — en sık olarak bir ekleme sonrası otomatik olarak oluşturulan ID, ancak aynı zamanda herhangi bir sütun veya hesaplanan değer. Ayrı bir sorguyu kaydeder ve PostgreSQL'in kullanışlı bir özelliğidir.
-- get the auto-generated id back from the insert (no separate SELECT needed)
INSERT INTO users (name, email) VALUES ('Ann', '[email protected]')
RETURNING id; -- returns the new id
-- return multiple columns or all of them
INSERT INTO users (name) VALUES ('Bob')
RETURNING id, name, created_at; -- including DB-generated values
INSERT INTO users (name) VALUES ('Carol') RETURNING *; -- the whole row
En yaygın kullanım: ekledikten sonra, genellikle oluşturulan birincil anahtara ihtiyacınız vardır (ilgili ekleme işlemlerinde veya istemciye geri dönmek için). RETURNING id bunu doğrudan geri verir — ayrı bir sorguya gerek yok.
-- see what was updated
UPDATE products SET price = price * 1.1 WHERE category = 'books'
RETURNING id, name, price; -- the NEW values after the update
-- capture deleted rows (e.g. for archiving/logging)
DELETE FROM sessions WHERE expired = true
RETURNING id, user_id; -- which rows were deleted
RETURNING, UPDATE üzerinde (yeni değerleri görmek için) ve DELETE üzerinde (kaldırılanı yakalamak için — arşivleme veya onaylama için kullanışlı) çalışır.
Without RETURNING:
INSERT ...; then a separate SELECT to get the id → TWO round-trips, and a potential
race (the SELECT might not reliably get YOUR row).
With RETURNING:
one statement returns the affected data atomically → fewer round-trips, no race.
-- use a CTE with RETURNING to insert and use the id in the same statement
WITH new_user AS (
INSERT INTO users (name) VALUES ('Ann') RETURNING id
)
INSERT INTO profiles (user_id, bio)
SELECT id, 'Hello' FROM new_user; -- use the returned id directly
RETURNING cümlesi, verileri değiştirirken verimlilik ve doğruluk için değerli olan, kullanışlı ve sık kullanılan bir PostgreSQL özelliğidir.
En yaygın ve önemli kullanımı bir INSERT'ten otomatik olarak oluşturulan ID'yi geri almaktır — neredeyse evrensel bir ihtiyaç (ekleme sonrası neredeyse her zaman yeni birincil anahtarı istiyorsunuz, bunu ilgili işlemlerde kullanmak veya uygulamaya döndürmek için), ve RETURNING id bunu doğrudan tek bir ifadede sağlar.
RETURNING olmadan, oluşturulan ID'yi almak için ayrı bir SELECT gerekli olurdu, bu da bir ekstra tur ve potansiyel bir yarış durumu (ayrı SELECT, eşzamanlı senaryolarda özel satırınızı güvenilir bir şekilde almayabilir) anlamına gelir, bu nedenle RETURNING hem daha verimli hem de daha doğrudur.
Eklemelerin ötesinde, RETURNING UPDATE (bir güncellemeden sonra yeni değerleri görmek) ve DELETE (arşivleme, günlüğe kaydetme veya silmeleri onaylamak için yararlı olan kaldırılanı yakalamak) ile çalışır.
CTE'ler ile birleştirildiğinde, döndürülen ID'yi tek bir ifadede kullanarak ilgili tablolara ekleme gibi güçlü desenleri etkinleştirir.
Veri değişikliklerinden sonra oluşturulan değerleri (özellikle ID'leri) almak sabit bir ihtiyaç olduğundan ve RETURNING bunu verimli ve atomik bir şekilde (ekstra sorguları ve yarış durumlarını önleyen) sağladığından, RETURNING cümlesini anlamak değerli, sık uygulanan PostgreSQL bilgisidir — veri değişikliği kodunu daha temiz, daha verimli ve daha doğru hale getiren pratik bir kolaylık; bu, Postgres ile çalışan gerçek uygulamalarda rutin olarak kullanılır, özellikle de ekleme işlemlerinden sonra oluşturulan ID'leri alma konusundaki her yerde bulunur.