Apache Superset 现代化数据 BI 工具部署与集成指南

注意：确保网络连通、账户有查询权限。源码部署需手动安装驱动（如 pip install mysqlclient），Docker 部署通常已预装。

三、核心操作：从数据到可视化仪表盘

1. 创建数据集（Dataset）

数据集是可视化的基础，对应数据库中的表/视图/SQL 查询结果。

1. 点击 Data > Datasets > + Dataset。
2. 选择已连接的数据库，再选择目标表；或选择 Custom SQL 编写自定义查询。
3. 配置字段属性：
   • 标记维度（Dimension，如时间、地区）和指标（Metric，如销售额 sum(amount)）。
   • 设置时间列、字段类型（字符串/数值/日期）。
4. 点击 Add 完成注册。

2. 制作可视化图表（Chart）

Superset 提供 50+ 图表类型（折线图、柱状图、饼图、热力图、地图等）。

1. 点击 Charts > + Chart，选择数据集。
2. 选择图表类型：
   • 趋势分析：折线图/面积图
   • 占比分析：饼图/环形图
   • 对比分析：柱状图/条形图
   • 地理分析：地图/气泡图
3. 配置图表参数：
   • Data 标签：选择维度（X 轴/分组）、指标（Y 轴/计算方式，如 sum、avg、count）。
   • Customize 标签：设置标题、颜色、图例、坐标轴格式。
4. 点击 Run Query 预览效果，保存图表。

3. 搭建交互式仪表盘（Dashboard）

1. 点击 Dashboards > + Dashboard，输入名称并保存。
2. 进入编辑模式，点击 + Add Chart，选择已创建的图表添加。
3. 布局调整：拖拽图表调整大小和位置。
4. 配置交互功能：
   • 过滤器（Filter）：添加时间、地区等过滤器，实现多图表联动筛选。
   • 图表联动：设置钻取功能（如点击'全国销售额'下钻到'省份销售额'）。
   • 刷新策略：设置自动刷新时间（如 5 分钟/次）。
5. 保存仪表盘，分享给团队（支持权限控制）。

四、进阶技巧：提升 BI 分析效率

1. 自定义指标与计算字段

在数据集编辑页，点击 + Add Metric 自定义指标，例如：

SUM(CASE WHEN status='paid' THEN amount ELSE 0 END) AS 已支付销售额

2. 权限管控（企业级必备）

• 基于 RBAC（角色权限控制）：创建角色（如管理员、分析师、只读用户）。
• 精细控制：限制用户对特定数据库、数据集、仪表盘的访问权限。

3. 性能优化

• 对大表创建物化视图，减少查询耗时。
• 开启 缓存：在配置文件中设置 Redis 缓存，缓存查询结果。
• 优化 SQL 查询：避免 select *，添加合理索引。

4. 集成与扩展

• API 集成：通过 Superset REST API 实现自动化报表推送。
• 自定义插件：开发自定义图表类型（基于 React）。
• 告警功能：结合外部工具（如 AlertManager）实现指标异常告警。

五、Superset 可视化图表集成到企业管理系统

核心是通过 嵌入（Embedding） 或 API 调用 实现，无需让用户单独登录 Superset。

方案 1：官方嵌入式集成（推荐，企业级首选）

Superset 支持 认证代理（Auth Proxy） 和 嵌入式令牌（Embed Token） 两种嵌入式方案。

核心前提

1. Superset 需配置为 允许嵌入（修改配置文件 superset_config.py）。
2. 企业管理系统与 Superset 需在同一域名或配置 CORS 跨域。

步骤 1：开启 Superset 嵌入功能

修改 superset_config.py，添加以下配置：

# 允许嵌入式访问
ENABLE_EMBEDDING = True
# 允许的嵌入来源（企业管理系统域名，* 为测试环境）
EMBEDDED_SUPERSET_DOMAINS = ["https://your-enterprise-system.com"]
# 使用令牌认证（推荐）
EMBEDDING_SECRET_KEY = "your-secret-key"

重启 Superset 服务使配置生效。

步骤 2：生成嵌入令牌

方式 A：手动生成（测试用）

1. 进入 Superset 仪表盘页面，点击右上角 … > Embed Dashboard。
2. 设置权限（如允许筛选、隐藏导航栏），生成 嵌入链接 或 嵌入代码。
   • 嵌入链接示例：https://superset.your.com/embed/dashboard/abc123?token=xxx
   • 嵌入代码示例（iframe）：

   <iframe src="https://superset.your.com/embed/dashboard/abc123?token=xxx" width="100%" height="800px" frameborder="0"></iframe>
   

方式 B：API 生成（生产用，动态授权）

通过 Superset REST API 生成令牌，适合根据企业系统用户权限动态返回图表。

1. 获取 Superset 管理员 Token：

   curl -X POST "https://superset.your.com/api/v1/security/login" \
     -H "Content-Type: application/json" \
     -d '{"username":"admin","password":"your-pass","provider":"db"}'
   

2. 调用嵌入令牌生成接口：

   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": [] }'
   

步骤 3：在企业管理系统中嵌入

直接将 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>

方案 2：API 调用 + 前端渲染（高度自定义）

如果需要将 Superset 图表数据与企业系统前端组件深度融合，可通过 Superset API 获取图表数据，再用前端框架（Vue/React）渲染。

步骤 1：获取图表数据 API

1. 找到目标图表的 chart_id（Superset 图表页面 URL 中 chart/123 的 123 即为 ID）。
2. 接口返回 JSON 格式数据，包含 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" } }'
   

步骤 2：前端渲染数据

以 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;

方案 3：静态图片导出（简单无交互）

适合只需要展示图表快照、无需交互的场景（如企业报表 PDF、邮件推送）。

步骤 1：导出 Superset 图表为图片

1. 进入图表页面，点击右上角 … > Export > Export as PNG，手动下载图片。
2. 或通过 API 批量导出：

   curl -X GET "https://superset.your.com/api/v1/chart/123/export/png" \
     -H "Authorization: Bearer {admin-token}" \
     -o "sales-chart.png"
   

步骤 2：集成到企业系统

将图片上传到企业系统的文件服务器，在页面中通过 <img> 标签引用：

<img src="/static/images/sales-chart.png" alt="销售趋势图" class="report-img">

关键注意事项（企业级部署）

1. 权限管控：生产环境禁止使用 EMBEDDED_SUPERSET_DOMAINS = ["*"]，需指定企业系统域名。通过 行级安全（RLS） 控制用户只能查看权限内数据。
2. 性能优化：开启 Superset 缓存，减少重复查询。嵌入式方案建议使用 CDN 加速 Superset 静态资源。
3. 安全防护：嵌入令牌需设置 过期时间，避免长期有效。企业系统与 Superset 之间的通信建议使用 HTTPS 加密。