Когда QuerySet выполняет запросы к БД?

Когда QuerySet выполняет запросы к БД?

QuerySet в Django работает по принципу ленивого вычисления (lazy evaluation). Это означает, что запрос к базе данных не выполняется сразу, а откладывается до момента, когда результаты действительно нужны.

1. QuerySet ленивый по умолчанию

Сам по себе создание QuerySet не генерирует SQL запрос:

from django.db.models import QuerySet
from myapp.models import Post

# Этот код НЕ генерирует запрос к БД
qs = Post.objects.filter(published=True)

# Запрос НЕ выполнен!
print(type(qs))  # <class 'django.db.models.query.QuerySet'>

QuerySet описывает, КАКОЙ запрос выполнить, но не выполняет его. Это позволяет оптимизировать: вы можете добавлять фильтры, сортировку, пагинацию перед тем, как отправить один оптимальный запрос.

2. Момент выполнения запроса (Evaluation)

QuerySet вычисляется (выполняется) в следующих случаях:

a) Итерация по QuerySet

# Запрос выполнится ВЫ when iterating
for post in Post.objects.filter(published=True):
    print(post.title)

b) Преобразование в список

# Запрос выполнится
posts = list(Post.objects.filter(published=True))

# Или
posts = Post.objects.filter(published=True)[:]  # Срез без границ

c) Проверка существования элемента

# Запрос выполнится
if Post.objects.filter(published=True).exists():
    print("Есть опубликованные посты")

d) Получение длины

# Запрос выполнится
count = len(Post.objects.filter(published=True))

# Или лучше (один запрос COUNT)
count = Post.objects.filter(published=True).count()

e) Сравнение с True/False

# Запрос выполнится
if Post.objects.filter(published=True):  # Требует список
    print("Есть посты")

# Лучше использовать
if Post.objects.filter(published=True).exists():
    print("Есть посты")

f) Использование in оператора

# Запрос выполнится при проверке
if 5 in Post.objects.all():
    print("Пост найден")

g) Представление (repr) и str

# Запрос выполнится
qs = Post.objects.all()
print(str(qs))  # Требует вычисления
print(repr(qs))

3. Оптимизация: цепочки фильтров

Большое преимущество ленивого вычисления — можно строить оптимальные запросы:

# Все эти операции НЕ генерируют запросы
qs = Post.objects.all()
qs = qs.filter(published=True)
qs = qs.filter(author__is_active=True)
qs = qs.exclude(deleted=True)
qs = qs.order_by('-created_at')
qs = qs.select_related('author')
qs = qs.prefetch_related('comments')

# Только здесь выполнится ОДИН оптимальный SQL запрос
for post in qs:
    print(post.title)

Django объединяет все фильтры в один SQL запрос с JOIN'ами.

4. Срезы QuerySet

Не вычисляются при использовании LIMIT:

# Не выполняет запрос
qs = Post.objects.all()[10:20]  # LIMIT 10 OFFSET 10

# Выполнит запрос, только когда вы итерируете или получаете элемент
for post in qs:
    print(post)

# Это выполнит запрос
post = Post.objects.all()[0]

Но:

# Это ВЫПОЛНИТ весь результат в памяти
count = len(Post.objects.all())  # Плохо!

# Это выполнит COUNT query
count = Post.objects.all().count()  # Хорошо!

5. Агрегирующие функции

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

# Эти методы выполняют запрос и возвращают результат
total = Post.objects.count()  # SELECT COUNT(*)
total_views = Post.objects.aggregate(Sum('views'))['views__sum']

# QuerySet с values и annotate выполняется при итерации
qs = Post.objects.values('author').annotate(count=Count('id'))
# Запрос НЕ выполнен

for item in qs:
    print(item)  # Теперь выполнен

6. Проверка SQL запроса

Вы можете посмотреть, какой SQL будет выполнен, без выполнения:

qs = Post.objects.filter(published=True)

# Посмотреть SQL без выполнения
print(qs.query)  # SELECT ... FROM ...

# Или
from django.db import connection
from django.test.utils import CaptureQueriesContext

with CaptureQueriesContext(connection) as context:
    list(qs)  # Выполнить запрос
    
print(context.captured_queries)  # Все выполненные запросы

7. Частые ошибки

Ошибка 1: Вычисление в цикле

# ❌ ПЛОХО: N+1 проблема
posts = Post.objects.all()
for post in posts:
    print(f"Author: {post.author.name}")  # Каждая итерация = новый запрос!

# ✅ ХОРОШО: select_related
posts = Post.objects.select_related('author')
for post in posts:
    print(f"Author: {post.author.name}")  # Все в одном запросе!

Ошибка 2: len вместо count

# ❌ ПЛОХО: загружает ВСЕ данные в памяь
if len(Post.objects.all()) > 0:
    print("Есть посты")

# ✅ ХОРОШО: один COUNT запрос
if Post.objects.exists():
    print("Есть посты")

Ошибка 3: Множественные QuerySet вычисления

# ❌ ПЛОХО: вычисление два раза
qs = Post.objects.filter(published=True)
list(qs)  # Первое вычисление
list(qs)  # Второе вычисление — два SQL запроса!

# ✅ ХОРОШО: сохранить результаты
posts = list(Post.objects.filter(published=True))
# Дальше работаем с Python списком, без новых запросов

8. Когда запрос НЕ выполняется

# Все эти операции просто возвращают новый QuerySet

# Фильтрация
qs2 = qs.filter(author=1)

# Исключение
qs2 = qs.exclude(deleted=True)

# Сортировка
qs2 = qs.order_by('-created_at')

# Выбор полей
qs2 = qs.values('id', 'title')

# Переименование
qs2 = qs.annotate(post_count=Count('comments'))

# Distinct
qs2 = qs.distinct()

# Reverse
qs2 = qs.reverse()

# Только эти методы запускают запрос:
# - list(), for loop, iter()
# - count(), exists(), all()
# - first(), last()
# - get(), update(), delete()
# - values_list()
# - aggregate()

Итоговые рекомендации

1. Помните о ленивом вычислении — QuerySet не выполняется сразу
2. Используйте select_related() и prefetch_related() для избежания N+1 проблем
3. Предпочитайте count() вместо len() на QuerySet'ах
4. Используйте exists() для проверки существования
5. Смотрите SQL через print(qs.query) для отладки
6. Строите оптимальные цепочки фильтров перед вычислением
7. Ограничивайте результаты с помощью слайсов перед вычислением

Правильное понимание ленивого вычисления критично для написания производительного Django кода.