databricks-sdk 0.45.0__tar.gz → 0.46.0__tar.gz

{databricks_sdk-0.45.0 → databricks_sdk-0.46.0}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Version changelog
 
+## Release v0.46.0
+
+### New Features and Improvements
+* [Experimental] Add support for async token refresh ([#916](https://github.com/databricks/databricks-sdk-py/pull/916)).
+  This can be enabled with by setting the following setting:
+  ```
+  export DATABRICKS_ENABLE_EXPERIMENTAL_ASYNC_TOKEN_REFRESH=1.
+  ```
+  This feature and its setting are experimental and may be removed in future releases.
+
+### API Changes
+* Added [w.forecasting](https://databricks-sdk-py.readthedocs.io/en/latest/workspace/ml/forecasting.html) workspace-level service.
+* Added `statement_id` field for `databricks.sdk.service.dashboards.GenieQueryAttachment`.
+* Added `could_not_get_model_deployments_exception` enum value for `databricks.sdk.service.dashboards.MessageErrorType`.
+* [Breaking] Removed `jwks_uri` field for `databricks.sdk.service.oauth2.OidcFederationPolicy`.
+
+
 ## Release v0.45.0
 
 ### New Features and Improvements

{databricks_sdk-0.45.0 → databricks_sdk-0.46.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: databricks-sdk
-Version: 0.45.0
+Version: 0.46.0
 Summary: Databricks SDK for Python (Beta)
 Project-URL: Documentation, https://databricks-sdk-py.readthedocs.io
 Keywords: databricks,sdk

{databricks_sdk-0.45.0 → databricks_sdk-0.46.0}/databricks/sdk/__init__.py

@@ -8,6 +8,7 @@ import databricks.sdk.dbutils as dbutils
 import databricks.sdk.service as service
 from databricks.sdk import azure
 from databricks.sdk.credentials_provider import CredentialsStrategy
+from databricks.sdk.data_plane import DataPlaneTokenSource
 from databricks.sdk.mixins.compute import ClustersExt
 from databricks.sdk.mixins.files import DbfsExt, FilesExt
 from databricks.sdk.mixins.jobs import JobsExt
@@ -63,7 +64,8 @@ from databricks.sdk.service.marketplace import (
     ProviderExchangeFiltersAPI, ProviderExchangesAPI, ProviderFilesAPI,
     ProviderListingsAPI, ProviderPersonalizationRequestsAPI,
     ProviderProviderAnalyticsDashboardsAPI, ProviderProvidersAPI)
-from databricks.sdk.service.ml import ExperimentsAPI, ModelRegistryAPI
+from databricks.sdk.service.ml import (ExperimentsAPI, ForecastingAPI,
+                                       ModelRegistryAPI)
 from databricks.sdk.service.oauth2 import (AccountFederationPolicyAPI,
                                            CustomAppIntegrationAPI,
                                            OAuthPublishedAppsAPI,
@@ -284,8 +286,11 @@ class WorkspaceClient:
         self._secrets = service.workspace.SecretsAPI(self._api_client)
         self._service_principals = service.iam.ServicePrincipalsAPI(self._api_client)
         self._serving_endpoints = serving_endpoints
+        serving_endpoints_data_plane_token_source = DataPlaneTokenSource(
+            self._config.host, self._config.oauth_token, not self._config.enable_experimental_async_token_refresh
+        )
         self._serving_endpoints_data_plane = service.serving.ServingEndpointsDataPlaneAPI(
-            self._api_client, serving_endpoints
+            self._api_client, serving_endpoints, serving_endpoints_data_plane_token_source
         )
         self._settings = service.settings.SettingsAPI(self._api_client)
         self._shares = service.sharing.SharesAPI(self._api_client)
@@ -305,6 +310,7 @@ class WorkspaceClient:
         self._workspace = WorkspaceExt(self._api_client)
         self._workspace_bindings = service.catalog.WorkspaceBindingsAPI(self._api_client)
         self._workspace_conf = service.settings.WorkspaceConfAPI(self._api_client)
+        self._forecasting = service.ml.ForecastingAPI(self._api_client)
 
     @property
     def config(self) -> client.Config:
@@ -808,6 +814,11 @@ class WorkspaceClient:
         """This API allows updating known workspace settings for advanced users."""
         return self._workspace_conf
 
+    @property
+    def forecasting(self) -> service.ml.ForecastingAPI:
+        """The Forecasting API allows you to create and get serverless forecasting experiments."""
+        return self._forecasting
+
     def get_workspace_id(self) -> int:
         """Get the workspace ID of the workspace that this client is connected to."""
         response = self._api_client.do("GET", "/api/2.0/preview/scim/v2/Me", response_headers=["X-Databricks-Org-Id"])

{databricks_sdk-0.45.0 → databricks_sdk-0.46.0}/databricks/sdk/config.py

@@ -95,6 +95,10 @@ class Config:
     max_connections_per_pool: int = ConfigAttribute()
     databricks_environment: Optional[DatabricksEnvironment] = None
 
+    enable_experimental_async_token_refresh: bool = ConfigAttribute(
+        env="DATABRICKS_ENABLE_EXPERIMENTAL_ASYNC_TOKEN_REFRESH"
+    )
+
     enable_experimental_files_api_client: bool = ConfigAttribute(env="DATABRICKS_ENABLE_EXPERIMENTAL_FILES_API_CLIENT")
     files_api_client_download_max_total_recovers = None
     files_api_client_download_max_total_recovers_without_progressing = 1

{databricks_sdk-0.45.0 → databricks_sdk-0.46.0}/databricks/sdk/credentials_provider.py

@@ -191,6 +191,7 @@ def oauth_service_principal(cfg: "Config") -> Optional[CredentialsProvider]:
         token_url=oidc.token_endpoint,
         scopes=["all-apis"],
         use_header=True,
+        disable_async=not cfg.enable_experimental_async_token_refresh,
     )
 
     def inner() -> Dict[str, str]:
@@ -290,6 +291,7 @@ def azure_service_principal(cfg: "Config") -> CredentialsProvider:
             token_url=f"{aad_endpoint}{cfg.azure_tenant_id}/oauth2/token",
             endpoint_params={"resource": resource},
             use_params=True,
+            disable_async=not cfg.enable_experimental_async_token_refresh,
         )
 
     _ensure_host_present(cfg, token_source_for)
@@ -355,6 +357,7 @@ def github_oidc_azure(cfg: "Config") -> Optional[CredentialsProvider]:
         token_url=f"{aad_endpoint}{cfg.azure_tenant_id}/oauth2/token",
         endpoint_params=params,
         use_params=True,
+        disable_async=not cfg.enable_experimental_async_token_refresh,
     )
 
     def refreshed_headers() -> Dict[str, str]:
@@ -458,8 +461,9 @@ class CliTokenSource(Refreshable):
         token_type_field: str,
         access_token_field: str,
         expiry_field: str,
+        disable_async: bool = True,
     ):
-        super().__init__()
+        super().__init__(disable_async=disable_async)
         self._cmd = cmd
         self._token_type_field = token_type_field
         self._access_token_field = access_token_field
@@ -690,6 +694,7 @@ class DatabricksCliTokenSource(CliTokenSource):
             token_type_field="token_type",
             access_token_field="access_token",
             expiry_field="expiry",
+            disable_async=not cfg.enable_experimental_async_token_refresh,
         )
 
     @staticmethod

{databricks_sdk-0.45.0 → databricks_sdk-0.46.0}/databricks/sdk/data_plane.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import threading
 from dataclasses import dataclass
-from typing import Callable, List, Optional
+from typing import Callable, Optional
 from urllib import parse
 
 from databricks.sdk import oauth
@@ -88,61 +88,3 @@ class DataPlaneDetails:
     """URL used to query the endpoint through the DataPlane."""
     token: Token
     """Token to query the DataPlane endpoint."""
-
-
-## Old implementation. #TODO: Remove after the new implementation is used
-
-
-class DataPlaneService:
-    """Helper class to fetch and manage DataPlane details."""
-
-    from .service.serving import DataPlaneInfo
-
-    def __init__(self):
-        self._data_plane_info = {}
-        self._tokens = {}
-        self._lock = threading.Lock()
-
-    def get_data_plane_details(
-        self,
-        method: str,
-        params: List[str],
-        info_getter: Callable[[], DataPlaneInfo],
-        refresh: Callable[[str], Token],
-    ):
-        """Get and cache information required to query a Data Plane endpoint using the provided methods.
-
-        Returns a cached DataPlaneDetails if the details have already been fetched previously and are still valid.
-        If not, it uses the provided functions to fetch the details.
-
-        :param method: method name. Used to construct a unique key for the cache.
-        :param params: path params used in the "get" operation which uniquely determine the object. Used to construct a unique key for the cache.
-        :param info_getter: function which returns the DataPlaneInfo. It will only be called if the information is not already present in the cache.
-        :param refresh: function to refresh the token. It will only be called if the token is missing or expired.
-        """
-        all_elements = params.copy()
-        all_elements.insert(0, method)
-        map_key = "/".join(all_elements)
-        info = self._data_plane_info.get(map_key)
-        if not info:
-            self._lock.acquire()
-            try:
-                info = self._data_plane_info.get(map_key)
-                if not info:
-                    info = info_getter()
-                    self._data_plane_info[map_key] = info
-            finally:
-                self._lock.release()
-
-        token = self._tokens.get(map_key)
-        if not token or not token.valid:
-            self._lock.acquire()
-            token = self._tokens.get(map_key)
-            try:
-                if not token or not token.valid:
-                    token = refresh(info.authorization_details)
-                    self._tokens[map_key] = token
-            finally:
-                self._lock.release()
-
-        return DataPlaneDetails(endpoint_url=info.endpoint_url, token=token)

{databricks_sdk-0.45.0 → databricks_sdk-0.46.0}/databricks/sdk/oauth.py

@@ -426,12 +426,16 @@ class SessionCredentials(Refreshable):
         client_id: str,
         client_secret: str = None,
         redirect_url: str = None,
+        disable_async: bool = True,
     ):
         self._token_endpoint = token_endpoint
         self._client_id = client_id
         self._client_secret = client_secret
         self._redirect_url = redirect_url
-        super().__init__(token)
+        super().__init__(
+            token=token,
+            disable_async=disable_async,
+        )
 
     def as_dict(self) -> dict:
         return {"token": self.token().as_dict()}
@@ -708,9 +712,10 @@ class ClientCredentials(Refreshable):
     scopes: List[str] = None
     use_params: bool = False
     use_header: bool = False
+    disable_async: bool = True
 
     def __post_init__(self):
-        super().__init__()
+        super().__init__(disable_async=self.disable_async)
 
     def refresh(self) -> Token:
         params = {"grant_type": "client_credentials"}

{databricks_sdk-0.45.0 → databricks_sdk-0.46.0}/databricks/sdk/service/compute.py

@@ -3846,6 +3846,10 @@ class DestroyResponse:
 
 @dataclass
 class DiskSpec:
+    """Describes the disks that are launched for each instance in the spark cluster. For example, if
+    the cluster has 3 instances, each instance is configured to launch 2 disks, 100 GiB each, then
+    Databricks will launch a total of 6 disks, 100 GiB each, for this cluster."""
+
     disk_count: Optional[int] = None
     """The number of disks launched for each instance: - This feature is only enabled for supported
     node types. - Users can choose up to the limit of the disks supported by the node type. - For
@@ -3920,9 +3924,15 @@ class DiskSpec:
 
 @dataclass
 class DiskType:
+    """Describes the disk type."""
+
     azure_disk_volume_type: Optional[DiskTypeAzureDiskVolumeType] = None
+    """All Azure Disk types that Databricks supports. See
+    https://docs.microsoft.com/en-us/azure/storage/storage-about-disks-and-vhds-linux#types-of-disks"""
 
     ebs_volume_type: Optional[DiskTypeEbsVolumeType] = None
+    """All EBS volume types that Databricks supports. See https://aws.amazon.com/ebs/details/ for
+    details."""
 
     def as_dict(self) -> dict:
         """Serializes the DiskType into a dictionary suitable for use as a JSON request body."""
@@ -3952,12 +3962,16 @@ class DiskType:
 
 
 class DiskTypeAzureDiskVolumeType(Enum):
+    """All Azure Disk types that Databricks supports. See
+    https://docs.microsoft.com/en-us/azure/storage/storage-about-disks-and-vhds-linux#types-of-disks"""
 
     PREMIUM_LRS = "PREMIUM_LRS"
     STANDARD_LRS = "STANDARD_LRS"
 
 
 class DiskTypeEbsVolumeType(Enum):
+    """All EBS volume types that Databricks supports. See https://aws.amazon.com/ebs/details/ for
+    details."""
 
     GENERAL_PURPOSE_SSD = "GENERAL_PURPOSE_SSD"
     THROUGHPUT_OPTIMIZED_HDD = "THROUGHPUT_OPTIMIZED_HDD"
@@ -3998,6 +4012,7 @@ class DockerBasicAuth:
 @dataclass
 class DockerImage:
     basic_auth: Optional[DockerBasicAuth] = None
+    """Basic auth with username and password"""
 
     url: Optional[str] = None
     """URL of the docker image."""
@@ -5334,7 +5349,7 @@ class GetInstancePool:
     - Currently, Databricks allows at most 45 custom tags"""
 
     default_tags: Optional[Dict[str, str]] = None
-    """Tags that are added by Databricks regardless of any `custom_tags`, including:
+    """Tags that are added by Databricks regardless of any ``custom_tags``, including:
     
     - Vendor: Databricks
     
@@ -6250,7 +6265,7 @@ class InstancePoolAndStats:
     - Currently, Databricks allows at most 45 custom tags"""
 
     default_tags: Optional[Dict[str, str]] = None
-    """Tags that are added by Databricks regardless of any `custom_tags`, including:
+    """Tags that are added by Databricks regardless of any ``custom_tags``, including:
     
     - Vendor: Databricks
     
@@ -6427,10 +6442,10 @@ class InstancePoolAndStats:
 
 @dataclass
 class InstancePoolAwsAttributes:
+    """Attributes set during instance pool creation which are related to Amazon Web Services."""
+
     availability: Optional[InstancePoolAwsAttributesAvailability] = None
-    """Availability type used for the spot nodes.
-    
-    The default value is defined by InstancePoolConf.instancePoolDefaultAwsAvailability"""
+    """Availability type used for the spot nodes."""
 
     spot_bid_price_percent: Optional[int] = None
     """Calculates the bid price for AWS spot instances, as a percentage of the corresponding instance
@@ -6439,10 +6454,7 @@ class InstancePoolAwsAttributes:
     instances. Similarly, if this field is set to 200, the bid price is twice the price of on-demand
     `r3.xlarge` instances. If not specified, the default value is 100. When spot instances are
     requested for this cluster, only spot instances whose bid price percentage matches this field
-    will be considered. Note that, for safety, we enforce this field to be no more than 10000.
-    
-    The default value and documentation here should be kept consistent with
-    CommonConf.defaultSpotBidPricePercent and CommonConf.maxSpotBidPricePercent."""
+    will be considered. Note that, for safety, we enforce this field to be no more than 10000."""
 
     zone_id: Optional[str] = None
     """Identifier for the availability zone/datacenter in which the cluster resides. This string will
@@ -6485,9 +6497,7 @@ class InstancePoolAwsAttributes:
 
 
 class InstancePoolAwsAttributesAvailability(Enum):
-    """Availability type used for the spot nodes.
-
-    The default value is defined by InstancePoolConf.instancePoolDefaultAwsAvailability"""
+    """The set of AWS availability types supported when setting up nodes for a cluster."""
 
     ON_DEMAND = "ON_DEMAND"
     SPOT = "SPOT"
@@ -6495,14 +6505,16 @@ class InstancePoolAwsAttributesAvailability(Enum):
 
 @dataclass
 class InstancePoolAzureAttributes:
+    """Attributes set during instance pool creation which are related to Azure."""
+
     availability: Optional[InstancePoolAzureAttributesAvailability] = None
-    """Shows the Availability type used for the spot nodes.
-    
-    The default value is defined by InstancePoolConf.instancePoolDefaultAzureAvailability"""
+    """Availability type used for the spot nodes."""
 
     spot_bid_max_price: Optional[float] = None
-    """The default value and documentation here should be kept consistent with
-    CommonConf.defaultSpotBidMaxPrice."""
+    """With variable pricing, you have option to set a max price, in US dollars (USD) For example, the
+    value 2 would be a max price of $2.00 USD per hour. If you set the max price to be -1, the VM
+    won't be evicted based on price. The price for the VM will be the current price for spot or the
+    price for a standard VM, which ever is less, as long as there is capacity and quota available."""
 
     def as_dict(self) -> dict:
         """Serializes the InstancePoolAzureAttributes into a dictionary suitable for use as a JSON request body."""
@@ -6532,9 +6544,7 @@ class InstancePoolAzureAttributes:
 
 
 class InstancePoolAzureAttributesAvailability(Enum):
-    """Shows the Availability type used for the spot nodes.
-
-    The default value is defined by InstancePoolConf.instancePoolDefaultAzureAvailability"""
+    """The set of Azure availability types supported when setting up nodes for a cluster."""
 
     ON_DEMAND_AZURE = "ON_DEMAND_AZURE"
     SPOT_AZURE = "SPOT_AZURE"
@@ -6542,6 +6552,8 @@ class InstancePoolAzureAttributesAvailability(Enum):
 
 @dataclass
 class InstancePoolGcpAttributes:
+    """Attributes set during instance pool creation which are related to GCP."""
+
     gcp_availability: Optional[GcpAvailability] = None
     """This field determines whether the instance pool will contain preemptible VMs, on-demand VMs, or
     preemptible VMs with a fallback to on-demand VMs if the former is unavailable."""
@@ -6756,7 +6768,10 @@ class InstancePoolPermissionsRequest:
 
 
 class InstancePoolState(Enum):
-    """Current state of the instance pool."""
+    """The state of a Cluster. The current allowable state transitions are as follows:
+
+    - ``ACTIVE`` -> ``STOPPED`` - ``ACTIVE`` -> ``DELETED`` - ``STOPPED`` -> ``ACTIVE`` -
+    ``STOPPED`` -> ``DELETED``"""
 
     ACTIVE = "ACTIVE"
     DELETED = "DELETED"
@@ -7865,6 +7880,8 @@ class NodeType:
 
 @dataclass
 class PendingInstanceError:
+    """Error message of a failed pending instances"""
+
     instance_id: Optional[str] = None
 
     message: Optional[str] = None

{databricks_sdk-0.45.0 → databricks_sdk-0.46.0}/databricks/sdk/service/dashboards.py

@@ -594,12 +594,15 @@ class GenieMessage:
     `ASKING_AI`: Waiting for the LLM to respond to the user's question. * `PENDING_WAREHOUSE`:
     Waiting for warehouse before the SQL query can start executing. * `EXECUTING_QUERY`: Executing a
     generated SQL query. Get the SQL query result by calling
-    [getMessageQueryResult](:method:genie/getMessageQueryResult) API. * `FAILED`: The response
-    generation or query execution failed. See `error` field. * `COMPLETED`: Message processing is
-    completed. Results are in the `attachments` field. Get the SQL query result by calling
-    [getMessageQueryResult](:method:genie/getMessageQueryResult) API. * `SUBMITTED`: Message has
-    been submitted. * `QUERY_RESULT_EXPIRED`: SQL result is not available anymore. The user needs to
-    rerun the query. * `CANCELLED`: Message has been cancelled."""
+    [getMessageAttachmentQueryResult](:method:genie/getMessageAttachmentQueryResult) API. *
+    `FAILED`: The response generation or query execution failed. See `error` field. * `COMPLETED`:
+    Message processing is completed. Results are in the `attachments` field. Get the SQL query
+    result by calling
+    [getMessageAttachmentQueryResult](:method:genie/getMessageAttachmentQueryResult) API. *
+    `SUBMITTED`: Message has been submitted. * `QUERY_RESULT_EXPIRED`: SQL result is not available
+    anymore. The user needs to rerun the query. Rerun the SQL query result by calling
+    [executeMessageAttachmentQuery](:method:genie/executeMessageAttachmentQuery) API. * `CANCELLED`:
+    Message has been cancelled."""
 
     user_id: Optional[int] = None
     """ID of the user who created the message"""
@@ -697,6 +700,10 @@ class GenieQueryAttachment:
     query_result_metadata: Optional[GenieResultMetadata] = None
     """Metadata associated with the query result."""
 
+    statement_id: Optional[str] = None
+    """Statement Execution API statement id. Use [Get status, manifest, and result first
+    chunk](:method:statementexecution/getstatement) to get the full result data."""
+
     title: Optional[str] = None
     """Name of the query"""
 
@@ -713,6 +720,8 @@ class GenieQueryAttachment:
             body["query"] = self.query
         if self.query_result_metadata:
             body["query_result_metadata"] = self.query_result_metadata.as_dict()
+        if self.statement_id is not None:
+            body["statement_id"] = self.statement_id
         if self.title is not None:
             body["title"] = self.title
         return body
@@ -730,6 +739,8 @@ class GenieQueryAttachment:
             body["query"] = self.query
         if self.query_result_metadata:
             body["query_result_metadata"] = self.query_result_metadata
+        if self.statement_id is not None:
+            body["statement_id"] = self.statement_id
         if self.title is not None:
             body["title"] = self.title
         return body
@@ -743,6 +754,7 @@ class GenieQueryAttachment:
             last_updated_timestamp=d.get("last_updated_timestamp", None),
             query=d.get("query", None),
             query_result_metadata=_from_dict(d, "query_result_metadata", GenieResultMetadata),
+            statement_id=d.get("statement_id", None),
             title=d.get("title", None),
         )
 
@@ -1062,6 +1074,7 @@ class MessageErrorType(Enum):
     CHAT_COMPLETION_NETWORK_EXCEPTION = "CHAT_COMPLETION_NETWORK_EXCEPTION"
     CONTENT_FILTER_EXCEPTION = "CONTENT_FILTER_EXCEPTION"
     CONTEXT_EXCEEDED_EXCEPTION = "CONTEXT_EXCEEDED_EXCEPTION"
+    COULD_NOT_GET_MODEL_DEPLOYMENTS_EXCEPTION = "COULD_NOT_GET_MODEL_DEPLOYMENTS_EXCEPTION"
     COULD_NOT_GET_UC_SCHEMA_EXCEPTION = "COULD_NOT_GET_UC_SCHEMA_EXCEPTION"
     DEPLOYMENT_NOT_FOUND_EXCEPTION = "DEPLOYMENT_NOT_FOUND_EXCEPTION"
     FUNCTIONS_NOT_AVAILABLE_EXCEPTION = "FUNCTIONS_NOT_AVAILABLE_EXCEPTION"
@@ -1107,12 +1120,15 @@ class MessageStatus(Enum):
     `ASKING_AI`: Waiting for the LLM to respond to the user's question. * `PENDING_WAREHOUSE`:
     Waiting for warehouse before the SQL query can start executing. * `EXECUTING_QUERY`: Executing a
     generated SQL query. Get the SQL query result by calling
-    [getMessageQueryResult](:method:genie/getMessageQueryResult) API. * `FAILED`: The response
-    generation or query execution failed. See `error` field. * `COMPLETED`: Message processing is
-    completed. Results are in the `attachments` field. Get the SQL query result by calling
-    [getMessageQueryResult](:method:genie/getMessageQueryResult) API. * `SUBMITTED`: Message has
-    been submitted. * `QUERY_RESULT_EXPIRED`: SQL result is not available anymore. The user needs to
-    rerun the query. * `CANCELLED`: Message has been cancelled."""
+    [getMessageAttachmentQueryResult](:method:genie/getMessageAttachmentQueryResult) API. *
+    `FAILED`: The response generation or query execution failed. See `error` field. * `COMPLETED`:
+    Message processing is completed. Results are in the `attachments` field. Get the SQL query
+    result by calling
+    [getMessageAttachmentQueryResult](:method:genie/getMessageAttachmentQueryResult) API. *
+    `SUBMITTED`: Message has been submitted. * `QUERY_RESULT_EXPIRED`: SQL result is not available
+    anymore. The user needs to rerun the query. Rerun the SQL query result by calling
+    [executeMessageAttachmentQuery](:method:genie/executeMessageAttachmentQuery) API. * `CANCELLED`:
+    Message has been cancelled."""
 
     ASKING_AI = "ASKING_AI"
     CANCELLED = "CANCELLED"
@@ -1917,7 +1933,8 @@ class GenieAPI:
     ) -> GenieGetMessageQueryResultResponse:
         """Execute message attachment SQL query.
 
-        Execute the SQL for a message query attachment.
+        Execute the SQL for a message query attachment. Use this API when the query attachment has expired and
+        needs to be re-executed.
 
         :param space_id: str
           Genie space ID
@@ -1945,7 +1962,7 @@ class GenieAPI:
     def execute_message_query(
         self, space_id: str, conversation_id: str, message_id: str
     ) -> GenieGetMessageQueryResultResponse:
-        """Execute SQL query in a conversation message.
+        """[Deprecated] Execute SQL query in a conversation message.
 
         Execute the SQL query in the message.
 
@@ -2059,7 +2076,7 @@ class GenieAPI:
     def get_message_query_result_by_attachment(
         self, space_id: str, conversation_id: str, message_id: str, attachment_id: str
     ) -> GenieGetMessageQueryResultResponse:
-        """[deprecated] Get conversation message SQL query result.
+        """[Deprecated] Get conversation message SQL query result.
 
         Get the result of SQL query if the message has a query attachment. This is only available if a message
         has a query attachment and the message status is `EXECUTING_QUERY` OR `COMPLETED`.
@@ -2088,9 +2105,9 @@ class GenieAPI:
         return GenieGetMessageQueryResultResponse.from_dict(res)
 
     def get_space(self, space_id: str) -> GenieSpace:
-        """Get details of a Genie Space.
+        """Get Genie Space.
 
-        Get a Genie Space.
+        Get details of a Genie Space.
 
         :param space_id: str
           The ID associated with the Genie space

{databricks_sdk-0.45.0 → databricks_sdk-0.46.0}/databricks/sdk/service/files.py

@@ -314,12 +314,14 @@ class DirectoryEntry:
 @dataclass
 class DownloadResponse:
     content_length: Optional[int] = None
+    """The length of the HTTP response body in bytes."""
 
     content_type: Optional[str] = None
 
     contents: Optional[BinaryIO] = None
 
     last_modified: Optional[str] = None
+    """The last modified time of the file in HTTP-date (RFC 7231) format."""
 
     def as_dict(self) -> dict:
         """Serializes the DownloadResponse into a dictionary suitable for use as a JSON request body."""
@@ -430,10 +432,12 @@ class GetDirectoryMetadataResponse:
 @dataclass
 class GetMetadataResponse:
     content_length: Optional[int] = None
+    """The length of the HTTP response body in bytes."""
 
     content_type: Optional[str] = None
 
     last_modified: Optional[str] = None
+    """The last modified time of the file in HTTP-date (RFC 7231) format."""
 
     def as_dict(self) -> dict:
         """Serializes the GetMetadataResponse into a dictionary suitable for use as a JSON request body."""