createdb — 创建一个新的 PostgreSQL 数据库
createdb [连接选项...] [选项...] [数据库名 [描述]]
createdb 创建一个新的 PostgreSQL 数据库。
通常,执行此命令的数据库用户将成为新数据库的所有者。但是,如果执行用户具有适当的权限,则可以通过 -O 选项指定不同的所有者。
createdb 是一个围绕SQL命令 CREATE DATABASE 的包装器。通过此实用程序创建数据库与通过其他方法访问服务器创建数据库之间没有实际区别。
createdb 接受以下命令行参数
dbname指定要创建的数据库的名称。该名称在该集群的所有 PostgreSQL 数据库中必须是唯一的。默认情况下,将创建一个与当前系统用户同名的数据库。
描述指定一个要与新创建的数据库关联的注释。
-D 表空间--tablespace=表空间指定数据库的默认表空间。(此名称被处理为带双引号的标识符。)
-e--echo回显 createdb 生成并发送到服务器的命令。
-E 编码--encoding=编码指定此数据库中要使用的字符编码方案。 PostgreSQL 服务器支持的字符集在 第 23.3.1 节 中进行了描述。
-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 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=数据库名指定创建新数据库时要连接的数据库的名称。如果未指定,将使用 postgres 数据库;如果该数据库不存在(或者它就是正在创建的新数据库的名称),则将使用 template1。这可以是一个 连接字符串。如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。
PGDATABASE如果设置,则为要创建的数据库的名称,除非在命令行中被覆盖。
PGHOSTPGPORTPGUSER默认连接参数。 PGUSER 也决定了要创建的数据库的名称,如果该名称未在命令行或通过 PGDATABASE 指定。
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;