diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/databases.txt | 4 | ||||
| -rw-r--r-- | docs/topics/async.txt | 5 |
2 files changed, 9 insertions, 0 deletions
diff --git a/docs/ref/databases.txt b/docs/ref/databases.txt index a3571295ff..93a773e9a7 100644 --- a/docs/ref/databases.txt +++ b/docs/ref/databases.txt @@ -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 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 ~~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/topics/async.txt b/docs/topics/async.txt index a289344f6b..c5cbabeea7 100644 --- a/docs/topics/async.txt +++ b/docs/topics/async.txt @@ -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 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 |