Klausa RETURNING membolehkan pernyataan INSERT, UPDATE, dan DELETE mengembalikan data tentang baris yang dipengaruhinya — paling lazim ID yang dijana secara automatik selepas sisipan, tetapi juga mana-mana lajur atau nilai terkira. Ia menjimatkan pertanyaan berasingan dan merupakan ciri PostgreSQL yang mudah.
-- 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 lazim: selepas menyisip, anda biasanya memerlukan kunci primer yang dijana (untuk digunakan dalam sisipan berkaitan atau dikembalikan kepada klien). RETURNING id mengembalikannya secara langsung — tanpa perlukan pertanyaan berasingan.
-- 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 berfungsi pada UPDATE (lihat nilai baharu) dan DELETE (tangkap apa yang dibuang — berguna untuk pengarkiban atau pengesahan).
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 ialah ciri PostgreSQL yang mudah dan kerap digunakan yang bernilai untuk kecekapan dan ketepatan apabila mengubah suai data.
Penggunaan paling lazim dan pentingnya ialah mendapatkan ID yang dijana secara automatik semula daripada INSERT — keperluan yang hampir universal (anda hampir selalu mahukan kunci primer baharu selepas menyisip, untuk digunakan dalam operasi berkaitan atau dikembalikan kepada aplikasi), dan RETURNING id menyediakannya secara langsung dalam satu pernyataan.
Tanpa RETURNING, anda akan memerlukan SELECT berasingan untuk mendapatkan ID yang dijana, yang bermakna round-trip tambahan dan race condition berpotensi (SELECT berasingan mungkin tidak mengambil baris khusus anda dengan boleh dipercayai dalam senario serentak), jadi RETURNING adalah lebih cekap dan lebih betul.
Di luar sisipan, RETURNING berfungsi dengan UPDATE (melihat nilai baharu selepas kemas kini) dan DELETE (menangkap apa yang dibuang — berguna untuk pengarkiban, pengelogan, atau pengesahan pemadaman).
Digabungkan dengan CTE, ia membolehkan corak berkuasa seperti menyisip ke dalam jadual berkaitan menggunakan ID yang dikembalikan dalam satu pernyataan.
Memandangkan mendapatkan nilai yang dijana (terutamanya ID) selepas pengubahsuaian data ialah keperluan berterusan, dan memandangkan RETURNING menyediakan ini dengan cekap dan atomik (mengelakkan pertanyaan tambahan dan race condition), memahami klausa RETURNING ialah pengetahuan PostgreSQL yang bernilai dan kerap digunakan yang menjadikan kod pengubahsuaian data lebih bersih, lebih cekap, dan lebih betul — kemudahan praktikal yang digunakan secara rutin dalam aplikasi sebenar yang bekerja dengan Postgres, terutamanya untuk keperluan menyeluruh mendapatkan ID yang dijana selepas sisipan.