Skip to content

Document Airflow 3 requirement for Databricks deferral - #71667

Open
breadtitor wants to merge 1 commit into
apache:mainfrom
breadtitor:agent/document-databricks-deferrable-version
Open

Document Airflow 3 requirement for Databricks deferral#71667
breadtitor wants to merge 1 commit into
apache:mainfrom
breadtitor:agent/document-databricks-deferrable-version

Conversation

@breadtitor

Copy link
Copy Markdown

Document the Airflow 3 version requirement for deferrable Databricks run-now and submit-run operators.

Airflow 3.0.x cannot fetch the Databricks connection from the Triggerer during asynchronous polling, while Airflow 3.1.0 and later handle this path in core. Documenting the boundary gives affected users an actionable upgrade path instead of suggesting an unnecessary provider-side fix.

closes: #71525

Validation:

  • RST syntax checked with rstcheck
  • Spelling checked with codespell
  • git diff --check

Was generative AI tooling used to co-author this PR?
  • Yes — Codex (GPT-5)

Generated-by: Codex (GPT-5) following the guidelines


Drafted-by: Codex (GPT-5) (no human review before posting)

Airflow 3.0.x cannot fetch Databricks connections from the Triggerer during asynchronous polling, while core 3.1.0 and later handle this path.
@boring-cyborg

boring-cyborg Bot commented Aug 16, 2026

Copy link
Copy Markdown

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide
Here are some useful points:

  • Pay attention to the quality of your code (ruff, mypy and type annotations). Our prek-hooks will help you with that.
  • In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example Dag that shows how users should use it.
  • Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
  • Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
  • Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
  • Be sure to read the Airflow Coding style.
  • Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
    Apache Airflow is a community-driven project and together we are making it better 🚀.
    In case of doubts contact the developers at:
    Mailing List: dev@airflow.apache.org
    Slack: https://s.apache.org/airflow-slack


.. note::
When using Airflow 3, deferrable execution requires Airflow 3.1.0 or later. Airflow 3.0.x
cannot fetch the Databricks connection from the Triggerer during asynchronous polling.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reading #71525

I am not sure if this is a doc issue. Shouldn't we check on runtime the airflow version and if it is 3.0 then alert users / fallback to the supported functionality?

cc @moomindani

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

DatabricksRunNowOperator(deferrable=True) crashes in triggerer: AsyncToSync used inside running event loop (Airflow 3.0.6)

2 participants