vb_initdb

功能描述

vb_initdb工具用于初始化数据库，在初始化数据库时会创建数据库目录、生成大量系统表和系统视图、创建默认数据库和模板数据库。

初始化时生成的数据库如下所示：

• template1：模板数据库，当以后再创建一个新的数据库时，template1数据库里的所有内容都会拷贝到新数据库中。通过vb_initdb的参数可以决定template1数据库的设置。

• template0：Vastbase提供的最初始的备份数据库，可用template0作为模板生成“干净”的数据库。

• postgres：提供给用户，工具和第三方应用的缺省数据库。

注意事项

• 在安装数据库时，推荐使用-D参数调用vb_initdb初始化数据库。如果由于故障恢复等原因，需要重新初始化一个数据库，可以通过执行vb_initdb来完成。

• 尽管vb_initdb会尝试创建相应的数据目录，但可能没有权限执行此操作，因为要创建目录的父目录通常被root所拥有。如果要创建数据目录，首先用root用户创建一个空数据目录，然后用chown命令把该目录的所有权交给数据库用户。

• vb_initdb决定template1数据库的设置，而该设置将会成为其他数据库的默认设置。

• vb_initdb初始化数据vb库的缺省区域和字符集编码。字符集编码、字符编码排序（LC_COLLATE）和字符集类（LC_CTYPE，如大写、小写数字等）可以在创建数据库时独立设置。

语法格式

vb_initdb [OPTION]... [DATADIR]

参数说明

• -A, --auth=METHOD

  指定本地用户连接数据库时的认证方法，即“pg_hba.conf”配置文件中host和local所在行的认证方法。

  METHOD取值范围：trust、reject、md5（不安全的算法，为了兼容老版本而存在）、sha256、sm3

  默认值：trust

  

  • 除非用户对本地用户都是信任的，否则不要使用默认值trust。
  • 若取值为md5，则需手动修改参数文件 postgresql.conf.sample中的密码存储类型 password_encryption_type参数的值修改为0，且放开注释使之生效。vs_initdb工具需同时配合-W选项一起使用。

• --auth-host=METHOD

  指定本地用户通过TCP/IP连接数据库时的认证方法，即：“pg_hba.conf”配置文件中host所在行的认证方法。

  METHOD取值范围：trust、reject、md5（不安全的算法，为了兼容老版本而存在）、sha256、sm3

  默认值：trust

  

  指定此参数则会覆盖-A参数的值。

• --auth-local=METHOD

  指定本地用户通过Unix域套接字连接数据库时的认证方法，即“pg_hba.conf”配置文件中local所在行的认证方法。

  METHOD取值范围：trust、reject、md5（不安全的算法，为了兼容老版本而存在）、sha256、sm3、peer（仅用于local模式）

  默认值：trust

  

  指定此参数则会覆盖-A参数的值。

• -c, --enable-dcf

  指定安装的节点为DCF模式。

• [-D, --pgdata=]DATADIR

  指定数据目录的位置。

  DATADIR的取值：用户自定义。

  

  不能包括“|”， “;”，“&”，“$”，“<”，“>”，“`”，“\”，“!”这几个字符。

• --nodename=NODENAME

  初始化的节点名称。

  

  节点的命名需要遵守如下规范： - 节点名称必须为小写字母（a-z）、下划线（_）、特殊符号#、数字（0-9）。 - 节点名称必须以小写字母（a-z）或下划线（_）开头。 - 节点名称不能为空，且最大的长度为64个字符。

• -E, --encoding=ENCODING

  指定数据库编码格式。

  

  • 不能包括“|”， “;”，“&”，“$”，“<”，“>”，“`”，“\”，“!”这几个字符。
  • 如果使用此参数，需要加上--locale选项指定支持此编码格式的区域。如果不加--locale选项，则采用系统默认的区域，如果系统默认区域的编码格式和用此参数指定的编码格式不匹配则会导致数据库初始化失败。

  • 如果不指定此参数，则使用系统默认区域的编码格式。系统默认区域和编码格式可以使用locale命令查看，如下：

    locale | grep LC_CTYPE
    

• --locale=LOCALE

  指定数据库的缺省区域，如果不希望指定特定的区域，则可以用C。可以用locale -a命令查看可用的区域。

  例如用户要将数据库编码格式初始化为GBK，可以采用如下步骤：

  1、用locale -a | grep gbk命令查看系统支持gbk编码的区域。

  locale -a | grep gbk
  

  显示结果为：

  zh_CN.gbk
  zh_SG.gbk
  

  2、初始化数据库时加入--locale=zh_CN.gbk选项。

  

  • 如果用户设置了数据库的编码格式，则用户选择区域的编码格式必须与用户设置的编码格式一致，否则数据库初始化会失败。
  • 不能包括“|”， “;”，“&”，“$”，“<”，“>”，“`”，“\”，“!”这几个字符。

• --dbcompatibility=DBCOMPATIBILITY

  指定兼容的数据库的类型。

  取值范围：A、B、C、PG。分别表示兼容Oracle、MySQL、Teradata、POSTGRES。

  

  指定该选项会影响默认Vastbase库的兼容模式，以及使用CREATE DATABASE新建库时的默认兼容模式。

• --pad-attribute=PADATTRIBUTE

  指定数据库默认的列校对规则。

  取值范围：

  • N,NO PAD：把字符串尾端的空格当作一个字符处理，即字符串等值比较不忽略尾端空格。
  • S,PAD SPACE：字符串等值比较忽略尾端空格。

  默认值：N,NO PAD

  

  支持版本：

  • V2.2 Build 10(Patch No.8)及以后补丁版本。
  • V2.2 Build 12及以后版本。
    

• --lc-collate=LOCALE, --lc-ctype=LOCALE, --lc-messages=LOCALE,--lc-monetary=LOCALE, --lc-numeric=LOCALE, --lc-time=LOCALE

  为新数据库设置指定范畴的区域。

  

  • 各参数的取值必须是操作系统支持的值。
  • 不能包括“|”， “;”，“&”，“$”，“<”，“>”，“`”，“\”，“!”这几个字符。

• --no-locale

  等价于和--locale=C。

• --pwfile=FILE

  执行vb_initdb命令时，从文件FILE中读取数据库中系统管理员的密码。该文件的第一行将被当作密码使用。

  

  • 不能包括“|”, “;”，“&”，“$”，“<”，“>”，“`”，“\”，“!”这几个字符。
  • FILE可以是“相对路径+文件”的形式，也可以是“绝对路径+文件”的形式。相对路径是相对当前路径的。

• -T, --text-search-config=CFG

  设置缺省的文本搜索方式。此配置项的值不会做正确性校验，配置成功后，有日志记录提醒当前配置项的取值。

  取值范围：

  • english：全文搜索。
  • simple：普通文本搜索。

  默认值：simple

• -U, --username=NAME

  选择数据库系统管理员的用户名。

  取值范围：正常的数据库用户。

  默认值：运行vb_initdb的操作系统用户。

  

  不能包括“|”, “;”，“&”，“$”，“<”，“>”，“`”，“\”，“!”这几个字符。

• -W, --pwprompt

  执行vb_initdb命令时强制交互式输入数据库管理员的密码。

• -w, --pwpasswd=PASSWD

  执行vb_initdb命令时通过命令行指定的管理员用户的密码，而不是交互式输入。

  

  设置的密码要符合复杂度要求：

  • 最少包含8个字符。
  • 不能和用户名和当前密码相同，或和当前密码反序。
  • 至少包含大写字母（A-Z）、小写字母（a-z）、数字、非字母数字字符（限定为“~”，“！”，“@”，“#”，“\$”，“\%”，“^”，“&”，“*”，“(”，“)”，“-”，“_”，“=”，“+”，“\”，“|”，“[”，“{”，“}”，“]”，“;”，“:”，“,”，“<”，“>”，“/”，“?”）四类字符中的三类字符。

• -C, --enpwdfiledir=DIR

  执行vb_initdb命令时指定的经AES128加密算法加密过的密码文件所在目录。vb_initdb会将该目录下密码文件进行解密，同时把解密后的密码做密码复杂度校验，校验通过的话会将此密码作为用户的密码。

  

  • 加密密码文件需使用vb_guc工具生成，例如vb_guc encrypt -K Gauss@123 -D Dir。
  • 如果用户指定多个-w和-C参数，vb_initdb会将用户输入的最后一个-w或-C参数作为用户的需求，即输入密码的明文或经过AES128加密后的密码。
  • 不能包括“|”, “;”，“&”，“$”，“<”，“>”，“`”，“\”，“!”这几个字符。

• -X, --xlogdir=XLOGDIR

  声明事务日志存储的目录。

  

  • 所设置的目录，必须满足运行Vastbase的用户有读写权限。

  • 只支持绝对路径。

  • 路径不能包括“|”, “;”，“&”，“$”，“<”，“>”，“`”，“\”，“!”这几个字符。

• -S, --security

  使用安全方式初始化数据库。以-S方式初始化的数据库后，创建的数据库用户权限受到限制，默认不再具有public schema的使用权限。

• -g, --xlogpath=XLOGPATH

  共享存储的XLOG文件路径。

• -d, --debug

  从初始化后端打印调试输出信息。初始化后端是vb_initdb用于创建系统表的程序。

• -L DIRECTORY

  vb_initdb初始化数据库所需要的输入文件的路径。

  

  • 该参数通常是不必要的。如果需要明确声明的话，程序会提示输入。因该参数意为创建指定配置信息的数据库，建议将share/postgresql下的所有涉及启动相关的子目录及文件全部复制过来，避免其他因素的影响。
  • 初始化数据库所需的输入文件路径。不能包括“|”,，“;”，“&”，“$”，“<”，“>”，“`”，“\”，“!”这几个字符。

• -n, --noclean

  这个选项禁止任何清理动作，因而对调试很有用。不指定该参数时，当vb_initdb发现一些错误妨碍它完成创建数据库的工作时，它将在检测到不能结束工作之前将其创建的所有文件删除。

• -s, --show

  显示内部设置。

• -H, --host-ip

  初始化Vastbase节点node_host。

  

  不能包括“|”,，“;”，“&”，“$”，“<”，“>”，“`”，“\”，“!”这几个字符。

• -V, --version

  打印vb_initdb版本信息，然后退出。

• -?, --help

  显示关于vb_initdb命令行参数的帮助信息，然后退出。

• --keyname=swkms_key_name

  使用三未信安硬件加密时的主密钥名。

• --userpin=username:password

  三未信安kms的用户密码。

• --algorithm=ENCRYPTALGORITHM

  硬件加密类型。

  取值范围：

  • SWS-KMS-SM4
  • TAS-KMS-SM4
    

--keyname=swkms_key_name，--userpin=username:password，--algorithm=ENCRYPTALGORITHM三个选项仅在Vastbase G100 V2.2 Build 10到Build 12版本支持。

使用示例

执行如下命令初始化数据库。

vb_initdb  -D /home/vastbase/data/vastbase --nodename vastbase -w vbase@123

/home/vastbase/data/vastbase为数据库目录，需要0700权限。详细请参见非实例化数据库安装。