gs_initdb
简介
背景信息
gs_initdb初始化数据库时，会创建数据库目录、生成系统表、创建默认数据库和模板数据库。
系统表
初始化数据库时会生成大量的系统表和视图，其中绝大部分都对任何数据库用户开放查看权限。
说明：
pg_user_status、pg_auth_history系统表权限只对初始化数据库用户和sysadmin用户开放。
生成的数据库
- template1：是一个模板数据库，当以后再创建一个新的数据库时，template1数据库里的所有内容都会拷贝到新数据库中。通过gs_initdb的参数可以决定template1数据库的设置。
- template0：是openGauss提供的最初始的备份数据库，当需要时可用template0作为模板生成“干净”的数据库。
- postgres：是一个提供给用户、工具和第三方应用的缺省数据库。
使用指导
背景信息
在安装时，推荐使用-D参数调用gs_initdb初始化数据库。如果由于故障恢复等原因，需要重新初始化一个数据库，可以通过执行gs_initdb来完成。
- 尽管gs_initdb会尝试创建相应的数据目录，但可能没有权限执行此操作，因为要创建目录的父目录通常被root所拥有。如果要创建数据目录，首先用root用户创建一个空数据目录，然后用chown把该目录的所有权交给数据库用户。
- gs_initdb决定template1数据库的设置，而该设置将会成为其他数据库的默认设置。
- gs_initdb初始化数据库的缺省区域和字符集编码。字符集编码、字符编码排序（LC_COLLATE）和字符集类（LC_CTYPE，如大写、小写数字等）可以在创建数据库时独立设置。
语法
gs_initdb [OPTION]... [DATADIR]
操作步骤
- 以操作系统用户omm登录数据库主节点。
规划数据库目录。
切换到root用户。
su - root
根据提示输入用户名和密码。
进入“/opt/gaussdb”目录，并创建“data1”目录。
cd /opt/gaussdbmkdir data1
执行gs_initdb命令初始化数据库。
gs_initdb -D /opt/gaussdb/data1 -w "Gauss@123" --nodename='data1'
命令参考
gs_initdb支持的常用参数和不常用参数请分别参见表 常用参数说明和表 不常用参数说明。
表 1 常用参数说明
参数
|
参数说明
|
取值范围
|
|---|
-A, —auth=METHOD
|
指定本地用户连接数据库时的认证方法，即“pghba.conf”配置文件中host和local所在行的认证方法。
除非用户对本地用户都是信任的，否则不要使用默认值trust。
须知： 若取值为md5，则需手动修改参数文件 postgresql.conf.sample 中的密码存储类型 password_encryption_type 参数的值，修改为0，且放开注释使之生效。gs_initdb工具需同时配合 -W 的使用。
|
METHOD的取值：
- trust
- reject
- md5（不安全的算法，为了兼容老版本而存在）
- sha256
- sm3
默认值：trust
|
—auth-host=METHOD
|
指定本地用户通过TCP/IP连接数据库时的认证方法，即：“pg_hba.conf”配置文件中host所在行的认证方法。
指定此参数则会覆盖-A参数的值。
|
METHOD的取值：
- trust
- reject
- md5（不安全的算法，为了兼容老版本而存在）
- sha256
- sm3
默认值：trust
|
—auth-local=METHOD
|
指定本地用户通过Unix域套接字连接数据库时的认证方法，即“pg_hba.conf”配置文件中local所在行的认证方法。
指定此参数则会覆盖-A参数的值。
|
METHOD的取值：
- trust
- reject
- md5（不安全的算法，为了兼容老版本而存在）
- sha256
- sm3
默认值：trust
|
[-D, —pgdata=]DATADIR
|
指定数据目录的位置。
|
DATADIR的取值：用户自定义。
|
—nodename=NODENAME
|
初始化的节点名称。
|
节点的命名需要遵守如下规范：
- 节点名称必须为小写字母（a-z）、下划线（）、特殊符号#、数字（0-9）或美元符号（$）。
- 节点名称必须以小写字母（a-z）或下划线（）开头。
- 节点名称不能为空，且最大的长度为64个字符。
|
-E, —encoding=ENCODING
|
为新数据库设置编码格式。
|
|
—locale=LOCALE
|
为新数据库设置缺省的区域。可以用locale -a查看可用的区域，如zh_CN.gbk等。如果不希望指定特定的区域，则可以用C。
须知： 如果用户设置了数据库的编码格式，则用户选择区域的编码格式必须与用户设置的编码格式一致，否则数据库初始化会失败。
|
例如用户要将数据库编码格式初始化为GBK，可以采用如下步骤：
- 用locale -a |grep gbk命令查看系统支持gbk编码的区域，如下：
- omm@linux:~> locale -a|grep gbk
- zh_CN.gbk
- zh_SG.gbk
- 初始化数据库时加入—locale=zh_CN.gbk选项。
|
—dbcompatibility=DBCOMPATIBILITY
|
指定兼容的数据库的类型。
|
取值范围：A、B、C、PG。分别表示兼容O、MY、TD和POSTGRES。
|
—lc-collate=LOCALE
—lc-ctype=LOCALE
—lc-messages=LOCALE
—lc-monetary=LOCALE
—lc-numeric=LOCALE
—lc-time=LOCALE
|
为新数据库设置指定范畴的区域。
|
各参数的取值必须是操作系统支持的值。
说明： 如果用户在数据库安装的时候没有指定—lc-collate参数，则—lc-collate参数的默认值为C。
|
—no-locale
|
和—locale=C等价。
|
-
|
—pwfile=FILE
|
gs_initdb时从文件FILE中读取数据库中系统管理员的密码。该文件的第一行将被当作密码使用。
|
FILE可以是“相对路径+文件”的形式，也可以是“绝对路径+文件”的形式。相对路径是相对当前路径的。
|
-T, —text-search-config=CFG
|
设置缺省的文本搜索方式。此配置项的值不会做正确性校验，配置成功后，有日志记录提醒当前配置项的取值。
|
text-search-config的取值：
默认值：simple
|
-U, —username=NAME
|
选择数据库系统管理员的用户名。
|
取值范围：正常的数据库用户。
默认值：运行gs_initdb的操作系统用户。
|
-W, —pwprompt
|
gs_initdb时强制交互式输入数据库管理员的密码。
|
-
|
-w, —pwpasswd=PASSWD
|
gs_initdb时通过命令行指定的管理员用户的密码，而不是交互式输入。
|
设置的密码要符合复杂度要求：
- 最少包含8个字符；
- 不能和用户名和当前密码（ALTER）相同，或和当前密码反序；
- 至少包含大写字母（A-Z）、小写字母（a-z）、数字、非字母数字字符（限定为~!@#$%^&*()-=+|[{}];:,<.>/?）四类字符中的三类字符。
|
-C, —enpwdfiledir=DIR
|
gs_initdb时指定的经AES128加密算法加密过的密码文件所在目录。gs_initdb会将该目录下密码文件进行解密，同时把解密后的密码做密码复杂度校验，校验通过的话会将此密码作为用户的密码。
说明： - 加密密码文件需使用gs_guc工具生成：gs_guc encrypt -K Gauss@123 -D Dir。
- 如果用户指定多个-w和-C参数，gs_initdb会将用户输入的最后一个-w或-C参数作为用户的需求，即输入密码的明文或经过AES128加密后的密码。
|
-
|
-X, —xlogdir=XLOGDIR
|
声明事务日志存储的目录。
所设置的目录，必须满足运行openGauss的用户有读写权限。
|
只支持绝对路径。
|
-S, —security
|
安全方式初始化数据库。
|
以-S方式初始化的数据库后，创建的数据库用户权限受到限制，默认不再具有public schema的使用权限。
|
表 2 不常用参数说明
参数
|
参数说明
|
取值范围
|
|---|
-d, —debug
|
从初始化后端打印调试输出信息。初始化后端是gs_initdb用于创建系统表的程序。
|
-
|
-L DIRECTORY
|
gs_initdb初始化数据库所需要的输入文件的路径。通常是不必要的。如果需要明确声明的话，程序会提示输入。因该参数意为创建指定配置信息的数据库，建议将share/postgresql下的所有涉及启动相关的子目录及文件全部复制过来，避免其他因素的影响。
|
初始化数据库所需的输入文件路径。
|
-n, —noclean
|
不指定该参数时，当gs_initdb发现一些错误妨碍它完成创建数据库的工作时，它将在检测到不能结束工作之前将其创建的所有文件删除。这个选项禁止任何清理动作，因而对调试很有用。
|
-
|
-s, —show
|
显示内部设置。
|
-
|
-V, —version
|
打印gs_initdb版本信息，然后退出。
|
-
|
-?, —help
|
显示关于gs_initdb命令行参数的帮助信息，然后退出。
|
-
|
我的书签
添加书签
移除书签
