Skip to content

docs: document --defer/--state gotchas in CLI reference#607

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/cli-defer-state-gotchas
Open

docs: document --defer/--state gotchas in CLI reference#607
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/cli-defer-state-gotchas

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 8, 2026

Adds a "Using --defer with lightdash preview and lightdash compile" subsection under the dbt-flags list in the CLI reference.

Covers three points:

  • --defer only resolves Lightdash-joined upstream models against the prod state manifest; standalone tag:lightdash models not joined to a modified model don't appear (scope of fix: patch deferred model schemas when using --defer lightdash#20672).
  • Don't use --favor-state for preview workflows — it routes modified models back to prod relations.
  • The comma in --select is AND, not OR.

Source: lightdash/lightdash#12615, lightdash/lightdash#10911.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 8, 2026

🤖 Documentation Bot

All checks passed! No issues found.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 8, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview May 8, 2026, 4:50 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants