命令参考

命令参考

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

表 1 常用参数说明

参数

参数说明

取值范围

-A, --auth=METHOD

指定本地用户连接数据库时的认证方法,即“pg_hba.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的取值:用户自定义。不能包括"|", ";", "&", "$", "<", ">", "`", "\\", "!"这几个字符。

--nodename=NODENAME

初始化的节点名称。

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

-E, --encoding=ENCODING

为新数据库设置编码格式。

  • 如果使用此参数,需要加上--locale选项指定支持此编码格式的区域。如果不加--locale选项,则采用系统默认的区域,如果系统默认区域的编码格式和用此参数指定的编码格式不匹配则会导致数据库初始化失败。
  • 如果不指定此参数,则使用系统默认区域的编码格式。系统默认区域和编码格式可以使用locale命令查看,如下:
    omm@linux:~> locale|grep LC_CTYPE
    LC_CTYPE="en_US.UTF-8"
    

    其中UTF-8表示系统默认区域的编码格式。

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

--locale=LOCALE

为新数据库设置缺省的区域。

须知:

  • 如果用户设置了数据库的编码格式,则用户选择区域的编码格式必须与用户设置的编码格式一致,否则数据库初始化会失败。
  • 当指定了数据库的编码格式为GB18030_2022时,则参数locale的取值范围与GB18030保持一致。
  • 例如用户要将数据库编码格式初始化为GBK,可以采用如下步骤:

    1. 用locale -a |grep gbk命令查看系统支持gbk编码的区域,如下:
      omm@linux:~>  locale -a|grep gbk
      zh_CN.gbk
      zh_SG.gbk
      
    2. 初始化数据库时加入--locale=zh_CN.gbk选项。
    3. 不能包括"|", ";", "&", "$", "<", ">", "`", "\\", "!"这几个字符。

    --dbcompatibility=DBCOMPATIBILITY

    为新数据库设置默认db兼容性。

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

    --lc-collate=LOCALE

    --lc-ctype=LOCALE

    --lc-messages=LOCALE

    --lc-monetary=LOCALE

    --lc-numeric=LOCALE

    --lc-time=LOCALE

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

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

    说明:

  • 如果用户在数据库安装的时候没有指定--lc-collate参数,则--lc-collate参数的默认值为C。
  • 当指定了数据库的编码格式为GB18030_2022时,则参数--lc-collate和参数--lc-ctype的取值范围与GB18030保持一致。
  • --no-locale

    和--locale=C等价。

    -

    --pwfile=FILE

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

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

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

    设置缺省的文本搜索方式。

    text-search-config的取值:

    • pg_catalog.english全文搜索
    • pg_catalog.simple普通文本搜索

    默认值:pg_catalog.simple

    -U, --username=NAME

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

    取值范围:正常的数据库用户。不能包括"|", ";", "&", "<", ">", "`", "\\", "!"这几个字符。

    默认值:运行gs_initdb的操作系统用户。

    -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加密后的密码。

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

    -X, --xlogdir=XLOGDIR

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

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

    支持绝对路径和相对路径,相对路径是相对于数据目录的。不能包括"|", ";", "&", "$", "<", ">", "`", "\\", "!"这几个字符。

    -S, --security

    安全方式初始化数据库。

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

    表 2 不常用参数说明

    参数

    参数说明

    取值范围

    -d, --debug

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

    -

    -L DIRECTORY

    gs_initdb初始化数据库所需要的输入文件的路径。通常是不必要的。如果需要明确声明的话,程序会提示输入。

    初始化数据库所需的输入文件路径。不能包括"|", ";", "&", "$", "<", ">", "`", "\\", "!"这几个字符。

    -n, --noclean

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

    -

    -s, --show

    显示内部设置。

    -

    -H, --host-ip

    openGauss节点node_host初始化。

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

    -V, --version

    打印gs_initdb版本信息,然后退出。

    -

    -?, --help

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

    -

    -g

    针对共享存储的跨AZ容灾数据库实例的初始化,指定共享xlog日志文件的路径。

    指定的共享日志文件路径。不能包括"|", ";", "&", "$", "<", ">", "`", "\\", "!"这几个字符。

    意见反馈
    编组 3备份
      openGauss 2025-05-06 07:43:30
      取消