diff --git a/product/zh/docs-mogdb/v2.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md b/product/zh/docs-mogdb/v2.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md index 99128e733b9fa2e6443a1c5ad2ea2e49e6c88eb2..02c49bc080e670519ef5e9f030b83a2f150b38a4 100644 --- a/product/zh/docs-mogdb/v2.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md +++ b/product/zh/docs-mogdb/v2.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md @@ -103,7 +103,7 @@ mogdb接受[表1](#canshushuoming)中所示的命令行参数。 | :----- | :--------------------------- | :------- | | -u NUM | 指定升级前数据库内核版本号。 | - | -除以上参数外,出现在postgres.conf中的所有参数,均可以用-guc_name=guc_value的方式在mogdb启动时传给mogdb。例如,-enable_fast_query_shipping=off +除以上参数外,出现在postgres.conf中的所有参数,均可以用-guc_name=guc_value的方式在mogdb启动时传给mogdb。 ## 环境变量 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md index fabb1d74f8d03918eae852462363d19960a8269e..364e53b02c06950d9346bd183b71f6a30505e318 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md @@ -102,7 +102,7 @@ mogdb接受[表1](#canshushuoming)中所示的命令行参数。 | :----- | :--------------------------- | :------- | | -u NUM | 指定升级前数据库内核版本号。 | - | -除以上参数外,出现在postgres.conf中的所有参数,均可以用-guc_name=guc_value的方式在mogdb启动时传给mogdb。例如,-enable_fast_query_shipping=off。 +除以上参数外,出现在postgres.conf中的所有参数,均可以用-guc_name=guc_value的方式在mogdb启动时传给mogdb。 ## 环境变量 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-mogdb.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-mogdb.md index 6bf256cb9c40307769535398bc2b43d654fba603..58fc7eedf0fc71a72f607024f082fc70101bd675 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-mogdb.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-mogdb.md @@ -103,7 +103,7 @@ mogdb接受[表1](#canshushuoming)中所示的命令行参数。 | :----- | :--------------------------- | :------- | | -u NUM | 指定升级前数据库内核版本号。 | - | -除以上参数外,出现在postgres.conf中的所有参数,均可以用--guc_name=guc_value的方式在mogdb启动时传给mogdb。例如,--enable_fast_query_shipping=off。 +除以上参数外,出现在postgres.conf中的所有参数,均可以用--guc_name=guc_value的方式在mogdb启动时传给mogdb。 ## 环境变量 diff --git a/product/zh/docs-mogdb/v3.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-mogdb.md b/product/zh/docs-mogdb/v3.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-mogdb.md index 29c03e676dae5671aebd3d317d7468ebc29b2db7..6ca3e4b4573563c38917e129619517d16f29264d 100644 --- a/product/zh/docs-mogdb/v3.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-mogdb.md +++ b/product/zh/docs-mogdb/v3.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-mogdb.md @@ -103,7 +103,7 @@ mogdb接受[表1](#canshushuoming)中所示的命令行参数。 | :----- | :--------------------------- | :------- | | -u NUM | 指定升级前数据库内核版本号。 | - | -除以上参数外,出现在postgres.conf中的所有参数,均可以用--guc_name=guc_value的方式在mogdb启动时传给mogdb。例如,--enable_fast_query_shipping=off。 +除以上参数外,出现在postgres.conf中的所有参数,均可以用--guc_name=guc_value的方式在mogdb启动时传给mogdb。 ## 环境变量 diff --git a/product/zh/docs-mogdb/v5.0/about-mogdb/mogdb-new-feature/5.0.6.md b/product/zh/docs-mogdb/v5.0/about-mogdb/mogdb-new-feature/5.0.6.md index 3919b6f57aef9208d384fceacbe3bf41b6bd9a90..2cf58d9aab375f7cb15572cd7451ca294ba607a7 100644 --- a/product/zh/docs-mogdb/v5.0/about-mogdb/mogdb-new-feature/5.0.6.md +++ b/product/zh/docs-mogdb/v5.0/about-mogdb/mogdb-new-feature/5.0.6.md @@ -87,7 +87,7 @@ MogDB对读写请求的处理全部放在事务机制下,这与Oracle读不启 5. 修改cte表的默认行为,使其可以被提升到上层查询,生成更优查询计划,以提升执行性能 -6. 支持在bpchar数据类型的列和常量字符串的运算作为表扫描过滤条件时可以使用索引,提升查询效率 +6. 新增参数[behavior_compat_options](../../reference-guide/guc-parameters/version-and-platform-compatibility/platform-and-client-compatibility.md#behavior_compat_options)的选项'bpchar_coerce_compat',让bpchar和text运算时隐式转换text为bpchar,使bpchar_col = 'xxx'::text条件可直接运用索引或者分区裁剪,提升查询效率 ### 2.6 易用性提升 diff --git a/product/zh/docs-mogdb/v5.0/reference-guide/guc-parameters/guc-parameter-list.md b/product/zh/docs-mogdb/v5.0/reference-guide/guc-parameters/guc-parameter-list.md index 7fba80681c3dddb1da5e4effa3bcd43f69c6574a..7da19283ea34738bbb4615666fea8eaa6383acba 100644 --- a/product/zh/docs-mogdb/v5.0/reference-guide/guc-parameters/guc-parameter-list.md +++ b/product/zh/docs-mogdb/v5.0/reference-guide/guc-parameters/guc-parameter-list.md @@ -287,9 +287,9 @@ date: 2023-04-07 | [enable_stmt_track](query.md#enable_stmt_track) | | [enable_stream_replication](ha-replication/primary-server.md#enable_stream_replication) | | [enable_tde](security-configuration.md#enable_tde) | -| [enable_time_report](write-ahead-log/log-replay.md#enable_time_report) | | [enable_thread_pool](thread-pool.md#enable_thread_pool) | | [enable_tidscan](query-planning/optimizer-method-configuration.md#enable_tidscan) | +| [enable_time_report](write-ahead-log/log-replay.md#enable_time_report) | | [enable_upgrade_merge_lock_mode](miscellaneous-parameters.md#enable_upgrade_merge_lock_mode) | | [enable_user_metric_persisten](load-management.md#enable_user_metric_persistent) | | [enable_ustore](miscellaneous-parameters.md#enable_ustore) | diff --git a/product/zh/docs-mogdb/v5.0/reference-guide/guc-parameters/version-and-platform-compatibility/platform-and-client-compatibility.md b/product/zh/docs-mogdb/v5.0/reference-guide/guc-parameters/version-and-platform-compatibility/platform-and-client-compatibility.md index d89a4cf105b05c617bf1770d7c1193b391c7642b..c0618db692c3229b442c68864c8f23d52a605119 100644 --- a/product/zh/docs-mogdb/v5.0/reference-guide/guc-parameters/version-and-platform-compatibility/platform-and-client-compatibility.md +++ b/product/zh/docs-mogdb/v5.0/reference-guide/guc-parameters/version-and-platform-compatibility/platform-and-client-compatibility.md @@ -448,6 +448,10 @@ date: 2021-04-20 在驱动为非自动提交模式下,配置此选项开启select自动提交事务功能。 +- bpchar_coerce_compat + + 控制bpchar和text运算时隐式转换text为bpchar,使bpchar_col = 'xxx'::text条件可直接运用索引或者分区裁剪,提升查询效率 + ## plpgsql.variable_conflict **参数说明**:设置同名的存储过程变量和表的列的使用优先级。 diff --git a/product/zh/docs-mogdb/v5.0/reference-guide/tool-reference/tools-used-in-the-internal-system/gs_ctl.md b/product/zh/docs-mogdb/v5.0/reference-guide/tool-reference/tools-used-in-the-internal-system/gs_ctl.md index eb229ac19c976ffcea2c1c6970e1fb372c0025ae..bfeb8bdfaf31b40607fcfbaa128326ba7fd11974 100644 --- a/product/zh/docs-mogdb/v5.0/reference-guide/tool-reference/tools-used-in-the-internal-system/gs_ctl.md +++ b/product/zh/docs-mogdb/v5.0/reference-guide/tool-reference/tools-used-in-the-internal-system/gs_ctl.md @@ -17,6 +17,8 @@ gs_ctl工具由操作系统用户omm执行。 - 在不停止数据库的情况下,重新加载配置文件(postgresql.conf,pg_hba.conf)。 - 主备切换、主备状态查询、重建和重建状态查询。 +gs_ctl build工具支持打印进度,根据已经传输完成的文件大小比上需要传输的总文件大小进行进度打印。 + > 说明:gs_ctl工具读取超过1M的配置文件可能出现异常,请确保配置文件大小保持在1M内。 ## 参数说明 @@ -33,6 +35,9 @@ gs_ctl参数可分为如下几类: - member参数,详细请参见[表8](#8)。 - changerole参数,详细参见[表9](#9)。 - setrunmode参数,详细参见[表10](#10)。 +- stack参数,详细参见[表11](#11)。 +- copy参数,详细参见[表12](#12)。 +- 资源池化build参数,详细请参见[表13](#13)。 **表 1** option参数 @@ -43,17 +48,20 @@ gs_ctl参数可分为如下几类: | restart | 重启数据库。 | | build | 在主机上重建备实例或级联备实例。 | | stop | 停止数据库。 | -| reload | 重载配置文件(postgresql.conf, pg_hba.conf)。 | +| reload | 重载配置文件(postgresql.conf,pg_hba.conf)。 | | status | 显示数据库运行状态。 | | finishredo | 主机故障时,备机停止回放,强制升主。 | -| failover | 在主机异常时,将备机切换为主机。
切换成功后,需要执行gs_om -t refreshconf 命令记录当前主备机信息,确保gs_om -t refreshconf 命令执行成功,否则再次重启会影响数据库状态。dcf模式下不支持该操作。 | -| switchover | 在主备机正常时,出于维护的需要,将备机切换为主机,可保证切换过程中数据不丢失。必须在要切换为主机的备机上,执行switchover命令才会生效。在主机上执行switchover命令,仅作查询使用。
切换成功后,需要执行gs_om -t refreshconf 命令记录当前主备机信息,确保gs_om -t refreshconf 命令执行成功,否则再次重启会影响数据库状态。
switchover命令下发后,命令如果超时返回,后台进程的执行状态可能处于不可确定状态。 | +| failover | 在主机异常时,将备机切换为主机。
切换成功后,需要执行gs_om -t refreshconf 命令记录当前主备机信息,确保gs_om -t refreshconf命令执行成功,否则再次重启会影响数据库状态。dcf模式下不支持该操作。 | +| switchover | 在主备机正常时,出于维护的需要,将备机切换为主机,可保证切换过程中数据不丢失。必须在要切换为主机的备机上,执行switchover命令才会生效。在主机上执行switchover命令,仅作查询使用。
切换成功后,需要执行gs_om -t refreshconf命令记录当前主备机信息,确保gs_om -t refreshconf命令执行成功,否则再次重启会影响数据库状态。
switchover命令下发后,命令如果超时返回,后台进程的执行状态可能处于不可确定状态。 | | query | 查询主备机之间的状态信息。 | | notify | 启动后再指定主备机。 | | kill | 给指定的进程发送信号量。 | | querybuild | 查看数据库的重建进度。 | -| stack | 获取gaussdb的调用栈。 | +| stack | 获取mogdb的调用栈。 | | copy | 基于共享存储的双中心容灾模式,进行xlog日志拷贝。 | +| member | 对成员节点的管理。 | +| changerole | 改变节点角色。 | +| setrunmode | 设置运行模式。 | > 说明: > @@ -99,17 +107,19 @@ gs_ctl参数可分为如下几类: **表 5** switchover参数 -| 参数 | 参数说明 | 取值范围 | -| :----------------- | :------------------------------------- | :----------------------------------------------------------- | -| -m SWITCHOVER-MODE | 声明双机主备实例正常时切换的切换模式。 | mode的取值:
- fast:不等待客户端中断连接,所有活跃事务都被回滚并且客户端都被强制断开,然后服务器将被切换。
- smart:本版本暂不支持该模式。
默认值:fast | +| 参数 | 参数说明 | 取值范围 | +| :----------------- | :----------------------------------------------------------- | :----------------------------------------------------------- | +| -f | 不等待客户端中断连接,所有活跃事务都被回滚并且客户端都被强制断开,然后服务器将被切换,且不做checkpoint。 | 无参数 | +| -m SWITCHOVER-MODE | 声明双机主备实例正常时切换的切换模式。 | mode的取值:
- fast:不等待客户端中断连接,所有活跃事务都被回滚并且客户端都被强制断开,然后服务器将被切换。
- smart:本版本暂不支持该模式。
默认值:fast | **表 6** build参数 | 参数 | 参数说明 | 取值范围 | | :------------------------- | :----------------------------------------------------------- | :----------------------------------------------------------- | -| -b MODE | 指定重建备机的模式。 | mode的取值:
- full:通过全量镜像的方式重新同步主机的数据目录。
- incremental:通过解析Xlog日志获 取主备机差异的数据进行增量修复备机。
说明:
增量重建适用于主备双主等因日志 造成的不一致场景。
- 增量重建不适用于一主一备并且没有开启最大高可用的场景,此种场景下需要使用全量重建或者开启最大高可用后再进行增量重建。
- 备机数据文件损坏、数据目录丢失等故障通过增量重建的方式无法修复,此时可通过全量重建的方式重 新修复备机。
- auto(不指定):先增量,根据失败后是否可以再增量选择继续增量或者全量,三次增量失败后进行全 量。
- standby_full:通过指定的备机ip和port全量重建故障备机。使用该参数时需要同时使用-C参数指定镜像的ip和port。
默认值:auto
说明:重建级联备机需要加上-M cascade_standy参数。 | +| -b MODE | 指定重建备机的模式。 | mode的取值:
- full:通过全量镜像的方式重新同步主机的数据目录。
- incremental:通过解析Xlog日志获 取主备机差异的数据进行增量修复备机。
说明:
- 增量重建适用于主备双主等因日志 造成的不一致场景。
- 增量重建不适用于一主一备并且没有开启最大高可用的场景,此种场景下需要使用全量重建或者开启最大高可用后再进行增量重建。
- 备机数据文件损坏、数据目录丢失等故障通过增量重建的方式无法修复,此时可通过全量重建的方式重 新修复备机。
- auto(不指定):先增量,根据失败后是否可以再增量选择继续增量或者全量,三次增量失败后进行全 量。
- standby_full:通过指定的备机ip和port全量重建故障备机。使用该参数时需要同时使用-C参数指定镜像的ip和port。
- copy_secure_files:在流式容灾场景下,获取指定节点数据目录下gs_secure_files目录对应内容。
- copy_upgrade_file:在dorado容灾场景下,获取指定节点下升级所需指定文件。
- cross_cluster_full:在dorado容灾场景下,通过全量镜像的方式重新同步主机的数据目录。
- cross_cluster_incremental:基于共享存储的同城双中心场景下的跨集群增量build。
- check:检测是否需要build,如果需要,返回build的类型。
默认值:auto
说明:重建级联备机需要加上-M cascade_standy参数。 | | -r, --recvtimeout=INTERVAL | 指定重建过程中备机日志接收等待主机响应的超时时间。 | 取值范围:整型(秒)。
默认值:120秒
提示:超时时间需根据业务繁忙程度设置,业务繁忙等待主机的响应时间需加长,建议超时时间=checkpoint的执行时间+1min。 | | -q | 重建结束后,是否自动重启。
指定参数场合,不自动重启。
未指定场合,自动重启。重启默认最大等待时间是60秒。如果在此时间内数据库未能启动成功,就会报不再等待,命令退出。此后可以通过gs_om -t status --detail或其他查看数据库状态的命令,来确认数据库是否启动成功。 | 无参数 | +| -C CONNECTOR | 到源端DN的连接串,通过连接源端DN进行本节点上DN的重建。只支持备机到备机的连接。 | 连接串包含本节点待重建DN的IP和端口和源端DN的IP和端口,格式如下:'localhost=Local DN IP localport=Local DN Port+1 remotehost=DN IP remoteport=DN Port+1' | **表 7** query参数 @@ -126,6 +136,8 @@ gs_ctl参数可分为如下几类: | -i, --ip | 新增节点与数据库实例DCF模块通信的IP。 | 字符串。 | | -e, --port | 新增节点与数据库实例DCF模块通信的port。 | 整型。 | | [-D, --pgdata=]DATADIR | 指定数据目录的位置。若指定目录中包含配置文件postgresql.conf,且配置文件内data_directory值与-D指定目录不同,将优先按data_directory目录执行。 | DATADIR的取值:用户自定义。 | +| -G | 用于设置DCF中的组号。 | 整型。 | +| --priority | 用于设置DCF中的优先级。 | 整型。 | **表 9** changerole参数 @@ -143,14 +155,26 @@ gs_ctl参数可分为如下几类: | -x, --xmode | 运行模式(在少数派的DN节点上使用)。 | - minority:少数派强起。
- normal:加回。 | | [-D, --pgdata=]DATADIR | 指定数据目录的位置。若指定目录中包含配置文件postgresql.conf,且配置文件内data_directory值与-D指定目录不同,将优先按data_directory目录执行。 | DATADIR的取值:用户自定义。 | -**表 11** stack参数 +**表 11** stack参数 | 参数 | 参数说明 | 取值范围 | | :--- | :------------------------------------ | :------- | | -I | 用于指定需要获取调用栈的线程的lwtid。 | 正整数。 | -**表 12** copy参数 +**表 12** copy参数 | 参数 | 参数说明 | 取值范围 | | :--- | :--------------------- | :----------------------------------------------------------- | -| -Q | 指定xlog日志拷贝方向。 | - copy_from_local:从本地往共享存储上拷贝。
- copy_from_share:从共享存储往本地存储上拷贝。
- force_copy_from_local:强制从本地往共享存储上拷贝。 | \ No newline at end of file +| -Q | 指定xlog日志拷贝方向。 | - copy_from_local:从本地往共享存储上拷贝。
- copy_from_share:从共享存储往本地存储上拷贝。
- force_copy_from_local:强制从本地往共享存储上拷贝。 | + +**表 13** 资源池化build参数 + +| 参数 | 参数说明 | 取值范围 | +| ------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | +| -b MODE | 指定重建备机的模式。 | mode的取值:
- cross_cluster_full:资源池化执行build,必须结合dorado容灾场景,该参数表示在dorado容灾场景下通过全量镜像的方式重新同步主机的数据目录。
- check:判断是否需要build提示:资源池化build只适用于主备集群间的跨集群build,不能用于资源池化单集群内的主备实例build。 | +| -q | 重建结束后,是否自动重启。
指定参数场合,不自动重启。
未指定场合,自动重启,重启默认最大等待时间是60秒。如果在此时间内数据库未能启动成功,就会报不再等待,命令退出。此后可以通过gs_om -t status --detail或其他查看数据库状态的命令,来确认数据库是否启动成功。 | 无参数 | +| --enable-dss | 开启资源池化开关。 | 无参数 | +| -g | 开启资源池化,指定节点做build。 | 取值范围:整型,[0-63],需要从0开始
默认值:0
提示:-g入参参数是指资源池化节点id参数ss_instance_id | +| --instance-id=instance_id | 启用dss和dms时,实例的ID号。 | 正整数。 | +| --vgname | 卷组名。 | 数据类型:字符串 。
例如:一个卷组“+data”或者两个卷组中间用“,”连接“+data,+log”。 | +| --socketpath | dss实例进程使用的socket文件路径。 | dss实例进程使用的socket文件路径。 | \ No newline at end of file diff --git a/product/zh/docs-mogdb/v5.0/reference-guide/tool-reference/tools-used-in-the-internal-system/mogdb.md b/product/zh/docs-mogdb/v5.0/reference-guide/tool-reference/tools-used-in-the-internal-system/mogdb.md index 29c03e676dae5671aebd3d317d7468ebc29b2db7..6ca3e4b4573563c38917e129619517d16f29264d 100644 --- a/product/zh/docs-mogdb/v5.0/reference-guide/tool-reference/tools-used-in-the-internal-system/mogdb.md +++ b/product/zh/docs-mogdb/v5.0/reference-guide/tool-reference/tools-used-in-the-internal-system/mogdb.md @@ -103,7 +103,7 @@ mogdb接受[表1](#canshushuoming)中所示的命令行参数。 | :----- | :--------------------------- | :------- | | -u NUM | 指定升级前数据库内核版本号。 | - | -除以上参数外,出现在postgres.conf中的所有参数,均可以用--guc_name=guc_value的方式在mogdb启动时传给mogdb。例如,--enable_fast_query_shipping=off。 +除以上参数外,出现在postgres.conf中的所有参数,均可以用--guc_name=guc_value的方式在mogdb启动时传给mogdb。 ## 环境变量 diff --git a/product/zh/docs-mogdb/v5.1/reference-guide/tool-reference/tools-used-in-the-internal-system/gs_ctl.md b/product/zh/docs-mogdb/v5.1/reference-guide/tool-reference/tools-used-in-the-internal-system/gs_ctl.md index f4466a8f0b1cc0dc31736d1ff5818c45ef92edfe..d3bd059b0e44f9793392f1a78a009919efc423af 100644 --- a/product/zh/docs-mogdb/v5.1/reference-guide/tool-reference/tools-used-in-the-internal-system/gs_ctl.md +++ b/product/zh/docs-mogdb/v5.1/reference-guide/tool-reference/tools-used-in-the-internal-system/gs_ctl.md @@ -17,6 +17,8 @@ gs_ctl工具由操作系统用户omm执行。 - 在不停止数据库的情况下,重新加载配置文件(postgresql.conf,pg_hba.conf)。 - 主备切换、主备状态查询、重建和重建状态查询。 +gs_ctl build工具支持打印进度,根据已经传输完成的文件大小比上需要传输的总文件大小进行进度打印。 + > 说明:gs_ctl工具读取超过1M的配置文件可能出现异常,请确保配置文件大小保持在1M内。 ## 参数说明 @@ -46,17 +48,20 @@ gs_ctl参数可分为如下几类: | restart | 重启数据库。 | | build | 在主机上重建备实例或级联备实例。 | | stop | 停止数据库。 | -| reload | 重载配置文件(postgresql.conf, pg_hba.conf)。 | +| reload | 重载配置文件(postgresql.conf,pg_hba.conf)。 | | status | 显示数据库运行状态。 | | finishredo | 主机故障时,备机停止回放,强制升主。 | -| failover | 在主机异常时,将备机切换为主机。
切换成功后,需要执行gs_om -t refreshconf 命令记录当前主备机信息,确保gs_om -t refreshconf 命令执行成功,否则再次重启会影响数据库状态。dcf模式下不支持该操作。 | -| switchover | 在主备机正常时,出于维护的需要,将备机切换为主机,可保证切换过程中数据不丢失。必须在要切换为主机的备机上,执行switchover命令才会生效。在主机上执行switchover命令,仅作查询使用。
切换成功后,需要执行gs_om -t refreshconf 命令记录当前主备机信息,确保gs_om -t refreshconf 命令执行成功,否则再次重启会影响数据库状态。
switchover命令下发后,命令如果超时返回,后台进程的执行状态可能处于不可确定状态。 | +| failover | 在主机异常时,将备机切换为主机。
切换成功后,需要执行gs_om -t refreshconf 命令记录当前主备机信息,确保gs_om -t refreshconf命令执行成功,否则再次重启会影响数据库状态。dcf模式下不支持该操作。 | +| switchover | 在主备机正常时,出于维护的需要,将备机切换为主机,可保证切换过程中数据不丢失。必须在要切换为主机的备机上,执行switchover命令才会生效。在主机上执行switchover命令,仅作查询使用。
切换成功后,需要执行gs_om -t refreshconf命令记录当前主备机信息,确保gs_om -t refreshconf命令执行成功,否则再次重启会影响数据库状态。
switchover命令下发后,命令如果超时返回,后台进程的执行状态可能处于不可确定状态。 | | query | 查询主备机之间的状态信息。 | | notify | 启动后再指定主备机。 | | kill | 给指定的进程发送信号量。 | | querybuild | 查看数据库的重建进度。 | | stack | 获取mogdb的调用栈。 | | copy | 基于共享存储的双中心容灾模式,进行xlog日志拷贝。 | +| member | 对成员节点的管理。 | +| changerole | 改变节点角色。 | +| setrunmode | 设置运行模式。 | **表 2** 公共参数 @@ -103,9 +108,10 @@ gs_ctl参数可分为如下几类: | 参数 | 参数说明 | 取值范围 | | :------------------------- | :----------------------------------------------------------- | :----------------------------------------------------------- | -| -b MODE | 指定重建备机的模式。 | mode的取值:
- full:通过全量镜像的方式重新同步主机的数据目录。
- incremental:通过解析Xlog日志获取主备机差异的数据进行增量修复备机。
说明:
- 增量重建适用于主备双主等因日志造成的不一致场景。
- 增量重建不适用于一主一备并且没有开启最大高可用的场景,此种场景下需要使用全量重建或者开启最大高可用后再进行增量重建。
- 备机数据文件损坏、数据目录丢失等故障通过增量重建的方式无法修复,此时可通过全量重建的方式重新修复备机。
- auto(不指定):先增量,根据失败后是否可以再增量选择继续增量或者全量,三次增量失败后进行全量。
- standby_full:通过指定的备机ip和port全量重建故障备机。使用该参数时需要同时使用-C参数指定镜像的ip和port。
- copy_secure_files:在流式容灾场景下,获取指定节点数据目录下gs_secure_files目录对应内容。
- copy_upgrade_file:在dorado容灾场景下,获取指定节点下升级所需指定文件。
- cross_cluster_full:在dorado容灾场景下,通过全量镜像的方式重新同步主机的数据目录。
- cross_cluster_incremental:基于共享存储的同城双中心场景下的跨集群增量build。
- check:检测是否需要build,如果需要,返回build的类型。
默认值:auto
说明:重建级联备机需要加上-M cascade_standy参数。 | +| -b MODE | 指定重建备机的模式。 | mode的取值:
- full:通过全量镜像的方式重新同步主机的数据目录。
- incremental:通过解析Xlog日志获 取主备机差异的数据进行增量修复备机。
说明:
- 增量重建适用于主备双主等因日志 造成的不一致场景。
- 增量重建不适用于一主一备并且没有开启最大高可用的场景,此种场景下需要使用全量重建或者开启最大高可用后再进行增量重建。
- 备机数据文件损坏、数据目录丢失等故障通过增量重建的方式无法修复,此时可通过全量重建的方式重 新修复备机。
- auto(不指定):先增量,根据失败后是否可以再增量选择继续增量或者全量,三次增量失败后进行全 量。
- standby_full:通过指定的备机ip和port全量重建故障备机。使用该参数时需要同时使用-C参数指定镜像的ip和port。
- copy_secure_files:在流式容灾场景下,获取指定节点数据目录下gs_secure_files目录对应内容。
- copy_upgrade_file:在dorado容灾场景下,获取指定节点下升级所需指定文件。
- cross_cluster_full:在dorado容灾场景下,通过全量镜像的方式重新同步主机的数据目录。
- cross_cluster_incremental:基于共享存储的同城双中心场景下的跨集群增量build。
- check:检测是否需要build,如果需要,返回build的类型。
默认值:auto
说明:重建级联备机需要加上-M cascade_standy参数。 | | -r, --recvtimeout=INTERVAL | 指定重建过程中备机日志接收等待主机响应的超时时间。 | 取值范围:整型(秒)。
默认值:120秒
提示:超时时间需根据业务繁忙程度设置,业务繁忙等待主机的响应时间需加长,建议超时时间=checkpoint的执行时间+1min。 | | -q | 重建结束后,是否自动重启。
指定参数场合,不自动重启。
未指定场合,自动重启。重启默认最大等待时间是60秒。如果在此时间内数据库未能启动成功,就会报不再等待,命令退出。此后可以通过gs_om -t status --detail或其他查看数据库状态的命令,来确认数据库是否启动成功。 | 无参数 | +| -C CONNECTOR | 到源端DN的连接串,通过连接源端DN进行本节点上DN的重建。只支持备机到备机的连接。 | 连接串包含本节点待重建DN的IP和端口和源端DN的IP和端口,格式如下:'localhost=Local DN IP localport=Local DN Port+1 remotehost=DN IP remoteport=DN Port+1' | **表 7** query参数 @@ -118,10 +124,12 @@ gs_ctl参数可分为如下几类: | 参数 | 参数说明 | 取值范围 | | :--------------------- | :----------------------------------------------------------- | :----------------------------------------------------------- | | --operation | MogDB数据库实例,DCF模式下,增删节点的操作。 | - add: 向数据库实例的DCF节点配置中增加一个节点。
- remove:从数据库实例DCF节点配置中删除一个节点。 | -| -u, --nodeid | 新增节点的DCF NODE ID。 | 无符号整型。 | +| -u, --nodeid | 新增节点的DCF NODE ID。 | 无符号整型 | | -i, --ip | 新增节点与数据库实例DCF模块通信的IP。 | 字符串。 | | -e, --port | 新增节点与数据库实例DCF模块通信的port。 | 整型。 | | [-D, --pgdata=]DATADIR | 指定数据目录的位置。若指定目录中包含配置文件postgresql.conf,且配置文件内data_directory值与-D指定目录不同,将优先按data_directory目录执行。 | DATADIR的取值:用户自定义。 | +| -G | 用于设置DCF中的组号。 | 整型。 | +| --priority | 用于设置DCF中的优先级。 | 整型。 | **表 9** changerole参数 @@ -153,11 +161,12 @@ gs_ctl参数可分为如下几类: **表 13** 资源池化build参数 -| 参数 | 参数说明 | 取值范围 | -| ------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | -| -b MODE | 指定重建备机的模式。 | mode的取值:
- cross_cluster_full:资源池化执行build,必须结合dorado容灾场景,该参数表示在dorado容灾场景下通过全量镜像的方式重新同步主机的数据目录。
提示:资源池化build只适用于主备集群间的跨集群build,不能用于资源池化单集群内的主备实例build。 | -| -q | 重建结束后,是否自动重启。
指定参数场合,不自动重启。
未指定场合,自动重启,重启默认最大等待时间是60秒。如果在此时间内数据库未能启动成功,就会报不再等待,命令退出。此后可以通过gs_om -t status --detail或其他查看数据库状态的命令,来确认数据库是否启动成功。 | 无参数 | -| --enable-dss | 开启资源池化开关。 | 无参数 | -| -g | 开启资源池化,指定节点做build。 | 取值范围:整型,[0-63],需要从0开始
默认值:0
提示:-g入参参数是指资源池化节点id参数ss_instance_id | -| --vgname | 卷组名。 | 数据类型:字符串 。
例如:一个卷组“+data”或者两个卷组中间用“,”连接“+data,+log”。 | -| --socketpath | dss实例进程使用的socket文件路径。 | dss实例进程使用的socket文件路径。 | \ No newline at end of file +| 参数 | 参数说明 | 取值范围 | +| ------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | +| -b MODE | 指定重建备机的模式。 | mode的取值:
- cross_cluster_full:资源池化执行build,必须结合dorado容灾场景,该参数表示在dorado容灾场景下通过全量镜像的方式重新同步主机的数据目录。
- check:判断是否需要build提示:资源池化build只适用于主备集群间的跨集群build,不能用于资源池化单集群内的主备实例build。 | +| -q | 重建结束后,是否自动重启。
指定参数场合,不自动重启。
未指定场合,自动重启,重启默认最大等待时间是60秒。如果在此时间内数据库未能启动成功,就会报不再等待,命令退出。此后可以通过gs_om -t status --detail或其他查看数据库状态的命令,来确认数据库是否启动成功。 | 无参数 | +| --enable-dss | 开启资源池化开关。 | 无参数 | +| -g | 开启资源池化,指定节点做build。 | 取值范围:整型,[0-63],需要从0开始
默认值:0
提示:-g入参参数是指资源池化节点id参数ss_instance_id | +| --instance-id=instance_id | 启用dss和dms时,实例的ID号。 | 正整数。 | +| --vgname | 卷组名。 | 数据类型:字符串 。
例如:一个卷组“+data”或者两个卷组中间用“,”连接“+data,+log”。 | +| --socketpath | dss实例进程使用的socket文件路径。 | dss实例进程使用的socket文件路径。 | \ No newline at end of file diff --git a/product/zh/docs-mogdb/v5.1/reference-guide/tool-reference/tools-used-in-the-internal-system/mogdb.md b/product/zh/docs-mogdb/v5.1/reference-guide/tool-reference/tools-used-in-the-internal-system/mogdb.md index 0dcc870f121d91ad5b9b472fc090dce779cf1b03..d240f4c6822e07aa82203863e50eaa71da8ad89c 100644 --- a/product/zh/docs-mogdb/v5.1/reference-guide/tool-reference/tools-used-in-the-internal-system/mogdb.md +++ b/product/zh/docs-mogdb/v5.1/reference-guide/tool-reference/tools-used-in-the-internal-system/mogdb.md @@ -104,7 +104,7 @@ mogdb接受[表1](#canshushuoming)中所示的命令行参数。 | :----- | :--------------------------- | :------- | | -u NUM | 指定升级前数据库内核版本号。 | - | -除以上参数外,出现在postgres.conf中的所有参数,均可以用--guc_name=guc_value的方式在mogdb启动时传给mogdb。例如,--enable_fast_query_shipping=off。 +除以上参数外,出现在postgres.conf中的所有参数,均可以用--guc_name=guc_value的方式在mogdb启动时传给mogdb。 ## 环境变量