Skip to content

Correct multi-source dbt collision behavior and add CLI deploy warning - #1075

Merged
jpetey75 merged 1 commit into
mainfrom
mintlify/e66d29f7
Aug 4, 2026
Merged

Correct multi-source dbt collision behavior and add CLI deploy warning#1075
jpetey75 merged 1 commit into
mainfrom
mintlify/e66d29f7

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Updates the "Connecting multiple dbt sources" section of references/integrations/dbt-projects.mdx:

  • Name collisions: rewrites the paragraph to reflect shipped behavior in v1.71.0. Duplicate model names across sources now fail the deploy with a ParameterError naming each collision and its sources; only identical dbt built-in macros and docs merge silently. Precedence still orders ref()/lookup resolution but no longer silently resolves model collisions. Updated the Models bullet accordingly.
  • CLI deploy warning: adds a <Warning> explaining that lightdash deploy bypasses multi-source merging and would replace project Explores with only the local repo's models. Teams should sync via Refresh dbt, lightdash refresh, or the refresh API.
  • How refreshes work: adds a short note that every refresh path re-fetches and compiles all sources and merges them into one Explore set, and that a failure in any single source fails the whole refresh with no partial deploys.

Write-back subsection and preview-project behavior were intentionally left unchanged.


Generated by Mintlify Agent.

Requested by: jake@lightdash.com via Slack
Mintlify session: slack_1785822298.159079_C0AM8D5UUR5

@mintlify

mintlify Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Aug 4, 2026, 5:48 AM

@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

@jpetey75
jpetey75 merged commit c3332cc into main Aug 4, 2026
6 checks passed
@jpetey75
jpetey75 deleted the mintlify/e66d29f7 branch August 4, 2026 05:51
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.

1 participant