feat: catalogs.yml v2 support via bridge_v2_catalog hooks#1440
Open
aahel wants to merge 28 commits into
Open
Conversation
Adds UnityDatabricksConfig and HiveMetastoreDatabricksConfig dataclasses and declares them on DatabricksAdapter.CATALOG_V2_CONFIGS. This enables parse-time validation of catalogs.yml v2 when the use_catalogs_v2 behavior flag is set in dbt-core. UnityDatabricksConfig enforces file_format='parquet' when use_uniform is false/unset, and 'delta' when use_uniform=true. HiveMetastoreDatabricksConfig accepts delta, parquet, or hudi. Both schemas are dbtClassMixin dataclasses — structural validation (unknown keys, required fields) via jsonschema; semantic constraints in __post_init__.
aahel
requested review from
benc-db,
jprakash-db,
sd-db and
tejassp-db
as code owners
…hook methods - Remove CATALOG_V2_CONFIGS and _v2.py typed dataclasses (old approach) - Add Capability.CatalogsV2 and _v2_to_v1_type hook (new approach) - Move use_uniform x file_format validation into UnityCatalogIntegration.__init__ - Move file_format enum validation into HiveMetastoreCatalogIntegration.__init__
aahel
changed the title
2 tasks
# Conflicts: # dbt/adapters/databricks/impl.py
…t/catalogs-v2-configs
sd-db
reviewed
Jun 11, 2026
sd-db
added a commit
that referenced
this pull request
Jun 11, 2026
Raises the `dbt-adapters` upper bound from `<1.23.0` to `<1.25.0` (latest is 1.24.2) and refreshes `uv.lock` to match. Floor is unchanged; the resolved version stays at 1.22.9. Unblocks #1440
use_uniform has no effect on runtime DDL today — the use_managed_iceberg behavior flag drives actual table creation. Warn users so they are not silently misled. Proper wiring of use_uniform is a follow-up PR.
sd-db
reviewed
Jun 11, 2026
Collaborator
|
/integration-test |
|
Integration tests dispatched for PR #1440 by @sd-db. Track progress in the Actions tab. |
Coverage report
Click to see where and how coverage changed
This report was generated by python-coverage-comment-action |
||||||||||||||||||||||||||||||||||||
…PR link Move optional CatalogsV2 capability setup into _adapter_capabilities() next to _capabilities (no behavior change) and link the 1.12.2 changelog entry to PR databricks#1440.
|
Integration results for PR #1440 — UC cluster ✅ success · SQL warehouse ✅ success · All-purpose cluster ✅ success · Shard coverage ✅ success |
sd-db
approved these changes
Jun 11, 2026
sd-db
left a comment
sd-db
left a comment
Collaborator
There was a problem hiding this comment.
Changes look good, thx for the PR !
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds catalogs.yml v2 support to dbt-databricks using the adapter-owned bridge architecture.
What changed
impl.pyCapability.CatalogsV2— enables v2 path whenuse_catalogs_v2: trueis set indbt_project.yml_v2_to_v1_typehook:unity → unity,hive_metastore → hive_metastorecatalogs/_unity.pyuse_uniformis set in config propertieslocation_rootmust be non-blank if providedcatalogs/_hive_metastore.pyfile_formatenum validation inHiveMetastoreCatalogIntegration.__init__: must be one ofdelta | parquet | hudiArchitecture
dbt-core parses
catalogs.ymlv2 structurally, checksCapability.CatalogsV2, then callsadapter.bridge_v2_catalog(catalog). The base adapter template method readscatalog.config.get("databricks", {})and calls_v2_to_v1_typeto resolve the v1 catalog_type. Field-level validation happens inCatalogIntegration.__init__— same as v1, no new interface.Companion PRs:
Test plan
UnityCatalogIntegration.__init__validationHiveMetastoreCatalogIntegration.__init__validation