DELETE

DELETE
Prev	Up	SQL 命令	Home	Next

DELETE — 删除一个表的行

Synopsis

[ WITH [ RECURSIVE ] with_query [, ...] ]
DELETE FROM [ ONLY ] table_name [ * ] [ [ AS ] alias ]
    [ USING from_item [, ...] ]
    [ WHERE condition | WHERE CURRENT OF cursor_name ]
    [ ORDER BY expression [ ASC | DESC | USING operator ] [ NULLS { FIRST | LAST } ] [, ...] ]
    [ LIMIT { count | ALL } ]
    [ OFFSET start [ ROW | ROWS ] ]
    [ RETURNING * | output_expression [ [ AS ] output_name ] [, ...] ]

描述

DELETE从指定表中删除满足 WHERE子句的行。如果WHERE 子句没有出现，效果将会是删除表中的所有行。结果是一个合法的空表。

Tip

TRUNCATE提供移除表中所有行的快速机制。

有两种方式可以使用数据库中其他表中包含的信息来删除一个表的行：使用子选择或者在USING子句中指定额外的表。哪种技术更合适取决于特定的环境。

可选的RETURNING子句导致DELETE 基于实际被删除的每一行计算并且返回值。任何使用被删除表列或者 USING中提到的其他表的列的表达式都可以被计算。 RETURNING列表的语法和SELECT的输出列表语法相同。

要从表中删除行，你必须具有其上的DELETE特权，以及USING子句中任何表以及其值在condition中被读取的表上的 SELECT特权。

如果指定了 ORDER BY 子句，可以按指定的顺序删除行。它的语义类似于 SELECT 中的 ORDER BY 子句。请注意，不支持带有 ORDER BY 子句的继承表删除，也不支持 Canopy。

如果指定了 LIMIT 或 OFFSET 子句，则可以删除行的子集。它的语义类似于 SELECT 中的 LIMIT 子句。请注意，不支持带有 LIMIT 或 OFFSET 子句的继承表更新，也不支持 Canopy。

参数

with_query: WITH子句允许你指定一个或者多个子查询，在 DELETE查询中可以用子查询的名字来引用它们。详见Section 8.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中的表的任何列。写成*可以返回所有列。
output_name: 被返回列的名称。

输出

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

DELETE count

count是被删除行的数目。注意如果有一个BEFORE DELETE触发器抑制删除，那么该数目可能小于匹配condition 的行数。如果count为 0，表示查询没有删除行（这并非一种错误）。

如果DELETE命令包含RETURNING子句，则结果会与包含有RETURNING列表中定义的列和值的 SELECT语句结果相似，这些结果是在被该命令删除的行上计算得来。

注解

通过在USING子句中指定其他的表， LightDB允许在 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 *;

删除tasks中游标c_tasks 当前位于其上的行：

DELETE FROM tasks WHERE CURRENT OF c_tasks;

删除 citys 表中按 id 排序的前 5 行。

DELETE FROM citys order by id LIMIT 5;

兼容性

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

FROM 自 LightDB 23.2开始可选，详细使用示例如下：

清除表films：

    DELETE films;

删除表中除kind不等musicals之外的所有行：

    DELETE films WHERE kind <> 'Musical';

又见

TRUNCATE