使用 TDengine ODBC Connector 将时序数据接入 Tableau从数据源配置到可视化看板【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine本文是一份面向 BI 分析人员的完整集成指南在不编写任何代码的前提下通过 TDengine 官方 ODBC Connector将 TDengine 中的标签Tag数据、原始时序数据以及经时间聚合后的时序数据导入 Tableau Desktop制作报表与仪表盘。读完本文你将掌握 Windows 环境下 TDengine ODBC 数据源的完整配置步骤、Tableau 中的连接与取数流程以及 WebSocket/Native 两种连接方式的选型要点与底层原理。前置条件在开始集成之前需要准备如下环境TDengine 集群安装v3.3.5.8及以上版本并正常运行企业版与社区版均可。taosAdapter必须正常运行。Tableau 通过 ODBC Connector 访问 TDengine 时WebSocket 连接方式需要经由 taosAdapter 的 WebSocket 接口默认端口6041与数据库交互其详细原理与配置参见 taosAdapter 参考手册。Tableau Desktop在 Windows 操作系统上安装并运行 64 位桌面版安装包可从 Tableau 官网下载安装步骤参考 Tableau 官方文档。TDengine Windows X64 客户端驱动从 TDengine 官网下载最新 Windows X64 客户端驱动并安装。根据 ODBC 客户端库 的说明Windows 客户端3.2.1.0及以上版本已内置 TDengine ODBC 64 位驱动3.3.3.0及以上版本内置 ODBC 32/64 位驱动安装前需确保系统已安装 VC 运行时库已安装 VS 开发工具的环境可忽略。由于 Tableau Desktop 运行于 Windows本集成方案要求 TDengine ODBC 客户端驱动与 Tableau 均部署在同一台 Windows 机器上TDengine 服务端既可位于本机也可位于远端或云端云端访问必须使用 WebSocket 连接。理解 TDengine ODBC 连接器在动手配置前先了解底层连接器的工作机制有助于你做出正确的连接类型选择。TDengine ODBC 是面向 Windows 平台以及支持 ODBC 的其他平台实现的 ODBC 驱动使 PowerBI、Tableau 等标准 ODBC 客户端可以经由 ODBC 标准接口访问 TDengine 数据库。它提供两种连接方式对比项WebSocket 连接Native 连接访问路径经 taosAdapter 的 WebSocket 接口默认6041端口通过 TDengine 客户端驱动taosnative库专有协议直达服务端默认6030端口性能与 Native 差距不大绝大多数场景推荐通常略优但要求客户端驱动版本与服务端版本严格一致兼容性更好服务端升级一般无需同步升级客户端较差版本不匹配会连接失败云端访问支持不支持32 位应用支持企业版不支持传输压缩支持COMPRESSION0/1开关不支持从源码结构看TDengine 的语言连接器普遍通过 taosAdapter 的 WebSocket 接口与数据库通信ODBC 驱动中的 WebSocket 连接方式遵循同一路径因此集成场景中 taosAdapter 必须处于运行状态。需要特别留意两点Native 连接即将弃用ODBC 官方文档明确标注 Native 连接已进入弃用流程将于2027-01-01停止支持请优先迁移到 WebSocket 连接。两种连接不可混用同一个进程内不能同时使用 Native 与 WebSocket 两种连接运行时也不允许切换单个进程只能选择一种连接类型。请在创建数据源时确定所需的连接方式。配置 ODBC 数据源本步骤的目标是在 Windows 系统中创建一个指向 TDengine 的 ODBC 数据源DSN供 Tableau 后续直接调用。详细配置说明可参考 配置 ODBC 数据源。第 1 步打开 ODBC 管理工具并创建数据源在 Windows 操作系统开始菜单中搜索并打开ODBC 数据源 (64 位)管理工具注意不要选择 32 位版本除非应用明确为 32 位且使用企业版。切换到用户 DSN选项卡点击添加按钮在驱动列表中选择TDengine点击完成后进入 TDengine ODBC 数据源配置页面。以推荐的 WebSocket 连接为例需要填写以下配置项配置项是否必填说明DSN必填数据源名称为新建的 ODBC 数据源命名例如MyTDengineConnection Type必填连接类型此处选择WebSocketURL必填ODBC 数据源地址本地示例http://localhost:6041云端示例https://gw.cloud.tdengine.com?tokenyour_tokenDatabase视场景而定默认连接的数据库。为 Tableau 配置时此项为必填需选择一个可成功连接的数据库见下方提示Username可选数据库用户名仅在步骤 5 连接测试时使用不填默认rootPassword可选数据库用户密码仅在步骤 5 连接测试时使用不填默认taosdataCompatible Software可选针对 KingSCADA、Kepware 等工业软件的兼容适配含 ADO 支持一般场景保持默认值 General 即可Enable Transport Compression可选仅 WebSocket 连接可用勾选等价于COMPRESSION1控制 WebSocket 传输压缩开关若选择Native连接方式则 URL 配置项替换为Server必填示例localhost:6030其余字段含义一致但该方式不支持云端访问和 32 位应用。填写完成后点击测试连接验证连通性WebSocket 方式成功时提示 Successfully connected to URLNative 方式成功时提示 Connection successful。最后点击确定保存配置并退出。重要提示为 Tableau 配置 ODBC 数据源时TDengine ODBC 数据源配置页面中的【数据库】配置项为必填必须选择一个能够成功连接的数据库否则 Tableau 侧无法正常完成登录与取数。第 2 步在 Tableau 中创建 ODBC 连接在 Windows 环境下启动 Tableau在其连接页面中搜索 ODBC选择其他数据库 (ODBC)。第 3 步选择 DSN 并登录点击DSN单选框选择第 1 步配置好的数据源如MyTDengine点击连接按钮。连接成功后删除字符串附加部分的内容即 URL 中自动追加的查询参数等附加串最后点击登录按钮即可完成连接。数据分析从取数到可视化完成数据源连接后即可在 Tableau 工作簿中浏览 TDengine 数据并构建图表。整个过程全部通过鼠标拖拽完成无需编写任何 SQL 或代码。第 1 步选择数据库与表进入工作簿页面后页面会显示已连接的数据源。点击数据库的下拉列表选择需要进行数据分析的数据库随后点击表选项中的查找按钮将该数据库下的所有表包括普通表与超级表显示出来。将需要分析的表拖拽到右侧区域即可查看表结构字段名与类型。第 2 步更新并预览数据点击下方的立即更新按钮即可将表中的数据实际拉取并展示出来。此时可以直观验证导入的数据是否正确包括时间戳、标签列与数值列的内容。第 3 步创建工作表与图表点击窗口下方的工作表弹出数据分析窗口窗口会展示分析表的全部字段时间戳、标签与测量值。将字段拖拽到行Rows与列Columns区域即可生成对应图表再配合 Tableau 的筛选器、聚合与标记功能即可制作完整的报表或仪表盘。在 Tableau 工作表中拖拽字段生成可视化图表数据分析场景建议结合 TDengine 的数据模型通过 ODBC 接入 Tableau 后可以支撑三类典型分析标签Tag数据分析将超级表子表的标签字段作为维度用于设备分组、筛选与对比。原始时序数据分析直接以TIMESTAMP为时间维度、以原始采集值为度量绘制原始曲线。时间聚合数据分析利用 TDengine 的INTERVAL时间窗口聚合能力如按小时/天计算avg、sum、max、min先在数据库中完成降采样再将聚合结果导入 Tableau可显著降低数据传输量与前端渲染压力。数据类型映射ODBC 连接器会将 TDengine 服务端的数据类型映射为标准的 SQL/C 类型确保 Tableau 正确识别字段语义。以下为关键映射关系完整映射见 ODBC 数据类型的映射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_DOUBLEBINARY / VARCHARSQL_VARCHARSQL_C_CHARNCHARSQL_VARCHARSQL_C_CHARJSONSQL_WVARCHARSQL_C_WCHARGEOMETRY / VARBINARYSQL_VARBINARYSQL_C_BINARYBOOLSQL_BITSQL_C_BIT从版本演进看ODBC 驱动在v1.1.0起支持 VARBINARY/GEOMETRY 数据类型与视图功能v1.1.1起支持 ADO 访问 ODBC 32/64 位接口这些能力在 BI 场景中均有实际用途。常见问题与注意事项连接失败提示无法登录优先检查 taosAdapter 是否在运行、URL 端口是否正确WebSocket 为6041以及【数据库】配置项是否已填写可连接的库名。驱动版本不匹配若使用 Native 连接客户端驱动版本必须与 TDengine 服务端版本一致升级服务端后如遇连接异常请同步升级 Windows 客户端。32 位/64 位架构匹配ODBC 驱动管理器位数需与应用的位数一致64 位应用使用 64 位驱动管理器DSN 在 32/64 位管理器下共享同一名称建议在 DSN 命名上加以区分。BI 模式从 ODBC 驱动v1.0.1起支持 DSN 的 BI 模式设置该模式下 TDengine 不再返回系统数据库及超级表子表信息界面更清爽适合 Tableau 等 BI 工具的元数据浏览场景。连接类型选定后不可切换Native 与 WebSocket 无法在同一进程混用请按 Tableau 所在机器的网络环境与服务端部署位置在创建数据源时一次性确定。按照上述流程即可在数分钟内完成 TDengine 到 Tableau 的无代码集成将工业物联网场景下的时序数据转化为可交互的分析看板。更深入的 ODBC 驱动 API 能力如SQLTables、SQLColumns、SQLFetchScroll等标准接口支持矩阵可继续阅读 ODBC 客户端库参考。【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考