---
title: "Nathanna fiosrúcháin sonracha PostgreSQL"
version: 5.2
locale: ga
source: https://docs.djangoproject.com/ga/5.2/ref/contrib/postgres/expressions/
canonical: https://djangodocs.dev/ga/5.2/ref/contrib/postgres/expressions/
---
# Nathanna fiosrúcháin sonracha PostgreSQL

Tá na nathanna seo ar fáil ón modúl `django.contrib.postgres.expressions`.

## Nathanna ArraySubquery () \`\`

#### `class ArraySubquery(queryset)`

Is é `ArraySubquery` a:class: ~django.db.models.subquery a úsáideann an tógálaí PostgreSQL `ARRAY` chun liosta luachanna a thógáil ón gceist, nach mór a úsáid:meth: .queryset.values chun ach colún amháin a thabhairt ar ais.

Tá difríocht idir an rang seo ó:class: ~django.contrib.postgres.aggregates.ArrayAgg sa chaoi nach ngníomhaíonn sé mar fheidhm chomhiomlán agus nach dteastaíonn clásal SQL `GROUP BY` uaidh chun an liosta luachanna a thógáil.

Mar shampla, más mian leat gach leabhar gaolmhar a anótáil le húdar mar rudaí JSON:

```pycon
>>> from django.db.models import OuterRef
>>> from django.db.models.functions import JSONObject
>>> from django.contrib.postgres.expressions import ArraySubquery
>>> books = Book.objects.filter(author=OuterRef("pk")).values(
...     json=JSONObject(title="title", pages="pages")
... )
>>> author = Author.objects.annotate(books=ArraySubquery(books)).first()
>>> author.books
[{'title': 'Solaris', 'pages': 204}, {'title': 'The Cyberiad', 'pages': 295}]
```