有时在修改行时获取数据是很有用的。INSERT
、UPDATE
、
DELETE
和 MERGE
命令都带有一个可选的
RETURNING
子句来支持这一点。使用 RETURNING
可以避免执行额外的数据库查询来收集数据,尤其在难以可靠识别被修改行时
更加有价值。
所允许的RETURNING
子句的内容与SELECT
命令的输出列表相同
(请参阅Section 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.*;
如果目标表上有触发器(Chapter 37),可用于RETURNING
的数据是被触发器修改的行。因此,检查由触发器计算的列是
RETURNING
的另一个常见用例。