Предложение RETURNING позволяет операторам INSERT, UPDATE и DELETE возвращать данные о затронутых строках — чаще всего автоматически сгенерированный ID после вставки, но также любые столбцы или вычисленные значения. Это сохраняет отдельный запрос и является удобной функцией 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
Мост частый случай: после вставки обычно нужен сгенерированный первичный ключ (для использования в связанных вставках или возврата клиенту). RETURNING id возвращает его напрямую — не нужен отдельный запрос.
-- 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 работает с UPDATE (смотрите новые значения) и DELETE (захватите удалённые данные — полезно для архивирования или подтверждения).
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 — это удобная, часто используемая функция PostgreSQL, которая ценна для эффективности и корректности при изменении данных.
Его наиболее частое и важное использование — получение автоматически сгенерированного ID обратно из INSERT — почти универсальная необходимость (вы почти всегда нужен новый первичный ключ после вставки, чтобы использовать его в связанных операциях или вернуть приложению), и RETURNING id предоставляет его напрямую в одном операторе.
Без RETURNING вам понадобился бы отдельный SELECT для получения сгенерированного ID, что означает дополнительный круговой обход и потенциальное условие гонки (отдельный SELECT может ненадёжно получить вашу конкретную строку в сценариях с конкурентностью), поэтому RETURNING является одновременно более эффективным и более корректным.
Помимо вставок, RETURNING работает с UPDATE (просмотр новых значений после обновления) и DELETE (захват удалённых данных — полезно для архивирования, логирования или подтверждения удалений).
В сочетании с CTE это обеспечивает мощные паттерны, такие как вставка в связанные таблицы с использованием возвращённого ID в одном операторе.
Поскольку получение сгенерированных значений (особенно ID) после модификации данных — постоянная необходимость, и поскольку RETURNING предоставляет это эффективно и атомарно (избегая дополнительных запросов и условий гонки), понимание предложения RETURNING — это ценное, часто применяемое знание PostgreSQL, которое делает код модификации данных чище, эффективнее и корректнее — практическое удобство, которое используется обычно в реальных приложениях, работающих с Postgres, особенно для повсеместной необходимости получения сгенерированных ID после вставок.