{"title":"Feidhmeanna comhiomlánaithe sonracha PostgreSQL","version":"5.2","locale":"ga","docname":"ref/contrib/postgres/aggregates","url":"/ga/5.2/ref/contrib/postgres/aggregates/","canonical":"https://djangodocs.dev/ga/5.2/ref/contrib/postgres/aggregates/","summary":"Tá na feidhmeanna seo ar fáil ón modúl django.contrib.postgres.aggregates. < https://www.postgresql.org/docs/current/functions-aggregate.html>Déantar cur…","html":"

Feidhmeanna comhiomlánaithe sonracha PostgreSQLLink to this heading#

\n

Tá na feidhmeanna seo ar fáil ón modúl django.contrib.postgres.aggregates. < https://www.postgresql.org/docs/current/functions-aggregate.html>Déantar cur síos níos mionsonraithe orthu sna doiciméid PostgreSQL.

\n\n\n
\n

Feidhmeanna comhiomlánchuspóireachLink to this heading#

\n
\n

ArrayagLink to this heading#

\n
\n
\nclass ArrayAgg(expression, distinct=False, filter=None, default=None, order_by=(), **extra)Link to this definition#
\n

Tugann sé liosta luachanna, lena n-áirítear neamhaill, atá comhcheangailte i sraith, nó réamhshocraithe mura bhfuil aon luachanna ann.

\n
\n
\ndistinctLink to this definition#
\n

Argóint boolean roghnach a chinneann an mbeidh luachanna eagar ar leith. Réamhshocraithe go False.

\n
\n\n
\n
\norder_byLink to this definition#
\n
\n

Sreang roghnach d'ainm réimse (le réimír roghnach ” -" a léiríonn ord íslitheach) nó abairt (nó liosta teaghráin agus/nó nathanna) a shonraíonn ordú na n-eilimintí sa liosta torthaí.

\n

Samplaí:

\n
Code
from django.db.models import F\n\nArrayAgg("a_field", order_by="-some_field")\nArrayAgg("a_field", order_by=F("some_field").desc())\n
\n
\n\n\n
\n\n
\n
\n

BitandLink to this heading#

\n
\n
\nclass BitAnd(expression, filter=None, default=None, **extra)Link to this definition#
\n

Filleann sé int de ghiotán AND de na luachanna ionchuir neamh-null go léir, nó default má tá na luachanna go léir neall.

\n
\n\n
\n
\n

BitorLink to this heading#

\n
\n
\nclass BitOr(expression, filter=None, default=None, **extra)Link to this definition#
\n

Filleann sé int den OR` bitwise de na luachanna ionchuir neamh-null go léir, nó default má tá na luachanna go léir niall.

\n
\n\n
\n
\n

BitxorLink to this heading#

\n
\n
\nclass BitXor(expression, filter=None, default=None, **extra)Link to this definition#
\n

Filleann sé int den XOR` bitwise de na luachanna ionchuir neamh-null go léir, nó default má tá na luachanna go léir niall. Éilíonn sé PostgreSQL 14 +.

\n
\n\n
\n
\n

BoolandLink to this heading#

\n
\n
\nclass BoolAnd(expression, filter=None, default=None, **extra)Link to this definition#
\n

Tugann sé True, má tá na luachanna ionchuir go léir fíor, default má tá na luachanna go léir null nó mura bhfuil aon luachanna ann, ar shlí eile False.

\n

Sampla úsáide:

\n
Code
class Comment(models.Model):\n    body = models.TextField()\n    published = models.BooleanField()\n    rank = models.IntegerField()\n
\n
Python console
>>> from django.db.models import Q\n>>> from django.contrib.postgres.aggregates import BoolAnd\n>>> Comment.objects.aggregate(booland=BoolAnd("published"))\n{'booland': False}\n>>> Comment.objects.aggregate(booland=BoolAnd(Q(rank__lt=100)))\n{'booland': True}\n
\n
\n\n
\n
\n

BoolorLink to this heading#

\n
\n
\nclass BoolOr(expression, filter=None, default=None, **extra)Link to this definition#
\n

Tugann sé True má tá luach ionchuir amháin ar a laghad fíor, default má tá na luachanna go léir niall nó mura bhfuil aon luachanna ann, ar shlí eile False.

\n

Sampla úsáide:

\n
Code
class Comment(models.Model):\n    body = models.TextField()\n    published = models.BooleanField()\n    rank = models.IntegerField()\n
\n
Python console
>>> from django.db.models import Q\n>>> from django.contrib.postgres.aggregates import BoolOr\n>>> Comment.objects.aggregate(boolor=BoolOr("published"))\n{'boolor': True}\n>>> Comment.objects.aggregate(boolor=BoolOr(Q(rank__gt=2)))\n{'boolor': False}\n
\n
\n\n
\n
\n

JsonbagLink to this heading#

\n
\n
\nclass JSONBAgg(expressions, distinct=False, filter=None, default=None, order_by=(), **extra)Link to this definition#
\n

Tugann na luachanna ionchuir ar ais mar shraith JSON, nó default mura bhfuil aon luachanna ann. <jsonfield.key>Is féidir leat an toradh a cheistiú ag baint úsáid:lookup: `eochair agus innéacs cuardaigh `.

\n
\n
\ndistinctLink to this definition#
\n

Argóint boolean roghnach a chinneann an mbeidh luachanna eagar ar leith. Réamhshocraithe go False.

\n
\n\n
\n
\norder_byLink to this definition#
\n
\n

Sreang roghnach d'ainm réimse (le réimír roghnach ” -" a léiríonn ord íslitheach) nó abairt (nó liosta teaghráin agus/nó nathanna) a shonraíonn ordú na n-eilimintí sa liosta torthaí.

\n

Examples are the same as for ArrayAgg.order_by.

\n
\n\n

Sampla úsáide:

\n
Code
class Room(models.Model):\n    number = models.IntegerField(unique=True)\n\n\nclass HotelReservation(models.Model):\n    room = models.ForeignKey("Room", on_delete=models.CASCADE)\n    start = models.DateTimeField()\n    end = models.DateTimeField()\n    requirements = models.JSONField(blank=True, null=True)\n
\n
Python console
>>> from django.contrib.postgres.aggregates import JSONBAgg\n>>> Room.objects.annotate(\n...     requirements=JSONBAgg(\n...         "hotelreservation__requirements",\n...         order_by="-hotelreservation__start",\n...     )\n... ).filter(requirements__0__sea_view=True).values("number", "requirements")\n<QuerySet [{'number': 102, 'requirements': [\n    {'parking': False, 'sea_view': True, 'double_bed': False},\n    {'parking': True, 'double_bed': True}\n]}]>\n
\n\n
\n\n
\n
\n

StringagLink to this heading#

\n
\n
\nclass StringAgg(expression, delimiter, distinct=False, filter=None, default=None, order_by=())Link to this definition#
\n

Filleann sé na luachanna ionchuir atá comhcheangailte i sreang, scartha leis an teaghrán delimiter, nó default mura bhfuil aon luachanna ann.

\n
\n
\ndelimiterLink to this definition#
\n

Argóint riachtanach. Caithfidh a bheith ina shreang.

\n
\n\n
\n
\ndistinctLink to this definition#
\n

Argóint roghnach boolean a chinneann an mbeidh luachanna comhtháite ar leith. Réamhshocraithe go False.

\n
\n\n
\n
\norder_byLink to this definition#
\n
\n

Sreang roghnach d'ainm réimse (le réimír roghnach ” -" a léiríonn ord íslitheach) nó abairt (nó liosta teaghráin agus/nó nathanna) a shonraíonn ordú na n-eilimintí sa sreangán torthaí.

\n

Examples are the same as for ArrayAgg.order_by.

\n
\n\n

Sampla úsáide:

\n
Code
class Publication(models.Model):\n    title = models.CharField(max_length=30)\n\n\nclass Article(models.Model):\n    headline = models.CharField(max_length=100)\n    publications = models.ManyToManyField(Publication)\n
\n
Python console
>>> article = Article.objects.create(headline="NASA uses Python")\n>>> article.publications.create(title="The Python Journal")\n<Publication: Publication object (1)>\n>>> article.publications.create(title="Science News")\n<Publication: Publication object (2)>\n>>> from django.contrib.postgres.aggregates import StringAgg\n>>> Article.objects.annotate(\n...     publication_names=StringAgg(\n...         "publications__title",\n...         delimiter=", ",\n...         order_by="publications__title",\n...     )\n... ).values("headline", "publication_names")\n<QuerySet [{\n    'headline': 'NASA uses Python', 'publication_names': 'Science News, The Python Journal'\n}]>\n
\n\n
\n\n
\n
\n
\n

Feidhmeanna comhiomlána leLink to this heading#

\n
\n

y agus xLink to this heading#

\n

Is féidir leis na hargóintí y agus x do na feidhmeanna seo go léir a bheith ina ainm réimse nó abairt ar ais sonraí uimhriúla. Tá an dá cheann ag teastáil.

\n
\n
\n

CorrLink to this heading#

\n
\n
\nclass Corr(y, x, filter=None, default=None)Link to this definition#
\n

Tugann an comhéifeacht comhghaoil ar ais mar snám, nó réamhshocraithe mura bhfuil aon sraitheanna meaitseála ann.

\n
\n\n
\n
\n

CovarpopLink to this heading#

\n
\n
\nclass CovarPop(y, x, sample=False, filter=None, default=None)Link to this definition#
\n

Tugann an comhathracht daonra ar ais mar snám, nó réamhshocraithe mura bhfuil aon sraitheanna meaitseála ann.

\n
\n
\nsampleLink to this definition#
\n

Roghnach. De réir réamhshocraithe filleann Covarpop an coathraitheacht ghinearálta daonra. Mar sin féin, má tá sample=True, is é an luach tuairisceáin an coathraitheacht daonra samplach.

\n
\n\n
\n\n
\n
\n

RegraVGXLink to this heading#

\n
\n
\nclass RegrAvgX(y, x, filter=None, default=None)Link to this definition#
\n

Tugann sé meán an athróg neamhspleách (sum (x) /N) ar ais mar snám`, nó ``réamhshocraithe mura bhfuil aon sraitheanna meaitseála ann.

\n
\n\n
\n
\n

RegravgiLink to this heading#

\n
\n
\nclass RegrAvgY(y, x, filter=None, default=None)Link to this definition#
\n

Tugann sé meán an athróg cleithiúnach (sum (y) /N) ar ais mar snám`, nó ``réamhshocraithe mura bhfuil aon sraitheanna meaitseála ann.

\n
\n\n
\n
\n

RegrCountLink to this heading#

\n
\n
\nclass RegrCount(y, x, filter=None)Link to this definition#
\n

Filleann sé ``int ``de líon na sraitheanna ionchuir nach bhfuil an dá abairt neall.

\n\n
\n\n
\n
\n

RegRinterceptLink to this heading#

\n
\n
\nclass RegrIntercept(y, x, filter=None, default=None)Link to this definition#
\n

Tugann sé an t-idirghabháil y den chothromóid líneach is lú atá oiriúnach cearnach arna chinneadh ag na péirí (x, y) mar snáth, nó réamhshocraithe mura bhfuil aon sraitheanna meaitseála ann.

\n
\n\n
\n
\n

RegRr2Link to this heading#

\n
\n
\nclass RegrR2(y, x, filter=None, default=None)Link to this definition#
\n

Tugann cearnóg an chomhéifeacht comhghaoil ar ais mar snám`, nó ``réamhshocraithe mura bhfuil aon sraitheanna meaitseála ann.

\n
\n\n
\n
\n

RegrSlopeLink to this heading#

\n
\n
\nclass RegrSlope(y, x, filter=None, default=None)Link to this definition#
\n

Tugann fána an chothromóid líneach is lú atá oiriúnach cearnach a chinneadh ag na péirí (x, y) mar snámh ``, nó ``réamhshocraithe mura bhfuil aon sraitheanna meaitseála ann.

\n
\n\n
\n
\n

RegRsXXLink to this heading#

\n
\n
\nclass RegrSXX(y, x, filter=None, default=None)Link to this definition#
\n

Tugann sum (x ^ 2) - suim (x) ^2/N (“suim na gcearnóga” den athróg neamhspleách) mar snám, nó réamhshocraithe` mura bhfuil aon sraitheanna meaitseála ann.

\n
\n\n
\n
\n

RegrsXYLink to this heading#

\n
\n
\nclass RegrSXY(y, x, filter=None, default=None)Link to this definition#
\n

Tuairisceáin suim (x*y) - suim (x) * suim (y) /N (“suim táirgí” d'athróg neamhspleách ag brath ar amanna) mar snám, nó réamhshocraithe mura bhfuil aon sraitheanna meaitseála ann.

\n
\n\n
\n
\n

RegrsyyLink to this heading#

\n
\n
\nclass RegrSYY(y, x, filter=None, default=None)Link to this definition#
\n

Tuairisceann sum (y ^ 2) - suim (y) ^2/N (“suim na gcearnóga” den athróg cleithiúnach) mar snám, nó réamhshocraithe mura bhfuil aon sraitheanna meaitseála ann.

\n
\n\n
\n
\n
\n

Samplaí úsáideLink to this heading#

\n

Úsáidfimid an tábla sampla seo:

\n
Text
| FIELD1 | FIELD2 | FIELD3 |\n|--------|--------|--------|\n|    foo |      1 |     13 |\n|    bar |      2 | (null) |\n|   test |      3 |     13 |\n
\n

Seo roinnt samplaí de chuid de na feidhmeanna comhiomlánaithe ginearálchuspóireach:

\n
Python console
>>> TestModel.objects.aggregate(result=StringAgg("field1", delimiter=";"))\n{'result': 'foo;bar;test'}\n>>> TestModel.objects.aggregate(result=ArrayAgg("field2"))\n{'result': [1, 2, 3]}\n>>> TestModel.objects.aggregate(result=ArrayAgg("field1"))\n{'result': ['foo', 'bar', 'test']}\n
\n

Taispeánann an chéad sampla eile úsáid feidhmeanna comhiomlán staitistiúla. < https://en.wikipedia.org/wiki/Regression_analysis>Ní dhéanfar cur síos ar an mhatamaitic bhunúsach (is féidir leat léamh faoi seo, mar shampla, ag wikipedia):

\n
Python console
>>> TestModel.objects.aggregate(count=RegrCount(y="field3", x="field2"))\n{'count': 2}\n>>> TestModel.objects.aggregate(\n...     avgx=RegrAvgX(y="field3", x="field2"), avgy=RegrAvgY(y="field3", x="field2")\n... )\n{'avgx': 2, 'avgy': 13}\n
\n
","rootId":"module-django.contrib.postgres.aggregates","toc":[{"title":"Feidhmeanna comhiomlánchuspóireach","anchor":"general-purpose-aggregation-functions","children":[{"title":"Arrayag","anchor":"arrayagg","children":[]},{"title":"Bitand","anchor":"bitand","children":[]},{"title":"Bitor","anchor":"bitor","children":[]},{"title":"Bitxor","anchor":"bitxor","children":[]},{"title":"Booland","anchor":"booland","children":[]},{"title":"Boolor","anchor":"boolor","children":[]},{"title":"Jsonbag","anchor":"jsonbagg","children":[]},{"title":"Stringag","anchor":"stringagg","children":[]}]},{"title":"Feidhmeanna comhiomlána le","anchor":"aggregate-functions-for-statistics","children":[{"title":"y agus x","anchor":"y-and-x","children":[]},{"title":"Corr","anchor":"corr","children":[]},{"title":"Covarpop","anchor":"covarpop","children":[]},{"title":"RegraVGX","anchor":"regravgx","children":[]},{"title":"Regravgi","anchor":"regravgy","children":[]},{"title":"RegrCount","anchor":"regrcount","children":[]},{"title":"RegRintercept","anchor":"regrintercept","children":[]},{"title":"RegRr2","anchor":"regrr2","children":[]},{"title":"RegrSlope","anchor":"regrslope","children":[]},{"title":"RegRsXX","anchor":"regrsxx","children":[]},{"title":"RegrsXY","anchor":"regrsxy","children":[]},{"title":"Regrsyy","anchor":"regrsyy","children":[]}]},{"title":"Samplaí úsáide","anchor":"usage-examples","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/5.2/ref/"},{"docname":"ref/contrib/index","title":"Pacáistí contrib","url":"/ga/5.2/ref/contrib/"},{"docname":"ref/contrib/postgres/index","title":"django.contrib.postgres","url":"/ga/5.2/ref/contrib/postgres/"}],"prev":{"docname":"ref/contrib/postgres/index","title":"django.contrib.postgres","url":"/ga/5.2/ref/contrib/postgres/"},"next":{"docname":"ref/contrib/postgres/constraints","title":"Srianta bunachar sonraí sonracha PostgreSQL","url":"/ga/5.2/ref/contrib/postgres/constraints/"},"formats":{"html":"/ga/5.2/ref/contrib/postgres/aggregates/","markdown":"/ga/5.2/ref/contrib/postgres/aggregates.md","json":"/ga/5.2/ref/contrib/postgres/aggregates.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/contrib/postgres/aggregates.txt","official":"https://docs.djangoproject.com/ga/5.2/ref/contrib/postgres/aggregates/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}