1
0
mirror of https://github.com/django/django.git synced 2025-04-10 16:29:42 +00:00

Fixed #36202 -- Added examples of JSONField __contains and __contained_by lookups with nested arrays to docs.

This commit is contained in:
Clifford Gama 2025-03-18 22:54:10 +02:00 committed by GitHub
parent 611e7bc3a0
commit 304e9f3d6a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -1247,10 +1247,15 @@ contained in the top-level of the field. For example:
<Dog: Meg>
>>> Dog.objects.create(name="Fred", data={})
<Dog: Fred>
>>> Dog.objects.create(
... name="Merry", data={"breed": "pekingese", "tricks": ["fetch", "dance"]}
... )
>>> Dog.objects.filter(data__contains={"owner": "Bob"})
<QuerySet [<Dog: Rufus>, <Dog: Meg>]>
>>> Dog.objects.filter(data__contains={"breed": "collie"})
<QuerySet [<Dog: Meg>]>
>>> Dog.objects.filter(data__contains={"tricks": ["dance"]})
<QuerySet [<Dog: Merry>]>
.. admonition:: Oracle and SQLite
@ -1273,10 +1278,17 @@ subset of those in the value passed. For example:
<Dog: Meg>
>>> Dog.objects.create(name="Fred", data={})
<Dog: Fred>
>>> Dog.objects.create(
... name="Merry", data={"breed": "pekingese", "tricks": ["fetch", "dance"]}
... )
>>> Dog.objects.filter(data__contained_by={"breed": "collie", "owner": "Bob"})
<QuerySet [<Dog: Meg>, <Dog: Fred>]>
>>> Dog.objects.filter(data__contained_by={"breed": "collie"})
<QuerySet [<Dog: Fred>]>
>>> Dog.objects.filter(
... data__contained_by={"breed": "pekingese", "tricks": ["dance", "fetch", "hug"]}
... )
<QuerySet [<Dog: Merry>, <Dog: Fred>]>
.. admonition:: Oracle and SQLite