Superset数据源导入导出完全指南：从基础到高级操作

Superset数据源导入导出完全指南：从基础到高级操作

superset 项目地址: https://gitcode.com/gh_mirrors/su/superset

概述

在现代数据分析平台Superset中，数据源(包括数据库和表)的管理是核心功能之一。本文将全面介绍Superset中数据源的导入导出机制，帮助用户高效管理数据源配置。

数据源结构解析

Superset中的数据源采用层级结构组织，理解这一结构对正确导入导出至关重要：

数据库(databases)
└── 表(tables)
    ├── 列(columns)
    └── 指标(metrics)

这种层级关系意味着：

• 每个数据库包含多个表
• 每张表包含多个列和指标
• 导入时必须保持这种层级关系

数据源导出详解

命令行导出

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

   superset export_datasources
   

2. 导出到文件：保存为ZIP压缩包

   superset export_datasources -f 导出文件名
   

3. 高级选项：

   • -d：包含空值字段
   • -b：包含反向引用(如表ID与列的关联)

界面导出操作

1. 导航至"Sources -> Databases"或"Tables"
2. 选择要导出的项目
3. 点击"Actions -> Export to YAML"

重要提示：通过UI导出的项目需要手动维护层级关系才能重新导入。

导出字段参考

获取完整的可导入字段列表：

superset export_datasource_schema

数据源导入深入

标准导入流程

superset import_datasources -p 文件路径 -u 用户名

参数说明：

• -p：指定导入文件路径
• -u：设置操作用户(默认admin)

同步模式(-s参数)

同步模式会强制使数据库与导入文件内容一致，慎用！

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

此命令会：

1. 添加文件中存在而数据库中没有的列和指标
2. 更新数据库中与文件内容不一致的列和指标
3. 删除数据库中存在但文件中没有的列和指标

增量更新

不指定-s参数时，导入仅执行添加和更新操作，不会删除任何内容。

示例YAML片段：

databases:
- database_name: 主数据库
  tables:
  - table_name: 时间序列表
    columns:
    - column_name: 日期字段
      verbose_name: 日期时间

旧版本兼容处理

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

使用专用命令处理JSON格式的旧版导出：

superset legacy_import_datasources -p 文件路径

旧版间的导入导出

行为由VERSIONED_EXPORT标志控制：

• True：使用ZIP格式
• False：使用YAML格式

递归导入目录下所有YAML文件：

superset import_datasources -p 目录路径 -r

最佳实践建议

1. 备份优先：执行导入前务必备份现有配置
2. 测试验证：先在测试环境验证导入效果
3. 版本匹配：注意不同Superset版本间的兼容性
4. 结构完整：确保导入文件保持正确的层级结构
5. 权限控制：使用适当的用户身份执行操作

通过掌握这些导入导出技巧，您可以轻松实现Superset数据源配置的迁移、备份和版本控制，极大提升数据管理效率。

superset 项目地址: https://gitcode.com/gh_mirrors/su/superset