La clause RETURNING permet aux instructions INSERT, UPDATE et DELETE de retourner des données sur les lignes qu'elles ont affectées — le plus souvent l'ID généré automatiquement après une insertion, mais aussi n'importe quelles colonnes ou valeurs calculées. Elle évite une requête distincte et est une fonctionnalité pratique de 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'utilisation la plus courante : après une insertion, vous avez généralement besoin de la clé primaire générée (pour l'utiliser dans des insertions connexes ou la retourner au client). RETURNING id la retourne directement — pas besoin d'une requête distincte.
-- 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 fonctionne sur UPDATE (voir les nouvelles valeurs) et DELETE (capturer ce qui a été supprimé — utile pour l'archivage ou la confirmation).
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 clause RETURNING est une fonctionnalité pratique et fréquemment utilisée de PostgreSQL qui est précieuse pour l'efficacité et la justesse lors de la modification de données.
Son utilisation la plus courante et importante est d'obtenir l'ID généré automatiquement en retour d'une INSERT — un besoin quasi universel (vous voulez presque toujours la nouvelle clé primaire après une insertion, pour l'utiliser dans des opérations connexes ou la retourner à l'application), et RETURNING id la fournit directement dans une seule instruction.
Sans RETURNING, vous auriez besoin d'une SELECT distincte pour obtenir l'ID généré, ce qui signifie un aller-retour supplémentaire et une condition de concurrence potentielle (la SELECT distincte pourrait ne pas récupérer de manière fiable votre ligne spécifique dans des scénarios concurrents), donc RETURNING est à la fois plus efficace et plus correct.
Au-delà des insertions, RETURNING fonctionne avec UPDATE (voir les nouvelles valeurs après une mise à jour) et DELETE (capturer ce qui a été supprimé — utile pour l'archivage, la journalisation ou la confirmation des suppressions).
Combinée avec les CTE, elle active des modèles puissants comme insérer dans des tables connexes en utilisant l'ID retourné dans une seule instruction.
Puisque obtenir des valeurs générées (en particulier les ID) après les modifications de données est un besoin constant, et puisque RETURNING le fournit efficacement et de manière atomique (en évitant les requêtes supplémentaires et les conditions de concurrence), comprendre la clause RETURNING est une connaissance PostgreSQL précieuse et fréquemment appliquée qui rend le code de modification de données plus propre, plus efficace et plus correct — une commodité pratique qui est utilisée régulièrement dans les applications réelles travaillant avec Postgres, en particulier pour le besoin omniprésent de récupérer les ID générés après les insertions.
Une bibliothèque de questions d'entretien IT avec des réponses détaillées — du Junior au Senior.
Faire un don