命令参考

命令参考

gs_initdb支持的常用参数和不常用参数请分别参见表1和表2。

表 1 常用参数说明

参数 参数说明 取值范围
-A, —auth=METHOD 指定本地用户连接数据库时的认证方法，即“pghba.conf”配置文件中host和local所在行的认证方法。 除非用户对本地用户都是信任的，否则不要使用默认值trust。 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 - peer（仅用于local模式） 默认值：trust
-c, —enable-dcf 设置安装的节点为DCF模式。 说明： 轻量版场景下，openGauss提供此参数，但DCF功能不可用。对于DCF功能，openGauss提供选主能力，用户若使用需自行配置。 -
[-D, —pgdata=]DATADIR 指定数据目录的位置。 DATADIR的取值：用户自定义。不能包括”
-E, —encoding=ENCODING 为新数据库设置编码格式。 - 如果使用此参数，需要加上—locale选项指定支持此编码格式的区域。如果不加—locale选项，则采用系统默认的区域，如果系统默认区域的编码格式和用此参数指定的编码格式不匹配则会导致数据库初始化失败。 - 如果不指定此参数，则使用系统默认区域的编码格式。系统默认区域和编码格式可以使用locale命令查看，如下： 1. omm@linux:~> locale|grep LC_CTYPE 2. LC_CTYPE=”en_US.UTF-8” 其中UTF-8表示系统默认区域的编码格式。 不能包括”
—dbcompatibility=DBCOMPATIBILITY 为新数据库设置默认db兼容性。 不能包括”
—no-locale 和—locale=C等价。 -
—pwfile=FILE gs_initdb时从文件FILE中读取数据库中系统管理员的密码。该文件的第一行将被当作密码使用。 FILE可以是“相对路径+文件”的形式，也可以是“绝对路径+文件”的形式。相对路径是相对当前路径的。不能包括”
-W, —pwprompt gs_initdb时强制交互式输入数据库管理员的密码。 -
-w, —pwpasswd=PASSWD gs_initdb时通过命令行指定管理员用户的密码，而不是交互式输入。 设置的密码要符合复杂度要求： - 最少包含8个字符； - 不能和用户名及当前密码（ALTER）相同，或和当前密码反序； - 至少包含如下字符中的三类： - 大写字母（A-Z）。 - 小写字母（a-z）。 - 数字（0-9）。 - 特殊字符（限定为~!@#$%^&*()-=+
-C, —enpwdfiledir=DIR gs_initdb时指定的经AES128加密算法加密过的密码文件所在目录。gs_initdb会将该目录下密码文件进行解密，同时把解密后的密码做密码复杂度校验，校验通过的话会将此密码作为用户的密码。 说明： - 加密密码文件需使用gs_guc工具生成：gs_guc encrypt -K password -D Dir。 - 如果用户指定多个-w和-C参数，gs_initdb会将用户输入的最后一个-w或-C参数作为用户的需求，即输入密码的明文或经过AES128加密后的密码。 不能包括”
-S, —security 安全方式初始化数据库。 以-S方式初始化的数据库后，创建的数据库用户权限受到限制，默认不再具有public schema的使用权限。

表 2 不常用参数说明

参数 参数说明 取值范围
-d, —debug 从初始化后端打印调试输出信息。初始化后端是gs_initdb用于创建系统表的程序。 -
-L DIRECTORY gs_initdb初始化数据库所需要的输入文件的路径。通常是不必要的。如果需要明确声明的话，程序会提示输入。 初始化数据库所需的输入文件路径。不能包括”
-V, —version 打印gs_initdb版本信息，然后退出。 -
-?, —help 显示关于gs_initdb命令行参数的帮助信息，然后退出。 -
-g 针对共享存储的跨AZ容灾数据库实例的初始化，指定共享xlog日志文件的路径。 指定的共享日志文件路径。不能包括”