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接口时,自动设置,不建议手动设置。
设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
| 配置项名称 | 描述 | 取值范围 | 默认值 |
|---|---|---|---|
| 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 |
| 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 |
| run_mode | 设置日志复制模式。 |
| "" |
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对接失败。