From 7746459d4909e24b38c20e77ad7b13ce8a033161 Mon Sep 17 00:00:00 2001 From: Tatiana Al-Chueyr Date: Thu, 23 Apr 2026 11:04:22 +0100 Subject: [PATCH] Add docs related to watcher depends_on_past limitation --- .../run_dbt/airflow-worker/watcher-execution-mode.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/guides/run_dbt/airflow-worker/watcher-execution-mode.rst b/docs/guides/run_dbt/airflow-worker/watcher-execution-mode.rst index 5375cd461e..61e235b5a2 100644 --- a/docs/guides/run_dbt/airflow-worker/watcher-execution-mode.rst +++ b/docs/guides/run_dbt/airflow-worker/watcher-execution-mode.rst @@ -379,6 +379,15 @@ This use case is not currently supported by the ``ExecutionMode.WATCHER``, since We have a follow-up ticket to `further investigate this use case `_. +Concurrent DAG runs with ``depends_on_past`` +'''''''''''''''''''''''''''''''''''''''''''' + +When ``depends_on_past=True`` is used together with concurrent DAG runs, a race can occur between consecutive runs where the next run's producer starts while the previous run's consumer fallback is still executing, causing two dbt processes to write to the same models concurrently. + +As a workaround, set ``max_active_runs=1`` on the DAG. + +For details, see `#2596 `_. + Advanced config +++++++++++++++