--- title: "PostgreSQL-specifika aggregeringsfunktioner" version: 6.1 locale: sv source: https://docs.djangoproject.com/sv/6.1/ref/contrib/postgres/aggregates/ canonical: https://djangodocs.dev/sv/6.1/ref/contrib/postgres/aggregates/ --- # PostgreSQL-specifika aggregeringsfunktioner Dessa funktioner är tillgängliga från modulen `django.contrib.postgres.aggregates`. De beskrivs mer detaljerat i [PostgreSQL-dokumenten](https://www.postgresql.org/docs/current/functions-aggregate.html). > **Note** > > Alla funktioner levereras utan standardaliaser, så du måste uttryckligen ange en. Till exempel: > > ```pycon > >>> SomeModel.objects.aggregate(arr=ArrayAgg("somefield")) > {'arr': [0, 1, 2]} > ``` > **Gemensamma aggregerade optioner** > > Alla aggregat har nyckelordsargumentet [filter](/sv/6.1/ref/models/querysets/#aggregate-filter) och de flesta har också nyckelordsargumentet [default](/sv/6.1/ref/models/querysets/#aggregate-default). ## Aggregeringsfunktioner för allmänt bruk ### `ArrayAgg` #### `class ArrayAgg(expression, distinct=False, filter=None, default=None, order_by=(), **extra)` Returnerar en lista med värden, inklusive nollvärden, sammanlänkade till en array, eller `default` om det inte finns några värden. #### `distinct` Ett valfritt booleskt argument som avgör om matrisvärdena ska vara distinkta. Standardvärdet är `False`. #### `order_by` En valfri sträng med ett fältnamn (med ett valfritt prefix `"-"` som anger fallande ordning) eller ett uttryck (eller en tupel eller en lista med strängar och/eller uttryck) som anger ordningen på elementen i resultatlistan. Exempel: ``` from django.db.models import F ArrayAgg("a_field", order_by="-some_field") ArrayAgg("a_field", order_by=F("some_field").desc()) ``` ### `Bit och` #### `class BitAnd(expression, filter=None, default=None, **extra)` Returnerar ett `int` av bitvis `AND` av alla icke-null värden, eller `default` om alla värden är null. > **Deprecated since Django 6.1** > > Ersatt sedan version 6.1: This class is deprecated in favor of the generally available > [`BitAnd`](/sv/6.1/ref/models/querysets/#django.db.models.BitAnd) class. ### `BitOr` #### `class BitOr(expression, filter=None, default=None, **extra)` Returnerar ett `int` av det bitvisa `OR` av alla icke-null indatavärden, eller `default` om alla värden är null. > **Deprecated since Django 6.1** > > Ersatt sedan version 6.1: This class is deprecated in favor of the generally available > [`BitOr`](/sv/6.1/ref/models/querysets/#django.db.models.BitOr) class. ### `BitXor` #### `class BitXor(expression, filter=None, default=None, **extra)` Returns an `int` of the bitwise `XOR` of all non-null input values, or `default` if all values are null. > **Deprecated since Django 6.1** > > Ersatt sedan version 6.1: This class is deprecated in favor of the generally available > [`BitXor`](/sv/6.1/ref/models/querysets/#django.db.models.BitXor) class. ### `BoolAnd` #### `class BoolAnd(expression, filter=None, default=None, **extra)` Returnerar `True`, om alla indatavärden är sanna, `default` om alla värden är null eller om det inte finns några värden, annars `False`. Exempel på användning: ``` class Comment(models.Model): body = models.TextField() published = models.BooleanField() rank = models.IntegerField() ``` ```pycon >>> from django.db.models import Q >>> from django.contrib.postgres.aggregates import BoolAnd >>> Comment.objects.aggregate(booland=BoolAnd("published")) {'booland': False} >>> Comment.objects.aggregate(booland=BoolAnd(Q(rank__lt=100))) {'booland': True} ``` ### `BoolOr` #### `class BoolOr(expression, filter=None, default=None, **extra)` Returnerar `True` om minst ett inmatningsvärde är sant, `default` om alla värden är null eller om det inte finns några värden, annars `False`. Exempel på användning: ``` class Comment(models.Model): body = models.TextField() published = models.BooleanField() rank = models.IntegerField() ``` ```pycon >>> from django.db.models import Q >>> from django.contrib.postgres.aggregates import BoolOr >>> Comment.objects.aggregate(boolor=BoolOr("published")) {'boolor': True} >>> Comment.objects.aggregate(boolor=BoolOr(Q(rank__gt=2))) {'boolor': False} ``` ### `JSONBAgg` #### `class JSONBAgg(expressions, distinct=False, filter=None, default=None, order_by=(), **extra)` Returnerar indatavärdena som en `JSON`-array, eller `default` om det inte finns några värden. Du kan fråga efter resultatet med hjälp av [`nyckel- och indexuppslagningar`](/sv/6.1/topics/db/queries/#std-fieldlookup-jsonfield.key). #### `distinct` Ett valfritt booleskt argument som avgör om matrisvärdena ska vara distinkta. Standardvärdet är `False`. #### `order_by` En valfri sträng med ett fältnamn (med ett valfritt prefix `"-"` som anger fallande ordning) eller ett uttryck (eller en tupel eller en lista med strängar och/eller uttryck) som anger ordningen på elementen i resultatlistan. Exemplen är desamma som för [`ArrayAgg.order_by`](#django.contrib.postgres.aggregates.ArrayAgg.order_by). Exempel på användning: ``` class Room(models.Model): number = models.IntegerField(unique=True) class HotelReservation(models.Model): room = models.ForeignKey("Room", on_delete=models.CASCADE) start = models.DateTimeField() end = models.DateTimeField() requirements = models.JSONField(blank=True, null=True) ``` ```pycon >>> from django.contrib.postgres.aggregates import JSONBAgg >>> Room.objects.annotate( ... requirements=JSONBAgg( ... "hotelreservation__requirements", ... order_by="-hotelreservation__start", ... ) ... ).filter(requirements__0__sea_view=True).values("number", "requirements") ``` ### `StringAgg` #### `class StringAgg(expression, delimiter, distinct=False, filter=None, default=None, order_by=())` > **Deprecated since Django 6.0** > > Ersatt sedan version 6.0: The PostgreSQL `StringAgg` class is deprecated in favor of the > generally available [`StringAgg`](/sv/6.1/ref/models/querysets/#django.db.models.StringAgg) class. Returnerar indatavärdena sammankopplade till en sträng, åtskilda av strängen `delimiter` eller `default` om det inte finns några värden. #### `delimiter` Required argument. A string, [`Value`](/sv/6.1/ref/models/expressions/#django.db.models.Value), or expression representing the string for separating values. For example, `Value(",")`. > **New in Django 6.0** > > Support for providing a `Value` or expression rather than a > string was added. > **Deprecated since Django 6.0** > > Ersatt sedan version 6.0: Support for providing a string is deprecated. #### `distinct` Ett valfritt booleanskt argument som avgör om sammanlänkade värden ska vara distinkta. Standardvärdet är `False`. #### `order_by` En valfri sträng med ett fältnamn (med ett valfritt prefix `"-"` som anger fallande ordning) eller ett uttryck (eller en tupel eller en lista med strängar och/eller uttryck) som anger ordningen på elementen i resultatsträngen. Exemplen är desamma som för [`ArrayAgg.order_by`](#django.contrib.postgres.aggregates.ArrayAgg.order_by). Exempel på användning: ``` class Publication(models.Model): title = models.CharField(max_length=30) class Article(models.Model): headline = models.CharField(max_length=100) publications = models.ManyToManyField(Publication) ``` ```pycon >>> article = Article.objects.create(headline="NASA uses Python") >>> article.publications.create(title="The Python Journal") >>> article.publications.create(title="Science News") >>> from django.contrib.postgres.aggregates import StringAgg >>> Article.objects.annotate( ... publication_names=StringAgg( ... "publications__title", ... delimiter=", ", ... order_by="publications__title", ... ) ... ).values("headline", "publication_names") ``` ## Aggregerade funktioner för statistik ### `y` och `x` Argumenten `y` och `x` för alla dessa funktioner kan vara namnet på ett fält eller ett uttryck som returnerar numeriska data. Båda är obligatoriska. ### `Corr` #### `class Corr(y, x, filter=None, default=None)` Returnerar korrelationskoefficienten som en `flata`, eller `standard` om det inte finns några matchande rader. ### `CovarPop` #### `class CovarPop(y, x, sample=False, filter=None, default=None)` Returnerar populationens kovarians som en `flata`, eller `standard` om det inte finns några matchande rader. #### `sample` Valfritt. Som standard returnerar `CovarPop` den allmänna populationens kovarians. Men om `sample=True`, kommer returvärdet att vara urvalspopulationens kovarians. ### `RegrAvgX` #### `class RegrAvgX(y, x, filter=None, default=None)` Returnerar medelvärdet av den oberoende variabeln (`sum(x)/N`) som en `flata`, eller `standard` om det inte finns några matchande rader. ### `RegrAvgY` #### `class RegrAvgY(y, x, filter=None, default=None)` Returnerar medelvärdet av den beroende variabeln (`sum(y)/N`) som en `flata`, eller `standard` om det inte finns några matchande rader. ### `RegrCount` #### `class RegrCount(y, x, filter=None)` Returnerar ett `int` av antalet indatarader där båda uttrycken inte är null. > **Note** > > Argumentet `default` stöds inte. ### `RegrIntercept` #### `class RegrIntercept(y, x, filter=None, default=None)` Returnerar y-interceptet för den linjära ekvationen med minsta kvadratanpassning som bestäms av paren `(x, y)` som en `float`, eller `default` om det inte finns några matchande rader. ### `RegrR2` #### `class RegrR2(y, x, filter=None, default=None)` Returnerar kvadraten på korrelationskoefficienten som en `float`, eller `default` om det inte finns några matchande rader. ### `RegrSlope` #### `class RegrSlope(y, x, filter=None, default=None)` Returnerar lutningen för den linjära ekvationen med minsta kvadratanpassning som bestäms av paren `(x, y)` som en `flata`, eller `default` om det inte finns några matchande rader. ### `RegrSXX` #### `class RegrSXX(y, x, filter=None, default=None)` Returnerar `sum(x^2) - sum(x)^2/N` (”kvadratsumman” för den oberoende variabeln) som en `float`, eller `default` om det inte finns några matchande rader. ### `RegrSXY` #### `class RegrSXY(y, x, filter=None, default=None)` Returnerar `sum(x*y) - sum(x) * sum(y)/N` (”summan av produkter” av oberoende gånger beroende variabel) som en `float`, eller `default` om det inte finns några matchande rader. ### `RegrSYY` #### `class RegrSYY(y, x, filter=None, default=None)` Returnerar `sum(y^2) - sum(y)^2/N` (”kvadratsumman” för den beroende variabeln) som en `float`, eller `default` om det inte finns några matchande rader. ## Exempel på användning Vi kommer att använda denna exempeltabell: ```text | FIELD1 | FIELD2 | FIELD3 | |--------|--------|--------| | foo | 1 | 13 | | bar | 2 | (null) | | test | 3 | 13 | ``` Här följer några exempel på några av de allmänna aggregeringsfunktionerna: ```pycon >>> TestModel.objects.aggregate(result=StringAgg("field1", delimiter=";")) {'result': 'foo;bar;test'} >>> TestModel.objects.aggregate(result=ArrayAgg("field2")) {'result': [1, 2, 3]} >>> TestModel.objects.aggregate(result=ArrayAgg("field1")) {'result': ['foo', 'bar', 'test']} ``` Nästa exempel visar användningen av statistiska aggregatfunktioner. Den underliggande matematiken kommer inte att beskrivas (du kan läsa om detta, till exempel på [wikipedia](https://en.wikipedia.org/wiki/Regression_analysis)): ```pycon >>> TestModel.objects.aggregate(count=RegrCount(y="field3", x="field2")) {'count': 2} >>> TestModel.objects.aggregate( ... avgx=RegrAvgX(y="field3", x="field2"), avgy=RegrAvgY(y="field3", x="field2") ... ) {'avgx': 2, 'avgy': 13} ```