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

有时，在操作修改行时获取数据很有用。INSERT、UPDATE和DELETE命令都具有一个可选的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的另一个常见用例。