有时在修改行的操作过程中获取数据很有用。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;
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 *;
如果目标表上有触发器(第 39 章),可用于RETURNING
的数据是被触发器修改的行。因此,检查由触发器计算的列是
RETURNING
的另一个常见用例。