描述

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 也是扩展。

另见