TDengine 3.3.7.5 版本发布解读数据接入、WebSocket 与共享存储的关键更新【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine本文基于官方 Release Notes3.3.7.5发布日期 2025-08-28展开系统梳理该维护版本在新特性、增强项与缺陷修复三个维度的全部变更并结合仓库中的配置文档与源码重点解读 taosX 数据接入、C WebSocket 连接、共享存储、流计算与 taosExplorer 等模块的落地细节帮助你在升级到 3.3.7.5 后快速评估影响面并正确配置。版本定位与升级说明3.3.7.5 属于 TDengine 3.3.x 系列的一个维护版本Maintenance Release。根据仓库中 版本规则说明 的定义TDengine 版本号由四位数字构成格式为[Major].[Major].[Feature].[Maintenance]维护版本最后一位不引入新特性只做缺陷修复支持滚动升级且升级后可回退滚动升级指对于由三个及以上节点构成、且采用三副本的集群逐个节点停止、升级、再启动重复此过程直至全部节点升级完成升级期间集群仍可对外提供服务功能版本第三位升级不支持滚动升级但从同一大版本内不同功能版本升级后可以回退大版本第二位升级不支持滚动升级且不可回退。因此从 3.3.7.0或更早的 3.3.6.x升级到 3.3.7.5属于同 Feature 系列的维护升级可以按滚动升级流程执行风险可控。新特性Features1. taosX 支持导入 ORC 格式taosX零代码数据接入平台在本版本新增了对ORCOptimized Row Columnar文件格式的导入支持进一步丰富了 taosX 支持的数据源类型。taosX 是 TDengine 官方提供的无代码数据接入工具其安装、迁移与数据源配置说明可参考 taosX 安装 与 数据迁移 文档。ORC 常用于 Hadoop 生态的大数据存储这一能力的补齐意味着 Hive/Spark 等系统导出的 ORC 文件可以直接导入 TDengine无需先转换为 CSV 等中间格式。2. C WebSocket 连接级时区支持C 语言的 WebSocket 连接对应c-ws系列客户端示例代码见 c-ws-new 示例在本次版本中支持在连接级别设置时区。这意味着同一进程内不同的 WebSocket 连接可以携带各自的时区配置方便跨时区的多源数据写入与查询场景。3. 流计算包含虚拟表查询的流创建时错误路由数据库TD-37437创建包含虚拟表virtual table查询的流时如果数据库定位不正确可能导致流计算被路由到错误的数据库。该问题以缺陷形式TD-37437提交本次作为特性修复。虚拟表相关流计算选项可参考 流处理语法 与 流处理最佳实践。4. ODBC 支持 ADO 接口ODBC 驱动在本版本支持ADOActiveX Data Objects接口。ADO 是 Windows 平台上常用的数据访问接口支持 ADO 意味着 Windows 上的遗留应用如 VB、脚本、老式 .NET 程序可以更平滑地通过 ODBC 驱动访问 TDengine降低存量系统迁移成本。5. taosAdapter 支持将 SQL 记录到 CSVtaosAdapterTDengine 的 RESTful 接入组件新增了将执行的SQL 记录为 CSV 文件的能力便于审计、回放与问题排查。增强项Enhancements1. taosExplorer环境变量跳过注册流程从 3.3.7.1 起可通过环境变量EXPLORER_SKIP_REGISTERtrue跳过注册流程直接使用账号登录见 taosExplorer 文档。本版本继续保留并完善该能力在私有化/内网部署场景下无需走在线注册即可使用 Explorer。启动示例EXPLORER_SKIP_REGISTERtrue taos-explorer2. taosX 二进制体积缩减约 60M压缩后约 15MtaosX 的安装包/二进制体积被大幅缩减未压缩体积减少约 60MB压缩后减少约 15MB可显著降低边缘侧与受限网络环境下的分发与部署成本。3. taosExplorer 用户名去除首尾空格taosExplorer 在登录与用户管理时会对用户名做 trim 处理避免因误输入前后空格导致的认证失败。4. C WebSocket 支持自动重连配置项C WebSocket 客户端新增自动重连auto reconnect相关配置选项可在连接异常断开后自动恢复会话减少 IoT 场景下因网络抖动造成的写入中断相关示例参考 c-ws-new 示例。5. Windows 平台支持 DDD 格式时间格式化在 Windows 平台上时间格式化支持使用DDD表示一年中的第几天格式串补齐了跨平台时间格式化的能力。6. taosExplorer OSS 版仪表盘禁用告警taosExplorer 的开源OSS版本中Dashboard 的告警alert功能被禁用避免未授权功能在开源版本中暴露。7. S3 上传支持 verifyPeer 参数跳过证书校验taosX 在S3 数据上传时新增verifyPeer参数允许用户跳过对服务器证书的校验。这与 TDengine 共享存储shared storage中 S3 配置的参数语义一致根据 多副本与共享存储配置S3 兼容对象存储的ssAccessString支持以下与安全/传输相关的选项参数说明endpoint对象存储服务器的主机名/IP 及可选端口bucket存储桶名称protocolhttps或http默认httpsuriStylevirtualHost或path默认virtualHostregion对象存储服务区域可选accessKeyId / secretAccessKey访问密钥对chunkSize分块大小MB超过该大小的文件使用分片上传默认 64maxChunks分片上传允许的最大分片数默认 10000maxRetry可重试错误的最大重试次数默认 3负值表示无限重试verifyPeer是否校验对端服务器证书仅当protocol为https时生效默认 false配置示例ssAccessString s3:endpoints3.amazonaws.com;bucketmybucket;uriStylepath;protocolhttps;accessKeyIdAKMYACCESSKEY;secretAccessKeyMYSECRETACCESSKEY;regionus-east-2;chunkSize64;maxChunks10000;maxRetry3;verifyPeerfalse在 taosX 的 S3 上传场景中若使用自签名证书或私有 CA 的内部对象存储可设置verifyPeer跳过证书校验以完成上传。8. S3 数据迁移状态控制机制增强针对 S3 数据迁移增强了状态控制机制提升迁移的精度与效率减少因状态漂移导致的重复迁移或漏迁移。9. taosExplorer 可配置 OPC UA 请求超时taosExplorer 在 OPC UA 数据接入场景下请求超时时间现在可配置便于适配网络状况较差的工业现场。OPC UA 接入相关说明见 OPC UA 无代码接入。10. SHOW CREATE TABLE 不再输出压缩信息SHOW CREATE TABLE的输出中不再包含压缩compression信息使建表语句展示更简洁同时也避免通过该命令误解读表级压缩配置。11. 共享存储支持 NASTDengine 的共享存储shared storage现在支持 NAS。此前共享存储主要面向 S3 兼容对象存储与本地挂载文件系统fs类型通过baseDir指定目录例如ssAccessString fs:baseDir/var/taos/ss。NAS 支持意味着基于 NFS/CIFS 等协议挂载的存储设备也可以作为共享存储使用降低中小规模部署的存储成本。12. taosBenchmark 通过 WebSocket 支持重试压测工具taosBenchmark在通过 WebSocket 协议连接时支持重试机制提升压测在弱网环境下的稳定性。taosBenchmark 相关说明见 taosBenchmark 目录。13. 提升 Kafka 数据接入性能taosX 的Kafka 数据接入性能得到提升Kafka 接入配置详见 Kafka 无代码接入。14. 修复 taosX 未启动时 UI 报 undefined 错误当 taosX 服务未启动时taosExplorer 界面不再出现undefined错误提示交互更友好。缺陷修复Fixes数据接入taosX / taosExplorer / taosAdapter加速 InfluxDB 1.x 查询并修复 OOMtaosX 的 InfluxDB 数据源在查询 1.x 版本数据时显著提速同时修复了可能导致内存溢出OOM的问题非默认密码下创建数据复制报错修复taosExplorer 中当使用非默认密码时创建数据复制任务不再报错不存在的文件导致恢复restore失败修复恢复过程中因文件不存在而反复报 failed to open file 且无法停止的问题varbinary 数据库映射修复taosExplorer 的 transform数据变换环节中 varbinary 数据库类型映射错误被修复Oracle 十进制转换 panic 修复从 Oracle 迁移 decimal 类型数据时不再触发 panicMQTT 采样频率过低导致超时修复 MQTT 获取样本数据在频率过低时的超时问题见 MQTT 无代码接入taosdump 按时间范围导出在 us/ns 精度下报错修复 taosdump 在微秒/纳秒精度下按时间范围导出数据时出错的问题taosdump 源码见 tools/taosdumpCSV 导入含 value 字段报错taosExplorer 导入包含value字段的 CSV 时不再报错多标签字段值相同时级联标签表列表异常修复 taosExplorer 中多标签字段取值相同时级联cascading标签表列表展示错误单字段不同类型导致 taosX 出现空值修复 taosX 在单个字段出现不同类型数据时得到意外 null 值的问题。流计算与查询长查询内存回收竞态崩溃修复修复长时间运行的查询在内存回收过程中因竞态条件race condition导致的崩溃批量创建流任务时偶发 stream task lost修复批量创建流任务时偶发丢失流任务的报错删除流时 Explorer 报 Database not specified修复在 taosExplorer 中删除流时报数据库未指定的错误CALC_NOTIFY_ONLY 选项崩溃修复修复在流计算中使用CALC_NOTIFY_ONLY选项时的崩溃问题。CALC_NOTIFY_ONLY是流计算的重要选项之一含义为仅将计算结果作为通知发送、不写入输出表。根据 流处理语法当未指定该选项时计算结果会写入输出表适用于只需要结果通知、无需持久化结果的场景见 流处理最佳实践常与PRE_FILTER等选项组合使用例如CREATE STREAM ... STREAM_OPTIONS(CALC_NOTIFY_ONLY | PRE_FILTER(col1 0));该选项在 SQL 关键字附录 中亦有登记属于保留关键字。触发器与运维触发器表标签为 null 导致崩溃修复触发器trigger表中标签字段为 null 时导致的崩溃taoskeeper 审计日志字段过长报错修复 taoskeeper 审计日志中client_address字段值过长导致 value too long for column/tag 的错误见 taoskeeper 源码nginx 服务重启导致 Explorer 报错修复 nginx 重启引发的 taosExplorer 异常。升级与验证建议版本匹配3.3.7.5 为维护版本支持滚动升级升级时请同步升级客户端驱动libtaos.so与服务器端重点回归场景结合本版本修复列表建议重点回归以下场景——长查询稳定性、批量创建流任务、CALC_NOTIFY_ONLY 流计算、taosdump 高精度导出、S3 上传与迁移配置项核对若使用共享存储请核对ssAccessString中的verifyPeerhttps 下生效默认 false等参数若使用 taosExplorer可设置EXPLORER_SKIP_REGISTERtrue跳过注册流程。完整的变更清单以 3.3.7.5 Release Notes 为准历史版本可查阅 版本历史索引。【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 TDengine 3.3.7.5 版本发布解读：数据接入、WebSocket 与共享存储的关键更新
TDengine 3.3.7.5 版本发布解读数据接入、WebSocket 与共享存储的关键更新【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine本文基于官方 Release Notes3.3.7.5发布日期 2025-08-28展开系统梳理该维护版本在新特性、增强项与缺陷修复三个维度的全部变更并结合仓库中的配置文档与源码重点解读 taosX 数据接入、C WebSocket 连接、共享存储、流计算与 taosExplorer 等模块的落地细节帮助你在升级到 3.3.7.5 后快速评估影响面并正确配置。版本定位与升级说明3.3.7.5 属于 TDengine 3.3.x 系列的一个维护版本Maintenance Release。根据仓库中 版本规则说明 的定义TDengine 版本号由四位数字构成格式为[Major].[Major].[Feature].[Maintenance]维护版本最后一位不引入新特性只做缺陷修复支持滚动升级且升级后可回退滚动升级指对于由三个及以上节点构成、且采用三副本的集群逐个节点停止、升级、再启动重复此过程直至全部节点升级完成升级期间集群仍可对外提供服务功能版本第三位升级不支持滚动升级但从同一大版本内不同功能版本升级后可以回退大版本第二位升级不支持滚动升级且不可回退。因此从 3.3.7.0或更早的 3.3.6.x升级到 3.3.7.5属于同 Feature 系列的维护升级可以按滚动升级流程执行风险可控。新特性Features1. taosX 支持导入 ORC 格式taosX零代码数据接入平台在本版本新增了对ORCOptimized Row Columnar文件格式的导入支持进一步丰富了 taosX 支持的数据源类型。taosX 是 TDengine 官方提供的无代码数据接入工具其安装、迁移与数据源配置说明可参考 taosX 安装 与 数据迁移 文档。ORC 常用于 Hadoop 生态的大数据存储这一能力的补齐意味着 Hive/Spark 等系统导出的 ORC 文件可以直接导入 TDengine无需先转换为 CSV 等中间格式。2. C WebSocket 连接级时区支持C 语言的 WebSocket 连接对应c-ws系列客户端示例代码见 c-ws-new 示例在本次版本中支持在连接级别设置时区。这意味着同一进程内不同的 WebSocket 连接可以携带各自的时区配置方便跨时区的多源数据写入与查询场景。3. 流计算包含虚拟表查询的流创建时错误路由数据库TD-37437创建包含虚拟表virtual table查询的流时如果数据库定位不正确可能导致流计算被路由到错误的数据库。该问题以缺陷形式TD-37437提交本次作为特性修复。虚拟表相关流计算选项可参考 流处理语法 与 流处理最佳实践。4. ODBC 支持 ADO 接口ODBC 驱动在本版本支持ADOActiveX Data Objects接口。ADO 是 Windows 平台上常用的数据访问接口支持 ADO 意味着 Windows 上的遗留应用如 VB、脚本、老式 .NET 程序可以更平滑地通过 ODBC 驱动访问 TDengine降低存量系统迁移成本。5. taosAdapter 支持将 SQL 记录到 CSVtaosAdapterTDengine 的 RESTful 接入组件新增了将执行的SQL 记录为 CSV 文件的能力便于审计、回放与问题排查。增强项Enhancements1. taosExplorer环境变量跳过注册流程从 3.3.7.1 起可通过环境变量EXPLORER_SKIP_REGISTERtrue跳过注册流程直接使用账号登录见 taosExplorer 文档。本版本继续保留并完善该能力在私有化/内网部署场景下无需走在线注册即可使用 Explorer。启动示例EXPLORER_SKIP_REGISTERtrue taos-explorer2. taosX 二进制体积缩减约 60M压缩后约 15MtaosX 的安装包/二进制体积被大幅缩减未压缩体积减少约 60MB压缩后减少约 15MB可显著降低边缘侧与受限网络环境下的分发与部署成本。3. taosExplorer 用户名去除首尾空格taosExplorer 在登录与用户管理时会对用户名做 trim 处理避免因误输入前后空格导致的认证失败。4. C WebSocket 支持自动重连配置项C WebSocket 客户端新增自动重连auto reconnect相关配置选项可在连接异常断开后自动恢复会话减少 IoT 场景下因网络抖动造成的写入中断相关示例参考 c-ws-new 示例。5. Windows 平台支持 DDD 格式时间格式化在 Windows 平台上时间格式化支持使用DDD表示一年中的第几天格式串补齐了跨平台时间格式化的能力。6. taosExplorer OSS 版仪表盘禁用告警taosExplorer 的开源OSS版本中Dashboard 的告警alert功能被禁用避免未授权功能在开源版本中暴露。7. S3 上传支持 verifyPeer 参数跳过证书校验taosX 在S3 数据上传时新增verifyPeer参数允许用户跳过对服务器证书的校验。这与 TDengine 共享存储shared storage中 S3 配置的参数语义一致根据 多副本与共享存储配置S3 兼容对象存储的ssAccessString支持以下与安全/传输相关的选项参数说明endpoint对象存储服务器的主机名/IP 及可选端口bucket存储桶名称protocolhttps或http默认httpsuriStylevirtualHost或path默认virtualHostregion对象存储服务区域可选accessKeyId / secretAccessKey访问密钥对chunkSize分块大小MB超过该大小的文件使用分片上传默认 64maxChunks分片上传允许的最大分片数默认 10000maxRetry可重试错误的最大重试次数默认 3负值表示无限重试verifyPeer是否校验对端服务器证书仅当protocol为https时生效默认 false配置示例ssAccessString s3:endpoints3.amazonaws.com;bucketmybucket;uriStylepath;protocolhttps;accessKeyIdAKMYACCESSKEY;secretAccessKeyMYSECRETACCESSKEY;regionus-east-2;chunkSize64;maxChunks10000;maxRetry3;verifyPeerfalse在 taosX 的 S3 上传场景中若使用自签名证书或私有 CA 的内部对象存储可设置verifyPeer跳过证书校验以完成上传。8. S3 数据迁移状态控制机制增强针对 S3 数据迁移增强了状态控制机制提升迁移的精度与效率减少因状态漂移导致的重复迁移或漏迁移。9. taosExplorer 可配置 OPC UA 请求超时taosExplorer 在 OPC UA 数据接入场景下请求超时时间现在可配置便于适配网络状况较差的工业现场。OPC UA 接入相关说明见 OPC UA 无代码接入。10. SHOW CREATE TABLE 不再输出压缩信息SHOW CREATE TABLE的输出中不再包含压缩compression信息使建表语句展示更简洁同时也避免通过该命令误解读表级压缩配置。11. 共享存储支持 NASTDengine 的共享存储shared storage现在支持 NAS。此前共享存储主要面向 S3 兼容对象存储与本地挂载文件系统fs类型通过baseDir指定目录例如ssAccessString fs:baseDir/var/taos/ss。NAS 支持意味着基于 NFS/CIFS 等协议挂载的存储设备也可以作为共享存储使用降低中小规模部署的存储成本。12. taosBenchmark 通过 WebSocket 支持重试压测工具taosBenchmark在通过 WebSocket 协议连接时支持重试机制提升压测在弱网环境下的稳定性。taosBenchmark 相关说明见 taosBenchmark 目录。13. 提升 Kafka 数据接入性能taosX 的Kafka 数据接入性能得到提升Kafka 接入配置详见 Kafka 无代码接入。14. 修复 taosX 未启动时 UI 报 undefined 错误当 taosX 服务未启动时taosExplorer 界面不再出现undefined错误提示交互更友好。缺陷修复Fixes数据接入taosX / taosExplorer / taosAdapter加速 InfluxDB 1.x 查询并修复 OOMtaosX 的 InfluxDB 数据源在查询 1.x 版本数据时显著提速同时修复了可能导致内存溢出OOM的问题非默认密码下创建数据复制报错修复taosExplorer 中当使用非默认密码时创建数据复制任务不再报错不存在的文件导致恢复restore失败修复恢复过程中因文件不存在而反复报 failed to open file 且无法停止的问题varbinary 数据库映射修复taosExplorer 的 transform数据变换环节中 varbinary 数据库类型映射错误被修复Oracle 十进制转换 panic 修复从 Oracle 迁移 decimal 类型数据时不再触发 panicMQTT 采样频率过低导致超时修复 MQTT 获取样本数据在频率过低时的超时问题见 MQTT 无代码接入taosdump 按时间范围导出在 us/ns 精度下报错修复 taosdump 在微秒/纳秒精度下按时间范围导出数据时出错的问题taosdump 源码见 tools/taosdumpCSV 导入含 value 字段报错taosExplorer 导入包含value字段的 CSV 时不再报错多标签字段值相同时级联标签表列表异常修复 taosExplorer 中多标签字段取值相同时级联cascading标签表列表展示错误单字段不同类型导致 taosX 出现空值修复 taosX 在单个字段出现不同类型数据时得到意外 null 值的问题。流计算与查询长查询内存回收竞态崩溃修复修复长时间运行的查询在内存回收过程中因竞态条件race condition导致的崩溃批量创建流任务时偶发 stream task lost修复批量创建流任务时偶发丢失流任务的报错删除流时 Explorer 报 Database not specified修复在 taosExplorer 中删除流时报数据库未指定的错误CALC_NOTIFY_ONLY 选项崩溃修复修复在流计算中使用CALC_NOTIFY_ONLY选项时的崩溃问题。CALC_NOTIFY_ONLY是流计算的重要选项之一含义为仅将计算结果作为通知发送、不写入输出表。根据 流处理语法当未指定该选项时计算结果会写入输出表适用于只需要结果通知、无需持久化结果的场景见 流处理最佳实践常与PRE_FILTER等选项组合使用例如CREATE STREAM ... STREAM_OPTIONS(CALC_NOTIFY_ONLY | PRE_FILTER(col1 0));该选项在 SQL 关键字附录 中亦有登记属于保留关键字。触发器与运维触发器表标签为 null 导致崩溃修复触发器trigger表中标签字段为 null 时导致的崩溃taoskeeper 审计日志字段过长报错修复 taoskeeper 审计日志中client_address字段值过长导致 value too long for column/tag 的错误见 taoskeeper 源码nginx 服务重启导致 Explorer 报错修复 nginx 重启引发的 taosExplorer 异常。升级与验证建议版本匹配3.3.7.5 为维护版本支持滚动升级升级时请同步升级客户端驱动libtaos.so与服务器端重点回归场景结合本版本修复列表建议重点回归以下场景——长查询稳定性、批量创建流任务、CALC_NOTIFY_ONLY 流计算、taosdump 高精度导出、S3 上传与迁移配置项核对若使用共享存储请核对ssAccessString中的verifyPeerhttps 下生效默认 false等参数若使用 taosExplorer可设置EXPLORER_SKIP_REGISTERtrue跳过注册流程。完整的变更清单以 3.3.7.5 Release Notes 为准历史版本可查阅 版本历史索引。【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考