更新时间:2024-05-31 GMT+08:00
分享

通信库参数

本节介绍通信库相关的参数设置及取值范围等内容。

tcp_keepalives_idle

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

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

  • 如果操作系统不支持TCP_KEEPIDLE选项 ,这个参数的值必须为0。
  • 在通过UNIX域套接字进行的连接的操作系统上,这个参数将被忽略。
  • 将该值设置为0时,将使用系统的值。
  • 该参数在不同的会话之间不共享,也就是说不同的会话连接可能有不同的值。
  • 查看该参数时查出来的是当前会话连接内的参数值,而不是GUC副本的值。

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

默认值:60

tcp_keepalives_interval

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

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

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

默认值:30

  • 如果操作系统不支持TCP_KEEPINTVL选项,这个参数的值必须为0。
  • 在通过UNIX域套接字进行的连接的操作系统上,这个参数将被忽略。
  • 将该值设置为0时,将使用系统的值。
  • 该参数在不同的会话之间不共享,也就是说不同的会话连接可能有不同的值。
  • 查看该参数时查出来的是当前会话连接内的参数值,而不是GUC副本的值。

tcp_keepalives_count

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

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

  • 如果操作系统不支持TCP_KEEPCNT选项,这个参数的值必须为0。
  • 在通过UNIX域套接字进行连接的操作系统上,这个参数将被忽略。
  • 将该值设置为0时,将使用系统的值。
  • 该参数在不同的会话之间不共享,也就是说不同的会话连接可能有不同的值。
  • 查看该参数时查出来的是当前会话连接内的参数值,而不是GUC副本的值。

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

默认值:20

tcp_user_timeout

参数说明:在支持TCP_USER_TIMEOUT套接字选项的操作系统上,设置GaussDB在发送数据时,指定传输的数据在TCP连接被强制关闭之前可以保持未确认状态的最大时长。

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

  • 如果操作系统不支持TCP_USER_TIMEOUT选项,这个参数的值将不生效,默认为0。
  • 在通过UNIX域套接字进行连接的操作系统上,这个参数将被忽略。

取值范围:0-3600000,单位为ms。其中0表示跟随操作系统设置。

默认值:0

注意,不同操作系统内核下,这个参数生效结果将不同:

  • aarch64 EulerOS(Linux内核版本:4.19),超时时间即为该参数设置值。
  • x86 Euler2.5(Linux内核版本:3.10),超时时间不是该参数设置值,而是不同区间的最大值,即超时时间取值为:tcp_user_timeout设置值所处“Linux TCP重传总耗时”区间的上限最大值。例如:tcp_user_timeout=40000时,重传总耗时为51秒。
    表1 x86 Euler2.5(Linux内核版本:3.10)tcp_user_timeout参数取值示意

    Linux TCP重传次数

    Linux TCP重传总耗时区间(秒)

    tcp_user_timeout设置举例(毫秒)

    实际Linux TCP重传总耗时(秒)

    1

    (0.2,0.6]

    400

    0.6

    2

    (0.6,1.4]

    1000

    1.4

    3

    (1.4,3]

    2000

    3

    4

    (3,6.2]

    4000

    6.2

    5

    (6.2,12.6]

    10000

    12.6

    6

    (12.6,25.4]

    20000

    25.4

    7

    (25.4,51]

    40000

    51

    8

    (51,102.2]

    80000

    102.2

    9

    (102.2,204.6]

    150000

    204.6

    10

    (204.6,324.6]

    260000

    324.6

    11

    (324.6,444.6]

    400000

    444.6

    注:TCP每次重传耗时随重传次数指数增加,当TCP一次重传到达120秒后,后续每次重传都将耗时120秒不再变化。

comm_proxy_attr

参数说明:通信代理库相关参数配置。

  • 该参数仅支持欧拉2.9系统下的集中式ARM单机。
  • 本功能在线程池开启状态下生效,即enable_thread_pool为on。
  • 配置该参数时需同步配置GUC参数local_bind_address为libos_kni的网卡IP。
  • 参数模板:comm_proxy_attr = '{enable_libnet:true, enable_dfx:false, numa_num:4, numa_bind:[[30,31],[62,63],[94,95],[126,127]]}'
  • 可配置参数说明。
    • enable_libnet:是否开启用户态协议,取值范围:true、false。
    • enable_dfx:是否开启通信代理库视图,取值范围:true、false。
    • numa_num:机器环境中numa的数量,支持2P、4P服务器,取值范围:4、8。
    • numa_bind:代理线程绑核参数,每个numa两个CPU绑核,共numa_num组,取值范围:[0,cpu数-1]。

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

取值范围:字符串,长度大于0。

默认值:'none'

umdk_enabled

参数说明:控制当前数据库主备DN是否开启UMDK功能。若DN主备间通信使用UMDK通信协议,则DN上相关日志关键字为“umdk”,若DN主备间通信使用TCP协议,则记录log日志。目前仅部分场景支持该功能。

参数类型:布尔型

参数单位:

取值范围:

  • on:开启UMDK功能,若当前数据库实例不支持UMDK网络通信协议,则DN主备间通信走TCP协议;若当前数据库实例支持UMDK网络通信协议,DN主备间通信走UMDK协议。
  • off:不开启UMDK功能,DN主备间通信走TCP协议。

默认值:off

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

设置建议:根据具体使用场景进行设置。

  • GaussDB数据库适配UMDK通信协议栈,UMDK能力由操作系统负责提供和维护。
  • GaussDB数据库侧默认关闭该参数umdk_enabled。参数打开后,GaussDB数据库能否支持该能力取决于操作系统是否被提供且支持UMDK功能。
  • UMDK能力依赖硬件网卡和软件OS配置,例如:硬件网卡:1823V200网卡,OS:HCE2.0。
  • 检测环境是否具备UMDK能力的操作方法为:root用户执行lsmod | grep ums语句查看操作系统是否加载了UMS模块。

    若通过该操作方法发现当前环境不支持UMDK(UMS模块)或者UMS模块故障,则开启umdk_enabled会导致主备建连失败。需要保证环境具备UMDK能力后再开启umdk_enabled。

umdk_port

参数说明:DN主备间通信使用UMDK协议时,主备DN网络通信链路的侦听端口。

参数类型:整型

参数单位:

取值范围:1 ~ 65535

默认值:dataPortBase+15,dataPortBase的值为数据库初次安装时GUC参数port的取值。

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

设置建议:推荐使用默认值。

  • GaussDB数据库适配UMDK通信协议栈,UMDK能力由操作系统提供和维护。
  • GaussDB数据库侧umdk_port默认不会侦听,需要在GUC参数umdk_enabled打开后,且当前环境硬件和软件支持UMDK协议时,数据库UMDK协议的功能才会开启,相关端口才会被侦听,DN主备开始执行UMS网络协议(UMS为UMDK的网络协议族)。
分享:

    相关文档

    相关产品