RETURNING-klausulen lader INSERT-, UPDATE- og DELETE-sætninger returnere data om de rækker, de påvirkede — mest almindeligt det auto-genererede ID efter en indsættelse, men også eventuelle kolonner eller beregnede værdier. Det sparer en separat forespørgsel og er en praktisk PostgreSQL-funktion.
-- 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 mest almindelige brug: efter indsættelse har du normalt brug for den genererede primærnøgle (til brug i relaterede indsættelser eller at returnere til klienten). RETURNING id giver den tilbage direkte — ingen grund til en separat forespørgsel.
-- 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 værdier) og DELETE (indfang hvad der blev fjernet — nyttigt til arkivering eller bekræftelse).
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-klausulen er en praktisk, hyppigt brugt PostgreSQL-funktion, der er værdifuld for effektivitet og korrekthed ved ændring af data.
Dens mest almindelige og vigtige brug er at få det auto-genererede ID tilbage fra en INSERT — et næsten universelt behov (du vil næsten altid have den nye primærnøgle efter indsættelse, for at bruge den i relaterede operationer eller returnere til applikationen), og RETURNING id giver den direkte i en enkelt sætning.
Uden RETURNING ville du have brug for en separat SELECT for at få det genererede ID, hvilket betyder en ekstra rundtur og en potentiel race condition (den separate SELECT kan muligvis ikke pålideligt hente din specifikke række i samtidige scenarier), så RETURNING er både mere effektiv og mere korrekt.
/#Udover indsættelser fungerer RETURNING med UPDATE (se de nye værdier efter en opdatering) og DELETE (indfang hvad der blev fjernet — nyttigt til arkivering, logging eller bekræftelse af sletninger).
I kombination med CTE'er muliggør det kraftfulde mønstre som indsættelse i relaterede tabeller ved hjælp af det returnerede ID i en enkelt sætning.
Da at få genererede værdier (især ID'er) efter dataændringer er et konstant behov, og da RETURNING giver dette effektivt og atomart (uden ekstra forespørgslinger og race conditions), er det værdifuldt og hyppigt anvendt PostgreSQL-viden at forstå RETURNING-klausulen, som gør dataændringskode renere, mere effektiv og mere korrekt — en praktisk bekvemmelighed, der bruges rutinemæssigt i rigtige applikationer, der arbejder med Postgres, især for det allestedsnærværende behov for at hente genererede ID'er efter indsættelser.