pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
createdb — 创建一个新的 PostgreSQL 数据库
createdb [options...] [dbname] [description]
createdb创建一个新的PostgreSQL数据库。
通常，执行此命令的数据库用户会成为新数据库的所有者。不过，如果执行用户具有相应的权限，也可以通过-O选项指定不同的所有者。
createdb 是围绕 SQL 命令 CREATE DATABASE 的一个 shell 脚本包装，它通过 PostgreSQL 交互式终端 psql 执行。因此， 用这种方法或其他方法创建数据库 并没有什么特别之处。这意味着 脚本必须能找到 psql 程序，而且 目标端口上必须有数据库服务器在 运行。此外， psql 和 libpq 前端库可用的任何默认 设置和环境变量都将适用。
createdb 接受下列命令行参数：
dbname指定要创建的数据库的名称。该名称在本 安装中的所有 PostgreSQL 数据库中必须 唯一。默认创建一个与 当前系统用户同名的 数据库。
description可选地指定与新创建的数据库 关联的注释。
-D location--location location指定数据库的备选位置。另见 initlocation。
-e--echo回显 createdb 生成并发送给服务器的 查询。
-E encoding--encoding encoding指定该数据库使用的字符编码方案。
-O owner--owner owner指定将拥有新数据库的数据库用户。
-q--quiet不显示响应。
-T template--template template指定用于构建该数据库的模板数据库。
-D、-E、-O和-T选项对应底层 SQL 命令CREATE DATABASE的选项；有关这些选项的更多信息请参见该命令。
createdb 还接受下列 用于连接参数的命令行参数：
-h host--host host指定服务器 所在机器的主机名。如果 host 以斜线开头，它被用作 Unix 域套接字的目录。
-p port--port port指定服务器 正在监听连接的 Internet TCP/IP 端口或本地 Unix 域套接字文件扩展名。
-U username--username username以该用户名进行连接。
-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
译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。