历史版本。 PostgreSQL 9.3 已结束支持。 2018-11-08. 请参阅 当前版本手册.
6.4. 从被修改的行中返回数据 #
有时候,在修改行的同时取得这些行中的数据会很有用。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 *;
如果目标表上有触发器(第 36 章),RETURNING可取得的数据就是触发器修改后的行。因此,检查由触发器计算的列,也是RETURNING的另一个常见用途。