TDengine 集成 Looker Studio：通过合作伙伴连接器构建时序数据可视化报表

TDengine 集成 Looker Studio通过合作伙伴连接器构建时序数据可视化报表【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengineTDengine 的 Looker Studio 连接器已作为合作伙伴连接器partner connector上线使时序数据库的数据能够直接进入 Google 旗下的报表与商业智能BI平台。本文介绍如何获取并配置该连接器连接 TDengine TSDB Cloud 或自部署的 TDengine Server 数据源并基于超级表supertable字段与标签完成可视化配置同时结合 TDengine 仓库中的 REST API 与 taosAdapter 文档剖析外部 BI 工具访问 TDengine 所依赖的 HTTP 接口、鉴权方式与返回结构帮助读者理解连接器自动加载字段和标签背后的机制。读完后你将掌握从数据源配置、权限授权到图表配置的全流程并能对接口层问题进行排查。Looker Studio 是什么Looker Studio 是 Google 旗下的功能强大的报表和商业智能工具前身名为 Google Data Studio于 2022 年的 Google Cloud Next 大会上被正式更名为 Looker Studio。它提供丰富的数据可视化选项和多样化的数据连接能力用户可以根据预设模板快速创建数据报表满足各种数据分析需求。由于其简单易用的操作界面和庞大的生态系统Looker Studio 受到众多数据科学家和分析师的青睐无论是初学者还是资深分析师都可以利用它快速构建美观且实用的数据报表从而更好地洞察业务趋势、优化决策过程并提升整体运营效率。对 TDengine 用户而言其价值在于时间序列数据的采集、存储和计算在 TDengine 中完成而报表呈现与交互分析交给 Looker Studio两者各司其职。获取 TDengine 连接器TDengine 连接器目前作为 Looker Studio 的合作伙伴连接器已在 Looker Studio 官网上线。在 Looker Studio 的 Data Source 列表中只须输入“TDengine”进行搜索即可找到并直接使用该连接器无需自行开发或安装第三方插件。该连接器兼容两类数据源TDengine TSDB Cloud涛思数据推出的全托管物联网和工业互联网大数据云服务平台提供一站式数据存储、处理和分析解决方案TDengine TSDB Server用户自行部署的本地版本支持通过公网访问。下文以 TDengine TSDB Cloud 为例介绍配置过程自部署 Server 版本的配置逻辑一致只是 URL 与 Token 的获取位置不同。使用步骤第 1 步选择数据源类型并填写连接信息进入 TDengine 连接器详情页面后在 Data Source 下拉列表中选择TDengine TSDB Cloud点击Next按钮进入数据源配置页面。需要填写以下信息然后点击Connect按钮配置项说明URL数据源访问地址可从 TDengine TSDB Cloud 的实例列表中获取TokenTDengine TSDB Cloud 的访问令牌同样从实例列表获取数据库名称要查询的数据库database超级表名称数据库下的超级表supertable查询开始/结束时间本次报表数据的时间范围第 2 步自动加载字段与标签Looker Studio 会根据上述配置自动加载所配置 TDengine 数据库下超级表的字段列和标签tag。这一步对使用者来说是无感的界面里会直接出现可用于维度、指标和过滤器的字段列表。从仓库文档看这一行为的底层依托是 TDengine 的 RESTful 接口。TDengine 的 REST API 由 taosAdapter 组件提供外部工具以 HTTP 请求直接携带 SQL 语句操作数据库接口路径形如http://fqdn:port/rest/sql/[db_name][?tztimezone[req_idreq_id][row_with_metatrue]]其中port对应配置文件中的httpPort配置项缺省为 6041db_name可指定本次 SQL 的默认数据库。查询成功时HTTP body 返回column_meta列名、类型、长度的三元组数组、data数据行和rows行数三部分结构详见 REST API 文档。可以推断连接器的加载字段和标签正是解析这类列元信息后映射到 Looker Studio 的字段模型而请求中的db_name/?tz参数则对应上表中的数据库名称与查询时间范围两项配置。第 3 步Explore 查看加载的数据点击页面右上角的Explore按钮即可查看从 TDengine 数据库中加载的数据。此页面用于确认字段类型、预览数据分布并设置数据源级别的过滤条件。第 4 步配置数据可视化根据需求利用 Looker Studio 提供的图表组件进行数据可视化配置。对时序场景常用的组合是以时间列ts为横轴维度以测点值或聚合结果如AVG、COUNT为指标将超级表的 tag 列用作分组维度即可生成按设备/端点拆分的时序趋势图。注意第一次使用时请根据页面提示对 Looker Studio 的 TDengine 连接器进行访问授权。未授权前连接器无法读取元数据这是首次配置时最常见的卡点。连接器与 TDengine HTTP 接口鉴权与请求细节BI 类工具通常无法使用数据库私有 TCP 协议而是经由 HTTP 通道访问数据。理解 TDengine 的 REST API 请求约定有助于排查连接器配置失败、字段缺失、时区偏差等问题。以下内容均出自 REST API 参考文档与连接器实际走的接口通道一致。身份认证HTTP 请求的 Header 中需携带身份认证信息TDengine 支持三种机制这解释了为什么 Looker Studio 配置页只需URL Token两项Authorization: Taosd TOKEN # 自定义授权码 Authorization: Basic TOKEN # Basic 认证TOKEN 为 {username}:{password} 的 Base64 Authorization: Bearer TOKEN # Token 认证例如默认账号密码root:taosdata经 Base64 编码后为cm9vdDp0YW9zZGF0YQ。用curl验证接口是否可用的最小示例将地址与端口替换为实际服务curl -L -H Authorization: Basic cm9vdDp0YW9zZGF0YQ \ -d select name, ntables, status from information_schema.ins_databases; \ h1.taosdata.com:6041/rest/sql返回code: 0即表示认证与接口均正常这可以用作连接器故障时绕过 Looker Studio 直接验证数据源的手段。无状态接口的约束表名必须带库前缀RESTful 接口是无状态的因此USE db_name指令没有效果所有对表名、超级表名的引用都需要指定数据库名前缀或在 URL 中指定db_name。从源码结构看HTTP 模块只是一个简单的转发层没有当前数据库的概念。这一点对使用连接器有直接含义——如果超级表名配置正确却查不到数据应优先确认超级表确实属于所选数据库而不是怀疑连接本身。时区与时间范围URL 中的tz参数遵循 IANA Time Zone 规则如America/New_York控制返回时间的时区data中的时间统一以 RFC3339 格式返回未指定tz时按 0 时区输出。配置 Looker Studio 的查询开始/结束时间后若报表时间与本地时区不符可核对数据源 URL 中是否带有时区参数。响应结构与错误排查成功响应形如{ code: 0, column_meta: [[ts, TIMESTAMP, 8], [count, BIGINT, 8]], data: [[2022-06-29T05:50:55.401Z, 2]], rows: 1 }失败响应只含code错误码与desc错误描述两个字段。默认情况下 C 接口调用出错时 HTTP 响应码仍为 200、错误信息在 body 中自v3.0.3.0起可通过taosAdapter的httpCodeServerError参数改为返回非 200 响应码400/401/500/502/503 等具体映射见 REST API 文档中的HTTP 响应码一节。若连接器报鉴权错误对应底层错误码为 401 一类如TSDB_CODE_MND_AUTH_FAILURE应先回到Token 是否过期/复制完整上排查。小结TDengine 以 Looker Studio 合作伙伴连接器的形式接入 Google BI 生态在 Data Source 列表搜索 TDengine 即可使用兼容 TSDB Cloud 与自部署 TSDB Server。配置流程为四步选择数据源类型并填写 URL/Token/数据库/超级表/时间范围 → 自动加载超级表字段与标签 → Explore 预览数据 → 配置图表可视化首次使用务必按提示完成授权。连接器底层依托 taosAdapter 提供的 RESTful 接口请求路径为/rest/sql/[db_name]默认端口 6041支持 Basic/Token 三种鉴权表名需带库前缀响应以column_meta/data/rows结构返回——掌握这些约定可以直接用curl独立验证数据源、定位连接与鉴权问题。更多 BI 与数据分析工具的集成方式Power BI、Tableau、Superset、Excel 等可参见 与数据分析类工具的集成 章节。【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考