生成值的汇总的另一个办法是为 ​QuerySet ​的每一个对象生成独立汇总。比如，如果你想检索书籍列表，你可能想知道每一本书有多少作者。每一本书与作者有多对多的关系；我们想在 ​QuerySet ​中为每一本书总结这个关系。

使用 ​annotate()​ 子句可以生成每一个对象的汇总。当指定 ​annotate()​ 子句，​QuerySet ​中的每一个对象将对指定值进行汇总。

这些语法与用于 ​aggregate()​ 子句的语法相同。 annotate() 的每个参数都描述了一个要计算的聚合。 例如，用作者数量注释书籍：

# Build an annotated queryset >>> from django.db.models import Count >>> q = Book.objects.annotate(Count('authors')) # Interrogate the first object in the queryset >>> q[0] <Book: The Definitive Guide to Django> >>> q[0].authors__count 2 # Interrogate the second object in the queryset >>> q[1] <Book: Practical Django Projects> >>> q[1].authors__count 1

与 ​aggregate()​ 一样，注解的名称是根据聚合函数和被聚合的字段名自动生成的。当你在指定注解的时候，你可以通过提供一个别名重写这个默认名：

>>> q = Book.objects.annotate(num_authors=Count('authors')) >>> q[0].num_authors 2 >>> q[1].num_authors 1

与 ​aggregate()​ 不同的是，​annotate()​ 不是终端子句。​annotate()​ 子句的输出就是 ​QuerySet​；这个 ​QuerySet ​被其他 ​QuerySet ​操作进行修改，包括 ​filter()​, ​order_by()​ ，甚至可以对 ​annotate()​ 进行额外调用。

组合多个聚合

将多个聚合与​ annotate() ​组合会产生错误的结果，因为使用的是连接而不是子查询：

>>> book = Book.objects.first() >>> book.authors.count() 2 >>> book.store_set.count() 3 >>> q = Book.objects.annotate(Count('authors'), Count('store')) >>> q[0].authors__count 6 >>> q[0].store__count 6

对大部分聚合来说，没办法避免这个问题，但是，​Count ​聚合可以使用 ​distinct ​参数来避免：

>>> q = Book.objects.annotate(Count('authors', distinct=True), Count('store', distinct=True)) >>> q[0].authors__count 2 >>> q[0].store__count 3