Функции агрегации, специфичные для PostgreSQL¶

ArrayAgg¶

class ArrayAgg(expression, distinct=False, filter=None, ordering=(), **extra)[исходный код]¶

Возвращает список значений, включая нули, объединенных в массив.

distinct¶

Необязательный булев аргумент, определяющий, будут ли значения массива различаться. По умолчанию имеет значение False.

ordering¶

Необязательная строка имени поля (с необязательным префиксом "-", который указывает порядок убывания) или выражение (или кортеж или список строк и/или выражений), которое определяет порядок элементов в списке результатов.

Примеры:

'some_field'
'-some_field'
from django.db.models import F
F('some_field').desc()

BitAnd¶

class BitAnd(expression, filter=None, **extra)[исходный код]¶

Возвращает int побитового AND всех не нулевых входных значений, или None, если все значения нулевые.

BitOr¶

class BitOr(expression, filter=None, **extra)[исходный код]¶

Возвращает int побитового OR всех не нулевых входных значений, или None, если все значения нулевые.

BoolAnd¶

class BoolAnd(expression, filter=None, **extra)[исходный код]¶

Возвращает True, если все входные значения истинны, None, если все значения равны null или отсутствуют, иначе False .

Пример использования:

class Comment(models.Model):
    body = models.TextField()
    published = models.BooleanField()
    rank = models.IntegerField()

>>> 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, **extra)[исходный код]¶

Возвращает True, если хотя бы одно входное значение истинно, None, если все значения нулевые или отсутствуют, иначе False.

Пример использования:

class Comment(models.Model):
    body = models.TextField()
    published = models.BooleanField()
    rank = models.IntegerField()

>>> 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, ordering=(), **extra)[исходный код]¶

Возвращает входные значения в виде массива JSON.

distinct¶

New in Django Development version.

Необязательный булев аргумент, определяющий, будут ли значения массива различаться. По умолчанию имеет значение False.

ordering¶

New in Django Development version.

Необязательная строка имени поля (с необязательным префиксом "-", который указывает порядок убывания) или выражение (или кортеж или список строк и/или выражений), которое определяет порядок элементов в списке результатов.

Примеры такие же, как и для ArrayAgg.ordering.

StringAgg¶

class StringAgg(expression, delimiter, distinct=False, filter=None, ordering=())[исходный код]¶

Возвращает входные значения, скомпонованные в строку, разделенные строкой delimiter.

delimiter¶

Обязательный аргумент. Должен быть строкой.

distinct¶

Необязательный булев аргумент, определяющий, будут ли конкатенированные значения различаться. По умолчанию имеет значение False.

ordering¶

Необязательная строка имени поля (с необязательным префиксом "-", который указывает порядок убывания) или выражение (или кортеж или список строк и/или выражений), которое определяет порядок элементов в строке результата.

Примеры такие же, как и для ArrayAgg.ordering.

y и x.¶

Аргументами y и x для всех этих функций могут быть имя поля или выражение, возвращающее числовые данные. Оба аргумента являются обязательными.

Corr¶

class Corr(y, x, filter=None)[исходный код]¶

Возвращает коэффициент корреляции в виде float, или None, если нет ни одной совпадающей строки.

CovarPop¶

class CovarPop(y, x, sample=False, filter=None)[исходный код]¶

Возвращает ковариацию популяции в виде float, или None, если нет ни одной совпадающей строки.

Имеет один необязательный аргумент:

sample¶

По умолчанию CovarPop возвращает ковариацию генеральной совокупности. Однако, если sample=True, возвращаемое значение будет ковариацией выборочной совокупности.

RegrAvgX¶

class RegrAvgX(y, x, filter=None)[исходный код]¶

Возвращает среднее значение независимой переменной (sum(x)/N) в виде float, или None, если нет ни одной совпадающей строки.

RegrAvgY¶

class RegrAvgY(y, x, filter=None)[исходный код]¶

Возвращает среднее значение зависимой переменной (sum(y)/N) в виде float, или None, если нет ни одной совпадающей строки.

RegrCount¶

class RegrCount(y, x, filter=None)[исходный код]¶

Возвращает int количество строк ввода, в которых оба выражения не являются нулевыми.

RegrIntercept¶

class RegrIntercept(y, x, filter=None)[исходный код]¶

Возвращает y-пересечение линейного уравнения, определенного по парам (x, y) в виде float, или None, если нет ни одного подходящего ряда.

RegrR2¶

class RegrR2(y, x, filter=None)[исходный код]¶

Возвращает квадрат коэффициента корреляции в виде float, или None, если нет ни одной совпадающей строки.

RegrSlope¶

class RegrSlope(y, x, filter=None)[исходный код]¶

Возвращает наклон линейного уравнения, определенного парами (x, y), как float, или None, если нет ни одного совпадающего ряда.

RegrSXX¶

class RegrSXX(y, x, filter=None)[исходный код]¶

Возвращает sum(x^2) - sum(x)^2/N («сумму квадратов» независимой переменной) в виде float, или None, если нет ни одной совпадающей строки.

RegrSXY¶

class RegrSXY(y, x, filter=None)[исходный код]¶

Возвращает sum(x*y) - sum(x) * sum(y)/N («сумму произведений» независимой переменной на зависимую) в виде float, или None, если нет ни одной совпадающей строки.

RegrSYY¶

class RegrSYY(y, x, filter=None)[исходный код]¶

Возвращает sum(y^2) - sum(y)^2/N («сумму квадратов» зависимой переменной) в виде float, или None, если нет ни одной совпадающей строки.