华为云用户手册

synchronous_commit 参数说明：设置当前事务的同步方式。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 通常情况下，一个事务产生的日志的同步顺序如下： 主机将日志内容写入本地内存。 主机将本地内存中的日志写入本地文件系统。 主机将本地文件系统中的日志内容刷盘。 主机将日志内容发送给备机。 备机接受到日志内容，存入备机内存。 备机将备机内存中的日志写入备机文件系统。 备机将备机文件系统中的日志内容刷盘。 备机回放日志，完成对数据文件的增量更新。 取值范围：枚举类型 on（true, yes, 1）：表示主机事务提交需要等待备机将对应日志刷新到磁盘。 off（false, no, 0）：表示主机事务提交无需等待主机自身将对应日志刷新到磁盘，通常也称为异步提交。 local：表示主机事务提交需要等待主机自身将对应日志刷新到磁盘，通常也称为本地提交。 remote_write：表示主机事务提交需要等待备机将对应日志写到文件系统（无需刷新到磁盘）。 remote_receive：表示主机事务提交需要等待备机接收到对应日志数据（无需写入文件系统）。 remote_apply：表示主机事务提交需要等待备机完成对应日志的回放操作。 true：同on。 false：同off。 yes：同on。 no：同off。 1：同on。 0：同off。 2：同remote_apply。 默认值：on

commit_delay 参数说明：表示一个已经提交的数据在WAL缓冲区中存放的时间。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置为非 0 值时事务执行commit后不会立即写入WAL中，而仍存放在WAL缓冲区中，等待WalWriter进程周期性写入磁盘。 如果系统负载很高，在延迟时间内，其他事务可能已经准备好提交。但如果没有事务准备提交，这个延迟就是在浪费时间。 取值范围：整型， 0～100000（微秒），其中0表示无延迟。 默认值：0

wal_buffers 参数说明：设置用于存放WAL数据的共享内存空间的X LOG _BLCKSZ数，XLOG_BLCKSZ的大小默认为8KB。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：-1~218，最小值为-1，最大值为262144，单位为8KB。 如果设置为-1，表示wal_buffers的大小随着参数shared_buffers自动调整，默认为shared_buffers的1/32。当该值小于8时，会被强制设置为8；当该值大于2048时，会被强制设置为2048。 如果设置为其他值，当小于4时，会被强制设置为4。 独立部署：1GB（60核CPU/480G内存，32核CPU/256G内存）；512MB（16核CPU/128G内存）；256MB（8核CPU/64G内存）；128MB（4核CPU/32G内存）；64MB（4核CPU/16G内存） 金融版（标准型）： CN：512MB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存）；256MB（72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存）；128MB（32核CPU/256G内存，16核CPU/128G内存）；64MB（8核CPU/64G内存） DN：2GB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存）；1GB（80核CPU/640G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存），512MB（16核CPU/128G内存）；256MB（8核CPU/64G内存） 企业版： CN：512MB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，80核CPU/512G内存）；256MB（72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存）；128MB（32核CPU/256G内存，16核CPU/128G内存）；64MB（8核CPU/64G内存） DN：1GB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，80核CPU/512G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存）；512MB（16核CPU/128G内存）；256MB（8核CPU/64G内存） 金融版（数据计算型）： CN：256MB（196核CPU/1536G内存，128核CPU/1024G内存，96核CPU/768G内存）；125MB（72核CPU/576G内存，64核CPU/512G内存）；64MB（32核CPU/256G内存） DN：1GB（196核CPU/1536G内存，128核CPU/1024G内存，96核CPU/768G内存，72核CPU/576G内存，64核CPU/512G内存）；512MB（32核CPU/256G内存） 设置建议：每次事务提交时，WAL缓冲区的内容都写入到磁盘中，因此设置为很大的值不会带来明显的性能提升。如果将它设置成几百兆，就可以在有很多即时事务提交的服务器上提高写入磁盘的性能。根据经验来说，默认值可以满足大多数的情况。

enable_data_replicate 参数说明：当数据库在数据导入行存表时，主机与备机的数据同步方式可以进行选择。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示导入数据行存表时主备数据采用数据页的方式进行同步。当replication_type参数为1时，不允许设置为on，如果此时用guc工具设置成on，会强制改为off。 off表示导入数据行存表时主备数据采用日志（Xlog）方式进行同步。 默认值：off

hadr_recovery_time_target 参数说明：在流式容灾模式下设置hadr_recovery_time_target能够让备数据库实例完成日志写入和回放。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0~3600 （秒） 0是指不开启日志流控，1~3600是指备机能够在hadr_recovery_time_target时间内完成日志的写入和回放，可以保证主数据库实例与备数据库实例切换时能够在hadr_recovery_time_target秒完成日志写入和回放，保证备数据库实例能够快速升主。hadr_recovery_time_target设置时间过小会影响主机的性能，设置过大会失去流控效果。 默认值：60（金融版（数据计算型））

hadr_recovery_point_target 参数说明：在流式容灾模式下设置hadr_recovery_point_target能够让备数据库实例完成日志刷盘的rpo时间。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0~3600 （秒） 0是指不开启日志流控，1~3600是指备机能够在hadr_recovery_point_target时间内完成日志的刷盘，可以保证主数据库实例与备数据库实例切换时日志差距能够在hadr_recovery_point_target秒内，保障备数据库实例升主日志量。hadr_recovery_point_target设置时间过小会影响主机的性能，设置过大会失去流控效果。 默认值：10（金融版（数据计算型））

check_sync_standby 参数说明：打开备机检查开关，主备场景下配置了正确的synchronous_standby_names参数后，当同步备故障时，主机写业务直接报错写失败。该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。 取值范围：on/off on表示开启备机检查。 off表示关闭备机检查。 默认值：off 该参数不支持在job work和自治事务中同步，有可能导致检查不生效。 若指定用户或session中未设置备机检查，开启强同步提交模式下备机故障，执行一个表的写操作会导致另一个用户或session中的同一个表的查询hang，此时需要备机恢复或者手动terminate hang住的客户端。 不支持非写操作中触发写日志的场景中（vacuum analyze，gs_clean等）开启备机检查开关。若备机不满足同步备配置，则该场景会导致业务hang，需要手动terminate。

enable_stream_replication 参数说明：控制主备、主从是否进行数据和日志同步。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 此参数属于性能测试参数，用于测试带有DN备机和不带DN备机的性能参数。关闭参数后，不能进行切换、故障等异常场景测试，否则会出现主备从不一致的情况。 此参数属于受控参数，不建议正常业务场景下关闭此参数。 取值范围：布尔型 on表示打开主备、主从同步。 off表示关闭主备、主从同步。 默认值：on

catchup2normal_wait_time 参数说明：单同步备机情况下，控制备机数据追赶（catchup）阻塞主机的最长时间。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，范围-1~10000，单位为毫秒。 -1表示主机阻塞直到备机数据追赶完成。 0表示备机数据追赶时始终不阻塞主机。 其余值表示备机数据追赶时阻塞主机的最长时间。例如，取值5000，表示当备机数据追赶完成时间还剩5s时，阻塞主机等待其完成。 默认值：-1

sync_config_strategy 参数说明：主机和备机、备机和级联备之间配置文件的同步策略。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：枚举类型 all_node: 主机配置为all_node时，表示允许主机向所有备机主动同步配置文件；备机配置为all_node时，表示允许当前备机向其主机发送同步请求，允许当前备机向其所有级联备主动同步配置文件；级联备配置为all_node时，表示允许当前级联备向其备机发送同步请求。 only_sync_node: 主机配置为only_sync_node时，表示仅允许主机向所有同步备机主动同步配置文件；备机配置为only_sync_node时，表示允许当前备机向其主机发送同步请求，不允许当前备机向其所有级联备主动同步配置文件；级联备配置为only_sync_node时，表示允许当前级联备向其备机发送同步请求。 none_node: 主机配置为none_node时，表示不允许主机向任何备机主动同步配置文件；备机配置为none_node时，表示不允许当前备机向其主机发送同步请求，不允许当前备机向其所有级联备主动同步配置文件；级联备配置为none_node时，表示不允许当前级联备向其备机发送同步请求。 默认值：all_node 注意：在低于503.0.0版本升级到503.0.0版本后配置了该参数，回滚后该参数将无法识别。请勿在升级503.0.0版本期间配置该参数。

vacuum_defer_cleanup_age 参数说明：指定VACUUM使用的事务数，VACUUM会延迟清除无效的行存表记录，延迟的事务个数通过vacuum_defer_cleanup_age进行设置。即VACUUM和VACUUM FULL操作不会立即清理刚刚被删除元组。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0～1000000，值为0表示不延迟。 默认值：0

enable_incremental_catchup 参数说明：控制主备之间数据追赶（catchup）的方式。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示备机catchup时用增量catchup方式，即从备本地数据文件扫描获得主备差异数据文件列表，进行主备之间的catchup。 off表示备机catchup时用全量catchup方式，即从主机本地所有数据文件扫描获得主备差异数据文件列表，进行主备之间的catchup。 默认值：on

synchronous_standby_names 参数说明：潜在同步复制的备机名称列表，每个名称用逗号分隔。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 当前连接的同步备机是列表中的第一个名称。如果当前同步备机失去连接，则它会立即更换下一个优先级更高的备机，并将此备机的名称放入列表中。 备机名称可以通过设置环境变量PGAPPNAME指定。 取值范围：字符串。当取值为*，表示匹配任意提供同步复制的备机名称。支持按如下格式配置： ANY num_sync (standby_name [, ...]) [FIRST] num_sync (standby_name [, ...]) standby_name [, ...] 其中num_sync是事务需要等待其回复的同步复制的备机的数量，standby_name是备机的名称，FIRST以及ANY指定从所列服务器中选取同步复制的备机的策略。 ANY N (dn_instanceId1, dn_instanceId2,...)表示在括号内任选N个主机名称作为同步复制的备机名称列表。例如，ANY 1(dn_instanceId1, dn_instanceId2)表示在dn_instanceId1和dn_instanceId2中任选一个作为同步复制的备机名称。 FIRST N (dn_instanceId1, dn_instanceId2,...)表示在括号内按出现顺序的先后作为优先级选择前N个主机名称作为同步复制的备机名称列表。例如，FIRST 1 (dn_instanceId1, dn_instanceId2)表示选择dn_instanceId1作为同步复制的备机名称。 dn_instanceId1, dn_instanceId2,...和FIRST 1 (dn_instanceId1, dn_instanceId2,...)具有的含义相同。 若使用gs_guc工具设置该参数，需要如下设置： gs_guc reload -Z datanode -N @NODE_NAME@ -D @DN_PATH@ -c "synchronous_standby_names='ANY NODE 1(dn_instanceId1, dn_instanceId2)'"; 或者： gs_guc reload -Z datanode -N @NODE_NAME@ -D @DN_PATH@ -c "synchronous_standby_names='ANY 1(AZ1, AZ2)'"; 默认值：*

查询规划 介绍查询优化器方法配置、开销常量、规划算法以及一些配置参数。 优化器中涉及的两个参数： INT_MAX数据类型INT的最大值，其值为2147483647。 DBL_MAX数据类型FLOAT的最大值。 全局设置查询规划相关参数除了客户业务外也会对数据库自身运维和监控业务造成影响，如WDR报告生成、扩容、重分布、数据导入导出等。 优化器方法配置 优化器开销常量 基因查询优化器 其他优化器选项 父主题： GUC参数说明

thread_top_level 参数说明：提高 WALWRITERAUXILIARY || WALWRITER || STARTUP ||WALRECEIVER || WAL_NORMAL_SENDER || PGSTAT线程的优先级到最高。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示上述线程优先级提高到最高。 off表示不提高上述线程优先级。 默认值：off

repl_uuid 参数说明：设置用于主备UUID验证的UUID码。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 如果主机上开启了UUID验证功能、且配置了非空字符串的repl_uuid验证码，那么备机也需要开启UUID验证功能、且配置相同的repl_uuid验证码，否则主备日志复制和备机重建请求将被主机拒绝。 该参数支持SIGHUP动态加载新值。修改之后，不影响已建连的主备连接，对后续主备复制请求和主备重建请求生效。 支持Quorum、DCF协议下的备机重建验证；支持Quorum协议下的主备复制验证；不支持DCF协议下的主备复制验证。 不支持跨集群主、备之间的认证，包括Dorado主备集群和容灾主备集群。 UUID验证功能主要为了防止主、备误连导致的数据串扰和污染，不是用于安全目的。 该参数不支持主、备间自动同步。 取值范围：字符串类型。长度0~63个字符，字母和数字的组合，大小写不敏感，内部统一转换为小写存储。空字符串表示不启用UUID验证功能。 默认值：空字符串

replconninfo4 参数说明：设置本端侦听和鉴权的第四个节点信息。集群安装成功后自动配置无需手动修改。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串。其中空字符串表示没有配置第四个节点信息。 默认值：DN侦听的第四个连接信息。 示例： replconninfo4 = 'localhost=127.0.0.1 localport=XXXX localheartbeatport=XXXX localservice=XXXX remotehost=127.0.0.1 remoteport=XXXX remoteheartbeatport=XXXX remoteservice=XXXX'

max_replication_slots 参数说明：设置主机端的日志复制slot个数。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0 ~ 1024（建议取值范围：8 ~ 100） 默认值：20 设置建议： 当使用双机复制、备份恢复、逻辑解码时，该参数值建议设为：当前物理流复制槽数+备份槽数+所需的逻辑复制槽数。 如果实际设置值比上述建议值小，可能造成这些功能不可用或异常。 物理流复制槽提供了一种自动化的方法来确保主DN在所有备DN收到xlog之前，xlog不会被移除。也就是说物理流复制槽用于支撑集群HA。集群所需要的物理流复制槽数为：一组DN中，备与主DN之间的比例。例如，假设集群的DN高可用方案为1主、1备，则所需物理流复制槽数为1。又例如，假设集群的DN高可用方案为1主3备，则所需物理流复制槽数为3。 备份槽：记录备份执行过程中的一些复制信息，全量备份和增量备份各自对应单独的备份槽，共2个。 关于逻辑复制槽数，请按如下规则考虑。 一个逻辑复制槽只能解码一个Database的修改，如果需要解码多个Database，则需要创建多个逻辑复制槽。 如果需要多路逻辑复制同步给多个目标数据库，在源端数据库需要创建多个逻辑复制槽，每个逻辑复制槽对应一条逻辑复制链路。

repl_auth_mode 参数说明：设置主备复制和备机重建的验证模式。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 如果主机上开启了UUID验证功能、且配置了非空字符串的repl_uuid验证码，那么备机也需要开启UUID验证功能、且配置相同的repl_uuid验证码，否则主备日志复制和备机重建请求将被主机拒绝。 该参数支持SIGHUP动态加载新值。修改之后不影响已建连的主备连接，对后续主备复制请求和主备重建请求生效。 支持Quorum、DCF协议下的备机重建验证；支持Quorum协议下的主备复制验证；不支持DCF协议下的主备复制验证。 不支持跨集群主、备之间的认证，包括Dorado主备集群和容灾主备集群。 UUID验证功能主要为了防止主、备误连导致的数据串扰和污染，不是用于安全目的。 该参数不支持主、备间自动同步。 取值范围：枚举类型 off：表示关闭UUID验证功能。 default：表示关闭UUID验证功能。 uuid：表示开启UUID验证功能。 默认值：default

replconninfo7 参数说明：设置本端侦听和鉴权的第七个节点信息。集群安装成功后自动配置无需手动修改。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串。其中空字符串表示没有配置第七个节点信息。 默认值：DN侦听的第七个连接信息。 示例： replconninfo7 = 'localhost=127.0.0.1 localport=XXXX localheartbeatport=XXXX localservice=XXXX remotehost=127.0.0.1 remoteport=XXXX remoteheartbeatport=XXXX remoteservice=XXXX'

replconninfo1 参数说明：设置本端侦听和鉴权的第一个节点信息。集群安装成功后自动配置无需手动修改。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串。其中空字符串表示没有配置第一个节点信息。 默认值：DN侦听的第一个连接信息。 示例： replconninfo1 = 'localhost=127.0.0.1 localport=XXXX localheartbeatport=XXXX localservice=XXXX remotehost=127.0.0.1 remoteport=XXXX remoteheartbeatport=XXXX remoteservice=XXXX'

replconninfo2 参数说明：设置本端侦听和鉴权的第二个节点信息。集群安装成功后自动配置无需手动修改。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串。其中空字符串表示没有配置第二个节点信息。 默认值：DN侦听的第二个连接信息。 示例： replconninfo2 = 'localhost=127.0.0.1 localport=XXXX localheartbeatport=XXXX localservice=XXXX remotehost=127.0.0.1 remoteport=XXXX remoteheartbeatport=XXXX remoteservice=XXXX'

replconninfo3 参数说明：设置本端侦听和鉴权的第三个节点信息。集群安装成功后自动配置无需手动修改。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串。其中空字符串表示没有配置第三个节点信息。 默认值：DN侦听的第三个连接信息。 示例： replconninfo3 = 'localhost=127.0.0.1 localport=XXXX localheartbeatport=XXXX localservice=XXXX remotehost=127.0.0.1 remoteport=XXXX remoteheartbeatport=XXXX remoteservice=XXXX'

enable_wal_shipping_compression 参数说明：在流式容灾模式下设置启动跨集群日志压缩功能。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 该参数仅作用于流式容灾中跨集群传输的一对walsender与walreceiver中，在主集群上配置。 取值范围：布尔型 true 表示打开流式容灾跨集群日志压缩 false 表示关闭流式容灾跨集群日志压缩 默认值：false

replconninfo5 参数说明：设置本端侦听和鉴权的第五个节点信息。集群安装成功后自动配置无需手动修改。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串。其中空字符串表示没有配置第五个节点信息。 默认值：DN侦听的第五个连接信息。 示例： replconninfo5 = 'localhost=127.0.0.1 localport=XXXX localheartbeatport=XXXX localservice=XXXX remotehost=127.0.0.1 remoteport=XXXX remoteheartbeatport=XXXX remoteservice=XXXX'

replconninfo6 参数说明：设置本端侦听和鉴权的第六个节点信息。集群安装成功后自动配置无需手动修改。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串。其中空字符串表示没有配置第六个节点信息。 默认值：DN侦听的第六个连接信息。 示例： replconninfo6 = 'localhost=127.0.0.1 localport=XXXX localheartbeatport=XXXX localservice=XXXX remotehost=127.0.0.1 remoteport=XXXX remoteheartbeatport=XXXX remoteservice=XXXX'

max_wal_senders 参数说明：指定事务日志发送进程的并发连接最大数量。不可大于等于max_connections。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 wal_level必须设置为archive、hot_standby或者logical以允许备机的连接。 取值范围：整型，0 ~ 1024（建议取值范围：8 ~ 100） 只有当使用单DN实例无主备场景下才可以设置0。 默认值： 设置建议：每个备机与主机的日志复制连接均会占用一个walsender线程，因此此参数务必大于等于DN数量，否则会导致备机无法连接主机。当有逻辑复制需求时，每个日志抽取线程会占用一个walsender线程，有逻辑复制时需要设置max_wal_senders大于备机+逻辑复制抽取线程的数量。

wal_sender_timeout 参数说明：设置本端等待事务日志接收端接收日志的最大等待时间。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 如果主机数据较大，重建操作需要增大此参数的值，主机数据在500GB时，此参数的参考值为600s。 此值不能大于wal_receiver_timeout或数据库重建时的超时参数。 取值范围：整型，0 ~ 2147483647‬，单位为毫秒（ms）。 默认值：6s

wal_keep_segments 参数说明：“pg_xlog”目录下保留事务日志文件的最小数目。备机通过获取主机此处的日志进行流复制。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，2 ~ INT_MAX 默认值：128 设置建议： 当服务器开启日志归档或者从检查点恢复时，保留的日志文件数量可能大于wal_keep_segments设定的值。 如果此参数设置过小，则在备机请求事务日志时，此事务日志可能已经被产生的新事务日志覆盖，导致请求失败，主备关系断开。 当双机为异步传输时，以COPY方式连续导入4G以上数据需要增大wal_keep_segments配置。以T6000单板为例，如果导入数据量为50G，建议调整参数为1000。您可以在导入完成并且日志同步正常后，动态恢复此参数设置。

max_standby_archive_delay 参数说明：当开启双机热备模式时，如果备机正处理归档WAL日志数据，这时进行查询就会产生冲突，此参数就是设置备机取消查询之前所等待的时间。当前版本设置暂不生效，统一由参数max_standby_streaming_delay控制。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 -1表示允许备机一直等待冲突的查询完成。 取值范围：整型，范围：-1~2147483647‬，单位为毫秒。 默认值：3s（即3000ms）