RETURNING 子句让 INSERT、UPDATE 和 DELETE 语句返回受影响行的数据 — 最常见的是插入后自动生成的 ID，但也可以是任何列或计算值。它节省了一条单独的查询，是一个方便的 PostgreSQL 特性。
users (name, email) (, )
RETURNING id;
users (name) ()
RETURNING id, name, created_at;
users (name) () RETURNING ;
最常见的用法：插入后，你通常需要生成的主键（用于后续插入或返回给客户端）。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 特性，在修改数据时对效率和正确性都很有价值。
它最常见且最重要的用途是从 INSERT 获取自动生成的 ID 返回 — 这几乎是通用的需求（插入后几乎总是需要新的主键，用于相关操作或返回给应用程序），而 RETURNING id 在单个语句中直接提供它。
没有 RETURNING，你需要通过单独的 SELECT 获取生成的 ID，这意味着额外的往返和潜在的竞态条件（在并发场景中，单独的 SELECT 可能无法可靠地检索你的特定行），所以 RETURNING 既更高效也更正确。
除了插入，RETURNING 也适用于 UPDATE（查看更新后的新值）和 DELETE（捕获被删除的内容 — 对存档、日志或确认删除很有用）。
结合 CTE，它支持强大的模式，如在单个语句中使用返回的 ID 插入相关表。
由于获取数据修改后的生成值（尤其是 ID）是持续的需求，而 RETURNING 高效且原子地提供这一点（避免了额外的查询和竞态条件），理解 RETURNING 子句是有价值的、经常使用的 PostgreSQL 知识，使数据修改代码更干净、更高效、更正确 — 这是一个实用的便利，在处理 Postgres 的真实应用程序中经常使用，特别是对于插入后检索生成 ID 这一普遍需求。