createdb
createdb — 创建一个新的PostgreSQL数据库
大纲
createdb [option...] [dbname] [description]
描述
createdb创建一个新的PostgreSQL数据库。
通常,执行此命令的数据库用户会成为新数据库的所有者。不过,如果执行用户具有相应的权限,也可以通过-O选项指定不同的所有者。
createdb是SQL命令CREATE DATABASE的包装器。通过此工具创建数据库与通过其他访问服务器的方法创建数据库,在效果上没有区别。
选项
createdb accepts the following command-line arguments:
dbname指定要创建的数据库名称。该名称必须在此数据库集簇中的所有PostgreSQL数据库中唯一。默认情况下,会创建一个与当前系统用户同名的数据库。
description指定要与新创建的数据库关联的注释。
-Dtablespace--tablespacetablespace指定数据库的默认表空间。
-e--echo回显createdb生成并发送到服务器的命令。
-Eencoding--encodingencoding指定该数据库使用的字符集编码。PostgreSQL服务器支持的字符集见第 21.2.1 节。
-Oowner--ownerowner指定将拥有新数据库的数据库用户。
-q--quiet不显示响应。
-Ttemplate--templatetemplate指定用于构建该数据库的模板数据库。
-D、-E、-O和-T选项对应底层 SQL 命令CREATE DATABASE的选项;有关这些选项的更多信息请参见该命令。
createdb还接受以下用于连接参数的命令行参数:
-hhost--hosthost指定服务器所在机器的主机名。如果该值以斜杠开头,则它将被用作 Unix 域套接字的目录。
-pport--portport指定服务器监听连接所用的 TCP 端口或本地 Unix 域套接字文件扩展名。
-Uusername--usernameusername以该用户名进行连接。
-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