Menu

PostgreSQL RETURNING: INSERT, UPDATE ve DELETE

RETURNING, INSERT, UPDATE, DELETE ve MERGE komutlarının değiştirdikleri satırları geri vermesini sağlar: üretilen id'ler, yeni değerler, silinen satırlar ve MERGE'ün hangi işlemi yaptığı.

Bu sayfada çalıştırılabilir editörler var. Düzenle, çalıştır ve sonucu anında gör.

RETURNING, veriyi değiştiren bir komutun bir SELECT gibi satır döndürmesini sağlar. Onu bir INSERT, UPDATE, DELETE ya da (PostgreSQL 17'den beri) MERGE komutunun sonuna ekle ve ardından istediğin sütunları ya da ifadeleri yaz: INSERT INTO users (email) VALUES ('ada@example.com') RETURNING id;.

İki yeni satır da PostgreSQL'in ürettiği id'lerle ve varsayılan değeriyle doldurulmuş plan sütunuyla geri gelir; ikinci bir sorguya gerek kalmaz.

Eklenen satırın id'sini alma

Üretilen bir anahtarı almanın standart yolu RETURNING id'dir. Satırı saklandığı hâliyle bildirir, bu yüzden identity sütunları, serial, UUID varsayılanları ve bir BEFORE tetikleyicisinin atadığı değerlerle çalışır. Çok satırlı bir VALUES ya da INSERT ... SELECT, eklenen her satır için bir satır döndürür.

Sürücüler bunu herhangi bir sorgu sonucu gibi okur: Python'da psycopg ile cursor.fetchone(), Node.js'te pg ile result.rows. Keşfederken RETURNING * yeterli; uygulama kodunda ise sütunları tek tek yaz ki tablo değiştiğinde sonuç sabit kalsın.

UPDATE'in neyi değiştirdiğini görme

Bir UPDATE komutunda RETURNING satırları değişiklikten sonraki hâliyle gösterir ve yalnızca WHERE ile eşleşen satırları döndürür:

İki satır döner: 16.5 ile Book ve 33 ile Lamp. Pen'e dokunulmadığı için sonuçta yer almaz.

PostgreSQL 17'de RETURNING sadece yeni değerleri görür. PostgreSQL 18 old ve new ekliyor (RETURNING old.price, new.price). 17'de tabloyu kendisinin kilitlenmiş bir kopyasıyla birleştir:

Her satır önceki ve sonraki fiyatıyla döner: 10 ve 15, 20 ve 25.

DELETE'in sildiği satırları döndürme

DELETE ... RETURNING sildiği satırları sana verir; kayıt tutmak, geri almak ya da bir worker'ın bir işi silip verisini geri aldığı bir iş kuyruğu için. Bir WITH sorgusunun içinde dönen satırlar sonraki komutu besler, böylece satırlar tek bir komutla tablolar arasında taşınır:

1 ve 3 numaralı görevler tasks tablosundan çıkar ve done_tasks tablosuna girer. Bu tek bir komut olduğu için hiçbir oturum onları iki tabloda birden ya da hiçbirinde görmez.

MERGE'ün hangi işlemi yaptığını öğrenme

PostgreSQL 17'den beri MERGE, RETURNING kabul eder ve merge_action() fonksiyonu her satır için INSERT, UPDATE ya da DELETE döndürür:

A-100 7'ye güncellendi, C-300 ise 4 ile eklendi. Eşzamanlı yazmalar altında anahtara göre ekle ya da güncelle işi için, RETURNING'i de destekleyen ON CONFLICT ile upsert yöntemini tercih et.

RETURNING neler içerebilir

Bir SELECT listesinin içerebildiği her şeyi: sütunlar, *, ifadeler, fonksiyon çağrıları ve takma adlar (RETURNING price * qty AS total); yalnızca aggregate'ler hariç. Dönen satırları saymak ya da toplamak için komutu bir WITH sorgusuna sar ve dıştaki SELECT içinde aggregate kullan.

ON CONFLICT DO NOTHING tarafından ya da NULL döndüren bir BEFORE tetikleyicisi tarafından atlanan satırlar döndürülmez.

Sıkça Sorulan Sorular

PostgreSQL'de az önce eklediğim satırın id'sini nasıl alırım?

INSERT komutuna RETURNING id ekle. Eklenen her satır için üretilen değeri aynı istek içinde döndürür; bu SELECT max(id) kullanmaktan daha güvenlidir ve identity sütunları, serial ve gen_random_uuid() gibi varsayılanlarla çalışır.

RETURNING ayrı bir SELECT'ten daha mı hızlı?

Genelde evet. İkinci bir komuttan ve sunucuya ikinci bir gidiş dönüşten kurtarır, ayrıca komutun dokunduğu satırları tam olarak döndürür; arada başka bir oturumun onları değiştirmesine fırsat kalmaz.

MySQL RETURNING destekliyor mu?

MySQL'de RETURNING cümlesi yoktur; bunun yerine insert sonrasında LAST_INSERT_ID() okunur. SQLite ise 3.35 sürümünden beri RETURNING destekliyor.

Coddy programlama dilleri çizimi

Coddy ile kodlamayı öğren

Başla