RETURNING sąlyga leidžia INSERT, UPDATE ir DELETE sakiniams grąžinti duomenis apie eilutes, kurias jie paveikė — dažniausiai automatiškai sugeneruotą ID po įterpimo, bet taip pat bet kokius stulpelius arba apskaičiuotus reikšmes. Tai sutaupa atskirą užklausą ir yra patogi PostgreSQL funkcija.
-- 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
Dažniausias naudojimas: po įterpimo paprastai reikia sugeneruoto pirminio rakto (naudoti susijusiuose įterpimuose arba grąžinti klientui). RETURNING id jį grąžina tiesiogiai — nereikia atskiros užklausos.
-- 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 veikia su UPDATE (žr. naujas reikšmes) ir DELETE (užfiksuoti, kas buvo pašalinta — naudinga archyvavimui arba patvirtinimui).
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
RETURNING sąlyga yra patogi, dažnai naudojama PostgreSQL funkcija, kuri yra vertinga efektyvumo ir korektišgumo prasme modifikuojant duomenis.
Jos dažniausias ir svarbiausias panaudojimas yra automatiškai sugeneruoto ID grąžinimas iš INSERT — beveik universali poreikis (jūs beveik visada norite naujo pirminio rakto po įterpimo, kad jį naudotumėte susijusiuose operacijose arba grąžintumėte programai), ir RETURNING id jį pateikia tiesiogiai viename sakinyje.
Be RETURNING, jums reikėtų atskiros SELECT užklausos sugeneruotam ID gauti, o tai reiškia papildomą atsiskaitymą ir potencialią lenktynių sąlygą (atskira SELECT gali nepatikimai gauti jūsų konkrečią eilutę lygiagrečiose situacijose), todėl RETURNING yra ir efektyvesnė, ir teisingesnė.
Beyond inserts, RETURNING works with UPDATE (seeing the new values after an update) and DELETE (capturing what was removed — useful for archiving, logging, or confirming deletions).
Kartu su CTE, jis įgalina galingas šablonų, tokias kaip įterpimas į susijusias lenteles, naudojant grąžintą ID viename sakinyje.
Kadangi sugeneruotų reikšmių (ypač ID) gavimas po duomenų modifikacijų yra nuolatinis poreikis, o RETURNING tai teikia efektyviai ir atomariai (vengiant papildomų užklausų ir lenktynių sąlygų), RETURNING sąlygos supratimas yra vertinga, dažnai taikoma PostgreSQL žinių, kuri daro duomenų modifikavimo kodą švaresniu, efektyvesniu ir teisingesniu — praktinis patogumas, kuris rutiniškai naudojamas tikrose aplikacijose dirbant su Postgres, ypač universaliajam ID gavimo poreikiui po įterpimų.