使用Superset查询和可视化数据

使用Apache Superset查询和可视化存储在InfluxDB数据库中的数据。

Apache Superset是一个现代的企业级商业智能Web应用程序。它快速、轻量级、直观，并包含许多选项，使所有技能级别的用户都能轻松探索和可视化他们的数据，从简单的饼图到高度详细的deck.gl地理空间图表。

– Apache Superset文档

• 设置Superset和Flight SQL的Docker
  • 安装Superset和Flight SQL的先决条件
  • 设置Superset的Docker
• 启动Superset的Docker容器
• 登录到Superset
• 为InfluxDB创建数据库连接
• 使用Superset查询InfluxDB
• 使用Superset构建可视化

设置Superset和Flight SQL的Docker

安装Superset和Flight SQL的先决条件

我们建议使用Docker和docker-compose来运行Superset。要将Superset设置为在Docker容器中运行并使用Flight SQL，请按照以下步骤操作

1. 按照系统说明下载并安装Docker和docker-compose。

   • macOS: 安装Docker for macOS
   • Linux: 安装Docker for Linux

2. 按照系统Python.org下载Python说明。

3. 安装Python后，请检查您是否可以运行Python和Pip。根据您的系统，您可能需要使用Python版本3的命令（python3和pip3）。在终端中输入以下命令

   python python3

   python --version
   

   pip --version
   

   python3 --version
   

   pip3 --version
   

   如果 neither pip nor pip3 工作正常，请遵循 Pypa.io Pip 安装方法之一，适用于您的系统。

4. 使用 Pip 安装 flightsql-dbapi 库。

   pip pip3

   pip install flightsql-dbapi
   

   pip3 install flightsql-dbapi
   

   Python 的 flightsql-dbapi 库提供了 DB API 2 接口和 SQLAlchemy 适配器，用于 Flight SQL。稍后，您将向 Superset 的 Docker 配置中添加 flightsql-dbapi。

   flightsql-dbapi 库是实验性的，并且正在积极开发中。它提供的 API 可能随时更改。

5. 使用 Git 克隆 Apache Superset 仓库

   git clone https://github.com/apache/superset.git
   

   该仓库包含在 Docker 容器中运行 Superset 的代码和配置文件。

设置Superset的Docker

1. 切换到您的 superset 仓库目录

   cd ./superset
   

2. 在您的文本编辑器或终端中，创建文件 ./docker/requirements-local.txt 并追加行 flightsql-dbapi，例如

   cat <<EOF >./docker/requirements-local.txt
   flightsql-dbapi
   EOF
   

   ./docker/requirements-local.txt 文件用于指定 Docker 应为 Superset 包含的附加 Python 包。有关 Superset 的 Docker 配置的更多信息，请参阅 使用 Docker 开始使用 Superset。

3. 使用 docker-compose pull 命令检索 Docker 容器的依赖项。

   docker-compose -f docker-compose-non-dev.yml pull
   

   此过程可能需要几秒钟才能完成。完成后，您即可 启动 Superset Docker 容器。

启动Superset的Docker容器

要启动容器并运行 Superset，请输入 docker-compose up 命令并传递带有设置文件名称的 -f 标志

docker-compose -f docker-compose-non-dev.yml up

这可能需要几秒钟才能完成。

如果成功，终端将包含类似以下内容的输出

superset_init         | Init Step 4/4 [Complete] -- Loading examples
superset_init         | 
superset_init         | 
superset_init         | ######################################################################
superset_init         | 
superset_init exited with code 0
superset_app          | 127.0.0.1 - - [24/Mar/2023:15:14:11 +0000] "GET /health HTTP/1.1" 200 2 "-" "curl/7.74.0"

Superset 运行后，您即可 登录 并设置数据库连接。

登录到Superset

1. 在浏览器中，访问 localhost:8088 以登录到 Superset 用户界面 (UI)。如果您已将 Superset 配置为使用自定义域名，请导航到您的自定义域名。

2. 如果您是第一次登录到 Superset，请使用以下用户名和密码

   • 用户名: admin
   • 密码: admin

3. 可选：创建一个新的管理员用户并使用唯一的密码。

   1. 在 Superset UI 中，单击右上角的 设置 并选择 用户列表。
   2. 单击右上角的 。
   3. 选择 管理员 角色，并为新用户提供剩余的凭据。
   4. 单击 保存。
   5. 删除默认的 admin 用户。

为InfluxDB创建数据库连接

1. 在 Superset UI 中，单击右上角的 设置 并选择 数据库连接。

2. 单击右上角的 + 数据库。

3. 在 连接数据库 窗口中，单击 支持的数据库 下拉菜单并选择 其他。

   

4. 为数据库连接输入一个 显示名称（例如，InfluxDB 集群）。

5. 输入以下内容的 SQL Alchemy URI

   • 协议: datafusion+flightsql
   • 域名: InfluxDB 集群 URL
   • 端口: 443

   查询参数

   • ?database: URL 编码的 InfluxDB 数据库名称
   • ?token: 具有指定数据库 READ 访问权限的 InfluxDB API 令牌

   # Syntax
   datafusion+flightsql://<domain>:<port>?database=<database-name>&token=<token>
   
   # Example
   datafusion+flightsql://cluster-host.com:443?database=example-database&token=example-token
   

6. 单击 测试连接 以确保连接有效。

7. 单击 连接 以保存数据库连接。

使用Superset查询InfluxDB

建立了与InfluxDB 集群版的连接后，您可以开始查询和可视化InfluxDB中的数据。

1. 在Superset UI中，点击顶部导航栏中的SQL ▾，然后选择SQL实验室。

2. 在左侧面板

   1. 在数据库下，选择您的InfluxDB连接。
   2. 在模式下，选择iox。
   3. 在查看表模式下，选择要查询的InfluxDB度量。

   度量模式会显示在左侧面板中

   

3. 使用查询编辑器编写一个查询您InfluxDB数据库中数据的SQL查询。

4. 点击运行以执行查询。

查询结果会显示在查询编辑器下方。

使用Superset构建可视化

使用Superset为InfluxDB查询创建可视化和仪表板。有关使用Superset创建可视化的全面教程，请参阅Superset中创建图表和仪表板文档。