RETURNING-klausulen låter INSERT-, UPDATE- och DELETE-satser returnera data om raderna de påverkade — oftast det autogenererade ID:t efter en infogning, men också alla kolumner eller beräknade värden. Det sparar en separat fråga och är 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 vanligaste användningen: efter infogning behöver du vanligtvis den genererade primärnyckeln (för att använda i relaterade infogningar eller returnera till klienten). RETURNING id ger den direkt — ingen separat fråga behövs.
-- 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 fungerar på UPDATE (se de nya värdena) och DELETE (fånga vad som togs bort — användbart för 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 är en praktisk, ofta använd PostgreSQL-funktion som är värdefull för effektivitet och korrekthet när data modifieras.
Den viktigaste och mest vanliga användningen är att få det autogenererade ID:t tillbaka från en INSERT — ett nästan universellt behov (du vill nästan alltid ha den nya primärnyckeln efter infogning, för att använda i relaterade operationer eller returnera till programmet), och RETURNING id ger det direkt i en enda sats.
\nutan RETURNING skulle du behöva en separat SELECT för att få det genererade ID:t, vilket betyder en extra tur-och-retur och en potentiell race condition (den separata SELECT:en kanske inte tillförlitligt hämtar din specifika rad i samtidiga scenarier), så RETURNING är både mer effektiv och mer korrekt.
Beyond inserts, RETURNING fungerar med UPDATE (se de nya värdena efter en uppdatering) och DELETE (fånga vad som togs bort — användbart för arkivering, loggning eller bekräftelse av borttagningar).
I kombination med CTE:er möjliggör det kraftfulla mönster som att infoga i relaterade tabeller med det returnerade ID:t i en enda sats.
Eftersom att få genererade värden (särskilt ID:n) efter dataändringar är ett konstant behov, och eftersom RETURNING ger detta effektivt och atomärt (undviker extra frågor och race conditions), är förståelsen för RETURNING-klausulen värdeful, ofta använd PostgreSQL-kunskap som gör kod för dataändringar renare, mer effektiv och mer korrekt — en praktisk bekvämlighet som används rutinmässigt i verkliga program som arbetar med Postgres, särskilt för det allomfattande behovet av att hämta genererade ID:n efter infogningar.