Menu

RETURNING PostgreSQL untuk INSERT, UPDATE, dan DELETE

RETURNING membuat INSERT, UPDATE, DELETE, dan MERGE mengembalikan baris yang diubahnya: id yang dibuat, nilai baru, baris yang dihapus, dan aksi MERGE mana yang dijalankan.

Halaman ini dilengkapi editor yang bisa dijalankan. Edit, jalankan, dan lihat output-nya seketika.

RETURNING membuat pernyataan yang mengubah data mengembalikan baris, seperti SELECT. Tambahkan di akhir INSERT, UPDATE, DELETE, atau (sejak PostgreSQL 17) MERGE, diikuti kolom atau ekspresi yang kamu inginkan: INSERT INTO users (email) VALUES ('ada@example.com') RETURNING id;.

Kedua baris baru kembali dengan id yang dibuat PostgreSQL dan plan yang diisi oleh default-nya, tanpa query kedua.

Mendapatkan id baris yang dimasukkan

RETURNING id adalah cara standar untuk mendapatkan key yang dibuat otomatis. Klausa ini melaporkan baris persis seperti yang disimpan, jadi berjalan untuk kolom identity, serial, default UUID, dan nilai yang diatur oleh trigger BEFORE. VALUES dengan banyak baris atau INSERT ... SELECT mengembalikan satu baris per baris yang dimasukkan.

Driver membacanya seperti hasil query biasa: cursor.fetchone() di Python dengan psycopg, result.rows di Node.js dengan pg. RETURNING * tidak masalah saat bereksplorasi; di kode aplikasi, tulis daftar kolomnya supaya hasilnya tetap stabil saat tabel berubah.

Melihat apa yang diubah UPDATE

Pada UPDATE, RETURNING menampilkan baris setelah perubahan, dan hanya baris yang cocok dengan WHERE:

Dua baris kembali, Book dengan harga 16.5 dan Lamp dengan 33. Pen tidak disentuh, jadi tidak ada di hasil.

Di PostgreSQL 17, RETURNING hanya melihat nilai baru. PostgreSQL 18 menambahkan old dan new (RETURNING old.price, new.price). Di versi 17, join tabel ke salinan dirinya sendiri yang dikunci:

Setiap baris kembali dengan harga sebelum dan sesudahnya: 10 dan 15, 20 dan 25.

Mengembalikan baris yang dihapus DELETE

DELETE ... RETURNING memberimu baris yang dihapusnya, untuk logging, untuk undo, atau untuk job queue tempat worker menghapus sebuah job dan mendapatkan datanya kembali. Di dalam query WITH, baris yang dikembalikan menjadi input pernyataan berikutnya, sehingga baris bisa dipindahkan antartabel dalam satu pernyataan:

Tugas 1 dan 3 keluar dari tasks dan masuk ke done_tasks. Ini satu pernyataan, jadi tidak ada sesi lain yang melihatnya ada di kedua tabel atau tidak ada di keduanya.

Mengetahui aksi yang diambil MERGE

Sejak PostgreSQL 17, MERGE menerima RETURNING, dan fungsi merge_action() mengembalikan INSERT, UPDATE, atau DELETE untuk setiap baris:

A-100 diperbarui menjadi 7 dan C-300 dimasukkan dengan 4. Untuk insert-atau-update berdasarkan kunci dengan penulisan bersamaan, utamakan upsert dengan ON CONFLICT, yang juga mendukung RETURNING.

Apa saja yang bisa ada di RETURNING

Apa pun yang bisa ada di daftar SELECT: kolom, *, ekspresi, pemanggilan fungsi, dan alias (RETURNING price * qty AS total), kecuali agregat. Untuk menghitung atau menjumlahkan baris yang dikembalikan, bungkus pernyataannya dalam query WITH dan lakukan agregasi di SELECT luar.

Baris yang dilewati oleh ON CONFLICT DO NOTHING, atau oleh trigger BEFORE yang mengembalikan NULL, tidak dikembalikan.

Pertanyaan yang sering diajukan

Bagaimana cara mendapatkan id baris yang baru saja dimasukkan di PostgreSQL?

Tambahkan RETURNING id ke INSERT. Klausa ini mengembalikan nilai yang dibuat untuk setiap baris yang dimasukkan dalam satu kali bolak-balik, lebih aman daripada SELECT max(id), dan berjalan untuk kolom identity, serial, serta default seperti gen_random_uuid().

Apakah RETURNING lebih cepat daripada SELECT terpisah?

Biasanya ya. Klausa ini menghemat satu pernyataan dan satu kali bolak-balik ke server, dan mengembalikan tepat baris yang disentuh pernyataan itu, tanpa celah bagi sesi lain untuk mengubahnya di antaranya.

Apakah MySQL mendukung RETURNING?

MySQL tidak punya klausa RETURNING; sebagai gantinya kamu membaca LAST_INSERT_ID() setelah insert. SQLite mendukung RETURNING sejak versi 3.35.

Ilustrasi bahasa pemrograman di Coddy

Belajar coding dengan Coddy

Mulai