DELETE

Name

DELETE -- 删除一个表中的行

Synopsis

[ WITH [ RECURSIVE ] _with_query_ [, ...] ]
DELETE FROM [ ONLY ] _table_name_ [ * ] [ [ AS ] _alias_ ]
    [ USING _using_list_ ]
    [ WHERE _condition_ | WHERE CURRENT OF _cursor_name_ ]
    [ RETURNING * | _output_expression_ [ [ AS ] _output_name_ ] [, ...] ]

描述

DELETE从指定的表里删除满足WHERE子句的行。如果WHERE子句不存在，将删除表中所有行。结果是一个有效的空表。

Tip: TRUNCATE是一个PostgreSQL扩展，它提供一个更快的从表中删除所有行的机制。

使用数据库中其它表的信息删除某个表中的数据行有两个办法：使用子查询，或者在USING子句中声明额外的表。哪种技巧更合适取决于特定的环境。

可选的RETURNING子句将使得DELETE计算并返回实际被删除了的行。任何使用表字段的表达式和/或USING中提到的其他表的字段，都可以用于计算。RETURNING列表的语法和SELECT输出列表的语法相同。

要对表进行删除，你必须对它有DELETE权限，同样也必须有USING 子句的表以及_condition_上读取的表的 SELECT权限。

参数

_with_query_

WITH子句允许指定一个或多个可以通过DELETE查询中的名字引用的子查询。参阅Section 7.8和SELECT获取详细信息。

_table_name_

要删除行的表的名字（可以有模式修饰）。如果在表的名字前指定了ONLY，则只从指定的表中删除匹配的行。如果没有指定ONLY，则从指定的表及其所有子表中的删除匹配的行。可选的，可以在表名的后面指定*以明确的指出包括后代表。

_alias_

目标表的别名。如果提供了别名，那么它将完全掩盖实际的表名。例如给定DELETE FROM foo AS f 之后，DELETE语句的剩余部分必须使用f而不是foo来引用该表。

_using_list_

表表达式列表，允许来自其他表的列出现在WHERE条件中。这与可以在 SELECT命令的FROM 子句中指定的表列表相似。例如，可以为该表的名字声明一个别名。不要在 _using_list_里重复目标表，除非你希望产生一个自连接。

_condition_

一个返回boolean值的表达式，只用表达式返回true的行被删除。

_cursor_name_

在WHERE CURRENT OF条件中使用的游标的名字。要删除的行是最近从这个游标获取到的。该游标必须是一个在DELETE的目标表中非分组的查询。请注意，WHERE CURRENT OF 不能和一个布尔条件一起指定，参阅DECLARE获取更多关于和WHERE CURRENT OF 一起使用游标的信息。

_output_expression_

计算并在删除行后由DELETE命令返回的一个表达式。该表达式可以使用由 _table_name_命名的表的任意字段名或在USING 中列出的表。*返回所有字段。

_output_name_

用于返回的列名称。

输出

成功时，DELETE命令返回形如

DELETE _count_

的标签。_count_是被删除的行数。请注意，当删除被BEFORE DELETE触发器取消时，这个数字可能小于匹配 _condition_的行数。如果_count_为 0 则没有行被该查询删除，这个不认为是错误。

如果DELETE命令包含一个RETURNING子句，那么其结果非常类似于 SELECT语句基于RETURNING子句中包含的字段和值列表的结果，只是基于被删除的行进行计算而已。

注意

PostgreSQL允许你在WHERE条件里引用其它表的字段，方法是在USING子句里声明其它表。比如，要删除给出制片商制作的所有电影，可以：

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');

有时候连接风格比子查询风格更容易写或者执行更快。

例子

删除所有电影(films)但不删除音乐(musicals)：

DELETE FROM films WHERE kind <> 'Musical';

清空films表：

DELETE FROM films;

从 tasks 表及其子表中删除，并返回所有被删除的行：

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

删除游标c_tasks当前指向的tasks的行：

DELETE FROM tasks WHERE CURRENT OF c_tasks;

兼容性

这条命令遵循SQL标准，但是USING和RETURNING 子句是PostgreSQL的扩展，就像在DELETE中使用WITH。