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

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

百科 / SQL 命令 / 表与视图

SQL COMMAND · 表与视图

DROP TABLE

移除一个表

remove a table

DROP表与视图引入 6.4(基线)现存至 20 devel3 次语法变更

动词
DROP
对象
TABLE
引入版本
6.4(基线)
状态
现存
语法变更次数
3
手册小节数
5

本站手册 · 18官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。

DROP TABLE IF EXISTS name , CASCADE RESTRICT

锁模式 PostgreSQL 18

具体锁模式取决于操作变体、目标对象和执行阶段;同一命令可同时取得表锁与行锁。查看完整冲突矩阵

ACCESS EXCLUSIVE · 表级锁

DROP TABLE:作用于被删除的表;依赖对象及 CASCADE 还可能取得额外锁。

语法概要

DROP TABLE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]

PostgreSQL 18 手册 · 查看完整参考页

描述

DROP TABLE 从数据库中移除表。只有表拥有者、模式拥有者以及超级用户才能删除表。若要清空表中的行而不销毁该表,请使用 DELETE 或 TRUNCATE。

DROP TABLE 总会移除目标表上存在的所有索引、规则、触发器和约束。但是,要删除一个被视图或另一张表的外键约束引用的表,必须指定 CASCADE。(CASCADE 会将依赖于该表的视图整个删除,但在外键场景下,它只会删除外键约束,不会把另一张表整体删除。)

参数

IF EXISTS

如果表不存在,则不要抛出错误。这种情况下会发出一条提示。

name

要删除的表名称(可选地使用模式限定)。

CASCADE

自动删除依赖于该表的对象(例如视图),以及进一步依赖于这些对象的所有对象(参见第 5.15 节)。

RESTRICT

如果有任何对象依赖于该表,则拒绝删除它。这是默认值。

示例

要删除两个表 films 和 distributors:

DROP TABLE films, distributors;

兼容性

此命令符合 SQL 标准,只是标准每条命令只允许删除一个表,且 IF EXISTS 选项是 PostgreSQL 扩展。

另见

语法演化

相邻大版本之间的差异,新的在前。版本号链接到对应快照。

  1. PostgreSQL 19← 18正文更新

    正文更新
  2. PostgreSQL 17← 16正文更新

    正文更新
  3. PostgreSQL 12← 11正文更新

    正文更新
  4. PostgreSQL 9.6← 9.5正文更新

    正文更新
  5. PostgreSQL 9.2← 9.1正文更新

    正文更新
  6. PostgreSQL 8.3← 8.2正文更新

    正文更新
  7. PostgreSQL 8.2← 8.1语法变化

    + DROP TABLE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]正文更新
  8. PostgreSQL 8.0← 7.4正文更新

    正文更新
  9. PostgreSQL 7.4← 7.3正文更新

    正文更新
  10. PostgreSQL 7.3← 7.2语法变化

    + DROP TABLE name [, ...] [ CASCADE | RESTRICT ]正文更新
  11. PostgreSQL 7.2← 7.1正文更新

    正文更新
  12. PostgreSQL 7.1← 7.0文件改名

    sql-droptable.htm → sql-droptable.html

    正文更新
  13. PostgreSQL 6.5← 6.4语法变化

    + DROP TABLE name [, ...]− DROP TABLE table [, ...]正文更新

同组命令

命令动词对象版本变动最近变更
TABLES & VIEWS表与视图15 条↑
TRUNCATETRUNCATE— 8.43 次
清空一个表或一组表现存
CREATE MATERIALIZED VIEWCREATEMATERIALIZED VIEW 122 次
定义一个新物化视图现存
ALTER MATERIALIZED VIEWALTERMATERIALIZED VIEW 168 次
更改一个物化视图的定义现存
DROP MATERIALIZED VIEWDROPMATERIALIZED VIEW —
移除一个物化视图现存
REFRESH MATERIALIZED VIEWREFRESHMATERIALIZED VIEW 9.41 次
替换物化视图的内容现存
CREATE SEQUENCECREATESEQUENCE 188 次
定义一个新的序列发生器现存
ALTER SEQUENCEALTERSEQUENCE 1810 次
更改序列发生器的定义现存
DROP SEQUENCEDROPSEQUENCE 8.23 次
移除一个序列现存
CREATE TABLECREATETABLE 1920 次
定义一个新表现存
ALTER TABLEALTERTABLE 1826 次
更改一个表的定义现存
DROP TABLEDROPTABLE 8.23 次
移除一个表现存
CREATE TABLE ASCREATETABLE AS 1911 次
根据查询结果定义一个新表现存
CREATE VIEWCREATEVIEW 9.47 次
定义一个新视图现存
ALTER VIEWALTERVIEW 145 次
更改视图的定义现存
DROP VIEWDROPVIEW 8.24 次
移除一个视图现存