createdb

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