Skip to content

feat: built-in databricks unity catalog sync#802

Open
parisni wants to merge 11 commits intoapache:mainfrom
leboncoin:pr-databricks-uc-sync
Open

feat: built-in databricks unity catalog sync#802
parisni wants to merge 11 commits intoapache:mainfrom
leboncoin:pr-databricks-uc-sync

Conversation

@parisni
Copy link
Contributor

@parisni parisni commented Feb 11, 2026

Important Read

  • Please ensure the GitHub issue is mentioned at the beginning of the PR

What is the purpose of the pull request

This pull request adds Databricks Unity Catalog (DATABRICKS_UC) catalog sync support to XTable, with a new xtable-databricks module, UC config wiring, UC sync client
implementation, and documentation updates.

Brief change log

  • Added new xtable-databricks module + ServiceLoader wiring.
  • Added DatabricksUnityCatalogConfig and DatabricksUnityCatalogSyncClient (DDL-based UC registration).
  • Implemented UC sync methods: hasDatabase, createDatabase, getTable, createTable, createOrReplaceTable, dropTable, refreshTable.
  • Added UC-specific unit tests for all catalog sync methods.
  • Documented Databricks UC sync flow, auth (OAuth M2M), limitations (Delta-only, unique location), and schema evolution strategy (drop/recreate).

Verify this pull request

This change added tests and can be verified as follows:

  • Added TestDatabricksUnityCatalogSyncClient in xtable-databricks.
  • Run:
    • mvn -Drat.skip=true -Dspotless.skip=true -Dtest=TestDatabricksUnityCatalogSyncClient -pl xtable-databricks test

not sure if unity catalog refresh by itself the table metadata. will
have to investigate
for now skip refresh table
- alter column stmt is meant for delta, not uc so it tries to upgrade
delta logs
- refresh table stmt does not refresh the columns
- create or replace stmt is also meant for delta, not uc so tries to
upgrade delta logs
- drop table + create new table: does the work, also sounds like uc does
keep track of the table history so we don't loose associated stuff (top
users, related assets, creation date...)
@parisni parisni changed the title feat: databricks unity catalog sync feat: built-in databricks unity catalog sync Feb 11, 2026
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