De RETURNING-clausule stelt INSERT-, UPDATE- en DELETE-instructies in staat om gegevens terug te geven over de rijen die ze hebben beïnvloed — meestal de automatisch gegenereerde ID na een insert, maar ook alle kolommen of berekende waarden. Dit bespaart een aparte query en is een handige PostgreSQL-functie.
-- 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
Het meest voorkomende gebruik: na het invoegen heb je meestal de gegenereerde primaire sleutel nodig (om in gerelateerde inserts te gebruiken of terug te geven aan de client). RETURNING id geeft deze direct terug — geen aparte query nodig.
-- 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 werkt op UPDATE (zie de nieuwe waarden) en DELETE (vastleggen wat werd verwijderd — handig voor archivering of bevestiging).
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
De RETURNING-clausule is een handige, veel gebruikte PostgreSQL-functie die waardevol is voor efficiëntie en juistheid bij het wijzigen van gegevens.
Het meest voorkomende en belangrijkste gebruik is het terugkrijgen van de automatisch gegenereerde ID van een INSERT — een bijna universele behoefte (je wilt bijna altijd de nieuwe primaire sleutel na het invoegen, om in gerelateerde bewerkingen te gebruiken of terug te geven aan de applicatie), en RETURNING id geeft deze direct in één instructie terug.
Zonder RETURNING zou je een aparte SELECT nodig hebben om de gegenereerde ID op te halen, wat betekent dat je een extra round-trip nodig hebt en een mogelijk race condition ontstaat (de aparte SELECT kan je specifieke rij in gelijktijdige scenario's mogelijk niet betrouwbaar ophalen), dus RETURNING is zowel efficiënter als correcter.
/*Behalve bij inserts werkt RETURNING met UPDATE (de nieuwe waarden zien na een update) en DELETE (vastleggen wat werd verwijderd — handig voor archivering, logging of bevestiging van verwijderingen).
Gecombineerd met CTE's maakt het krachtige patronen mogelijk, zoals het invoegen in gerelateerde tabellen met behulp van de geretourneerde ID in één instructie.
Aangezien het ophalen van gegenereerde waarden (vooral ID's) na gegevenswijzigingen een constant behoefte is, en aangezien RETURNING dit efficiënt en atomair biedt (zonder extra queries en race conditions), is het begrijpen van de RETURNING-clausule waardevol, veel toegepast PostgreSQL-kennis dat gegevenswijzigingscode schoner, efficiënter en correcter maakt — een praktische handigheidsfunctie die routinematig wordt gebruikt in echte applicaties die met Postgres werken, vooral voor de alomtegenwoordige behoefte van het ophalen van gegenereerde ID's na inserts.