La clausola RETURNING consente alle istruzioni INSERT, UPDATE e DELETE di restituire dati sulle righe che hanno interessato — più comunemente l'ID auto-generato dopo un inserimento, ma anche qualsiasi colonna o valore calcolato. Permette di evitare una query separata ed è una funzionalità comoda di PostgreSQL.
-- 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
L'uso più comune: dopo l'inserimento, di solito hai bisogno della chiave primaria generata (da usare in inserimenti correlati o da restituire al client). RETURNING id la restituisce direttamente — nessun bisogno di una query separata.
-- 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 funziona con UPDATE (vedi i nuovi valori) e DELETE (cattura ciò che è stato rimosso — utile per l'archiviazione o la conferma).
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
La clausola RETURNING è una funzionalità comoda e frequentemente utilizzata di PostgreSQL che è preziosa per l'efficienza e la correttezza quando si modificano i dati.
L'uso più comune e importante è ottenere l'ID auto-generato indietro da un INSERT — un'esigenza quasi universale (quasi sempre vuoi la nuova chiave primaria dopo l'inserimento, da usare in operazioni correlate o restituire all'applicazione), e RETURNING id lo fornisce direttamente in un'unica istruzione.
Senza RETURNING, avresti bisogno di un SELECT separato per ottenere l'ID generato, il che significa un round-trip aggiuntivo e una potenziale race condition (il SELECT separato potrebbe non recuperare affidabilmente la tua riga specifica in scenari concorrenti), quindi RETURNING è sia più efficiente che più corretto.
Al di là degli inserimenti, RETURNING funziona con UPDATE (vedendo i nuovi valori dopo un aggiornamento) e DELETE (catturando ciò che è stato rimosso — utile per l'archiviazione, la registrazione o la conferma delle eliminazioni).
Combinato con le CTE, consente pattern potenti come l'inserimento in tabelle correlate utilizzando l'ID restituito in un'unica istruzione.
Poiché ottenere valori generati (specialmente ID) dopo le modifiche ai dati è un'esigenza costante, e poiché RETURNING lo fornisce in modo efficiente e atomico (evitando query aggiuntive e race condition), comprendere la clausola RETURNING è una conoscenza preziosa e frequentemente applicata di PostgreSQL che rende il codice di modifica dei dati più pulito, più efficiente e più corretto — una comodità pratica che viene utilizzata routinariamente nelle applicazioni reali che lavorano con Postgres, in particolare per l'esigenza ubiqua di recuperare gli ID generati dopo gli inserimenti.