New Features and Improvements
- Add support for unified hosts. A single configuration profile can now be used for both account-level and workspace-level operations when the host supports it and both
account_idandworkspace_idare available. Theexperimental_is_unified_hostflag has been removed; unified host detection is now automatic. - Accept
DATABRICKS_OIDC_TOKEN_FILEPATHenvironment variable for consistency with other Databricks SDKs (Go, CLI, Terraform). The previousDATABRICKS_OIDC_TOKEN_FILEis still supported as an alias.
Breaking Changes
- Drop support for Python 3.8 and 3.9. The minimum supported Python version is now 3.10, in line with the oldest supported Databricks Runtime LTS (DBR 13.3).
Internal Changes
- Replace the async-disabling mechanism on token refresh failure with a 1-minute retry backoff. Previously, a single failed async refresh would disable proactive token renewal until the token expired. Now, the SDK waits a short cooldown period and retries, improving resilience to transient errors.
- Extract
_resolve_profileto simplify config file loading and improve__settings__error messages. - Resolve
token_audiencefrom thetoken_federation_default_oidc_audiencesfield in the host metadata discovery endpoint, removing the need for explicit audience configuration.
API Changes
- Add
create_catalog(),create_synced_table(),delete_catalog(),delete_synced_table(),get_catalog()andget_synced_table()methods for w.postgres workspace-level service. - Add
effective_file_event_queuefield fordatabricks.sdk.service.catalog.CreateExternalLocation. - Add
effective_file_event_queuefield fordatabricks.sdk.service.catalog.ExternalLocationInfo. - Add
effective_file_event_queuefield fordatabricks.sdk.service.catalog.UpdateExternalLocation. - Add
column_selectionfield fordatabricks.sdk.service.ml.Function. - Add
cascadefield fordatabricks.sdk.service.pipelines.DeletePipelineRequest. - Add
default_branchfield fordatabricks.sdk.service.postgres.ProjectSpec. - Add
default_branchfield fordatabricks.sdk.service.postgres.ProjectStatus. - Add
ingressandingress_dry_runfields fordatabricks.sdk.service.settings.AccountNetworkPolicy. - Add
delete_app_thumbnail()andupdate_app_thumbnail()methods for w.apps workspace-level service. - Add
create_message_comment(),list_conversation_comments()andlist_message_comments()methods for w.genie workspace-level service. - Add
apply_environment()method for w.pipelines workspace-level service. - Add
nameandpermissionfields fordatabricks.sdk.service.apps.AppResourceApp. - Add
managed_encryption_settingsfield fordatabricks.sdk.service.catalog.CatalogInfo. - Add
managed_encryption_settingsfield fordatabricks.sdk.service.catalog.CreateCatalog. - Add
managed_encryption_settingsfield fordatabricks.sdk.service.catalog.UpdateCatalog. - Add
commentfield fordatabricks.sdk.service.dashboards.GenieFeedback. - Add
thoughtsfield fordatabricks.sdk.service.dashboards.GenieQueryAttachment. - Add
commentfield fordatabricks.sdk.service.dashboards.GenieSendMessageFeedbackRequest. - Add
request_sourcefield fordatabricks.sdk.service.ml.DataSource. - Add
is_onlinefield fordatabricks.sdk.service.ml.MaterializedFeature. - Add
connector_optionsfield fordatabricks.sdk.service.pipelines.SchemaSpec. - Add
connector_optionsfield fordatabricks.sdk.service.pipelines.TableSpec. - Add
scopesfield fordatabricks.sdk.service.settings.CreateOboTokenRequest. - Add
gcp_endpointfield fordatabricks.sdk.service.settings.CreatePrivateEndpointRule. - Add
scopesfield fordatabricks.sdk.service.settings.CreateTokenRequest. - Add
gcp_endpointfield fordatabricks.sdk.service.settings.NccPrivateEndpointRule. - Add
gcp_endpointfield fordatabricks.sdk.service.settings.UpdatePrivateEndpointRule. - Add
sql_statefield fordatabricks.sdk.service.sql.StatementStatus. - Add
usage_policy_idfield fordatabricks.sdk.service.vectorsearch.CreateEndpoint. - Add
index_subtypefield fordatabricks.sdk.service.vectorsearch.CreateVectorIndexRequest. - Add
budget_policy_idfield fordatabricks.sdk.service.vectorsearch.EndpointInfo. - Add
index_subtypefield fordatabricks.sdk.service.vectorsearch.MiniVectorIndex. - Add
budget_policy_idfield fordatabricks.sdk.service.vectorsearch.PatchEndpointBudgetPolicyResponse. - Add
index_subtypefield fordatabricks.sdk.service.vectorsearch.VectorIndex. - Add
table_delta_uniform_iceberg_external_deltasharingenum value fordatabricks.sdk.service.catalog.SecurableKind. - Add
google_driveenum value fordatabricks.sdk.service.pipelines.IngestionSourceType. - Add
storage_optimizedenum value fordatabricks.sdk.service.vectorsearch.EndpointType. - [Breaking] Remove
projectfield fordatabricks.sdk.service.postgres.SyncedTableSyncedTableSpec. - [Breaking] Remove
appsandlakebasefields fordatabricks.sdk.service.settings.CustomerFacingIngressNetworkPolicyRequestDestination.