diff --git a/docs/docs/miscellaneous/importing-exporting-datasources.mdx b/docs/docs/miscellaneous/importing-exporting-datasources.mdx index e51aed3536dfb..11d2ff6faf3c5 100644 --- a/docs/docs/miscellaneous/importing-exporting-datasources.mdx +++ b/docs/docs/miscellaneous/importing-exporting-datasources.mdx @@ -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 +``` + +The optional username flag **-u** sets the user used for the datasource import. The default is 'admin'. Example: + +``` +superset import_datasources -p -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 +``` + +#### 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 ``` -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): ```