createdb — 创建新的 PostgreSQL 数据库
createdb [连接选项...] [选项...] [数据库名 [描述]]
createdb 创建一个新的 PostgreSQL 数据库。
通常，执行此命令的数据库用户将成为新数据库的所有者。但是，如果执行用户拥有适当的权限，可以通过 -O 选项指定不同的所有者。
createdb 是对SQL命令 CREATE DATABASE 的包装器。通过此实用程序创建数据库与通过其他访问服务器的方法创建数据库之间没有实际差异。
createdb 接受以下命令行参数
数据库名指定要创建的数据库的名称。该名称必须在此群集中的所有 PostgreSQL 数据库中唯一。默认情况下，创建的数据库名称与当前系统用户相同。
描述指定要与新创建的数据库关联的注释。
-D 表空间--tablespace=表空间指定数据库的默认表空间。（此名称将被视为双引号标识符处理。）
-e--echo回显 createdb 生成的并发送到服务器的命令。
-E 编码--encoding=编码指定此数据库中要使用的字符编码方案。在 第 23.3.1 节 中描述了 PostgreSQL 服务器支持的字符集。
-l 语言环境--locale=语言环境指定此数据库中要使用的语言环境。这等效于将 --lc-collate、--lc-ctype 和 --icu-locale 指定为相同的值。某些语言环境仅对 ICU 有效，必须使用 --icu-locale 设置。
--lc-collate=语言环境指定此数据库中要使用的 LC_COLLATE 设置。
--lc-ctype=语言环境指定此数据库中要使用的 LC_CTYPE 设置。
--builtin-locale=语言环境使用内置提供程序时指定语言环境名称。语言环境支持在 第 23.1 节 中描述。
--icu-locale=语言环境如果选择了 ICU 语言环境提供程序，则指定此数据库中要使用的 ICU 语言环境 ID。
--icu-rules=规则指定其他排序规则以自定义此数据库的默认排序的运行行为。仅对 ICU 支持。
--locale-provider={builtin|libc|icu}指定数据库的默认排序的语言环境提供程序。
-O 所有者--owner=所有者指定将拥有新数据库的数据库用户。（此名称将被视为双引号标识符处理。）
-S 策略--strategy=策略指定数据库创建策略。有关更多详细信息，请参阅 CREATE DATABASE 策略。
-T 模板--template=模板指定要从中构建此数据库的模板数据库。（此名称将被视为双引号标识符处理。）
-V--version打印 createdb 版本并退出。
-?--help显示有关 createdb 命令行参数的帮助，并退出。
选项 -D、-l、-E、-O 和 -T 对应于底层 SQL 命令 CREATE DATABASE 的选项；有关这些选项的更多信息，请参阅此处。
createdb 还接受以下命令行参数以用于连接参数
-h 主机--host=主机指定运行服务器的机器的主机名。如果值以斜杠开头，则将其用作 Unix 域套接字的目录。
-p 端口--port=端口指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展名。
-U 用户名--username=用户名要连接的用户名称。
-w--no-password从不发出密码提示。如果服务器需要密码身份验证并且没有通过其他方式（例如 .pgpass 文件）提供密码，则连接尝试将失败。此选项在没有用户存在来输入密码的批处理作业和脚本中可能很有用。
-W--password强制 createdb 在连接到数据库之前提示输入密码。
此选项永远不是必需的，因为如果服务器要求密码身份验证，createdb 将自动提示输入密码。但是，createdb 会浪费连接尝试来发现服务器需要密码。在某些情况下，输入 -W 以避免额外的连接尝试是值得的。
--maintenance-db=数据库名指定创建新数据库时要连接到的数据库的名称。如果未指定，则将使用 postgres 数据库；如果不存在（或者它是要创建的新数据库的名称），则将使用 template1。这可以是 连接字符串。如果是，则连接字符串参数将覆盖任何冲突的命令行选项。
PGDATABASE如果设置，则为要创建的数据库的名称，除非在命令行中被覆盖。
PGHOSTPGPORTPGUSER默认连接参数。如果未在命令行或 PGDATABASE 中指定，PGUSER 还会确定要创建的数据库的名称。
PG_COLOR指定是否在诊断消息中使用颜色。可能的值为 always、auto 和 never。
此实用程序（与大多数其他 PostgreSQL 实用程序一样）还使用 libpq 支持的环境变量（请参阅 第 32.15 节）。
如果遇到困难，请参阅 CREATE DATABASE 和 psql 以了解潜在问题和错误消息的讨论。数据库服务器必须在目标主机上运行。此外，libpq 前端库使用的任何默认连接设置和环境变量都将适用。
要使用默认数据库服务器创建数据库 demo
$createdb demo
要使用主机 eden 上的服务器（端口 5000）创建数据库 demo，并使用 template0 模板数据库，以下是命令行命令和底层 SQL 命令
$createdb -p 5000 -h eden -T template0 -e demoCREATE DATABASE demo TEMPLATE template0;
如果您在文档中发现任何错误、与您对特定功能的体验不符或需要进一步说明的内容，请使用此表格 报告文档问题。