A RETURNING záradék lehetővé teszi az INSERT, UPDATE és DELETE utasítások számára, hogy adatokat adjanak vissza az általuk érintett sorokról — leggyakrabban az auto-generált ID-t egy beszúrás után, de bármilyen oszlopot vagy számított értéket. Megspórol egy külön lekérdezést és egy kényelmes PostgreSQL funkció.
-- 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
A leggyakoribb használat: beszúrás után általában szükséged van az auto-generált elsődleges kulcsra (kapcsolódó beszúrásokhoz vagy a kliens felé való visszaadáshoz). A RETURNING id közvetlenül visszaadja — nincs szükség külön lekérdezésre.
-- 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
A RETURNING működik az UPDATE-en (lásd az új értékeket) és a DELETE-en (rögzítsd, hogy mi lett eltávolítva — hasznos az archiváláshoz vagy a megerősítéshez).
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
A RETURNING záradék egy kényelmes, gyakran használt PostgreSQL funkció, amely értékes az adatok módosításakor a hatékonyság és a helyesség szempontjából.
Ennek leggyakoribb és legfontosabb alkalmazása az auto-generált ID visszaadása az INSERT-ből — egy szinte egyetemes szükséglet (szinte mindig akarod az új elsődleges kulcsot a beszúrás után, hogy kapcsolódó műveletek során vagy az alkalmazás felé vissza lehessen adni), és a RETURNING id közvetlenül biztosítja egy utasításban.
A RETURNING nélkül szükséged lenne egy külön SELECT-re az azonosított ID megadásához, ami azt jelenti, hogy egy extra körút és egy lehetséges versenyhelyzet (a külön SELECT nem biztos, hogy megbízhatóan lekéri az azonos sort párhuzamos forgatókönyvekben), így a RETURNING egyszerre hatékonyabb és helyesebb.
A beszúrásokon túl a RETURNING működik az UPDATE-vel (az új értékeket lát egy frissítés után) és a DELETE-vel (rögzítsd, hogy mi lett eltávolítva — hasznos az archiváláshoz, naplózáshoz vagy törlések megerősítéséhez).
A CTE-kkel kombinálva hatékony mintákat tesz lehetővé, mint például a kapcsolódó táblákba történő beszúrás a visszaadott azonosító használatával egyetlen utasításban.
Mivel az adatok módosítása után a generált értékek (különösen az ID-k) megadása egy állandó szükséglet, és mivel a RETURNING ezt hatékonyan és atomikusan biztosítja (elkerülve az extra lekérdezéseket és versenyhelyzeteket), a RETURNING záradék értékes, gyakran alkalmazott PostgreSQL tudás, amely tisztábbá, hatékonyabbá és helyesebbé teszi az adat-módosítási kódot — egy gyakorlati kényelem, amelyet rendszeresen használnak valós alkalmazások a Postgres-szel való munkához, különösen a beszúrások után az azonosított ID-k visszakeresésének közönséges szükséglete miatt.