通信库参数

    参数说明:在支持TCP_KEEPIDLE套接字选项的系统上,设置发送活跃信号的间隔秒数。不设置发送保持活跃信号,连接就会处于闲置状态。

    该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。

    取值范围:0-3600,单位为s。

    默认值:60

    tcp_keepalives_interval

    参数说明:在支持TCP_KEEPINTVL套接字选项的操作系统上,以秒数声明在重新传输之间等待响应的时间。

    该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。

    取值范围:0-180,单位为s。

    默认值:30

    须知:
    - 如果操作系统不支持TCP_KEEPINTVL选项,这个参数的值必须为0。
    - 在通过Unix域套接字进行的连接的操作系统上,这个参数将被忽略。

    tcp_keepalives_count

    参数说明:在支持TCP_KEEPCNT套接字选项的操作系统上,设置openGauss服务端在断开与客户端连接之前可以等待的保持活跃信号个数。

    该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。

    通信库参数 - 图3 须知:
    - 如果操作系统不支持TCP_KEEPCNT选项,这个参数的值必须为0。
    - 在通过Unix域套接字进行连接的操作系统上,这个参数将被忽略。

    取值范围:0-100,其中0表示openGauss未收到客户端反馈的保持活跃信号则立即断开连接。

    默认值:20

    tcp_recv_timeout

    参数说明:在支持SO_RCVTIMEO套接字选项的操作系统上,设置openGauss服务端在接收数据上的超时时间。

    该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。

    须知:
    - 如果操作系统不支持SO_RCVTIMEO选项,这个参数的值必须为0。
    - 在通过Unix域套接字进行连接的操作系统上,这个参数将被忽略。

    取值范围:0-86400,单位为s,其中0表示永不超时。

    默认值:0

    comm_tcp_mode

    参数说明:通信库使用TCP或SCTP协议建立数据通道的切换开关,重启openGauss生效。

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

    取值范围:布尔型,设置为on表示使用TCP模式连接数据库节点。

    默认值:on

    参数说明:TCP代理通信库或SCTP通信库使用的TCP或SCTP协议监听端口,负责监听数据报文通道。

    通信库参数 - 图6 须知:
    openGauss部署时会自动分配此端口号,请不要轻易修改此参数,如端口号配置不正确会导致数据库通信失败。

    取值范围:整型,最小值为0,最大值为65535。

    默认值:7000

    comm_control_port

    参数说明:TCP代理通信库或SCTP通信库使用的TCP协议监听端口。

    该参数属于INTERNAL类型参数,为固定参数,用户无法修改此参数,只能查看。

    须知:
    openGauss部署时会自动分配此端口号,请不要轻易修改此参数,如端口号配置不正确会导致数据库通信失败。

    取值范围:整型,最小值为0,最大值为65535。

    默认值:7001

    comm_max_receiver

    参数说明:TCP代理通信库或SCTP通信库内部接收线程数量。

    该参数属于POSTMASTER类型参数,请参考中对应设置方法进行设置。

    取值范围:整型,最小值为1,最大值为50。

    默认值:4

    comm_quota_size

    参数说明:TCP代理通信库或SCTP通信库最大可连续发送包总大小。使用1GE网卡时,建议取较小值,推荐设置为20KB~40KB。

    该参数属于POSTMASTER类型参数,请参考中对应设置方法进行设置。

    取值范围:整型,最小值为0,最大值为2048000,默认单位为KB。

    默认值:1MB

    comm_usable_memory

    参数说明:单个数据库节点内TCP代理通信库或SCTP通信库缓存最大可使用内存。

    通信库参数 - 图8 须知:
    此参数需根据环境内存及部署方式具体配置,过大会造成OOM,过小会降低TCP代理通信库或SCTP通信库性能。

    该参数属于POSTMASTER类型参数,请参考中对应设置方法进行设置。

    取值范围:整型,最小值为100*1024,最大值为INT_MAX/2,默认单位为KB。

    默认值:4000MB

    参数说明:单个数据库节点内TCP代理通信库或SCTP通信库可使用内存池资源的容量大小。

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

    取值范围:整型,最小值为100*1024,最大值为INT_MAX/2,默认单位为KB。

    默认值:2000MB

    comm_memory_pool_percent

    须知:
    此参数需根据实际业务情况做调整,若通信库使用内存小,可设置该参数数值较小,反之设置数值较大。

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

    取值范围:整型,最小值为0,最大值为100。

    默认值:0

    comm_no_delay

    参数说明:是否使用通信库连接的NO_DELAY属性,重启openGauss生效。

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

    取值范围:布尔型

    通信库参数 - 图11 须知:
    如果openGauss出现因每秒接收数据包过多导致的丢包时,需设置为off,以便小包合并成大包发送,减少数据包总数。

    默认值:off

    comm_debug_mode

    参数说明:TCP代理通信库或SCTP通信库debug模式开关,该参数设置是否打印通信层详细日志。

    须知:
    设置为on时,打印日志量较大,会增加额外的overhead并降低数据库性能,仅在调试时打开。

    该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。

    取值范围:布尔型

    • on表示打印通信库详细debug日志。
    • off表示不打印通信库详细debug日志。

    默认值:off

    comm_ackchk_time

    参数说明:无数据包接收情况下,该参数设置通信库服务端主动ACK触发时长。

    该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。

    取值范围:整型,最小值为0,最大值为20000,单位为毫秒。取值为0表示关闭此功能。

    默认值:2000

    参数说明:TCP代理通信库或SCTP通信库timer模式开关,该参数设置是否打印通信层各阶段时间桩。

    该参数属于USERSET类型参数,请参考中对应设置方法进行设置。

    取值范围:布尔型

    • on表示打印通信库详细时间桩日志。
    • off表示不打印通信库详细时间桩日志。

    默认值:off

    comm_stat_mode

    参数说明:TCP代理通信库或SCTP通信库stat模式开关,该参数设置是否打印通信层的统计信息。

    通信库参数 - 图14 须知:
    设置为on时,打印日志量较大,会增加额外的overhead并降低数据库性能,仅在调试时打开。

    该参数属于USERSET类型参数,请参考中对应设置方法进行设置。

    • on表示打印通信库统计信息日志。
    • off表示不打印通信库统计信息日志。

    默认值:off