This is an automated email from the ASF dual-hosted git repository.
vatsrahul1001 pushed a commit to branch v3-3-test
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/v3-3-test by this push:
new 7013c59d718 [v3-3-test] Document effect of state-store cleanup in
ResumableJobMixin (#70718) (#70792)
7013c59d718 is described below
commit 7013c59d7183ef8d9bef8567b564789463c33ea9
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Fri Jul 31 14:42:05 2026 +0530
[v3-3-test] Document effect of state-store cleanup in ResumableJobMixin
(#70718) (#70792)
(cherry picked from commit cea9e6efdb5b23d8381bb930762f2e8d89643857)
Co-authored-by: Amogh Desai <[email protected]>
---
task-sdk/docs/resumable-job-mixin.rst | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/task-sdk/docs/resumable-job-mixin.rst
b/task-sdk/docs/resumable-job-mixin.rst
index 345fc4c4494..52e0b004792 100644
--- a/task-sdk/docs/resumable-job-mixin.rst
+++ b/task-sdk/docs/resumable-job-mixin.rst
@@ -111,6 +111,14 @@ to check the current state of the job:
If the worker crashes in that gap, the next retry does not have the
identifier and will
submit a fresh job. For most workloads this window is negligible.
+.. note::
+
+ The stored identifier expires after ``[state_store]
default_retention_days`` (30 days by
+ default), but nothing deletes it automatically, that only happens when
someone runs
+ ``airflow state-store clean``. Do not run that command while a task's
``retry_delay`` is
+ longer than ``default_retention_days``, the identifier could be gone by the
next retry,
+ causing the operator to submit a fresh job instead of reconnecting.
+
Example
-------
