summaryrefslogtreecommitdiff
path: root/docs/topics
diff options
context:
space:
mode:
authorCarlton Gibson <carlton.gibson@noumenal.es>2025-03-13 10:23:00 +0100
committerNatalia <124304+nessita@users.noreply.github.com>2025-03-18 21:28:43 -0300
commitab4bb5b2f93d5bb4e1375594adad9d8c596fb8a7 (patch)
treef19adbf2e6045fff73506e90ea66c3b7fad1dd78 /docs/topics
parente9acb05b6308e2b07f7f75d70e80e6472a04a336 (diff)
[5.1.x] Fixed #33497 -- Doc'd that persistent DB connections should be disabled in ASGI and async modes.
Backport of 8713e4ae96817a0c7be3f7a8fee25a7c7f819721 from main.
Diffstat (limited to 'docs/topics')
-rw-r--r--docs/topics/async.txt5
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/topics/async.txt b/docs/topics/async.txt
index 87550ff46d..204d79fc8c 100644
--- a/docs/topics/async.txt
+++ b/docs/topics/async.txt
@@ -148,6 +148,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
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:
Performance