更新时间:2026-10-21 GMT+08:00
分享

GaussStor相关参数

dr_gaussstor_cms_url_list

参数说明:设置GaussStor集群管理节点的ip:port列表。

参数类型:字符串

参数单位:无

取值范围:长度不超过8192字节的字符串,格式为本地GaussStor集群管理节点的ip:port列表+远端GaussStor集群管理节点的ip:port列表。例如:"xxx.xxx.xxx.xxx:xxxx,xxx.xxx.xxx.xxx:xxxx,xxx.xxx.xxx.xxx:xxxx+xxx.xxx.xxx.xxx:xxxx,xxx.xxx.xxx.xxx:xxxx,xxx.xxx.xxx.xxx:xxxx"。

默认值:""

设置方式:该参数属于POSTMASTER类型参数,请参见表1中对应设置方法进行设置。

设置建议:使用对接GaussStor的接口时,自动设置,禁止手动设置。

设置不当的风险与影响:如果在对接前后,修改此参数的值,使其与对接时的配置不一致,重启集群可能会导致GaussStor对接失败。

enable_dr_gaussstor_mode

参数说明:设置是否开启GaussStor模式。

参数类型:布尔型

参数单位:无

取值范围:on、off

默认值:off

设置方式:该参数属于POSTMASTER类型参数,请参见表1中对应设置方法进行设置。

设置建议:使用对接GaussStor的接口时,自动设置,禁止手动设置。

设置不当的风险与影响:如果在对接后,将该参数设置为off,重启集群会导致对接GaussStor失败。

dr_gaussstor_config

参数说明:用于配置与GaussStor连接和写入的相关参数。每个配置项为name=value格式,配置项之间用空格分隔,包含的配置项如表1所示。

参数类型:字符串

参数单位:无

取值范围:长度不超过8192字节的字符串,格式为[gaussstor_async_write_batch_timeout=xxx gaussstor_max_sdk_retry_timeout=xxx enable_gaussstor_sync_commit=xxx max_size_for_gaussstor_xlog_prune=xxx max_gaussstor_wal_sender_buf_size=xxx enable_auto_service_down=xxx run_mode=xxx]

默认值:""

设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。设置时所有配置项需补全,若仅含部分配置项则设置失败。

设置建议:调用对接GaussStor接口时,自动设置,不建议手动设置。

设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。

表1 配置项说明

配置项名称

描述

取值范围

默认值

gaussstor_async_write_batch_timeout

设置SDK汇聚写的最大超时时间。

[0, UINT32_MAX],单位:微秒。

200微秒

gaussstor_max_sdk_retry_timeout

设置SDK与GaussStor通信的最大超时时间。

[0, UINT32_MAX],单位:毫秒。

3000毫秒

enable_gaussstor_sync_commit

设置是否事务提交时等待对应日志写到GaussStor。

  • on:事务提交时需要等待对应日志写到GaussStor。
  • off:事务提交时无需等待对应日志写到GaussStor。

on

max_size_for_gaussstor_xlog_prune

当灾备集群和主集群断连的时候,允许GaussStor存储的最大Xlog大小。

[0, INT_MAX],单位KB。

536870912KB(512GB)

max_gaussstor_wal_sender_buf_size

设置一次可写到GaussStor的Xlog buffer最大大小。

[8, 131072],单位KB。

4088

enable_auto_service_down

GaussStor故障时,是否开启自动同步转异步。

  • on:GaussStor故障时,开启自动同步转异步。
  • off:GaussStor故障时,不开启自动同步转异步。

on

run_mode

设置日志复制模式。

  • "":流式复制模式。该值为默认值。
  • "serial":串行复制模式。

""

enable_dr_gaussstor_parallel_write

参数说明:写入GaussStor时,设置写入方式为并行还是串行。

参数类型:布尔型

参数单位:无

取值范围:

  • on:设置写入方式为并行,写入备机同时写入GaussStor。
  • off:设置写入方式为串行,以备机多数派位置作为写入点写入GaussStor。

默认值:on

设置方式:该参数属于POSTMASTER类型参数,请参见表1中对应设置方法进行设置。

设置建议:使用对接GaussStor接口时,自动设置,不建议手动设置。

设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。

gaussstor_auth_type

参数说明:设置GaussDB和GaussStor认证方式,仅sysadmin用户可以访问。

参数类型:字符串

参数单位:无

取值范围:
  • none:表示不使用连接认证。
  • only_auth_connect:表示使用连接认证。
  • auth_connect_with_encrypt:表示使用连接认证&&通信加密。
  • auth_connect_with_tls_encrypt:表示使用TLS双向认证&&通信加密。

默认值:auth_connect_with_encrypt

设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。设置后对接GaussStor或重新对接GaussStor生效。

设置建议:对性能要求较高并且确保无安全风险时,可以使用only_auth_connect。

设置不当的风险与影响:配置错误会导致对接GaussStor失败。不使用连接认证可能会导致被仿冒的安全风险。

gaussstor_psk_path

参数说明:设置预共享密钥文件路径,可设置为相对于$GAUSSHOME数据库安装目录路径或系统绝对路径,仅sysadmin用户可以访问。

参数类型:字符串

参数单位:无

取值范围:不超过1024字节的字符串

默认值:share/gaussstor

设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。设置后对接或重新对接GaussStor生效。

设置建议:建议使用默认值。

设置不当的风险与影响:开启认证时对接GaussStor失败。

gaussstor_hash_check

参数说明:写入GaussStor时,是否开启链式哈希防篡改检测功能。

参数类型:布尔型

参数单位:无

取值范围:

  • on:开启链式哈希防篡改检测。
  • off:关闭链式哈希防篡改检测。

默认值:off

设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。设置后对接或重新对接GaussStor生效。

设置建议:需要在gaussstor_auth_type不为none的情况下开启。使用链式防篡改检测能力会对性能有影响,请综合业务安全和性能考虑是否开启。

设置不当的风险与影响:未开启认证时开启链式防篡改开关,对接GaussStor失败。

gaussstor_recycle_ttl

参数说明:指定Xlog文件在GaussStor中的IO-WORM保护时间,在保护时间内下发删除命令,文件内容不会实际删除,此时文件会成为只读状态,直到到达保护时间,文件才会被真实删除;在保护时间之后下发删除命令,此时有可能会触发部分过期数据的直接删除,最新数据会滞后一个保护时间再触发实际删除。

参数类型:整型

参数单位:min(分钟)

取值范围:1 ~ 36792000

默认值:5

设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。

设置建议:调用对接GaussStor接口时,作为接口入参设置,不建议手动更改该GUC的值。

设置不当的风险与影响:设置过大会使GaussStor的Xlog日志文件长时间不被回收,可能导致磁盘空间满。设置过小会降低GaussStor IO-WORM提供的保护能力。

enable_ima

参数说明:控制GaussStor完整性度量开关和远程证明校验。

参数类型:字符串

参数单位:无

取值范围:

  • on_warning:开启完整性度量开关和远程证明校验,度量失败告警。
  • on_exit:开启完整性度量开关和远程证明校验,度量失败退出数据库与GaussStor的连接。
  • off:关闭完整性度量和远程证明校验。

默认值:off

设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。

设置建议:调用对接GaussStor接口时,作为接口入参设置,可以根据业务需要手动更改该GUC的值。

设置不当的风险与影响:如果没有在本地启动证明代理相关配置,开启此GUC参数,将无法正确获取挑战值随机数,导致度量失败。

dr_gaussstor_client_info

参数说明:设置数据库实例对接GaussStor需要绑定的客户端IP列表。

参数类型:字符串

参数单位:无

取值范围:格式为数据库实例的实例名:绑定本地GaussStor的客户端ip列表+数据库实例的实例名:绑定远端GaussStor的客户端ip列表。例如:"dn6001:xxx.xxx.xxx.xxx,dn_6002:xxx.xxx.xxx.xxx,dn_6003:xxx.xxx.xxx.xxx+dn_6001:xxx.xxx.xxx.xxx,dn_6002:xxx.xxx.xxx.xxx,dn_6003:xxx.xxx.xxx.xxx"。

在IPv6环境下,必须将每个IP地址包裹在方括号[]内,例如:"dn_6001:[2001:db8:85a3::8a2e:0370:7334],dn_6002:[240e:fe:abcd:1234::1]+dn_6001:[fe80::1ff:fe23:4567:890a],dn_6002:[2001:db8:0:42:0:8a2e:370:7334]"。

默认值:""

设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。

设置建议:使用对接GaussStor的接口时自动设置,接口中会把用户传入的数据库实例管理ip和数据库实例名匹配,不建议手动修改GUC参数设置。

设置不当的风险与影响:如果在对接前后,修改此参数的值,使其与对接时的配置不一致,重启集群可能会导致GaussStor对接失败。

相关文档