6.4. 从修改的行返回数据

有时，在对已修改的行进行操作时从中获取数据很有用。 INSERT，UPDATE和DELETE命令都具有支持此功能的可选RETURNING子句。 RETURNING的使用避免了执行额外的数据库查询来收集数据，并且在否则将难以可靠地标识修改后的行的情况下特别有用。

RETURNING子句的允许内容与SELECT命令的输出列表相同(请参见Section 7.3)。它可以包含命令目标表的列名，也可以包含使用这些列的值表达式。常见的缩写是RETURNING *，它按 Sequences 选择目标表的所有列。

在INSERT中，RETURNING可用的数据是插入时所在的行。这在琐碎的插入中不是很有用，因为它只会重复 Client 端提供的数据。但是，在依赖于计算的默认值时它可能非常方便。例如，当使用serial列提供唯一标识符时，RETURNING可以返回分配给新行的 ID：

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

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

RETURNING子句对于INSERT ... SELECT也非常有用。

在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 *;

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