createdb — 创建一个新的 PostgreSQL 数据库
createdb [连接选项...] [选项...] [dbname [描述]]
createdb 创建一个新的 PostgreSQL 数据库。
通常，执行此命令的数据库用户将成为新数据库的所有者。但是，如果执行用户具有适当的权限，可以通过 -O 选项指定不同的所有者。
createdb 是围绕SQL命令 CREATE DATABASE 的一个包装器。通过此实用程序创建数据库与通过其他访问服务器的方法创建数据库之间没有实际区别。
createdb 接受以下命令行参数：
dbname指定要创建的数据库的名称。该名称必须在此集群中的所有 PostgreSQL 数据库中是唯一的。默认是创建一个与当前系统用户同名的数据库。
描述指定与新创建的数据库关联的注释。
-D 表空间--tablespace=表空间指定数据库的默认表空间。（此名称被视为双引号标识符。）
-e--echo回显 createdb 生成并发送到服务器的命令。
-E 编码--encoding=编码指定在此数据库中使用的字符编码方案。PostgreSQL 服务器支持的字符集在 第 23.3.1 节 中描述。
-l locale--locale=locale指定在此数据库中使用的区域设置。这等效于将 --lc-collate、--lc-ctype 和 --icu-locale 设置为相同的值。某些区域设置仅对 ICU 有效，必须使用 --icu-locale 进行设置。
--lc-collate=locale指定在此数据库中使用的 LC_COLLATE 设置。
--lc-ctype=locale指定在此数据库中使用的 LC_CTYPE 设置。
--builtin-locale=locale指定使用内置提供程序时的区域设置名称。区域设置支持在 第 23.1 节 中描述。
--icu-locale=locale如果选择了 ICU 区域设置提供程序，则指定在此数据库中使用的 ICU 区域设置 ID。
--icu-rules=规则指定额外的排序规则以自定义此数据库的默认排序规则的行为。这仅支持 ICU。
--locale-provider={builtin|libc|icu}指定数据库的默认排序规则的区域设置提供程序。
-O 所有者--owner=所有者指定将拥有新数据库的数据库用户。（此名称被视为双引号标识符。）
-S 策略--strategy=策略指定数据库创建策略。有关详细信息，请参阅 CREATE DATABASE STRATEGY。
-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=dbname指定创建新数据库时要连接到的数据库的名称。如果未指定，则将使用 postgres 数据库；如果该数据库不存在（或者它是正在创建的新数据库的名称），则将使用 template1。这可以是 连接字符串。如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。
PGDATABASE如果设置，则为要创建的数据库的名称，除非在命令行上被覆盖。
PGHOSTPGPORTPGUSER默认连接参数。如果未在命令行上或通过 PGDATABASE 指定，则 PGUSER 也确定要创建的数据库的名称。
PG_COLOR指定是否在诊断消息中使用颜色。可能的值为 always、auto 和 never。
这个工具，和大多数其他的 PostgreSQL 工具一样，也使用 libpq 支持的环境变量（参见 第 32.15 节）。
如果遇到困难，请参阅 CREATE DATABASE 和 psql，其中讨论了潜在的问题和错误消息。数据库服务器必须在目标主机上运行。此外，libpq 前端库使用的任何默认连接设置和环境变量都将适用。
要使用默认数据库服务器创建数据库 demo
$createdb demo
要使用主机 eden 上端口 5000 的服务器，使用 template0 模板数据库创建数据库 demo，以下是命令行命令和底层 SQL 命令
$createdb -p 5000 -h eden -T template0 -e demoCREATE DATABASE demo TEMPLATE template0;
如果您在文档中发现任何不正确、与您使用特定功能的体验不符或需要进一步澄清的内容，请使用此表单报告文档问题。