有时，在修改行时获取修改后的行的数据会很有用。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 的另一个常见用例。