DELETE

描述

DELETE从指定表中删除满足 WHERE子句的行。如果省略WHERE 子句，效果就是删除表中的所有行。结果是一个合法但为空的表。

有两种方法可以利用数据库中其他表所包含的信息来删除一个表中的行：使用子选择，或者在USING子句中指定附加表。哪种技术更合适取决于具体情况。

可选的RETURNING子句使DELETE 基于每个实际被删除的行计算并返回一个或多个值。可以计算使用该表列和/或USING中提到的其他表列的任意表达式。RETURNING列表的语法与SELECT 的输出列表相同。

要从一个表中删除行，必须具有该表上的DELETE权限，以及USING子句中出现的任何表或者其值会在 condition中读取的任何表上的SELECT权限。

参数

输出

在成功完成时，一个DELETE命令会返回以下形式的命令标签：

DELETE count

count是被删除的行数。注意，当删除被BEFORE DELETE触发器抑制时，这个数量可能小于匹配condition 的行数。如果count为 0，则该查询没有删除任何行（这不被视为错误）。

如果DELETE命令包含RETURNING 子句，其结果将类似于一个SELECT语句，其中包含 RETURNING列表中定义的列和值，并在该命令删除的行上进行计算。

注解

PostgreSQL允许通过在 USING子句中指定其他表，在 WHERE条件中引用这些表的列。例如，要删除由给定制片人制作的所有电影，可以这样做：

DELETE FROM films USING producers
  WHERE producer_id = producers.id AND producers.name = 'foo';

本质上，这里发生的是在films和 producers之间进行连接，并将所有成功连接到的films行标记为删除。这种语法不是标准的。更标准的写法是：

DELETE FROM films
  WHERE producer_id IN (SELECT id FROM producers WHERE name = 'foo');

在某些情况下，连接形式比子选择形式更容易书写或者执行更快。

示例

删除所有电影，但音乐剧除外：

DELETE FROM films WHERE kind <> 'Musical';

清空表films：

DELETE FROM films;

删除已完成的任务，并返回被删除行的完整详情：

DELETE FROM tasks WHERE status = 'DONE' RETURNING *;

删除游标c_tasks当前所定位的 tasks行：

DELETE FROM tasks WHERE CURRENT OF c_tasks;

虽然DELETE没有LIMIT子句，但可以采用UPDATE文档中介绍的相同方法来获得类似效果：

WITH delete_batch AS (
  SELECT l.ctid FROM user_logs AS l
    WHERE l.status = 'archived'
    ORDER BY l.creation_date
    FOR UPDATE
    LIMIT 10000
)
DELETE FROM user_logs AS dl
  USING delete_batch AS del
  WHERE dl.ctid = del.ctid;

这里使用ctid之所以安全，仅仅是因为该查询会被重复执行，从而避免了ctid发生变化的问题。

兼容性

这个命令符合SQL标准，不过 USING和RETURNING子句是 PostgreSQL扩展，在 DELETE中使用WITH也是扩展。

另见