createdb

创建一个新数据库。

概要

createdb [connection_option ...] [-D tablespace] [-E encoding] 
        [-O owner] [-T template] [-e] [dbname ['description']]

createdb --help 

createdb --version

描述

createdb在Greenplum数据库系统中创建一个新数据库。

通常，执行这个命令的数据库用户会变成新数据库的拥有者。不过，如果执行用户有适当的特权，可以通过-O选项指定一个不同的拥有者。

createdb是SQL命令CREATE DATABASE的包装程序。

选项

dbname: 要创建的数据库名。如果没有指定，会从环境变量PGDATABASE中读取数据库名。如果PGDATABASE也没设置，则使用PGUSER的值。如果还是没有设置，则默认为当前系统用户名。
description: 与新创建的数据库相关的一段注释。包含空格的描述必须被封闭在引号中。
-D tablespace | --tablespace tablespace: 该数据库的默认表空间。
-e echo: 回显createdb生成并且发送给服务器的命令。
-E encoding | --encoding encoding: 在新数据库中使用的字符集编码。指定一个字符串常量（例如'UTF8'）、一个整数编码编号或者指定DEFAULT以使用默认编码。有关支持的字符集的信息请见Greenplum数据库参考指南。
-O owner | --owner owner: 将拥有新数据库的数据库用户名。默认为执行这一命令的用户。
-T template | --template template: 要从其创建新数据库的模板名。默认为template1.

连接选项

-h host | --host host: 指定Greenplum的Master数据库服务器在其上运行的机器的主机名。如果没有指定，会从环境变量PGHOST读取或者默认为localhost。
-p port | --port port: 指定Greenplum的Master数据库服务器在其上监听连接的TCP端口。如果没有指定，会从环境变量PGPORT读取或者默认为5432。
-U username | --username username: 要用其进行连接的数据库角色名。如果没有指定，会从环境变量PGUSER读取或者默认为当前系统用户名。
-w | --no-password: 从不发出口令提示。如果服务器要求口令认证并且不能通过其他方式（例如.pgpass文件）提供口令，则连接尝试将会失败。这个选项对于批作业和脚本很有用，因为这些情况下不会有用户输入口令。
-W | --password: 强制口令提示。

示例

要使用默认选项创建数据库test：

createdb test

要使用主机gpmaster、端口54321上的Greenplum的Master并且使用LATIN1编码创建数据库demo：

createdb -p 54321 -h gpmaster -E LATIN1 demo

另见

CREATE DATABASE