导入和导出数据源

Superset CLI 允许您将数据源从 YAML 导入和导出到 YAML。数据源包括数据库。数据应按以下层次结构组织：

├──databases
|  ├──database_1
|  |  ├──table_1
|  |  |  ├──columns
|  |  |  |  ├──column_1
|  |  |  |  ├──column_2
|  |  |  |  └──... (more columns)
|  |  |  └──metrics
|  |  |     ├──metric_1
|  |  |     ├──metric_2
|  |  |     └──... (more metrics)
|  |  └── ... (more tables)
|  └── ... (more databases)

将数据源导出到 YAML

您可以通过运行以下命令将当前数据源打印到标准输出：

superset export_datasources

要将数据源保存到 ZIP 文件，请运行：

superset export_datasources -f <filename>

默认情况下，将省略默认（空）值。使用 -d 标志来包含它们。如果您希望包含反向引用（例如，列包含其所属的表 ID），请使用 -b 标志。

或者，您可以使用 UI 导出数据源

1. 打开 Sources -> Databases 以导出与一个或多个数据库关联的所有表。（Tables 用于一个或多个表）
2. 选择您要导出的项目。
3. 单击 Actions -> Export 到 YAML
4. 如果要导入通过 UI 导出的项目，则需要将其嵌套在其父元素中，例如，数据库需要嵌套在数据库下，表需要嵌套在数据库元素内。

为了获取您可以使用 YAML 导入运行的所有字段的详尽列表

superset export_datasource_schema

提醒一下，您可以使用 -b 标志来包含反向引用。

导入数据源

为了从 ZIP 文件导入数据源，请运行：

superset import_datasources -p <path / filename>

可选的用户名标志 -u 设置用于数据源导入的用户。默认是“admin”。示例：

superset import_datasources -p <path / filename> -u 'admin'

旧版数据源导入

从旧版本的 Superset 到当前版本

当使用 Superset 4.x.x 版本从旧版本（2.x.x 或 3.x.x）导入时，导入作为命令 legacy_import_datasources 支持，并期望一个 JSON 或一个 JSON 目录。选项是 -r 表示递归，-u 用于指定用户。不带选项的旧版导入示例：

superset legacy_import_datasources -p <path or filename>

从旧版本的 Superset 到旧版本

当使用旧的 Superset 版本（2.x.x 和 3.x.x）时，命令是 import_datasources。支持 ZIP 和 YAML 文件，并使用功能标志 VERSIONED_EXPORT 在它们之间切换。当 VERSIONED_EXPORT 为 True 时，import_datasources 期望一个 ZIP 文件，否则是 YAML。示例：

superset import_datasources -p <path or filename>

当 VERSIONED_EXPORT 为 False 时，如果您提供路径，所有以 yaml 或 yml 结尾的文件都将被解析。您可以应用其他标志（例如，递归搜索提供的路径）

superset import_datasources -p <path> -r

同步标志 -s 接受参数，以便将提供的元素与您的文件同步。请注意，这可能会删除您的元数据库的内容。示例：

superset import_datasources -p <path / filename> -s columns,metrics

这将同步 Superset 元数据库中 <path /filename> 中找到的所有数据源的所有指标和列。这意味着未在 YAML 中指定的列和指标将被删除。如果您将表添加到列、指标，它们也将被同步。

如果您不提供同步标志 (-s)，导入将只添加和更新（覆盖）字段。例如，您可以通过将以下 YAML 保存到文件，然后运行 import_datasources 命令，为示例数据集中的表 random_time_series 中的列 ds 添加一个 verbose_name。

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