1.简介
createdb 是一个命令行工具,该命令行工具位于
KingbaseES
安装目录的
bin
目录下。通常,执行这个命令的 数据库用户将成为新数据库的所有者。但是,如果执行用户具有合适的权限,可以通过-O
选项指定一个不同的所有者。
2.命令行参数
createdb
[
connection-option
...] [
option
...] [
dbname
[
description
]]
3.参数说明
dbname
指定要被创建的数据库名。该名称必须在这个集簇中所有
KingbaseES
数据库名中唯一,默认是创建一个 与当前系统用户同名的数据库。
description
指定与新创建的数据库相关联的一段注释信息。
-D tablespace --tablespace=tablespace
指定该数据库使用的默认表空间(这个名称被当做一个双引号引用的标识符处理)。
-e --echo
回显
createdb
生成并发送到服务器的命令信息。
-E encoding --encoding=encoding
指定要在这个数据库中使用的字符编码模式。
KingbaseES
服务器支持的字符集在 字符集支持中描述。
-l locale --locale=locale
指定要在这个数据库中使用的区域。这等效于同时指定
--lc-collate
和
--lc-ctype
。
--lc-collate=locale
指定要在这个数据库中使用的
LC_COLLATE
设置。
--lc-ctype=locale
指定要在这个数据库中使用的
LC_CTYPE
设置。
-O owner --owner=owner
指定拥有这个新数据库的数据库用户(这个名称被当做一个双引号引用的标识符处理)。
-T template --template=template
指定用于创建这个数据库的模板数据库(这个名称被当做一个双引号引用的标识符处理)。
-V --version
打印
createdb
版本并退出。
-? --help
显示关于
createdb
命令参数的帮助信息并退出。
选项
-D
、
-l
、
-E
、
-O
和
-T
对应于底层
SQL
命令
CREATE DATABASE
的选项,关于这些选项的信息可见该命令的内容。
createdb
也接受下列命令行参数用于连接参数:
-h host --host=host
指定运行服务器的机器的主机名。如果该值以一个斜线开始,它被用作
Unix
域套接字的目录。
-p port --port=port
指定服务器正在监听连接的
TCP
端口或本地
Unix
域套接字文件扩展。
-U username --username=username
要使用哪个用户连接到数据库。
-w --no-password
从不发出一个输入密码提示。如果服务器要求密码认证并且没有其他方式提供密码(例如一个
.kbpass
文 件),那么连接尝试将会失败。这个选项对于批处理任务和脚本有用,因为在其中没有一个用户来输入密码。
-W --password
强制
createdb
在连接到一个数据库之前提示要求输入一个密码。
--maintenance-db=dbname
指定要连接到用来发现那些其它数据库应该被集簇的数据库的名字。如果没有指定,将使用
kingbase
数据库。而如果它也不存在,将使用 template1
。