Metabase 2026: 以零许可证成本取代 Tableau 的开源商业智能工具 —— 部署指南

-- 用户点击的内容：
-- 表: orders
-- 筛选: created_at 为 "最近30天"
-- 分组: country
-- 聚合: count, sum(total)

-- Metabase 生成的SQL：
SELECT 
    country,
    COUNT(*) AS order_count,
    SUM(total) AS revenue
FROM orders
WHERE created_at >= DATE_TRUNC('day', NOW() - INTERVAL '30 days')
GROUP BY country
ORDER BY revenue DESC;

-- Metabase 中的原生SQL问题
WITH cohort_users AS (
    SELECT 
        user_id,
        DATE_TRUNC('month', created_at) AS cohort_month
    FROM users
    WHERE created_at >= '2024-01-01'
),
retention AS (
    SELECT 
        c.cohort_month,
        DATE_TRUNC('month', o.created_at) - c.cohort_month AS period,
        COUNT(DISTINCT o.user_id) AS retained_users,
        COUNT(DISTINCT c.user_id) AS total_users
    FROM cohort_users c
    LEFT JOIN orders o ON c.user_id = o.user_id
    GROUP BY 1, 2
)
SELECT 
    cohort_month,
    period,
    ROUND(retained_users::float / total_users * 100, 2) AS retention_pct
FROM retention
WHERE period <= 12
ORDER BY 1, 2;

仪表板: "Q2收入概览"
├── 问题: "月度收入趋势" (折线图)
├── 问题: "按国家收入" (柱状图)
├── 问题: "前10产品" (表格)
├── 问题: "客户获取漏斗" (漏斗图)
└── 筛选器: "日期范围" (链接到所有问题)

mkdir -p ~/metabase-data
chmod 777 ~/metabase-data

# 启动Metabase容器
docker run -d \
  --name metabase \
  -p 3000:3000 \
  -v ~/metabase-data:/metabase-data \
  -e MB_DB_FILE=/metabase-data/metabase.db \
  --restart unless-stopped \
  metabase/metabase:v0.60.2

# 查看日志
docker logs -f metabase

1. 选择语言 (English)
2. 创建管理员账户 (邮箱 + 密码)
3. 添加第一个数据库：
   - 数据库类型: PostgreSQL
   - 主机: your-db-host
   - 端口: 5432
   - 数据库名: analytics
   - 用户名: metabase_readonly
   - 密码: ********
4. 完成 — Metabase自动发现表和关系

# docker-compose.yml
version: "3.8"
services:
  metabase:
    image: metabase/metabase:v0.60.2
    restart: always
    ports:
      - "3000:3000"
    environment:
      # 使用PostgreSQL作为应用数据库（生产推荐）
      MB_DB_TYPE: postgres
      MB_DB_DBNAME: metabase
      MB_DB_PORT: 5432
      MB_DB_USER: metabase
      MB_DB_PASS: ${POSTGRES_PASSWORD}
      MB_DB_HOST: postgres
      # 针对较大部署的Java堆大小
      JAVA_OPTS: "-Xmx2g -Xms1g"
    depends_on:
      postgres:
        condition: service_healthy
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3000/api/health"]
      interval: 30s
      timeout: 10s
      retries: 5

  postgres:
    image: postgres:15-alpine
    restart: always
    environment:
      POSTGRES_USER: metabase
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: metabase
    volumes:
      - metabase_db:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U metabase"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  metabase_db:

# 创建环境文件
echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .env

# 启动服务
docker-compose up -d

# 验证服务健康状态
docker-compose ps

# 1. 创建预装Docker的Droplet
#    使用推荐链接获取$200免费额度：
#    https://m.do.co/c/eca87ac14ee0

# 2. SSH连接到Droplet
ssh root@your-droplet-ip

# 3. 克隆docker-compose配置
git clone https://github.com/your-org/metabase-infra.git
cd metabase-infra

# 4. 启动
docker-compose up -d

# 5. 设置Nginx反向代理和SSL
apt install -y nginx certbot python3-certbot-nginx

# 6. 配置Nginx
cat > /etc/nginx/sites-available/metabase << 'EOF'
server {
    listen 80;
    server_name analytics.yourdomain.com;
    
    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
EOF

ln -s /etc/nginx/sites-available/metabase /etc/nginx/sites-enabled/
certbot --nginx -d analytics.yourdomain.com
systemctl reload nginx

# Metabase UI中的连接设置
数据库类型: PostgreSQL
主机: db.example.com
端口: 5432
数据库名: analytics
用户名: metabase_readonly
密码: ${POSTGRES_PASSWORD}
SSL: 必需
额外JDBC选项: ?prepareThreshold=0

数据库类型: Snowflake
账户: xyz123.us-east-1
仓库: REPORTING_WH
数据库: PRODUCTION
架构: PUBLIC
用户名: METABASE_USER
密码: ${SNOWFLAKE_PASSWORD}
角色: METABASE_ROLE

# 1. 在Google Cloud Console中创建服务账户
# 2. 下载JSON密钥文件
# 3. 在Metabase连接对话框中上传

# 所需IAM角色：
# - roles/bigquery.dataViewer
# - roles/bigquery.jobUser

导航: + 新建 > 问题
数据库: analytics
表: orders

筛选器:
  - 创建时间: "最近30天"
  - 状态: 不是 "已退款"

分组: Country
聚合: 行数, Total总和
可视化: 柱状图
排序: Total 降序

保存为: "按国家收入 (30天)"

导航: + 新建 > 仪表板
名称: "执行摘要"

添加问题:
  1. "日活跃用户" → 折线图
  2. "按国家收入 (30天)" → 柱状图
  3. "热门产品" → 表格
  4. "转化漏斗" → 漏斗图

添加筛选器:
  - 日期范围 (链接到所有问题)
  - 国家 (链接到问题 2, 3)

配置自动刷新: 每5分钟

-- 问题: "用户留存分析"
-- 带日期筛选变量

SELECT 
    DATE_TRUNC('month', created_at) AS cohort_month,
    COUNT(*) AS new_users
FROM users
WHERE created_at >= {{start_date}}  -- 仪表板筛选器
GROUP BY 1
ORDER BY 1;

<!-- 在React应用中嵌入仪表板 -->
<iframe
  src="https://analytics.yourapp.com/embed/dashboard/123"
  frameborder="0"
  width="1200"
  height="800"
  allowtransparency
></iframe>

// 用于签名嵌入的JWT令牌生成 (Node.js)
const jwt = require('jsonwebtoken');

const token = jwt.sign({
  resource: { dashboard: 123 },
  params: { "customer_id": req.user.customerId },
  exp: Math.round(Date.now() / 1000) + (60 * 60) // 1小时
}, process.env.METABASE_SECRET_KEY);

const embedUrl = `https://analytics.yourapp.com/embed/dashboard/123#${token}`;

1. 打开任何已保存的问题
2. 点击铃铛图标 → "设置告警"
3. 选择条件：
   - "当结果达到目标"
   - 目标: 1000
   - 方向: "超过"
4. 选择交付方式：
   - 邮件: team@company.com
   - Slack: #data-alerts 频道
5. 设置频率: 每小时检查

# 在 Metabase 管理 > 设置 > Slack中：
Slack API令牌: xoxb-your-bot-token
Slack频道: #data-alerts, #executive-summary

管理 > 设置 > 缓存:
  - 启用查询缓存: 开
  - 最小缓存查询时长: 1秒
  - 缓存生存时间(TTL)乘数: 10
  - 最大缓存条目大小: 1,000 KB

-- 企业沙盒：用户只能看到其区域的数据
-- 管理 > 权限 > 数据 > 沙盒

SELECT * FROM orders
WHERE region = user_attribute('region');

#!/bin/bash
# metabase-backup.sh — 通过cron每日运行

BACKUP_DIR="/backups/metabase"
DATE=$(date +%Y%m%d_%H%M%S)

# 备份应用数据库 (PostgreSQL)
docker exec metabase_postgres pg_dump -U metabase metabase \
  > "$BACKUP_DIR/metabase_db_$DATE.sql"

# 备份Metabase设置 (如果使用H2)
docker exec metabase cat /metabase-data/metabase.db.mv.db \
  > "$BACKUP_DIR/metabase_app_$DATE.db"

# 仅保留7天备份
find "$BACKUP_DIR" -name "*.sql" -mtime +7 -delete
find "$BACKUP_DIR" -name "*.db" -mtime +7 -delete

echo "Metabase备份完成: $DATE"