TDengine 3.4.1.13 版本说明连接器高可用、TSDB 新特性与稳定性全面升级【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine导读本文档基于 TDengine 开源仓库官方发布说明docs/zh/17-release-history/03-notes/3.4.1.13.md整理详细介绍 TDengine3.4.1.13版本发布时间2026-07-02带来的 6 项新特性、22 项功能优化与 35 项问题修复。阅读本文后你将全面掌握该版本在连接器高可用、TSDB 授权与订阅、流计算增强、WAL 自愈、Windows 平台支持等方面的具体能力变化并了解各修复项对应的使用场景便于评估升级收益与排查问题。一、新特性Features本版本共引入 6 项新特性覆盖连接器可靠性、TSDB 数据订阅、授权管理以及流计算状态窗口等方向。1. 多语言连接器支持 Adapter 高可用C# 连接器、JDBC、Rust 连接器均新增对 AdaptertaosAdapter高可用HA的支持。在实际生产部署中可通过配置多个 taosAdapter 地址实现故障转移避免单一 Adapter 节点故障导致业务写入/查询中断。这与连接器对数据库节点dnode高可用的既有能力形成互补使端到端接入链路更加健壮。2. TSDB CLI 支持 subscribe 命令订阅 Topic 数据TSDB CLI 交互模式下新增subscribe命令可以直接在命令行交互环境中订阅 Topic 数据。此前订阅 Topic 数据通常需要通过各语言连接器的 TMQ数据订阅接口实现现在运维与开发人员可以直接在 CLI 中完成订阅消费便于快速验证 Topic 内容与调试数据链路。3. TSDB 支持通过 License Server 进行授权管理TSDB数据库服务端新增基于License Server的授权管理模式。通过独立的 License Server 统一签发与管理授权适用于需要集中化授权控制的企业场景。结合仓库中 cmake/enterprise.cmake 等构建配置可以看出TDengine 的授权管理面向企业级部署链路设计。4. 状态窗口表达式增强状态窗口STATE_WINDOW的表达式新增支持常量标签列tag 列逻辑运算符如AND、OR等。状态窗口是流计算中按状态条件划分窗口的重要窗口类型。此前状态窗口的窗口表达式仅支持部分简单条件本次扩展后可以基于标签与逻辑组合定义更加复杂的状态切换条件。从源码结构看状态窗口的推导与计算逻辑集中在 source/libs/new-stream/src/streamTriggerTask.c其中包含对STATE_WINDOW状态列的追加计算与窗口闭合判定该增强属于流计算引擎new-stream 模块的表达式能力升级。二、优化Enhancements本版本包含 22 项优化从连接器功能、平台支持、SQL 函数、系统参数、流计算、taosX 数据接入等多个维度提升产品易用性与性能。1. 连接器与驱动优化序号优化内容说明1C WebSocket 连接器支持decimal数据类型补齐 WebSocket 链路上的高精度数值类型支持2ODBC WS 连接器新增传输压缩降低弱网环境下 ODBC WebSocket 传输的数据量3Python UDF 依赖随包发布taospyudf库改为随安装包统一发布不再需要手动执行pip3 install taospyudf和ldconfig大幅简化 UDF 环境搭建4微秒us精度数据库支持 stmt2 查询扩展 stmt2 预编译查询能力到微秒精度数据库覆盖更精细的时间序列场景2. Windows 平台支持增强本版本针对 Windows 平台集中补齐了多项能力新增共享存储功能Windows 部署支持共享存储模式便于多节点共享数据盘部署。新增 UDF 功能支持Windows 平台首次支持用户自定义函数UDF。WAL_LEVEL 默认值调整Windows 平台新建数据库时WAL_LEVEL默认值设为2强制刷新在 Windows 文件系统环境下优先保证数据落盘安全。同时修复了 Windows 下 Native 库时区TZ格式、WebSocket 接口 timezone 失效、taosdlog 日志顺序错误等一系列问题详见修复章节。3. SQL 函数与查询优化base64 函数新增支持非字符串类型参数可对数值等类型直接进行 base64 编码减少使用时的显式类型转换。ASOF Join查询性能提升加速时间序列场景下最常用的非等值关联查询。流计算查询语句中 JOIN 的执行效率提升改善流式场景下多流关联的处理吞吐。支持列查询结果脱敏展示对敏感列的查询结果进行脱敏处理满足安全合规要求可配合 11-security-guide 中的权限与安全配置使用。4. 系统参数与管理能力优化支持动态修改参数tmqMaxTopicNum和mqRebalanceInterval这两个数据订阅TMQ相关参数无需重启服务即可调整前者控制单个客户端可订阅的最大 Topic 数量后者控制消费者组 Rebalance 的检查间隔方便在线调优订阅集群。支持show create stream命令查看流计算的完整创建语句。该能力由 mnode 中的流管理模块提供相关逻辑位于 source/dnode/mnode/impl/src/mndStreamMgmt.c可用于流任务迁移、重建与审计。新增kill compact compact_id force命令支持强制删除正在运行的数据重整compact任务便于运维在数据重整任务异常卡住时快速干预。新增配置参数WALDeleteOnCorruption默认开启当 WAL 文件损坏时系统自动修复并移除损坏文件避免因 WAL 损坏导致 vnode 无法启动。从源码看该参数定义于 source/common/src/tglobal.ctsWalDeleteOnCorruption默认值为true属于服务端全局配置CFG_SCOPE_SERVER且支持动态修改。在 source/libs/wal/src/walMeta.c 中WAL 元数据恢复逻辑会依据tsWalDeleteOnCorruption判断是否直接删除损坏的 WAL 文件相应的行为验证位于 source/libs/wal/test/walMetaTest.cpp测试用例通过开关该参数验证损坏 WAL 的自动修复路径。流计算事件窗口EVENT_WINDOW的子事件通知新增父事件 ID 字段便于在流计算输出中关联父事件与子事件完善嵌套事件场景的追踪能力。5. taosX 数据接入优化新增配置项backup.auto_create_dir支持自动创建备份目录简化备份任务的目录准备工作。taosX-agent OPC UA 数据接入新增存储转发功能当目标端暂不可用时OPC UA 数据可先落盘暂存恢复后继续转发增强数据接入的容错性。调整 OPC UA 批次整体失败时的重试与超级表创建策略避免批次失败场景下的数据丢失。6. 其他优化taos-explorer 连通性检查错误提示信息改进便于定位网络/配置问题。taos-explorer 登录失败后的错误提示信息改进。vnode 处于 learner 角色时不再参与选主流程避免 learner 节点干扰主节点选举提升集群选主的稳定性与效率。三、修复Bug Fixes本版本共修复 35 个问题覆盖升级兼容、数据写入、订阅、流计算、taosX 数据接入、集群管理、平台适配等场景。1. 升级与兼容性修复修复3.3 版本升级至 3.4 版本时ROOT 用户无权限创建新用户的问题。修复3.3 版本升级至 3.4 版本时多副本 mnode 场景下部分权限设置失效的问题。修复从 v3.3.8.x 版本升级到 3.4.1.9 版本时流状态兼容性问题。修复K8s 部署时无法获取正常容器资源信息的问题。修复英文环境下 Explorer 查询结果导出 CSV 时中文内容乱码的问题。2. 写入、查询与数据类型修复修复C WebSocket 连接器无模式写入时微秒精度转换错误的问题。修复STMT 高效写入模式下删除表并重建同名表后数据写入错误的问题。修复STMT2 使用 concat 函数时导致程序崩溃的问题。修复多客户端并发无模式写入时触发修改同一个超级表报错的问题。修复LoF局部离群因子支持多列数据异常检测的问题。修复查询线程内存分配失败时因提前释放指针导致的崩溃问题并修复错误路径下的资源泄漏。修复存在大量超级表时执行show stables命令卡死/挂起的问题。修复创建超级表的标签顺序与自动建表的标签顺序不一致时订阅结果错误的问题。3. 流计算修复修复流计算中使用 UDF 时函数编号超出范围导致的进程崩溃问题。修复流计算中子查询表达式计算时使用值缓存导致查询结果错误的问题。修复流计算使用%% trows写入 varchar 类型数据时发生崩溃的问题。修复虚拟表查询包含 STATE_WINDOW 但未使用实际聚合函数时报 Invalid Parameter 错误的问题。4. 集群与权限修复修复副本数为 2 时执行balance vgroup报错的问题。修复执行balance leader操作处理反引号飘号标识符出错的问题。修复频繁修改用户权限且同时执行show users等操作时引发程序崩溃的问题。5. taosX 与 Explorer 修复修复taos-explorer 创建数据接入任务时保存失败的问题。修复taos-explorer 的 datain 任务中修改任务名称不生效的问题。修复taosExplorer DataIn 任务同步进度显示异常的问题。修复taosX 任务 Kafka 规则中过滤条件显示异常的问题。修复taosX 使用 UDT 和超级表模板时出现数据采集故障的问题。修复taosX 同步 InfluxDB 数据时measurement 数量过大导致的 OOM问题。修复taosX 接入 MQTT 数据时过滤条件不生效的问题。修复taosX 接入 PI 数据源时连接报错的问题。修复taosX 消费 Kafka 数据时Kafka 集群异常后的重试机制不完善的问题。修复taosX 的 MQTT 任务配置 UDT 解析与过滤条件后任务创建失败的问题。修复taosX 的 PI Connector 在 PI Vision 使用 CDR 时实时刷新失败的问题。修复taosX 的 PI Connector 接入数据时无法修改超级表名和列名的问题。四、升级建议与注意事项升级路径本版本重点修复了 3.3 → 3.4 升级过程中的权限问题以及 v3.3.8.x → 3.4.x 的流状态兼容性问题。若你正运行上述旧版本建议优先评估升级到 3.4.1.13。WAL 自愈参数新增的WALDeleteOnCorruption默认开启启用后 WAL 文件损坏时会被自动修复并移除损坏文件。对于对数据冗余要求极高的场景请在升级前评估该默认行为是否符合业务预期并可通过 taos.cfg 等配置文件进行显式设置。Windows 平台若在 Windows 部署升级后新建数据库时WAL_LEVEL默认值为2强制刷新写入性能与数据安全之间需要结合业务重新评估。Python UDF升级后taospyudf已随安装包发布无需再手动执行pip3 install taospyudf与ldconfig存量环境建议清理旧的独立安装方式避免版本冲突。五、总结TDengine 3.4.1.13 是面向连接器生态与生产稳定性的一次重要更新C#、JDBC、Rust 连接器全面支持 Adapter 高可用TSDB CLI 新增订阅能力并支持 License Server 授权同时通过 WAL 损坏自愈、learner 不参与选主、ASOF Join 性能优化等改进增强了系统健壮性35 项修复则覆盖了升级兼容、流计算、taosX 数据接入与平台适配等高频痛点。建议生产环境用户结合自身场景评估升级并持续关注 17-release-history 目录下的后续版本说明。【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 TDengine 3.4.1.13 版本说明：连接器高可用、TSDB 新特性与稳定性全面升级
TDengine 3.4.1.13 版本说明连接器高可用、TSDB 新特性与稳定性全面升级【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine导读本文档基于 TDengine 开源仓库官方发布说明docs/zh/17-release-history/03-notes/3.4.1.13.md整理详细介绍 TDengine3.4.1.13版本发布时间2026-07-02带来的 6 项新特性、22 项功能优化与 35 项问题修复。阅读本文后你将全面掌握该版本在连接器高可用、TSDB 授权与订阅、流计算增强、WAL 自愈、Windows 平台支持等方面的具体能力变化并了解各修复项对应的使用场景便于评估升级收益与排查问题。一、新特性Features本版本共引入 6 项新特性覆盖连接器可靠性、TSDB 数据订阅、授权管理以及流计算状态窗口等方向。1. 多语言连接器支持 Adapter 高可用C# 连接器、JDBC、Rust 连接器均新增对 AdaptertaosAdapter高可用HA的支持。在实际生产部署中可通过配置多个 taosAdapter 地址实现故障转移避免单一 Adapter 节点故障导致业务写入/查询中断。这与连接器对数据库节点dnode高可用的既有能力形成互补使端到端接入链路更加健壮。2. TSDB CLI 支持 subscribe 命令订阅 Topic 数据TSDB CLI 交互模式下新增subscribe命令可以直接在命令行交互环境中订阅 Topic 数据。此前订阅 Topic 数据通常需要通过各语言连接器的 TMQ数据订阅接口实现现在运维与开发人员可以直接在 CLI 中完成订阅消费便于快速验证 Topic 内容与调试数据链路。3. TSDB 支持通过 License Server 进行授权管理TSDB数据库服务端新增基于License Server的授权管理模式。通过独立的 License Server 统一签发与管理授权适用于需要集中化授权控制的企业场景。结合仓库中 cmake/enterprise.cmake 等构建配置可以看出TDengine 的授权管理面向企业级部署链路设计。4. 状态窗口表达式增强状态窗口STATE_WINDOW的表达式新增支持常量标签列tag 列逻辑运算符如AND、OR等。状态窗口是流计算中按状态条件划分窗口的重要窗口类型。此前状态窗口的窗口表达式仅支持部分简单条件本次扩展后可以基于标签与逻辑组合定义更加复杂的状态切换条件。从源码结构看状态窗口的推导与计算逻辑集中在 source/libs/new-stream/src/streamTriggerTask.c其中包含对STATE_WINDOW状态列的追加计算与窗口闭合判定该增强属于流计算引擎new-stream 模块的表达式能力升级。二、优化Enhancements本版本包含 22 项优化从连接器功能、平台支持、SQL 函数、系统参数、流计算、taosX 数据接入等多个维度提升产品易用性与性能。1. 连接器与驱动优化序号优化内容说明1C WebSocket 连接器支持decimal数据类型补齐 WebSocket 链路上的高精度数值类型支持2ODBC WS 连接器新增传输压缩降低弱网环境下 ODBC WebSocket 传输的数据量3Python UDF 依赖随包发布taospyudf库改为随安装包统一发布不再需要手动执行pip3 install taospyudf和ldconfig大幅简化 UDF 环境搭建4微秒us精度数据库支持 stmt2 查询扩展 stmt2 预编译查询能力到微秒精度数据库覆盖更精细的时间序列场景2. Windows 平台支持增强本版本针对 Windows 平台集中补齐了多项能力新增共享存储功能Windows 部署支持共享存储模式便于多节点共享数据盘部署。新增 UDF 功能支持Windows 平台首次支持用户自定义函数UDF。WAL_LEVEL 默认值调整Windows 平台新建数据库时WAL_LEVEL默认值设为2强制刷新在 Windows 文件系统环境下优先保证数据落盘安全。同时修复了 Windows 下 Native 库时区TZ格式、WebSocket 接口 timezone 失效、taosdlog 日志顺序错误等一系列问题详见修复章节。3. SQL 函数与查询优化base64 函数新增支持非字符串类型参数可对数值等类型直接进行 base64 编码减少使用时的显式类型转换。ASOF Join查询性能提升加速时间序列场景下最常用的非等值关联查询。流计算查询语句中 JOIN 的执行效率提升改善流式场景下多流关联的处理吞吐。支持列查询结果脱敏展示对敏感列的查询结果进行脱敏处理满足安全合规要求可配合 11-security-guide 中的权限与安全配置使用。4. 系统参数与管理能力优化支持动态修改参数tmqMaxTopicNum和mqRebalanceInterval这两个数据订阅TMQ相关参数无需重启服务即可调整前者控制单个客户端可订阅的最大 Topic 数量后者控制消费者组 Rebalance 的检查间隔方便在线调优订阅集群。支持show create stream命令查看流计算的完整创建语句。该能力由 mnode 中的流管理模块提供相关逻辑位于 source/dnode/mnode/impl/src/mndStreamMgmt.c可用于流任务迁移、重建与审计。新增kill compact compact_id force命令支持强制删除正在运行的数据重整compact任务便于运维在数据重整任务异常卡住时快速干预。新增配置参数WALDeleteOnCorruption默认开启当 WAL 文件损坏时系统自动修复并移除损坏文件避免因 WAL 损坏导致 vnode 无法启动。从源码看该参数定义于 source/common/src/tglobal.ctsWalDeleteOnCorruption默认值为true属于服务端全局配置CFG_SCOPE_SERVER且支持动态修改。在 source/libs/wal/src/walMeta.c 中WAL 元数据恢复逻辑会依据tsWalDeleteOnCorruption判断是否直接删除损坏的 WAL 文件相应的行为验证位于 source/libs/wal/test/walMetaTest.cpp测试用例通过开关该参数验证损坏 WAL 的自动修复路径。流计算事件窗口EVENT_WINDOW的子事件通知新增父事件 ID 字段便于在流计算输出中关联父事件与子事件完善嵌套事件场景的追踪能力。5. taosX 数据接入优化新增配置项backup.auto_create_dir支持自动创建备份目录简化备份任务的目录准备工作。taosX-agent OPC UA 数据接入新增存储转发功能当目标端暂不可用时OPC UA 数据可先落盘暂存恢复后继续转发增强数据接入的容错性。调整 OPC UA 批次整体失败时的重试与超级表创建策略避免批次失败场景下的数据丢失。6. 其他优化taos-explorer 连通性检查错误提示信息改进便于定位网络/配置问题。taos-explorer 登录失败后的错误提示信息改进。vnode 处于 learner 角色时不再参与选主流程避免 learner 节点干扰主节点选举提升集群选主的稳定性与效率。三、修复Bug Fixes本版本共修复 35 个问题覆盖升级兼容、数据写入、订阅、流计算、taosX 数据接入、集群管理、平台适配等场景。1. 升级与兼容性修复修复3.3 版本升级至 3.4 版本时ROOT 用户无权限创建新用户的问题。修复3.3 版本升级至 3.4 版本时多副本 mnode 场景下部分权限设置失效的问题。修复从 v3.3.8.x 版本升级到 3.4.1.9 版本时流状态兼容性问题。修复K8s 部署时无法获取正常容器资源信息的问题。修复英文环境下 Explorer 查询结果导出 CSV 时中文内容乱码的问题。2. 写入、查询与数据类型修复修复C WebSocket 连接器无模式写入时微秒精度转换错误的问题。修复STMT 高效写入模式下删除表并重建同名表后数据写入错误的问题。修复STMT2 使用 concat 函数时导致程序崩溃的问题。修复多客户端并发无模式写入时触发修改同一个超级表报错的问题。修复LoF局部离群因子支持多列数据异常检测的问题。修复查询线程内存分配失败时因提前释放指针导致的崩溃问题并修复错误路径下的资源泄漏。修复存在大量超级表时执行show stables命令卡死/挂起的问题。修复创建超级表的标签顺序与自动建表的标签顺序不一致时订阅结果错误的问题。3. 流计算修复修复流计算中使用 UDF 时函数编号超出范围导致的进程崩溃问题。修复流计算中子查询表达式计算时使用值缓存导致查询结果错误的问题。修复流计算使用%% trows写入 varchar 类型数据时发生崩溃的问题。修复虚拟表查询包含 STATE_WINDOW 但未使用实际聚合函数时报 Invalid Parameter 错误的问题。4. 集群与权限修复修复副本数为 2 时执行balance vgroup报错的问题。修复执行balance leader操作处理反引号飘号标识符出错的问题。修复频繁修改用户权限且同时执行show users等操作时引发程序崩溃的问题。5. taosX 与 Explorer 修复修复taos-explorer 创建数据接入任务时保存失败的问题。修复taos-explorer 的 datain 任务中修改任务名称不生效的问题。修复taosExplorer DataIn 任务同步进度显示异常的问题。修复taosX 任务 Kafka 规则中过滤条件显示异常的问题。修复taosX 使用 UDT 和超级表模板时出现数据采集故障的问题。修复taosX 同步 InfluxDB 数据时measurement 数量过大导致的 OOM问题。修复taosX 接入 MQTT 数据时过滤条件不生效的问题。修复taosX 接入 PI 数据源时连接报错的问题。修复taosX 消费 Kafka 数据时Kafka 集群异常后的重试机制不完善的问题。修复taosX 的 MQTT 任务配置 UDT 解析与过滤条件后任务创建失败的问题。修复taosX 的 PI Connector 在 PI Vision 使用 CDR 时实时刷新失败的问题。修复taosX 的 PI Connector 接入数据时无法修改超级表名和列名的问题。四、升级建议与注意事项升级路径本版本重点修复了 3.3 → 3.4 升级过程中的权限问题以及 v3.3.8.x → 3.4.x 的流状态兼容性问题。若你正运行上述旧版本建议优先评估升级到 3.4.1.13。WAL 自愈参数新增的WALDeleteOnCorruption默认开启启用后 WAL 文件损坏时会被自动修复并移除损坏文件。对于对数据冗余要求极高的场景请在升级前评估该默认行为是否符合业务预期并可通过 taos.cfg 等配置文件进行显式设置。Windows 平台若在 Windows 部署升级后新建数据库时WAL_LEVEL默认值为2强制刷新写入性能与数据安全之间需要结合业务重新评估。Python UDF升级后taospyudf已随安装包发布无需再手动执行pip3 install taospyudf与ldconfig存量环境建议清理旧的独立安装方式避免版本冲突。五、总结TDengine 3.4.1.13 是面向连接器生态与生产稳定性的一次重要更新C#、JDBC、Rust 连接器全面支持 Adapter 高可用TSDB CLI 新增订阅能力并支持 License Server 授权同时通过 WAL 损坏自愈、learner 不参与选主、ASOF Join 性能优化等改进增强了系统健壮性35 项修复则覆盖了升级兼容、流计算、taosX 数据接入与平台适配等高频痛点。建议生产环境用户结合自身场景评估升级并持续关注 17-release-history 目录下的后续版本说明。【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考