dropdb
dropdb — 移除一个 PostgreSQL 数据库
当前查看 PostgreSQL 18.6。
说明
dropdb — 移除一个 PostgreSQL 数据库
- 手册中的可执行程序
- dropdb
- 程序版本
- 18.6
- 参考清单
- 客户端程序
- 选项定义组
- 12
用法
dropdb [ connection-option ...] [ option ...] dbname手册中的选项
| 选项与参数 | 说明 |
|---|---|
| -e --echo | 回显 dropdb 生成并发送给服务器的命令。 |
| -f --force | 在删除目标数据库之前，尝试终止所有到该数据库的现有连接。关于此选项的更多信息，见 DROP DATABASE 。 |
| -i --interactive | 在执行任何破坏性操作之前发出确认提示。 |
| -V --version | 打印 dropdb 版本并退出。 |
| --if-exists | 如果数据库不存在，则不要抛出错误。这种情况下会发出一个提示。 |
| -? --help | 显示有关 dropdb 命令行参数的帮助并退出。 |
| -h host --host= host | 指定服务器所在机器的主机名。如果该值以斜杠开头，则它将被用作 Unix 域套接字的目录。 |
| -p port --port= port | 指定服务器监听连接所用的 TCP 端口或本地 Unix 域套接字文件扩展名。 |
| -U username --username= username | 指定用于连接的用户名。 |
| -w --no-password | 从不发出密码提示。如果服务器要求密码认证，而密码又无法通过诸如 .pgpass 文件等其他方式获得，则连接尝试将失败。该选项适合没有用户在场输入密码的批处理作业和脚本。 |
| -W --password | 强制 dropdb 在连接数据库之前提示输入密码。 |
| --maintenance-db= dbname | 指定在删除目标数据库时要连接到的数据库名称。如果未指定，将使用 postgres 数据库；若该数据库不存在（或者它正是要被删除的数据库），则改用 template1 。这也可以是一个 连接字符串 。如果是这种情况，其中的连接字符串参数将覆盖任何冲突的命令行选项。 |
环境变量
| 变量 | 含义 |
|---|---|
| PGHOST PGPORT PGUSER | 默认连接参数 |
| PG_COLOR | 指定诊断消息是否使用颜色。可选值为 always 、 auto 和 never 。 |
手册定义
dropdb
dropdb — 移除一个PostgreSQL数据库
大纲
dropdb [connection-option...] [option...] dbname
说明
dropdb删除一个现有的 PostgreSQL数据库。执行此命令的用户必须是数据库超级用户或该数据库的拥有者。
dropdb是SQL命令 DROP DATABASE的一个包装器。通过此工具删除数据库与通过其他访问服务器的方法删除数据库，在效果上没有区别。
选项
dropdb接受下列命令行参数：
dbname-
指定要移除的数据库名称。
-e--echo-
回显dropdb生成并发送给服务器的命令。
-f--force-
在删除目标数据库之前，尝试终止所有到该数据库的现有连接。关于此选项的更多信息，见DROP DATABASE。
-i--interactive-
在执行任何破坏性操作之前发出确认提示。
-V--version-
打印dropdb版本并退出。
--if-exists-
如果数据库不存在，则不要抛出错误。这种情况下会发出一个提示。
-?--help-
显示有关dropdb命令行参数的帮助并退出。
dropdb也接受下列用于连接参数的命令行参数：
-hhost--host=host-
指定服务器所在机器的主机名。如果该值以斜杠开头，则它将被用作 Unix 域套接字的目录。
-pport--port=port-
指定服务器监听连接所用的 TCP 端口或本地 Unix 域套接字文件扩展名。
-Uusername--username=username-
指定用于连接的用户名。
-w--no-password-
从不发出密码提示。如果服务器要求密码认证，而密码又无法通过诸如
.pgpass文件等其他方式获得，则连接尝试将失败。该选项适合没有用户在场输入密码的批处理作业和脚本。 -W--password-
强制dropdb在连接数据库之前提示输入密码。
这个选项并非必不可少，因为如果服务器要求密码认证，dropdb会自动提示输入密码。不过，dropdb会浪费一次连接尝试，才知道服务器需要密码。在某些情况下，为了避免这次额外的连接尝试，提前指定
-W是值得的。 --maintenance-db=dbname-
指定在删除目标数据库时要连接到的数据库名称。如果未指定，将使用
postgres数据库；若该数据库不存在（或者它正是要被删除的数据库），则改用template1。这也可以是一个连接字符串。如果是这种情况，其中的连接字符串参数将覆盖任何冲突的命令行选项。
环境
PGHOSTPGPORTPGUSER-
默认连接参数
PG_COLOR-
指定诊断消息是否使用颜色。可选值为
always、auto和never。
与大多数其他 PostgreSQL 工具一样，此工具也使用 libpq 支持的环境变量（见第 32.15 节）。
诊断
如果遇到问题，请参见DROP DATABASE和psql中关于潜在问题和错误消息的讨论。数据库服务器必须在目标主机上运行。此外，libpq前端库所使用的任何默认连接设置和环境变量都会生效。
示例
要在默认数据库服务器上删除数据库demo：
$dropdb demo
使用主机 eden 上端口为 5000 的服务器删除数据库 demo，要求确认并查看底层命令：
$dropdb -p 5000 -h eden -i -e demoDatabase "demo" will be permanently deleted. Are you sure? (y/n)yDROP DATABASE demo;
文档与源码
来源构建
- 版本
- 18.6
- 构建
- https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
- 来源指纹
ee8d1a3612338fd9adf250730cb640fcc5233b5491337cc00a316a44e3a0b9f8
版本比较
PostgreSQL 11 → 12: 属性变化。
以下差异保留原始字段名与英文源描述。
--- PostgreSQL 11
+++ PostgreSQL 12
@@ -3,6 +3,10 @@
{
"description": "Default connection parameters",
"name": "PGHOST PGPORT PGUSER"
+ },
+ {
+ "description": "Specifies whether to use color in diagnostic messages. Possible values are always , auto and never .",
+ "name": "PG_COLOR"
}
],
"options": [比较已记录的接口与属性，排除来源指纹和构建元数据。某个样本中没有记录，不能据此判断实际引入或移除的版本。
相关条目
导出 JSON · 返回命令行工具 · 收录范围为 PostgreSQL 10 至 20；最早采样版本不一定是实际引入版本。