Klavuzula RETURNING omogoča stavkom INSERT, UPDATE in DELETE, da vrnejo podatke o vrsticah, ki jih spremenijo — najpogosteje samodejno generiran ID po vstavljanju, vendar tudi katere koli stolpce ali izračunane vrednosti. Prihrani ločeno poizvedbo in je priročna PostgreSQL-ova funkcionalnost.
-- 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
Najpogostejša uporaba: po vstavljanju vam ponavadi trebate generirani primarni ključ (za uporabo pri povezanih vstavljanjih ali vrnitev odjemalcu). RETURNING id vam ga vrne direktno — ni potrebna ločena poizvedba.
-- 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 deluje pri UPDATE (vidite nove vrednosti) in DELETE (zajemite odstranjena podatka — uporabno za arhiviranje ali potrditev).
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
Klavuzula RETURNING je priročna, pogosto uporabljena PostgreSQL-ova funkcionalnost, ki je vredna za učinkovitost in pravilnost pri spreminjanju podatkov.
Njena najpogostejša in najpomembnejša uporaba je pridobitev samodejno generiranega ID-ja nazaj iz INSERT — skoraj univerzalna potreba (skoraj vedno želite nov primarni ključ po vstavljanju, da ga uporabite v povezanih operacijah ali vrnete aplikaciji), in RETURNING id vam ga neposredno zagotovi v enem stavku.
Brez RETURNING bi potrebovali ločen SELECT za pridobitev generiranega ID-ja, kar pomeni dodatno potovanje in potencialno stanje tekmovanja (ločen SELECT morda ne bo zanesljivo pridobil vaše specifične vrstice v sočasnih scenarijih), zato je RETURNING hkrati bolj učinkovit in bolj pravilen.
Poleg vstavljanj RETURNING deluje z UPDATE (prikaz novih vrednosti po posodobitvi) in DELETE (zajemanje tega, kar je bilo odstranjeno — uporabno za arhiviranje, beleženje ali potrditev brisanja).
V kombinaciji s CTE-ji omogoča zmogljive vzorce, kot je vstavljanje v povezane tabele z uporabo vrnjene ID-je v enem stavku.
Ker je pridobivanje generiranih vrednosti (posebej ID-jev) po spremembah podatkov konstanta potreba, in ker RETURNING to zagotavlja učinkovito in atomično (se izognemo dodatnim poizvedbam in stanjem tekmovanja), je razumevanje klavuzule RETURNING dragoceno, pogosto uporabljano PostgreSQL-ovo znanje, ki naredi kodo za spreminjanje podatkov čistejšo, bolj učinkovito in bolj pravilno — praktično priročnost, ki se rutinsko uporablja v pravých aplikacijah, ki delajo s Postgres-om, posebej za ubikvitozno potrebo po pridobivanju generiranih ID-jev po vstavljanjih.