Redrock Postgres 搜索 英文
版本: 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17

6.4. 从修改行返回数据 #

有时,在操作修改行时获取这些行中的数据很有用。 INSERTUPDATEDELETEMERGE 命令均有一个可选的 RETURNING 子句以支持此操作。使用 RETURNING 可避免执行额外的数据库查询以收集数据,尤其是在依靠这种方式难以可靠地识别修改行时,它很有用。

允许的内容 RETURNING 子句与 SELECT 命令的输出列表相同 (参见 第 7.3 节)。它可以包含命令目标表的列名或使用这些列的值表达式。一个常见的简写是 RETURNING *,它按顺序选择目标表的全部列。

INSERT 中,可用于 RETURNING 的数据是作为插入的行。这对平凡的插入并不是很有用,因为它只会重复客户端提供的数据。但是,当依赖计算缺省值时,它可能非常方便。例如,在使用 serial 列提供唯一标识符时,RETURNING 可返回分配给新行的 ID

CREATE TABLE users (firstname text, lastname text, id serial primary key);

INSERT INTO users (firstname, lastname) VALUES ('Joe', 'Cool') RETURNING id;

INSERT ... SELECT 中,RETURNING 子句也很有用。

UPDATE 中,可用于 RETURNING 的数据是修改行的新内容。例如

UPDATE products SET price = price * 1.10
  WHERE price <= 99.99
  RETURNING name, price AS new_price;

DELETE 中,可用于 RETURNING 的数据是被删除行的内容。例如

DELETE FROM products
  WHERE obsoletion_date = 'today'
  RETURNING *;

MERGE 中,可用于 RETURNING 的数据是源行内容加上已插入、已更新或已删除的目标行内容。由于源和目标常常有许多相同的列,因此规定 RETURNING * 可能导致许多重复列,因此经常更有用的是限定它以仅返回源或目标行。例如

MERGE INTO products p USING new_products n ON p.product_no = n.product_no
  WHEN NOT MATCHED THEN INSERT VALUES (n.product_no, n.name, n.price)
  WHEN MATCHED THEN UPDATE SET name = n.name, price = n.price
  RETURNING p.*;

如果目标表上存在触发器(第 37 章),则可用于 RETURNING 的数据是经触发器修改过的行。因此,检查由触发器计算的列是 RETURNING 的另一个常见用例。