文档中心

task_thd_num ​

参数名称 ​

task_thd_num

参数解释 ​

设置任务处理的初始线程数量，用于处理TCP接收任务和集群内部远程任务。

任务线程具备自动扩展机制。新执行任务放入待执行任务池管理，当任务积压不能快速执行时，系统判定为任务线程不足，系统自动按每调度组扩展2个线程，提升并发处理能力。

默认值 ​

16

取值范围 ​

[4,10000]

访问权限 ​

R/W

是否全局参数 ​

是

修改生效方式 ​

task_thd_num不支持在数据库中执行SET命令修改，只能通过修改xugu.ini文件，重启系统后生效。

操作步骤 ​

  1. 在数据库中执行以下命令中止数据库服务，退出控制台工具。
    SQL> SHUTDOWN
  2. 修改SETUP文件夹下xugu.ini文件中的task_thd_num参数，根据实际需求在取值范围内选择合适的参数值，保存并退出。
  3. 重新启动数据库服务。
  4. 在数据库中执行以下命令查看当前参数值。
    SQL> SHOW task_thd_num

注意事项 ​

初始线程数设定 ​

任务线程不足时，任务请求在任务池中等待被执行，表现为任务响应延迟变长，线程扩展足够后延迟变长消除，但任务线程过多则引入不必要资源开销，所以需要考虑设置适当的任务线程数，建议配置为task_thd_num = 业务最大并发数 * 2。

最大线程数计算 ​

最大线程计算方式为最大线程数 = (tcp_thd_num + msg_port_num) * 256。

其中单机环境：msg_port_num=1，故最大线程数 = (tcp_thd_num + 1) * 256。

动态范围限制 ​

最小可配置线程数为16，当task_thd_num < 16或者task_thd_num > 10000时报错。

当最大可配置线程数 < task_thd_num ≤ 10000时，系统会自动将其调整为最大可配置线程数。

线程收缩 ​

扩展后的线程不会自动回收，长期运行可能导致资源浪费。建议定期评估负载，手动调整task_thd_num适配实际需求。