RETURNING 子句做什么？

Question

RETURNING 子句做什么？

IT Interview Practice · Accepted Answer

**`RETURNING`** 子句让 `INSERT`、`UPDATE` 和 `DELETE` 语句**返回受影响行的数据** — 最常见的是插入后自动生成的 ID，但也可以是任何列或计算值。它节省了一条单独的查询，是一个方便的 PostgreSQL 特性。

## INSERT 后使用 RETURNING（获取生成的 ID）

```sql
-- get the auto-generated id back from the insert (no separate SELECT needed)
INSERT INTO users (name, email) VALUES ('Ann', 'ann@x.com')
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` 可以直接返回它 — 无需单独查询。

## 与 UPDATE 和 DELETE 一起使用 RETURNING

```sql
-- 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（捕获被删除的内容 — 对存档或确认很有用）。

## 为什么它有价值：效率和原子性

```text
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.
```

## 一个组合模式：插入到相关表

```sql
-- 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 这一普遍需求。

INSERT 后使用 RETURNING（获取生成的 ID）

与 UPDATE 和 DELETE 一起使用 RETURNING

为什么它有价值：效率和原子性

一个组合模式：插入到相关表

为什么这很重要

相关问题