这些功能可以从 django.contrib.postgres.aggregates
模块中获得。在 PostgreSQL docs 中对这些功能有更详细的描述。
注解
所有的函数都没有默认的别名,所以你必须明确提供一个别名。例如:
>>> SomeModel.objects.aggregate(arr=ArrayAgg('somefield'))
{'arr': [0, 1, 2]}
ArrayAgg
¶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()
BoolAnd
¶BoolAnd
(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 BoolAnd
>>> Comment.objects.aggregate(booland=BoolAnd('published'))
{'booland': False}
>>> Comment.objects.aggregate(booland=BoolAnd(Q(rank__lt=100)))
{'booland': True}
BoolOr
¶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
¶JSONBAgg
(expressions, distinct=False, filter=None, ordering=(), **extra)¶将输入值以 JSON
数组形式返回。
distinct
¶一个可选的布尔参数,用于确定数组值是否会被去重。默认值为 False
。
ordering
¶可选的字段名字符串(可选的 "-"
前缀表示降序)或表达式(或字符串和/或表达式的元组或列表),指定结果列表中元素的顺序。
例子与 ArrayAgg.ordering
相同。
y
和 x
¶所有这些函数的参数 y
和 x
可以是字段名或返回数值数据的表达式。这两个参数都是必须的。
CovarPop
¶RegrIntercept
¶RegrIntercept
(y, x, filter=None)¶返回由 (x, y)
对确定的最小二乘拟合线性方程的 y 截距,如果没有任何匹配的行,则返回 None
。
RegrSXX
¶RegrSXX
(y, x, filter=None)¶返回 sum(x^2) - sum(x)^2/N
(自变量的“平方和”)作为 float
,如果没有任何匹配的行,则返回 None
。
我们将用这个例表:
| FIELD1 | FIELD2 | FIELD3 |
|--------|--------|--------|
| foo | 1 | 13 |
| bar | 2 | (null) |
| test | 3 | 13 |
下面是一些通用聚合函数的例子:
>>> 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']}
下一个例子显示了统计聚合函数的使用。基本的数学知识将不作说明(例如,你可以在 wikipedia ):
>>> 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}
12月 07, 2021