В Django ORM методы annotate() и aggregate() позволяют использовать агрегирующие функции SQL, такие как COUNT, SUM, AVG, MAX, MIN.
Однако работают они по-разному и служат разным задачам.

annotate() — вычисления для каждого объекта QuerySet

Назначение: добавить новое поле, вычисляемое SQL-агрегатом, к каждому элементу выборки.

Пример: считаем число комментариев у каждой статьи.

python

from django.db.models import Count

articles = Article.objects.annotate(total_comments=Count('comments'))

Каждый объект Article получит поле .total_comments.

aggregate() — один общий результат по выборке

Назначение: вернуть итоговое значение, а не QuerySet.

Пример:

python

from django.db.models import Avg

average_age = User.objects.aggregate(avg_age=Avg('age'))

Результат:

{'avg_age': 27.5}

Главное различие

annotate():

• возвращает QuerySet

• добавляет вычисления к каждому объекту

• формирует SQL c GROUP BY

aggregate():

• возвращает словарь

• выполняет один итоговый запрос

• не создаёт группировок, если они не нужны

Использование вместе

Пример:

python

Article.objects.annotate(total=Count('comments')).aggregate(sum=Sum('total'))

Итог

annotate() → добавить поле с вычислениями на каждый объект.
aggregate() → получить итоговое значение по всей выборке.