createdb

功能描述

createdb工具用于创建一个新的数据库。

createdb是对SQL命令CREATE DATABASE的封装。

语法格式

createdb [OPTION]... [DBNAME] [DESCRIPTION]

• DBNAME：要创建的数据库名。该名称应该在本节点的所有数据库中是唯一的。缺省创建的数据库名称是与当前系统用户同名。

• DESCRIPTION：指定与新创建的数据库相关的注释。

参数说明

通用参数

• -D, --tablespace=TABLESPACE

  指定数据库默认表空间。

• -e, --echo

  回显createdb生成并发送到服务端的命令。

• -E, --encoding=ENCODING

  指定数据库编码格式。

• -l, --locale=LOCALE

  指定在此数据库中使用的语言环境。 这相当于同时指定--lc-collate和--lc-ctype选项。

• --lc-collate=LOCALE

  指定新数据库使用的字符集。

  取值范围：操作系统支持的字符集。

• --lc-ctype=LOCALE

  指定新数据库使用的字符分类。

  取值范围：操作系统支持的字符分类。

• -O, --owner=OWNER

  指定将拥有新数据库的用户。

• -T, --template=TEMPLATE

  指定创建此数据库的模板数据库。

• -V, --version

  输出createdb命令的版本信息，然后退出。

• -?, --help

  显示createdb命令的帮助信息，然后退出。

选项-D，-l，-E，-O，--lc-collate=LOCALE，--lc-ctype=LOCALE和-T对应底层的SQL命令CREATE DATABASE的选项，详细内容请参考CREATE DATABASE参数说明。

连接参数

• -h, --host=HOSTNAME

  指定运行服务器的主机名，如果数值以斜杠开头则被用作到Unix域套接字的路径。

• -p, --port=PORT

  指定主机端口号。

• -U, --username=USERNAME

  指定所连接主机的用户名。

• -w, --no-password

  不出现输入密码提示。如果主机要求密码认证并且密码没有通过其它形式给出，则连接尝试将会失败。

• -W, --password

  指定用户连接的密码。

• --maintenance-db=DBNAME

  指定要创建新数据库时连接的数据库名称。

使用示例

用缺省数据库服务器创建一个demo数据库，指定其数据库编码格式并回显执行的命令。

createdb demo -E  'UTF-8' -e

显示内容如下所示：

CREATE DATABASE demo ENCODING 'UTF-8';