databricks-sdk 0.47.0__py3-none-any.whl → 0.48.0__py3-none-any.whl

databricks/sdk/service/dashboards.py

@@ -1082,7 +1082,6 @@ class MessageErrorType(Enum):
     FUNCTION_ARGUMENTS_INVALID_JSON_EXCEPTION = "FUNCTION_ARGUMENTS_INVALID_JSON_EXCEPTION"
     FUNCTION_ARGUMENTS_INVALID_TYPE_EXCEPTION = "FUNCTION_ARGUMENTS_INVALID_TYPE_EXCEPTION"
     FUNCTION_CALL_MISSING_PARAMETER_EXCEPTION = "FUNCTION_CALL_MISSING_PARAMETER_EXCEPTION"
-    GENERATED_SQL_QUERY_TOO_LONG_EXCEPTION = "GENERATED_SQL_QUERY_TOO_LONG_EXCEPTION"
     GENERIC_CHAT_COMPLETION_EXCEPTION = "GENERIC_CHAT_COMPLETION_EXCEPTION"
     GENERIC_CHAT_COMPLETION_SERVICE_EXCEPTION = "GENERIC_CHAT_COMPLETION_SERVICE_EXCEPTION"
     GENERIC_SQL_EXEC_API_CALL_EXCEPTION = "GENERIC_SQL_EXEC_API_CALL_EXCEPTION"
@@ -1097,7 +1096,6 @@ class MessageErrorType(Enum):
     MESSAGE_CANCELLED_WHILE_EXECUTING_EXCEPTION = "MESSAGE_CANCELLED_WHILE_EXECUTING_EXCEPTION"
     MESSAGE_DELETED_WHILE_EXECUTING_EXCEPTION = "MESSAGE_DELETED_WHILE_EXECUTING_EXCEPTION"
     MESSAGE_UPDATED_WHILE_EXECUTING_EXCEPTION = "MESSAGE_UPDATED_WHILE_EXECUTING_EXCEPTION"
-    MISSING_SQL_QUERY_EXCEPTION = "MISSING_SQL_QUERY_EXCEPTION"
     NO_DEPLOYMENTS_AVAILABLE_TO_WORKSPACE = "NO_DEPLOYMENTS_AVAILABLE_TO_WORKSPACE"
     NO_QUERY_TO_VISUALIZE_EXCEPTION = "NO_QUERY_TO_VISUALIZE_EXCEPTION"
     NO_TABLES_TO_QUERY_EXCEPTION = "NO_TABLES_TO_QUERY_EXCEPTION"

databricks/sdk/service/iam.py

@@ -846,7 +846,7 @@ class ObjectPermissions:
 @dataclass
 class PartialUpdate:
     id: Optional[str] = None
-    """Unique ID in the Databricks workspace."""
+    """Unique ID for a user in the Databricks workspace."""
 
     operations: Optional[List[Patch]] = None
 
@@ -1918,7 +1918,8 @@ class User:
     groups: Optional[List[ComplexValue]] = None
 
     id: Optional[str] = None
-    """Databricks user ID."""
+    """Databricks user ID. This is automatically set by Databricks. Any value provided by the client
+    will be ignored."""
 
     name: Optional[Name] = None
 
@@ -2479,7 +2480,7 @@ class AccountGroupsAPI:
         Partially updates the details of a group.
 
         :param id: str
-          Unique ID in the Databricks workspace.
+          Unique ID for a group in the Databricks account.
         :param operations: List[:class:`Patch`] (optional)
         :param schemas: List[:class:`PatchSchema`] (optional)
           The schema of the patch request. Must be ["urn:ietf:params:scim:api:messages:2.0:PatchOp"].
@@ -2492,6 +2493,7 @@ class AccountGroupsAPI:
         if schemas is not None:
             body["schemas"] = [v.value for v in schemas]
         headers = {
+            "Accept": "application/json",
             "Content-Type": "application/json",
         }
 
@@ -2555,6 +2557,7 @@ class AccountGroupsAPI:
         if schemas is not None:
             body["schemas"] = [v.value for v in schemas]
         headers = {
+            "Accept": "application/json",
             "Content-Type": "application/json",
         }
 
@@ -2762,7 +2765,7 @@ class AccountServicePrincipalsAPI:
         Partially updates the details of a single service principal in the Databricks account.
 
         :param id: str
-          Unique ID in the Databricks workspace.
+          Unique ID for a service principal in the Databricks account.
         :param operations: List[:class:`Patch`] (optional)
         :param schemas: List[:class:`PatchSchema`] (optional)
           The schema of the patch request. Must be ["urn:ietf:params:scim:api:messages:2.0:PatchOp"].
@@ -2775,6 +2778,7 @@ class AccountServicePrincipalsAPI:
         if schemas is not None:
             body["schemas"] = [v.value for v in schemas]
         headers = {
+            "Accept": "application/json",
             "Content-Type": "application/json",
         }
 
@@ -2844,6 +2848,7 @@ class AccountServicePrincipalsAPI:
         if schemas is not None:
             body["schemas"] = [v.value for v in schemas]
         headers = {
+            "Accept": "application/json",
             "Content-Type": "application/json",
         }
 
@@ -2907,7 +2912,8 @@ class AccountUsersAPI:
           External ID is not currently supported. It is reserved for future use.
         :param groups: List[:class:`ComplexValue`] (optional)
         :param id: str (optional)
-          Databricks user ID.
+          Databricks user ID. This is automatically set by Databricks. Any value provided by the client will
+          be ignored.
         :param name: :class:`Name` (optional)
         :param roles: List[:class:`ComplexValue`] (optional)
           Corresponds to AWS instance profile/arn role.
@@ -3117,7 +3123,7 @@ class AccountUsersAPI:
         Partially updates a user resource by applying the supplied operations on specific user attributes.
 
         :param id: str
-          Unique ID in the Databricks workspace.
+          Unique ID for a user in the Databricks account.
         :param operations: List[:class:`Patch`] (optional)
         :param schemas: List[:class:`PatchSchema`] (optional)
           The schema of the patch request. Must be ["urn:ietf:params:scim:api:messages:2.0:PatchOp"].
@@ -3130,6 +3136,7 @@ class AccountUsersAPI:
         if schemas is not None:
             body["schemas"] = [v.value for v in schemas]
         headers = {
+            "Accept": "application/json",
             "Content-Type": "application/json",
         }
 
@@ -3157,7 +3164,8 @@ class AccountUsersAPI:
         Replaces a user's information with the data supplied in request.
 
         :param id: str
-          Databricks user ID.
+          Databricks user ID. This is automatically set by Databricks. Any value provided by the client will
+          be ignored.
         :param active: bool (optional)
           If this user is active
         :param display_name: str (optional)
@@ -3207,6 +3215,7 @@ class AccountUsersAPI:
         if user_name is not None:
             body["userName"] = user_name
         headers = {
+            "Accept": "application/json",
             "Content-Type": "application/json",
         }
 
@@ -3425,7 +3434,7 @@ class GroupsAPI:
         Partially updates the details of a group.
 
         :param id: str
-          Unique ID in the Databricks workspace.
+          Unique ID for a group in the Databricks workspace.
         :param operations: List[:class:`Patch`] (optional)
         :param schemas: List[:class:`PatchSchema`] (optional)
           The schema of the patch request. Must be ["urn:ietf:params:scim:api:messages:2.0:PatchOp"].
@@ -3438,6 +3447,7 @@ class GroupsAPI:
         if schemas is not None:
             body["schemas"] = [v.value for v in schemas]
         headers = {
+            "Accept": "application/json",
             "Content-Type": "application/json",
         }
 
@@ -3499,6 +3509,7 @@ class GroupsAPI:
         if schemas is not None:
             body["schemas"] = [v.value for v in schemas]
         headers = {
+            "Accept": "application/json",
             "Content-Type": "application/json",
         }
 
@@ -3911,7 +3922,7 @@ class ServicePrincipalsAPI:
         Partially updates the details of a single service principal in the Databricks workspace.
 
         :param id: str
-          Unique ID in the Databricks workspace.
+          Unique ID for a service principal in the Databricks workspace.
         :param operations: List[:class:`Patch`] (optional)
         :param schemas: List[:class:`PatchSchema`] (optional)
           The schema of the patch request. Must be ["urn:ietf:params:scim:api:messages:2.0:PatchOp"].
@@ -3924,6 +3935,7 @@ class ServicePrincipalsAPI:
         if schemas is not None:
             body["schemas"] = [v.value for v in schemas]
         headers = {
+            "Accept": "application/json",
             "Content-Type": "application/json",
         }
 
@@ -3988,6 +4000,7 @@ class ServicePrincipalsAPI:
         if schemas is not None:
             body["schemas"] = [v.value for v in schemas]
         headers = {
+            "Accept": "application/json",
             "Content-Type": "application/json",
         }
 
@@ -4046,7 +4059,8 @@ class UsersAPI:
           External ID is not currently supported. It is reserved for future use.
         :param groups: List[:class:`ComplexValue`] (optional)
         :param id: str (optional)
-          Databricks user ID.
+          Databricks user ID. This is automatically set by Databricks. Any value provided by the client will
+          be ignored.
         :param name: :class:`Name` (optional)
         :param roles: List[:class:`ComplexValue`] (optional)
           Corresponds to AWS instance profile/arn role.
@@ -4280,7 +4294,7 @@ class UsersAPI:
         Partially updates a user resource by applying the supplied operations on specific user attributes.
 
         :param id: str
-          Unique ID in the Databricks workspace.
+          Unique ID for a user in the Databricks workspace.
         :param operations: List[:class:`Patch`] (optional)
         :param schemas: List[:class:`PatchSchema`] (optional)
           The schema of the patch request. Must be ["urn:ietf:params:scim:api:messages:2.0:PatchOp"].
@@ -4293,6 +4307,7 @@ class UsersAPI:
         if schemas is not None:
             body["schemas"] = [v.value for v in schemas]
         headers = {
+            "Accept": "application/json",
             "Content-Type": "application/json",
         }
 
@@ -4341,7 +4356,8 @@ class UsersAPI:
         Replaces a user's information with the data supplied in request.
 
         :param id: str
-          Databricks user ID.
+          Databricks user ID. This is automatically set by Databricks. Any value provided by the client will
+          be ignored.
         :param active: bool (optional)
           If this user is active
         :param display_name: str (optional)
@@ -4391,6 +4407,7 @@ class UsersAPI:
         if user_name is not None:
             body["userName"] = user_name
         headers = {
+            "Accept": "application/json",
             "Content-Type": "application/json",
         }
 

databricks/sdk/service/jobs.py

@@ -3659,7 +3659,6 @@ class PerformanceTarget(Enum):
     on serverless compute should be. The performance mode on the job or pipeline should map to a
     performance setting that is passed to Cluster Manager (see cluster-common PerformanceTarget)."""
 
-    BALANCED = "BALANCED"
     COST_OPTIMIZED = "COST_OPTIMIZED"
     PERFORMANCE_OPTIMIZED = "PERFORMANCE_OPTIMIZED"
 

databricks/sdk/service/marketplace.py

@@ -1192,7 +1192,6 @@ class FileParent:
 class FileParentType(Enum):
 
     LISTING = "LISTING"
-    LISTING_RESOURCE = "LISTING_RESOURCE"
     PROVIDER = "PROVIDER"
 
 
@@ -2453,7 +2452,6 @@ class ListingType(Enum):
 
 class MarketplaceFileType(Enum):
 
-    APP = "APP"
     EMBEDDED_NOTEBOOK = "EMBEDDED_NOTEBOOK"
     PROVIDER_ICON = "PROVIDER_ICON"
 

databricks/sdk/service/ml.py

@@ -499,19 +499,27 @@ class CreateForecastingExperimentRequest:
     time_column: str
     """Name of the column in the input training table that represents the timestamp of each row."""
 
-    forecast_granularity: str
-    """The granularity of the forecast. This defines the time interval between consecutive rows in the
-    time series data. Possible values: '1 second', '1 minute', '5 minutes', '10 minutes', '15
-    minutes', '30 minutes', 'Hourly', 'Daily', 'Weekly', 'Monthly', 'Quarterly', 'Yearly'."""
+    data_granularity_unit: str
+    """The time unit of the input data granularity. Together with data_granularity_quantity field, this
+    defines the time interval between consecutive rows in the time series data. Possible values: *
+    'W' (weeks) * 'D' / 'days' / 'day' * 'hours' / 'hour' / 'hr' / 'h' * 'm' / 'minute' / 'min' /
+    'minutes' / 'T' * 'S' / 'seconds' / 'sec' / 'second' * 'M' / 'month' / 'months' * 'Q' /
+    'quarter' / 'quarters' * 'Y' / 'year' / 'years'"""
 
     forecast_horizon: int
     """The number of time steps into the future for which predictions should be made. This value
-    represents a multiple of forecast_granularity determining how far ahead the model will forecast."""
+    represents a multiple of data_granularity_unit and data_granularity_quantity determining how far
+    ahead the model will forecast."""
 
     custom_weights_column: Optional[str] = None
     """Name of the column in the input training table used to customize the weight for each time series
     to calculate weighted metrics."""
 
+    data_granularity_quantity: Optional[int] = None
+    """The quantity of the input data granularity. Together with data_granularity_unit field, this
+    defines the time interval between consecutive rows in the time series data. For now, only 1
+    second, 1/5/10/15/30 minutes, 1 hour, 1 day, 1 week, 1 month, 1 quarter, 1 year are supported."""
+
     experiment_path: Optional[str] = None
     """The path to the created experiment. This is the path where the experiment will be stored in the
     workspace."""
@@ -552,10 +560,12 @@ class CreateForecastingExperimentRequest:
         body = {}
         if self.custom_weights_column is not None:
             body["custom_weights_column"] = self.custom_weights_column
+        if self.data_granularity_quantity is not None:
+            body["data_granularity_quantity"] = self.data_granularity_quantity
+        if self.data_granularity_unit is not None:
+            body["data_granularity_unit"] = self.data_granularity_unit
         if self.experiment_path is not None:
             body["experiment_path"] = self.experiment_path
-        if self.forecast_granularity is not None:
-            body["forecast_granularity"] = self.forecast_granularity
         if self.forecast_horizon is not None:
             body["forecast_horizon"] = self.forecast_horizon
         if self.holiday_regions:
@@ -587,10 +597,12 @@ class CreateForecastingExperimentRequest:
         body = {}
         if self.custom_weights_column is not None:
             body["custom_weights_column"] = self.custom_weights_column
+        if self.data_granularity_quantity is not None:
+            body["data_granularity_quantity"] = self.data_granularity_quantity
+        if self.data_granularity_unit is not None:
+            body["data_granularity_unit"] = self.data_granularity_unit
         if self.experiment_path is not None:
             body["experiment_path"] = self.experiment_path
-        if self.forecast_granularity is not None:
-            body["forecast_granularity"] = self.forecast_granularity
         if self.forecast_horizon is not None:
             body["forecast_horizon"] = self.forecast_horizon
         if self.holiday_regions:
@@ -622,8 +634,9 @@ class CreateForecastingExperimentRequest:
         """Deserializes the CreateForecastingExperimentRequest from a dictionary."""
         return cls(
             custom_weights_column=d.get("custom_weights_column", None),
+            data_granularity_quantity=d.get("data_granularity_quantity", None),
+            data_granularity_unit=d.get("data_granularity_unit", None),
             experiment_path=d.get("experiment_path", None),
-            forecast_granularity=d.get("forecast_granularity", None),
             forecast_horizon=d.get("forecast_horizon", None),
             holiday_regions=d.get("holiday_regions", None),
             max_runtime=d.get("max_runtime", None),
@@ -6987,10 +7000,11 @@ class ForecastingAPI:
         train_data_path: str,
         target_column: str,
         time_column: str,
-        forecast_granularity: str,
+        data_granularity_unit: str,
         forecast_horizon: int,
         *,
         custom_weights_column: Optional[str] = None,
+        data_granularity_quantity: Optional[int] = None,
         experiment_path: Optional[str] = None,
         holiday_regions: Optional[List[str]] = None,
         max_runtime: Optional[int] = None,
@@ -7013,16 +7027,23 @@ class ForecastingAPI:
           this column will be used as the ground truth for model training.
         :param time_column: str
           Name of the column in the input training table that represents the timestamp of each row.
-        :param forecast_granularity: str
-          The granularity of the forecast. This defines the time interval between consecutive rows in the time
-          series data. Possible values: '1 second', '1 minute', '5 minutes', '10 minutes', '15 minutes', '30
-          minutes', 'Hourly', 'Daily', 'Weekly', 'Monthly', 'Quarterly', 'Yearly'.
+        :param data_granularity_unit: str
+          The time unit of the input data granularity. Together with data_granularity_quantity field, this
+          defines the time interval between consecutive rows in the time series data. Possible values: * 'W'
+          (weeks) * 'D' / 'days' / 'day' * 'hours' / 'hour' / 'hr' / 'h' * 'm' / 'minute' / 'min' / 'minutes'
+          / 'T' * 'S' / 'seconds' / 'sec' / 'second' * 'M' / 'month' / 'months' * 'Q' / 'quarter' / 'quarters'
+          * 'Y' / 'year' / 'years'
         :param forecast_horizon: int
           The number of time steps into the future for which predictions should be made. This value represents
-          a multiple of forecast_granularity determining how far ahead the model will forecast.
+          a multiple of data_granularity_unit and data_granularity_quantity determining how far ahead the
+          model will forecast.
         :param custom_weights_column: str (optional)
           Name of the column in the input training table used to customize the weight for each time series to
           calculate weighted metrics.
+        :param data_granularity_quantity: int (optional)
+          The quantity of the input data granularity. Together with data_granularity_unit field, this defines
+          the time interval between consecutive rows in the time series data. For now, only 1 second,
+          1/5/10/15/30 minutes, 1 hour, 1 day, 1 week, 1 month, 1 quarter, 1 year are supported.
         :param experiment_path: str (optional)
           The path to the created experiment. This is the path where the experiment will be stored in the
           workspace.
@@ -7057,10 +7078,12 @@ class ForecastingAPI:
         body = {}
         if custom_weights_column is not None:
             body["custom_weights_column"] = custom_weights_column
+        if data_granularity_quantity is not None:
+            body["data_granularity_quantity"] = data_granularity_quantity
+        if data_granularity_unit is not None:
+            body["data_granularity_unit"] = data_granularity_unit
         if experiment_path is not None:
             body["experiment_path"] = experiment_path
-        if forecast_granularity is not None:
-            body["forecast_granularity"] = forecast_granularity
         if forecast_horizon is not None:
             body["forecast_horizon"] = forecast_horizon
         if holiday_regions is not None:
@@ -7102,10 +7125,11 @@ class ForecastingAPI:
         train_data_path: str,
         target_column: str,
         time_column: str,
-        forecast_granularity: str,
+        data_granularity_unit: str,
         forecast_horizon: int,
         *,
         custom_weights_column: Optional[str] = None,
+        data_granularity_quantity: Optional[int] = None,
         experiment_path: Optional[str] = None,
         holiday_regions: Optional[List[str]] = None,
         max_runtime: Optional[int] = None,
@@ -7119,8 +7143,9 @@ class ForecastingAPI:
     ) -> ForecastingExperiment:
         return self.create_experiment(
             custom_weights_column=custom_weights_column,
+            data_granularity_quantity=data_granularity_quantity,
+            data_granularity_unit=data_granularity_unit,
             experiment_path=experiment_path,
-            forecast_granularity=forecast_granularity,
             forecast_horizon=forecast_horizon,
             holiday_regions=holiday_regions,
             max_runtime=max_runtime,

databricks/sdk/service/oauth2.py

@@ -776,13 +776,6 @@ class OidcFederationPolicy:
     endpoint. Databricks strongly recommends relying on your issuer’s well known endpoint for
     discovering public keys."""
 
-    jwks_uri: Optional[str] = None
-    """URL of the public keys used to validate the signature of federated tokens, in JWKS format. Most
-    use cases should not need to specify this field. If jwks_uri and jwks_json are both unspecified
-    (recommended), Databricks automatically fetches the public keys from your issuer’s well known
-    endpoint. Databricks strongly recommends relying on your issuer’s well known endpoint for
-    discovering public keys."""
-
     subject: Optional[str] = None
     """The required token subject, as specified in the subject claim of federated tokens. Must be
     specified for service principal federation policies. Must not be specified for account
@@ -800,8 +793,6 @@ class OidcFederationPolicy:
             body["issuer"] = self.issuer
         if self.jwks_json is not None:
             body["jwks_json"] = self.jwks_json
-        if self.jwks_uri is not None:
-            body["jwks_uri"] = self.jwks_uri
         if self.subject is not None:
             body["subject"] = self.subject
         if self.subject_claim is not None:
@@ -817,8 +808,6 @@ class OidcFederationPolicy:
             body["issuer"] = self.issuer
         if self.jwks_json is not None:
             body["jwks_json"] = self.jwks_json
-        if self.jwks_uri is not None:
-            body["jwks_uri"] = self.jwks_uri
         if self.subject is not None:
             body["subject"] = self.subject
         if self.subject_claim is not None:
@@ -832,7 +821,6 @@ class OidcFederationPolicy:
             audiences=d.get("audiences", None),
             issuer=d.get("issuer", None),
             jwks_json=d.get("jwks_json", None),
-            jwks_uri=d.get("jwks_uri", None),
             subject=d.get("subject", None),
             subject_claim=d.get("subject_claim", None),
         )

databricks/sdk/service/pipelines.py

@@ -69,7 +69,7 @@ class CreatePipeline:
 
     ingestion_definition: Optional[IngestionPipelineDefinition] = None
     """The configuration for a managed ingestion pipeline. These settings cannot be used with the
-    'libraries', 'schema', 'target', or 'catalog' settings."""
+    'libraries', 'target' or 'catalog' settings."""
 
     libraries: Optional[List[PipelineLibrary]] = None
     """Libraries or code needed by this deployment."""
@@ -95,7 +95,8 @@ class CreatePipeline:
     is thrown."""
 
     schema: Optional[str] = None
-    """The default schema (database) where tables are read from or published to."""
+    """The default schema (database) where tables are read from or published to. The presence of this
+    field implies that the pipeline is in direct publishing mode."""
 
     serverless: Optional[bool] = None
     """Whether serverless compute is enabled for this pipeline."""
@@ -104,9 +105,9 @@ class CreatePipeline:
     """DBFS root directory for storing checkpoints and tables."""
 
     target: Optional[str] = None
-    """Target schema (database) to add tables in this pipeline to. Exactly one of `schema` or `target`
-    must be specified. To publish to Unity Catalog, also specify `catalog`. This legacy field is
-    deprecated for pipeline creation in favor of the `schema` field."""
+    """Target schema (database) to add tables in this pipeline to. If not specified, no data is
+    published to the Hive metastore or Unity Catalog. To publish to Unity Catalog, also specify
+    `catalog`."""
 
     trigger: Optional[PipelineTrigger] = None
     """Which pipeline trigger to use. Deprecated: Use `continuous` instead."""
@@ -442,7 +443,7 @@ class EditPipeline:
 
     ingestion_definition: Optional[IngestionPipelineDefinition] = None
     """The configuration for a managed ingestion pipeline. These settings cannot be used with the
-    'libraries', 'schema', 'target', or 'catalog' settings."""
+    'libraries', 'target' or 'catalog' settings."""
 
     libraries: Optional[List[PipelineLibrary]] = None
     """Libraries or code needed by this deployment."""
@@ -471,7 +472,8 @@ class EditPipeline:
     is thrown."""
 
     schema: Optional[str] = None
-    """The default schema (database) where tables are read from or published to."""
+    """The default schema (database) where tables are read from or published to. The presence of this
+    field implies that the pipeline is in direct publishing mode."""
 
     serverless: Optional[bool] = None
     """Whether serverless compute is enabled for this pipeline."""
@@ -480,9 +482,9 @@ class EditPipeline:
     """DBFS root directory for storing checkpoints and tables."""
 
     target: Optional[str] = None
-    """Target schema (database) to add tables in this pipeline to. Exactly one of `schema` or `target`
-    must be specified. To publish to Unity Catalog, also specify `catalog`. This legacy field is
-    deprecated for pipeline creation in favor of the `schema` field."""
+    """Target schema (database) to add tables in this pipeline to. If not specified, no data is
+    published to the Hive metastore or Unity Catalog. To publish to Unity Catalog, also specify
+    `catalog`."""
 
     trigger: Optional[PipelineTrigger] = None
     """Which pipeline trigger to use. Deprecated: Use `continuous` instead."""
@@ -2216,7 +2218,7 @@ class PipelineSpec:
 
     ingestion_definition: Optional[IngestionPipelineDefinition] = None
     """The configuration for a managed ingestion pipeline. These settings cannot be used with the
-    'libraries', 'schema', 'target', or 'catalog' settings."""
+    'libraries', 'target' or 'catalog' settings."""
 
     libraries: Optional[List[PipelineLibrary]] = None
     """Libraries or code needed by this deployment."""
@@ -2234,7 +2236,8 @@ class PipelineSpec:
     """Restart window of this pipeline."""
 
     schema: Optional[str] = None
-    """The default schema (database) where tables are read from or published to."""
+    """The default schema (database) where tables are read from or published to. The presence of this
+    field implies that the pipeline is in direct publishing mode."""
 
     serverless: Optional[bool] = None
     """Whether serverless compute is enabled for this pipeline."""
@@ -2243,9 +2246,9 @@ class PipelineSpec:
     """DBFS root directory for storing checkpoints and tables."""
 
     target: Optional[str] = None
-    """Target schema (database) to add tables in this pipeline to. Exactly one of `schema` or `target`
-    must be specified. To publish to Unity Catalog, also specify `catalog`. This legacy field is
-    deprecated for pipeline creation in favor of the `schema` field."""
+    """Target schema (database) to add tables in this pipeline to. If not specified, no data is
+    published to the Hive metastore or Unity Catalog. To publish to Unity Catalog, also specify
+    `catalog`."""
 
     trigger: Optional[PipelineTrigger] = None
     """Which pipeline trigger to use. Deprecated: Use `continuous` instead."""
@@ -3455,7 +3458,7 @@ class PipelinesAPI:
           Unique identifier for this pipeline.
         :param ingestion_definition: :class:`IngestionPipelineDefinition` (optional)
           The configuration for a managed ingestion pipeline. These settings cannot be used with the
-          'libraries', 'schema', 'target', or 'catalog' settings.
+          'libraries', 'target' or 'catalog' settings.
         :param libraries: List[:class:`PipelineLibrary`] (optional)
           Libraries or code needed by this deployment.
         :param name: str (optional)
@@ -3473,15 +3476,15 @@ class PipelinesAPI:
           Only `user_name` or `service_principal_name` can be specified. If both are specified, an error is
           thrown.
         :param schema: str (optional)
-          The default schema (database) where tables are read from or published to.
+          The default schema (database) where tables are read from or published to. The presence of this field
+          implies that the pipeline is in direct publishing mode.
         :param serverless: bool (optional)
           Whether serverless compute is enabled for this pipeline.
         :param storage: str (optional)
           DBFS root directory for storing checkpoints and tables.
         :param target: str (optional)
-          Target schema (database) to add tables in this pipeline to. Exactly one of `schema` or `target` must
-          be specified. To publish to Unity Catalog, also specify `catalog`. This legacy field is deprecated
-          for pipeline creation in favor of the `schema` field.
+          Target schema (database) to add tables in this pipeline to. If not specified, no data is published
+          to the Hive metastore or Unity Catalog. To publish to Unity Catalog, also specify `catalog`.
         :param trigger: :class:`PipelineTrigger` (optional)
           Which pipeline trigger to use. Deprecated: Use `continuous` instead.
 
@@ -3959,7 +3962,7 @@ class PipelinesAPI:
           Unique identifier for this pipeline.
         :param ingestion_definition: :class:`IngestionPipelineDefinition` (optional)
           The configuration for a managed ingestion pipeline. These settings cannot be used with the
-          'libraries', 'schema', 'target', or 'catalog' settings.
+          'libraries', 'target' or 'catalog' settings.
         :param libraries: List[:class:`PipelineLibrary`] (optional)
           Libraries or code needed by this deployment.
         :param name: str (optional)
@@ -3977,15 +3980,15 @@ class PipelinesAPI:
           Only `user_name` or `service_principal_name` can be specified. If both are specified, an error is
           thrown.
         :param schema: str (optional)
-          The default schema (database) where tables are read from or published to.
+          The default schema (database) where tables are read from or published to. The presence of this field
+          implies that the pipeline is in direct publishing mode.
         :param serverless: bool (optional)
           Whether serverless compute is enabled for this pipeline.
         :param storage: str (optional)
           DBFS root directory for storing checkpoints and tables.
         :param target: str (optional)
-          Target schema (database) to add tables in this pipeline to. Exactly one of `schema` or `target` must
-          be specified. To publish to Unity Catalog, also specify `catalog`. This legacy field is deprecated
-          for pipeline creation in favor of the `schema` field.
+          Target schema (database) to add tables in this pipeline to. If not specified, no data is published
+          to the Hive metastore or Unity Catalog. To publish to Unity Catalog, also specify `catalog`.
         :param trigger: :class:`PipelineTrigger` (optional)
           Which pipeline trigger to use. Deprecated: Use `continuous` instead.