华为云用户手册

keepalives_interval 参数说明：在支持TCP_KEEPINTVL套接字选项的操作系统上，此参数控制GTM服务端保持活跃信号发送的时间间隔。 参数类型：整型 参数单位：s（秒） 取值范围：0 ~ 2147483647 默认值：0 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

local_host 参数说明：HA本地地址，根据集群配置文件进行设置，不需要手动设置。该地址支持IPv4与IPv6格式。 参数类型：字符串 参数单位：无 取值范围：字符串，要符合标识符的命名规范。 默认值："" 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

standby_connection_timeout 参数说明：设置GTM主备之间的超时时间。此参数控制GTM主备机之间的超时设置，增大该参数可以增加GTM主备之间的网络容错能力，但是也会增加故障场景下GTM主备断连的检测时长。 参数类型：整型 参数单位：s（秒） 取值范围：5 ~ 2147483647 默认值：5 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：设置过大时，可能无法及时检测到断连故障。

active_host 参数说明：目标GTM的地址。即在主GTM上时为备GTM的地址，在备GTM上时为主GTM的地址。该地址支持IPv4与IPv6格式。 参数类型：字符串 参数单位：无 取值范围：字符串，要符合标识符的命名规范。 默认值："" 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

keepalives_idle 参数说明：在支持TCP_KEEPIDLE套接字选项的操作系统上，此参数控制GTM服务端连接上客户端之后，如果没有数据发送，多长时间发送保持活跃信号。 参数类型：整型 参数单位：s（秒） 取值范围：0 ~ 2147483647 默认值：0 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

keepalives_count 参数说明：在支持TCP_KEEPCNT套接字选项的操作系统上，此参数控制GTM服务端在断开与客户端连接之前，等待未响应的保持活跃信号的最大数量。该参数仅在备GTM上生效。 参数类型：整型 参数单位：无 取值范围：0 ~ 2147483647 默认值：0，表示GTM未收到客户端反馈的保持活跃信号则立即断开连接。 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

GLOBAL_WLM_RESPOOL_IO_INFO 该视图用于查看分布式下所有节点实时的资源池I/O使用情况。查询该视图需要sysadmin权限或者monadmin权限。 该视图只能查询主DN节点上的数据，备节点需要登录到备节点上后使用系统函数gs_wlm_respool_io_info()查询I/O使用情况。 表1 GLOBAL_WLM_RESPOOL_IO_INFO字段 名称 类型 描述 node_name name 节点名称。 respool_name name 资源池名称。 io_limits integer 每秒触发I/O的次数上限。0表示不控制。 行存单位：GUC参数io_control_unit，I/O管控时用来对I/O次数进行计数的单位。1个io_control_unit次为1次IOPS。 io_priority text I/O利用率高达90%时，消耗I/O作业进行I/O资源管控时关联的优先级等级。None表示不控制。 current_iops integer 当前I/O已经触发的次数。 当前I/O统计值存在偶尔超过上限的情况，与I/O统计算法有关，属于正常波动。 示例： 1 2 3 4 5 6 7 8 gaussdb=# SELECT * FROM GLOBAL_WLM_RESPOOL_CONCURRENCY_INFO; node_name | respool_name | io_limits | io_priority | current_iops --------------+--------------+-----------+-------------+-------------- coordinator1 | default_pool | 0 | None | 0 datanode2 | default_pool | 0 | None | 0 datanode3 | default_pool | 0 | None | 0 datanode1 | default_pool | 0 | None | 0 (4 rows) 父主题： 负载管理

blackbox_number 参数说明：控制“$GAUSS LOG /gs_blackbox/{nodename}”目录下最多能够保留的黑匣子文件个数。 参数类型：整型 参数单位：无 取值范围：0 ~ 10，其中0表示不使用黑匣子功能。 默认值：5 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：参数设置为0将关闭功能，不保留黑匣子文件，有可能影响性能诊断。

PG_INDEX PG_INDEX系统表存储索引的一部分信息，其他的信息大多数在PG_CLASS中。 表1 PG_INDEX字段 名称 类型 描述 indexrelid oid 这个索引在12.2.15.28 PG_CLASS里的记录的OID。 indrelid oid 使用这个索引的表在12.2.15.28 PG_CLASS里的记录的OID。 indnatts smallint 索引中的字段数目。 indisunique boolean 是否为唯一索引。 true：是唯一索引。 false：不是唯一索引。 indisprimary boolean 该索引是否为该表的主键。 true：该索引是该表的主键。这个字段为真的时候indisunique总是为真。 false：该索引不是该表的主键。 indisexclusion boolean 该索引是否支持排他约束。 true：该索引支持排他约束。 false：该索引不支持排他约束。 indimmediate boolean 插入数据时是否进行唯一性检查。 true：在插入数据时会立即进行唯一性检查。 false：在插入数据时不会进行唯一性检查。 indisclustered boolean 该表是否在这个索引上建簇。 true：该表在这个索引上建簇。 false：该表没有在这个索引上建簇。 indisusable boolean 该索引对insert/select是否可用。 true：该索引对insert/select可用。 false：该索引对insert/select不可用。 indisvalid boolean true：该索引可以用于查询。 false：该索引可能不完整，仍然必须在INSERT/UPDATE操作时进行更新，不过不能安全的用于查询。如果是唯一索引，则唯一属性也将不为真。 indcheckxmin boolean true：查询不能使用索引，直到pg_index此行的xmin低于其快照的TransactionXmin，因为该表可能包含它们能看到的不兼容行断开的HOT链。 false：查询可以用索引。 indisready boolean true：此索引对插入数据是可用的。 false：在插入或修改数据时忽略此索引。 indkey int2vector 这是一个包含indnatts值的数组，这些数组值表示这个索引所建立的表字段。比如一个值为1 3的意思是第一个字段和第三个字段组成这个索引键字。这个数组里的零表明对应的索引属性是在这个表字段上的一个表达式，而不是一个简单的字段引用。 indcollation oidvector 索引各列对应的排序规则的OID，详情请参见PG_COLLATION。 indclass oidvector 对于索引键字里面的每个字段，这个字段都包含一个指向所使用的操作符类的OID，详情请参见12.2.15.53 PG_OPCLASS。 indoption int2vector 存储列前标识位，该标识位是由索引的访问方法定义。 indexprs pg_node_tree 表达式树（以nodeToString()形式表现）用于那些非简单字段引用的索引属性。它是一个列表，个数与indkey中的零值个数相同。如果所有索引属性都是简单的引用，则为空。 indpred pg_node_tree 部分索引断言的表达式树（以nodeToString()的形式表现）。如果不是部分索引，则是空字符串。 indisreplident boolean 此索引的列是否为逻辑解码的解码列。 true：此索引的列成为逻辑解码的解码列。 false：此索引的列不是逻辑解码的解码列。 indnkeyatts smallint 索引中的总字段数，超出indnatts的部分不参与索引查询。 indcctmpid oid Ustore在线创建索引时临时表OID。 indisvisible boolean true：此索引状态为可见，即优化器可以使用此索引。 false：此索引状态为不可见，此时若enable_invisible_indexes参数为off，则优化器不可以使用此索引；若enable_invisible_indexes参数为on，则优化器可以使用此索引。 父主题： 其他系统表

COMM_IPC 参数说明：通信性能问题定位开关，该参数设置是否打印通信各个节点的报文收发情况。 参数类型：布尔型 参数单位：无 取值范围： on：表示打开报文收发统计日志。 off：表示关闭报文收发统计日志。 默认值：off 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 set logging_module='on(COMM_IPC)'; --打开 set logging_module='off(COMM_IPC)'; --关闭 show logging_module; --查看设置结果 设置建议：设置为on时，打印日志量较大，会增加额外的overhead并降低数据库性能，建议仅在调试时打开，调试完后及时关闭。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

comm_stat_mode 参数说明：TCP代理通信库stat模式开关，该参数设置是否打印通信层的统计信息。 参数类型：布尔型 参数单位：无 取值范围： on：表示打印通信库统计信息日志。 off：表示不打印通信库统计信息日志。 默认值：off 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：设置为on时，打印日志量较大，会增加额外的overhead并降低数据库性能，建议仅在调试时打开。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

enable_stateless_pooler_reuse 参数说明：pooler连接池复用切换开关，开启后可对已有的空闲TCP连接进行复用，重启集群生效。 参数类型：布尔型 参数单位：无 取值范围： on：表示使用pooler复用模式。 off：表示关闭pooler复用模式。 默认值：on 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：CN和DN需要同步设置。如果CN设置enable_stateless_pooler_reuse为off，DN设置enable_stateless_pooler_reuse为on会导致集群不能正常通信，因此必须对该参数做CN和DN全局相同的配置，重启集群生效。 设置不当的风险与影响：当该参数关闭时，pooler连接池复用粒度会降低，DN的内存消耗可能会增加。

comm_cn_dn_logic_conn 参数说明：CN和DN间逻辑连接特性开关，重启集群生效。 不再提供CN和DN之间的逻辑连接支持，为了保持兼容，提供此参数的接口，但此参数会在设置过程中强制改为off。 参数类型：布尔型 参数单位：无 取值范围： on：表示CN和DN之间连接为逻辑链接，使用libcomm组件。 off：表示CN和DN之间连接为物理连接，使用libpq组件。 默认值：off 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：该参数开启时，CN和DN之间会使用逻辑连接用于解决socket数量上限瓶颈，逻辑连接通信库会有性能开销。

COMM_PA RAM 参数说明：通信性能问题定位开关，该参数设置是否打印节点通信过程中session参数设置情况。 参数类型：布尔型 参数单位：无 取值范围： on：表示打开连接的session参数设置日志。 off：表示关闭连接的session参数设置日志。 默认值：off 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 set logging_module='on(COMM_PARAM)'; --打开 set logging_module='off(COMM_PARAM)'; --关闭 show logging_module; --查看设置结果 设置建议：设置为on时，打印日志量较大，会增加额外的overhead并降低数据库性能，建议仅在调试时打开，调试完后及时关闭。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

comm_timer_mode 参数说明：TCP代理通信库timer模式开关，该参数设置是否打印通信层各阶段时间桩。 参数类型：布尔型 参数单位：无 取值范围： on：表示打印通信库详细时间桩日志。 off：表示不打印通信库详细时间桩日志。 默认值：off 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：设置为on时，打印日志量较大，会增加额外的overhead并降低数据库性能，建议仅在调试时打开。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

comm_no_delay 参数说明：是否使用通信库连接的NO_DELAY属性。 参数类型：布尔型 参数单位：无 取值范围： on：表示使用NO_DELAY属性。 off：表示不使用NO_DELAY属性。 默认值：off 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：总体上，时延敏感型业务建议打开；吞吐要求高时，建议关闭。此外，当集群出现因每秒接收数据包过多导致的丢包时，需设置为off，以便小包合并成大包发送，减少数据包总数。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

comm_client_bind 参数说明：通信库客户端发起连接时是否使用bind绑定指定IP。 参数类型：布尔型 参数单位：无 取值范围： on：表示绑定指定IP。 off：表示不绑定指定IP。 默认值：off 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：如果集群某一节点存在多个IP处于同一通信网段时，需设置为on。此时将绑定本地listen_addresses指定的IP发起通信，随机端口号不能重复使用，集群并发数量会受到可用随机端口号数量的限制。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

comm_usable_memory 参数说明：单个DN内TCP代理通信库缓存最大可使用内存。 参数类型：整型 参数单位：kB 取值范围：102400 ~ 1073741823 默认值：4096000（即4000MB） 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值102400，表示comm_usable_memory为102400kB；带单位取值100MB，表示comm_usable_memory为100MB。取值如果要带单位，必须为kB、MB、GB。 设置建议：推荐使用默认值。此参数需根据环境内存及部署方式具体配置。 设置不当的风险与影响：参数设置过大会造成OOM，过小会降低TCP代理通信库性能。

comm_memory_pool 参数说明：单个DN内TCP代理通信库可使用内存池资源的容量大小。 参数类型：整型 参数单位：kB 取值范围：102400 ~ 1073741823 默认值：2048000（即2000MB） 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值102400，表示comm_memory_pool为102400kB；带单位取值100MB，表示comm_memory_pool为100MB。取值如果要带单位，必须为kB、MB、GB。 设置建议：推荐使用默认值。此参数需根据实际业务情况做调整，若通信库使用内存小，可设置该参数数值较小，反之设置数值较大。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

comm_memory_pool_percent 参数说明：单个DN内TCP代理通信库可使用内存池资源的百分比，用于自适应负载预留通信库通信消耗的内存大小。 参数类型：整型 参数单位：无 取值范围：0 ~ 100 默认值：0 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值。此参数需根据实际业务情况做调整，若通信库使用内存小，可设置该参数数值较小，反之设置数值较大。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

comm_debug_mode 参数说明：TCP代理通信库debug模式开关，该参数设置是否打印通信层详细日志。 参数类型：布尔型 参数单位：无 取值范围： on：表示打印通信库详细debug日志。 off：表示不打印通信库详细debug日志。 默认值：off 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：设置为on时，打印日志量较大，会增加额外的overhead并降低数据库性能，建议仅在调试时打开。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

comm_ackchk_time 参数说明：无数据包接收情况下，该参数设置通信库服务端主动ACK触发时长。 参数类型：整型 参数单位：ms 取值范围：0 ~ 20000。取值为0表示关闭此功能。 默认值：2000 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值60，表示comm_ackchk_time为60ms；带单位取值1min，表示comm_ackchk_time为1min。取值如果要带单位，必须为ms、s、min、h、d。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

comm_max_stream 参数说明：TCP代理通信库支持的最大并发数据流数。该参数必须大于业务并发数*每并发平均stream算子数*query_dop的平方。 参数类型：整型 参数单位：无 取值范围：1 ~ 60000 默认值：1024 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议： 不建议该参数值设置过大，因为comm_max_stream会占用内存（占用内存=256byte*comm_max_stream*comm_max_datanode），若并发数据流过大，查询较为复杂及smp过大都会导致内存不足。 如果comm_max_stream参数值较小，进程内存充足，可以适当将comm_max_stream值调大。 设置不当的风险与影响：参数设置过小会限制大并发分布式stream查询；设置过大可能会占用过多内存。

comm_quota_size 参数说明：TCP代理通信库最大可连续发送包总大小。 参数类型：整型 参数单位：kB 取值范围：0 ~ 2048000 默认值：1024 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值1024，表示comm_quota_size为1024kB；带单位取值1MB，表示comm_quota_size为1MB。取值如果要带单位，必须为kB、MB、GB。 设置建议：推荐使用默认值。使用1GE网卡时，建议取较小值，推荐设置为20kB~40kB。 设置不当的风险与影响：设置过小可能会导致TCP通信库收发阶段等待quota。

comm_sctp_port 参数说明：TCP代理通信库使用的TCP协议侦听端口，负责侦听数据报文通道。 参数类型：整型 参数单位：无 取值范围：0 ~ 65535 默认值：25110（实际值为GUC参数port值+2，取决于用户配置） 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：不建议用户配置，集群安装时会自动下发相关配置。 设置不当的风险与影响：集群部署时会自动分配此端口号，请不要轻易修改此参数，如端口号配置不正确会导致数据库通信失败。

tcp_syn_retries 参数说明：在支持TCP_SYNCNT套接字选项的操作系统上，设置 GaussDB 连接其他内部节点时，建立连接三次握手阶段SYN包发送失败而重传的次数。 参数类型：整型 参数单位：无 取值范围：0-127，其中0表示跟随操作系统设置。 默认值：0 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：保持默认。 设置不当的风险与影响：该参数设置过小（大于0）时，网络波动情况下，会导致SYN重传次数较少，若重传时长少于网络恢复时长，会导致建连失败；该参数设置过大时，网络不通情况下，会导致SYN重传次数较多，重传时间较长，造成整体报错的时间变长。 如果操作系统不支持TCP_SYNCNT选项，这个参数的值将不生效，默认为0。 在通过Unix域套接字进行连接的操作系统上，这个参数将被忽略。

comm_control_port 参数说明：TCP代理通信库使用的TCP协议侦听端口。 参数类型：整型 参数单位：无 取值范围：0 ~ 65535 默认值：25111（实际值为GUC参数port值+3，取决于用户配置） 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：不建议用户配置，集群安装时会自动下发相关配置。 设置不当的风险与影响：集群部署时会自动分配此端口号，请不要轻易修改此参数，如端口号配置不正确会导致数据库通信失败。

comm_tcp_mode 参数说明：通信库使用TCP协议建立数据通道的切换开关，重启集群生效。 SCTP协议的连接不再提供支持，为了保持兼容，提供此参数的接口，但此参数会在设置过程中强制改为on。 参数类型：布尔型 参数单位：无 取值范围：CN设置为on表示使用TCP模式连接DN，DN设置为on表示DN间使用TCP代理通信。 默认值：on 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

tcp_keepalives_interval 参数说明：在支持TCP_KEEPINTVL套接字选项的操作系统上，设置重新传输之间等待响应的时间。 如果操作系统不支持TCP_KEEPINTVL选项，这个参数的值必须为0。 在通过UNIX域套接字进行的连接的操作系统上，这个参数将被忽略。 将该值设置为0时，将使用系统的值。 该参数在不同的会话之间不共享，也就是说不同的会话连接可能有不同的值。 查看该参数时查出来的是当前会话连接内的参数值，而不是GUC副本的值。 参数类型：整型 参数单位：s 取值范围：0 ~ 180 默认值：30 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值60，表示tcp_keepalives_interval为60s；带单位取值1min，表示tcp_keepalives_interval为1min。取值如果要带单位，必须为s、min、h、d。 设置建议：设置时请确认操作系统是否支持TCP_KEEPINTVL套接字选项。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

tcp_keepalives_count 参数说明：在支持TCP_KEEPCNT套接字选项的操作系统上，设置GaussDB服务端在断开与客户端连接之前可以等待的保持活跃信号个数。 如果操作系统不支持TCP_KEEPCNT选项，这个参数的值必须为0。 在通过Unix域套接字进行连接的操作系统上，这个参数将被忽略。 将该值设置为0时，将使用系统的值。 该参数在不同的会话之间不共享，也就是说不同的会话连接可能有不同的值。 查看该参数时查出来的是当前会话连接内的参数值，而不是GUC副本的值。 参数类型：整型 参数单位：无 取值范围：0 ~ 100，其中0表示GaussDB未收到客户端反馈的保持活跃信号则立即断开连接。 默认值：20 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：设置时请确认操作系统是否支持TCP_KEEPCNT套接字选项。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。