Clauza RETURNING permite instrucțiunilor INSERT, UPDATE și DELETE să returneze date despre rândurile pe care le-au afectat — cel mai des ID-ul generat automat după o inserare, dar și orice coloane sau valori calculate. Economisește o interogare separată și este o caracteristică convenabilă a PostgreSQL.
-- 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
Celul mai frecvent caz de utilizare: după o inserare, de obicei aveți nevoie de cheia primară generată (pentru a o folosi în inserări asociate sau pentru a o returna clientului). RETURNING id o returnează direct — fără nevoie de o interogare separată.
-- 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 funcționează pe UPDATE (vedeți valorile noi) și DELETE (capturați ce a fost șters — util pentru arhivare sau confirmare).
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
Clauza RETURNING este o caracteristică convenabilă și frecvent utilizată a PostgreSQL care este valoroasă pentru eficiență și corectitudine la modificarea datelor.
Utilizarea sa cea mai comună și importantă este obținerea ID-ului generat automat înapoi dintr-o INSERT — o nevoie aproape universală (aproape întotdeauna doriți cheia primară nouă după o inserare, pentru a o folosi în operații asociate sau pentru a o returna aplicației), iar RETURNING id o furnizează direct într-o singură instrucțiune.
Fără RETURNING, ați avea nevoie de o SELECT separată pentru a obține ID-ul generat, ceea ce înseamnă un transport suplimentar și o potențială condiție de cursă (SELECT-ul separat poate să nu recupereze în mod fiabil rândul dvs. specific în scenarii concurente), deci RETURNING este atât mai eficient, cât și mai corect.
Dincolo de inserări, RETURNING funcționează cu UPDATE (observând valorile noi după o actualizare) și DELETE (capturând ce a fost șters — util pentru arhivare, înregistrare sau confirmare a ștergerii).
Combinată cu CTE-uri, permite modele puternice precum inserarea în tabele asociate folosind ID-ul returnat într-o singură instrucțiune.
Deoarece obținerea valorilor generate (în special ID-uri) după modificări de date este o nevoie constantă, și deoarece RETURNING furnizează acest lucru eficient și atomic (evitând interogări suplimentare și condiții de cursă), înțelegerea clauzei RETURNING este cunoștințe PostgreSQL valoroase și frecvent aplicate care face codul de modificare a datelor mai curat, mai eficient și mai corect — o conveniență practică care este utilizată în mod obișnuit în aplicațiile reale care lucrează cu Postgres, în special pentru necesitatea omniprezentă de recuperare a ID-urilor generate după inserări.