p31829507
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Fixed #31894 -- Added note about using JSONField key lookups with QuerySet.exclude() in docs.

This commit is contained in:
jpribyl 2020-09-04 08:16:46 +02:00 committed by Mariusz Felisiak
parent 94e2238107
commit 17407eca59
1 changed files with 8 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/topics/db/queries.txt
View File

@ -910,6 +910,14 @@ To query for missing keys, use the ``isnull`` lookup::
:lookup:`istartswith`, :lookup:`lt`, :lookup:`lte`, :lookup:`gt`, and
:lookup:`gte`, as well as with :ref:`containment-and-key-lookups`.
.. note::
Due to the way in which key-path queries work,
:meth:`~django.db.models.query.QuerySet.exclude` and
:meth:`~django.db.models.query.QuerySet.filter` are not guaranteed to
produce exhaustive sets. If you want to include objects that do not have
the path, add the ``isnull`` lookup.
.. warning::
Since any string could be a key in a JSON object, any lookup other than