与 Superset 集成
Apache Superset 是一个现代的企业级商业智能（BI）Web 应用程序，主要用于数据探索和可视化。它由 Apache 软件基金会支持，是一个开源项目，它拥有活跃的社区和丰富的生态系统。Apache Superset 提供了直观的用户界面，使得创建、分享和可视化数据变得简单，同时支持多种数据源和丰富的可视化选项。
通过 TDengine 的 Python 连接器, Apache Superset 可支持 TDengine 数据源并提供数据展现、分析等功能。
前置条件
准备以下环境：
- TDengine 3.2.3.0 及以上版本集群已部署并正常运行（企业及社区版均可）。
- taosAdapter 能够正常运行，详细参考 taosAdapter 使用手册。
- Apache Superset v2.1.0 或以上版本已安装，安装 Apache Superset 请参考 官方文档。
- 安装 Python 连接器驱动，详细参考 TDengine Python Connector。
TDengine Python 连接器从 v2.1.18 起带 Superset 连接驱动，会安装至 Superset 相应目录下并向 Superset 提供数据源服务。
配置数据源
第 1 步，进入新建数据库连接页面【Superset】 -> 【Setting】->【Database Connections ->【+DATABASE】。
第 2 步，选择 TDengine 数据库连接。【SUPPORTED DATABASES】下拉列表中选择 TDengine 项。
注意：若下拉列表中无 TDengine 项，请检查安装顺序，确保 TDengine Python 连接器 在 Superset 安装之后再安装。
第 3 步，【DISPLAY NAME】中填写连接名称，任意填写即可。
第 4 步，【SQLALCHEMY URL】项为关键连接信息串，务必填写正确。
taosws://用户名:密码@主机名:端口号
| 参数名称 | |
|---|---|
| 用户名 | 登录 TDengine 数据库用户名 |
| 密码 | 登录 TDengine 数据库密码 |
| 主机名 | TDengine 数据库所在主机名称 |
| 端口号 | 提供 WebSocket 服务的端口，默认：6041 |
示例：
本机安装 TDengine 数据库，WebSocket 服务端口 6041，使用默认用户名密码，SQLALCHEMY URL 应为：
taosws://root:taosdata@localhost:6041
第 5 步，配置好连接串，点击【TEST CONNECTION】测试连接是否成功，测试通过后点击【CONNECT】按钮，完成连接。
数据分析
数据准备
TDengine 数据源与其它数据源使用上无差别，这里简单介绍下数据查询：
Superset界面点击右上角【+】号按钮，选择SQL query, 进入查询界面。- 左上角【DATABASE】下拉列表中选择前面已创建好的
TDengine数据源。 - 【SCHEMA】下拉列表，选择要操作的数据库名（系统库不显示）。
- 【SEE TABLE SCHEMA】选择要操作的超级表名或普通表名（子表不显示）。
- 随后会在下方显示选定表的
SCHEMA信息。 - 在
SQL编辑器区域可输入符合TDengine语法的任意SQL语句执行。
智能电表样例
我们选择【Superset Chart】模板中较流行的两个模板做了效果展示，以智能电表数据为例：
Aggregate类型，展示在第 4 组中指定时间段内每分钟采集电压值(voltage)最大值。
RAW RECORDS类型，展示在第 4 组中指定时间段内 current, voltage 的采集值。
