TDengine 集成 Excel通过 ODBC 连接器零代码加载时序数据并制作报表【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine本文介绍如何在 Windows 环境下通过配置 ODBC 数据源让 Excel 直接访问 TDengine 中的标签数据tag 数据、原始时序数据以及按时间聚合后的时序数据并在不编写任何代码的前提下完成报表与仪表盘制作。读完本文你将掌握 TDengine ODBC 驱动与 taosAdapter 的环境准备、DSN 数据源配置、Excel 数据导入全流程以及基于透视表/图表的可视化分析方法。方案概述TDengine 官方提供了针对 Windows 平台的 ODBC 驱动应用如 Excel、PowerBI 等可以通过 ODBC 标准接口本地、远程或经云服务访问 TDengine 数据库。Excel 作为最常用的桌面分析工具借助该 ODBC 驱动即可成为 TDengine 的“零代码 BI 前端”导入标签数据tag 数据如设备型号、区域、所属业务线等静态属性导入原始时序数据如传感器逐条上报的原始采样记录导入时间聚合后的时序数据如按小时/天聚合的均值、最大值、最小值、计数等统计结果。整个流程不需要写一行 SQL 以外的代码实际上连 SQL 都可以交给 Excel 的数据导航器完成非常适合业务人员、运维人员快速做数据探查与图表汇报。需要说明的是TDengine ODBC 驱动源码及 Windows 安装包属于独立发行物不在本仓库源码树中本仓库内的 ODBC 客户端库参考文档 对该驱动的连接方式、参数与版本能力有完整定义本文以该文档与官方集成文档docs/en/13-ecosystem-integrations/03-bi/07-excel.md为准展开说明。环境准备Prerequisites开始前请确认以下环境项均已就绪TDengine 3.3.5.8 及以上版本已安装并正常运行企业版与社区版均可。版本下限要求来自官方集成文档低于该版本时 ODBC 驱动的配套能力可能不完整。taosAdapter 正常运行。Excel 通过 ODBC 驱动访问数据库时WebSocket 连接方式依赖 taosAdapter 暴露的 WebSocket 接口默认端口 6041。taosAdapter 是 TDengine 集群与上层应用之间的桥接/适配组件详细说明与配置方式参见 taosAdapter 参考文档。安装并运行 ExcelMicrosoft 365 / Office 桌面版均可。若未安装请先按微软官方指引完成安装。从 TDengine 官网下载最新版 Windows X64 客户端驱动并安装安装步骤与注意事项参见 安装 ODBC 驱动。根据 ODBC 文档Windows 客户端需先安装 VC 运行库已安装 VS 开发工具可忽略且3.2.1.0 及以上版本客户端包含 TDengine ODBC64 位驱动3.3.3.0 及以上版本客户端包含 TDengine ODBC32/64 位驱动。连接方式选型WebSocket 与 Native配置数据源之前先理解 ODBC 驱动的两种连接类型这直接影响后续 DSN 的填写方式对比项WebSocket 连接推荐Native 连接原生连接访问路径经 taosAdapter 的 WebSocket 接口访问服务器通过 TDengine 客户端驱动库taosnative专有协议直连服务器云服务支持支持云服务必须使用 WebSocket不支持32 位应用支持支持企业版不支持版本兼容性好升级服务端通常无需同步升级客户端要求客户端驱动版本与服务端版本一致性能与 Native 差异不大通常略优传输压缩支持COMPRESSION0/1开关不支持按官方建议绝大多数场景应选用WebSocket连接。另外请注意同一进程内 Native 与 WebSocket 连接不能混用也不允许运行时切换一个进程只能使用一种连接类型创建数据源时即需确定。ODBC 原生连接已被标记为弃用官方计划于2027-01-01停止支持请尽早迁移至 WebSocket 连接迁移说明见 连接方式。配置数据源Configure Data Source下面按官方集成文档的操作流程逐步完成从“创建 DSN”到“Excel 加载数据”的全过程。Step 1打开 ODBC 数据源管理工具在 Windows 开始菜单中搜索并打开ODBC Data Sources (64 bit)管理工具。Excel 桌面版是 64 位应用必须使用与应用程序位数匹配的 ODBC 驱动管理器32 位应用需用 32 位驱动管理器。该工具的基础使用方法与驱动注册细节参见 安装 ODBC 驱动。在User DSN选项卡下通过添加(D)按钮进入“创建数据源”界面选择TDengine驱动点击完成后即进入 ODBC 数据源配置页。其中核心配置项如下配置项是否必填说明DSN必填数据源名称为新建的 ODBC 数据源命名如MyTDengineConnection Type必填连接类型选择WebSocket推荐或NativeURLWebSocket 模式必填ODBC 数据源地址如http://localhost:6041云服务示例https://gw.cloud.tdengine.com?tokenyour_tokenServerNative 模式必填服务器地址如localhost:6030Database可选默认连接的数据库Username可选数据库用户名仅用于连接测试未指定时 TDengine 默认rootPassword可选数据库用户密码仅用于连接测试未指定时默认taosdataCompatible Software可选针对 KingSCADA、Kepware 等工业软件含 ADO的兼容适配通常保持默认值General即可Enable Transport Compression可选仅 WebSocket 连接可用勾选等价于COMPRESSION1控制 WebSocket 传输压缩是否开启配置完成后点击Test Connection测试连通性成功会出现 Successfully connected to URL 提示随后点击OK保存。已配置过的 DSN 可通过配置按钮随时进入修改。DSN 的完整参数含义与两种连接类型的详细差异参见 ODBC 客户端库参考。Step 2在 Excel 中进入“从 ODBC 获取数据”在 Windows 环境下启动 Excel依次选择[数据(Data)] → [获取数据(Get Data)] → [来自其他源(From Other Sources)] → [来自 ODBC(From ODBC)]。Step 3选择已配置的数据源在弹出的窗口中找到[数据源名称(DSN)]下拉列表选中刚才在 ODBC 管理工具中创建的 TDengine 数据源示例中名为MyTDengine点击[确定(OK)]。Step 4输入认证凭据输入 TDengine 的用户名与密码默认用户root、默认密码taosdata完成身份认证。Step 5在导航器中选择表并加载在弹出的[导航器(Navigator)]对话框中勾选需要加载的数据库表可多选右侧会显示数据预览点击[加载(Load)]即完成数据导入。若需要做数据清洗、列类型调整可先点击转换数据(Transform Data)进入 Power Query 编辑器。关于“能加载什么数据”的说明导航器中能看到的数据范围取决于 ODBC 驱动的 BI 模式设置。根据 ODBC 驱动的版本历史ODBC 参考文档自 v1.0.1 起 DSN 支持 BI 模式在 BI 模式下TDengine 数据库不返回系统数据库以及超级表的子表信息从而让 BI 工具含 Excel获得更干净的表清单。如果你的数据组织方式是“一张超级表 大量子表”建议在数据库中预先通过 SQL 视图或聚合查询生成面向报表的普通表视图功能自 ODBC v1.1.0 起受支持再在 Excel 中加载。此外ODBC 驱动已覆盖 TDengine 的常用数据类型映射加载后 Excel 中的列类型将与下列映射保持一致TDengine 类型SQL 类型C 类型TIMESTAMPSQL_TYPE_TIMESTAMPSQL_C_TIMESTAMPINT / INT UNSIGNEDSQL_INTEGERSQL_C_SLONG / SQL_C_ULONGBIGINT / BIGINT UNSIGNEDSQL_BIGINTSQL_C_SBIGINT / SQL_C_UBIGINTFLOAT / DOUBLESQL_REAL / SQL_DOUBLESQL_C_FLOAT / SQL_C_DOUBLESMALLINT / SMALLINT UNSIGNEDSQL_SMALLINTSQL_C_SSHORT / SQL_C_USHORTTINYINT / TINYINT UNSIGNEDSQL_TINYINTSQL_C_STINYINT / SQL_C_UTINYINTBOOLSQL_BITSQL_C_BITBINARY / NCHAR / VARCHARSQL_BINARY / SQL_VARCHARSQL_C_BINARY / SQL_C_CHARJSONSQL_WVARCHARSQL_C_WCHARGEOMETRY / VARBINARYSQL_VARBINARYSQL_C_BINARY完整映射表见 数据类型映射。数据类型映射表为英文官方文档原文未经授权不得用于商业用途此处仅为帮助理解 Excel 中的列类型来源。数据分析用透视表与图表可视化数据加载完成后即可进入分析环节选中导入的数据区域在[插入(Insert)]选项卡中选择柱状图等图表类型在右侧的[数据透视图字段(PivotChart Fields)]窗格中拖拽配置字段将时间戳如ts拖入轴Axis将数值字段拖入值Values将标签字段如tbname、phase拖入图例或筛选区即可快速生成按设备/标签分组的聚合图表。由于 Excel 透视图天然支持字段聚合求和、平均值、计数、最大值、最小值等你可以直接在值字段设置中完成“时间聚合”效果例如按小时/天对原始采样求均值——这正是本文开篇提到的“时间聚合后的时序数据”的常见落地方式。常见问题与排查建议找不到 TDengine 驱动确认安装的是 64 位客户端驱动且打开的是 “ODBC Data Sources (64 bit)” 管理工具驱动位数必须与应用位数匹配。连接测试失败WebSocket 模式检查 taosAdapter 是否在运行且 6041 端口可达Native 模式检查 TDengine 服务端默认 6030 端口与客户端版本是否一致。导航器表清单“不干净”启用 BI 模式ODBC v1.0.1后系统库与超级表子表不再显示请通过视图或物化表组织报表数据。类型显示异常核对 数据类型映射 表确认 TDengine 侧列类型是否符合预期VARBINARY/GEOMETRY 等类型需 ODBC v1.1.0 及以上驱动。小结通过“TDengine 3.3.5.8 taosAdapter Windows X64 ODBC 驱动 Excel”这一组合用户可以零代码完成时序数据的导入、聚合与可视化。本文所述流程对应的官方文档为 docs/en/13-ecosystem-integrations/03-bi/07-excel.mdDSN 配置、连接方式与版本细节可进一步查阅 ODBC 客户端库参考taosAdapter 的安装与启停参见 taosAdapter 参考文档。【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 TDengine 集成 Excel：通过 ODBC 连接器零代码加载时序数据并制作报表
TDengine 集成 Excel通过 ODBC 连接器零代码加载时序数据并制作报表【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine本文介绍如何在 Windows 环境下通过配置 ODBC 数据源让 Excel 直接访问 TDengine 中的标签数据tag 数据、原始时序数据以及按时间聚合后的时序数据并在不编写任何代码的前提下完成报表与仪表盘制作。读完本文你将掌握 TDengine ODBC 驱动与 taosAdapter 的环境准备、DSN 数据源配置、Excel 数据导入全流程以及基于透视表/图表的可视化分析方法。方案概述TDengine 官方提供了针对 Windows 平台的 ODBC 驱动应用如 Excel、PowerBI 等可以通过 ODBC 标准接口本地、远程或经云服务访问 TDengine 数据库。Excel 作为最常用的桌面分析工具借助该 ODBC 驱动即可成为 TDengine 的“零代码 BI 前端”导入标签数据tag 数据如设备型号、区域、所属业务线等静态属性导入原始时序数据如传感器逐条上报的原始采样记录导入时间聚合后的时序数据如按小时/天聚合的均值、最大值、最小值、计数等统计结果。整个流程不需要写一行 SQL 以外的代码实际上连 SQL 都可以交给 Excel 的数据导航器完成非常适合业务人员、运维人员快速做数据探查与图表汇报。需要说明的是TDengine ODBC 驱动源码及 Windows 安装包属于独立发行物不在本仓库源码树中本仓库内的 ODBC 客户端库参考文档 对该驱动的连接方式、参数与版本能力有完整定义本文以该文档与官方集成文档docs/en/13-ecosystem-integrations/03-bi/07-excel.md为准展开说明。环境准备Prerequisites开始前请确认以下环境项均已就绪TDengine 3.3.5.8 及以上版本已安装并正常运行企业版与社区版均可。版本下限要求来自官方集成文档低于该版本时 ODBC 驱动的配套能力可能不完整。taosAdapter 正常运行。Excel 通过 ODBC 驱动访问数据库时WebSocket 连接方式依赖 taosAdapter 暴露的 WebSocket 接口默认端口 6041。taosAdapter 是 TDengine 集群与上层应用之间的桥接/适配组件详细说明与配置方式参见 taosAdapter 参考文档。安装并运行 ExcelMicrosoft 365 / Office 桌面版均可。若未安装请先按微软官方指引完成安装。从 TDengine 官网下载最新版 Windows X64 客户端驱动并安装安装步骤与注意事项参见 安装 ODBC 驱动。根据 ODBC 文档Windows 客户端需先安装 VC 运行库已安装 VS 开发工具可忽略且3.2.1.0 及以上版本客户端包含 TDengine ODBC64 位驱动3.3.3.0 及以上版本客户端包含 TDengine ODBC32/64 位驱动。连接方式选型WebSocket 与 Native配置数据源之前先理解 ODBC 驱动的两种连接类型这直接影响后续 DSN 的填写方式对比项WebSocket 连接推荐Native 连接原生连接访问路径经 taosAdapter 的 WebSocket 接口访问服务器通过 TDengine 客户端驱动库taosnative专有协议直连服务器云服务支持支持云服务必须使用 WebSocket不支持32 位应用支持支持企业版不支持版本兼容性好升级服务端通常无需同步升级客户端要求客户端驱动版本与服务端版本一致性能与 Native 差异不大通常略优传输压缩支持COMPRESSION0/1开关不支持按官方建议绝大多数场景应选用WebSocket连接。另外请注意同一进程内 Native 与 WebSocket 连接不能混用也不允许运行时切换一个进程只能使用一种连接类型创建数据源时即需确定。ODBC 原生连接已被标记为弃用官方计划于2027-01-01停止支持请尽早迁移至 WebSocket 连接迁移说明见 连接方式。配置数据源Configure Data Source下面按官方集成文档的操作流程逐步完成从“创建 DSN”到“Excel 加载数据”的全过程。Step 1打开 ODBC 数据源管理工具在 Windows 开始菜单中搜索并打开ODBC Data Sources (64 bit)管理工具。Excel 桌面版是 64 位应用必须使用与应用程序位数匹配的 ODBC 驱动管理器32 位应用需用 32 位驱动管理器。该工具的基础使用方法与驱动注册细节参见 安装 ODBC 驱动。在User DSN选项卡下通过添加(D)按钮进入“创建数据源”界面选择TDengine驱动点击完成后即进入 ODBC 数据源配置页。其中核心配置项如下配置项是否必填说明DSN必填数据源名称为新建的 ODBC 数据源命名如MyTDengineConnection Type必填连接类型选择WebSocket推荐或NativeURLWebSocket 模式必填ODBC 数据源地址如http://localhost:6041云服务示例https://gw.cloud.tdengine.com?tokenyour_tokenServerNative 模式必填服务器地址如localhost:6030Database可选默认连接的数据库Username可选数据库用户名仅用于连接测试未指定时 TDengine 默认rootPassword可选数据库用户密码仅用于连接测试未指定时默认taosdataCompatible Software可选针对 KingSCADA、Kepware 等工业软件含 ADO的兼容适配通常保持默认值General即可Enable Transport Compression可选仅 WebSocket 连接可用勾选等价于COMPRESSION1控制 WebSocket 传输压缩是否开启配置完成后点击Test Connection测试连通性成功会出现 Successfully connected to URL 提示随后点击OK保存。已配置过的 DSN 可通过配置按钮随时进入修改。DSN 的完整参数含义与两种连接类型的详细差异参见 ODBC 客户端库参考。Step 2在 Excel 中进入“从 ODBC 获取数据”在 Windows 环境下启动 Excel依次选择[数据(Data)] → [获取数据(Get Data)] → [来自其他源(From Other Sources)] → [来自 ODBC(From ODBC)]。Step 3选择已配置的数据源在弹出的窗口中找到[数据源名称(DSN)]下拉列表选中刚才在 ODBC 管理工具中创建的 TDengine 数据源示例中名为MyTDengine点击[确定(OK)]。Step 4输入认证凭据输入 TDengine 的用户名与密码默认用户root、默认密码taosdata完成身份认证。Step 5在导航器中选择表并加载在弹出的[导航器(Navigator)]对话框中勾选需要加载的数据库表可多选右侧会显示数据预览点击[加载(Load)]即完成数据导入。若需要做数据清洗、列类型调整可先点击转换数据(Transform Data)进入 Power Query 编辑器。关于“能加载什么数据”的说明导航器中能看到的数据范围取决于 ODBC 驱动的 BI 模式设置。根据 ODBC 驱动的版本历史ODBC 参考文档自 v1.0.1 起 DSN 支持 BI 模式在 BI 模式下TDengine 数据库不返回系统数据库以及超级表的子表信息从而让 BI 工具含 Excel获得更干净的表清单。如果你的数据组织方式是“一张超级表 大量子表”建议在数据库中预先通过 SQL 视图或聚合查询生成面向报表的普通表视图功能自 ODBC v1.1.0 起受支持再在 Excel 中加载。此外ODBC 驱动已覆盖 TDengine 的常用数据类型映射加载后 Excel 中的列类型将与下列映射保持一致TDengine 类型SQL 类型C 类型TIMESTAMPSQL_TYPE_TIMESTAMPSQL_C_TIMESTAMPINT / INT UNSIGNEDSQL_INTEGERSQL_C_SLONG / SQL_C_ULONGBIGINT / BIGINT UNSIGNEDSQL_BIGINTSQL_C_SBIGINT / SQL_C_UBIGINTFLOAT / DOUBLESQL_REAL / SQL_DOUBLESQL_C_FLOAT / SQL_C_DOUBLESMALLINT / SMALLINT UNSIGNEDSQL_SMALLINTSQL_C_SSHORT / SQL_C_USHORTTINYINT / TINYINT UNSIGNEDSQL_TINYINTSQL_C_STINYINT / SQL_C_UTINYINTBOOLSQL_BITSQL_C_BITBINARY / NCHAR / VARCHARSQL_BINARY / SQL_VARCHARSQL_C_BINARY / SQL_C_CHARJSONSQL_WVARCHARSQL_C_WCHARGEOMETRY / VARBINARYSQL_VARBINARYSQL_C_BINARY完整映射表见 数据类型映射。数据类型映射表为英文官方文档原文未经授权不得用于商业用途此处仅为帮助理解 Excel 中的列类型来源。数据分析用透视表与图表可视化数据加载完成后即可进入分析环节选中导入的数据区域在[插入(Insert)]选项卡中选择柱状图等图表类型在右侧的[数据透视图字段(PivotChart Fields)]窗格中拖拽配置字段将时间戳如ts拖入轴Axis将数值字段拖入值Values将标签字段如tbname、phase拖入图例或筛选区即可快速生成按设备/标签分组的聚合图表。由于 Excel 透视图天然支持字段聚合求和、平均值、计数、最大值、最小值等你可以直接在值字段设置中完成“时间聚合”效果例如按小时/天对原始采样求均值——这正是本文开篇提到的“时间聚合后的时序数据”的常见落地方式。常见问题与排查建议找不到 TDengine 驱动确认安装的是 64 位客户端驱动且打开的是 “ODBC Data Sources (64 bit)” 管理工具驱动位数必须与应用位数匹配。连接测试失败WebSocket 模式检查 taosAdapter 是否在运行且 6041 端口可达Native 模式检查 TDengine 服务端默认 6030 端口与客户端版本是否一致。导航器表清单“不干净”启用 BI 模式ODBC v1.0.1后系统库与超级表子表不再显示请通过视图或物化表组织报表数据。类型显示异常核对 数据类型映射 表确认 TDengine 侧列类型是否符合预期VARBINARY/GEOMETRY 等类型需 ODBC v1.1.0 及以上驱动。小结通过“TDengine 3.3.5.8 taosAdapter Windows X64 ODBC 驱动 Excel”这一组合用户可以零代码完成时序数据的导入、聚合与可视化。本文所述流程对应的官方文档为 docs/en/13-ecosystem-integrations/03-bi/07-excel.mdDSN 配置、连接方式与版本细节可进一步查阅 ODBC 客户端库参考taosAdapter 的安装与启停参见 taosAdapter 参考文档。【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考