Klauzula RETURNING pozwala instrukcjom INSERT, UPDATE i DELETE zwrócić dane dotyczące wierszy, które dotyczyły — najczęściej automatycznie wygenerowany ID po wstawieniu, ale także dowolne kolumny lub wartości obliczone. Oszczędza osobne zapytanie i jest wygodną cechą 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
Najczęstsze zastosowanie: po wstawieniu zwykle potrzebujesz wygenerowanego klucza głównego (aby użyć go w powiązanych wstawieniach lub zwrócić klientowi). RETURNING id zwraca go bezpośrednio — bez potrzeby osobnego zapytania.
-- 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 działa na UPDATE (patrz nowe wartości) i DELETE (przechwyć usunięte — przydatne do archiwizacji lub potwierdzenia).
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
Klauzula RETURNING jest wygodną, często używaną cechą PostgreSQL, która jest cenna dla wydajności i poprawności podczas modyfikacji danych.
Jej najczęstsze i najważniejsze zastosowanie to uzyskanie automatycznie wygenerowanego ID z powrotem z INSERT — praktycznie uniwersalna potrzeba (prawie zawsze chcesz nowy klucz główny po wstawieniu, aby użyć go w powiązanych operacjach lub zwrócić do aplikacji), a RETURNING id dostarcza go bezpośrednio w jednej instrukcji.
Bez RETURNING potrzebowałbyś osobnego SELECT aby uzyskać wygenerowany ID, co oznacza dodatkową podróż w obie strony i potencjalną warunek wyścigu (osobny SELECT może nie niezawodnie pobrać twojego konkretnego wiersza w scenariuszach współbieżnych), więc RETURNING jest zarówno bardziej wydajne, jak i bardziej poprawne.
Poza wstawieniami, RETURNING działa z UPDATE (patrz nowe wartości po aktualizacji) i DELETE (przechwyć usunięte — przydatne do archiwizacji, rejestrowania lub potwierdzania usunięć).
W połączeniu z CTE, umożliwia potężne wzorce, takie jak wstawianie do powiązanych tabel przy użyciu zwróconego ID w jednej instrukcji.
Ponieważ uzyskanie wygenerowanych wartości (szczególnie ID) po modyfikacjach danych jest stałą potrzebą, a ponieważ RETURNING dostarcza to wydajnie i atomowo (unikając dodatkowych zapytań i warunków wyścigu), zrozumienie klauzuli RETURNING jest cenne, często stosowane know-how PostgreSQL, które czyni kod modyfikujący dane czystszym, bardziej wydajnym i bardziej poprawnym — praktyczną wygodą, która jest rutynowo używana w rzeczywistych aplikacjach pracujących z Postgres, szczególnie dla wszechobecnej potrzeby pobierania wygenerowanych ID po wstawieniach.
Biblioteka pytań rekrutacyjnych IT ze szczegółowymi odpowiedziami — od Juniora do Seniora.
Wesprzyj