Перейти на PRO

Каковы различия между методами annotate и aggregate в Django ORM

Тип вопроса: Django Вероятность: 10% Категория: Python Разработчик

Ответ

В Django ORM annotate() и aggregate() — это методы QuerySet для выполнения агрегатных функций (таких как Sum, Count, Avg), но они возвращают результаты принципиально разного типа.

annotate() — для каждой записи

  • Что делает: Добавляет вычисляемое поле к каждому объекту в QuerySet.
  • Что возвращает: Новый QuerySet, где каждый объект дополнен новым полем.
  • Аналогия: Добавление нового столбца в таблицу с вычисленным значением для каждой строки (например, «количество заказов у каждого клиента»).

aggregate() — для всего набора

  • Что делает: Вычисляет итоговое значение для всего QuerySet.
  • Что возвращает: Словарь (dict) с итоговыми значениями.
  • Аналогия: Вычисление итоговой суммы или среднего по всему столбцу таблицы (например, «общая сумма всех заказов»).

Практический пример

Предположим, у нас есть модели Author и Book:

from django.db import models
from django.db.models import Count, Avg

class Author(models.Model):
    name = models.CharField(max_length=100)

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.ForeignKey(Author, on_delete=models.CASCADE, related_name='books')
    rating = models.FloatField()

Использование annotate(): Получим количество книг для каждого автора.

# Возвращает QuerySet объектов Author, у каждого из которых есть поле 'num_books'
authors = Author.objects.annotate(num_books=Count('books'))

for author in authors:
    # author.name = 'J.K. Rowling', author.num_books = 7
    # author.name = 'J.R.R. Tolkien', author.num_books = 3
    print(f"{author.name} написал(а) книг: {author.num_books}")

Использование aggregate(): Вычислим средний рейтинг по всем книгам в базе данных.

# Возвращает словарь с одним ключом 'avg_rating'
result = Book.objects.aggregate(avg_rating=Avg('rating'))

# result будет {'avg_rating': 4.25}
print(f"Средний рейтинг всех книг: {result['avg_rating']}")

Вывод: annotate() обогащает каждую запись в наборе данных, а aggregate() сводит весь набор данных к одному итоговому значению.

Ответ 18+ 🔞

А, ну ты глянь, опять про эти annotate() и aggregate() спрашивают. Ёпта, это ж классика, как "Муму" и Герасим, только в коде, блядь.

Смотри, чтобы не путаться, представь себе такую картину. Вот есть у тебя бар, полный авторов, которые книжки пишут. annotate() — это как подойти к каждому чуваку, посчитать, сколько у него пустых стаканов на столе, и приклеить ему на лоб бумажку с цифрой. Каждому, сука! А aggregate() — это подойти к бармену и спросить: «Слушай, а сколько в среднем стаканов на столе у всех этих креативных личностей?». И он тебе одну цифру назовёт, пизда.

Технически, если без соплей:

  • annotate() — это для каждой строчки в результате. Возвращает он QuerySet, где у каждого объекта появляется новое, блядь, вычисляемое поле. Как будто новый столбец в таблицу добавили.
  • aggregate() — это для всего запроса целиком. Возвращает он словарик, один на всех, с итоговыми циферками. Всё, что насобирал, в одну кучу свалил.

Вот смотри на примере, а то мозги сейчас ебнуть могут.

Допустим, модели такие:

from django.db import models
from django.db.models import Count, Avg

class Author(models.Model):
    name = models.CharField(max_length=100)

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.ForeignKey(Author, on_delete=models.CASCADE, related_name='books')
    rating = models.FloatField()

Ситуация первая, annotate(): Надо узнать, сколько книг написал каждый плодовитый товарищ.

# Берём всех авторов и КАЖДОМУ приписываем поле 'num_books'
authors_with_counts = Author.objects.annotate(num_books=Count('books'))

for author in authors_with_counts:
    # Теперь у каждого автора есть своё личное поле 'num_books'
    # 'Джоан Роулинг' -> num_books = 7
    # 'Толкин' -> num_books = 3
    print(f"{author.name} — плодовитый мудак, книг: {author.num_books}")

Ситуация вторая, aggregate(): Надо выяснить, а не говно ли в среднем все эти книжки, которые они написали.

# Собираем ВСЕ книги и считаем ОДНУ среднюю оценку на всех
total_avg = Book.objects.aggregate(avg_rating=Avg('rating'))

# total_avg — это словарь, типа {'avg_rating': 3.14}
print(f"Средний рейтинг по палате: {total_avg['avg_rating']}. Пидары, одним словом.")

Вот и вся разница, в рот меня чих-пых! annotate() — каждому по бумажке на лоб, aggregate() — один вердикт на всю толпу. Запомнил? А то опять переспрашивать будешь.

© ХакСобесов, 2026
support@hacksobesov.com