Apache Superset 是一款开源企业级 BI 工具，支持数据可视化探索与交互式仪表盘制作。文章涵盖 Docker Compose 快速部署、主流数据库连接配置、数据集创建与图表制作流程。重点介绍将 Superset 嵌入企业系统的三种方案：官方嵌入式集成、API 调用结合前端渲染、静态图片导出。同时包含权限管控、性能优化及缓存策略等进阶技巧，助力实现高效数据洞察。
Apache Superset 是一款开源的现代化企业级 BI Web 应用程序，由 Airbnb 开源。它通过创建和分享 dashboard，为数据分析提供了轻量级的数据查询和可视化方案，支持数据可视化探索、交互式仪表盘制作、SQL 查询等功能，能帮助技术和非技术人员快速实现数据洞察。前端主要用到了 React 和 NVD3/D3，而后端则基于 Python 的 Flask 框架和 Pandas、SQLAlchemy 等依赖库。
| 部署方式 | 适用场景 | 操作难度 |
|---|---|---|
| Docker Compose | 测试/个人使用/小型团队 | 低（一键部署） |
| Kubernetes | 企业级生产环境 | 中（需容器编排经验） |
| 源码部署 | 二次开发/定制化需求 | 高（需 Python 环境） |
git clone https://github.com/apache/superset.git
cd superset
docker-compose up -d
superset db upgrade && superset init
docker-compose exec superset bash superset fab create-admin
http://localhost:8088，输入账户密码登录。Superset 支持主流数据库/数据仓库，核心步骤如下：
数据库类型://用户名：密码@主机：端口/数据库名。
mysql+pymysql://root:[email protected]:3306/sales_dbpostgresql://user:pass@localhost:5432/analyticsclickhouse+connect://user:pass@host:8123/defaultdoris://user:pass@host:9030/catalog.db?charset=utf8mb4）。注意：确保网络连通、账户有查询权限。源码部署需手动安装驱动（如 pip install mysqlclient），Docker 部署通常已预装。
数据集是可视化的基础，对应数据库中的表/视图/SQL 查询结果。
Superset 提供 50+ 图表类型（折线图、柱状图、饼图、热力图、地图等）。
在数据集编辑页，点击 + Add Metric 自定义指标，例如：
SUM(CASE WHEN status='paid' THEN amount ELSE 0 END) AS 已支付销售额
核心是通过 嵌入（Embedding） 或 API 调用 实现，无需让用户单独登录 Superset。
Superset 支持 认证代理（Auth Proxy） 和 嵌入式令牌（Embed Token） 两种嵌入式方案。
superset_config.py）。修改 superset_config.py，添加以下配置：
# 允许嵌入式访问
ENABLE_EMBEDDING = True
# 允许的嵌入来源（企业管理系统域名，* 为测试环境）
EMBEDDED_SUPERSET_DOMAINS = ["https://your-enterprise-system.com"]
# 使用令牌认证（推荐）
EMBEDDING_SECRET_KEY = "your-secret-key"
重启 Superset 服务使配置生效。
https://superset.your.com/embed/dashboard/abc123?token=xxx<iframe src="https://superset.your.com/embed/dashboard/abc123?token=xxx" width="100%" height="800px" frameborder="0"></iframe>
通过 Superset REST API 生成令牌，适合根据企业系统用户权限动态返回图表。
curl -X POST "https://superset.your.com/api/v1/security/login" \
-H "Content-Type: application/json" \
-d '{"username":"admin","password":"your-pass","provider":"db"}'
curl -X POST "https://superset.your.com/api/v1/security/guest_token/" \
-H "Authorization: Bearer {admin-token}" \
-H "Content-Type: application/json" \
-d '{ "user": {"username": "enterprise-user-01"}, "resources": [{"type": "dashboard", "id": 1}], "rls": [] }'
直接将 iframe 代码插入到企业系统的页面模板中，示例（Java 后端 Thymeleaf 模板）：
<div class="dashboard-container">
<h3>销售数据仪表盘</h3>
<iframe th:src="@{https://superset.your.com/embed/dashboard/abc123?token=${guestToken}}" width="100%" height="900px" style="border:none;"></iframe>
</div>
| 优势 | 局限 |
|---|---|
| 保留 Superset 全部交互功能 | 需要配置跨域，部署复杂度中等 |
| 支持权限控制和行级过滤 | 嵌入页面样式需与企业系统适配 |
如果需要将 Superset 图表数据与企业系统前端组件深度融合，可通过 Superset API 获取图表数据，再用前端框架（Vue/React）渲染。
chart/123 的 123 即为 ID）。columns（字段名）和 data（数据行）。
curl -X POST "https://superset.your.com/api/v1/chart/data" \
-H "Authorization: Bearer {admin-token}" \
-H "Content-Type: application/json" \
-d '{ "chart_id": 123, "form_data": { "granularity": "month", "time_range": "Last 6 Months" } }'
以 React + ECharts 为例，将 API 数据渲染为图表：
import React, { useEffect, useState } from 'react';
import * as echarts from 'echarts';
const SalesChart = () => {
const [chartData, setChartData] = useState(null);
useEffect(() => {
fetch('https://superset.your.com/api/v1/chart/data', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + localStorage.getItem('superset-token'),
'Content-Type': 'application/json'
},
body: JSON.stringify({ chart_id: 123, form_data: {...} })
})
.then(res => res.json())
.then(data => setChartData(data));
}, []);
useEffect(() => {
if (!chartData) return;
const myChart = echarts.init(document.getElementById('sales-chart'));
myChart.setOption({
xAxis: { type: 'category', data: chartData.data.map(d => d.month) },
yAxis: { type: 'value' },
series: [{ data: chartData.data.map(d => d.sales), type: 'bar' }]
});
}, [chartData]);
return <div style={{ width: '100%', height: '400px' }}></div>;
};
export default SalesChart;
| 优势 | 局限 |
|---|---|
| 完全自定义样式，与企业系统无缝融合 | 失去 Superset 原生交互功能（需自行开发） |
| 支持与业务数据联动 | 需前端开发成本，API 调用需处理鉴权 |
适合只需要展示图表快照、无需交互的场景（如企业报表 PDF、邮件推送）。
curl -X GET "https://superset.your.com/api/v1/chart/123/export/png" \
-H "Authorization: Bearer {admin-token}" \
-o "sales-chart.png"
将图片上传到企业系统的文件服务器，在页面中通过 <img> 标签引用：
<img src="/static/images/sales-chart.png" alt="销售趋势图" class="report-img">
| 优势 | 局限 |
|---|---|
| 实现最简单，无跨域/鉴权问题 | 无交互功能，数据需手动/定时更新 |
| 兼容性好，支持所有前端框架 | 不适合实时数据展示 |
EMBEDDED_SUPERSET_DOMAINS = ["*"]，需指定企业系统域名。通过 行级安全（RLS） 控制用户只能查看权限内数据。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online