↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 6.5 / 6.4
历史版本PostgreSQL 8.2 已于 2011 年 12 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

DELETE

DELETE — 删除表中的行

大纲

DELETE FROM [ ONLY ] table [ [ AS ] alias ]
    [ USING usinglist ]
    [ WHERE condition ]
    [ RETURNING * | output_expression [ AS output_name ] [, ...] ]

描述

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

默认情况下,DELETE将删除指定表及其所有子表中的行。 如果只想从所提及的这个表中删除,必须使用ONLY子句。

提示

TRUNCATE是一种PostgreSQL扩展,它提供了一种更快的机制来移除表中的所有行。

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

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

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

参数

ONLY

如果指定,则只从所提及的表中删除行。未指定时,任何继承自所提及表的 表也都会被处理。

table

一个已有表的名称(可以是模式限定的)。

alias

目标表的替代名称。提供别名时,它会完全隐藏该表的实际名称。 例如,给定DELETE FROM foo AS f, DELETE语句的其余部分必须将该表称为 f,而不是foo。

usinglist

一个表表达式列表,允许其他表的列出现在WHERE条件中。这类似于SELECT语句的FROM Clause中可以指定的表列表;例如,可以为表名指定别名。不要把目标表重复写在usinglist中,除非打算进行自连接。

condition

一个返回boolean类型值的表达式,它决定要删除哪些行。

output_expression

每行删除之后,由DELETE命令计算并返回的表达式。该表达式可以使用table所指定的表或USING中列出的表中的任何列名。写成*可返回所有列。

output_name

返回列所使用的名称。

输出

成功完成后,DELETE 命令返回如下形式的命令标签:

DELETE count

其中 count 是被删除的行数。如果 count 为 0,说明没有行匹配 condition(这不算错误)。

如果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 *;

兼容性

这个命令符合SQL标准,不过USING和RETURNING子句是PostgreSQL扩展。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。