↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

Wiki / SQL 命令

DROP DATABASE

移除一个数据库

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

anchor
SQL-DROPDATABASE
file
sql-dropdatabase.html
lang
en
name
DROP DATABASE
purpose
remove a database
purpose zh
未知
sections same as
未知
slug
18
synopsis text
DROP DATABASE [ IF EXISTS ] name [ [ WITH ] ( option [, ...] ) ] where option can be: FORCE

语法

DROP DATABASE [ IF EXISTS ] name [ [ WITH ] ( option [, ...] ) ]

where option can be:

FORCE
语法图

从左向右阅读;分支表示选择,旁路表示可选,循环表示重复。点击带下划线的参数可打开对应规则。

DROP DATABASE IF EXISTS name WITH ( option , )
option
FORCE

版本定义 PG 18

DROP DATABASE [ IF EXISTS ] name [ [ WITH ] ( option [, ...] ) ]

其中 option 可以是:

FORCE

描述

DROP DATABASE删除一个数据库。它会移除该数据库的系统目录条目,并删除包含数据的目录。只有数据库拥有者才能执行此命令。连接到目标数据库时不能执行此命令。(请连接到postgres或任何其他数据库来发出此命令。)另外,如果还有其他人连接到目标数据库,除非使用下面描述的 FORCE选项,否则该命令将失败。

DROP DATABASE无法撤销。请谨慎使用!

参数

IF EXISTS

如果该数据库不存在,则不要抛出错误。这种情况下会发出一个提示。

name

要移除的数据库名称。

FORCE

尝试终止所有现有的、连接到目标数据库的连接。如果目标数据库中存在预备事务、活动的逻辑复制槽或订阅,则不会终止这些连接。

这会终止后台工作进程连接,以及当前用户有权使用 pg_terminate_backend终止的连接,该函数见第 9.28.2 节。如果仍有连接保留,该命令将失败。

注解

DROP DATABASE不能在事务块内执行。

由于该命令不能在连接到目标数据库时执行,因此改用程序dropdb可能更方便,它是此命令的一个包装器。

兼容性

SQL 标准中没有DROP DATABASE语句。

另见

CREATE DATABASE

比较版本

完整来源事实

synopsis html

DROP DATABASE [ IF EXISTS ] <em class="replaceable"><code>name</code></em> [ [ WITH ] ( <em class="replaceable"><code>option</code></em> [, ...] ) ]

<span class="phrase">where <em class="replaceable"><code>option</code></em> can be:</span>

    FORCE

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c