Klauzula RETURNING i lejon deklaratave INSERT, UPDATE, dhe DELETE të kthejnë të dhëna në lidhje me rreshtat që ata ndikuan — më shpesh ID-në e gjeneruar automatikisht pas një futjeje, por edhe çdo kolonë ose vlerë të llogaritur. Kjo kursen një pyetje të veçantë dhe është një veçori praktike e PostgreSQL-it.
-- 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
Përdorimi më i zakonshëm: pas futjes, zakonisht ju duhet çelësi primar i gjeneruar (për t'u përdorur në futjet e lidhura ose për t'u kthyer klientit). RETURNING id e kthen atë direkt — nuk ka nevojë për një pyetje të veçantë.
-- 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 funksionon në UPDATE (shihni vlerat e reja) dhe DELETE (kap atë që u hiq — e dobishme për arkivim ose konfirmim).
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
Klauzula RETURNING është një veçori praktike dhe shpesh e përdorur e PostgreSQL-it që është e vlefshme për efikasitetin dhe korrektësinë kur modifikoni të dhëna.
Përdorimi i tij më i zakonshëm dhe më i rëndësishëm është marrja e ID-së e gjeneruar automatikisht përsëri nga një INSERT — një nevojë pothuajse universale (pothuajse gjithmonë dëshironi çelësin primar të ri pas futjes, për ta përdorur në operacione të lidhura ose për ta kthyer në aplikacion), dhe RETURNING id e sigurohet atë direkt në një deklaratë.
Pa RETURNING, do t'ju duhet një SELECT i veçantë për të marrë ID-në e gjeneruar, që do të thotë një rrugë shtesë dhe një potencial garer kushti (SELECT-i i veçantë mund të mos marrë në mënyrë të besueshme rreshtin tuaj specifik në skenarë konkurrues), kështu që RETURNING është edhe më i efektshëm edhe më i saktë.
Pas futjeve, RETURNING funksionon me UPDATE (shihni vlerat e reja pas një ažurimi) dhe DELETE (kap atë që u hiq — e dobishme për arkivim, regjistrimin, ose konfirmimin e fshirjeve).
E kombinuar me CTE-t, ajo mundëson modele të fuqishme si futje në tabela të lidhura duke përdorur ID-në e kthyer në një deklaratë të vetme.
Meqenëse marrja e vlerave të gjeneruara (veçanërisht ID-ve) pas modifikimeve të të dhënave është një nevojë konstante, dhe meqenëse RETURNING e siguron këtë në mënyrë efikase dhe atomike (duke shmangur pyetje shtesë dhe garuesit e kushteve), kuptimi i klauzulës RETURNING është njohurit e vlefshme, shpesh të aplikuara PostgreSQL që e bënë kodin e modifikimit të të dhënave më të pastër, më efikase dhe më të saktë — një konvenijencë praktike që përdoret rregullisht në aplikacione reale që punojnë me Postgres, veçanërisht për nevojën omniprezente të marrjes sëpali ID-ve të gjeneruar pas futjeve.