pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
createdb — 创建一个新的 PostgreSQL 数据库
createdb [option...] [dbname] [description]
createdb创建一个新的PostgreSQL数据库。
通常,执行此命令的数据库用户会成为新数据库的所有者。不过,如果执行用户具有相应的权限,也可以通过-O选项指定不同的所有者。
createdb是SQL命令CREATE DATABASE的包装器。通过此工具创建数据库与通过其他访问服务器的方法创建数据库,在效果上没有区别。
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指定服务器所在机器的主机名。如果该值以斜杠开头,则它将被用作 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 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。