华为云用户手册

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

synchronous_standby_names 参数说明：潜在同步复制的备机名称列表，每个名称用逗号分隔。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 当前连接的同步备机是列表中的第一个名称。如果当前同步备机失去连接，则它会立即更换下一个优先级更高的备机，并将此备机的名称放入列表中。 备机名称可以通过设置环境变量PGAPPNAME指定。 取值范围：字符串。当取值为*，表示匹配任意提供同步复制的备机名称。支持按如下格式配置： ANY num_sync (standby_name [, ...]) [, 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)'"; 默认值：*

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

walwriter_sleep_threshold 参数说明：xlogflusher进入sleep之前空闲xlog刷新的次数，达到阈值会休眠。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，1-50000。 默认值：500（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存）；50（32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存，4核CPU/32G内存，4核CPU/16G内存）

wal_rec_writer_bind_cpu 参数说明：WAL rec writer 线程绑定cpu的核号。 默认是-1，-1是无效值，就是不绑核。 虽然数值范围为INT_MAX，但是实际和所用设备核数相关，所设定CPU核号不存在时报错中断。 多个线程允许绑定一个核，但是性能下降，不建议。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：最大值INT_MAX ，最小值-1。 默认值：-1

wal_receiver_bind_cpu 参数说明：WAL receiver 线程绑定cpu的核号。 默认是-1，-1是无效值，就是不绑核。 虽然数值范围为INT_MAX，但是实际和所用设备核数相关，所设定CPU核号不存在时报错中断。 多个线程允许绑定一个核，但是性能下降，不建议。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：最大值INT_MAX ，最小值-1。 默认值：-1

full_page_writes 参数说明：设置 GaussDB Kernel服务器在检查点之后对页面的第一次修改时，是否将每个磁盘页面的全部内容写到WAL日志中。当增量检查点开关和enable_double_write同时打开时，则不使用full_page_writes。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置这个参数是因为在操作系统崩溃过程中可能磁盘页面只写入了一部分内容，从而导致在同一个页面中包含新旧数据的混合。在崩溃后的恢复期间，由于在WAL日志中存储的行变化信息不够完整，因此无法完全恢复该页。把完整的页面影像保存下来就可以保证页面被正确还原，代价是增加了写入WAL日志的数据量。 关闭此参数，在系统崩溃的时候，可能无法恢复原来的数据。如果服务器硬件的特质（比如电池供电的磁盘控制器）可以减小部分页面的写入风险，或者文件系统特性支持（比如ReiserFS 4），并且清楚知道写入风险在一个可以接受的范畴，可以关闭这个参数。 取值范围：布尔型 on表示启用此特性。 off表示关闭此特性。 默认值：on

wal_file_init_num 参数说明：WAL编写器将创建的xlog段文件的数量。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0~1000000。 默认值：10（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存）；0（32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存，4核CPU/32G内存，4核CPU/16G内存）

wal_sync_method 参数说明：设置向磁盘强制更新WAL数据的方法。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 如果将fsync关闭，这个参数的设置就没有意义，因为所有数据更新都不会强制写入磁盘。 取值范围：枚举类型 open_datasync表示用带O_DSYNC选项的open()打开“WAL”文件。 fdatasync表示每次提交的时候都调用fdatasync()（支持suse10和suse11）。 fsync_writethrough表示每次提交的时候调用fsync()强制把缓冲区任何数据写入磁盘。 由于历史原因，Windows平台支持将wal_sync_method设置为fsync_writethrough。在windows平台上fsync_writethrough和fsync等效。 fsync表示每次提交的时候调用fsync()（支持suse10和suse11）。 open_sync表示用带O_SYNC选项的open()写“WAL”文件（支持suse10和suse11）。 不是所有的平台都支持以上参数。 默认值：fdatasync

wal_sender_bind_cpu_attr 参数说明：用于控制日志发送的绑核操作，仅sysadmin用户可以访问。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 'nobind'：线程不做绑核。 'cpuorderbind: 8-12': 从8号核开始一个线程绑定一个CPU，区间内核不足就不参与绑定。建议区间大小设置为大于等于参数max_wal_senders。 取值范围：字符串，长度大于0，该参数不区分大小写。 默认值：'nobind'

wal_flush_delay 参数说明：遍历WalInsertStatusEntryTbl时，遇到WAL_NOT_COPIED状态entry时等待的时间间隔。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型， 0 ~ 90000000（微秒） 默认值： 1us（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存，4核CPU/32G内存）；100us（4核CPU/16G内存）

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

wal_flush_timeout 参数说明：遍历WalInsertStatusEntryTbl的超时时间。Xlog刷盘自适应控制的刷盘IO遍历WalInsertStatusEntryTbl等待的最大时间。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 如果时间过长可能造成Xlog刷盘频率降低，降低Xlog处理性能。 取值范围：整型， 0 ~ 90000000（微秒） 默认值： 2us（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存，4核CPU/32G内存）；800us（4核CPU/16G内存）

wal_level 参数说明：设置写入WAL信息量的级别，不能为空或被注释掉。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 如果需要启用WAL日志归档和主备机的数据流复制，必须将此参数设置为archive、hot_standby或者logical。 如果此参数设置为minimal，archive_mode必须设置为off，hot_standby必须设置为off，max_wal_senders参数设置为0，且需为单机环境，否则将导致数据库无法启动。 如果此参数设置为archive，hot_standby必须设置为off，否则将导致数据库无法启动。但是，hot_standby在双机环境中不能设置为off，具体参见hot_standby参数说明。 取值范围：枚举类型 minimal 优点：一些重要操作（包括创建表、创建索引、簇操作和表的复制）都能安全的跳过，这样就可以使操作变得更快。 缺点：WAL仅提供从数据库服务器崩溃或者紧急关闭状态恢复时所需要的基本信息，无法用WAL归档日志恢复数据。 archive 这个参数增加了WAL归档需要的日志信息，从而可以支持数据库的归档恢复。 hot_standby 这个参数进一步增加了在备机上运行的SQL查询的信息，这个参数只能在数据库服务重新启动后生效。 为了在备机上开启只读查询，wal_level必须在主机上设置成hot_standby，并且备机必须打开hot_standby参数。hot_standby和archive级别之间的性能只有微小的差异，如果它们的设置对产品的性能影响有明显差异，欢迎反馈。 logical 这个参数表示WAL日志支持逻辑复制。 默认值：hot_standby

fsync 参数说明：设置GaussDB Kernel服务器是否使用fsync()系统函数（请参见wal_sync_method）确保数据的更新及时写入物理磁盘中。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 使用fsync()系统函数可以保证在操作系统或者硬件崩溃的情况下将数据恢复到一个已知的状态。 如果将此参数关闭，可能会在系统崩溃时无法恢复原来的数据，导致数据库不可用。 取值范围：布尔型 on表示使用fsync()系统函数。 off表示不使用fsync()系统函数。 默认值：on

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

effective_cache_size 参数说明：设置优化器在一次单一的查询中可用的磁盘缓冲区的有效大小。 设置这个参数，还要考虑GaussDB Kernel的共享缓冲区以及内核的磁盘缓冲区。另外，还要考虑预计的在不同表之间的并发查询数目，因为它们将共享可用的空间。 这个参数对GaussDB Kernel分配的共享内存大小没有影响，它也不会使用内核磁盘缓冲，它只用于估算。数值是用磁盘页来计算的，通常每个页面是8192字节。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，1～2147483647，单位为8KB。 比默认值高的数值可能会导致使用索引扫描，更低的数值可能会导致选择顺序扫描。 默认值： 280GB（196核CPU/1536G内存）；180GB（128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；135GB（96核CPU/768G内存）；100GB（80核CPU/640G内存）；90GB（64核CPU/512G内存）；80GB（60核CPU/480G内存）；40GB（32核CPU/256G内存）；18GB（16核CPU/128G内存）；8GB（8核CPU/64G内存）；4GB（4核CPU/32G内存）；2GB（4核CPU/16G内存）

random_page_cost 参数说明：设置优化器计算一次非顺序抓取磁盘页面的开销。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 虽然服务器允许将random_page_cost设置的比seq_page_cost小，但是物理上实际不受影响。如果所有数据库都位于随机访问内存中时，两者设置为相等很合理。因为在此种情况下，非顺序抓取页并没有副作用。同样，在缓冲率很高的数据库上，应该相对于CPU参数同时降低这两个值，因为获取内存中的页要比通常情况下开销小很多。 取值范围：浮点型，0～DBL_MAX。 默认值：4 对于特别表空间中的表和索引，可以通过设置同名的表空间的参数来覆盖这个值。 相对于seq_page_cost，减少这个值将导致系统更倾向于使用索引扫描，而增加这个值使得索引扫描开销比较高。可以通过同时增加或减少这两个值来调整磁盘I/O相对于CPU的开销。

hot_standby_feedback 参数说明：设置是否允许将备机上执行查询的结果反馈给主机，这可以避免查询冲突。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示允许将备机上执行查询的最小事务号反馈给主机。 off表示不允许将备机上执行查询的最小事务号反馈给主机。 默认值：off 当该参数为on时，主机的旧版本数据的清理会受限于备机正在读的事务，即主机只允许清理小于备机反馈回来的事务所作的更改。 所以，若该参数开启时，会影响主机的性能。若备机回放与查询冲突，出现查询报错，建议适当调大max_standby_streaming_delay。

wal_receiver_status_interval 参数说明：设置WAL日志接收进程的状态通知给主机的最大时间间隔。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0 ~ INT_MAX ，单位为毫秒。 默认值：5s（即5000ms） 当该参数设置为0时，表示关闭备机向主机反馈日志接收位置等信息，可能会导致主机事务提交阻塞、switchover操作失败等异常现象。正常业务场景，不建议将该参数设置为0。

standby_force_recycle_ratio 参数说明：开启极致RTO功能后，备机读相关文件的触发强制回收的比例。当base page文件总大小超过max_standby_base_page_size* standby_force_recycle_ratio，或者lsn info文件总大小超过max_standby_lsn_info_size* standby_force_recycle_ratio时，触发强制回收，会有查询被取消。当standby_force_recycle_ratio = 0时，不会启动强制回收，max_standby_base_page_size和max_standby_lsn_info_size也不会生效。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：双精度浮点类型，0.0～1.0。 默认值：0.8

standby_max_query_time 参数说明：开启极致RTO功能后，支持的备机上查询的最大时间，超过该时间会被取消。注：何时取消查询受回收线程的时间间隔参数standby_recycle_interval和查询取快照的时间影响，因此备机上查询的实际执行时间要大于该参数。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0~86400‬，单位是秒（s）。 默认值：600

max_standby_streaming_delay 参数说明：当开启双机热备模式时，如果备机正通过流复制接收WAL日志数据，这时进行查询就会产生冲突，这个参数就是设置备机取消查询之前所等待的时间。当参数值较大，或业务压力大时，概率出现等待事务回放落盘的报错。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 -1表示允许备机一直等待冲突的查询完成。 取值范围：整型（毫秒），范围：-1~INT_MAX 默认值：3s（即3000ms）

hot_standby 参数说明：设置是否允许备机在恢复过程中连接和查询。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 如果此参数设置为on，wal_level级别必须设置为hot_standby或以上，否则将导致数据库无法启动。 在双机环境中，因为会对双机其他一些功能产生影响，hot_standby参数不能设置成off。 如果hot_standby参数曾经被关闭，且wal_level参数曾被设置低于hot_standby等级，那么，再次打开hot_standby参数之前，为了确保主备环境下备机上待回放的日志都可以支持备机查询功能，需要进行如下操作： 将主、备的wal_level参数调整到hot_standby等级或以上，并重启实例生效。 在主机上执行checkpoint操作，并通过查询pg_stat_get_wal_senders()系统函数，确认各个备机的receiver_replay_location追上主机当前的sender_flush_location，保证wal_level的调整同步到备机并生效，且备机不需要再回放之前低等级的日志。 将主、备的hot_standby参数打开（设为on），并重启实例生效。 当开启极致RTO功能后（配置参数recovery_parse_workers和recovery_redo_workers），备机查询不支持列存表、段页式表。 取值范围：布尔型 on表示允许备机在恢复过程中连接和查询。 off表示不允许备机在恢复过程中连接和查询。 默认值：on

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

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

archive_timeout 参数说明：表示归档周期。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 超过该参数设定的时间时强制切换WAL段。 由于强制切换而提早关闭的归档文件仍然与完整的归档文件长度相同。因此，将archive_timeout设为很小的值将导致占用巨大的归档存储空间，建议将archive_timeout设置为60秒。 取值范围：整型，0 ~ 1073741823，单位为秒。其中0表示禁用该功能。 默认值：0

time_to_target_rpo 参数说明： 双数据库实例异地灾备模式下，设置主数据库实例发生异常发生时到已归档到OBS的恢复点所允许的time_to_target_rpo秒。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0~3600（秒） 双数据库实例异地灾备模式下，主数据库实例日志将被归档到OBS。0是指不开启日志流控，1~3600是指设置主数据库实例发生异常发生时到已归档到OBS的恢复点所允许的time_to_target_rpo秒，保证主数据库实例因灾难崩溃时，最多可能丢失的数据的时长在允许范围内。time_to_target_rpo设置时间过小会影响主机的性能，设置过大会失去流控效果。 默认值：0

archive_command 参数说明：由管理员设置的用于归档WAL日志的命令，建议归档路径为绝对路径。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 当archive_dest和archive_command同时配置时，WAL日志优先保存到archive_dest所设置的目录中，archive_command配置的命令不生效。 字符串中任何%p都被要归档的文件的绝对路径代替，而任何%f都只被该文件名代替（相对路径都相对于数据目录的）。如果需要在命令里嵌入%字符就必须双写%。 这个命令当且仅当成功的时候才返回零。示例如下： 1 archive_command = 'cp --remove-destination %p /mnt/server/archivedir/%f' --remove-destination选项作用为：拷贝前如果目标文件已存在，会先删除已存在的目标文件，然后执行拷贝操作。 如果归档命令有多条，则需将其写入SHELL脚本文件中，然后将archive_command配置为执行该脚本的命令。示例如下： --假设多条命令如下。test ! -f dir/%f && cp %p dir/%f--则test.sh脚本内容如下。test ! -f dir/$2 && cp $1 dir/$2 --归档命令如下。archive_command='sh dir/test.sh %p %f' 取值范围：字符串 默认值：(disabled)

archive_dest 参数说明：由管理员设置的用于归档WAL日志的目录，建议归档路径为绝对路径。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 当archive_dest和archive_command同时配置时，WAL日志优先保存到archive_dest所设置的目录中，archive_command配置的命令不生效。 字符串中如果是相对路径为相对于数据目录的。示例如下。 1 archive_dest = '/mnt/server/archivedir/' 取值范围：字符串 默认值：空字符串