Skip to content

Commit 6d2e05a

Browse files
committed
Document PostgreSQL fallback host connection strings (#25461)
1 parent 9ec73ba commit 6d2e05a

1 file changed

Lines changed: 8 additions & 0 deletions

File tree

airflow-core/docs/howto/set-up-database.rst

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -276,6 +276,14 @@ If you use a current Postgres user with custom search_path, search_path can be c
276276
277277
For more information regarding setup of the PostgreSQL connection, see `PostgreSQL dialect <https://docs.sqlalchemy.org/en/20/dialects/postgresql.html>`__ in SQLAlchemy documentation.
278278

279+
.. note::
280+
281+
PostgreSQL connection strings can include multiple fallback hosts when you use the ``psycopg2`` driver.
282+
Use SQLAlchemy's documented PostgreSQL URL format for this setup, because each fallback host must be
283+
passed in a form that the SQLAlchemy dialect forwards correctly to libpq. See
284+
`Specifying multiple fallback hosts <https://docs.sqlalchemy.org/en/20/dialects/postgresql.html#specifying-multiple-fallback-hosts>`__
285+
in the SQLAlchemy documentation.
286+
279287
.. note::
280288

281289
Airflow is known - especially in high-performance setup - to open many connections to metadata database. This might cause problems for

0 commit comments

Comments
 (0)