createdb
createdb — 创建一个新的 PostgreSQL 数据库
大纲
createdb [options...] [dbname] [description]
描述
createdb创建一个新的PostgreSQL数据库。
通常，执行此命令的数据库用户会成为新数据库的所有者。不过，如果执行用户具有相应的权限，也可以通过-O选项指定不同的所有者。
createdb 是围绕 SQL 命令CREATE DATABASE的一个 shell 脚本包装，它通过 PostgreSQL 交互式终端psql执行。因此，用这种方法或其他方法创建数据库并没有什么特别之处。这意味着脚本必须能找到 psql 程序，而且目标端口上必须有数据库服务器在运行。此外， psql 和 libpq 前端库可用的任何默认设置和环境变量都将适用。
选项
createdb 接受下列命令行参数：
dbname指定要创建的数据库的名称。该名称在本安装中的所有 PostgreSQL 数据库中必须唯一。默认创建一个与当前系统用户同名的数据库。
description可选地指定与新创建的数据库关联的注释。
-Dlocation--locationlocation指定数据库的备选位置。另见initlocation。
-e--echo回显 createdb 生成并发送给服务器的查询。
-Eencoding--encodingencoding指定该数据库使用的字符编码方案。
-Oowner--ownerowner指定将拥有新数据库的数据库用户。
-q--quiet不显示响应。
-Ttemplate--templatetemplate指定用于构建该数据库的模板数据库。
-D、-E、-O和-T选项对应底层 SQL 命令CREATE DATABASE的选项；有关这些选项的更多信息请参见该命令。
createdb 还接受下列用于连接参数的命令行参数：
-hhost--hosthost指定服务器所在机器的主机名。如果 host 以斜线开头，它被用作 Unix 域套接字的目录。
-pport--portport指定服务器正在监听连接的 Internet TCP/IP 端口或本地 Unix 域套接字文件扩展名。
-Uusername--usernameusername以该用户名进行连接。
-W--password强制提示输入密码。
诊断
CREATE DATABASE数据库创建成功。
createdb: Database creation failed.（一目了然。）
createdb: Comment creation failed. (Database was created.)无法创建数据库的注释/描述。数据库本身已经创建。可以以后用 SQL 命令
COMMENT ON DATABASE创建注释。
如果出现错误条件，将显示后端错误消息。可能的情况请参阅CREATE DATABASE和psql。
环境
PGDATABASE如果设置了该变量，其值就是要创建的数据库名称，除非被命令行覆盖。
PGHOSTPGPORTPGUSER默认连接参数。如果命令行和
PGDATABASE都没有指定要创建的数据库名称，则PGUSER也会决定该名称。
示例
要使用默认数据库服务器创建demo数据库：
$createdb demoCREATE DATABASE
其响应与你直接运行CREATE DATABASE SQL命令所得到的相同。
用主机 eden 上的服务器、端口 5000 创建数据库 demo，使用
LATIN1 编码方案并看一看底层查询：
$createdb -p 5000 -h eden -E LATIN1 -e demoCREATE DATABASE "demo" WITH ENCODING = 'LATIN1'CREATE DATABASE