subhash-0000 commented on code in PR #60818: URL: https://github.com/apache/airflow/pull/60818#discussion_r2831764211
########## airflow-core/docs/core-concepts/backfill.rst: ########## @@ -47,6 +47,24 @@ Run ordering You can run your backfill in reverse, i.e. latest runs first. The CLI option is ``--run-backwards``. +Running backfills on paused DAGs +--------------------------------- + +Airflow allows backfills to run on paused DAGs. This is useful when: + +* You need to reprocess historical data without activating the regular DAG schedule +* The data source is not available for regular runs +* You want to avoid unnecessary computation and logs from scheduled triggers + +When you create a backfill on a paused DAG, only the backfill runs will execute—the DAG remains paused and will not be triggered by its regular schedule. + +**Via UI**: When creating a backfill for a paused DAG, you can: + +- **Check "Unpause on trigger"**: This will unpause the DAG before running the backfill (and regular schedules will resume) +- **Uncheck "Unpause on trigger"** (default): The backfill will run but the DAG stays paused Review Comment: Manually tested with Breeze (Airflow 3.2.0.dev0). Screenshot shows: DAG toggle is off/paused throughout Two backfill runs created with Run Type = Backfill Both runs have actual Start Dates and durations — tasks executed and were not stuck in Queued as in the previous iteration The Failed state is due to example_bash_operator's bash commands failing in the Breeze container environment, unrelated to the paused DAG behavior. <img width="1401" height="742" alt="image" src="https://github.com/user-attachments/assets/9cbbe0e7-30a7-4450-896e-9b6524545b90"; /> -- 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]
