Использование методов all(), filter(), get() в Django ORM

В этой лекции мы углубимся в возможности работы с данными и более детально разберем методы all(), filter() и get() в Django ORM.

Зачем нам all(), filter() и get()?

Обработка данных в приложении требует функциональных и удобных инструментов для получения информации. Методы all(), filter() и get() являются основополагающими для взаимодействия с базой данных через ORM.

Может возникнуть закономерный вопрос: а почему бы нам просто не писать сырые SQL-запросы? Это возможно, но:

• Их сложно поддерживать: представьте, что бизнес-логика меняется. Что тогда? Ручной рефакторинг SQL-запросов!
• Это ненадежно: за безопасность должен отвечать ORM, а не доводиться до нервного тика от SQL-инъекций.
• Да еще и скучно! Django ORM дает вам Python, а не SQL. Зачем усложнять себе жизнь?

Метод all()

Метод all() используется для получения всех записей из таблицы, связанной с моделью.

Пример использования

# Модель для примера
from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=255)
    author = models.CharField(max_length=100)
    published_year = models.IntegerField()

Получим все книги из базы данных:

# Получение всех записей
books = Book.objects.all()

# Просмотр результата
for book in books:
    print(f"{book.title} — {book.author}, {book.published_year}")

Особенности

1. all() возвращает QuerySet. Это означает:
   • Он ленивый (ленится выполнять запросы, пока вы к нему не обратитесь).
   • Можно использовать цепочки методов (например, комбинировать с filter() или order_by()).
2. Если в таблице нет данных, вернется пустой QuerySet, а не None.

Пример цепочки методов

Добавим сортировку, сразу после метода all():

# Получение всех книг по убыванию года публикации
books = Book.objects.all().order_by('-published_year')

for book in books:
    print(f"{book.title} — {book.published_year}")

Метод filter()

filter() используется для извлечения записей, соответствующих одному или нескольким условиям.

Примеры использования

1. Фильтрация по одному полю:

   # Найти все книги автора "Дмитрий Глуховский"
   books = Book.objects.filter(author="Дмитрий Глуховский")
   
   for book in books:
       print(book.title)

2. Фильтрация по нескольким условиям:

   # Найти книги автора "Дмитрий Глуховский", опубликованные после 2005 года
   books = Book.objects.filter(author="Дмитрий Глуховский", published_year__gt=2005)
   
   for book in books:
       print(book.title)

3. Использование сложных условий с Q (из предыдущей лекции вы наверняка помните Q):

   from django.db.models import Q
   
   # Найти книги, опубликованные до 2000 года или написанные автором "Лев Толстой"
   books = Book.objects.filter(Q(published_year__lt=2000) | Q(author="Лев Толстой"))
   
   for book in books:
       print(book.title)
   
   

Особенности

• filter() возвращает QuerySet (аналогично all()).
• Если в таблице нет записей, соответствующих условиям, вернется пустой QuerySet.

Метод get()

get() извлекает ровно одну запись, которая соответствует заданным условиям.

Пример использования

1. Получение записи по ID:

   # Найти книгу с ID = 5
   book = Book.objects.get(id=5)
   print(book.title)

2. Фильтрация по полям модели:

   # Найти книгу с названием "1984" и автором "Джордж Оруэлл"
   book = Book.objects.get(title="1984", author="Джордж Оруэлл")
   print(f"{book.title} — {book.author}")

Важное различие: get() vs filter()

• get() возвращает один объект модели (а не QuerySet).
• Если запись не найдена, бросается исключение DoesNotExist. Будьте осторожны — лучше оборачивать в try...except:

  try:
      book = Book.objects.get(id=9999)  # ID, которого нет
  except Book.DoesNotExist:
      print("Такой книги нет!")
  

• Если условию подходит больше одной записи, вы получите MultipleObjectsReturned. Вот вам еще одна причина не использовать get() без уверенности!

Когда использовать get()?

Используйте его только тогда, когда уверены, что запрос вернет ровно одну запись. В остальных случаях filter() безопаснее.

Различия между all(), filter() и get()

Лучшие практики и типичные ошибки

1. Ленивая загрузка:

   методы all() и filter() возвращают ленивый QuerySet. Если вы случайно не "материализовали" QuerySet (например, перебрав его в цикле), SQL-запрос просто не выполнится. Чтобы проверить запрос, можно воспользоваться методом .query:

   books = Book.objects.filter(author="Дмитрий Глуховский")
   print(books.query)  # Печатает SQL-запрос
   

2. Использование get() на неподходящий запрос: никогда не используйте get(), если запрос может вернуть более одной записи. Например:

   # Это вызовет MultipleObjectsReturned, если есть две одинаковые книги
   book = Book.objects.get(author="Лев Толстой")

3. Обработка пустых результатов: всегда проверяйте результат вызова filter() или all() на наличие записей перед выполнением операций:

   books = Book.objects.filter(author="Неизвестный автор")
   if not books.exists():
       print("Книги не найдены!")
   

Применение на практике

Давайте добавим в наше приложение простую функциональность. Представьте, что нам нужно реализовать поиск книг для библиотеки.

Шаг 1: Создаем представление

# views.py

from django.shortcuts import render
from .models import Book

def search_books(request):
    query = request.GET.get('q', '')  # Получить поисковый запрос от пользователя
    books = Book.objects.filter(title__icontains=query)  # Фильтр по заголовку
    return render(request, 'search_results.html', {'books': books, 'query': query})

Шаг 2: Добавляем URL-маршрут

# urls.py

from django.urls import path
from .views import search_books

urlpatterns = [
    path('search/', search_books, name='search_books'),
]

Шаг 3: Создаем простой шаблон

<!-- templates/search_results.html -->

<form method="get" action="{% url 'search_books' %}">
    <input type="text" name="q" placeholder="Искать...">
    <button type="submit">Поиск</button>
</form>

<h2>Результаты поиска для "{{ query }}"</h2>

<ul>
    {% for book in books %}
        <li>{{ book.title }} — {{ book.author }}</li>
    {% empty %}
        <p>Ничего не найдено</p>
    {% endfor %}
</ul>

Теперь наша библиотека может искать книги по названию с использованием filter()!