Install & Compatibility
Where this runs
tested against v3.0.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.612s · 44.2MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 3.8s · import 0.534s · 45MB
43MB installed
● package 43MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
AzureDatabricksManagementClient
✓ from azure.mgmt.databricks import AzureDatabricksManagementClient
DefaultAzureCredential
✓ from azure.identity import DefaultAzureCredential
This quickstart demonstrates how to authenticate using `DefaultAzureCredential` and list Azure Databricks workspaces within a subscription. Ensure `AZURE_SUBSCRIPTION_ID`, and potentially `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, `AZURE_CLIENT_SECRET` environment variables are set for successful authentication.
import os
from azure.identity import DefaultAzureCredential
from azure.mgmt.databricks import AzureDatabricksManagementClient
# Set these environment variables or replace with actual values
# AZURE_SUBSCRIPTION_ID, AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET
subscription_id = os.environ.get("AZURE_SUBSCRIPTION_ID", "")
if not subscription_id:
raise ValueError("AZURE_SUBSCRIPTION_ID environment variable not set.")
# Authenticate using DefaultAzureCredential
# This will try to authenticate using various methods (env vars, managed identity, Azure CLI, etc.)
credential = DefaultAzureCredential()
# Create the Databricks Management Client
client = AzureDatabricksManagementClient(credential=credential, subscription_id=subscription_id)
# Example: List all Databricks workspaces in the subscription
print("Listing Databricks workspaces:")
for workspace in client.workspaces.list_by_subscription():
print(f" - {workspace.name} (Resource Group: {workspace.id.split('/')[4]}) (Location: {workspace.location})")
Debug
Known issues
breakingThe credential system was completely revamped in v2.x. Classes like `azure.common.credentials` or `msrestazure.azure_active_directory` are no longer supported. You must migrate to `azure-identity` classes (e.g., `DefaultAzureCredential`). The client constructor parameter `credentials` was renamed to `credential`.fixReplace old credential classes with `azure.identity` and update the client instantiation to use the `credential` parameter.
affects: < 2.0.0 (v1.x)
breakingOperations that previously returned `msrest.polling.LROPoller` for long-running operations (LROs) now return `azure.core.polling.LROPoller` and are typically prefixed with `begin_` (e.g., `create_or_update` becomes `begin_create_or_update`).fixUpdate method calls to use the `begin_` prefix for LROs and handle the `azure.core.polling.LROPoller` return type.
affects: < 2.0.0 (v1.x)
breakingThe exception hierarchy has been simplified. Most exceptions are now `azure.core.exceptions.HttpResponseError`. The `CloudError` exception has been removed.fixUpdate exception handling to catch `azure.core.exceptions.HttpResponseError` instead of `CloudError`.
affects: < 2.0.0 (v1.x)
gotchaThis library (`azure-mgmt-databricks`) is for *managing* Azure Databricks workspaces and resources (create, update, delete). It is distinct from the `Databricks SDK for Python` (pypi: `databricks-sdk`), which is used for interacting with Databricks *within* a Databricks environment (e.g., notebooks, jobs, clusters, data plane operations) or through the Databricks REST API. Users often confuse these two, leading to incorrect package usage for their intended task.fixEnsure you are using the correct SDK for your task: `azure-mgmt-databricks` for Azure resource management, `databricks-sdk` for in-workspace or Databricks API interactions.
affects: All versions
gotchaPython 2.7 support for Azure SDK for Python packages ended on January 1, 2022. This `azure-mgmt-databricks` package specifically requires Python 3.7 or newer.fixEnsure your environment uses Python 3.7 or a later version.
affects: < 2.0.0 (and any attempt to use with Python 2.7)
Upgrade
Version history
3.0.0latest on PyPI · released Jul 8, 2026
Audit
Dependencies
azure-identityrequiredRequired for Azure Active Directory token authentication.
azure-corerequiredCore functionalities for Azure SDKs, including HTTP pipeline, error handling, and polling for long-running operations.