From 397470557476bf90e0b04728d0d3995abfd987d6 Mon Sep 17 00:00:00 2001 From: Stephan Date: Wed, 15 Jul 2026 16:25:13 +0200 Subject: [PATCH 1/3] Fix wrong configuration section use external_db_managers is part of the database section, not core --- providers/fab/docs/upgrading.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/providers/fab/docs/upgrading.rst b/providers/fab/docs/upgrading.rst index 3e861fb1a7e1d..b832b2b7d34ab 100644 --- a/providers/fab/docs/upgrading.rst +++ b/providers/fab/docs/upgrading.rst @@ -25,12 +25,12 @@ Why you need to upgrade The FAB provider is a separate package from Airflow and it is released independently. Starting from version 1.3.0, FAB can now run its own migrations if you are on Airflow 3. Newer FAB versions can contain database migrations, so you must run ``airflow fab-db migrate`` to migrate your database with the schema changes in the FAB version you are -upgrading to. If ``FABDBManager`` is included in the ``[core] external_db_managers`` configuration, the migrations will +upgrading to. If ``FABDBManager`` is included in the ``[database] external_db_managers`` configuration, the migrations will be run automatically as part of the ``airflow db migrate`` command. .. note:: If FAB auth manager is configured as auth manager in your environment, ``FABDBManager`` is automatically added in the - ``[core] external_db_managers`` configuration. + ``[database] external_db_managers`` configuration. How to upgrade ============== From cb1ee8c949b56f8696b85bb26d4210798175ac52 Mon Sep 17 00:00:00 2001 From: Stephan Date: Wed, 15 Jul 2026 16:33:23 +0200 Subject: [PATCH 2/3] Correct imprecise wording around auto adding FABDBManager FABDBManager is not added to external_db_manager if it is specified under auth_manager, it is just loaded by the RunDBManager --- providers/fab/docs/upgrading.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/providers/fab/docs/upgrading.rst b/providers/fab/docs/upgrading.rst index b832b2b7d34ab..4a7bf4cfab530 100644 --- a/providers/fab/docs/upgrading.rst +++ b/providers/fab/docs/upgrading.rst @@ -29,8 +29,8 @@ upgrading to. If ``FABDBManager`` is included in the ``[database] external_db_ma be run automatically as part of the ``airflow db migrate`` command. .. note:: - If FAB auth manager is configured as auth manager in your environment, ``FABDBManager`` is automatically added in the - ``[database] external_db_managers`` configuration. + If the FAB auth manager is configured as ``[core] auth_manager`` in your environment, Airflow automatically loads + ``FABDBManager`` and runs its migrations as part of the ``airflow db migrate`` command. How to upgrade ============== From dccb537ddf9f048416a19f49a7f1b6ee221a5aa8 Mon Sep 17 00:00:00 2001 From: Stephan Date: Wed, 15 Jul 2026 16:47:48 +0200 Subject: [PATCH 3/3] Correct imprecise wording around get_db_manager function --- airflow-core/docs/core-concepts/auth-manager/index.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/airflow-core/docs/core-concepts/auth-manager/index.rst b/airflow-core/docs/core-concepts/auth-manager/index.rst index 49d761b174bb7..b821fbfa135bc 100644 --- a/airflow-core/docs/core-concepts/auth-manager/index.rst +++ b/airflow-core/docs/core-concepts/auth-manager/index.rst @@ -257,8 +257,8 @@ Other optional methods Override this method if you need to make any action (e.g. create resources, API call) that the auth manager needs. * ``get_extra_menu_items``: Provide additional links to be added to the menu in the UI. * ``get_db_manager``: If your auth manager requires one or several database managers (see :class:`~airflow.utils.db_manager.BaseDBManager`), - their class paths need to be returned as part of this method. By doing so, they will be automatically added to the - config ``[database] external_db_managers``. + their class paths need to be returned as part of this method. By doing so, Airflow automatically loads the + respective database managers. Additional Caveats