TDengine 3.3.6.6 版本详解Docker 初始化脚本、协变量预测与虚拟表/STMT 稳定性加固【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengineTDengine 3.3.6.6 于 2025-05-15 发布是一个兼顾“新功能”与“稳定性收敛”的版本taosAdapter 监控指标扩展、Docker 镜像初始化脚本、JDBC 订阅增强、TDgpt 协变量预测等 5 项新特性落地同时修复了 45 个缺陷其中虚拟表VTABLE、STMT 绑定写入、TMQ 订阅三条主线问题集中清理。读完本文你可以快速判断该版本对你部署与升级路径的影响并依据仓库中的入口脚本与配置解析源码理解每项变更的落地机制。版本概览本版本说明以发布记录 3.3.6.6.md 为主体结构分为三部分特性5 项taosAdapter 监控新增指标、Docker 初始化脚本、JDBC 订阅库和超级表、TDgpt 协变量预测、MQTT 接收字节数指标优化11 项覆盖连接器特殊字符密码、增量备份间隔、WebSocket 行为一致性、集群授权、taosX 备份性能、参数热更新等修复45 项集中在虚拟表查询/流计算、STMT/STMT2 内存安全、订阅链路、WebSocket 与 taos shell 体验、安全漏洞等方向。特性逐项解读与仓库佐证1. taosAdapter 监控新增进程、连接池等指标taosAdapter 是 TDengine 的 REST/WebSocket/多协议适配组件默认监听 6041 端口。本版本为其 Prometheus 风格的/metrics端点补充了进程级与连接池级指标便于在 Grafana/告警体系中观测 taosAdapter 自身的资源水位而不仅是 taosd 的服务端指标。从仓库的容器入口脚本 entrypoint.sh 可以看到taosAdapter 就绪探测正是通过轮询http://localhost:6041/metrics完成的脚本第 104111 行若未设置TAOS_DISABLE_ADAPTER后台启动 taosadapter 并以/metrics接口作为存活信号。新增的进程与连接池指标使得该探测之外的深度观测线程、句柄、连接池复用率成为可能。若你通过 Docker 部署文档 将 taosAdapter 拆分为独立容器甚至多副本 Nginx 反代架构这些新指标是判断单个 adapter 实例是否过载的关键依据。2. Docker 镜像支持初始化脚本本版本沿用了类 MySQL 的docker-entrypoint-initdb.d约定镜像内预建/docker-entrypoint-initdb.d/目录见 Dockerfile 第 8081 行的RUN mkdir /docker-entrypoint-initdb.d用户可将.sql文件挂载到该目录容器首启时自动执行完成建库建表等初始化。entrypoint.sh 中的实现细节值得注意仅首节点执行初始化脚本只在本容器是集群 first EP 节点时生效FQDN FIRST_EP_HOST并通过数据目录下的.docker-entrypoint-inited标记文件保证幂等重启容器不会重复执行失败重试每个.sql文件通过taos -f执行若输出中出现DB error则等待 2 秒后重试最多 5 次脚本第 136154 行root 密码联动若设置了非默认的TAOS_ROOT_PASSWORD环境变量首启时会先执行ALTER USER root PASS并写入.docker-entrypoint-root-password-changed标记初始化 SQL 即以新密码执行初始化后自动创建 snode脚本最后执行create snode on dnode 1保证订阅/消息队列能力开箱即用。典型用法docker run -d -v /path/init.sql:/docker-entrypoint-initdb.d/init.sql -e TAOS_ROOT_PASSWORDyourpass -p 6041:6041 tdengine/tdengine容器起来后初始化脚本已执行完毕。3. JDBC 连接器支持订阅库和超级表JDBC 连接器在本版本支持直接对“库”和“超级表”建立订阅TMQ Consumer此前订阅对象粒度更受限。对 Java 生态含 Flink 等流式集成而言这意味着可以在不指定具体子表的情况下按超级表维度批量消费其下所有子表的数据变更简化了大规模子表场景下的消费者配置。该能力与 JDBC 连接器参考文档 及订阅相关文档06-data-subscription配合使用本版本同时还修复了“权限更新后重启导致客户端订阅偶发失败”修复项 23等订阅链路问题订阅路径整体更稳。4. TDgpt 支持协变量分析预测TDgpt 的 TimeSeries Foundation ModelTSFM服务在本版本支持带协变量exogenous/covariate的预测预测目标序列时可将历史及未来的关联变量作为输入对受外部因素驱动较强的工业指标如负荷受温度、电价影响预测精度更友好。从源码结构可以印证该能力的落点TSFM 服务入口 moirai-server.py 实现了handle_covariate_forecast与handle_future_covariate_forecast两类请求处理第 6468 行根据请求类型分发函数定义见第 122、173 行分别对应“仅含历史协变量”与“含未来协变量”两种预测模式。与此同时gpt.py、timemoe.py、timesfm.py 中的部分模型对协变量输入暂以covariate forecast is not supported yet显式报错说明该特性以 moirai 等模型为首批支持具体模型可用性以调用返回为准。使用方式可参考 TDgpt 教程 与 forecast 算子文档。5. MQTT 新增接收字节数指标MQTT 接入通道tmqtt 库见 source/libs/tmqtt新增“接收字节数”指标配合既有消息数指标可以在监控中还原单位时间的数据流量画像对容量规划和异常流量设备风暴识别有价值。优化11 项改进分组解读连接器与客户端体验所有连接器支持密码包含特殊字符——此前特殊字符密码在部分协议链路上会被误解析影响含、/等字符的强密码使用C WebSocket 连接报错与原生连接保持一致——WebSocket 客户端libtaosws错误码语义对齐原生libtaos跨连接方式排障更一致DBeaver 升级 JDBC 连接器——配套更新 IDE/数据库管理工具中的驱动版本ODBC 连接器对用户名密码在 WebSocket 连接的处理、Explorer 特殊密码连通性检查修复项 12、25 亦关联此主题。备份与恢复taosX支持增量备份interval小于 60s备份粒度更细taosX 备份数据 timeout 逻辑优化taosX 数据备份恢复性能优化。集群与参数两节点双副本场景的授权策略优化——小型集群授权行为更合理参数minReservedMemorySize支持热更新。该参数在服务端配置中注册为CFG_DYN_SERVER动态项见 tglobal.c 第 1091 行cfgAddInt32Ex(pCfg, minReservedMemorySize, 0, 1024, 1000000000, CFG_SCOPE_SERVER, CFG_DYN_SERVER, ...)取值范围 01000000000单位 KB默认 0。热更新意味着调整内存预留水位时无需重启 taosdtaosX 2.x/3.x 同步任务重命名为 Query/Data Subscription概念命名与订阅链路统一taosBenchmark 初始化性能优化压测工具冷启动更快。此外还有两项查询侧行为调整调整超级表KEEP属性的修改逻辑ALTER STABLE ... KEEP的约束与生效方式超级表/数据库保留期相关变更需结合业务数据量评估升级后建议用show databases/show stables核对。修复45 项按主题归纳虚拟表VTABLE系列本版本对虚拟表做了密集的问题清理涉及查询正确性与流计算查询虚拟表时查询列与实体表列顺序不一致会误报 “Table Schema is old”修复 17源表列名相同前缀时的同类误报修复 32虚拟表查询不能识别数据表结构修改修复 33使用虚拟表时测点数量计算错误修复 28虚拟表上的流计算未正确触发修复 29数据库包含虚拟表且订阅参数snapshottrue导致 taosd crash修复 26DROP VTABLE IF EXISTS删除不存在的虚拟表报错修复 43SHOW CREATE TABLE与DESC TABLE对复合主键错误显示为PRIMARY KEY而非COMPOSITE KEY修复 27。从问题分布可以推断虚拟表作为“逻辑视图”层的 schema 一致性列序、前缀、结构变更传播是本版本重点收敛的边界场景重度使用 VTABLE 的用户应优先升级。STMT / STMT2 绑定写入系列预编译绑定写入STMT/STMT2是高频写入路径本版本修复了多个内存安全问题STMT 写入模式下 SQL 解析失败导致内存泄漏修复 4STMT2 多线程写入时的内存泄漏修复 5STMT 语句多次 Prepare 导致崩溃修复 8及报错异常修复 9websocket 使用 stmt2 写入数据时的死锁修复 3taosBenchmark 自动建表 Tag 数据写入 coredump修复 13。对使用 C 连接器预编译接口 的高并发写入服务这些修复直接关系到长期运行下的内存稳定性与线程安全。订阅TMQ与数据同步系列数据包含 null、none 与 value 混合项时TMQ 同步可能导致 taosAdapter 崩溃修复 1订阅过程中消费者持有的 WAL 版本被 WAL 文件滚动删除导致订阅失败修复 38多副本间同步数据快照时网络故障造成的重复数据传输引发查询错误修复 22用户权限更新后重启 taosd 导致客户端订阅偶发失败修复 23Sparse 模式同步时 taosAdapter 中断导致数据丢失修复 212.x 数据源连接断开后手动停止任务卡住修复 20taosX 同步表重命名时表结构不一致报错修复 45。这些修复覆盖了订阅链路的“断点恢复—WAL 生命周期—副本同步”关键环节对跨版本数据迁移2.x → 3.x与高可用订阅部署尤为关键。WebSocket 与 taos shell 体验taos shell WebSocket 连接输入中文和中文符号乱码/异常修复 6taosc WebSocket 连接解析taos.cfg中timezone无效修复 7Explorer 日志中粘贴 SQL 包含不识别空白修复 31taos shell 允许\G与分号之间有空格修复 10。时序语义与查询正确性timetruncate时间单位为y时导致 taosd crash修复 14纳秒数据库中 Interval 查询窗口个数计算错误修复 40含 decimal 字段的表做 tag 条件过滤可能 crash修复 41forecast函数输入完全相同数据时部分算法报错修复 42在虚拟子表上创建带NOTIFY语句的流导致超级表无数据生成修复 2Transformer 时间生成器纳秒时间戳重复修复 34流计算结果表未创建完整修复 35。安全与升级路径引用 zlib 仓库存在 CVE-2023-45853 漏洞已替换修复修复 15JDBC 示例代码 CVE-2024-56337 漏洞修复修复 163.3.6.2 升级到 3.3.6.3 后 taosd 无法启动的问题修复 36——处于该升级路径的用户务必升级到本版本或更高版本修改时区配置参数后 taosd 无法启动修复 37Mac 平台原生连接报 “Driver was not loaded”修复 39mac 下 taosBenchmark-s参数报错修复 11。升级建议常规部署3.3.6.6 为稳定性版本从 3.3.6.x 系列升级收益明确尤其是使用虚拟表、STMT 高并发写入、TMQ 订阅的集群3.3.6.2 → 3.3.6.3 遗留问题若曾出现升级后 taosd 无法启动直接升级到 3.3.6.6 可一并解决容器化部署可借机启用本版本 Docker 初始化脚本能力将建库建表、初始账号准备等步骤移入/docker-entrypoint-initdb.d/减少运维脚本监控体系升级后建议同步更新 Grafana 面板纳入 taosAdapter 新增的进程/连接池指标与 MQTT 接收字节数指标升级验证升级前建议完成一次全量备份taosX/taosdump升级后重点回归虚拟表查询与流任务触发、订阅消费者位点恢复、含特殊字符密码的连接器连通性。完整发布记录以 docs/zh/17-release-history/03-notes/3.3.6.6.md 为准本文中的实现佐证涉及 容器入口脚本、Docker 构建文件、服务端配置解析 与 TDgpt TSFM 服务 等仓库文件可继续深入查阅。【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考