summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorMariusz Felisiak <felisiak.mariusz@gmail.com>2021-07-08 06:51:10 +0200
committerGitHub <noreply@github.com>2021-07-08 06:51:10 +0200
commit77b88fe621bb7828535a4c4cf37d9d4ac01b146b (patch)
tree6e6f6db794e0ef0707a28426be5d54e5a76ca339 /docs
parent5013798fe9a87b693ddb5589a8a408a04a873781 (diff)
Fixed #32908 -- Allowed select_for_update(skip_locked) on MariaDB 10.6+.
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/databases.txt2
-rw-r--r--docs/ref/models/querysets.txt14
-rw-r--r--docs/releases/4.0.txt3
3 files changed, 13 insertions, 6 deletions
diff --git a/docs/ref/databases.txt b/docs/ref/databases.txt
index 6a6bab8e2f..d61406198d 100644
--- a/docs/ref/databases.txt
+++ b/docs/ref/databases.txt
@@ -686,7 +686,7 @@ a :exc:`~django.db.NotSupportedError` is raised.
=============== ========= ==========
Option MariaDB MySQL
=============== ========= ==========
-``SKIP LOCKED`` X (≥8.0.1)
+``SKIP LOCKED`` X (≥10.6) X (≥8.0.1)
``NOWAIT`` X (≥10.3) X (≥8.0.1)
``OF`` X (≥8.0.1)
``NO KEY``
diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt
index c24079ec10..408224aed1 100644
--- a/docs/ref/models/querysets.txt
+++ b/docs/ref/models/querysets.txt
@@ -1792,11 +1792,11 @@ them::
>>> Person.objects.select_related('hometown').select_for_update().exclude(hometown=None)
<QuerySet [<Person: ...)>, ...]>
-Currently, the ``postgresql``, ``oracle``, and ``mysql`` database
-backends support ``select_for_update()``. However, MariaDB 10.3+ supports only
-the ``nowait`` argument and MySQL 8.0.1+ supports the ``nowait``,
-``skip_locked``, and ``of`` arguments. The ``no_key`` argument is supported
-only on PostgreSQL.
+The ``postgresql``, ``oracle``, and ``mysql`` database backends support
+``select_for_update()``. However, MariaDB 10.3+ only supports the ``nowait``
+argument, MariaDB 10.6+ also supports the ``skip_locked`` argument, and MySQL
+8.0.1+ supports the ``nowait``, ``skip_locked``, and ``of`` arguments. The
+``no_key`` argument is only supported on PostgreSQL.
Passing ``nowait=True``, ``skip_locked=True``, ``no_key=True``, or ``of`` to
``select_for_update()`` using database backends that do not support these
@@ -1836,6 +1836,10 @@ raised if ``select_for_update()`` is used in autocommit mode.
The ``of`` argument was allowed on MySQL 8.0.1+.
+.. versionchanged:: 4.0
+
+ The ``skip_locked`` argument was allowed on MariaDB 10.6+.
+
``raw()``
~~~~~~~~~
diff --git a/docs/releases/4.0.txt b/docs/releases/4.0.txt
index bc8e1639c8..4c0efc236f 100644
--- a/docs/releases/4.0.txt
+++ b/docs/releases/4.0.txt
@@ -274,6 +274,9 @@ Models
* The new :attr:`.Aggregate.empty_aggregate_value` attribute allows specifying
a value to return when the aggregation is used over an empty result set.
+* The ``skip_locked`` argument of :meth:`.QuerySet.select_for_update()` is now
+ allowed on MariaDB 10.6+.
+
Requests and Responses
~~~~~~~~~~~~~~~~~~~~~~