DELETE — 删除表中的行
[ WITH [ RECURSIVE ]with_query[, ...] ] DELETE FROM [ ONLY ]table_name[ * ] [ [ AS ]alias] [ USINGfrom_item[, ...] ] [ WHEREcondition| WHERE CURRENT OFcursor_name] [ RETURNING * |output_expression[ [ AS ]output_name] [, ...] ]
DELETE 从指定表中删除满足 WHERE 子句的行。如果 WHERE 子句不存在,则效果是删除表中的所有行。结果是一个有效但为空的表。
TRUNCATE 提供了一种更快的机制来从表中删除所有行。
使用数据库中其他表中的信息,有两种方法可以在表中删除行:使用子查询,或在 USING 子句中指定其他表。哪种技术更合适取决于具体情况。
可选的 RETURNING 子句导致 DELETE 计算并返回基于每个实际删除的行的一个或多个值。可以使用表的列和/或 USING 中提到的其他表的列的任何表达式进行计算。RETURNING 列表的语法与 SELECT 的输出列表相同。
您必须具有要从中删除的表的 DELETE 权限,以及 USING 子句中的任何表的 SELECT 权限,或在 condition 中读取其值。
with_queryWITH 子句允许您指定一个或多个子查询,这些子查询可以在 DELETE 查询中按名称引用。有关详细信息,请参见 第 7.8 节 和 SELECT。
table_name要从中删除行的表的名称(可选的模式限定)。如果在表名前指定了 ONLY,则仅从命名的表中删除匹配的行。如果未指定 ONLY,则还从继承自命名表的任何表中删除匹配的行。此外,可以在表名后指定 * 以明确指示包括后代表。
alias目标表的替代名称。提供别名时,它会完全隐藏表的实际名称。例如,给定 DELETE FROM foo AS f,DELETE 语句的其余部分必须将此表引用为 f,而不是 foo。
from_item允许其他表中的列出现在 WHERE 条件中的表表达式。这使用与 SELECT 语句的 FROM 子句相同的语法;例如,可以指定表名的别名。不要将目标表重复为 from_item,除非您希望设置自连接(在这种情况下,它必须在 from_item 中以别名出现)。
condition返回 boolean 类型值的表达式。仅删除此表达式返回 true 的行。
cursor_name在 WHERE CURRENT OF 条件中使用的游标的名称。要删除的行是最近从此游标中获取的行。游标必须是 DELETE 目标表上的非分组查询。请注意,WHERE CURRENT OF 不能与布尔条件一起指定。有关将游标与 WHERE CURRENT OF 一起使用的更多信息,请参见 DECLARE。
output_expression在删除每一行后由 DELETE 命令计算并返回的表达式。该表达式可以使用 table_name 指定的表或 USING 中列出的表(s) 的任何列名。编写 * 以返回所有列。
output_name用于返回列的名称。
成功完成后,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;
此命令符合 SQL 标准,但 USING 和 RETURNING 子句是 PostgreSQL 扩展,并且可以使用 WITH 与 DELETE 一起使用。
如果您在文档中看到任何不正确的内容,与您对特定功能的体验不符或需要进一步澄清,请使用 此表单 报告文档问题。