pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
createdb — 创建新的PostgreSQL数据库
createdb [option...] [dbname] [description]
createdb创建一个新的PostgreSQL数据库。
通常,执行此命令的数据库用户会成为新数据库的所有者。不过,如果执行用户具有相应的权限,也可以通过-O选项指定不同的所有者。
createdb是SQL命令CREATE DATABASE的包装器。通过此工具创建数据库与通过其他访问服务器的方法创建数据库,在效果上没有区别。
createdb接受以下命令行参数:
dbname指定要创建的数据库名称。该名称必须在此数据库集簇中的所有PostgreSQL数据库中唯一。 默认情况下,会创建一个与当前系统用户同名的数据库。
description指定要与新创建的数据库关联的注释。
-D tablespace--tablespace tablespace指定数据库的默认表空间。
-e--echo回显createdb生成并发送到服务器的命令。
-E encoding--encoding encoding指定该数据库使用的字符集编码。PostgreSQL服务器支持的字符集见第 20.2.1 节。
-O owner--owner owner指定将拥有新数据库的数据库用户。
-q--quiet不显示响应。
-T template--template template指定用于构建该数据库的模板数据库。
-D、-E、-O和-T选项对应底层 SQL 命令CREATE DATABASE的选项;有关这些选项的更多信息请参见该命令。
createdb还接受以下用于连接参数的命令行参数:
-h host--host host指定服务器所在机器的主机名。如果该值以斜杠开头,则它将被用作 Unix 域套接字的目录。
-p port--port port指定服务器监听连接所用的 TCP 端口或本地 Unix 域套接字文件扩展名。
-U username--username username以该用户名进行连接。
-W--password强制提示输入密码。
PGDATABASE如果设置了该变量,其值就是要创建的数据库名称,除非被命令行覆盖。
PGHOSTPGPORTPGUSER默认连接参数。如果命令行和PGDATABASE都没有指定要创建的数据库名称,则PGUSER也会决定该名称。
如果遇到问题,请参阅CREATE DATABASE和psql中关于潜在问题和错误消息的讨论。数据库服务器必须在目标主机上运行。此外,由libpq前端库使用的任何默认连接设置和环境变量也都会生效。
要使用默认数据库服务器创建demo数据库:
$createdb demoCREATE DATABASE
其响应与你直接运行CREATE DATABASE SQL命令所得到的相同。
要使用主机eden上、端口为 5000 的服务器,并以 LATIN1编码方案创建demo数据库, 可以看看下面的底层命令:
$createdb -p 5000 -h eden -E LATIN1 -e demoCREATE DATABASE "demo" WITH ENCODING = 'LATIN1'CREATE DATABASE
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。