Releases: databricks/databricks-sdk-py
v0.19.1
v0.19.0
Improvements and Bug Fixes
- Construct workspace client from account client (#527).
- Enabled Databricks OAuth also for Azure and GCP (#526).
- Do not terminate listing for token-based pagination resources on empty response (#530).
- Renamed
databricks.sdk.errors.mappingtodatabricks.sdk.errors.platform(#522). - Added Union to content (2nd) parameter in upload function (#493).
- Fixed WorkspaceConf.get_status and WorkspaceConf.set_status (#525).
Documentation
API Changes
Additions:
- Added the following dataclasses:
databricks.sdk.service.catalog.CancelRefreshRequestdatabricks.sdk.service.catalog.GetRefreshRequestdatabricks.sdk.service.catalog.ListRefreshesRequestdatabricks.sdk.service.catalog.MonitorRefreshInfodatabricks.sdk.service.catalog.MonitorRefreshInfoStatedatabricks.sdk.service.catalog.RunRefreshRequestdatabricks.sdk.service.compute.Adlsgen2Infodatabricks.sdk.service.compute.GcsStorageInfodatabricks.sdk.service.files.CreateDirectoryRequestdatabricks.sdk.service.files.DeleteDirectoryRequestdatabricks.sdk.service.files.DirectoryEntrydatabricks.sdk.service.files.ListDirectoryContentsRequestdatabricks.sdk.service.files.ListDirectoryResponsedatabricks.sdk.service.files.PageTokendatabricks.sdk.service.jobs.ForEachStatsdatabricks.sdk.service.jobs.ForEachTaskdatabricks.sdk.service.jobs.ForEachTaskErrorMessageStatsdatabricks.sdk.service.jobs.ForEachTaskTaskRunStatsdatabricks.sdk.service.jobs.RunForEachTaskdatabricks.sdk.service.pipelines.PipelineClusterAutoscaledatabricks.sdk.service.pipelines.PipelineClusterAutoscaleModedatabricks.sdk.service.settings.DeleteDefaultNamespaceSettingRequestdatabricks.sdk.service.settings.DeleteDefaultNamespaceSettingResponsedatabricks.sdk.service.settings.DeleteRestrictWorkspaceAdminsSettingRequestdatabricks.sdk.service.settings.DeleteRestrictWorkspaceAdminsSettingResponsedatabricks.sdk.service.settings.GetDefaultNamespaceSettingRequestdatabricks.sdk.service.settings.GetPersonalComputeSettingRequestdatabricks.sdk.service.settings.GetRestrictWorkspaceAdminsSettingRequestdatabricks.sdk.service.settings.RestrictWorkspaceAdminsMessagedatabricks.sdk.service.settings.RestrictWorkspaceAdminsMessageStatusdatabricks.sdk.service.settings.RestrictWorkspaceAdminsSettingdatabricks.sdk.service.settings.UpdateDefaultNamespaceSettingRequestdatabricks.sdk.service.settings.UpdateRestrictWorkspaceAdminsSettingRequest
- Added
cancel_refresh(),get_refresh(),list_refreshes()andrun_refresh()method for w.lakehouse_monitors workspace-level service. - Added
use_preemptible_executorsfield fordatabricks.sdk.service.compute.GcpAttributes. - Added
zone_idfield fordatabricks.sdk.service.compute.GcpAttributes. - Added
abfssandgcsfield fordatabricks.sdk.service.compute.InitScriptInfo. - Added
create_directory(),delete_directory()andlist_directory_contents()method for w.files workspace-level service. - Added
sourcefield fordatabricks.sdk.service.jobs.DbtTaskanddatabricks.sdk.service.jobs.SqlTaskFile. - Added
for_each_taskfield fordatabricks.sdk.service.jobs.RunTask,databricks.sdk.service.jobs.SubmitTaskanddatabricks.sdk.service.jobs.Task. - Added
field_maskfield fordatabricks.sdk.service.settings.UpdatePersonalComputeSettingRequest. - Added
delta_sync_index_specfield fordatabricks.sdk.service.vectorsearch.CreateVectorIndexRequest. - Added
file_typefield fordatabricks.sdk.service.workspace.ExportResponse. - Added
resource_idfield fordatabricks.sdk.service.workspace.ObjectInfo. - Added
delete_default_namespace_setting(),delete_restrict_workspace_admins_setting(),get_default_namespace_setting(),get_restrict_workspace_admins_setting(),update_default_namespace_setting()andupdate_restrict_workspace_admins_setting()method for w.settings workspace-level service. - Added
get_personal_compute_setting()method for a.account_settings account-level service.
Removals:
- Removed the following dataclasses:
databricks.sdk.service.settings.ReadDefaultWorkspaceNamespaceRequestdatabricks.sdk.service.settings.ReadPersonalComputeSettingRequestdatabricks.sdk.service.settings.UpdateDefaultWorkspaceNamespaceRequestdatabricks.sdk.service.settings.DeleteDefaultWorkspaceNamespaceRequestdatabricks.sdk.service.settings.DeleteDefaultWorkspaceNamespaceResponsedatabricks.sdk.service.pipelines.ResetRequest
- Removed the following methods:
get_status()for w.files workspace-level service.reset()for w.pipelines workspace-level service.delete_default_workspace_namespace()for w.settings workspace-level service.read_default_workspace_namespace()for w.settings workspace-level service.update_default_workspace_namespace()for w.settings workspace-level service.read_personal_compute_setting()for a.account_settings account-level service.
- Removed
namefield fordatabricks.sdk.service.catalog.UpdateConnection,databricks.sdk.service.catalog.UpdateMetastore,databricks.sdk.service.catalog.UpdateRegisteredModelRequest.databricks.sdk.service.catalog.UpdateSchemaanddatabricks.sdk.service.catalog.UpdateVolumeRequestContent. - Removed
delta_sync_vector_index_specfield fordatabricks.sdk.service.vectorsearch.CreateVectorIndexRequest.
Changes:
- Changed
max_workersandmin_workersfield fordatabricks.sdk.service.compute.AutoScaleto no longer be required. - Changed
destinationfield fordatabricks.sdk.service.compute.DbfsStorageInfo,databricks.sdk.service.compute.LocalFileInfo,databricks.sdk.service.compute.S3StorageInfo,databricks.sdk.service.compute.VolumesStorageInfoanddatabricks.sdk.service.compute.WorkspaceStorageInfoto be required. - Changed
clientsfield fordatabricks.sdk.service.compute.WorkloadTypeto be required. - Changed
allow_missingandsettingfield fordatabricks.sdk.service.settings.UpdatePersonalComputeSettingRequestto be required. - Changed
etagfield fordatabricks.sdk.service.settings.DeletePersonalComputeSettingRequestto no longer be required. - Changed
autoscalefield fordatabricks.sdk.service.pipelines.PipelineClustertodatabricks.sdk.service.pipelines.PipelineClusterAutoscaledataclass. - Changed
delete_personal_compute_setting()andupdate_personal_compute_setting()method for a.account_settings account-level service with new required argument order.
Internal Changes
- Generate SDK (#536).
- Use fake clock for faster unit tests (#533).
- Skip test_get_workspace_client in Azure and GCP (#531).
- Regenerate from the tip of main (#524).
- Search for both databricks.exe and databricks binaries in windows (#517).
OpenAPI SHA: 6b897bc95b23abed8b9f5eff0e6b8ec034046180, Date: 2024-02-08
v0.18.0
Bugfixes:
- Fix Databricks OAuth M2M on Azure (#513).
Other noteworthy changes:
- Use
[]instead ofNoneas default list value for deserialising responses (#361). - Support dev and staging workspaces (#514).
API Changes:
- Added
exists()method for w.tables workspace-level service. - Added w.lakehouse_monitors workspace-level service.
- Added the following dataclasses:
databricks.sdk.service.catalog.CreateMonitor,
databricks.sdk.service.catalog.DeleteLakehouseMonitorRequest,
databricks.sdk.service.catalog.ExistsRequest,
databricks.sdk.service.catalog.GetLakehouseMonitorRequest,
databricks.sdk.service.catalog.MonitorCronSchedule,
databricks.sdk.service.catalog.MonitorCronSchedulePauseStatus,
databricks.sdk.service.catalog.MonitorCustomMetric,
databricks.sdk.service.catalog.MonitorCustomMetricType,
databricks.sdk.service.catalog.MonitorDataClassificationConfig,
databricks.sdk.service.catalog.MonitorDestinations,
databricks.sdk.service.catalog.MonitorInferenceLogProfileType,
databricks.sdk.service.catalog.MonitorInferenceLogProfileTypeProblemType,
databricks.sdk.service.catalog.MonitorInfo,
databricks.sdk.service.catalog.MonitorInfoStatus,
databricks.sdk.service.catalog.MonitorNotificationsConfig,
databricks.sdk.service.catalog.MonitorTimeSeriesProfileType,
databricks.sdk.service.catalog.TableExistsResponseand
databricks.sdk.service.catalog.UpdateMonitor. - Changed
create_obo_token()method for w.token_management workspace-level service with new required argument order. - Changed
get()method for w.token_management workspace-level service to returndatabricks.sdk.service.settings.GetTokenResponsedataclass. - Changed
lifetime_secondsfield fordatabricks.sdk.service.settings.CreateOboTokenRequestto no longer be required. - Added
databricks.sdk.service.settings.GetTokenResponsedataclass.
OpenAPI SHA: e05401ed5dd4974c5333d737ec308a7d451f749f, Date: 2024-01-23
v0.17.0
- Use covariant type for
@retried(on=[...])(#486). - Configure request timeout using existing parameter from Config (#489).
- Make contents of
__init__.pyequal across projects (#488). - Update SDK to Latest OpenAPI Specification (#501).
Note: This release contains breaking changes, please see below for more details.
API Changes:
- [Breaking] Changed
list()method for w.tokens workspace-level service to returndatabricks.sdk.service.settings.ListPublicTokensResponsedataclass. - Changed
list()method for w.external_locations workspace-level service to require request ofdatabricks.sdk.service.catalog.ListExternalLocationsRequestdataclass and w.storage_credentials workspace-level service to require request ofdatabricks.sdk.service.catalog.ListStorageCredentialsRequestdataclass. - Added
next_page_tokenfield fordatabricks.sdk.service.catalog.ListExternalLocationsResponse,databricks.sdk.service.catalog.ListFunctionsResponse,databricks.sdk.service.catalog.ListSchemasResponseanddatabricks.sdk.service.catalog.ListStorageCredentialsResponse. - Added
max_resultsfield fordatabricks.sdk.service.catalog.ListFunctionsRequestanddatabricks.sdk.service.catalog.ListSchemasRequest. - Added
page_tokenfield fordatabricks.sdk.service.catalog.ListFunctionsRequestanddatabricks.sdk.service.catalog.ListSchemasRequest. - Added
omit_columnsfield fordatabricks.sdk.service.catalog.ListTablesRequest. - Added
omit_propertiesfield fordatabricks.sdk.service.catalog.ListTablesRequest. - Added
init_scriptsfield fordatabricks.sdk.service.pipelines.PipelineCluster. - Added
validate_onlyfield fordatabricks.sdk.service.pipelines.StartUpdateanddatabricks.sdk.service.pipelines.UpdateInfo. - Changed
create()method for w.dashboards workspace-level service . New request type isdatabricks.sdk.service.sql.DashboardPostContentdataclass. - Added
update()method for w.dashboards workspace-level service. - Added
http_headersfield fordatabricks.sdk.service.sql.ExternalLink. - Added
run_as_rolefield fordatabricks.sdk.service.sql.QueryEditContent. - Added package:
databricks.sdk.service.dashboardsanddatabricks.sdk.service.vectorsearch. - Added dataclass:
databricks.sdk.service.catalog.ListExternalLocationsRequest,databricks.sdk.service.catalog.ListStorageCredentialsRequest,databricks.sdk.service.settings.ListPublicTokensResponse,databricks.sdk.service.sql.DashboardEditContentanddatabricks.sdk.service.sql.DashboardPostContent. - Removed dataclass:
databricks.sdk.service.catalog.TableConstraintListanddatabricks.sdk.service.sql.CreateDashboardRequest.
OpenAPI SHA: 0e0d4cbe87193e36c73b8b2be3b0dd0f1b013e00, Date: 2024-01-10
v0.16.0
- Sort imports in service template (#479).
- Add
py.typedto support PEP-561 (#483). - Fixed bug in
@retriedwhen exception subtypes were not respected (#484). - Make
WorkspaceClientandAccountClientmore friendly with autospeccing (#480).
API Changes:
- Added
azure_workspace_infofield fordatabricks.sdk.service.provisioning.Workspace. - Added
databricks.sdk.service.provisioning.AzureWorkspaceInfodataclass. - Changed
update_config()method for w.serving_endpoints workspace-level service with new required argument order. - Changed
served_entitiesfield fordatabricks.sdk.service.serving.EndpointCoreConfigInputto no longer be required. - Changed
create()method for a.account_ip_access_lists account-level service with new required argument order. - Changed
replace()method for a.account_ip_access_lists account-level service with new required argument order. - Changed
update()method for a.account_ip_access_lists account-level service with new required argument order. - Changed
create()method for w.ip_access_lists workspace-level service with new required argument order. - Changed
replace()method for w.ip_access_lists workspace-level service with new required argument order. - Changed
update()method for w.ip_access_lists workspace-level service with new required argument order. - Changed
ip_addressesfield fordatabricks.sdk.service.settings.CreateIpAccessListto no longer be required. - Changed
ip_addressesfield fordatabricks.sdk.service.settings.ReplaceIpAccessListto no longer be required. - Removed
list_idfield fordatabricks.sdk.service.settings.ReplaceIpAccessList. - Changed
enabledfield fordatabricks.sdk.service.settings.UpdateIpAccessListto no longer be required. - Changed
ip_addressesfield fordatabricks.sdk.service.settings.UpdateIpAccessListto no longer be required. - Changed
labelfield fordatabricks.sdk.service.settings.UpdateIpAccessListto no longer be required. - Removed
list_idfield fordatabricks.sdk.service.settings.UpdateIpAccessList. - Changed
list_typefield fordatabricks.sdk.service.settings.UpdateIpAccessListto no longer be required.
OpenAPI SHA: d3853c8dee5806d04da2ae8910f273ffb35719a5, Date: 2023-12-14
v0.15.0
Bugfixes:
Other changes:
- Updated GCP OAuth Readme (#464).
- Reference Documentation Refactoring (#467).
- Installed local library when generating docs (#469).
- Fixed readme links in pypi (#472).
- Updated a note for installing Python SDK on Databricks Runtime 13.1+ (#474).
- Updated GCP auth readme (#470).
API Changes:
- Changed
update()method for w.connections workspace-level service with new required argument order. - Added
cloudflare_api_tokenfield fordatabricks.sdk.service.catalog.CreateStorageCredential. - Added
cloudflare_api_tokenfield fordatabricks.sdk.service.catalog.StorageCredentialInfo. - Changed
namefield fordatabricks.sdk.service.catalog.UpdateCatalogto be required. - Added
new_namefield fordatabricks.sdk.service.catalog.UpdateCatalog. - Changed
namefield fordatabricks.sdk.service.catalog.UpdateConnectionto no longer be required. - Added
new_namefield fordatabricks.sdk.service.catalog.UpdateConnection. - Changed
namefield fordatabricks.sdk.service.catalog.UpdateExternalLocationto be required. - Added
new_namefield fordatabricks.sdk.service.catalog.UpdateExternalLocation. - Added
new_namefield fordatabricks.sdk.service.catalog.UpdateMetastore. - Added
new_namefield fordatabricks.sdk.service.catalog.UpdateRegisteredModelRequest. - Added
new_namefield fordatabricks.sdk.service.catalog.UpdateSchema. - Changed
namefield fordatabricks.sdk.service.catalog.UpdateStorageCredentialto be required. - Added
cloudflare_api_tokenfield fordatabricks.sdk.service.catalog.UpdateStorageCredential. - Added
new_namefield fordatabricks.sdk.service.catalog.UpdateStorageCredential. - Added
new_namefield fordatabricks.sdk.service.catalog.UpdateVolumeRequestContent. - Added
cloudflare_api_tokenfield fordatabricks.sdk.service.catalog.ValidateStorageCredential. - Added
databricks.sdk.service.catalog.CloudflareApiTokendataclass. - Removed
continuousfield fordatabricks.sdk.service.jobs.BaseRun. - Removed
continuousfield fordatabricks.sdk.service.jobs.Run. - Changed
job_parametersfield fordatabricks.sdk.service.jobs.RunJobTasktodatabricks.sdk.service.jobs.ParamPairsdataclass. - Added
run_iffield fordatabricks.sdk.service.jobs.SubmitTask. - Added
run_job_taskfield fordatabricks.sdk.service.jobs.SubmitTask. - Changed
update_config()method for w.serving_endpoints workspace-level service with new required argument order. - Added
put()method for w.serving_endpoints workspace-level service. - Added
rate_limitsfield fordatabricks.sdk.service.serving.CreateServingEndpoint. - Changed
served_modelsfield fordatabricks.sdk.service.serving.EndpointCoreConfigInputto no longer be required. - Added
auto_capture_configfield fordatabricks.sdk.service.serving.EndpointCoreConfigInput. - Added
served_entitiesfield fordatabricks.sdk.service.serving.EndpointCoreConfigInput. - Added
auto_capture_configfield fordatabricks.sdk.service.serving.EndpointCoreConfigOutput. - Added
served_entitiesfield fordatabricks.sdk.service.serving.EndpointCoreConfigOutput. - Added
served_entitiesfield fordatabricks.sdk.service.serving.EndpointCoreConfigSummary. - Added
served_entitiesfield fordatabricks.sdk.service.serving.EndpointPendingConfig. - Added
extra_paramsfield fordatabricks.sdk.service.serving.QueryEndpointInput. - Added
inputfield fordatabricks.sdk.service.serving.QueryEndpointInput. - Added
max_tokensfield fordatabricks.sdk.service.serving.QueryEndpointInput. - Added
messagesfield fordatabricks.sdk.service.serving.QueryEndpointInput. - Added
nfield fordatabricks.sdk.service.serving.QueryEndpointInput. - Added
promptfield fordatabricks.sdk.service.serving.QueryEndpointInput. - Added
stopfield fordatabricks.sdk.service.serving.QueryEndpointInput. - Added
streamfield fordatabricks.sdk.service.serving.QueryEndpointInput. - Added
temperaturefield fordatabricks.sdk.service.serving.QueryEndpointInput. - Changed
predictionsfield fordatabricks.sdk.service.serving.QueryEndpointResponseto no longer be required. - Added
choicesfield fordatabricks.sdk.service.serving.QueryEndpointResponse. - Added
createdfield fordatabricks.sdk.service.serving.QueryEndpointResponse. - Added
datafield fordatabricks.sdk.service.serving.QueryEndpointResponse. - Added
idfield fordatabricks.sdk.service.serving.QueryEndpointResponse. - Added
modelfield fordatabricks.sdk.service.serving.QueryEndpointResponse. - Added
objectfield fordatabricks.sdk.service.serving.QueryEndpointResponse. - Added
usagefield fordatabricks.sdk.service.serving.QueryEndpointResponse. - Changed
workload_sizefield fordatabricks.sdk.service.serving.ServedModelInputtodatabricks.sdk.service.serving.ServedModelInputWorkloadSizedataclass. - Changed
workload_typefield fordatabricks.sdk.service.serving.ServedModelInputtodatabricks.sdk.service.serving.ServedModelInputWorkloadTypedataclass. - Added
taskfield fordatabricks.sdk.service.serving.ServingEndpoint. - Added
taskfield fordatabricks.sdk.service.serving.ServingEndpointDetailed. - Added
databricks.sdk.service.serving.Ai21LabsConfigdataclass. - Added
databricks.sdk.service.serving.AnthropicConfigdataclass. - Added
databricks.sdk.service.serving.AutoCaptureConfigInputdataclass. - Added
databricks.sdk.service.serving.AutoCaptureConfigOutputdataclass. - Added
databricks.sdk.service.serving.AutoCaptureStatedataclass. - Added
databricks.sdk.service.serving.AwsBedrockConfigdataclass. - Added
databricks.sdk.service.serving.AwsBedrockConfigBedrockProviderdataclass. - Added
databricks.sdk.service.serving.ChatMessagedataclass. - Added
databricks.sdk.service.serving.ChatMessageRoledataclass. - Added
databricks.sdk.service.serving.CohereConfigdataclass. - Added
databricks.sdk.service.serving.DatabricksModelServingConfigdataclass. - Added
databricks.sdk.service.serving.EmbeddingsV1ResponseEmbeddingElementdataclass. - Added
databricks.sdk.service.serving.EmbeddingsV1ResponseEmbeddingElementObjectdataclass. - Added
databricks.sdk.service.serving.ExternalModeldataclass. - Added
databricks.sdk.service.serving.ExternalModelConfigdataclass. - Added
databricks.sdk.service.serving.ExternalModelProviderdataclass. - Added
databricks.sdk.service.serving.ExternalModelUsageElementdataclass. - Added
databricks.sdk.service.serving.FoundationModeldataclass. - Added
databricks.sdk.service.serving.OpenAiConfigdataclass. - Added
databricks.sdk.service.serving.PaLmConfigdataclass. - Added
databricks.sdk.service.serving.PayloadTabledataclass. - Added
databricks.sdk.service.serving.PutRequestdataclass. - Added
databricks.sdk.service.serving.PutResponsedataclass. - Added
databricks.sdk.service.serving.QueryEndpointResponseObjectdataclass. - Added
databricks.sdk.service.serving.RateLimitdataclass. - Added
databricks.sdk.service.serving.RateLimitKeydataclass. - Added
databricks.sdk.service.serving.RateLimitRenewalPerioddataclass. - Added
databricks.sdk.service.serving.ServedEntityInputdataclass. - Added
databricks.sdk.service.serving.ServedEntityOutputdataclass. - Added
databricks.sdk.service.serving.ServedEntitySpecdataclass. - Added
databricks.sdk.service.serving.ServedModelInputWorkloadSizedataclass. - Added
databricks.sdk.service.serving.ServedModelInputWorkloadTypedataclass. - Added
databricks.sdk.service.serving.V1ResponseChoiceElementdataclass. - Removed a.account_network_policy account-level service.
- Removed
databricks.sdk.service.settings.AccountNetworkPolicyMessagedataclass. - Removed
databricks.sdk.service.settings.DeleteAccountNetworkPolicyRequestdataclass. - Removed
databricks.sdk.service.settings.DeleteAccountNetworkPolicyResponsedataclass. - Removed
databricks.sdk.service.settings.ReadAccountNetworkPolicyRequestdataclass. - Removed
databricks.sdk.service.settings.UpdateAccountNetworkPolicyRequestdataclass. - Removed
namefield fordatabricks.sdk.service.sharing.UpdateCleanRoom. - Changed
namefield fordatabricks.sdk.service.sharing.UpdateProviderto be required. - Added
new_namefield fordatabricks.sdk.service.sharing.UpdateProvider. - Changed
namefield fordatabricks.sdk.service.sharing.UpdateRecipientto be required. - Added
new_namefield fordatabricks.sdk.service.sharing.UpdateRecipient. - Changed
namefield fordatabricks.sdk.service.sharing.UpdateShareto be required. - Added
new_namefield fordatabricks.sdk.service.sharing.UpdateShare. - Added
statement_idsfield fordatabricks.sdk.service.sql.QueryFilter. - Added
databricks.sdk.service.sql.StatementIddataclass.
OpenAPI SHA: 63caa3cb0c05045e81d3dcf2451fa990d8670f36, Date: 2023-12-12
v0.14.0
Major changes:
- GCP Auth is now supported in the Python SDK. To use Google credentials-based authentication, specify your Default Application Credentials in the
GOOGLE_CREDENTIALSenvironment variable or correspondinggoogle_credentialsparameter inConfigor the client constructors. You may provide either the path to the file containing your credentials or the credentials themselves serialized as JSON. To use Google impersonation, specify the service principal to impersonate in theDATABRICKS_GOOGLE_SERVICE_ACCOUNTenvironment variable or the correspondinggoogle_service_accountparameter inConfigor the client constructors. See #444 for the changes.
Bug fixes:
- Fix flask app example (#445).
- Fix deserialization of repeated enums (#450, #452).
- Capture stdout and stderr separately when calling Azure CLI (#460).
Other changes:
- Change the name of retries logger to
databricks.sdk.retries(#453).
API Changes:
- Added
pipeline_idfield fordatabricks.sdk.service.catalog.TableInfo. - Added
enable_predictive_optimizationfield fordatabricks.sdk.service.catalog.UpdateCataloganddatabricks.sdk.service.catalog.UpdateSchema. - Removed
databricks.sdk.service.catalog.UpdatePredictiveOptimizationanddatabricks.sdk.service.catalog.UpdatePredictiveOptimizationResponsedataclasses. - Removed
enable_optimization()method for w.metastores workspace-level service. - Added
descriptionfield fordatabricks.sdk.service.jobs.CreateJobanddatabricks.sdk.service.jobs.JobSettings. - Added
list_network_connectivity_configurations()andlist_private_endpoint_rules()methods for a.network_connectivity account-level service. - Added
databricks.sdk.service.settings.ListNccAzurePrivateEndpointRulesResponse,databricks.sdk.service.settings.ListNetworkConnectivityConfigurationsRequest,databricks.sdk.service.settings.ListNetworkConnectivityConfigurationsResponse, anddatabricks.sdk.service.settings.ListPrivateEndpointRulesRequestdataclasses.
Internal changes:
- Make ucws tests skipped when DATABRICKS_ACCOUNT_ID is present (#448).
OpenAPI SHA: 22f09783eb8a84d52026f856be3b2068f9498db3, Date: 2023-11-23
Dependency updates:
- Introduced "google-auth" dependency to support Google authentication.
v0.13.0
- Introduce more specific exceptions, like
NotFound,AlreadyExists,BadRequest,PermissionDenied,InternalError, and others (#376). This makes it easier to handle errors thrown by the Databricks API. Instead of catchingDatabricksErrorand checking the error_code field, you can catch one of these subtypes ofDatabricksError, which is more ergonomic and removes the need to rethrow exceptions that you don't want to catch. For example:
try:
return (self._ws
.permissions
.get(object_type, object_id))
except DatabricksError as e:
if e.error_code in [
"RESOURCE_DOES_NOT_EXIST",
"RESOURCE_NOT_FOUND",
"PERMISSION_DENIED",
"FEATURE_DISABLED",
"BAD_REQUEST"]:
logger.warning(...)
return None
raise RetryableError(...) from ecan be replaced with
try:
return (self._ws
.permissions
.get(object_type, object_id))
except PermissionDenied, FeatureDisabled:
logger.warning(...)
return None
except NotFound:
raise RetryableError(...)- Paginate all SCIM list requests in the SDK (#440). This change ensures that SCIM list() APIs use a default limit of 100 resources, leveraging SCIM's offset + limit pagination to batch requests to the Databricks API.
- Added taskValues support in remoteDbUtils (#406).
- Added more detailed error message on default credentials not found error (#419).
- Request management token via Azure CLI only for Service Principals and not human users (#408).
API Changes:
- Fixed
create()method for w.functions workspace-level service and correspondingdatabricks.sdk.service.catalog.CreateFunctionanddatabricks.sdk.service.catalog.FunctionInfodataclasses. - Changed
create()method for w.metastores workspace-level service with new required argument order. - Changed
storage_rootfield fordatabricks.sdk.service.catalog.CreateMetastoreto be optional. - Added
skip_validationfield fordatabricks.sdk.service.catalog.UpdateExternalLocation. - Added
librariesfield fordatabricks.sdk.service.compute.CreatePolicy,databricks.sdk.service.compute.EditPolicyanddatabricks.sdk.service.compute.Policy. - Added
init_scriptsfield fordatabricks.sdk.service.compute.EventDetails. - Added
filefield fordatabricks.sdk.service.compute.InitScriptInfo. - Added
zone_idfield fordatabricks.sdk.service.compute.InstancePoolGcpAttributes. - Added several dataclasses related to init scripts.
- Added
databricks.sdk.service.compute.LocalFileInfodataclass. - Replaced
ui_statefield withedit_modefordatabricks.sdk.service.jobs.CreateJobanddatabricks.sdk.service.jobs.JobSettings. - Replaced
databricks.sdk.service.jobs.CreateJobUiStatedataclass withdatabricks.sdk.service.jobs.CreateJobEditMode. - Added
include_resolved_valuesfield fordatabricks.sdk.service.jobs.GetRunRequest. - Replaced
databricks.sdk.service.jobs.JobSettingsUiStatedataclass withdatabricks.sdk.service.jobs.JobSettingsEditMode. - Removed a.o_auth_enrollment account-level service. This was only used to aid in OAuth enablement during the public preview of OAuth. OAuth is now enabled for all AWS E2 accounts, so usage of this API is no longer needed.
- Added
network_connectivity_config_idfield fordatabricks.sdk.service.provisioning.UpdateWorkspaceRequest. - Added a.network_connectivity account-level service.
- Added
string_shared_asfield fordatabricks.sdk.service.sharing.SharedDataObject.
Internal changes:
- Added regression question to issue template (#414).
- Made test_auth no longer fail if you have a default profile setup (#426).
OpenAPI SHA: d136ad0541f036372601bad9a4382db06c3c912d, Date: 2023-11-14
v0.12.0
- Retry on all 429 and 503, even when missing Retry-After header (#402).
- Add support for tokenless authentication for GitHub Actions configured with OpenID Connect with Azure User Managed Identity (or Service Principal) (#385).
- Reduce redundant warning messages in azure-cli credential provider (#410).
API Changes:
- Added
attributes,count,excluded_attributes,filter,sort_by,sort_order, andstart_indexfields fordatabricks.sdk.service.iam.GetAccountUserRequestanddatabricks.sdk.service.iam.GetUserRequest. - Added
schemasfield fordatabricks.sdk.service.iam.Group,databricks.sdk.service.iam.ListGroupsResponse,databricks.sdk.service.iam.ListServicePrincipalResponse,databricks.sdk.service.iam.ListUsersResponse,databricks.sdk.service.iam.ServicePrincipal, anddatabricks.sdk.service.iam.User. - Added
databricks.sdk.service.iam.GetSortOrder,databricks.sdk.service.iam.GroupSchema,databricks.sdk.service.iam.ListResponseSchema,databricks.sdk.service.iam.ServicePrincipalSchema, anddatabricks.sdk.service.iam.UserSchemadataclasses. - Added
webhook_notificationsfield fordatabricks.sdk.service.jobs.SubmitTask. - Added w.apps workspace-level service and related dataclasses
- Added a.account_network_policy account-level service and related dataclasses.
OpenAPI SHA: 5903bb39137fd76ac384b2044e425f9c56840e00, Date: 2023-10-23
v0.11.0
- Added Python 3.12 to project classifiers (#381).
- Fix serialization issues for generated resources (#382).
- Fix select spark version in staging (#388).
- Adjust token expiry window to 40 seconds because of Azure (#392).
- Add retries on
RPC token bucket limit has been exceeded(#395). - Regenerate to fix template drift (#398).
- Update OpenAPI spec to 12 Oct 2023 (#399).
Internal:
API Changes:
- Changed
download()method for a.billable_usage account-level service to start returningdatabricks.sdk.service.billing.DownloadResponsedataclass. - Added
databricks.sdk.service.billing.DownloadResponsedataclass. - Changed
delete()method for a.account_storage_credentials account-level service with new required argument order. - Changed
get()method for a.account_storage_credentials account-level service with new required argument order. - Changed
update()method for a.account_storage_credentials account-level service with new required argument order. - Added
get_bindings()method for w.workspace_bindings workspace-level service. - Added
update_bindings()method for w.workspace_bindings workspace-level service. - Removed
namefield fordatabricks.sdk.service.catalog.AccountsUpdateStorageCredential. - Added
storage_credential_namefield fordatabricks.sdk.service.catalog.AccountsUpdateStorageCredential. - Removed
namefield fordatabricks.sdk.service.catalog.DeleteAccountStorageCredentialRequest. - Added
storage_credential_namefield fordatabricks.sdk.service.catalog.DeleteAccountStorageCredentialRequest. - Removed
namefield fordatabricks.sdk.service.catalog.GetAccountStorageCredentialRequest. - Added
storage_credential_namefield fordatabricks.sdk.service.catalog.GetAccountStorageCredentialRequest. - Added
ownerfield fordatabricks.sdk.service.catalog.UpdateConnection. - Added
databricks.sdk.service.catalog.GetBindingsRequestdataclass. - Added
databricks.sdk.service.catalog.UpdateWorkspaceBindingsParametersdataclass. - Added
databricks.sdk.service.catalog.WorkspaceBindingdataclass. - Added
databricks.sdk.service.catalog.WorkspaceBindingBindingTypedataclass. - Added
databricks.sdk.service.catalog.WorkspaceBindingsResponsedataclass. - Added
specfield fordatabricks.sdk.service.compute.ClusterDetails. - Added
apply_policy_default_valuesfield fordatabricks.sdk.service.compute.ClusterSpec. - Removed
aws_attributesfield fordatabricks.sdk.service.compute.EditInstancePool. - Removed
azure_attributesfield fordatabricks.sdk.service.compute.EditInstancePool. - Removed
disk_specfield fordatabricks.sdk.service.compute.EditInstancePool. - Removed
enable_elastic_diskfield fordatabricks.sdk.service.compute.EditInstancePool. - Removed
gcp_attributesfield fordatabricks.sdk.service.compute.EditInstancePool. - Removed
preloaded_docker_imagesfield fordatabricks.sdk.service.compute.EditInstancePool. - Removed
preloaded_spark_versionsfield fordatabricks.sdk.service.compute.EditInstancePool. - Added
deploymentfield fordatabricks.sdk.service.jobs.CreateJob. - Added
ui_statefield fordatabricks.sdk.service.jobs.CreateJob. - Added
deploymentfield fordatabricks.sdk.service.jobs.JobSettings. - Added
ui_statefield fordatabricks.sdk.service.jobs.JobSettings. - Removed
condition_taskfield fordatabricks.sdk.service.jobs.RunOutput. - Added
webhook_notificationsfield fordatabricks.sdk.service.jobs.Task. - Added
databricks.sdk.service.jobs.CreateJobUiStatedataclass. - Added
databricks.sdk.service.jobs.JobDeploymentdataclass. - Added
databricks.sdk.service.jobs.JobDeploymentKinddataclass. - Added
databricks.sdk.service.jobs.JobSettingsUiStatedataclass. - Added
workload_typefield fordatabricks.sdk.service.serving.ServedModelInput. - Added
workload_typefield fordatabricks.sdk.service.serving.ServedModelOutput. - Removed a.account_network_policy account-level service.
- Changed
list()method for w.ip_access_lists workspace-level service to returndatabricks.sdk.service.settings.ListIpAccessListResponsedataclass. - Removed
databricks.sdk.service.settings.AccountNetworkPolicyMessagedataclass. - Removed
databricks.sdk.service.settings.DeleteAccountNetworkPolicyRequestdataclass. - Removed
databricks.sdk.service.settings.DeleteAccountNetworkPolicyResponsedataclass. - Removed
ip_access_listsfield fordatabricks.sdk.service.settings.GetIpAccessListResponse. - Added
ip_access_listfield fordatabricks.sdk.service.settings.GetIpAccessListResponse. - Removed
databricks.sdk.service.settings.ReadAccountNetworkPolicyRequestdataclass. - Removed
databricks.sdk.service.settings.UpdateAccountNetworkPolicyRequestdataclass. - Added
databricks.sdk.service.settings.ListIpAccessListResponsedataclass.
OpenAPI SHA: 493a76554afd3afdd15dc858773d01643f80352a, Date: 2023-10-12