Superset

Superset 是一个快速、轻量级、直观的工具，并且提供了丰富的选项，使得各种技能水平的用户都能轻松探索和可视化他们的数据，从简单的折线图到高度详细的地理空间图。

Databend 通过两个 Python 库与 Superset 集成：databend-py 和 databend-sqlalchemy。要实现这种集成，您需要基于官方的 Superset Docker 镜像构建一个自定义的 Docker 镜像，并包含这两个库。databend-py 作为 Databend 的 Python 客户端库，允许 Superset 与 Databend 服务器通信，通过其 API 执行查询并检索结果。同时，databend-sqlalchemy 作为 Databend 的 SQLAlchemy 适配器，使 Superset 能够使用 SQLAlchemy 框架与 Databend 集成。它通过 SQLAlchemy 的接口将 Superset 生成的 SQL 查询转换为 Databend 可理解的格式。

教程：与 Superset 集成

本教程将指导您完成将 Databend Cloud 与 Superset 集成的过程。

1

构建 Superset 镜像

这些步骤涉及创建一个带有 Databend 集成的自定义 Superset Docker 镜像：

1. 以官方的 Superset Docker 镜像为基础。编辑 Dockerfile，提升权限以安装必要的包。

Dockerfile

FROM apache/superset
# 切换到 root 以安装所需的包
USER root
RUN pip install databend-py 
RUN pip install databend-sqlalchemy
# 切换回使用 `superset` 用户
USER superset

2. 使用当前目录作为构建上下文，构建一个标签为 "superset-databend:v0.0.1" 的 Docker 镜像。

docker build -t superset-databend:v0.0.1 .

3. 使用 "superset-databend:v0.0.1" 镜像运行一个 Docker 容器。

docker run -d -p 8080:8088 -e "SUPERSET_SECRET_KEY=<your_secret_key>" --name superset --platform linux/x86_64 superset-databend:v0.0.1

2

设置 Superset

1. 创建一个管理员用户。

docker exec -it superset superset fab create-admin \
           --username admin \
           --firstname Superset \
           --lastname Admin \
           --email admin@superset.com \
           --password admin

2. 应用任何必要的数据库迁移，以确保 Superset 数据库模式是最新的。

docker exec -it superset superset db upgrade

3. 初始化 Superset。

docker exec -it superset superset init

3

连接到 Databend Cloud

1. 导航到 http://localhost:8080/login/，并使用用户名和密码 admin/admin 登录。

2. 选择 设置 > 数据 > 连接数据库 以打开连接向导。

3. 从支持的数据库列表中选择 其他。

4. 在 基本 标签页中，设置一个显示名称，例如 Databend，然后输入连接到 Databend Cloud 的 URI。URI 的格式为：databend://<host>，其中 <host> 对应于您的计算集群连接信息中的主机字段。有关如何获取连接详细信息的信息，请参阅 连接到计算集群。

5. 点击 测试连接，应该会出现一个弹出消息，显示 "连接看起来不错！"。