销毁一个数据库

22.5. 销毁一个数据库
数据库用DROP DATABASE命令删除：

DROP DATABASE name;
只有数据库的拥有者或者超级用户才可以删除数据库。删除数据库会移除其中包括的所有对象。数据库的删除不能被撤销。

你不能在与目标数据库连接时执行DROP DATABASE命令。不过，你可以连接到任何其它数据库，包括 template1数据库。template1也是你删除一个给定集簇中最后一个用户数据库的唯一选项。

为了方便，有一个在 shell 程序可以删除数据库，dropdb：

dropdb dbname
（和createdb不同，删除当前用户名的数据库不是默认动作）。

DROP DATABASE命令

DROP DATABASE

DROP DATABASE — 移除一个数据库

大纲

DROP DATABASE [ IF EXISTS ] name

描述
DROP DATABASE移除一个数据库。它会 移除该数据库的系统目录项并且删除包含数据的文件目录。它只能由数据库 拥有者执行。还有，当你或者任何其他人已经连接到目标数据库时，它不能 被执行（连接到postgres或者任何其他数据库来发出这 个命令）。

DROP DATABASE不能被撤销。请小心使用！

参数
IF EXISTS
如果该数据库不存在则不要抛出一个错误，而是发出一个提示。

name
要移除的数据库的名称。

注解
DROP DATABASE不能在一个事务块内执行。

在连接到目标数据库时，这个命令不能被执行。因此，使用程序 dropdb会更方便，它是这个命令的一个包装器。

兼容性
SQL 标准中没有DROP DATABASE语句。

命令方式dropdb

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（见官方文档第 33.14 节）支持的环境变量。

诊断
在有困难时，可以在DROP DATABASE和psql中找潜在问题和错误消息的讨论。数据库服务器必须运行在目标主机上。同样，任何libpq前端库使用的默认连接设置和环境变量都将适用于此。

例子
要在默认数据库服务器上毁掉数据库demo：

$ dropdb demo

要使用在主机eden、端口 5000 上的服务器中毁掉数据库demo，并带有验证和回显，看看下面的命令：

$ dropdb -p 5000 -h eden -i -e demo
Database "demo" will be permanently deleted.
Are you sure? (y/n) y
DROP DATABASE demo;