Skip to content

docs(cli): document import_directory --username option - #43602

Merged
rusackas merged 2 commits into
masterfrom
fix/from-pr-40994-needs-docs-fix-cli-add-username-option-t
Aug 27, 2026
Merged

docs(cli): document import_directory --username option#43602
rusackas merged 2 commits into
masterfrom
fix/from-pr-40994-needs-docs-fix-cli-add-username-option-t

Conversation

@rusackas

Copy link
Copy Markdown
Member

SUMMARY

#40994 added an optional --username/-u flag to the import_directory CLI command (mirroring import_datasources) so imported assets get assigned an owner instead of ending up with an empty owners list. That flag, its default value, and its fail-fast behavior for unknown users weren't documented anywhere. This adds a short section to the import/export admin doc, alongside the existing write-up of import_datasources's user-resolution behavior.

BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF

N/A - docs only.

TESTING INSTRUCTIONS

Docs-only change. Confirm the new "Importing a Directory of Assets" section in docs/admin_docs/configuration/importing-exporting-datasources.mdx renders correctly and reflects the CLI behavior added in #40994.

ADDITIONAL INFORMATION

  • Has associated issue:
  • Required feature flags:
  • Changes UI
  • Includes DB Migration
  • Introduces new feature or API
  • Removes existing feature or API

Follow-up to #40994.

Co-Authored-By: Claude noreply@anthropic.com

PR #40994 added an optional --username/-u flag to the import_directory
CLI command (mirroring import_datasources) so imported assets are
assigned an owner instead of ending up with an empty owners list. That
flag, its default, and its fail-fast behavior for unknown users weren't
documented anywhere; this adds a short section alongside the other
import commands' user-resolution behavior.

Co-Authored-By: Claude <noreply@anthropic.com>
@dosubot dosubot Bot added the doc Namespace | Anything related to documentation label Aug 27, 2026
@bito-code-review

bito-code-review Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Code Review Agent Run #40007e

Actionable Suggestions - 0
Review Details
  • Files reviewed - 1 · Commit Range: e3e6583..e3e6583
    • docs/admin_docs/configuration/importing-exporting-datasources.mdx
  • Files skipped - 0
  • Tools
    • Whispers (Secret Scanner) - ✔︎ Successful
    • Detect-secrets (Secret Scanner) - ✔︎ Successful

Bito Usage Guide

Commands

Type the following command in the pull request comment and save the comment.

  • /review - Manually triggers an incremental AI Review.

  • /review full - Manually triggers a full AI Review.

  • /pause - Pauses automatic reviews on this pull request.

  • /resume - Resumes automatic reviews.

  • /resolve - Marks all Bito-posted review comments as resolved.

  • /abort - Cancels all in-progress reviews.

Refer to the documentation for additional commands.

Configuration

This repository uses Superset You can customize the agent settings here or contact your Bito workspace admin at evan@preset.io.

Documentation & Help

AI Code Review powered by Bito Logo

@netlify

netlify Bot commented Aug 27, 2026

Copy link
Copy Markdown

Deploy Preview for superset-docs-preview ready!

Name Link
🔨 Latest commit 8d11c33
🔍 Latest deploy log https://app.netlify.com/projects/superset-docs-preview/deploys/6a9095a450a9bb0008c1b120
😎 Deploy Preview https://deploy-preview-43602--superset-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Comment thread docs/admin_docs/configuration/importing-exporting-datasources.mdx Outdated
@bito-code-review

Copy link
Copy Markdown
Contributor

The flagged issue is correct. The documentation implies that import_directory supports the full range of assets found in a ZIP export, but the underlying implementation (using ImportExamplesCommand) is limited to specific asset types like databases, datasets, charts, and dashboards, excluding saved queries and tags.

To resolve this, you should update the documentation to clarify the supported asset types. Here is the suggested update for docs/admin_docs/configuration/importing-exporting-datasources.mdx:

## Importing a Directory of Assets

The `import_directory` command imports a directory of exported assets (databases, datasets,
dashboards, and charts) in the same layout produced by the ZIP-based export. Note that saved
queries and tag files are not supported and will be ignored.

```bash
superset import_directory <path / directory>

There are no other comments on this PR to address.

**docs/admin_docs/configuration/importing-exporting-datasources.mdx**
## Importing a Directory of Assets

The `import_directory` command imports a directory of exported assets (databases, datasets,
dashboards, and charts) in the same layout produced by the ZIP-based export. Note that saved
queries and tag files are not supported and will be ignored.

```bash
superset import_directory <path / directory>

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@bito-code-review

bito-code-review Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Code Review Agent Run #a70265

Actionable Suggestions - 0
Review Details
  • Files reviewed - 1 · Commit Range: e3e6583..8d11c33
    • docs/admin_docs/configuration/importing-exporting-datasources.mdx
  • Files skipped - 0
  • Tools
    • Whispers (Secret Scanner) - ✔︎ Successful
    • Detect-secrets (Secret Scanner) - ✔︎ Successful

Bito Usage Guide

Commands

Type the following command in the pull request comment and save the comment.

  • /review - Manually triggers an incremental AI Review.

  • /review full - Manually triggers a full AI Review.

  • /pause - Pauses automatic reviews on this pull request.

  • /resume - Resumes automatic reviews.

  • /resolve - Marks all Bito-posted review comments as resolved.

  • /abort - Cancels all in-progress reviews.

Refer to the documentation for additional commands.

Configuration

This repository uses Superset You can customize the agent settings here or contact your Bito workspace admin at evan@preset.io.

Documentation & Help

AI Code Review powered by Bito Logo

@rusackas
rusackas merged commit 5ff44c5 into master Aug 27, 2026
65 checks passed
@rusackas
rusackas deleted the fix/from-pr-40994-needs-docs-fix-cli-add-username-option-t branch August 27, 2026 23:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc Namespace | Anything related to documentation preset-io size/S

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants