1
0
mirror of https://github.com/django/django.git synced 2025-05-20 13:56:30 +00:00

[5.2.x] Fixed #33497 -- Doc'd that persistent DB connections should be disabled in ASGI and async modes.

Backport of 8713e4ae96817a0c7be3f7a8fee25a7c7f819721 from main.
This commit is contained in:
Carlton Gibson 2025-03-13 10:23:00 +01:00 committed by Natalia
parent bcb6ada288
commit c779808c8e
2 changed files with 9 additions and 0 deletions

View File

@ -40,6 +40,10 @@ database connection at the end of each request. To enable persistent
connections, set :setting:`CONN_MAX_AGE` to a positive integer of seconds. For connections, set :setting:`CONN_MAX_AGE` to a positive integer of seconds. For
unlimited persistent connections, set it to ``None``. unlimited persistent connections, set it to ``None``.
When using ASGI, persistent connections should be disabled. Instead, use your
database backend's built-in connection pooling if available, or investigate a
third-party connection pooling option if required.
Connection management Connection management
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~

View File

@ -146,6 +146,11 @@ Transactions do not yet work in async mode. If you have a piece of code that
needs transactions behavior, we recommend you write that piece as a single needs transactions behavior, we recommend you write that piece as a single
synchronous function and call it using :func:`sync_to_async`. synchronous function and call it using :func:`sync_to_async`.
:ref:`Persistent database connections <persistent-database-connections>`, set
via the :setting:`CONN_MAX_AGE` setting, should also be disabled in async mode.
Instead, use your database backend's built-in connection pooling if available,
or investigate a third-party connection pooling option if required.
.. _async_performance: .. _async_performance:
Performance Performance