{"title":"Expressions de requête spécifiques à PostgreSQL","version":"6.0","locale":"fr","docname":"ref/contrib/postgres/expressions","url":"/fr/6.0/ref/contrib/postgres/expressions/","canonical":"https://djangodocs.dev/fr/6.0/ref/contrib/postgres/expressions/","summary":"Ces expressions sont disponibles dans le module django.contrib.postgres.expressions . Expressions ArraySubquery() Lien vers cette rubrique # class ArraySubquery (…","html":"

Expressions de requête spécifiques à PostgreSQLLien vers cette rubrique#

\n

Ces expressions sont disponibles dans le module django.contrib.postgres.expressions.

\n
\n

Expressions ArraySubquery()Lien vers cette rubrique#

\n
\n
\nclass ArraySubquery(queryset)Lien vers cette définition#
\n
\n\n

ArraySubquery est une sous-requête Subquery qui utilise le constructeur PostgreSQL ARRAY pour construire une liste de valeurs du jeu de requêtem qui doit utiliser QuerySet.values() pour ne renvoyer qu’une seule colonne.

\n

Cette classe diffère de ArrayAgg dans le sens où elle n’agit pas comme une fonction d’agrégat et n’exige pas de clause SQL GROUP BY pour construire la liste des valeurs.

\n

Par exemple, si vous souhaitez annoter tous les livres liés à un auteur sous forme d’objet JSON :

\n
Python console
>>> from django.db.models import OuterRef\n>>> from django.db.models.functions import JSONObject\n>>> from django.contrib.postgres.expressions import ArraySubquery\n>>> books = Book.objects.filter(author=OuterRef("pk")).values(\n...     json=JSONObject(title="title", pages="pages")\n... )\n>>> author = Author.objects.annotate(books=ArraySubquery(books)).first()\n>>> author.books\n[{'title': 'Solaris', 'pages': 204}, {'title': 'The Cyberiad', 'pages': 295}]\n
\n
","rootId":"module-django.contrib.postgres.expressions","toc":[{"title":"Expressions ArraySubquery()","anchor":"arraysubquery-expressions","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/6.0/ref/"},{"docname":"ref/contrib/index","title":"Paquets contrib","url":"/fr/6.0/ref/contrib/"},{"docname":"ref/contrib/postgres/index","title":"django.contrib.postgres","url":"/fr/6.0/ref/contrib/postgres/"}],"prev":{"docname":"ref/contrib/postgres/constraints","title":"Contraintes de bases de données spécifiques à PostgreSQL","url":"/fr/6.0/ref/contrib/postgres/constraints/"},"next":{"docname":"ref/contrib/postgres/fields","title":"Champs de modèles spécifiques à PostgreSQL","url":"/fr/6.0/ref/contrib/postgres/fields/"},"formats":{"html":"/fr/6.0/ref/contrib/postgres/expressions/","markdown":"/fr/6.0/ref/contrib/postgres/expressions.md","json":"/fr/6.0/ref/contrib/postgres/expressions.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/ref/contrib/postgres/expressions.txt","official":"https://docs.djangoproject.com/fr/6.0/ref/contrib/postgres/expressions/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}