Klauzule RETURNING umožňuje příkazům INSERT, UPDATE a DELETE vrátit data o řádcích, které ovlivnily — nejčastěji automaticky generované ID po vložení, ale také jakýkoli sloupec nebo vypočítanou hodnotu. Šetří separátní dotaz a je vhodnou funkcí 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
Nejčastější použití: po vložení obvykle potřebujete generovaný primární klíč (k použití v souvisejících vloženích nebo k vrácení klientovi). RETURNING id jej vrací přímo — není potřeba separátní dotaz.
-- 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 funguje s UPDATE (podívejte se na nové hodnoty) a DELETE (zachyťte co bylo odebráno — užitečné pro archivaci nebo potvrzení).
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
Klauzule RETURNING je vhodná a často používaná funkcí PostgreSQL, která je cenná pro efektivitu a správnost při úpravě dat.
Její nejčastější a nejdůležitější použití je získání automaticky generovaného ID zpět z INSERT — téměř univerzální potřeba (skoro vždy chcete nový primární klíč po vložení, aby se použil v souvisejících operacích nebo vrátil do aplikace), a RETURNING id jej poskytuje přímo v jednom příkazu.
Bez RETURNING byste potřebovali separátní SELECT k získání generovaného ID, což znamená další round-trip a potenciální race condition (separátní SELECT nemusí spolehlivě získat váš konkrétní řádek v souběžných scénářích), takže RETURNING je zároveň efektivnější a správnější.
Beyond inserts, RETURNING funguje s UPDATE (vidíte nové hodnoty po aktualizaci) a DELETE (zachycení co bylo odebráno — užitečné pro archivaci, logování nebo potvrzení smazání).
V kombinaci s CTE umožňuje výkonné vzory, jako je vložení do souvisejících tabulek s použitím vráceného ID v jednom příkazu.
Protože získávání generovaných hodnot (zvláště ID) po úpravách dat je neustálá potřeba a protože RETURNING to poskytuje efektivně a atomicky (vyhýbá se dalším dotazům a race conditions), porozumění klauzuli RETURNING je cenné, často používané PostgreSQL znalosti, které činí kód pro úpravu dat čistší, efektivnější a správnější — praktická vhodnost, která se rutinně používá v reálných aplikacích pracujících s Postgres, zejména pro všudypřítomnou potřebu získávání generovaných ID po vloženích.