databricks-sdk 0.19.1__py3-none-any.whl → 0.21.0__py3-none-any.whl

databricks/sdk/service/jobs.py

@@ -170,9 +170,9 @@ class BaseRun:
     One time triggers that fire a single run. This occurs you triggered a single run on demand
     through the UI or the API. * `RETRY`: Indicates a run that is triggered as a retry of a
     previously failed run. This occurs when you request to re-run the job in case of failures. *
-    `RUN_JOB_TASK`: Indicates a run that is triggered using a Run Job task.
-    
-    * `FILE_ARRIVAL`: Indicates a run that is triggered by a file arrival."""
+    `RUN_JOB_TASK`: Indicates a run that is triggered using a Run Job task. * `FILE_ARRIVAL`:
+    Indicates a run that is triggered by a file arrival. * `TABLE`: Indicates a run that is
+    triggered by a table update."""
 
     trigger_info: Optional[TriggerInfo] = None
 
@@ -261,6 +261,20 @@ class CancelAllRuns:
         return cls(all_queued_runs=d.get('all_queued_runs', None), job_id=d.get('job_id', None))
 
 
+@dataclass
+class CancelAllRunsResponse:
+
+    def as_dict(self) -> dict:
+        """Serializes the CancelAllRunsResponse into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, any]) -> CancelAllRunsResponse:
+        """Deserializes the CancelAllRunsResponse from a dictionary."""
+        return cls()
+
+
 @dataclass
 class CancelRun:
     run_id: int
@@ -278,6 +292,20 @@ class CancelRun:
         return cls(run_id=d.get('run_id', None))
 
 
+@dataclass
+class CancelRunResponse:
+
+    def as_dict(self) -> dict:
+        """Serializes the CancelRunResponse into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, any]) -> CancelRunResponse:
+        """Deserializes the CancelRunResponse from a dictionary."""
+        return cls()
+
+
 @dataclass
 class ClusterInstance:
     cluster_id: Optional[str] = None
@@ -340,6 +368,12 @@ class ClusterSpec:
                    new_cluster=_from_dict(d, 'new_cluster', compute.ClusterSpec))
 
 
+class Condition(Enum):
+
+    ALL_UPDATED = 'ALL_UPDATED'
+    ANY_UPDATED = 'ANY_UPDATED'
+
+
 @dataclass
 class ConditionTask:
     left: Optional[str] = None
@@ -512,9 +546,9 @@ class CreateJob:
     """An optional timeout applied to each run of this job. A value of `0` means no timeout."""
 
     trigger: Optional[TriggerSettings] = None
-    """Trigger settings for the job. Can be used to trigger a run when new files arrive in an external
-    location. The default behavior is that the job runs only when triggered by clicking “Run
-    Now” in the Jobs UI or sending an API request to `runNow`."""
+    """A configuration to trigger a run when certain conditions are met. The default behavior is that
+    the job runs only when triggered by clicking “Run Now” in the Jobs UI or sending an API
+    request to `runNow`."""
 
     webhook_notifications: Optional[WebhookNotifications] = None
     """A collection of system notification IDs to notify when runs of this job begin or complete."""
@@ -738,6 +772,20 @@ class DeleteJob:
         return cls(job_id=d.get('job_id', None))
 
 
+@dataclass
+class DeleteResponse:
+
+    def as_dict(self) -> dict:
+        """Serializes the DeleteResponse into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, any]) -> DeleteResponse:
+        """Deserializes the DeleteResponse from a dictionary."""
+        return cls()
+
+
 @dataclass
 class DeleteRun:
     run_id: int
@@ -755,6 +803,20 @@ class DeleteRun:
         return cls(run_id=d.get('run_id', None))
 
 
+@dataclass
+class DeleteRunResponse:
+
+    def as_dict(self) -> dict:
+        """Serializes the DeleteRunResponse into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, any]) -> DeleteRunResponse:
+        """Deserializes the DeleteRunResponse from a dictionary."""
+        return cls()
+
+
 @dataclass
 class ExportRunOutput:
     views: Optional[List[ViewItem]] = None
@@ -838,7 +900,7 @@ class ForEachTask:
     task: Task
 
     concurrency: Optional[int] = None
-    """Controls the number of active iterations task runs. Default is 100 (maximal value)."""
+    """Controls the number of active iterations task runs. Default is 20, maximum allowed is 100."""
 
     def as_dict(self) -> dict:
         """Serializes the ForEachTask into a dictionary suitable for use as a JSON request body."""
@@ -1061,9 +1123,6 @@ class Job:
     """Settings for this job and all of its runs. These settings can be updated using the `resetJob`
     method."""
 
-    trigger_history: Optional[TriggerHistory] = None
-    """History of the file arrival trigger associated with the job."""
-
     def as_dict(self) -> dict:
         """Serializes the Job into a dictionary suitable for use as a JSON request body."""
         body = {}
@@ -1072,7 +1131,6 @@ class Job:
         if self.job_id is not None: body['job_id'] = self.job_id
         if self.run_as_user_name is not None: body['run_as_user_name'] = self.run_as_user_name
         if self.settings: body['settings'] = self.settings.as_dict()
-        if self.trigger_history: body['trigger_history'] = self.trigger_history.as_dict()
         return body
 
     @classmethod
@@ -1082,8 +1140,7 @@ class Job:
                    creator_user_name=d.get('creator_user_name', None),
                    job_id=d.get('job_id', None),
                    run_as_user_name=d.get('run_as_user_name', None),
-                   settings=_from_dict(d, 'settings', JobSettings),
-                   trigger_history=_from_dict(d, 'trigger_history', TriggerHistory))
+                   settings=_from_dict(d, 'settings', JobSettings))
 
 
 @dataclass
@@ -1591,9 +1648,9 @@ class JobSettings:
     """An optional timeout applied to each run of this job. A value of `0` means no timeout."""
 
     trigger: Optional[TriggerSettings] = None
-    """Trigger settings for the job. Can be used to trigger a run when new files arrive in an external
-    location. The default behavior is that the job runs only when triggered by clicking “Run
-    Now” in the Jobs UI or sending an API request to `runNow`."""
+    """A configuration to trigger a run when certain conditions are met. The default behavior is that
+    the job runs only when triggered by clicking “Run Now” in the Jobs UI or sending an API
+    request to `runNow`."""
 
     webhook_notifications: Optional[WebhookNotifications] = None
     """A collection of system notification IDs to notify when runs of this job begin or complete."""
@@ -1776,13 +1833,13 @@ class ListJobsResponse:
     """If true, additional jobs matching the provided filter are available for listing."""
 
     jobs: Optional[List[BaseJob]] = None
-    """The list of jobs."""
+    """The list of jobs. Only included in the response if there are jobs to list."""
 
     next_page_token: Optional[str] = None
-    """A token that can be used to list the next page of jobs."""
+    """A token that can be used to list the next page of jobs (if applicable)."""
 
     prev_page_token: Optional[str] = None
-    """A token that can be used to list the previous page of jobs."""
+    """A token that can be used to list the previous page of jobs (if applicable)."""
 
     def as_dict(self) -> dict:
         """Serializes the ListJobsResponse into a dictionary suitable for use as a JSON request body."""
@@ -1808,13 +1865,14 @@ class ListRunsResponse:
     """If true, additional runs matching the provided filter are available for listing."""
 
     next_page_token: Optional[str] = None
-    """A token that can be used to list the next page of runs."""
+    """A token that can be used to list the next page of runs (if applicable)."""
 
     prev_page_token: Optional[str] = None
-    """A token that can be used to list the previous page of runs."""
+    """A token that can be used to list the previous page of runs (if applicable)."""
 
     runs: Optional[List[BaseRun]] = None
-    """A list of runs, from most recently started to least."""
+    """A list of runs, from most recently started to least. Only included in the response if there are
+    runs to list."""
 
     def as_dict(self) -> dict:
         """Serializes the ListRunsResponse into a dictionary suitable for use as a JSON request body."""
@@ -1883,7 +1941,7 @@ class NotebookTask:
     :method:jobs/runNow with parameters specified, the two parameters maps are merged. If the same
     key is specified in `base_parameters` and in `run-now`, the value from `run-now` is used.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
     
     If the notebook takes a parameter that is not specified in the job’s `base_parameters` or the
     `run-now` override parameters, the default value from the notebook is used.
@@ -1892,8 +1950,8 @@ class NotebookTask:
     
     The JSON representation of this field cannot exceed 1MB.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
-    [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html#dbutils-widgets"""
+    [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html#dbutils-widgets
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     source: Optional[Source] = None
     """Optional location type of the notebook. When set to `WORKSPACE`, the notebook will be retrieved
@@ -2084,8 +2142,9 @@ class RepairRun:
     be specified in conjunction with notebook_params. The JSON representation of this field (for
     example `{"jar_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables](/jobs.html"#parameter-variables") to set parameters containing
-    information about job runs."""
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
+    
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     job_parameters: Optional[Dict[str, str]] = None
     """Job-level parameters used in the run. for example `"param": "overriding_val"`"""
@@ -2103,13 +2162,13 @@ class RepairRun:
     
     notebook_params cannot be specified in conjunction with jar_params.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
     
     The JSON representation of this field (for example `{"notebook_params":{"name":"john
     doe","age":"35"}}`) cannot exceed 10,000 bytes.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
-    [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html"""
+    [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     pipeline_params: Optional[PipelineParams] = None
 
@@ -2123,7 +2182,7 @@ class RepairRun:
     `run-now`, it would overwrite the parameters specified in job setting. The JSON representation
     of this field (for example `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
     
     Important
     
@@ -2131,7 +2190,7 @@ class RepairRun:
     returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
     emojis.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     rerun_all_failed_tasks: Optional[bool] = None
     """If true, repair all failed tasks. Only one of `rerun_tasks` or `rerun_all_failed_tasks` can be
@@ -2151,7 +2210,7 @@ class RepairRun:
     parameters specified in job setting. The JSON representation of this field (for example
     `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables] to set parameters containing information about job runs
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
     
     Important
     
@@ -2159,7 +2218,7 @@ class RepairRun:
     returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
     emojis.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     sql_params: Optional[Dict[str, str]] = None
     """A map from keys to values for jobs with SQL task, for example `"sql_params": {"name": "john
@@ -2246,6 +2305,20 @@ class ResetJob:
         return cls(job_id=d.get('job_id', None), new_settings=_from_dict(d, 'new_settings', JobSettings))
 
 
+@dataclass
+class ResetResponse:
+
+    def as_dict(self) -> dict:
+        """Serializes the ResetResponse into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, any]) -> ResetResponse:
+        """Deserializes the ResetResponse from a dictionary."""
+        return cls()
+
+
 @dataclass
 class ResolvedConditionTaskValues:
     left: Optional[str] = None
@@ -2538,9 +2611,9 @@ class Run:
     One time triggers that fire a single run. This occurs you triggered a single run on demand
     through the UI or the API. * `RETRY`: Indicates a run that is triggered as a retry of a
     previously failed run. This occurs when you request to re-run the job in case of failures. *
-    `RUN_JOB_TASK`: Indicates a run that is triggered using a Run Job task.
-    
-    * `FILE_ARRIVAL`: Indicates a run that is triggered by a file arrival."""
+    `RUN_JOB_TASK`: Indicates a run that is triggered using a Run Job task. * `FILE_ARRIVAL`:
+    Indicates a run that is triggered by a file arrival. * `TABLE`: Indicates a run that is
+    triggered by a table update."""
 
     trigger_info: Optional[TriggerInfo] = None
 
@@ -2656,7 +2729,7 @@ class RunConditionTaskOp(Enum):
 @dataclass
 class RunForEachTask:
     concurrency: Optional[int] = None
-    """Controls the number of active iterations task runs. Default is 100 (maximal value)."""
+    """Controls the number of active iterations task runs. Default is 20, maximum allowed is 100."""
 
     inputs: Optional[str] = None
     """Array for task to iterate on. This can be a JSON string or a reference to an array parameter."""
@@ -2793,8 +2866,9 @@ class RunNow:
     be specified in conjunction with notebook_params. The JSON representation of this field (for
     example `{"jar_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables](/jobs.html"#parameter-variables") to set parameters containing
-    information about job runs."""
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
+    
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     job_parameters: Optional[Dict[str, str]] = None
     """Job-level parameters used in the run. for example `"param": "overriding_val"`"""
@@ -2808,13 +2882,13 @@ class RunNow:
     
     notebook_params cannot be specified in conjunction with jar_params.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
     
     The JSON representation of this field (for example `{"notebook_params":{"name":"john
     doe","age":"35"}}`) cannot exceed 10,000 bytes.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
-    [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html"""
+    [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     pipeline_params: Optional[PipelineParams] = None
 
@@ -2828,7 +2902,7 @@ class RunNow:
     `run-now`, it would overwrite the parameters specified in job setting. The JSON representation
     of this field (for example `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
     
     Important
     
@@ -2836,7 +2910,7 @@ class RunNow:
     returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
     emojis.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     queue: Optional[QueueSettings] = None
     """The queue settings of the run."""
@@ -2848,7 +2922,7 @@ class RunNow:
     parameters specified in job setting. The JSON representation of this field (for example
     `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables] to set parameters containing information about job runs
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
     
     Important
     
@@ -2856,7 +2930,7 @@ class RunNow:
     returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
     emojis.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     sql_params: Optional[Dict[str, str]] = None
     """A map from keys to values for jobs with SQL task, for example `"sql_params": {"name": "john
@@ -2998,8 +3072,9 @@ class RunParameters:
     be specified in conjunction with notebook_params. The JSON representation of this field (for
     example `{"jar_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables](/jobs.html"#parameter-variables") to set parameters containing
-    information about job runs."""
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
+    
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     job_parameters: Optional[Dict[str, str]] = None
     """Job-level parameters used in the run. for example `"param": "overriding_val"`"""
@@ -3013,13 +3088,13 @@ class RunParameters:
     
     notebook_params cannot be specified in conjunction with jar_params.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
     
     The JSON representation of this field (for example `{"notebook_params":{"name":"john
     doe","age":"35"}}`) cannot exceed 10,000 bytes.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
-    [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html"""
+    [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     pipeline_params: Optional[PipelineParams] = None
 
@@ -3033,7 +3108,7 @@ class RunParameters:
     `run-now`, it would overwrite the parameters specified in job setting. The JSON representation
     of this field (for example `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
     
     Important
     
@@ -3041,7 +3116,7 @@ class RunParameters:
     returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
     emojis.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     spark_submit_params: Optional[List[str]] = None
     """A list of parameters for jobs with spark submit task, for example `"spark_submit_params":
@@ -3050,7 +3125,7 @@ class RunParameters:
     parameters specified in job setting. The JSON representation of this field (for example
     `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables] to set parameters containing information about job runs
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
     
     Important
     
@@ -3058,7 +3133,7 @@ class RunParameters:
     returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
     emojis.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     sql_params: Optional[Dict[str, str]] = None
     """A map from keys to values for jobs with SQL task, for example `"sql_params": {"name": "john
@@ -3405,9 +3480,9 @@ class SparkJarTask:
     parameters: Optional[List[str]] = None
     """Parameters passed to the main method.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     def as_dict(self) -> dict:
         """Serializes the SparkJarTask into a dictionary suitable for use as a JSON request body."""
@@ -3436,9 +3511,9 @@ class SparkPythonTask:
     parameters: Optional[List[str]] = None
     """Command line parameters passed to the Python file.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     source: Optional[Source] = None
     """Optional location type of the Python file. When set to `WORKSPACE` or not specified, the file
@@ -3470,9 +3545,9 @@ class SparkSubmitTask:
     parameters: Optional[List[str]] = None
     """Command-line parameters passed to spark submit.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html"""
 
     def as_dict(self) -> dict:
         """Serializes the SparkSubmitTask into a dictionary suitable for use as a JSON request body."""
@@ -4137,6 +4212,44 @@ class SubmitTask:
                    webhook_notifications=_from_dict(d, 'webhook_notifications', WebhookNotifications))
 
 
+@dataclass
+class TableTriggerConfiguration:
+    condition: Optional[Condition] = None
+    """The table(s) condition based on which to trigger a job run."""
+
+    min_time_between_triggers_seconds: Optional[int] = None
+    """If set, the trigger starts a run only after the specified amount of time has passed since the
+    last time the trigger fired. The minimum allowed value is 60 seconds."""
+
+    table_names: Optional[List[str]] = None
+    """A list of Delta tables to monitor for changes. The table name must be in the format
+    `catalog_name.schema_name.table_name`."""
+
+    wait_after_last_change_seconds: Optional[int] = None
+    """If set, the trigger starts a run only after no table updates have occurred for the specified
+    time and can be used to wait for a series of table updates before triggering a run. The minimum
+    allowed value is 60 seconds."""
+
+    def as_dict(self) -> dict:
+        """Serializes the TableTriggerConfiguration into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.condition is not None: body['condition'] = self.condition.value
+        if self.min_time_between_triggers_seconds is not None:
+            body['min_time_between_triggers_seconds'] = self.min_time_between_triggers_seconds
+        if self.table_names: body['table_names'] = [v for v in self.table_names]
+        if self.wait_after_last_change_seconds is not None:
+            body['wait_after_last_change_seconds'] = self.wait_after_last_change_seconds
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, any]) -> TableTriggerConfiguration:
+        """Deserializes the TableTriggerConfiguration from a dictionary."""
+        return cls(condition=_enum(d, 'condition', Condition),
+                   min_time_between_triggers_seconds=d.get('min_time_between_triggers_seconds', None),
+                   table_names=d.get('table_names', None),
+                   wait_after_last_change_seconds=d.get('wait_after_last_change_seconds', None))
+
+
 @dataclass
 class Task:
     task_key: str
@@ -4434,62 +4547,6 @@ class TaskNotificationSettings:
                    no_alert_for_skipped_runs=d.get('no_alert_for_skipped_runs', None))
 
 
-@dataclass
-class TriggerEvaluation:
-    description: Optional[str] = None
-    """Human-readable description of the the trigger evaluation result. Explains why the trigger
-    evaluation triggered or did not trigger a run, or failed."""
-
-    run_id: Optional[int] = None
-    """The ID of the run that was triggered by the trigger evaluation. Only returned if a run was
-    triggered."""
-
-    timestamp: Optional[int] = None
-    """Timestamp at which the trigger was evaluated."""
-
-    def as_dict(self) -> dict:
-        """Serializes the TriggerEvaluation into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        if self.description is not None: body['description'] = self.description
-        if self.run_id is not None: body['run_id'] = self.run_id
-        if self.timestamp is not None: body['timestamp'] = self.timestamp
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, any]) -> TriggerEvaluation:
-        """Deserializes the TriggerEvaluation from a dictionary."""
-        return cls(description=d.get('description', None),
-                   run_id=d.get('run_id', None),
-                   timestamp=d.get('timestamp', None))
-
-
-@dataclass
-class TriggerHistory:
-    last_failed: Optional[TriggerEvaluation] = None
-    """The last time the trigger failed to evaluate."""
-
-    last_not_triggered: Optional[TriggerEvaluation] = None
-    """The last time the trigger was evaluated but did not trigger a run."""
-
-    last_triggered: Optional[TriggerEvaluation] = None
-    """The last time the run was triggered due to a file arrival."""
-
-    def as_dict(self) -> dict:
-        """Serializes the TriggerHistory into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        if self.last_failed: body['last_failed'] = self.last_failed.as_dict()
-        if self.last_not_triggered: body['last_not_triggered'] = self.last_not_triggered.as_dict()
-        if self.last_triggered: body['last_triggered'] = self.last_triggered.as_dict()
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, any]) -> TriggerHistory:
-        """Deserializes the TriggerHistory from a dictionary."""
-        return cls(last_failed=_from_dict(d, 'last_failed', TriggerEvaluation),
-                   last_not_triggered=_from_dict(d, 'last_not_triggered', TriggerEvaluation),
-                   last_triggered=_from_dict(d, 'last_triggered', TriggerEvaluation))
-
-
 @dataclass
 class TriggerInfo:
     run_id: Optional[int] = None
@@ -4515,18 +4572,23 @@ class TriggerSettings:
     pause_status: Optional[PauseStatus] = None
     """Whether this trigger is paused or not."""
 
+    table: Optional[TableTriggerConfiguration] = None
+    """Table trigger settings."""
+
     def as_dict(self) -> dict:
         """Serializes the TriggerSettings into a dictionary suitable for use as a JSON request body."""
         body = {}
         if self.file_arrival: body['file_arrival'] = self.file_arrival.as_dict()
         if self.pause_status is not None: body['pause_status'] = self.pause_status.value
+        if self.table: body['table'] = self.table.as_dict()
         return body
 
     @classmethod
     def from_dict(cls, d: Dict[str, any]) -> TriggerSettings:
         """Deserializes the TriggerSettings from a dictionary."""
         return cls(file_arrival=_from_dict(d, 'file_arrival', FileArrivalTriggerConfiguration),
-                   pause_status=_enum(d, 'pause_status', PauseStatus))
+                   pause_status=_enum(d, 'pause_status', PauseStatus),
+                   table=_from_dict(d, 'table', TableTriggerConfiguration))
 
 
 class TriggerType(Enum):
@@ -4536,15 +4598,16 @@ class TriggerType(Enum):
     One time triggers that fire a single run. This occurs you triggered a single run on demand
     through the UI or the API. * `RETRY`: Indicates a run that is triggered as a retry of a
     previously failed run. This occurs when you request to re-run the job in case of failures. *
-    `RUN_JOB_TASK`: Indicates a run that is triggered using a Run Job task.
-    
-    * `FILE_ARRIVAL`: Indicates a run that is triggered by a file arrival."""
+    `RUN_JOB_TASK`: Indicates a run that is triggered using a Run Job task. * `FILE_ARRIVAL`:
+    Indicates a run that is triggered by a file arrival. * `TABLE`: Indicates a run that is
+    triggered by a table update."""
 
     FILE_ARRIVAL = 'FILE_ARRIVAL'
     ONE_TIME = 'ONE_TIME'
     PERIODIC = 'PERIODIC'
     RETRY = 'RETRY'
     RUN_JOB_TASK = 'RUN_JOB_TASK'
+    TABLE = 'TABLE'
 
 
 @dataclass
@@ -4584,6 +4647,20 @@ class UpdateJob:
                    new_settings=_from_dict(d, 'new_settings', JobSettings))
 
 
+@dataclass
+class UpdateResponse:
+
+    def as_dict(self) -> dict:
+        """Serializes the UpdateResponse into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, any]) -> UpdateResponse:
+        """Deserializes the UpdateResponse from a dictionary."""
+        return cls()
+
+
 @dataclass
 class ViewItem:
     content: Optional[str] = None
@@ -4771,6 +4848,7 @@ class JobsAPI:
         if all_queued_runs is not None: body['all_queued_runs'] = all_queued_runs
         if job_id is not None: body['job_id'] = job_id
         headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
+
         self._api.do('POST', '/api/2.1/jobs/runs/cancel-all', body=body, headers=headers)
 
     def cancel_run(self, run_id: int) -> Wait[Run]:
@@ -4789,8 +4867,11 @@ class JobsAPI:
         body = {}
         if run_id is not None: body['run_id'] = run_id
         headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
-        self._api.do('POST', '/api/2.1/jobs/runs/cancel', body=body, headers=headers)
-        return Wait(self.wait_get_run_job_terminated_or_skipped, run_id=run_id)
+
+        op_response = self._api.do('POST', '/api/2.1/jobs/runs/cancel', body=body, headers=headers)
+        return Wait(self.wait_get_run_job_terminated_or_skipped,
+                    response=CancelRunResponse.from_dict(op_response),
+                    run_id=run_id)
 
     def cancel_run_and_wait(self, run_id: int, timeout=timedelta(minutes=20)) -> Run:
         return self.cancel_run(run_id=run_id).result(timeout=timeout)
@@ -4901,9 +4982,9 @@ class JobsAPI:
         :param timeout_seconds: int (optional)
           An optional timeout applied to each run of this job. A value of `0` means no timeout.
         :param trigger: :class:`TriggerSettings` (optional)
-          Trigger settings for the job. Can be used to trigger a run when new files arrive in an external
-          location. The default behavior is that the job runs only when triggered by clicking “Run Now” in
-          the Jobs UI or sending an API request to `runNow`.
+          A configuration to trigger a run when certain conditions are met. The default behavior is that the
+          job runs only when triggered by clicking “Run Now” in the Jobs UI or sending an API request to
+          `runNow`.
         :param webhook_notifications: :class:`WebhookNotifications` (optional)
           A collection of system notification IDs to notify when runs of this job begin or complete.
         
@@ -4935,6 +5016,7 @@ class JobsAPI:
         if trigger is not None: body['trigger'] = trigger.as_dict()
         if webhook_notifications is not None: body['webhook_notifications'] = webhook_notifications.as_dict()
         headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
+
         res = self._api.do('POST', '/api/2.1/jobs/create', body=body, headers=headers)
         return CreateResponse.from_dict(res)
 
@@ -4951,6 +5033,7 @@ class JobsAPI:
         body = {}
         if job_id is not None: body['job_id'] = job_id
         headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
+
         self._api.do('POST', '/api/2.1/jobs/delete', body=body, headers=headers)
 
     def delete_run(self, run_id: int):
@@ -4966,6 +5049,7 @@ class JobsAPI:
         body = {}
         if run_id is not None: body['run_id'] = run_id
         headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
+
         self._api.do('POST', '/api/2.1/jobs/runs/delete', body=body, headers=headers)
 
     def export_run(self, run_id: int, *, views_to_export: Optional[ViewsToExport] = None) -> ExportRunOutput:
@@ -4985,6 +5069,7 @@ class JobsAPI:
         if run_id is not None: query['run_id'] = run_id
         if views_to_export is not None: query['views_to_export'] = views_to_export.value
         headers = {'Accept': 'application/json', }
+
         res = self._api.do('GET', '/api/2.1/jobs/runs/export', query=query, headers=headers)
         return ExportRunOutput.from_dict(res)
 
@@ -5002,6 +5087,7 @@ class JobsAPI:
         query = {}
         if job_id is not None: query['job_id'] = job_id
         headers = {'Accept': 'application/json', }
+
         res = self._api.do('GET', '/api/2.1/jobs/get', query=query, headers=headers)
         return Job.from_dict(res)
 
@@ -5017,6 +5103,7 @@ class JobsAPI:
         """
 
         headers = {'Accept': 'application/json', }
+
         res = self._api.do('GET', f'/api/2.0/permissions/jobs/{job_id}/permissionLevels', headers=headers)
         return GetJobPermissionLevelsResponse.from_dict(res)
 
@@ -5032,6 +5119,7 @@ class JobsAPI:
         """
 
         headers = {'Accept': 'application/json', }
+
         res = self._api.do('GET', f'/api/2.0/permissions/jobs/{job_id}', headers=headers)
         return JobPermissions.from_dict(res)
 
@@ -5059,6 +5147,7 @@ class JobsAPI:
         if include_resolved_values is not None: query['include_resolved_values'] = include_resolved_values
         if run_id is not None: query['run_id'] = run_id
         headers = {'Accept': 'application/json', }
+
         res = self._api.do('GET', '/api/2.1/jobs/runs/get', query=query, headers=headers)
         return Run.from_dict(res)
 
@@ -5083,6 +5172,7 @@ class JobsAPI:
         query = {}
         if run_id is not None: query['run_id'] = run_id
         headers = {'Accept': 'application/json', }
+
         res = self._api.do('GET', '/api/2.1/jobs/runs/get-output', query=query, headers=headers)
         return RunOutput.from_dict(res)
 
@@ -5236,8 +5326,9 @@ class JobsAPI:
           in conjunction with notebook_params. The JSON representation of this field (for example
           `{"jar_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
           
-          Use [Task parameter variables](/jobs.html"#parameter-variables") to set parameters containing
-          information about job runs.
+          Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
+          
+          [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html
         :param job_parameters: Dict[str,str] (optional)
           Job-level parameters used in the run. for example `"param": "overriding_val"`
         :param latest_repair_id: int (optional)
@@ -5252,13 +5343,13 @@ class JobsAPI:
           
           notebook_params cannot be specified in conjunction with jar_params.
           
-          Use [Task parameter variables] to set parameters containing information about job runs.
+          Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
           
           The JSON representation of this field (for example `{"notebook_params":{"name":"john
           doe","age":"35"}}`) cannot exceed 10,000 bytes.
           
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
           [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html
+          [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html
         :param pipeline_params: :class:`PipelineParams` (optional)
         :param python_named_params: Dict[str,str] (optional)
           A map from keys to values for jobs with Python wheel task, for example `"python_named_params":
@@ -5269,7 +5360,7 @@ class JobsAPI:
           would overwrite the parameters specified in job setting. The JSON representation of this field (for
           example `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
           
-          Use [Task parameter variables] to set parameters containing information about job runs.
+          Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
           
           Important
           
@@ -5277,7 +5368,7 @@ class JobsAPI:
           returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
           emojis.
           
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
+          [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html
         :param rerun_all_failed_tasks: bool (optional)
           If true, repair all failed tasks. Only one of `rerun_tasks` or `rerun_all_failed_tasks` can be used.
         :param rerun_dependent_tasks: bool (optional)
@@ -5292,7 +5383,7 @@ class JobsAPI:
           in job setting. The JSON representation of this field (for example `{"python_params":["john
           doe","35"]}`) cannot exceed 10,000 bytes.
           
-          Use [Task parameter variables] to set parameters containing information about job runs
+          Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
           
           Important
           
@@ -5300,7 +5391,7 @@ class JobsAPI:
           returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
           emojis.
           
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
+          [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html
         :param sql_params: Dict[str,str] (optional)
           A map from keys to values for jobs with SQL task, for example `"sql_params": {"name": "john doe",
           "age": "35"}`. The SQL alert task does not support custom parameters.
@@ -5325,6 +5416,7 @@ class JobsAPI:
         if spark_submit_params is not None: body['spark_submit_params'] = [v for v in spark_submit_params]
         if sql_params is not None: body['sql_params'] = sql_params
         headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
+
         op_response = self._api.do('POST', '/api/2.1/jobs/runs/repair', body=body, headers=headers)
         return Wait(self.wait_get_run_job_terminated_or_skipped,
                     response=RepairRunResponse.from_dict(op_response),
@@ -5383,6 +5475,7 @@ class JobsAPI:
         if job_id is not None: body['job_id'] = job_id
         if new_settings is not None: body['new_settings'] = new_settings.as_dict()
         headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
+
         self._api.do('POST', '/api/2.1/jobs/reset', body=body, headers=headers)
 
     def run_now(self,
@@ -5428,8 +5521,9 @@ class JobsAPI:
           in conjunction with notebook_params. The JSON representation of this field (for example
           `{"jar_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
           
-          Use [Task parameter variables](/jobs.html"#parameter-variables") to set parameters containing
-          information about job runs.
+          Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
+          
+          [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html
         :param job_parameters: Dict[str,str] (optional)
           Job-level parameters used in the run. for example `"param": "overriding_val"`
         :param notebook_params: Dict[str,str] (optional)
@@ -5441,13 +5535,13 @@ class JobsAPI:
           
           notebook_params cannot be specified in conjunction with jar_params.
           
-          Use [Task parameter variables] to set parameters containing information about job runs.
+          Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
           
           The JSON representation of this field (for example `{"notebook_params":{"name":"john
           doe","age":"35"}}`) cannot exceed 10,000 bytes.
           
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
           [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html
+          [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html
         :param pipeline_params: :class:`PipelineParams` (optional)
         :param python_named_params: Dict[str,str] (optional)
           A map from keys to values for jobs with Python wheel task, for example `"python_named_params":
@@ -5458,7 +5552,7 @@ class JobsAPI:
           would overwrite the parameters specified in job setting. The JSON representation of this field (for
           example `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
           
-          Use [Task parameter variables] to set parameters containing information about job runs.
+          Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
           
           Important
           
@@ -5466,7 +5560,7 @@ class JobsAPI:
           returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
           emojis.
           
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
+          [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html
         :param queue: :class:`QueueSettings` (optional)
           The queue settings of the run.
         :param spark_submit_params: List[str] (optional)
@@ -5476,7 +5570,7 @@ class JobsAPI:
           in job setting. The JSON representation of this field (for example `{"python_params":["john
           doe","35"]}`) cannot exceed 10,000 bytes.
           
-          Use [Task parameter variables] to set parameters containing information about job runs
+          Use [task parameter variables] such as `{{job.id}}` to pass context about job runs.
           
           Important
           
@@ -5484,7 +5578,7 @@ class JobsAPI:
           returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
           emojis.
           
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
+          [task parameter variables]: https://docs.databricks.com/workflows/jobs/parameter-value-references.html
         :param sql_params: Dict[str,str] (optional)
           A map from keys to values for jobs with SQL task, for example `"sql_params": {"name": "john doe",
           "age": "35"}`. The SQL alert task does not support custom parameters.
@@ -5507,6 +5601,7 @@ class JobsAPI:
         if spark_submit_params is not None: body['spark_submit_params'] = [v for v in spark_submit_params]
         if sql_params is not None: body['sql_params'] = sql_params
         headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
+
         op_response = self._api.do('POST', '/api/2.1/jobs/run-now', body=body, headers=headers)
         return Wait(self.wait_get_run_job_terminated_or_skipped,
                     response=RunNowResponse.from_dict(op_response),
@@ -5559,6 +5654,7 @@ class JobsAPI:
         if access_control_list is not None:
             body['access_control_list'] = [v.as_dict() for v in access_control_list]
         headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
+
         res = self._api.do('PUT', f'/api/2.0/permissions/jobs/{job_id}', body=body, headers=headers)
         return JobPermissions.from_dict(res)
 
@@ -5640,6 +5736,7 @@ class JobsAPI:
         if timeout_seconds is not None: body['timeout_seconds'] = timeout_seconds
         if webhook_notifications is not None: body['webhook_notifications'] = webhook_notifications.as_dict()
         headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
+
         op_response = self._api.do('POST', '/api/2.1/jobs/runs/submit', body=body, headers=headers)
         return Wait(self.wait_get_run_job_terminated_or_skipped,
                     response=SubmitRunResponse.from_dict(op_response),
@@ -5706,6 +5803,7 @@ class JobsAPI:
         if job_id is not None: body['job_id'] = job_id
         if new_settings is not None: body['new_settings'] = new_settings.as_dict()
         headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
+
         self._api.do('POST', '/api/2.1/jobs/update', body=body, headers=headers)
 
     def update_permissions(
@@ -5727,5 +5825,6 @@ class JobsAPI:
         if access_control_list is not None:
             body['access_control_list'] = [v.as_dict() for v in access_control_list]
         headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
+
         res = self._api.do('PATCH', f'/api/2.0/permissions/jobs/{job_id}', body=body, headers=headers)
         return JobPermissions.from_dict(res)