Klausa RETURNING memungkinkan pernyataan INSERT, UPDATE, dan DELETE mengembalikan data tentang baris yang mereka pengaruhi — paling umum ID yang dihasilkan secara otomatis setelah insert, tetapi juga kolom atau nilai yang dihitung apa pun. Ini menghemat query terpisah dan merupakan fitur PostgreSQL yang nyaman.
-- 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
Penggunaan paling umum: setelah menyisipkan, Anda biasanya memerlukan kunci utama yang dihasilkan (untuk digunakan dalam insert terkait atau dikembalikan ke klien). RETURNING id memberikannya kembali secara langsung — tidak perlu query terpisah.
-- 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 bekerja pada UPDATE (lihat nilai baru) dan DELETE (tangkap apa yang dihapus — berguna untuk pengarsipan atau konfirmasi).
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
Klausa RETURNING adalah fitur PostgreSQL yang nyaman dan sering digunakan yang berharga untuk efisiensi dan kebenaran saat memodifikasi data.
Penggunaan paling umum dan penting adalah mendapatkan ID yang dihasilkan secara otomatis kembali dari INSERT — kebutuhan yang hampir universal (Anda hampir selalu menginginkan kunci utama baru setelah menyisipkan, untuk digunakan dalam operasi terkait atau dikembalikan ke aplikasi), dan RETURNING id menyediakannya secara langsung dalam satu pernyataan.
Tanpa RETURNING, Anda akan membutuhkan SELECT terpisah untuk mendapatkan ID yang dihasilkan, yang berarti putaran perjalanan ekstra dan potensi kondisi balapan (SELECT terpisah mungkin tidak dapat diandalkan mengambil baris spesifik Anda dalam skenario bersamaan), jadi RETURNING lebih efisien dan lebih benar.
Selain insert, RETURNING bekerja dengan UPDATE (melihat nilai baru setelah update) dan DELETE (menangkap apa yang dihapus — berguna untuk pengarsipan, logging, atau konfirmasi penghapusan).
Digabungkan dengan CTE, ini memungkinkan pola canggih seperti memasukkan ke tabel terkait menggunakan ID yang dikembalikan dalam satu pernyataan.
Karena mendapatkan nilai yang dihasilkan (terutama ID) setelah modifikasi data adalah kebutuhan yang konstan, dan karena RETURNING menyediakan ini secara efisien dan atomis (menghindari query ekstra dan kondisi balapan), memahami klausa RETURNING adalah pengetahuan PostgreSQL yang berharga dan sering diterapkan yang membuat kode modifikasi data lebih bersih, lebih efisien, dan lebih benar — kenyamanan praktis yang digunakan secara rutin dalam aplikasi nyata yang bekerja dengan Postgres, khususnya untuk kebutuhan yang ada di mana-mana dalam mengambil ID yang dihasilkan setelah insert.