?Apache Superset? 是一個現代的企業級商業智能（BI）Web 應用程序，主要用于數據探索和可視化。它由 Apache 軟件基金會支持，是一個開源項目，它擁有活躍的社區和豐富的生態系統。Apache Superset 提供了直觀的用戶界面，使得創建、分享和可視化數據變得簡單，同時支持多種數據源和豐富的可視化選項?。

通過 TDengine 的 Python 連接器, ?Apache ?Superset? 可支持 TDengine 數據源并提供數據展現、分析等功能

前置條件

準備以下環境：

• TDengine 集群已部署并正常運行（企業及社區版均可）
• taosAdapter 能夠正常運行。詳細參考 taosAdapter 使用手冊
• Apache Superset v2.1.0 或以上版本已安裝。安裝 Apache Superset 請參考 官方文檔

安裝 TDengine Python 連接器

TDengine Python 連接器從 v2.1.18 起帶 Superset 連接驅動，會安裝至 Superset 相應目錄下并向 Superset 提供數據源服務
Superset 與 TDengine 之間使用 WebSocket 協議連接，需安裝支持此協議的 taos-ws-py 組件, 全部安裝腳本如下：

pip3 install taospy
pip3 install taos-ws-py

配置 TDengine 數據源

第 1 步，進入新建數據庫連接頁面 “Superset” → “Setting” → “Database Connections” → “+DATABASE”
第 2 步，選擇 TDengine 數據庫連接。“SUPPORTED DATABASES” 下拉列表中選擇 “TDengine” 項。
:::tip
注意：若下拉列表中無 “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 數據源與其它數據源使用上無差別，這里簡單介紹下數據查詢：

1. Superset 界面點擊右上角 “+” 號按鈕，選擇 “SQL query”, 進入查詢界面
2. 左上角 “DATABASE” 下拉列表中選擇前面已創建好的 “TDengine” 數據源
3. “SCHEMA” 下拉列表，選擇要操作的數據庫名（系統庫不顯示）
4. “SEE TABLE SCHEMA” 選擇要操作的超級表名或普通表名（子表不顯示）
5. 隨后會在下方顯示選定表的 SCHEMA 信息
6. 在 SQL 編輯器區域可輸入符合 TDengine 語法的任意 SQL 語句執行

示例效果

我們選擇 Superset Chart 模板中較流行的兩個模板做了效果展示，以智能電表數據為例：

1. “Aggregate” 類型，展示在第 4 組中指定時間段內每分鐘采集電壓值(voltage)最大值

2. “RAW RECORDS” 類型，展示在第 4 組中指定時間段內 current, voltage 的采集值