Skip to content

docs(databricks): merge databricks_tags additively across config hierarchy levels#9379

Merged
luna-bianca merged 4 commits into
dbt-labs:currentfrom
sd-db:sd-db/docs-sync/pr-1340
Jun 18, 2026
Merged

docs(databricks): merge databricks_tags additively across config hierarchy levels#9379
luna-bianca merged 4 commits into
dbt-labs:currentfrom
sd-db:sd-db/docs-sync/pr-1340

Conversation

@sd-db

@sd-db sd-db commented Jun 10, 2026

Copy link
Copy Markdown
Contributor

What this PR does

Documents that databricks_tags now merges additively across dbt config hierarchy levels as of dbt-databricks v1.12.0. Previously, a lower-level config (e.g. model-level) fully replaced a higher-level one (e.g. project-level); now the dictionaries are merged — keys defined at the lower level override matching keys from the higher level, and any other higher-level keys are retained.

This documents the behavior change introduced in databricks/dbt-databricks#1340.

Changes

  • Adds a "Breaking change in v1.12.0" caution callout with a worked example (project-level + model-level merge) in the databricks_tags section.
  • Notes the additive-merge behavior in the relevant footnotes (table and column config tables) with links back to the detailed section.
  • Clarifies the merge applies wherever databricks_tags is set — tables, columns, materialized views, and streaming tables.

Which audience does this affect?

dbt-databricks users on v1.12.0+ who set databricks_tags at more than one config hierarchy level.

…archy levels (databricks/dbt-databricks#1340)

`databricks_tags` now merges additively across dbt config hierarchy levels: a model-level `databricks_tags` value no longer clobbers tags defined at the project level — instead the dictionaries are merged (child keys override matching parent keys, other parent keys are retained). This is a breaking change for projects that relied on lower-level configs fully replacing higher-level ones.
@sd-db sd-db requested a review from a team as a code owner June 10, 2026 08:11
@vercel

vercel Bot commented Jun 10, 2026

Copy link
Copy Markdown

@sd-db is attempting to deploy a commit to the dbt-labs Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions github-actions Bot added the content Improvements or additions to content label Jun 10, 2026
@luna-bianca luna-bianca self-assigned this Jun 16, 2026
@vercel

vercel Bot commented Jun 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs-getdbt-com Ready Ready Preview Jun 18, 2026 1:20pm

Request Review

@luna-bianca luna-bianca left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for opening this PR, @sd-db ! I have some editorial suggestions, please check! Also, can you please add this update to Upgrade guide for 1.12? Thanks!

Comment thread website/docs/reference/resource-configs/databricks-configs.md Outdated
Comment thread website/docs/reference/resource-configs/databricks-configs.md Outdated
Comment thread website/docs/reference/resource-configs/databricks-configs.md Outdated
Comment thread website/docs/reference/resource-configs/databricks-configs.md Outdated
Comment thread website/docs/reference/resource-configs/databricks-configs.md Outdated
Co-authored-by: Bianca Luna <biancacamille.luna@dbtlabs.com>
@luna-bianca luna-bianca merged commit 790596c into dbt-labs:current Jun 18, 2026
3 of 4 checks passed
@luna-bianca

Copy link
Copy Markdown
Contributor

Hey @sd-db , I went ahead and pushed the changes + approved/merged the PR. I'll open a new PR to add this update to the Upgrade guide.

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

Labels

content Improvements or additions to content

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants