跳到主要内容

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:指定日志输入方式,可选 stdoutstderr/dev/null<directory> <directory>/<filename><filename>
  • -k:获取机器码
  • -dm:启用内存调度
  • -V:打印版本信息

配置参数

备注

配置文件参数修改后,通常需要重启 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 版本开始引入

shellActivityTimer

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

numOfRpcSessions

  • 说明:RPC 支持的最大连接数
  • 类型:整数
  • 默认值:30000
  • 最小值:100
  • 最大值:100000
  • 动态修改:支持通过 SQL 修改,重启后生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

numOfRpcThreads

  • 说明:RPC 收发数据的线程数目
  • 类型:整数
  • 默认值:CPU 核数的一半
  • 最小值:1
  • 最大值:50
  • 动态修改:支持通过 SQL 修改,重启后生效。
  • 支持版本:从 v3.0.0.0 版本开始引入

numOfTaskQueueThreads

  • 说明:RPC 处理消息的线程数目
  • 类型:整数
  • 默认值:CPU 核数的一半
  • 最小值:4
  • 最大值:16
  • 动态修改:支持通过 SQL 修改,重启后生效。
  • 支持版本:从 v3.0.0.0 版本开始引入

rpcQueueMemoryAllowed

  • 说明:dnode 已经收到并等待处理的 RPC 消息占用内存的最大值
  • 类型:整数
  • 单位:byte
  • 默认值:服务器内存的 1/10
  • 最小值: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

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

shareConnLimit

  • 说明:一个链接可以共享的请求的数目
  • 类型:整数
  • 默认值:10
  • 最小值:1
  • 最大值:512
  • 动态修改:支持通过 SQL 修改,重启后生效。
  • 支持版本:从 v3.3.4.0 版本开始引入

readTimeout

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

监控相关

monitor

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

monitorFqdn

  • 说明:taosKeeper 服务所在服务器的地址
  • 类型:fqdn
  • 默认值:无
  • 动态修改:支持通过 SQL 修改,重启后生效。
  • 支持版本:从 v3.0.0.0 版本开始引入

monitorPort

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

monitorInterval

  • 说明:监控数据库记录系统参数(CPU/内存)的时间间隔
  • 类型:整数
  • 单位:秒
  • 默认值:30
  • 最小值:1
  • 最大值:200000
  • 动态修改:支持通过 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:打开。
  • 默认值: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:上传。
  • 默认值:1
  • 最小值:0
  • 最大值:1
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.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 引入

queryBufferSize

  • 说明:查询可用的缓存大小
  • 类型:整数;-1 表示不限制。
  • 单位:MB
  • 默认值:-1
  • 最小值:-1
  • 最大值:500000000000
  • 动态修改:支持通过 SQL 修改,重启后效。
  • 支持版本:预留参数,当前版本尚不支持

queryRspPolicy

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

queryUseMemoryPool

  • 说明:查询是否使用内存池管理内存
  • 类型:整数;0:关闭;1:打开。
  • 默认值:1
  • 最小值:0
  • 最大值:1
  • 动态修改:不支持
  • 支持版本:v3.3.5.0 引入

minReservedMemorySize

  • 说明:最小预留的系统可用内存数量,除预留外的内存都可以被用于查询。
  • 类型:整数
  • 单位:MB
  • 默认值:系统物理内存的 20%
  • 最小值:1024
  • 最大值:1000000000
  • 动态修改:不支持
  • 支持版本:v3.3.5.0 引入

singleQueryMaxMemorySize

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

filterScalarMode

  • 说明:强制使用标量过滤模式
  • 类型:整数;0:关闭;1:开启。
  • 默认值:0
  • 最小值:0
  • 最大值:1
  • 动态修改:不支持
  • 支持版本: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_M
  • 最大值: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

  • 说明:排序使用的内存阈值 内部参数
  • 类型:整数
  • 单位:MB
  • 默认值:16
  • 最小值:1
  • 最大值:10240
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

区域相关

timezone

  • 说明:时区
  • 默认值:从系统中动态获取当前的时区设置
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

locale

  • 说明:系统区位信息及编码格式
  • 默认值:从系统中获取
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

charset

  • 说明:字符集编码
  • 默认值:从系统中获取
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入
信息

区域相关参数说明

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

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

timezone UTC-8
timezone GMT-8
timezone Asia/Shanghai

均是合法的设置东八区时区的格式。但需注意,Windows 下并不支持 timezone Asia/Shanghai 这样的写法,而必须写成 timezone UTC-8

时区的设置对于查询和写入 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。

存储相关

dataDir

  • 说明:数据文件目录,所有的数据文件都将写入该目录。
  • 类型:字符串
  • 默认值:/var/lib/taos
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

diskIDCheckEnabled

  • 说明:在重启 dnode 时增加了检查 dataDir 所在磁盘 id 是否发生改变
  • 类型:整数;0:进行检查,1:不进行检查。
  • 默认值:1
  • 最小值: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 版本开始引入

s3MigrateIntervalSec

  • 说明:本地数据文件自动上传 S3 的触发周期 企业版参数
  • 类型:整数
  • 单位:秒
  • 默认值:3600
  • 最小值:600
  • 最大值:100000
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.3.4.3 版本开始引入

s3MigrateEnabled

  • 说明:是否自动进行 S3 迁移 企业版参数
  • 类型:整数;0:关闭,1:开启。
  • 默认值:0
  • 最小值:0
  • 最大值:1
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.3.4.3 版本开始引入

s3Accesskey

  • 说明:冒号分隔的用户 SecretId:SecretKey 企业版参数
  • 示例:AKIDsQmwsfKxTo2A6nGVXZN0UlofKn6JRRSJ:lIdoy99ygEacU7iHfogaN2Xq0yumSm1E
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.3.4.3 版本开始引入

s3Endpoint

  • 说明:用户所在地域的 COS 服务域名,支持 http 和 https,bucket 的区域需要与 endpoint 保持一致,否则无法访问。 企业版参数
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.3.4.3 版本开始引入

s3BucketName

  • 说明:存储桶名称,减号后面是用户注册 COS 服务的 AppId,其中 AppId 是 COS 特有,AWS 和阿里云都没有,配置时需要作为 bucket name 的一部分,使用减号分隔;参数值均为字符串类型,但不需要引号。 企业版参数
  • 示例:test0711-1309024725
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.3.4.3 版本开始引入

s3PageCacheSize

  • 说明:S3 page cache 缓存页数目 企业版参数
  • 类型:整数
  • 单位:页
  • 默认值:4096
  • 最小值:4
  • 最大值:1048576
  • 示例:test0711-1309024725
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.3.4.3 版本开始引入

s3UploadDelaySec

  • 说明:data 文件持续多长时间不再变动后上传至 S3 企业版参数
  • 类型:整数
  • 单位:秒
  • 默认值:60
  • 最小值:1
  • 最大值:2592000
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.3.4.3 版本开始引入

cacheLazyLoadThreshold

  • 说明:缓存的装载策略 内部参数
  • 类型:整数
  • 默认值:500
  • 最小值:0
  • 最大值:100000
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

集群相关

supportVnodes

  • 说明:dnode 支持的最大 vnode 数目
  • 类型:整数
  • 默认值:CPU 核数的 2 倍 + 5
  • 最小值:0
  • 最大值:4096
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

numOfCommitThreads

  • 说明:落盘线程的最大数量
  • 类型:整数
  • 默认值:4
  • 最小值:1
  • 最大值:1024
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

numOfCompactThreads

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

numOfMnodeReadThreads

  • 说明:mnode 的 Read 线程数目
  • 类型:整数
  • 默认值:CPU 核数的四分之一(不低于 1 不超过 4)
  • 最小值:0
  • 最大值:1024
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

numOfVnodeQueryThreads

  • 说明:vnode 的 Query 线程数目
  • 类型:整数
  • 默认值:CPU 核数的两倍(不低于 16)
  • 最小值:0
  • 最大值:1024
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

numOfVnodeFetchThreads

  • 说明:vnode 的 Fetch 线程数目
  • 类型:整数
  • 默认值:CPU 核数的四分之一(不低于 4)
  • 最小值:0
  • 最大值:1024
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

numOfVnodeRsmaThreads

  • 说明:vnode 的 Rsma 线程数目
  • 类型:整数
  • 默认值:CPU 核数的四分之一(不低于 4)
  • 最小值:0
  • 最大值:1024
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

numOfQnodeQueryThreads

  • 说明:qnode 的 Query 线程数目
  • 类型:整数
  • 默认值:CPU 核数的两倍(不低于 16)
  • 最小值:0
  • 最大值:1024
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

numOfSnodeSharedThreads

  • 说明:snode 的共享线程数目
  • 类型:整数
  • 默认值:CPU 核数的四分之一(不小于 2,不超过 4)
  • 最小值:0
  • 最大值:1024
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

numOfSnodeUniqueThreads

  • 说明:snode 的独占线程数目
  • 类型:整数
  • 默认值:CPU 核数的四分之一(不小于 2,不超过 4)
  • 最小值:0
  • 最大值:1024
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

ratioOfVnodeStreamThreads

  • 说明:流计算使用 vnode 线程的比例
  • 类型:浮点数
  • 默认值:0.5
  • 最小值:0.01
  • 最大值:4
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

ttlUnit

  • 说明:ttl 参数的单位
  • 类型:整数
  • 单位:秒
  • 默认值:86400
  • 最小值:1
  • 最大值:31572500
  • 动态修改:不支持
  • 支持版本: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

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

maxTsmaNum

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

tmqMaxTopicNum

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

tmqRowSize

  • 说明:订阅数据块的最大记录条数
  • 类型:整数
  • 默认值:4096
  • 最小值:1
  • 最大值:1000000
  • 动态修改:支持通过 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 版本开始引入

auditCreateTable

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

encryptAlgorithm

  • 说明:数据加密算法 企业版参数
  • 类型:字符串
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

encryptScope

  • 说明:加密范围 企业版参数
  • 类型:字符串
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

enableWhiteList

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

syncLogBufferMemoryAllowed

  • 说明:一个 dnode 允许的 sync 日志缓存消息占用的内存最大值
  • 类型:整数
  • 单位:bytes
  • 默认值:服务器内存的 1/10
  • 最小值:104857600
  • 最大值:9223372036854775807
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:v3.1.3.2/v3.3.2.13 版本开始生效

syncElectInterval

  • 说明:用于同步模块调试 内部参数
  • 类型:整数
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

syncHeartbeatInterval

  • 说明:用于同步模块调试 内部参数
  • 类型:整数
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

syncHeartbeatTimeout

  • 说明:用于同步模块调试 内部参数
  • 类型:整数
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

syncSnapReplMaxWaitN

  • 说明:用于同步模块调试 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

arbHeartBeatIntervalSec

  • 说明:用于同步模块调试 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

arbCheckSyncIntervalSec

  • 说明:用于同步模块调试 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

arbSetAssignedTimeoutSec

  • 说明:用于同步模块调试 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

arbSetAssignedTimeoutSec

  • 说明:用于 mnode 模块调试 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

mndLogRetention

  • 说明:用于 mnode 模块调试 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

skipGrant

  • 说明:用于授权检查 内部参数
  • 类型:整数
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

trimVDbIntervalSec

  • 说明:用于删除过期数据 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

ttlFlushThreshold

  • 说明:ttl 定时器的频率 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

compactPullupInterval

  • 说明:数据重整定时器的频率 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

walFsyncDataSizeLimit

  • 说明:WAL 进行 FSYNC 的阈值 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

transPullupInterval

  • 说明:mnode 执行事务的重试间 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

mqRebalanceInterval

  • 说明:消费者再平衡的时间间隔**内部参数**
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

uptimeInterval

  • 说明:用于记录系统启动时间 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

timeseriesThreshold

  • 说明:用于统计用量 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

udf

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

udfdResFuncs

  • 说明:用于统计用量 内部参数
  • 类型:字符串
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

udfdLdLibPath

  • 说明:用于统计用量 内部参数
  • 类型:字符串
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

enableStrongPassword

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

流计算参数

disableStream

  • 说明:流计算的启动开关
  • 类型:整数;0:启动,1:关闭。
  • 默认值:0
  • 最小值:0
  • 最大值:1
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

streamBufferSize

  • 说明:控制内存中窗口状态缓存的大小
  • 类型:整数
  • 单位:bytes
  • 默认值:128 * 1024 * 1024
  • 最小值:0
  • 最大值:9223372036854775807
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

streamAggCnt

  • 说明:并发进行聚合计算的数目 内部参数
  • 类型:整数
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

checkpointInterval

  • 说明:checkponit 同步间隔 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

concurrentCheckpoint

  • 说明:是否并发检查 checkpoint 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

maxStreamBackendCache

  • 说明:流计算使用的最大缓存 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

streamSinkDataRate

  • 说明:用于控制流计算结果的写入速度 内部参数
  • 类型:整数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

streamNotifyMessageSize

  • 说明:用于控制事件通知的消息大小 内部参数
  • 类型:整数
  • 单位:KB
  • 默认值:8192
  • 最小值:8
  • 最大值:1048576
  • 动态修改:不支持
  • 支持版本:v3.3.6.0 引入

streamNotifyFrameSize

  • 说明:用于控制事件通知消息发送时底层的帧大小 内部参数
  • 类型:整数
  • 单位:KB
  • 默认值:256
  • 最小值:8
  • 最大值:1048576
  • 动态修改:不支持
  • 支持版本:v3.3.6.0 引入

adapterFqdn

  • 说明:taosAdapter 服务的地址 内部参数
  • 类型:fqdn
  • 默认值:localhost
  • 动态修改:不支持
  • 支持版本:v3.3.6.0 引入

adapterPort

  • 说明:taosAdapter 服务的端口号 内部参数
  • 类型:整数
  • 默认值:6041
  • 最小值:1
  • 最大值:65056
  • 动态修改:不支持
  • 支持版本:v3.3.6.0 引入

adapterToken

  • 说明:为 {username}:{password} 经过 Base64 编码之后的字符串 内部参数
  • 类型:字符串
  • 默认值:cm9vdDp0YW9zZGF0YQ==
  • 动态修改:不支持
  • 支持版本:v3.3.6.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 为日志文件最后修改的时间戳,并滚动产生新的日志文件。
  • 类型:整数;0
  • 单位:天
  • 默认值:0
  • 最小值:-365000
  • 最大值:365000
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

slowLogThreshold

  • 说明:慢查询门限值,大于等于门限值认为是慢查询。
  • 类型:整数
  • 单位:秒
  • 默认值:3
  • 最小值: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 版本开始引入

调试相关

enableCoreFile

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

configDir

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

forceReadConfig

  • 说明:配置文件所在目录
  • 类型:整数;0:使用持久化的配置参数,1:使用配置文件中的配置参数。
  • 默认值:0
  • 最小值:0
  • 最大值:1
  • 动态修改:不支持
  • 支持版本:v3.3.5.0 引入

scriptDir

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

assert

  • 说明:断言控制开关
  • 类型:整数;0:关闭,1:开启。
  • 默认值:0
  • 最小值:0
  • 最大值:1
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

randErrorChance

  • 说明:用于随机失败测试 内部参数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

randErrorDivisor

  • 说明:用于随机失败测试 内部参数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

randErrorScope

  • 说明:用于随机失败测试 内部参数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

safetyCheckLevel

  • 说明:用于随机失败测试 内部参数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

experimental

  • 说明:用于一些实验特性 内部参数
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

simdEnable

  • 说明:用于测试 SIMD 加速 内部参数
  • 动态修改:不支持
  • 支持版本:v3.3.4.3 引入

AVX512Enable

  • 说明:用于测试 AVX512 加速 内部参数
  • 动态修改:不支持
  • 支持版本:v3.3.4.3 引入

rsyncPort

  • 说明:用于调试流计算 内部参数
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

snodeAddress

  • 说明:用于调试流计算 内部参数
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

checkpointBackupDir

  • 说明:用于恢复 snode 数据 内部参数
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从 v3.1.0.0 版本开始引入

enableAuditDelete

  • 说明:用于测试审计功能 内部参数
  • 动态修改:不支持
  • 支持版本:v3.1.0.0 引入

slowLogThresholdTest

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

bypassFlag

  • 说明:配置文件所在目录
  • 类型:整数
  • 取值范围:
    • 0:正常写入
    • 1:写入消息在 taos 客户端发送 RPC 消息前返回
    • 2:写入消息在 taosd 服务端收到 RPC 消息后返回
    • 4:写入消息在 taosd 服务端写入内存缓存前返回
    • 8:写入消息在 taosd 服务端数据落盘前返回
  • 默认值:0
  • 动态修改:支持通过 SQL 修改,立即生效。
  • 支持版本:从 v3.3.4.5 版本开始引入

压缩参数

fPrecision

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

dPrecision

  • 说明:设置 double 类型浮点数压缩精度,小于此值的浮点数尾数部分将被截取。
  • 类型:浮点数
  • 默认值:0.0000000000000001
  • 最小值:0.0000000000000001
  • 最大值:0.1
  • 动态修改:支持通过 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 以后废弃。

maxRange

  • 说明:用于有损压缩设置 内部参数
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从v3.1.0.0 版本引入,v3.3.0.0 以后废弃。

curRange

  • 说明:用于有损压缩设置 内部参数
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从v3.1.0.0 版本引入,v3.3.0.0 以后废弃。

compressor

  • 说明:用于有损压缩设置 内部参数
  • 动态修改:支持通过 SQL 修改,重启生效。
  • 支持版本:从v3.1.0.0 版本引入,v3.3.0.0 以后废弃。

补充说明

  1. 在 3.3.5.0 之后,所有配置参数都将被持久化到本地存储,重启数据库服务后,将默认使用持久化的配置参数列表;如果您希望继续使用 config 文件中配置的参数,需设置 forceReadConfig 为 1。
  2. 在 3.2.0.0 ~ 3.3.0.0(不包含)版本生效,启用该参数后不能回退到升级前的版本。
  3. TSZ 压缩算法是通过数据预测技术完成的压缩,所以更适合有规律变化的数据。
  4. TSZ 压缩时间会更长一些,如果您的服务器 CPU 空闲多,存储空间小的情况下适合选用。
  5. 示例:对 float 和 double 类型都启用有损压缩。
lossyColumns     float|double
  1. 配置需重启服务生效,重启如果在 taosd 日志中看到以下内容,表明配置已生效:
   02/22 10:49:27.607990 00002933 UTL  lossyColumns     float|double

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