createdb

创建一个新数据库。

概要

  1. createdb [connection_option ...] [-D tablespace] [-E encoding] 
  2.         [-O owner] [-T template] [-e] [dbname ['description']]
  4. createdb --help 
  6. 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：

  1. createdb test

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

  1. createdb -p 54321 -h gpmaster -E LATIN1 demo

另见

CREATE DATABASE