O que é uma anotação de agregação?

Nos frameworks ORM, como Django ou SQLAlchemy, a anotação de agregação permite adicionar campos calculados aos resultados de uma consulta, baseados em funções de agregação (SUM, COUNT, AVG, MAX, MIN) para registros relacionados. Permite obter informações resumidas sem executar subconsultas separadas ou joins complexos manualmente.

Exemplo no Django ORM:

from django.db.models import Count

# Obter uma lista de autores e o número de livros de cada
Author.objects.annotate(book_count=Count('book'))

Exemplo no SQLAlchemy ORM:

from sqlalchemy import func

# Obter uma lista de autores e o número de livros de cada
session.query(Author, func.count(Book.id).label('book_count')).join(Book).group_by(Author).all()

Principais vantagens:

• Eficiência: Reduz o número de consultas ao banco de dados.
• Legibilidade: Torna o código mais compreensível e conciso.
• Flexibilidade: Permite criar relatórios resumidos complexos.