Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(import_datasources): Remove legacy documentation and update current use #27290

Merged
merged 8 commits into from
Mar 5, 2024
30 changes: 27 additions & 3 deletions docs/docs/miscellaneous/importing-exporting-datasources.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -61,15 +61,39 @@ superset export_datasource_schema

As a reminder, you can use the `-b` flag to include back references.

### Importing Datasources from YAML
### Importing Datasources

In order to import datasources from a YAML file(s), run:
In order to import datasources from a ZIP file, run:

```
superset import_datasources -p <path / filename>
```

The optional username flag **-u** sets the user used for the datasource import. The default is 'admin'. Example:

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

### Legacy Importing Datasources

#### From older versions of Superset to current version

When using Superset version 4.x.x to import from an older version (2.x.x or 3.x.x) importing is supported as the command `legacy_import_datasources` and expects a JSON or directory of JSONs. The options are `-r` for recursive and `-u` for specifying a user. Example of legacy import without options:

```
superset legacy_import_datasources -p <path or filename>
```

#### From older versions of Superset to older versions

When using an older Superset version (2.x.x & 3.x.x) of Superset, the command is `import_datasources`. ZIP and YAML files are supported and to switch between them the feature flag `VERSIONED_EXPORT` is used. When `VERSIONED_EXPORT` is `True`, `import_datasources` expects a ZIP file, otherwise YAML. Example:

```
superset import_datasources -p <path or filename>
```

If you supply a path all files ending with **yaml** or **yml** will be parsed. You can apply
When `VERSIONED_EXPORT` is `False`, if you supply a path all files ending with **yaml** or **yml** will be parsed. You can apply
additional flags (e.g. to search the supplied path recursively):

```
Expand Down
Loading