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

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

在 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 的另一个常见用例。