Setningen RETURNING lar INSERT-, UPDATE- og DELETE-setninger returnere data om radene de påvirket — oftest den autogenererte ID-en etter et insert, men også andre kolonner eller beregnede verdier. Det sparer en egen spørring og er en praktisk PostgreSQL-funksjonalitet.
-- 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
Den vanligste bruken: etter et insert trenger du vanligvis den genererte primærnøkkelen (for å bruke i relaterte inserts eller returnere til klienten). RETURNING id gir den direkte tilbake — ingen behov for en egen spørring.
-- 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 fungerer på UPDATE (se de nye verdiene) og DELETE (hent det som ble fjernet — nyttig for arkivering eller bekrefting).
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
RETURNING-setningen er en praktisk, hyppig brukt PostgreSQL-funksjonalitet som er verdifull for effektivitet og korrekthet når du endrer data.
Den mest vanlige og viktige bruken er å få auto-generert ID tilbake fra et INSERT — et nesten universelt behov (du vil nesten alltid ha den nye primærnøkkelen etter et insert, for å bruke i relaterte operasjoner eller returnere til applikasjonen), og RETURNING id gir den direkte i én setning.
Uten RETURNING ville du trenge en egen SELECT for å hente den genererte ID-en, noe som betyr en ekstra rundtur og en potensiell race condition (den separate SELECT-en kan kanskje ikke pålitelig hente din spesifikke rad i parallelle scenarier), så RETURNING er både mer effektiv og mer korrekt.
/*/*Utover inserts fungerer RETURNING med UPDATE (se de nye verdiene etter en oppdatering) og DELETE (hent det som ble fjernet — nyttig for arkivering, logging eller bekrefting av slettinger).
I kombinasjon med CTE-er gjør det mulige kraftige mønster som å insert i relaterte tabeller ved å bruke den returnerte ID-en i en enkelt setning.
Siden det å få genererte verdier (spesielt ID-er) etter dataendringer er et konstant behov, og siden RETURNING gir dette effektivt og atomart (og unngår ekstra spørringer og race conditions), er forståelsen av RETURNING-setningen verdifull, hyppig brukt PostgreSQL-kunnskap som gjør datamodifiseringskode renere, mer effektiv og mer korrekt — en praktisk funksjonalitet som brukes rutinemessig i virkelige applikasjoner som arbeider med Postgres, spesielt for det allestedsnærværende behovet for å hente genererte ID-er etter inserts.