Apache Superset 数据源导入导出完全指南

Apache Superset 数据源导入导出完全指南

superset Apache Superset is a Data Visualization and Data Exploration Platform 项目地址: https://gitcode.com/gh_mirrors/supers/superset

概述

Apache Superset 作为一款强大的数据可视化工具，其数据源管理功能尤为重要。本文将全面介绍 Superset 中数据源的导入导出操作，帮助用户高效管理数据库、表、列和指标等元数据。

数据源结构解析

Superset 中的数据源采用层级结构组织，理解这一结构对后续操作至关重要：

├── 数据库(databases)
│   ├── 数据库1(database_1)
│   │   ├── 表1(table_1)
│   │   │   ├── 列(columns)
│   │   │   │   ├── 列1(column_1)
│   │   │   │   ├── 列2(column_2)
│   │   │   │   └── ... (更多列)
│   │   │   └── 指标(metrics)
│   │   │       ├── 指标1(metric_1)
│   │   │       ├── 指标2(metric_2)
│   │   │       └── ... (更多指标)
│   │   └── ... (更多表)
│   └── ... (更多数据库)

数据源导出详解

命令行导出方式

1. 基础导出命令：将当前数据源输出到标准输出

   superset export_datasources
   

2. 导出到文件：将数据源保存为ZIP文件

   superset export_datasources -f <文件名>
   

3. 高级选项：

   • -d 参数：包含空值字段
   • -b 参数：包含反向引用（如表与列的关联关系）

可视化界面导出

1. 导航至"Sources" → "Databases"（导出整个数据库）或"Tables"（导出特定表）
2. 选择需要导出的项目
3. 点击"Actions" → "Export to YAML"

重要提示：通过UI导出的项目需要保持原有层级关系才能正确导入，例如表必须嵌套在数据库元素内。

导出完整字段参考

获取可用于YAML导入的所有字段列表：

superset export_datasource_schema

数据源导入详解

标准导入方式

从ZIP文件导入数据源：

superset import_datasources -p <文件路径>

用户指定：使用-u参数设置导入操作的用户，默认为'admin'

superset import_datasources -p <文件路径> -u 'admin'

同步模式

-s参数支持同步操作，会删除元数据库中未在导入文件中指定的内容：

superset import_datasources -p <文件路径> -s columns,metrics

警告：同步模式会删除未指定的元素，使用需谨慎！

增量更新示例

不指定-s参数时，导入仅会添加和更新字段。例如更新列描述：

databases:
- database_name: main
  tables:
  - table_name: random_time_series
    columns:
    - column_name: ds
      verbose_name: datetime

旧版本兼容处理

从旧版(2.x/3.x)导入到新版(4.x+)

使用特殊命令处理旧版JSON格式：

superset legacy_import_datasources -p <路径或文件名>

可选参数：

• -r：递归处理目录
• -u：指定操作用户

旧版间的导入导出

在2.x/3.x版本中，行为由VERSIONED_EXPORT标志控制：

• True：期望ZIP文件
• False：期望YAML文件

递归处理YAML文件示例：

superset import_datasources -p <路径> -r

最佳实践建议

1. 备份优先：执行导入操作前务必备份现有元数据
2. 测试验证：先在测试环境验证导入效果
3. 版本匹配：注意不同版本间的格式差异
4. 权限管理：合理设置操作用户权限
5. 文档记录：保留导入导出的配置说明

通过掌握这些数据源管理技巧，您可以更高效地在不同环境间迁移Superset配置，实现元数据的版本控制和团队协作。

superset Apache Superset is a Data Visualization and Data Exploration Platform 项目地址: https://gitcode.com/gh_mirrors/supers/superset