TDengine 配置参数作用范围对比

本文档对比了 TDengine TSDB 中 taosd（服务端）和 taosc（客户端）的配置参数，明确标识每个参数的作用范围。

配置参数作用范围对比表

参数名称	作用范围	说明
连接相关
firstEp	both	启动时，主动连接的集群中首个 dnode 的 endpoint
secondEp	both	启动时，如果 firstEp 连接不上，尝试连接集群中第二个 dnode 的 endpoint
fqdn	taosd	taosd 监听的服务地址
serverPort	both	taosd 监听的端口
compressMsgSize	both	是否对 RPC 消息进行压缩
shellActivityTimer	both	客户端向 mnode 发送心跳的时长
numOfRpcSessions	both	RPC 支持的最大连接数
numOfRpcThreads	both	RPC 收发数据的线程数目
numOfTaskQueueThreads	both	RPC 处理消息的线程数目
rpcQueueMemoryAllowed	taosd	dnode 已经收到并等待处理的 RPC 消息占用内存的最大值
resolveFQDNRetryTime	taosd	FQDN 解析失败时的重试次数
timeToGetAvailableConn	taosc	获得可用连接的最长等待时间
maxShellConns	taosd	允许创建的最大连接数
maxRetryWaitTime	both	重连最大超时时间，从重试时候开始计算
shareConnLimit	both	一个链接可以共享的请求的数目
readTimeout	both	单个请求最小超时时间
useAdapter	taosc	是否使用 taosadapter，影响 CSV 文件导入
监控相关
monitor	taosd	是否收集监控数据并上报
monitorFqdn	taosd	taosKeeper 服务所在服务器的地址
monitorPort	taosd	taosKeeper 服务所监听的端口号
monitorInterval	taosd	监控数据库记录系统参数（CPU/内存）的时间间隔
monitorMaxLogs	taosd	缓存的待上报日志条数
monitorComp	taosd	是否采用压缩方式上报监控日志
monitorLogProtocol	taosd	是否打印监控日志
monitorForceV2	taosd	是否使用 V2 版本协议上报日志
telemetryReporting	taosd	是否上传 telemetry
telemetryServer	taosd	telemetry 服务器地址
telemetryPort	taosd	telemetry 服务器端口号
telemetryInterval	taosd	telemetry 上传时间间隔
crashReporting	both	是否使用 V2 版本协议上报日志
enableMetrics	taosd	是否打开写入诊断工具，收集并上传写入指标
metricsInterval	taosd	写入诊断工具上传写入指标的间隔
metricsLevel	taosd	写入诊断工具上传写入指标的级别
查询相关
countAlwaysReturnValue	both	count/hyperloglog 函数在输入数据为空或者 NULL 的情况下是否返回值
tagFilterCache	taosd	是否缓存标签过滤结果
queryBufferSize	taosd	查询可用的缓存大小
queryRspPolicy	taosd	查询响应策略
queryUseMemoryPool	taosd	查询是否使用内存池管理内存
minReservedMemorySize	taosd	内存池开启时，最小预留的系统可用内存数量
singleQueryMaxMemorySize	taosd	单个查询在单个节点 (dnode) 上可以使用的内存上限
filterScalarMode	taosd	强制使用标量过滤模式
queryNoFetchTimeoutSec	taosd	查询中当应用长时间不 FETCH 数据时的超时时间
queryPlannerTrace	both	查询计划是否输出详细日志
queryNodeChunkSize	both	查询计划的块大小
queryUseNodeAllocator	both	查询计划的分配方法
queryMaxConcurrentTables	both	查询计划的分配方法
queryRsmaTolerance	taosd	查询计划的分配方法
enableQueryHb	both	是否发送查询心跳消息
pqSortMemThreshold	taosd	排序使用的内存阈值
keepColumnName	taosc	Last、First、LastRow 函数查询且未指定别名时，自动设置别名为列名
multiResultFunctionStarReturnTags	taosc	查询超级表时，last()/last_row()/first(*) 是否返回标签列
metaCacheMaxSize	taosc	指定单个客户端元数据缓存大小的最大值
maxTsmaCalcDelay	taosc	查询时客户端可允许的 tsma 计算延迟
tsmaDataDeleteMark	taosc	TSMA 计算的历史数据中间结果保存时间
queryPolicy	taosc	查询语句的执行策略
queryTableNotExistAsEmpty	taosc	查询表不存在时是否返回空结果集
querySmaOptimize	taosc	querSmaOptimize，永远从原始数据进行查询
queryMaxConcurrentTables	taosc	查询计划的并发数目
minSlidingTime	taosc	sliding 的最小允许值
minIntervalTime	taosc	interval 的最小允许值
compareAsStrInGreatest	taosc	用于决定 greatest、least 函数的参数既有数值类型又有字符串类型时，比较类型的转换规则
showFullCreateTableColumn	taosc	show create table 的返回值是否带 column 的压缩信息
区域相关
timezone	both	时区
locale	both	系统区位信息及编码格式
charset	both	字符集编码
存储相关
dataDir	taosd	数据文件目录，所有的数据文件都将写入该目录
diskIDCheckEnabled	taosd	在重启 dnode 时增加了检查 dataDir 所在磁盘 id 是否发生改变
tempDir	both	指定所有系统运行过程中的临时文件生成的目录
minimalDataDirGB	taosd	dataDir 指定的时序数据存储目录所需要保留的最小空间
minimalTmpDirGB	both	tempDir 所指定的临时文件目录所需要保留的最小空间
minDiskFreeSize	taosd	当某块磁盘上的可用空间小于等于这个阈值时，该磁盘将不再被选择用于生成新的数据文件
ssAutoMigrateIntervalSec	taosd	本地数据文件自动迁移共享存储的触发周期
ssEnabled	taosd	是否启用共享存储
ssAccessString	taosd	共享存储访问参数字符串
ssPageCacheSize	taosd	共享存储 page cache 缓存页数目
ssUploadDelaySec	taosd	data 文件持续多长时间不再变动后上传至共享存储
cacheLazyLoadThreshold	taosd	缓存的装载策略
集群相关
supportVnodes	taosd	dnode 支持的最大 vnode 数目
numOfCommitThreads	taosd	落盘线程的最大数量
numOfCompactThreads	taosd	合并线程的最大数量
numOfMnodeReadThreads	taosd	mnode 的 Read 线程数目
numOfVnodeQueryThreads	taosd	vnode 的 Query 线程数目
numOfVnodeFetchThreads	taosd	vnode 的 Fetch 线程数目
numOfVnodeRsmaThreads	taosd	vnode 的 Rsma 线程数目
numOfQnodeQueryThreads	taosd	qnode 的 Query 线程数目
ttlUnit	taosd	ttl 参数的单位
ttlPushInterval	taosd	ttl 检测超时频率
ttlChangeOnWrite	taosd	ttl 到期时间是否伴随表的修改操作改变
ttlBatchDropNum	taosd	ttl 一批删除子表的数目
retentionSpeedLimitMB	taosd	数据在不同级别硬盘上迁移时的速度限制
maxTsmaNum	taosd	集群内可创建的 TSMA 个数
tmqMaxTopicNum	taosd	订阅最多可建立的 topic 数量
tmqRowSize	taosd	订阅数据块的最大记录条数
audit	taosd	审计功能开关
auditInterval	taosd	审计数据上报的时间间隔
auditCreateTable	taosd	是否针对创建子表开启申计功能
encryptAlgorithm	taosd	数据加密算法
encryptScope	taosd	加密范围
encryptPassAlgorithm	taosd	加密存储用户密码功能开关
enableWhiteList	taosd	白名单功能开关
syncLogBufferMemoryAllowed	taosd	一个 dnode 允许的 sync 日志缓存消息占用的内存最大值
syncApplyQueueSize	taosd	sync 日志 apply 队列的大小
syncElectInterval	taosd	用于同步模块调试
syncHeartbeatInterval	taosd	用于同步模块调试
syncHeartbeatTimeout	taosd	用于同步模块调试
syncSnapReplMaxWaitN	taosd	用于同步模块调试
arbHeartBeatIntervalSec	taosd	用于同步模块调试
arbCheckSyncIntervalSec	taosd	用于同步模块调试
arbSetAssignedTimeoutSec	taosd	用于同步模块调试
mndLogRetention	taosd	用于 mnode 模块调试
skipGrant	taosd	用于授权检查
trimVDbIntervalSec	taosd	用于删除过期数据
ttlFlushThreshold	taosd	ttl 定时器的频率
compactPullupInterval	taosd	数据重整定时器的频率
walFsyncDataSizeLimit	taosd	WAL 进行 FSYNC 的阈值
walForceRepair	taosd	强制修复 wal 文件
transPullupInterval	taosd	mnode 执行事务的重试间
forceKillTrans	taosd	用于 mnode 事务模块调试
mqRebalanceInterval	taosd	消费者再平衡的时间间隔
uptimeInterval	taosd	用于记录系统启动时间
timeseriesThreshold	taosd	用于统计用量
udf	taosd	是否启动 UDF 服务
udfdResFuncs	taosd	用于统计用量
udfdLdLibPath	taosd	用于统计用量
enableStrongPassword	taosd	密码要符合一个要求：至少包含大写字母、小写字母、数字、特殊字符中的三类
流计算参数
numOfMnodeStreamMgmtThreads	taosd	mnode 流计算管理线程个数
numOfStreamMgmtThreads	taosd	snode 流计算管理线程个数
numOfVnodeStreamReaderThreads	taosd	vnode 流计算读线程个数
numOfStreamTriggerThreads	taosd	流计算触发线程个数
numOfStreamRunnerThreads	taosd	流计算执行线程个数
streamBufferSize	taosd	流计算可以使用的最大缓存大小，只适用于 %%trows 的结果缓存
streamNotifyMessageSize	taosd	用于控制事件通知的消息大小
streamNotifyFrameSize	taosd	用于控制事件通知消息发送时底层的帧大小
日志相关
logDir	both	日志文件目录，运行日志将写入该目录
minimalLogDirGB	both	日志文件夹所在磁盘可用空间大小小于该值时，停止写日志
numOfLogLines	both	单个日志文件允许的最大行数
asyncLog	both	日志写入模式
logKeepDays	both	日志文件的最长保存时间
slowLogThreshold	taosd	慢查询门限值，大于等于门限值认为是慢查询
slowLogMaxLen	taosd	慢查询日志最大长度
slowLogScope	taosd	慢查询记录类型
slowLogExceptDb	taosd	指定的数据库不上报慢查询，仅支持配置换一个数据库
debugFlag	both	运行日志开关，该参数的设置会影响到所有模块的开关
tmrDebugFlag	both	定时器模块的日志开关
uDebugFlag	both	共用功能模块的日志开关
rpcDebugFlag	both	rpc 模块的日志开关
qDebugFlag	both	query 模块的日志开关
dDebugFlag	taosd	dnode 模块的日志开关
vDebugFlag	taosd	vnode 模块的日志开关
mDebugFlag	taosd	mnode 模块的日志开关
azDebugFlag	taosd	S3 模块的日志开关
sDebugFlag	taosd	sync 模块的日志开关
tsdbDebugFlag	taosd	tsdb 模块的日志开关
tqDebugFlag	taosd	tq 模块的日志开关
fsDebugFlag	taosd	fs 模块的日志开关
udfDebugFlag	taosd	udf 模块的日志开关
smaDebugFlag	taosd	sma 模块的日志开关
idxDebugFlag	taosd	index 模块的日志开关
tdbDebugFlag	taosd	tdb 模块的日志开关
metaDebugFlag	taosd	meta 模块的日志开关
stDebugFlag	taosd	stream 模块的日志开关
sndDebugFlag	taosd	snode 模块的日志开关
jniDebugFlag	taosc	jni 模块的日志开关
cDebugFlag	taosc	客户端模块的日志开关
simDebugFlag	taosc	测试工具的日志开关
tqClientDebugFlag	taosc	测试工具的日志开关
rpcRecvLogThreshold	taosd	rpc模块的警告日志的阈值
调试相关
enableCoreFile	both	crash 时是否生成 core 文件
configDir	both	配置文件所在目录
forceReadConfig	taosd	是否使用持久化的局部配置参数
scriptDir	both	测试工具的脚本目录
assert	both	断言控制开关
randErrorChance	both	用于随机失败测试
randErrorDivisor	both	用于随机失败测试
randErrorScope	both	用于随机失败测试
safetyCheckLevel	both	用于随机失败测试
experimental	taosd	用于一些实验特性
simdEnable	both	用于测试 SIMD 加速
AVX512Enable	both	用于测试 AVX512 加速
rsyncPort	taosd	用于调试流计算
snodeAddress	taosd	用于调试流计算
checkpointBackupDir	taosd	用于恢复 snode 数据
enableAuditDelete	taosd	用于测试审计功能
slowLogThresholdTest	taosd	用于测试慢日志
bypassFlag	both	用于短路测试
压缩参数
fPrecision	taosd	设置 float 类型浮点数压缩精度，小于此值的浮点数尾数部分将被截断
dPrecision	taosd	设置 double 类型浮点数压缩精度，小于此值的浮点数尾数部分将被截取
lossyColumn	taosd	对 float 和/或 double 类型启用 TSZ 有损压缩
ifAdtFse	taosd	在启用 TSZ 有损压缩时，使用 FSE 算法替换 HUFFMAN 算法
enableIpv6	taosd	用于节点直接通过 ipv6 通信
maxRange	taosd	用于有损压缩设置
curRange	taosd	用于有损压缩设置
compressor	taosd	用于有损压缩设置
写入相关
smlChildTableName	taosc	schemaless 自定义的子表名的 key
smlAutoChildTableNameDelimiter	taosc	schemaless tag 之间的连接符，连起来作为子表名
smlTagName	taosc	schemaless tag 为空时默认的 tag 名字
smlTsDefaultName	taosc	schemaless 自动建表的时间列名字通过该配置设置
smlDot2Underline	taosc	schemaless 把超级表名中的 dot 转成下划线
maxInsertBatchRows	taosc	一批写入的最大条数
SHELL 相关
enableScience	taosc	是否开启科学计数法显示浮点数
WebSocket 相关
serverPort	taosc	taosadapter 监听的端口
timezone	taosc	时区
logDir	taosc	日志文件目录，运行日志将写入该目录
logKeepDays	taosc	日志文件的最长保存时间
rotationCount	taosc	日志文件轮转数量
rotationSize	taosc	单个日志文件最大大小（支持 KB/MB/GB 单位）
compression	taosc	是否对 WebSocket 消息进行压缩
adapterList	taosc	taosAdapter 地址列表，用于负载均衡和故障转移
connRetries	taosc	连接失败时的最大重试次数
retryBackoffMs	taosc	连接失败时的初始等待时间（毫秒）
retryBackoffMaxMs	taosc	连接失败时的最大等待时间（毫秒）

说明

• taosd: 仅服务端生效的配置参数
• taosc: 仅客户端生效的配置参数
• both: 服务端和客户端都生效的配置参数

关于 TDengine

TDengine 是一款专为物联网、工业互联网等场景设计并优化的大数据平台，其核心模块是高性能、集群开源、云原生、极简的时序数据库。

它能安全高效地将大量设备每天产生的高达 TB 甚至 PB 级的数据进行汇聚、存储、分析和分发，并提供 AI 智能体对数据进行预测与异常检测，提供实时的商业洞察。