跳到主要内容

taosd 参考手册

taosd 是 TDengine 数据库引擎的核心服务，其配置文件默认是 /etc/taos/taos.cfg 但也可以指定不同路径的配置文件。本节详细介绍 taosd 的命令行参数及配置文件中的配置参数。

命令行参数​

taosd 命令行参数如下：

  • -a <json file>：指定一个 JSON 文件，其中包含服务启动时的各项配置参数，其格式形如 {"fqdn":"td1"}，关于配置参数的细节请参考下一节。
  • -c <directory>：指定配置文件所在目录
  • -s：打印 SDB 信息
  • -C：打印配置信息
  • -e：指定环境变量的字符串，例如 -e 'TAOS_FQDN=td1'。
  • -E：指定环境变量的文件路径，默认是 ./.env，.env 文件中的内容可以是 TAOS_FQDN=td1。
  • -o：指定日志输入方式，可选 stdout、stderr、/dev/null、<directory>、<directory>/<filename>、<filename>。
  • -r：启动修复模式。支持两种模式：--mode force（强制本地修复）和 --mode copy（从健康的源节点拷贝 vnode 数据）。
  • -k：获取机器码
  • -dm：启用内存调度
  • -V：打印版本信息

修复模式​

使用 taosd -r 可以进入修复模式。支持以下两种模式：

  • 强制模式（force）：对本地 vnode 进行原地修复，需要指定修复目标。
  • 拷贝模式（copy）：当损坏的数据量巨大、常规修复模式的性能无法满足要求时，从健康的源节点直接拷贝指定 vnode 的文件到目标节点。

强制模式语法​

taosd -r --mode force --node-type vnode [--backup-path <path>] \
  --repair-target <target> [--repair-target <target>]...

--repair-target 语法​

每个 --repair-target 的取值格式如下：

<file-type>:<key>=<value>[:<key>=<value>]...

规则如下：

  • <file-type> 必须放在第一个 segment。
  • 当前支持的 file type 为 meta、tsdb、wal。
  • key=value 的顺序不影响语义，但文档示例统一采用固定顺序。
  • 同一条 target 内，key 不允许重复。
  • 多条 target 如果命中同一个修复对象，会直接报错。
  • 对 tsdb 来说，fileid=* 表示命中该 vnode 下全部 fileset，且不能和同一 vnode 下的显式 fileid=<n> target 混用。

当前支持的 Target​

文件类型必填字段可选字段默认策略支持的策略
metavnodestrategyfrom_uidfrom_uid、from_redo
tsdbvnode、fileidstrategydrop_invalid_onlydrop_invalid_only、head_only_rebuild、full_rebuild
walvnode无无无

补充说明：

  • fileid 仅允许用于 tsdb，且当前阶段必须显式指定。使用 fileid=<n> 表示修复单个 fileset，使用 fileid=* 表示修复该 vnode 下全部 fileset。
  • 同一个 vnode 内，fileid=* 与显式 fileid=<n> target 互斥。
  • wal 当前阶段不支持 strategy。
  • --backup-path 是本次 repair 启动的全局参数，不属于某个特定 target。
  • TSDB repair 策略语义如下：
    • drop_invalid_only：仅在 deep scan 前删除明显的缺失文件场景；不会检查与 current.json 不一致的 size mismatch 损坏。
    • head_only_rebuild：对有效 core block 做 deep scan，只重建 .head；保留 .data，如果 .sma 元数据不可用则删除 .sma。
    • full_rebuild：对有效 core block 做 deep scan，并沿用现有 writer 路径重建完整 core 数据。
    • 如果需要处理 size mismatch 这类损坏，请显式使用 head_only_rebuild 或 full_rebuild。

强制模式限制​

  • 当前只支持 --node-type vnode。
  • taosd -r --mode force 如果缺少 --node-type 或 --repair-target，会直接报错。
  • --backup-path 和 --repair-target 不能与 --mode copy 一起使用。
  • 旧的修复参数 --file-type、--vnode-id、--replica-node 已经从这套接口中移除。

强制模式示例​

修复某个 vnode 的 meta，并使用默认策略：

taosd -r --mode force --node-type vnode \
  --repair-target meta:vnode=3

修复一个 TSDB file set，并显式指定策略：

taosd -r --mode force --node-type vnode \
  --repair-target tsdb:vnode=5:fileid=1809:strategy=head_only_rebuild

修复一个 TSDB file set，并强制执行完整 core 重建：

taosd -r --mode force --node-type vnode \
  --repair-target tsdb:vnode=5:fileid=1809:strategy=full_rebuild

用一条 target 修复一个 vnode 下全部 TSDB fileset：

taosd -r --mode force --node-type vnode \
  --repair-target 'tsdb:vnode=5:fileid=*'

一次启动同时声明多个修复目标：

taosd -r --mode force --node-type vnode --backup-path /tmp/repair-bak \
  --repair-target meta:vnode=3 \
  --repair-target tsdb:vnode=5:fileid=1809 \
  --repair-target wal:vnode=6

拷贝模式​

拷贝模式用于从健康的源节点直接拷贝指定 vnode 的文件到当前（目标）节点。适用于损坏的数据量巨大、常规修复模式的性能无法满足要求的场景。

拷贝模式语法​

taosd -r --mode copy --node-type vnode --source-cfg <path> \
  [--source-host <host>] --vnode <id>[,<id>|<id>-<id>]...

拷贝模式参数​

参数必填说明
--source-cfg是源节点 taos.cfg 配置文件的路径，也可以指定配置文件所在目录
--source-host否源节点的 SSH 主机地址；省略时表示源数据在本地
--vnode是要拷贝的 vnode ID 列表，多个 ID 用逗号分隔，支持用 - 指定范围（如 3,5-8,10）

拷贝模式限制​

  • 当前只支持 --node-type vnode。
  • Windows 平台暂不支持拷贝模式。
  • --backup-path 和 --repair-target 不能与 --mode copy 一起使用。
  • 远程模式需要 SSH 免密登录（BatchMode）。

拷贝模式示例​

从本地源节点拷贝单个 vnode：

taosd -r --mode copy --node-type vnode \
  --source-cfg /data/source-cluster/taos.cfg \
  --vnode 3

从本地源节点拷贝多个 vnode（指定配置目录）：

taosd -r --mode copy --node-type vnode \
  --source-cfg /etc/taos/ \
  --vnode 3,5,8

从远程源节点拷贝 vnode：

taosd -r --mode copy --node-type vnode \
  --source-cfg /etc/taos/taos.cfg \
  --source-host 192.168.1.100 \
  --vnode 3,5

配置参数​

配置参数按作用范围分为全局和局部两类：

参数类型说明作用范围修改方法查看参数命令
全局配置参数集群所有节点共同使用的参数集群整体1. 通过 SQL 修改。show variables;
局部配置参数每个集群节点本地单独配置的参数单节点1. 通过 SQL 修改；
2. 通过 taos.cfg 配置文件修改。		show dnode <dnode_id> variables;

补充说明：

  1. 通过 SQL 修改全局配置参数命令：alter all dnodes ‘参数名’ ‘参数值’;，修改后是否立即生效请参考各参数 动态修改 说明。
  2. 通过 SQL 修改局部配置参数命令，alter dnode <dnode_id> ‘参数名’ ‘参数值’;，修改后是否立即生效请参考各参数 动态修改 说明。
  3. 对于标注为「支持通过 SQL 修改，重启后生效」的参数，修改后 show variables / show local variables / show dnode <dnode_id> variables 会立即显示新值，但该值在进程内实际生效前仍需重启对应节点；可通过结果中的 reboot 列判断：true 表示已修改但尚待重启生效，false 表示无需重启（或从未被运行期修改过）。该标记随进程重启自动清除。
  4. 自 v3.4.0.0 起，为防止配置文件被篡改，取消了 forceReadConfig 参数；除首次启动外，不再从配置文件中加载配置项。如需修改配置参数，请使用 ALTER 命令通过 SQL 修改。
  5. 配置参数动态修改方法详见 节点管理。
  6. 有些参数在客户端（taosc）和服务器端（taosd）中都有，在不同地方其作用范围和意义有所不同，详见 配置参数作用范围对比。

连接相关​

firstEp​

  • 说明：taosd 启动时，主动连接的集群中首个 dnode 的 endpoint。
  • 类型：endpoint
  • 默认值：localhost:6030
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.0.0.0 引入

secondEp​

  • 说明：taosd 启动时，如果 firstEp 连接不上，尝试连接集群中第二个 dnode 的 endpoint。
  • 类型：endpoint
  • 默认值：无
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.0.0.0 引入

fqdn​

  • 说明：taosd 监听的服务地址
  • 类型：fqdn
  • 默认值：所在服务器上配置的第一个 hostname
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.0.0.0 引入

serverPort​

  • 说明：taosd 监听的端口
  • 类型：整数
  • 默认值：6030
  • 最小值：1
  • 最大值：65056
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.0.0.0 引入

compressMsgSize​

  • 说明：是否对 RPC 消息进行压缩
  • 类型：整数；-1：所有消息都不压缩；0：所有消息都压缩；N (N>0)：只有大于 N 个字节的消息才压缩。
  • 默认值：-1
  • 最小值：-1
  • 最大值：100000000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启后生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

rpcCrcEnable​

  • 说明：是否对 RPC 消息进行 CRC32C 校验
  • 类型：布尔值
  • 默认值：1（开启）
  • 参数类型：全局配置参数
  • 动态修改：支持（可通过 ALTER 修改），但需重启进程后生效。
  • 注意：需全集群（含所有客户端）保持一致；某端开启 CRC 时会拒绝对端关闭 CRC 的消息。
  • 支持版本：从 v3.4.2.4 版本开始引入

shellActivityTimer​

  • 说明：客户端向 mnode 发送心跳的时长
  • 类型：整数
  • 单位：秒
  • 默认值：3
  • 最小值：1
  • 最大值：120
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

numOfRpcSessions​

  • 说明：RPC 支持的最大连接数
  • 类型：整数
  • 默认值：30000
  • 最小值：1
  • 最大值：100000
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启后生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

numOfRpcThreads​

  • 说明：RPC 收发数据的线程数目
  • 类型：整数
  • 默认值：CPU 核数的一半（Linux 上限制为 [2, 100]，Windows 上限制为 [2, 4]）
  • 最小值：1
  • 最大值：1024
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启后生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

numOfTaskQueueThreads​

  • 说明：RPC 处理消息的线程数目
  • 类型：整数
  • 默认值：CPU 核数的两倍（不低于 16）
  • 最小值：4
  • 最大值：1024
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启后生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

rpcQueueMemoryAllowed​

  • 说明：dnode 已经收到并等待处理的 RPC 消息占用内存的最大值
  • 类型：整数
  • 单位：byte
  • 默认值：服务器内存的 1/10（不低于 1M 不超过 1G）
  • 最小值：104857600
  • 最大值：INT64_MAX
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

resolveFQDNRetryTime​

  • 说明：FQDN 解析失败时的重试次数
  • 类型：整数
  • 默认值：100
  • 最小值：1
  • 最大值：10240
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.3.4.0 之后取消

timeToGetAvailableConn​

  • 说明：获得可用连接的最长等待时间
  • 类型：整数
  • 单位：毫秒
  • 默认值：500000
  • 最小值：20
  • 最大值：1000000
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.3.4.0 之后取消

maxShellConns​

  • 说明：允许创建的最大连接数
  • 类型：整数
  • 默认值：50000
  • 最小值：10
  • 最大值：50000000
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.3.4.0 之后取消

maxRetryWaitTime​

  • 说明：重连最大超时时间，从重试时候开始计算。
  • 类型：整数
  • 单位：毫秒
  • 默认值：20000
  • 最小值：3000
  • 最大值：86400000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启后生效。
  • 支持版本：从 v3.3.4.0 版本开始引入

maxRetryTimes​

  • 说明：查询调度任务的基础重试次数。调度器将该值乘以固定系数 3，再根据任务类型，与根据 maxRetryWaitTime 换算的次数或候选节点数取较大值，作为任务的初始最大重试次数。该参数不是查询总超时时间。
  • 类型：整数
  • 单位：次
  • 默认值：12
  • 最小值：1
  • 最大值：1000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启后生效。

shareConnLimit​

  • 说明：一个链接可以共享的请求的数目
  • 类型：整数
  • 默认值：10 (Linux/macOS)，1 (Windows)
  • 最小值：1
  • 最大值：512
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启后生效。
  • 支持版本：从 v3.3.4.0 版本开始引入

readTimeout​

  • 说明：单个请求最小超时时间
  • 类型：整数
  • 单位：秒
  • 默认值：900
  • 最小值：64
  • 最大值：604800
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启后生效。
  • 支持版本：从 v3.3.4.0 版本开始引入

mqttPort​

  • 说明：MQTT 服务监听的端口
  • 类型：整数
  • 默认值：6057
  • 最小值：1
  • 最大值：65056
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：从 v3.3.6.23 版本开始引入

enableTLS​

  • 说明：是否启用 TLS 连接
  • 类型：整数；0：不启用；1：启用。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.8.4 版本开始引入

enableSasl​

  • 说明：是否启用 SASL 认证
  • 类型：整数；0：不启用；1：启用。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

rpcRecvLogThreshold​

  • 说明：RPC 接收日志阈值，超过该时间的 RPC 请求将记录日志
  • 类型：整数
  • 单位：秒
  • 默认值：3
  • 最小值：1
  • 最大值：1024 * 1024
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.8.4 版本开始引入

监控相关​

monitor​

  • 说明：是否收集监控数据并上报
  • 类型：整数；0：关闭；1：打开。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

monitorFqdn​

  • 说明：taosKeeper 服务所在服务器的地址
  • 类型：字符串
  • 默认值：空
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启后生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

monitorPort​

  • 说明：taosKeeper 服务所监听的端口号
  • 类型：整数
  • 默认值：6043
  • 最小值：1
  • 最大值：65056
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启后生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

monitorInterval​

  • 说明：监控数据库记录系统参数（CPU/内存）的时间间隔
  • 类型：整数
  • 单位：秒
  • 默认值：30
  • 最小值：1
  • 最大值：86400
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

monitorMaxLogs​

  • 说明：缓存的待上报日志条数
  • 类型：整数
  • 默认值：100
  • 最小值：1
  • 最大值：1000000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

monitorComp​

  • 说明：是否采用压缩方式上报监控日志
  • 类型：整数
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启后生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

monitorLogProtocol​

  • 说明：是否打印监控日志
  • 类型：整数
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.0.0 版本开始引入

monitorForceV2​

  • 说明：是否使用 V2 版本协议上报日志
  • 类型：整数
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.0.0 版本开始引入

telemetryReporting​

  • 说明：是否上传 telemetry
  • 类型：整数；0：关闭；1：打开
  • 默认值：0（企业版），1（社区版）
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

telemetryServer​

  • 说明：telemetry 服务器地址
  • 类型：fqdn
  • 默认值：telemetry.taosdata.com
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.0.0.0 引入

telemetryPort​

  • 说明：telemetry 服务器端口号
  • 类型：整数
  • 默认值：80
  • 最小值：1
  • 最大值：65056
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.0.0.0 引入

telemetryInterval​

  • 说明：telemetry 上传时间间隔
  • 类型：整数
  • 单位：秒
  • 默认值：86400
  • 最小值：1
  • 最大值：200000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

crashReporting​

  • 说明：是否使用 V2 版本协议上报日志
  • 类型：布尔值；0：不上传；1：上传
  • 默认值：0（企业版），1（社区版）
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

enableMetrics​

  • 说明：是否打开写入诊断工具，收集并上传写入指标
  • 类型：整数；0：不开启；1：开启。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.7.0.0 版本开始引入

metricsInterval​

  • 说明：写入诊断工具上传写入指标的间隔。
  • 类型：整数
  • 单位：秒
  • 默认值：30
  • 最小值：1
  • 最大值：3600
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.7.0.0 版本开始引入

metricsLevel​

  • 说明：写入诊断工具上传写入指标的级别。
  • 类型：整数；0:仅收集重要指标；1:收集全部指标。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.7.0.0 版本开始引入

查询相关​

countAlwaysReturnValue​

  • 说明：count/hyperloglog 函数在输入数据为空或者 NULL 的情况下是否返回值
  • 类型：整数；0：返回空行，1：如果查询中含有 INTERVAL 子句或者该查询使用了 TSMA，且相应的组或窗口内数据为空或者 NULL，对应的组或窗口将不返回查询结果。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

tagFilterCache​

  • 说明：是否缓存标签过滤结果
  • 类型：整数；0：不缓存，1：缓存。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持
  • 支持版本：v3.1.0.0 引入

stableTagFilterCache​

  • 说明：流式计算中，是否缓存标签等值条件的过滤结果，不会因为增删子表、更新标签值或修改超级表标签而失效
  • 类型：整数；0：不缓存，1：缓存。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持
  • 支持版本：v3.3.8.6 引入

metaEntryCache​

  • 说明：是否缓存元数据标签
  • 类型：整数；0：不缓存，1：缓存。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 动态修改：不支持
  • 支持版本：v3.3.6.35 引入

metaEntryCacheSize​

  • 说明：元数据标签缓存的大小
  • 类型：整数
  • 单位：byte
  • 默认值：131072
  • 最小值：4096
  • 最大值：4294967296
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：v3.3.6.35 引入

queryRspPolicy​

  • 说明：查询响应策略
  • 类型：整数；0：正常模式；1：快速响应模式，服务端收到查询消息后立即返回响应，而不是有查询结果后才响应。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

queryUseMemoryPool​

  • 说明：查询是否使用内存池管理内存
  • 类型：整数；0：关闭；1：打开 当内存池开关打开时，还需要满足如下条件才会启用内存池：1. 系统的可用内存总量不低于 5G；2. 扣除预留部分后系统的可用内存不低于4G。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：v3.3.5.0 引入

minReservedMemorySize​

  • 说明：内存池开启时，最小预留的系统可用内存数量，除预留外的内存都可以被用于查询。当设置为 0 时，系统会自动计算预留内存大小。
  • 类型：整数
  • 单位：MB
  • 默认值：0
  • 最小值：1024
  • 最大值：1000000000
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：v3.3.5.0 引入

singleQueryMaxMemorySize​

  • 说明：单个查询在单个节点 (dnode) 上可以使用的内存上限，超过该上限将返回错误信息。
  • 类型：整数；0：无上限。
  • 单位：MB
  • 默认值：0
  • 最小值：0
  • 最大值：1000000000
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.3.5.0 引入

filterScalarMode​

  • 说明：强制使用标量过滤模式
  • 类型：整数；0：关闭；1：开启。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：v3.1.0.0 引入

queryNoFetchTimeoutSec​

  • 说明：查询中当应用长时间不 FETCH 数据时的超时时间，从最后一次响应起计时，超时自动清除任务。内部参数
  • 类型：整数；0：关闭；1：开启。
  • 默认值：18000
  • 最小值：60
  • 最大值：1000000000
  • 参数类型：局部配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

queryPlannerTrace​

  • 说明：查询计划是否输出详细日志 内部参数
  • 类型：整数；0：关闭；1：开启。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

queryNodeChunkSize​

  • 说明：查询计划的块大小 内部参数
  • 类型：整数
  • 单位：byte
  • 默认值：32 * 1024
  • 最小值：1024
  • 最大值：128 * 1024
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

queryUseNodeAllocator​

  • 说明：查询计划的分配方法 内部参数
  • 类型：整数；0：关闭；1：开启。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

queryMaxConcurrentTables​

  • 说明：查询计划的分配方法 内部参数
  • 类型：整数
  • 默认值：200
  • 最小值：INT64_MIN
  • 最大值：INT64_MAX
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

queryRsmaTolerance​

  • 说明：查询计划的分配方法 内部参数
  • 类型：整数
  • 默认值：1000
  • 最小值：0
  • 最大值：900000
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

enableQueryHb​

  • 说明：是否发送查询心跳消息 内部参数
  • 类型：整数；0：关闭；1：开启。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

pqSortMemThreshold​

  • 说明：排序及去重聚合使用的内存阈值。当排序算子或 DISTINCT 聚合的哈希表内存超过此阈值时，自动切换为磁盘缓冲模式。内部参数
  • 类型：整数
  • 单位：MB
  • 默认值：16
  • 最小值：1
  • 最大值：10240
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

updateCacheBatch​

  • 说明：是否批量更新缓存
  • 类型：整数；0：不批量更新；1：批量更新。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：从 v3.3.4.11 版本开始引入

sessionControl​

  • 说明：是否启用会话控制功能
  • 类型：整数；0：不启用；1：启用。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启后生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

sessionPerUser​

  • 说明：每个用户允许的最大会话数，-1 表示不限制
  • 类型：整数
  • 默认值：-1
  • 最小值：-1
  • 最大值：INT32_MAX
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

sessionConnTime​

  • 说明：会话连接时长限制，单位为秒，-1 表示不限制
  • 类型：整数
  • 单位：秒
  • 默认值：-1
  • 最小值：-1
  • 最大值：INT32_MAX
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

sessionConnIdleTime​

  • 说明：会话空闲时长限制，单位为秒，-1 表示不限制
  • 类型：整数
  • 单位：秒
  • 默认值：-1
  • 最小值：-1
  • 最大值：INT32_MAX
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

sessionMaxConcurrency​

  • 说明：单个会话最大并发数，-1 表示不限制
  • 类型：整数
  • 默认值：-1
  • 最小值：-1
  • 最大值：INT32_MAX
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

sessionMaxCallVnodeNum​

  • 说明：单个会话最大调用 vnode 的次数，-1 表示不限制
  • 类型：整数
  • 默认值：-1
  • 最小值：-1
  • 最大值：INT32_MAX
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

timestampDeltaLimit​

  • 说明：服务器与客户端当前时间最大偏差，单位为秒，默认 900 秒（15 分钟）
  • 类型：整数
  • 单位：秒
  • 默认值：900
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：从 v3.4.0.0 版本之后取消

联邦查询相关​

以下参数用于控制服务端的联邦查询行为。客户端和服务端均支持的参数应保持一致，详细用法参见联邦查询。

federatedQueryEnable​

  • 说明：是否启用联邦查询功能；false 表示关闭，true 表示开启。
  • 类型：布尔
  • 默认值：false
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.2.0 版本开始引入

federatedQueryConnectTimeoutMs​

  • 说明：建立外部数据源连接的超时时间。
  • 类型：整数
  • 单位：毫秒
  • 默认值：5000
  • 最小值：100
  • 最大值：600000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.2.0 版本开始引入

federatedQueryQueryTimeoutMs​

  • 说明：执行外部查询的超时时间。
  • 类型：整数
  • 单位：毫秒
  • 默认值：1000000000，等于最大值时实际效果为不限时
  • 最小值：100
  • 最大值：1000000000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.2.0 版本开始引入

federatedQueryMaxPoolSizePerSource​

  • 说明：每个外部数据源允许的最大连接池大小。
  • 类型：整数
  • 默认值：64
  • 最小值：1
  • 最大值：1024
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.2.0 版本开始引入

federatedQueryIdleConnTtlSec​

  • 说明：空闲外部连接的存活时间，超过该时间后自动回收。
  • 类型：整数
  • 单位：秒
  • 默认值：600
  • 最小值：1
  • 最大值：86400
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.2.0 版本开始引入

federatedQueryProbeTimeoutMs​

  • 说明：外部数据源存活探测超时时间。该参数当前暂未实现。
  • 类型：整数
  • 单位：毫秒
  • 默认值：5000
  • 最小值：100
  • 最大值：600000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.2.0 版本开始引入

区域相关​

timezone​

  • 说明：时区
  • 默认值：从系统中动态获取当前的时区设置
  • 参数类型：全局配置参数
  • 动态修改：支持
  • 支持版本：v3.0.0.0 引入

locale​

  • 说明：系统区位信息及编码格式
  • 默认值：从系统中获取
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.0.0.0 引入

charset​

  • 说明：字符集编码
  • 默认值：从系统中获取
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.0.0.0 引入
信息

区域相关参数说明​

  1. 为应对多时区的数据写入和查询问题，TDengine 采用 Unix 时间戳 (Unix Timestamp) 来记录和存储时间戳。Unix 时间戳的特点决定了任一时刻不论在任何时区，产生的时间戳均一致。需要注意的是，Unix 时间戳是在客户端完成转换和记录。为了确保客户端其他形式的时间转换为正确的 Unix 时间戳，需要设置正确的时区。

在 Linux/macOS 中，客户端会自动读取系统设置的时区信息。用户也可以采用多种方式在配置文件设置时区。例如：

timezone UTC-8
timezone Asia/Shanghai

均是合法的设置东八区时区的格式。注意：timezone UTC-8 在 POSIX 符号约定下表示东八区（即北京时间），正负号与直觉相反；如不确定，推荐直接写 IANA 名称（如 Asia/Shanghai）。完整支持的时区格式及符号约定说明见支持的时区格式。

时区的设置对于查询和写入 SQL 语句中非 Unix 时间戳的内容（时间戳字符串、关键词 now 的解析）产生影响。例如：

SELECT count(*) FROM table_name WHERE TS<'2019-04-11 12:01:08';

在东八区，SQL 语句等效于：

SELECT count(*) FROM table_name WHERE TS<1554955268000;

在 UTC 时区，SQL 语句等效于：

SELECT count(*) FROM table_name WHERE TS<1554984068000;

为了避免使用字符串时间格式带来的不确定性，也可以直接使用 Unix 时间戳。此外，还可以在 SQL 语句中使用带有时区的时间戳字符串，例如：RFC3339 格式的时间戳字符串，2013-04-12T15:52:01.123+08:00 或者 ISO-8601 格式时间戳字符串 2013-04-12T15:52:01.123+0800。上述两个字符串转化为 Unix 时间戳不受系统所在时区的影响。

  1. TDengine 为存储中文、日文、韩文等非 ASCII 编码的宽字符，提供一种专门的字段类型 nchar。写入 nchar 字段的数据将统一采用 UCS4-LE 格式进行编码并发送到服务器。需要注意的是，编码正确性是客户端来保证。因此，如果用户想要正常使用 nchar 字段来存储诸如中文、日文、韩文等非 ASCII 字符，需要正确设置客户端的编码格式。

客户端的输入的字符均采用操作系统当前默认的编码格式，在 Linux/macOS 系统上多为 UTF-8，部分中文系统编码则可能是 GB18030 或 GBK 等。在 docker 环境中默认的编码是 POSIX。在中文版 Windows 系统中，编码则是 CP936。客户端需要确保正确设置自己所使用的字符集，即客户端运行的操作系统当前编码字符集，才能保证 nchar 中的数据正确转换为 UCS4-LE 编码格式。

在 Linux/macOS 中 locale 的命名规则为：<语言>_<地区>.<字符集编码> 如：zh_CN.UTF-8，zh 代表中文，CN 代表大陆地区，UTF-8 表示字符集。字符集编码为客户端正确解析本地字符串提供编码转换的说明。Linux/macOS 可以通过设置 locale 来确定系统的字符编码，由于 Windows 使用的 locale 中不是 POSIX 标准的 locale 格式，因此在 Windows 下需要采用另一个配置参数 charset 来指定字符编码。在 Linux/macOS 中也可以使用 charset 来指定字符编码。

  1. 如果配置文件中不设置 charset，在 Linux/macOS 中，taos 在启动时候，自动读取系统当前的 locale 信息，并从 locale 信息中解析提取 charset 编码格式。如果自动读取 locale 信息失败，则尝试读取 charset 配置，如果读取 charset 配置也失败，则中断启动过程。

在 Linux/macOS 中，locale 信息包含了字符编码信息，因此正确设置了 Linux/macOS 的 locale 以后可以不用再单独设置 charset。例如：

locale zh_CN.UTF-8

在 Windows 系统中，无法从 locale 获取系统当前编码。如果无法从配置文件中读取字符串编码信息，taos 默认设置为字符编码为 CP936。其等效在配置文件中添加如下配置：

charset CP936

如果需要调整字符编码，请查阅当前操作系统使用的编码，并在配置文件中正确设置。

在 Linux/macOS 中，如果用户同时设置了 locale 和字符集编码 charset，并且 locale 和 charset 的不一致，后设置的值将覆盖前面设置的值。

locale zh_CN.UTF-8
charset GBK

则 charset 的有效值是 GBK。

charset GBK
locale zh_CN.UTF-8

charset 的有效值是 UTF-8。

  1. 上述编码设置不仅用于写入，同样决定字符集敏感的查询转换。即使客户端与服务端 charset 不同，NCHAR 与字符串常量、VARCHAR 之间的比较、函数及 CAST 也会在服务端按客户端 charset 正确转换，因此客户端 charset 应与数据编码保持一致。

存储相关​

dataDir​

  • 说明：数据文件目录，所有的数据文件都将写入该目录。
  • 类型：字符串
  • 默认值：/var/lib/taos
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.0.0.0 引入

diskIDCheckEnabled​

  • 说明：在重启 dnode 时增加了检查 dataDir 所在磁盘 id 是否发生改变
  • 类型：整数；0:进行检查，1:不进行检查。
  • 参数类型：局部配置参数
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 支持版本：v3.3.5.0 引入

tempDir​

  • 说明：指定所有系统运行过程中的临时文件生成的目录
  • 类型：字符串
  • 默认值：/tmp
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

minimalDataDirGB​

  • 说明：dataDir 指定的时序数据存储目录所需要保留的最小空间
  • 类型：浮点数
  • 单位：GB
  • 默认值：2
  • 最小值：0.001f
  • 最大值：10000000
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

minimalTmpDirGB​

  • 说明：tempDir 所指定的临时文件目录所需要保留的最小空间
  • 类型：浮点数
  • 单位：GB
  • 默认值：1
  • 最小值：0.001f
  • 最大值：10000000
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

minDiskFreeSize​

  • 说明：当某块磁盘上的可用空间小于等于这个阈值时，该磁盘将不再被选择用于生成新的数据文件。企业版参数
  • 类型：整数
  • 单位：byte
  • 默认值：52428800 (50MB)
  • 最小值：52428800 (50MB)
  • 最大值：2199023255552 (2TB)
  • 参数类型：局部配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

ssAutoMigrateIntervalSec​

  • 说明：本地数据文件自动迁移共享存储的触发周期 企业版参数
  • 类型：整数
  • 单位：秒
  • 默认值：3600
  • 最小值：600
  • 最大值：100000
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.7.0 版本开始引入

ssEnabled​

  • 说明：是否启用共享存储 企业版参数
  • 类型：整数；0：禁用，1：仅启用手动迁移，2：启用自动迁移
  • 默认值：0
  • 最小值：0
  • 最大值：2
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.3.7.0 版本开始引入

ssAccessString​

  • 说明：共享存储访问参数字符串 企业版参数
  • 类型：字符串，格式为 <device-type>:<option-name>=<option-value>;<option-name>=<option-value>;...，具体取决于实际使用的存储设备，请参阅相关文档。
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.3.7.0 版本开始引入

ssPageCacheSize​

  • 说明：共享存储 page cache 缓存页数目 企业版参数
  • 类型：整数
  • 单位：页
  • 默认值：4096
  • 最小值：4
  • 最大值：1048576
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.3.7.0 版本开始引入

ssUploadDelaySec​

  • 说明：data 文件持续多长时间不再变动后上传至共享存储 企业版参数
  • 类型：整数
  • 单位：秒
  • 默认值：60
  • 最小值：1
  • 最大值：2592000
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.7.0 版本开始引入

缓存相关​

当 CACHEMODEL 不为 none 时，除内存中的 LRU 缓存外，每个 vnode 还会打开一个独立的 RocksDB 实例作为持久化 last cache 引擎，用于在内存缓存未命中或重启后继续服务 last/last_row 查询。以下参数用于调优该引擎的行为，均为 dnode 级参数。除 CACHESIZE（详见 CACHESIZE，用于设置该引擎的 block cache 容量，支持立即生效）外，以下参数在打开 vnode 时一次性绑定到 RocksDB 的 Options，修改后需重启 dnode（或重新打开受影响的 vnode）才能生效。可以通过 INS_LAST_CACHE_STATS 系统表查看该引擎按 vgroup 的运行状态。

sLastCacheWriteBufferSize​

  • 说明：last cache 引擎（基于 RocksDB）单个 memtable 的写缓冲区大小
  • 类型：整数
  • 单位：MB
  • 默认值：8
  • 最小值：1
  • 最大值：1048576
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.4.2.11 版本开始引入

sLastCacheMaxWriteBufferNumber​

  • 说明：last cache 引擎（基于 RocksDB）允许同时存在的最大 memtable 个数
  • 类型：整数
  • 默认值：2
  • 最小值：1
  • 最大值：64
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.4.2.11 版本开始引入

sLastCacheBackgroundThreads​

  • 说明：last cache 引擎（基于 RocksDB）用于 flush/compaction 的后台线程数，每个 vnode 拥有独立的该规格线程池
  • 类型：整数
  • 默认值：2
  • 最小值：1
  • 最大值：256
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.4.2.11 版本开始引入

sLastCacheBloomFilterBits​

  • 说明：last cache 引擎（基于 RocksDB）每个 key 使用的布隆过滤器位数，用于减少点查时不必要的 SST 文件读取；为 0 时表示关闭布隆过滤器
  • 类型：整数
  • 默认值：10
  • 最小值：0
  • 最大值：32
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.4.2.11 版本开始引入

sLastCacheMaxOpenFiles​

  • 说明：last cache 引擎（基于 RocksDB）允许打开的最大文件描述符数量，-1 表示不限制
  • 类型：整数
  • 默认值：-1
  • 最小值：-1
  • 最大值：1048576
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.4.2.11 版本开始引入

sLastCacheCompressionType​

  • 说明：last cache 引擎（基于 RocksDB）使用的压缩算法，可选值取决于编译时链接的压缩库
  • 类型：字符串
  • 默认值：none
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.4.2.11 版本开始引入

sLastCacheOptionsOverride​

  • 说明：以原始 RocksDB Options 字符串形式（形如 key1=value1;key2=value2;...，通过 RocksDB GetOptionsFromString 解析）覆盖以上参数，优先级最低，供高级场景使用；其中与某个显式 sLastCacheXxx 参数重叠的选项（如 write_buffer_size、max_write_buffer_number、max_background_jobs、filter_policy、max_open_files、compression、block_cache 等）会被该显式参数的取值覆盖而不生效，须改用对应的 sLastCacheXxx 参数设置。例如，若要调整这些显式参数未覆盖到的 L0 文件数写停滞阈值，可设置为 level0_slowdown_writes_trigger=32;level0_stop_writes_trigger=48
  • 类型：字符串
  • 默认值：（空）
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.4.2.11 版本开始引入

集群相关​

supportVnodes​

  • 说明：dnode 支持的最大 vnode 数目
  • 类型：整数
  • 默认值：CPU 核数的 2 倍 + 5
  • 最小值：0
  • 最大值：1024
  • 参数类型：局部配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

numOfCommitThreads​

  • 说明：落盘线程的最大数量
  • 类型：整数
  • 默认值：CPU 核数的一半（不低于 2 不超过 4）
  • 最小值：1
  • 最大值：1024
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

numOfCompactThreads​

  • 说明：合并线程的最大数量
  • 类型：整数
  • 默认值：2
  • 最小值：1
  • 最大值：16
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

numOfMnodeReadThreads​

  • 说明：mnode 的 Read 线程数目
  • 类型：整数
  • 默认值：CPU 核数的八分之一（不低于 1 不超过 4）
  • 最小值：1
  • 最大值：1024
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

numOfVnodeQueryThreads​

  • 说明：vnode 的 Query 线程数目
  • 类型：整数
  • 默认值：CPU 核数的两倍（不低于 16）
  • 最小值：1
  • 最大值：1024
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

numOfVnodeFetchThreads​

  • 说明：vnode 的 Fetch 线程数目
  • 类型：整数
  • 默认值：CPU 核数的四分之一（不低于 4）
  • 最小值：4
  • 最大值：1024
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.0.0.0 版本开始引入

numOfVnodeRsmaThreads​

  • 说明：vnode 的 Rsma 线程数目
  • 类型：整数
  • 默认值：CPU 核数的四分之一（不低于 4）
  • 最小值：1
  • 最大值：1024
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

numOfQnodeQueryThreads​

  • 说明：qnode 的 Query 线程数目
  • 类型：整数
  • 默认值：CPU 核数的两倍（不低于 16）
  • 最小值：1
  • 最大值：1024
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

ttlUnit​

  • 说明：ttl 参数的单位
  • 类型：整数
  • 单位：秒
  • 默认值：86400
  • 最小值：1
  • 最大值：31572500
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：v3.1.0.0 引入

ttlPushInterval​

  • 说明：ttl 检测超时频率
  • 类型：整数
  • 单位：秒
  • 默认值：10
  • 最小值：1
  • 最大值：100000
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

ttlChangeOnWrite​

  • 说明：ttl 到期时间是否伴随表的修改操作改变
  • 类型：整数；0：不改变，1：改变。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

ttlBatchDropNum​

  • 说明：ttl 一批删除子表的数目
  • 类型：整数
  • 默认值：10000
  • 最小值：0
  • 最大值：2147483647
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

retentionSpeedLimitMB​

  • 说明：数据在不同级别硬盘上迁移时的速度限制
  • 类型：整数；0：不限制
  • 单位：MB
  • 默认值：0
  • 最小值：0
  • 最大值：1024
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

compactSpeedLimitMB​

  • 说明：compact 写盘时的速度限制，避免 compact 占用过多磁盘 I/O 影响其他功能。此参数的作用域是 DNODE，即同一 DNODE 上的所有 VNODE 进行 COMPACT 时的写盘速度之和不能超过此限制。
  • 类型：整数；0：不限制
  • 单位：MB
  • 默认值：0
  • 最小值：0
  • 最大值：1024
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.2.10 版本开始引入

maxTsmaNum​

  • 说明：集群内可创建的 TSMA 个数
  • 类型：整数
  • 默认值：10
  • 最小值：0
  • 最大值：10
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

maxTsmaCalcDelay​

  • 说明：TSMA 最大计算延迟
  • 类型：整数
  • 单位：秒
  • 默认值：600
  • 最小值：600
  • 最大值：86400
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

tsmaDataDeleteMark​

  • 说明：TSMA 数据删除标记时间
  • 类型：整数
  • 单位：毫秒
  • 默认值：86400000 (1 天)
  • 最小值：3600000
  • 最大值：INT64_MAX
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

tmqWriteRefDB​

  • 说明：tmq_write_raw 接口写入 meta 消息时，虚拟表 ref 信息里的 db 替换为该参数，空标识不替换。
  • 类型：字符串
  • 默认值：空
  • 参数类型：客户端参数
  • 动态修改：不支持。
  • 支持版本：从 v3.4.1.0 版本开始引入

tmqWriteCheckRef​

  • 说明：tmq_write_raw 接口写入另一个集群时，是否校验虚拟表 ref 信息的有效性。
  • 类型：布尔值；false：不校验；true：校验。
  • 默认值：false
  • 参数类型：客户端参数
  • 动态修改：不支持。
  • 支持版本：从 v3.4.1.0 版本开始引入

tmqMaxTopicNum​

  • 说明：订阅最多可建立的 topic 数量
  • 类型：整数
  • 默认值：20
  • 最小值：1
  • 最大值：10000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

audit​

  • 说明：审计功能开关 企业版参数
  • 类型：整数；0:关闭，1：开启。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

auditInterval​

  • 说明：审计数据上报的时间间隔 企业版参数
  • 类型：整数
  • 默认值：5000
  • 最小值：500
  • 最大值：200000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

auditLevel​

  • 说明：审计数据上报的级别 企业版参数
  • 类型：整数; 0:不启用，1:系统级别，2:集群级别，3:数据库级别，4:子表级别，5:数据级别
  • 默认值：3
  • 最小值：0
  • 最大值：5
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

auditHttps​

  • 说明：审计数据上报时是否使用 https 企业版参数
  • 类型：整数; 0:不使用，1：使用
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

auditUseToken​

  • 说明：审计数据上报时是否使用 token 企业版参数
  • 类型：整数; 0:不使用，1：使用
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

auditCreateTable​

  • 说明：是否针对创建子表开启审计功能 企业版参数
  • 类型：整数；0:关闭，1：开启。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

auditSaveInSelf​

  • 说明：审计数据保存在自身，而不发送给 taoskeeper
  • 类型：整数；0:关闭，1：开启。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.1.0 版本开始引入

encryptAlgorithm​

  • 说明：数据加密算法 企业版参数
  • 类型：字符串
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.3.0.0 引入

encryptScope​

  • 说明：加密范围 企业版参数
  • 类型：字符串
  • 取值范围：以下范围的组合，多个范围用英文逗号分隔
    • tsdb：TSDB 数据文件
    • vnode_wal：vnode 的 WAL 文件
    • sdb：mnode 的 SDB 文件
    • mnode_wal：mnode 的 WAL 文件
    • query_spill：查询执行过程中因内存不足落盘的临时文件（v3.4.2.0 引入）
    • all：以上全部范围
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.3.0.0 引入

encryptExtDir​

  • 说明：用户自定义加密算法扩展的存放目录 企业版参数
  • 类型：字符串
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.4.0.0 引入

encryptPassAlgorithm​

  • 说明：加密存储用户密码功能开关。早期文档口径下设为 SM4（或 sm4）表示开启口令落盘加密。v3.4.0.0 起推荐以 taosk 生成并加载 DATA_KEY 作为口令摘要再加密的前提（见 静态数据保护 · 加密用户密码）；本参数与分级密钥主流程勿混用理解。
  • 类型：字符串
  • 取值范围：SM4(采用 SM4 算法加密)
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.7.0 版本开始引入

enableWhiteList​

  • 说明：白名单功能开关 企业版参数
  • 类型：整数；0:关闭，1：开启。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.0.0 版本开始引入

secureEraseMode​

  • 说明：安全删除物理覆写填充方式。仅当数据库开启 SECURE_DELETE 时生效。0 表示用零填充覆写；1 表示对整块可直接覆写的数据块使用随机字节填充。部分重叠块为保证就地写回，始终使用零填充。详见 数据安全 · 安全删除。
  • 类型：整数
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启后生效（CFG_DYN_SERVER_LAZY）。

authServer​

  • 说明：是否启用认证服务器 企业版参数
  • 类型：整数；0：不启用；1：启用。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

authReq​

  • 说明：是否启用认证请求 企业版参数
  • 类型：整数；0：不启用；1：启用。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

authReqInterval​

  • 说明：认证请求间隔 企业版参数
  • 类型：整数
  • 单位：秒
  • 默认值：2592000 (30 天)
  • 最小值：1
  • 最大值：2592000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

authReqUrl​

  • 说明：认证请求 URL 企业版参数
  • 类型：字符串
  • 默认值：空
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

syncLogBufferMemoryAllowed​

  • 说明：一个 dnode 允许的 sync 日志缓存消息占用的内存最大值
  • 类型：整数
  • 单位：bytes
  • 默认值：服务器内存的 1/10（不低于 1M 不超过 1G）
  • 最小值：104857600
  • 最大值：9223372036854775807
  • 参数类型：局部配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：v3.1.3.2/v3.3.2.13 版本开始生效

syncApplyQueueSize​

  • 说明：sync 日志 apply 队列的大小
  • 类型：整数
  • 默认值：512
  • 最小值：32
  • 最大值：2048
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：v3.3.6.20/v3.3.7.3 版本开始生效

syncNegotiationWin​

  • 说明：sync 协商窗口的大小，用于控制日志同步时的协商缓冲区，防止未完成 apply 的日志堆积过多
  • 类型：整数
  • 默认值：512
  • 最小值：128
  • 最大值：10240
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：v3.4.0.0 版本开始生效

statusIntervalMs​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：1000
  • 最小值：50
  • 最大值：30000
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：v3.3.6.23 引入

statusSRTimeoutMs​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：5000
  • 最小值：50
  • 最大值：30000
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：v3.3.6.23 引入

statusTimeoutMs​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：5000
  • 最小值：50
  • 最大值：30000
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：v3.3.6.23 引入

syncElectInterval​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：4000
  • 最小值：10
  • 最大值：172800000
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

syncHeartbeatInterval​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：1000
  • 最小值：10
  • 最大值：172800000
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

syncVnodeElectIntervalMs​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：4000
  • 最小值：10
  • 最大值：172800000
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：v3.3.6.23 引入

syncVnodeHeartbeatIntervalMs​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：1000
  • 最小值：10
  • 最大值：172800000
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：v3.3.6.23 引入

syncMnodeElectIntervalMs​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：3000
  • 最小值：10
  • 最大值：172800000
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：v3.3.6.23 引入

syncMnodeHeartbeatIntervalMs​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：500
  • 最小值：10
  • 最大值：172800000
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：v3.3.6.23 引入

syncHeartbeatTimeout​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：20000
  • 最小值：10
  • 最大值：172800000
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

syncSnapReplMaxWaitN​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：128
  • 最小值：16
  • 最大值：256
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

snapshotRateLimit​

  • 说明：控制每个 dnode 快照发送的总带宽上限。当多个 vgroup 同时进行快照复制时，可通过此参数限制快照发送速率，避免对 follower 节点产生 IO 瓶颈。设置为 0 表示不限速。
  • 类型：整数
  • 单位：MB/s
  • 默认值：0
  • 最小值：0
  • 最大值：10240
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.2.0 版本开始引入

示例：

-- 设置单个 dnode 快照限速为 50 MB/s
ALTER DNODE 1 'snapshotRateLimit' '50';

-- 设置所有 dnode 快照限速为 50 MB/s
ALTER ALL DNODES 'snapshotRateLimit' '50';

-- 取消限速
ALTER ALL DNODES 'snapshotRateLimit' '0';

snapshotMediumOnLag​

  • 说明：当某个副本（follower）节点长期停止后重新启动、自身已有数据但落后于同副本组其它节点时，控制快照同步使用的复制模式。设置为 0 时使用逐行（normal）方式同步；设置为 1 时使用文件级增量（medium）方式同步，只传输与 leader 存在差异的文件，可降低传输量、缩短同步时间。该参数只对已有提交数据（lastApplyIndex >= 0）的副本生效；无数据的新副本仍使用全量（raw）方式，FSM 处于 incomplete 状态的副本不受本参数影响，始终使用 medium 方式。
  • 类型：布尔
  • 默认值：0
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.3.0 版本开始引入

示例：

-- 打开落后副本的文件级增量快照同步
ALTER ALL DNODES 'snapshotMediumOnLag' '1';

-- 恢复为默认的逐行快照同步
ALTER ALL DNODES 'snapshotMediumOnLag' '0';

-- 查看当前取值
SHOW DNODE VARIABLES LIKE 'snapshotMediumOnLag';

arbHeartBeatIntervalSec​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：2
  • 最小值：1
  • 最大值：172800
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

arbCheckSyncIntervalSec​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：3
  • 最小值：1
  • 最大值：172800
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

arbSetAssignedTimeoutSec​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：14
  • 最小值：1
  • 最大值：172800
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

arbSetAssignedTimeoutMs​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：14000
  • 最小值：100
  • 最大值：172800000
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.6.23 版本开始引入

arbHeartBeatIntervalMs​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：2000
  • 最小值：100
  • 最大值：172800000
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.6.23 版本开始引入

arbCheckSyncIntervalMs​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：3000
  • 最小值：100
  • 最大值：172800000
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.6.23 版本开始引入

syncTimeout​

  • 说明：用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：0
  • 最小值：0
  • 最大值：172800000
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.6.23 版本开始引入

syncAssignedCheckAppliedGap​

  • 说明：双副本模式下，被指定为 assigned leader 的节点在 step down 前，检查对端 applied index 与 commit index 之间差距的阈值。仅当差距小于等于此值时才会 step down，避免对端因 applied index 尚未追上而进入 restoring 状态。设置为 0 表示不检查差距（保持旧行为，立即 step down）。用于同步模块调试 内部参数
  • 类型：整数
  • 默认值：20
  • 最小值：0
  • 最大值：10000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.1.0 版本开始引入

mndLogRetention​

  • 说明：用于 mnode 模块调试 内部参数
  • 类型：整数
  • 默认值：2000
  • 最小值：500
  • 最大值：10000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

skipGrant​

  • 说明：用于授权检查 内部参数
  • 类型：整数
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：v3.1.0.0 引入

trimVDbIntervalSec​

  • 说明：用于删除过期数据 内部参数
  • 类型：整数
  • 默认值：3600
  • 最小值：1
  • 最大值：100000
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

ttlFlushThreshold​

  • 说明：ttl 定时器的频率 内部参数
  • 类型：整数
  • 默认值：100
  • 最小值：-1
  • 最大值：1000000
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

compactPullupInterval​

  • 说明：数据重整定时器的频率 内部参数
  • 类型：整数
  • 默认值：10
  • 最小值：1
  • 最大值：10000
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

walFsyncDataSizeLimit​

  • 说明：WAL 进行 FSYNC 的阈值 内部参数
  • 类型：整数
  • 默认值：104857600
  • 最小值：104857600
  • 最大值：9223372036854775807
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

walForceRepair​

  • 说明：强制修复 wal 文件 内部参数
  • 类型：整数；0: 不修复，1：修复。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：从 v3.3.7.0 版本开始引入

walDeleteOnCorruption​

  • 说明：节点启动时将已经损坏的 WAL 目录备份并删除。单副本开启后，由于无法从其他节点同步，可能会丢失部分数据；三副本开启后，节点可从其他副本重新同步数据，通常不会造成数据丢失。
  • 类型：整数；0: 不删除，1：备份并删除。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.3.6.32 版本开始引入

walCorruptionBackupDir​

  • 说明：损坏的 WAL 文件在被删除前的备份目录；若为空，则在 WAL 路径下自动创建带时间戳的子目录作为备份目录。
  • 类型：字符串
  • 默认值：空字符串
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.3.6.50 版本开始引入

walMultiMountEnable​

  • 说明：是否允许 WAL 段文件（仅 0 级存储）在多个挂载点间轮询选择写入路径。开启后，新建 WAL 段文件会在 0 级存储配置的多个磁盘间选择写入路径；关闭后，新建段文件只写入 vnode 的主目录，但关闭前已经写入到非主盘上的历史段文件不受影响，仍可正常查找和读取。
  • 类型：整数；0: 关闭，1: 开启。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 动态修改：支持通过 SQL 修改，立即生效（仅影响后续新建的 WAL 段文件）。
  • 支持版本：从 v3.4.2.7,v3.3.6.58 版本开始引入

transPullupInterval​

  • 说明：mnode 执行事务的重试间 内部参数
  • 类型：整数
  • 默认值：2
  • 最小值：1
  • 最大值：10000
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

forceKillTrans​

  • 说明：用于 mnode 事务模块调试 内部参数
  • 类型：整数
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.7.0 版本开始引入

mqRebalanceInterval​

  • 说明：消费者再平衡的时间间隔 内部参数
  • 类型：整数
  • 默认值：2
  • 最小值：1
  • 最大值：10000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

uptimeInterval​

  • 说明：用于记录系统启动时间 内部参数
  • 类型：整数
  • 默认值：300
  • 最小值：1
  • 最大值：100000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

timeseriesThreshold​

  • 说明：用于统计用量 内部参数
  • 类型：整数
  • 默认值：50
  • 最小值：0
  • 最大值：2000
  • 参数类型：全局配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

udf​

  • 说明：是否启动 UDF 服务
  • 类型：整数；0：不启动，1：启动。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

disableStream​

  • 说明：是否禁用流式计算功能
  • 类型：整数；0：不禁用；1：禁用。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.3.6.18 版本开始引入

streamBatchRequestWaitMs​

  • 说明：流式计算批量请求等待时间
  • 类型：整数
  • 单位：毫秒
  • 默认值：5000
  • 最小值：0
  • 最大值：1800000
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.3.8.5 版本开始引入

udfdResFuncs​

  • 说明：UDF 服务常驻函数列表 内部参数
  • 类型：字符串
  • 默认值：空
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

udfdLdLibPath​

  • 说明：UDF 服务动态库加载路径 内部参数
  • 类型：字符串
  • 默认值：空
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

statusInterval​

  • 说明：控制 dnode 向 mnode 发送状态报告的间隔时间
  • 类型：整数；单位：秒
  • 默认值：1
  • 最小值：1
  • 最大值：30
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。

安全相关​

enableStrongPassword​

  • 说明：密码要符合一个要求：至少包含大写字母、小写字母、数字、特殊字符中的三类。特殊字符包括 ! @ # $ % ^ & * ( ) - _ + = [ ] { } : ; > < ? | ~ , .
  • 类型：整数；0：不启用，1：启用
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效
  • 支持版本：v3.3.6.0 引入

enableAdvancedSecurity​

  • 说明：是否默认启用高级安全功能，用于控制是否默认打开新创建用户的密码过期、密码轮换等安全策略等（但可通过创建用户时明确指定相关参数来改变默认行为）。
  • 类型：整数；0：不启用，1：启用
  • 默认值：因版本而异
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效
  • 支持版本：v3.4.0.10 引入

enableGrantLegacySyntax​

  • 说明：是否启用兼容 3.3.x.y 版本 grant/revoke 语法的功能；启用时（1），grant/revoke 授权语法在不指定权限对象时，会根据权限类型和 priv_level 自适应扩展为 database/table/view/index/tsma/rsma/topic/stream 对应的权限；禁用时（0），仅自适应扩展为 table/view 对应的权限。
  • 类型：整数；0：不启用，1：启用
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效
  • 支持版本：v3.4.0.11 引入

xnodeDsnProtection​

  • 说明：XNODE DSN 保护总开关 企业版参数；0：关闭，SHOW XNODE TASKS 和 SHOW XNODE JOBS 返回明文 DSN；1：开启，上述 SHOW 输出中的 DSN 敏感值以 ****** 脱敏返回。详见 安全加固指南 · XNODE DSN 保护
  • 类型：整数；0：关闭，1：开启
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.4.3.0 引入

xnodeDsnPublicKeyFile​

  • 说明：共享公钥文件（X.509 SubjectPublicKeyInfo PEM 格式，RSA-2048）的本地路径 企业版参数；仅在 xnodeDsnProtection 为 1 时由 mnode 加载和校验，用于加密 SHOW 输出的 DSN，保护开启时文件缺失、不可读或非法将导致 taosd 启动失败，保护关闭时不读取
  • 类型：字符串
  • 默认值：空
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.4.3.0 引入

xnodedDsnPrivateKeyFile​

  • 说明：共享私钥文件（PKCS#8 PEM 格式，RSA-2048）的本地路径 企业版参数；由 taosd 转交给其启动的 xnoded 子进程，taosd 只转交路径，不读取私钥内容
  • 类型：字符串
  • 默认值：空
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.4.3.0 引入

流计算参数​

流式计算的语法与运维说明见 流式计算。下列为与流式计算相关的 taosd 配置参数。

numOfMnodeStreamMgmtThreads​

  • 说明：mnode 流式计算管理线程个数
  • 类型：整数
  • 默认值：CPU 核数的四分之一（不低于 2 不超过 5）
  • 最小值：2
  • 最大值：5
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效
  • 支持版本：从 v3.3.7.0 版本开始引入

numOfStreamMgmtThreads​

  • 说明：snode 流式计算管理线程个数
  • 类型：整数
  • 默认值：CPU 核数的八分之一（不低于 2 不超过 5）
  • 最小值：2
  • 最大值：5
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效
  • 支持版本：从 v3.3.7.0 版本开始引入

numOfVnodeStreamReaderThreads​

  • 说明：vnode 流式计算读线程个数
  • 类型：整数
  • 默认值：CPU 核数的二分之一（不低于 2）
  • 最小值：2
  • 最大值：INT32_MAX
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效
  • 支持版本：从 v3.3.7.0 版本开始引入

numOfStreamTriggerThreads​

  • 说明：流式计算触发线程个数
  • 类型：整数
  • 默认值：CPU 核数（不低于 4）
  • 最小值：4
  • 最大值：INT32_MAX
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效
  • 支持版本：从 v3.3.7.0 版本开始引入

numOfStreamRunnerThreads​

  • 说明：流式计算执行线程个数
  • 类型：整数
  • 默认值：CPU 核数（不低于 4）
  • 最小值：4
  • 最大值：INT32_MAX
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效
  • 支持版本：从 v3.3.7.0 版本开始引入

streamBufferSize​

  • 说明：流式计算可以使用的最大缓存大小，只适用于 %%trows 的结果缓存
  • 类型：整数
  • 单位：MB
  • 默认值：系统物理内存的 30%
  • 最小值：128
  • 最大值：INT32_MAX
  • 参数类型：局部配置参数
  • 动态修改：支持
  • 支持版本：从 v3.3.7.0 版本开始引入

streamNotifyMessageSize​

  • 说明：用于控制事件通知的消息大小
  • 类型：整数
  • 单位：KB
  • 默认值：8192
  • 最小值：8
  • 最大值：1048576
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效
  • 支持版本：从 v3.3.7.0 版本开始引入

streamNotifyFrameSize​

  • 说明：用于控制事件通知消息发送时底层的帧大小，以及 async worker 同 stream 队列 pendingBytes 达阈值时的 flush 上限 内部参数
  • 类型：整数
  • 单位：KB
  • 默认值：256
  • 最小值：8
  • 最大值：104857
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效
  • 支持版本：从 v3.3.7.0 版本开始引入

streamNotifyWorkerNum​

  • 说明：异步事件通知 worker 线程个数（每个 snode）。各 worker 竞争全局 FIFO 队列列表（globalQueueList），从连接池按 URL 复用 WebSocket 长连接。
  • 类型：整数
  • 单位：个
  • 默认值：4（首次启动且未在配置文件中指定时，按 TRANGE(CPU 核数, 1, 8) 自动取值）
  • 最小值：1
  • 最大值：16
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效
  • 支持版本：从 v3.4.2.0 版本开始引入

streamNotifyBatchIntervalMs​

  • 说明：异步事件通知批处理的最大等待时间。高频写入时，同 stream 的多条通知在该时间窗口内合并为一条 JSON（events[] 合并）后发送；距上次发送已超过该间隔时，下一条通知立即发送。
  • 类型：整数
  • 单位：毫秒
  • 默认值：5
  • 最小值：0
  • 最大值：60000
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效
  • 支持版本：从 v3.4.2.0 版本开始引入

streamNotifyParamPoolSize​

  • 说明：异步事件通知 pending 项对象池的总容量上限（所有 stream 共享）。尚未发送的通知参数在该池中排队；池满时会回收其他 stream 队列上最老的 pending 项，或在同一 stream 上用新通知覆盖最老项，并输出 WARN 日志。对应内部变量 tsStreamNotifyParamPoolSize。
  • 类型：整数
  • 单位：KB
  • 默认值：10240（10 MB）
  • 最小值：1
  • 最大值：262144（256 MB）
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效
  • 支持版本：从 v3.4.2.0 版本开始引入

streamTriggerMaxPendingParams​

  • 说明：流式计算触发时允许积攒的待计算参数个数上限（按个数，不按字节），达到上限后暂停积攒新的计算参数，避免实时/历史计算请求积压占用过多内存
  • 类型：整数
  • 默认值：1048576
  • 最小值：1
  • 最大值：INT32_MAX
  • 参数类型：局部配置参数
  • 动态修改：支持
  • 支持版本：从 v3.4.3.0 版本开始引入

日志相关​

logDir​

  • 说明：日志文件目录，运行日志将写入该目录。
  • 类型：字符串
  • 默认值：/var/log/taos
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

minimalLogDirGB​

  • 说明：日志文件夹所在磁盘可用空间大小小于该值时，停止写日志。
  • 类型：浮点数
  • 单位：GB
  • 默认值：1
  • 最小值：0.001f
  • 最大值：10000000
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

numOfLogLines​

  • 说明：单个日志文件允许的最大行数
  • 类型：整数
  • 默认值：10,000,000
  • 最小值：1000
  • 最大值：2000000000
  • 参数类型：局部配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

asyncLog​

  • 说明：日志写入模式
  • 类型：整数；0：同步，1：异步。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

logKeepDays​

  • 说明：日志文件的最长保存时间
    • 等于 0 意味着只有两个日志文件相互切换保存日志，超过两个文件保存数量的日志会被删除；
    • 当设置为大于 0 的值时，当日志文件大小达到设置的上限时会被重命名为 taosdlog.yyy，其中 yyy 为日志文件最后修改的时间戳，并滚动产生新的日志文件，日志文件创建时间超过 logKeepDays 则删除。
    • 考虑到 2.0 版本的用户习惯，自 TDengine 3.3.6.6 版本开始，当设置为小于 0 的值时，除日志文件创建时间超过 -logKeepDays 删除外，其他行为与取值大于 0 时一致（3.0.0.0-3.3.6.5 之间的版本，不建议设置为小于 0 的值）。
  • 类型：整数；0
  • 单位：天
  • 默认值：0
  • 最小值：-365000
  • 最大值：365000
  • 参数类型：局部配置参数
  • 动态修改：仅在企业版支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

slowLogThreshold​

  • 说明：慢查询门限值，大于等于门限值认为是慢查询。
  • 类型：整数
  • 单位：秒
  • 默认值：10
  • 最小值：1
  • 最大值：2147483647
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.0.0 版本开始引入

slowLogMaxLen​

  • 说明：慢查询日志最大长度
  • 类型：整数
  • 默认值：4096
  • 最小值：1
  • 最大值：16384
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.0.0 版本开始引入

slowLogScope​

  • 说明：慢查询记录类型
  • 取值范围：ALL/QUERY/INSERT/OTHERS/NONE
  • 默认值：QUERY
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.0.0 版本开始引入

slowLogExceptDb​

  • 说明：指定的数据库不上报慢查询，仅支持配置一个数据库。
  • 默认值：空
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.0.0 版本开始引入

debugFlag​

  • 说明：运行日志开关，该参数的设置会影响到所有模块的开关。开启该参数的设置后，各模块的设置参数将失效。
  • 类型：整数
  • 取值范围：131（输出错误和警告日志），135（输出错误、警告和调试日志），143（输出错误、警告、调试和跟踪日志）。
  • 默认值：131 或 135（取决于不同模块）
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

tmrDebugFlag​

  • 说明：定时器模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

uDebugFlag​

  • 说明：共用功能模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

rpcDebugFlag​

  • 说明：rpc 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

qDebugFlag​

  • 说明：query 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

dDebugFlag​

  • 说明：dnode 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

vDebugFlag​

  • 说明：vnode 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

mDebugFlag​

  • 说明：mnode 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

azDebugFlag​

  • 说明：S3 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.4.3 版本开始引入

sDebugFlag​

  • 说明：sync 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

tsdbDebugFlag​

  • 说明：tsdb 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

tqDebugFlag​

  • 说明：tq 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

fsDebugFlag​

  • 说明：fs 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

udfDebugFlag​

  • 说明：udf 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

smaDebugFlag​

  • 说明：sma 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

idxDebugFlag​

  • 说明：index 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

tdbDebugFlag​

  • 说明：tdb 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

metaDebugFlag​

  • 说明：meta 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

stDebugFlag​

  • 说明：stream 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

sndDebugFlag​

  • 说明：snode 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

xndDebugFlag​

  • 说明：xnode 模块的日志开关
  • 类型：整数
  • 取值范围：同上
  • 默认值：131
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.1 版本开始引入

调试相关​

enableCoreFile​

  • 说明：crash 时是否生成 core 文件
  • 类型：整数；0：不生成，1：生成。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

configDir​

  • 说明：配置文件所在目录
  • 类型：字符串
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

forceReadConfig​

  • 说明：是否使用持久化的局部配置参数，改配置参数从 v3.4.0.0 废弃，v3.4.0.0 之后请通过 SQL 修改配置参数。
  • 类型：整数；0：使用持久化的局部配置参数，1：使用配置文件中的局部配置参数。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.3.5.0 引入，v3.4.0.0 废弃

scriptDir​

  • 说明：测试工具的脚本目录 内部参数
  • 类型：字符串
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

assert​

  • 说明：断言控制开关
  • 类型：整数；0：关闭，1：开启。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

randErrorChance​

  • 说明：用于随机失败测试 内部参数，特定编译选项时生效
  • 类型：整数
  • 默认值：1
  • 最小值：0
  • 最大值：10000
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

randErrorDivisor​

  • 说明：用于随机失败测试 内部参数，特定编译选项时生效
  • 类型：整数
  • 默认值：10001
  • 最小值：1
  • 最大值：INT64_MAX
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

randErrorScope​

  • 说明：用于随机失败测试 内部参数，特定编译选项时生效
  • 类型：整数
  • 默认值：4
  • 最小值：0
  • 最大值：INT64_MAX
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

safetyCheckLevel​

  • 说明：安全检查级别 内部参数
  • 类型：整数
  • 默认值：1
  • 最小值：0
  • 最大值：5
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

experimental​

  • 说明：用于一些实验特性 内部参数，特定编译选项时生效
  • 类型：整数
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

simdEnable​

  • 说明：用于测试 SIMD 加速 内部参数
  • 类型：整数
  • 默认值：1（不支持 AVX 时为 0）
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.3.4.3 引入

AVX512Enable​

  • 说明：用于测试 AVX512 加速 内部参数
  • 类型：整数
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.3.4.3 引入

rsyncPort​

  • 说明：用于调试流式计算 内部参数
  • 类型：整数
  • 默认值：873
  • 最小值：1
  • 最大值：65535
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入，v3.3.7.0 废弃

snodeAddress​

  • 说明：用于调试流式计算 内部参数
  • 类型：字符串
  • 默认值：空
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：v3.1.0.0 引入，v3.3.7.0 废弃

checkpointBackupDir​

  • 说明：用于恢复 snode 数据 内部参数
  • 类型：字符串
  • 默认值："/var/lib/taos/backup/checkpoint/" (Linux) 或 "C:\TDengine\data\backup\checkpoint" (Windows)
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：v3.1.0.0 引入，v3.3.7.0 废弃

enableAuditDelete​

  • 说明：用于测试审计功能 内部参数
  • 类型：整数
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

enableAuditSelect​

  • 说明：用于测试审计功能 内部参数
  • 类型：整数
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.3.9.0 引入

enableAuditInsert​

  • 说明：用于测试审计功能 内部参数
  • 类型：整数
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：v3.3.9.0 引入

slowLogThresholdTest​

  • 说明：用于测试慢日志 内部参数
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：v3.1.0.0 引入

bypassFlag​

  • 说明：内部参数，用于短路测试，仅用于写入性能问题的定位调试。其原理是让写入请求在链路的指定阶段提前"短路"返回，从而逐段排查写入瓶颈所在的环节。请勿在生产环境使用。
  • 类型：整数
  • 取值范围：
    • 0：正常写入
    • 1：写入消息在 taos 客户端发送 RPC 消息前返回
    • 2：写入消息在 taosd 服务端收到 RPC 消息后返回
    • 4：写入消息在 taosd 服务端写入内存缓存前返回
    • 8：写入消息在 taosd 服务端数据落盘前返回
  • 默认值：0
  • 最小值：0
  • 最大值：INT32_MAX
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.3.4.5 版本开始引入
注意

该参数一旦设置为非 0 值，写入请求会在真正持久化之前提前返回 成功，被跳过阶段的数据将被静默丢弃且不可恢复，客户端却无法感知。因此它 仅供研发或技术支持在测试环境定位写入性能问题时临时使用，切勿在生产环境或任何需要保留数据的场景开启。定位结束后，请务必将其恢复为 0。

CPU 亲和性​

enableCpuAffinity​

  • 说明：CPU 亲和性绑定的主开关。启用（1）时，taosd 线程将按类别（管理、写入、读取）绑定到指定的 CPU 核心。禁用（0，默认值）时，所有线程在所有可用核心上自由运行。CPU 核心不足 3 个的系统将自动禁用亲和性并输出警告日志。
  • 类型：整数；0：禁用，1：启用
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：从 v3.3.6.0 版本开始引入

managementCpuCores​

  • 说明：分配给管理线程（集群协调、网络、系统级任务）的 CPU 核心数量。核心从 core 0 开始顺序分配。仅在 enableCpuAffinity 为 1 时生效。
  • 类型：整数
  • 默认值：1
  • 最小值：1
  • 最大值：256
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：从 v3.3.6.0 版本开始引入

readCpuCores​

  • 说明：分配给读取（查询）线程的 CPU 核心数量。核心在管理线程和写入线程之后顺序分配。仅在 enableCpuAffinity 为 1 时生效。managementCpuCores + readCpuCores + otherCpuCores 之和不得超过系统总 CPU 核心数。
  • 类型：整数
  • 默认值：动态计算，为剩余核心的一半 (totalCores - managementCpuCores) / 2
  • 最小值：1
  • 最大值：256
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：从 v3.3.6.0 版本开始引入

otherCpuCores​

  • 说明：分配给写入线程的 CPU 核心数量。核心在管理线程之后顺序分配。仅在 enableCpuAffinity 为 1 时生效。managementCpuCores + readCpuCores + otherCpuCores 之和不得超过系统总 CPU 核心数。
  • 类型：整数
  • 默认值：动态计算，为剩余核心的另一半
  • 最小值：1
  • 最大值：256
  • 参数类型：局部配置参数
  • 动态修改：不支持
  • 支持版本：从 v3.3.6.0 版本开始引入

压缩参数​

fPrecision​

  • 说明：设置 float 类型浮点数压缩精度，小于此值的浮点数尾数部分将被截断。
  • 类型：浮点数
  • 默认值：0.00000001
  • 最小值：0.0f
  • 最大值：100000.0f
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

dPrecision​

  • 说明：设置 double 类型浮点数压缩精度，小于此值的浮点数尾数部分将被截取。
  • 类型：浮点数
  • 默认值：0.0000000000000001
  • 最小值：0.0f
  • 最大值：1000000.0f
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.1.0.0 版本开始引入

lossyColumn​

  • 说明：对 float 和/或 double 类型启用 TSZ 有损压缩
  • 取值范围：float/double/none
  • 默认值：none，表示关闭无损压缩
  • 参数类型：全局配置参数
  • 动态修改：不支持
  • 支持版本：从 v3.1.0.0 版本引入，v3.3.0.0 以后废弃。

ifAdtFse​

  • 说明：在启用 TSZ 有损压缩时，使用 FSE 算法替换 HUFFMAN 算法，FSE 算法压缩速度更快，但解压稍慢，追求压缩速度可选用此算法。
  • 类型：整数：0：关闭，1：打开。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.1.0.0 版本引入，v3.3.0.0 以后废弃。

enableIpv6​

  • 说明：用于节点直接通过 ipv6 通信，firstep/second/fqdn 都要能解析为 ipv6，且不支持同一集群 ipv4 和 ipv6 混合部署
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：不支持动态修改
  • 支持版本：从 v3.3.7.0 版本引入

maxRange​

  • 说明：用于有损压缩设置 内部参数
  • 类型：整数
  • 默认值：500
  • 最小值：0
  • 最大值：65536
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.1.0.0 版本引入，v3.3.0.0 以后废弃。

curRange​

  • 说明：用于有损压缩设置 内部参数
  • 类型：整数
  • 默认值：100
  • 最小值：0
  • 最大值：65536
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.1.0.0 版本引入，v3.3.0.0 以后废弃。

compressor​

  • 说明：用于有损压缩设置 内部参数
  • 类型：字符串
  • 默认值：ZSTD_COMPRESSOR
  • 参数类型：全局配置参数
  • 动态修改：支持通过 SQL 修改，重启生效。
  • 支持版本：从 v3.1.0.0 版本引入，v3.3.0.0 以后废弃。

compareAsStrInGreatest​

  • 说明：在 GREATEST 函数中是否将值作为字符串比较
  • 类型：整数；0：按数值类型比较；1：按字符串比较。
  • 默认值：1
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

ignoreNullInGreatest​

  • 说明：GREATEST、LEAST 函数是否跳过 NULL 参数
  • 类型：整数；0：与 MySQL 一致，任一参数为 NULL 则返回 NULL；1：跳过 NULL 参数，仅在非 NULL 值之间比较，所有参数均为 NULL 时仍返回 NULL。与 compareAsStrInGreatest 正交。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.2.0 版本开始引入

showFullCreateTableColumn​

  • 说明：SHOW CREATE TABLE 是否显示完整的列信息
  • 类型：整数；0：不显示列属性 ENCODE/COMPRESS/LEVEL 信息；1：显示完整创建语句。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

multiResultFunctionStarReturnTags​

  • 说明：多结果函数在使用 * 时是否返回标签列
  • 类型：整数；0：不返回；1：返回。
  • 默认值：0
  • 最小值：0
  • 最大值：1
  • 参数类型：局部配置参数
  • 动态修改：支持通过 SQL 修改，立即生效。
  • 支持版本：从 v3.4.0.0 版本开始引入

taosd 监控指标​

taosd 会将监控指标上报给 taosKeeper，这些监控指标会被 taosKeeper 写入监控数据库，默认是 log 库，可以在 taoskeeper 配置文件中修改。

以下是这些监控指标的详细介绍：

taosd_cluster_basic 表​

taosd_cluster_basic 表记录集群基础信息。

fieldtypeis_tagcomment
tsTIMESTAMPtimestamp
first_epVARCHAR集群 first ep
first_ep_dnode_idINT集群 first ep 的 dnode id
cluster_versionVARCHARtdengine version。例如：3.0.4.0
cluster_idVARCHARTAGcluster id

taosd_cluster_info 表​

taosd_cluster_info 表记录集群信息。

fieldtypeis_tagcomment
_tsTIMESTAMPtimestamp
cluster_uptimeDOUBLE当前 master 节点的 uptime。单位：秒
dbs_totalDOUBLEdatabase 总数
tbs_totalDOUBLE当前集群 table 总数
stbs_totalDOUBLE当前集群 stable 总数
dnodes_totalDOUBLE当前集群 dnode 总数
dnodes_aliveDOUBLE当前集群 dnode 存活总数
mnodes_totalDOUBLE当前集群 mnode 总数
mnodes_aliveDOUBLE当前集群 mnode 存活总数
vgroups_totalDOUBLE当前集群 vgroup 总数
vgroups_aliveDOUBLE当前集群 vgroup 存活总数
vnodes_totalDOUBLE当前集群 vnode 总数
vnodes_aliveDOUBLE当前集群 vnode 存活总数
connections_totalDOUBLE当前集群连接总数
topics_totalDOUBLE当前集群 topic 总数
streams_totalDOUBLE当前集群 stream 总数
grants_expire_timeDOUBLE认证过期时间，企业版有效，社区版为 DOUBLE 最大值
grants_timeseries_usedDOUBLE已用测点数
grants_timeseries_totalDOUBLE总测点数，开源版本为 DOUBLE 最大值
cluster_idVARCHARTAGcluster id

taosd_vgroups_info 表​

taosd_vgroups_info 表记录虚拟节点组信息。

fieldtypeis_tagcomment
_tsTIMESTAMPtimestamp
tables_numDOUBLEvgroup 中 table 数量
statusDOUBLEvgroup 状态，取值范围 0：unsynced、1：ready
vgroup_idVARCHARTAGvgroup id
database_nameVARCHARTAGvgroup 所属的 database 名字
cluster_idVARCHARTAGcluster id

taosd_dnodes_info 表​

taosd_dnodes_info 记录 dnode 信息。

fieldtypeis_tagcomment
_tsTIMESTAMPtimestamp
uptimeDOUBLEdnode uptime，单位：秒
cpu_engineDOUBLEtaosd cpu 使用率，从 /proc/<taosd_pid>/stat 读取
cpu_systemDOUBLE服务器 cpu 使用率，从 /proc/stat 读取
cpu_coresDOUBLE服务器 cpu 核数
mem_engineDOUBLEtaosd 内存使用率，从 /proc/<taosd_pid>/status 读取
mem_freeDOUBLE服务器可用内存，单位 KB
mem_totalDOUBLE服务器内存总量，单位 KB
disk_usedDOUBLEdata dir 挂载的磁盘使用量，单位 bytes
disk_totalDOUBLEdata dir 挂载的磁盘总容量，单位 bytes
system_net_inDOUBLE网络吞吐率，从 /proc/net/dev 中读取的 received bytes。单位 byte/s
system_net_outDOUBLE网络吞吐率，从 /proc/net/dev 中读取的 transmit bytes。单位 byte/s
io_readDOUBLEio 吞吐率，从 /proc/<taosd_pid>/io 中读取的 rchar 与上次数值计算之后，计算得到速度。单位 byte/s
io_writeDOUBLEio 吞吐率，从 /proc/<taosd_pid>/io 中读取的 wchar 与上次数值计算之后，计算得到速度。单位 byte/s
io_read_diskDOUBLE磁盘 io 吞吐率，从 /proc/<taosd_pid>/io 中读取的 read_bytes。单位 byte/s
io_write_diskDOUBLE磁盘 io 吞吐率，从 /proc/<taosd_pid>/io 中读取的 write_bytes。单位 byte/s
vnodes_numDOUBLEdnode 上 vnodes 数量
mastersDOUBLEdnode 上 master node 数量
has_mnodeDOUBLEdnode 是否包含 mnode，取值范围：1：包含、0：不包含
has_qnodeDOUBLEdnode 是否包含 qnode，取值范围：1：包含、0：不包含
has_snodeDOUBLEdnode 是否包含 snode，取值范围：1：包含、0：不包含
has_bnodeDOUBLEdnode 是否包含 bnode，取值范围：1：包含、0：不包含
error_log_countDOUBLEerror 总数
info_log_countDOUBLEinfo 总数
debug_log_countDOUBLEdebug 总数
trace_log_countDOUBLEtrace 总数
dnode_idVARCHARTAGdnode id
dnode_epVARCHARTAGdnode endpoint
cluster_idVARCHARTAGcluster id

taosd_dnodes_status 表​

taosd_dnodes_status 表记录 dnode 状态信息。

fieldtypeis_tagcomment
_tsTIMESTAMPtimestamp
statusDOUBLEdnode 状态，取值范围 1：ready、0：offline
dnode_idVARCHARTAGdnode id
dnode_epVARCHARTAGdnode endpoint
cluster_idVARCHARTAGcluster id

taosd_dnodes_log_dir 表​

taosd_dnodes_log_dir 表记录 log 目录信息。

fieldtypeis_tagcomment
_tsTIMESTAMPtimestamp
availDOUBLElog 目录可用空间。单位 byte
usedDOUBLElog 目录已使用空间。单位 byte
totalDOUBLElog 目录空间。单位 byte
nameVARCHARTAGlog 目录名，一般为 /var/log/taos/
dnode_idVARCHARTAGdnode id
dnode_epVARCHARTAGdnode endpoint
cluster_idVARCHARTAGcluster id

taosd_dnodes_data_dir 表​

taosd_dnodes_data_dir 表记录 data 目录信息。

fieldtypeis_tagcomment
_tsTIMESTAMPtimestamp
availDOUBLEdata 目录可用空间。单位 byte
usedDOUBLEdata 目录已使用空间。单位 byte
totalDOUBLEdata 目录空间。单位 byte
levelVARCHARTAG0、1、2 多级存储级别
nameVARCHARTAGdata 目录，一般为 /var/lib/taos
dnode_idVARCHARTAGdnode id
dnode_epVARCHARTAGdnode endpoint
cluster_idVARCHARTAGcluster id

taosd_mnodes_info 表​

taosd_mnodes_info 表记录 mnode 角色信息。

fieldtypeis_tagcomment
_tsTIMESTAMPtimestamp
roleDOUBLEmnode 角色，取值范围 0：offline、100：follower、101：candidate、102：leader、103：error、104、learne
mnode_idVARCHARTAGmaster node id
mnode_epVARCHARTAGmaster node endpoint
cluster_idVARCHARTAGcluster id

taosd_vnodes_role 表​

taosd_vnodes_role 表记录虚拟节点角色信息。

fieldtypeis_tagcomment
_tsTIMESTAMPtimestamp
vnode_roleDOUBLEvnode 角色，取值范围 0：offline、100：follower、101：candidate、102：leader、103：error、104、learne
vgroup_idVARCHARTAGdnode id
dnode_idVARCHARTAGdnode id
database_nameVARCHARTAGvgroup 所属的 database 名字
cluster_idVARCHARTAGcluster id

taosd_sql_req 表​

taosd_sql_req 记录服务端 sql 请求信息。

fieldtypeis_tagcomment
_tsTIMESTAMPtimestamp
countDOUBLEsql 数量
resultVARCHARTAGsql 的执行结果，取值范围 Success、Failed
usernameVARCHARTAG执行 sql 的 user name
sql_typeVARCHARTAGsql 类型，取值范围 inserted_rows
dnode_idVARCHARTAGdnode id
dnode_epVARCHARTAGdnode endpoint
vgroup_idVARCHARTAGdnode id
cluster_idVARCHARTAGcluster id

taos_sql_req 表​

taos_sql_req 记录客户端 sql 请求信息。

fieldtypeis_tagcomment
_tsTIMESTAMPtimestamp
countDOUBLEsql 数量
resultVARCHARTAGsql 的执行结果，取值范围 Success、Failed
usernameVARCHARTAG执行 sql 的 user name
sql_typeVARCHARTAGsql 类型，取值范围 select、insert、delete
cluster_idVARCHARTAGcluster id

taos_slow_sql 表​

taos_slow_sql 记录客户端慢查询信息。

fieldtypeis_tagcomment
_tsTIMESTAMPtimestamp
countDOUBLEsql 数量
resultVARCHARTAGsql 的执行结果，取值范围 Success、Failed
usernameVARCHARTAG执行 sql 的 user name
durationVARCHARTAGsql 执行耗时，取值范围 3-10s,10-100s,100-1000s,1000s-
cluster_idVARCHARTAGcluster id

taos_slow_sql_detail 表​

taos_slow_sql_detail 记录客户端慢查询详细信息。子表名规则为：{user}_{db}_{ip}_clusterId_{cluster_id}

fieldtypeis_tagcomment
start_tsTIMESTAMPsql 开始执行的客户端时间，单位 ms，主键
request_idUINT64_Tsql 请求的 request id，为 hash 生产的随机值
query_timeINT32_Tsql 执行耗时，单位 ms
codeINT32_Tsql 执行返回码，0 表示成功
error_infoVARCHARsql 执行失败时，记录的错误信息
typeINT8_Tsql 语句的类型（1：查询，2：写入，4：其他）
rows_numINT64_Tsql 执行结果的记录数目
sqlVARCHARsql 语句的字符串
process_nameVARCHAR进程名称
process_idVARCHAR进程 id
dbVARCHARTAG执行 sql 所属数据库
userVARCHARTAG执行 sql 语句的用户
ipVARCHARTAG记录执行 sql 语句的 client 的 ip 地址
cluster_idVARCHARTAGcluster id
SOC 2 Certified
ISO 27001 Certified
ISO 27017 Certified
TDengine 专为物联网IoT平台、工业大数据平台设计。其中，TDengine TSDB 是一款高性能、分布式的时序数据库（Time Series Database），同时它还带有内建的缓存、流式计算、数据订阅等系统功能；TDengine IDMP 是一款AI原生工业数据管理平台，它通过树状层次结构建立数据目录，对数据进行标准化、情景化，并通过 AI 提供实时分析、可视化、事件管理与报警等功能。
产品
TDengine TSDB
TDengine IDMP
TDengine Cloud
学习
TSDB 文档
IDMP 文档
博客
资源
公司
关于我们
技术支持
新闻动态
安全性
联系我们
招贤纳士
服务条款
隐私
场景
物联网
工业互联网
车联网
IT 运维
电力能源
金融
TDengine AI Chat
点击使用 AI 问答
TDengine 的智能助手
TDengine Database
加小 T 为好友
即可加入物联网大数据技术前沿群
点击填写表单
获得解决方案专家帮助
© 2017-2026 涛思数据
京公网安备 11010502047618号
新版时序数据库 TDengine Database v3.0