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

6.4. 从修改行中返回数据 #

有时,在操作修改行时获取数据很有用。INSERTUPDATEDELETE 命令都具有一个可选的 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 *;

如果目标表上有触发器(第 39 章),RETURNING 可用的数据是触发器修改后的行。因此,检查由触发器计算的列是 RETURNING 的另一个常见用例。