Fix unnecessary DAG version churn when DAG file paths change#60799
Merged
kaxil merged 1 commit intoapache:mainfrom Jan 20, 2026
Merged
Fix unnecessary DAG version churn when DAG file paths change#60799kaxil merged 1 commit intoapache:mainfrom
kaxil merged 1 commit intoapache:mainfrom
Conversation
Add exclude_module parameter to qualname() that returns only the qualified name without module prefix. This prevents unnecessary DAG version churn when bundle paths change (e.g., version or timestamp-based folders). The module name contains a path-derived hash that changes with each deployment, causing new `SerializedDagModel` entries even when DAG code is unchanged.
01f2900 to
d7c6c22
Compare
amoghrajesh
approved these changes
Jan 20, 2026
jason810496
pushed a commit
to jason810496/airflow
that referenced
this pull request
Jan 22, 2026
amoghrajesh
pushed a commit
to astronomer/airflow
that referenced
this pull request
Jan 22, 2026
suii2210
pushed a commit
to suii2210/airflow
that referenced
this pull request
Jan 26, 2026
ephraimbuddy
pushed a commit
that referenced
this pull request
Jan 27, 2026
(cherry picked from commit fbb200e)
kaxil
added a commit
that referenced
this pull request
Jan 27, 2026
(cherry picked from commit fbb200e)
shreyas-dev
pushed a commit
to shreyas-dev/airflow
that referenced
this pull request
Jan 29, 2026
86 tasks
jhgoebbert
pushed a commit
to jhgoebbert/airflow_Owen-CH-Leung
that referenced
this pull request
Feb 8, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
When DAG files are loaded from paths that change between deployments (e.g., versioned directories), the
python_callable_namein serialized DAGs changes even when the actual DAG code is unchanged.This happens because
qualname()includes the module name, which contains a hash derived from the file path viaget_unique_dag_module_name(). When the path changes, the module name changes, causing:python_callable_namevaluesdag_hashSerializedDagModelentries on every deploymentSolution
Add
exclude_moduleparameter toqualname()that returns only the qualified name without the module prefix:Use this in operator serialization to ensure
python_callable_nameis stable across deployments.