Superset
Apache Superset 是一个开源的数据挖掘平台，支持丰富的数据源连接、多种可视化方式，并提供细粒度的用户权限控制。其核心功能包括自助分析、自定义仪表盘、分析结果可视化导出、用户/角色权限控制，以及内置 SQL 编辑器。
本文目标：在 Apache Superset 3.1 中配置 Apache Doris 数据源，实现数据查询和可视化。
| 组件 | 推荐版本 | 说明 |
|---|---|---|
| Apache Superset | 3.1 及以上 | 官方支持 Apache Doris 连接 |
| Apache Doris | 2.0.4 及以上 | 推荐使用 |
| Python | 3.9 / 3.10 / 3.11 | 建议使用稳定版本 |
| pydoris | 1.1.0 | Doris Python 客户端 |
准备工作
在开始配置前，请确保完成以下准备工作：
-
安装 Apache Superset 3.1 或更高版本
参考 Superset 官方安装指南。
-
安装 Apache Doris 的 Python 客户端：
pip install pydoris -
验证安装结果：
pip list | grep pydoris
# 预期输出：
# pydoris 1.1.0
步骤一：配置 Doris 数据源
完成环境准备后，按照以下步骤在 Superset 中添加 Doris 数据源。
1. 获取 SQLAlchemy 连接字符串
Doris 使用以下格式的 SQLAlchemy URI：
doris://<用户名>:<密码>@<主机地址>:<端口>/<Catalog>.<数据库名>
参数说明：
| 参数 | 含义 | 示例 |
|---|---|---|
| 用户名 | Doris 连接用户名 | testuser |
| 密码 | 用户密码 | xxxxxx |
| 主机地址 | 数据库 host | 127.0.1.28 |
| 端口 | Query port | 9030 |
| Catalog | Doris Catalog，内部表用 internal，外部表查询数据湖时指定对应 Catalog | internal |
| 数据库名 | 数据库名称 | tpch |
2. 在 Superset 中添加数据源
-
访问 Superset Web 界面，点击右上角 Settings → Database Connectors。
-
点击 + Add Database，在 Connect a Database 弹窗中选择 Apache Doris。
-
在连接信息中填写 SQLAlchemy URI，完成连接验证后，点击 Connect。
-
添加成功后，界面将显示已添加的数据源。
步骤二：构建可视化图表
数据源配置完成后，开始构建数据可视化。
本文以 TPC-H 数据集为例，演示如何分析不同货运方式的订单金额随时间变化曲线。
前提条件：已在 Apache Doris 中加载 TPC-H 数据集，参考 TPC-H 数据构建文档。
1. 创建 Dataset
-
点击左侧导航栏 Datasets → + Add Dataset。
-
依次选择配置后，点击右下角 Create dataset and create chart：
- Database：Doris
- Schema：tpch
- Table：lineitem
2. 添加自定义指标
-
在 Dataset 编辑页面，点击 Metrics → Add item，添加计算指标：
- Metric Key：Revenue
- SQL Expression：
SUM(l_extendedprice * (1 - l_discount))
3. 创建图表
-
进入 Chart 页面，点击 + Add Chart，选择 lineitem 作为数据集，Line Chart 作为图表类型。
-
配置图表参数：
- 将 l_shipdate 拖拽到 X 轴，设置时间粒度
- 将 Revenue 指标拖拽到 Metrics 区域
- 将 l_shipmode 列拖拽到 Dimensions 区域
-
点击 Update chart 预览图表，确认无误后点击 Save 保存看板。
常见问题与使用技巧
前提条件
- 必须在 Superset 环境中预先安装
pydoris，否则在创建数据库时无法选择 Apache Doris 选项。
性能优化
| 优化项 | 说明 |
|---|---|
| 表结构设计 | 根据实际需求合理创建 Doris 库表，按时间分区分桶 |
| 谓词下推 | 有效减少谓词过滤和数据传输量 |
| 网络安全 | 建议使用 VPC 私有连接，避免公网访问引入安全风险 |
| 权限控制 | 细化 Doris 用户账号角色和访问权限，避免过度下放权限 |
故障排查
Q: 在添加数据库时没有看到 Apache Doris 选项
A: 检查是否已在新环境中安装 pydoris。Superset 需要在运行时检测到 Doris 驱动程序才会显示该选项。安装后可能需要重启 Superset 服务。
Q: 连接验证失败
A: 检查 SQLAlchemy URI 格式是否正确，确认 Host、Port、用户名、密码是否可访问。可使用 Doris BE 或 MySQL Client 先验证连接。
