{"title":"PostgreSQL 特有查询表达式","version":"5.0","locale":"zh-hans","docname":"ref/contrib/postgres/expressions","url":"/zh-hans/5.0/ref/contrib/postgres/expressions/","canonical":"https://djangodocs.dev/zh-hans/5.0/ref/contrib/postgres/expressions/","summary":"这些表达式可以从 django.contrib.postgres.expressions 模块中获得。ArraySubquery 是一个 Subquery，使用 PostgreSQL 的 ARRAY 构造函数，从查询集中建立一个值列表…","html":"

PostgreSQL 特有查询表达式Link to this heading#

\n

这些表达式可以从 django.contrib.postgres.expressions 模块中获得。

\n
\n

ArraySubquery() 表达式Link to this heading#

\n
\n
\nclass ArraySubquery(queryset)Link to this definition#
\n
\n\n

ArraySubquery 是一个 Subquery，使用 PostgreSQL 的 ARRAY 构造函数，从查询集中建立一个值列表，它必须使用 QuerySet.values() 来只返回一个列。

\n

这个类与 ArrayAgg 不同，它不作为一个聚合函数，也不需要一个 SQL GROUP BY 子句来建立值的列表。

\n

例如，如果您想要将作者的所有相关书籍注释为 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":"ArraySubquery() 表达式","anchor":"arraysubquery-expressions","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"API 参考","url":"/zh-hans/5.0/ref/"},{"docname":"ref/contrib/index","title":"contrib 包","url":"/zh-hans/5.0/ref/contrib/"},{"docname":"ref/contrib/postgres/index","title":"django.contrib.postgres","url":"/zh-hans/5.0/ref/contrib/postgres/"}],"prev":{"docname":"ref/contrib/postgres/constraints","title":"PostgreSQL 特有数据库约束","url":"/zh-hans/5.0/ref/contrib/postgres/constraints/"},"next":{"docname":"ref/contrib/postgres/fields","title":"PostgreSQL 特有模型字段","url":"/zh-hans/5.0/ref/contrib/postgres/fields/"},"formats":{"html":"/zh-hans/5.0/ref/contrib/postgres/expressions/","markdown":"/zh-hans/5.0/ref/contrib/postgres/expressions.md","json":"/zh-hans/5.0/ref/contrib/postgres/expressions.json"},"source":"https://github.com/django/django/blob/stable/5.0.x/docs/ref/contrib/postgres/expressions.txt","official":"https://docs.djangoproject.com/zh-hans/5.0/ref/contrib/postgres/expressions/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}