dropdb
名称
dropdb -- 删除一个
PostgreSQL 数据库
大纲
dropdb [connection-option...] [option...] dbname
描述
dropdb 删除一个现有
PostgreSQL 数据库。
执行此命令的用户必须是数据库超级用户或者是数据库的所有者。
dropdb是对
SQL命令DROP DATABASE的封装。
因此,用哪种方法删除数据库都一样。
选项
dropdb 接受下列命令行参数:
- dbname
指定要删除的数据库名称
- -e
--echo 回显dropdb生成并发送到服务端的命令。
- -i
--interactive 在做任何破坏性动作前发出确认提示。
- -V
--version 输出dropdb命令的版本信息,然后退出。
- --if-exists
不要抛出如果数据库不存在时发出的错误。
- -?
--help 显示dropdb命令的帮助信息,然后退出。
dropdb 还接受以下命令行选项用于连接参数:
- -h host
--host=host 指定运行服务器的主机名。如果数值以斜杠开头则被用作到Unix域套接字的路径。
- -p port
--port=port 指定服务器侦听的TCP端口或一个本地Unix域套接字文件的扩展(描述符)。
- -U username
--username=username 进行联接的用户名。
- -w
--no-password 永远不提示输入密码。 如果服务器要求密码验证和密码
通过其他方式如.pgpass文件(验证)不可用,则联接尝试将失败。
此选项在不需要用户输入密码的批处理作业和脚本中非常有用。
- -W
--password 强制 dropdb 联接到数据库之前提示输入密码。
这个选项不是必须的,如果服务器要求认证密码
dropdb 会自动提示需输入密码。
然而 dropdb 会浪费一个联接尝试判断出该服务器需要密码。
在某些情况下,这是值得键入 -W 以避免多余的联接尝试。
- --maintenance-db=dbname
指定要删除数据库时联接的数据库名称。
如果没有指定,将使用postgres数据库;
如果不存在(或是正在被删除的数据库),
将使用template1数据库。
环境变量
- PGHOST
PGPORT
PGUSER 缺省的联接参数
此实用工具,像大多其他的PostgreSQL 实用工具,
还使用libpq支持的环境变量 (见 第 31.14 节)。
诊断
如果有问题,参阅 DROP DATABASE
和psql 获取可能的问题和错误消息的描述。
数据库服务器必须在目标机器上运行。
此外,前端库 libpq中的所有缺省连接设置和环境变量都将适用。
示例
删除缺省数据库服务器上的demo数据库:
$ dropdb demo
在主机eden上删除demo数据库,端口是5000,
执行命令前提示并且回显执行的命令:
$ dropdb -p 5000 -h eden -i -e demo
Database "demo" will be permanently deleted.
Are you sure? (y/n) y
DROP DATABASE demo;