Skip to content

feat(databricks): add AzureDatabricksDeltaClient via Unity Catalog credential vending - #19

Open
lukany wants to merge 3 commits into
mainfrom
feat/databricks-uc-credential-vending
Open

feat(databricks): add AzureDatabricksDeltaClient via Unity Catalog credential vending#19
lukany wants to merge 3 commits into
mainfrom
feat/databricks-uc-credential-vending

Conversation

@lukany

@lukany lukany commented Jun 16, 2026

Copy link
Copy Markdown
Collaborator

Read Unity Catalog tables directly from their underlying Azure storage using short-lived credentials vended by the temporary-table-credentials API, with no SQL warehouse or cluster. The client resolves a table by its full name, vends and caches an Azure user-delegation SAS, refreshes it before expiry, and returns a configured DeltaTableClient.

The Databricks REST API is authenticated with a Microsoft Entra ID token (DefaultAzureCredential by default) via azure-core's pipeline. Adds a manual smoke script for verifying against a real workspace, guarded by an import test, and documents the credential-vending flow in the README.

…edential vending

Read Unity Catalog tables directly from their underlying Azure storage
using short-lived credentials vended by the temporary-table-credentials
API, with no SQL warehouse or cluster. The client resolves a table by its
full name, vends and caches an Azure user-delegation SAS, refreshes it
before expiry, and returns a configured DeltaTableClient.

The Databricks REST API is authenticated with a Microsoft Entra ID token
(DefaultAzureCredential by default) via azure-core's pipeline. Adds a manual
smoke script for verifying against a real workspace, guarded by an import
test, and documents the credential-vending flow in the README.
@lukany
lukany requested a review from pall-j June 16, 2026 19:23
@lukany
lukany marked this pull request as ready for review June 16, 2026 19:25
@pall-j
pall-j requested a review from mbelak-dtml June 29, 2026 08:58
Comment thread README.md
uv add deltabridge
```

## Usage

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.

Idea for new readme sections (from offline talk):

Options

1. Direct Storage Access

...

Example (Azure)

Example (Local)

2. Databricks Access (Unity Catalog)

Databricks tables can be accessed also through (1.) but recommended this approach is preferred in case of Databricks.

...

Example (Azure)

on the schema (or parent catalog);
* the metastore must have external data access enabled;
* the table must not use row filters or column masks and must not be a
view - credential vending rejects those.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

There are additional limitations:

  • tables managed by Lakeflow Spark Declartive Pipelines are not supported (materialized views & streaming tables)
  • shallow clones are not supported
  • tables from a foreign metastore shared via Delta Sharing

Note: I tested this in late April 2026 using deltalake==1.5.1, might be outdated. However, I don't see any mention of any changes to these points in deltalake changelogs.

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

Labels

None yet

Development

Successfully merging this pull request may close these issues.

3 participants