Klauzula RETURNING omogućava INSERT, UPDATE i DELETE naredbama vraćanje podataka o redcima koje su utjecale — najčešće automatski generirani ID nakon unosa, ali i bilo koji stupci ili izračunate vrijednosti. Štedi odvojena upita i praktična je PostgreSQL značajka.
-- 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
Najčešća upotreba: nakon umetanja, obično trebate generirani primarni ključ (za korištenje u povezanim unoscima ili vraćanje klijentu). RETURNING id vraća ga izravno — nema potrebe za odvojenim upitom.
-- 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 funkcionira s UPDATE (vidi nove vrijednosti) i DELETE (uhvati što je uklonjeno — korisno za arhiviranje ili potvrdu).
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 praktična je, često korištena PostgreSQL značajka koja je vrijedna za efikasnost i ispravnost pri izmjeni podataka.
Njena najčešća i najvažnija upotreba je vraćanje automatski generiranog ID-a iz INSERT-a — gotovo univerzalna potreba (gotovo uvijek trebate novi primarni ključ nakon unosa, za korištenje u povezanim operacijama ili vraćanje aplikaciji), a RETURNING id pruža ga izravno u jednoj naredbi.
Bez RETURNING, trebali biste odvojena SELECT upita da dobijete generirani ID, što znači dodatnu komunikaciju i potencijalni race condition (odvojeni SELECT možda neće pouzdano dohvatiti vaš specifičan redak u konkurentnim scenarijima), pa je RETURNING i efikasniji i ispravniji.
Osim umetanja, RETURNING funkcionira s UPDATE (vidi nove vrijednosti nakon ažuriranja) i DELETE (uhvata što je uklonjeno — korisno za arhiviranje, logiranje ili potvrdu brisanja).
U kombinaciji s CTE-ima, omogućava moćne muhure kao što je unos u povezane tablice koristeći vraćeni ID u jednoj naredbi.
Budući da je dobivanje generiranih vrijednosti (posebno ID-eva) nakon izmjene podataka stalna potreba, a budući da RETURNING pruža to efikasno i atomički (izbjegavajući dodatne upite i race conditions), razumijevanje klauzule RETURNING je vrijedna, često primijenjena PostgreSQL znanja koja čini kod izmjene podataka čišćim, efikasnijim i ispravnijim — praktična pogodnost koja se rutinski koristi u stvarnim aplikacijama koje rade s Postgre-om, posebno za sveprisutnu potrebu dohvaćanja generiranih ID-eva nakon umetanja.