ashb commented on code in PR #67794:
URL: https://github.com/apache/airflow/pull/67794#discussion_r3356389148
##########
airflow-core/docs/authoring-and-scheduling/deferring.rst:
##########
@@ -571,3 +571,24 @@ In Airflow, sensors wait for specific conditions to be met
before proceeding wit
| Built-in functionality for rescheduling | Requires custom
logic to defer task and handle |
| | external changes
|
+--------------------------------------------------------+--------------------------------------------------------+
+
+.. _deferring/resumable:
+
+Resumable Operators (ResumableJobMixin)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A third pattern is available when an operator submits a long-running job to an
+external system and needs to survive worker crashes.
+:class:`~airflow.sdk.ResumableJobMixin` persists the external job identifier to
+``task_state`` before polling. On retry, the mixin reconnects to the
already-running
+job instead of submitting a duplicate.
+
+Unlike deferrable operators, a resumable operator **holds the worker slot**
throughout
+execution. Use it when:
+
+- A Triggerer is not available, or the operator is already synchronous.
+- The external system supports reconnecting to a running job via a stable
identifier.
Review Comment:
This is specific to the mixin, not an intrinsic requirement of when to use
State/ Resumable operators.
This is not incorrect, but it's not complete.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
