Die RETURNING-Klausel ermöglicht es INSERT-, UPDATE- und DELETE-Anweisungen, Daten über die betroffenen Zeilen zurückzugeben — am häufigsten die automatisch generierte ID nach einem Insert, aber auch beliebige Spalten oder berechnete Werte. Sie spart eine separate Abfrage ein und ist eine praktische 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
Der häufigste Anwendungsfall: Nach einem Insert benötigen Sie normalerweise den generierten Primärschlüssel (um ihn in verwandten Inserts zu verwenden oder an den Client zurückzugeben). RETURNING id liefert ihn direkt zurück — keine separate Abfrage nötig.
-- 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 funktioniert bei UPDATE (siehe die neuen Werte) und DELETE (erfasst, was gelöscht wurde — nützlich zum Archivieren oder Bestätigen).
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
Die RETURNING-Klausel ist eine praktische, häufig verwendete PostgreSQL-Funktion, die bei Datenänderungen wertvoll für Effizienz und Korrektheit ist.
Die häufigste und wichtigste Anwendung ist das Abrufen der automatisch generierten ID aus einem INSERT — ein praktisch universeller Bedarf (Sie möchten fast immer den neuen Primärschlüssel nach einem Insert haben, um ihn in verwandten Operationen zu verwenden oder an die Anwendung zurückzugeben), und RETURNING id liefert ihn direkt in einer Anweisung.
Ohne RETURNING benötigen Sie einen separaten SELECT, um die generierte ID abzurufen, was bedeutet, dass ein zusätzlicher Netzwerkzugriff und eine potenzielle Race Condition erforderlich sind (der separate SELECT könnte Ihre spezifische Zeile in parallelen Szenarien möglicherweise nicht zuverlässig abrufen), daher ist RETURNING sowohl effizienter als auch korrekter.
Über Inserts hinaus funktioniert RETURNING mit UPDATE (um die neuen Werte nach einem Update zu sehen) und DELETE (um zu erfassen, was gelöscht wurde — nützlich zum Archivieren, Protokollieren oder Bestätigen von Löschungen).
In Kombination mit CTEs ermöglicht es leistungsstarke Muster wie das Einfügen in verwandte Tabellen mithilfe der zurückgegebenen ID in einer einzigen Anweisung.
Da das Abrufen generierter Werte (besonders IDs) nach Datenänderungen eine konstante Notwendigkeit ist, und da RETURNING dies effizient und atomar bereitstellt (vermeidet zusätzliche Abfragen und Race Conditions), ist das Verständnis der RETURNING-Klausel wertvoll, häufig angewendetes PostgreSQL-Wissen, das Datenänderungscode sauberer, effizienter und korrekter macht — eine praktische Convenience, die routinemäßig in echten Anwendungen mit Postgres verwendet wird, besonders für den allgegenwärtigen Bedarf, generierte IDs nach Inserts abzurufen.