Как получить данные из базы данных в Django: полное руководство

14.09.2025
22461

8 мин
131

Обзор ORM Django и его преимущества

Django ORM (Object-Relational Mapper) — это мощный инструмент, позволяющий взаимодействовать с базами данных, используя Python-код вместо SQL. Основные преимущества ORM:

Абстракция от SQL: Разработчики могут писать код на Python, а ORM автоматически преобразует его в SQL-запросы, специфичные для используемой базы данных.
Безопасность: ORM помогает предотвратить SQL-инъекции, автоматически экранируя данные.
Переносимость: Легко переключаться между различными базами данных (PostgreSQL, MySQL, SQLite и др.), изменив настройки Django.
Удобство: ORM предоставляет удобные методы для выполнения CRUD-операций (Create, Read, Update, Delete).

Настройка базы данных для вашего проекта Django

Установите необходимые пакеты для вашей базы данных (например, psycopg2 для PostgreSQL).

Настройте параметры подключения к базе данных в файле settings.py:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'your_database_name',
        'USER': 'your_username',
        'PASSWORD': 'your_password',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

Выполните миграции, чтобы создать таблицы в базе данных на основе ваших моделей Django:
```
python manage.py migrate
```

Определение моделей Django и их связь с таблицами базы данных

Модели Django определяют структуру таблиц в базе данных. Каждая модель – это класс, наследуемый от django.db.models.Model. Атрибуты модели соответствуют столбцам таблицы.

Пример модели:

from django.db import models

class AdCampaign(models.Model):
    name: models.CharField = models.CharField(max_length=200)
    start_date: models.DateField = models.DateField()
    end_date: models.DateField = models.DateField()
    budget: models.DecimalField = models.DecimalField(max_digits=10, decimal_places=2)

    def __str__(self) -> str:
        return self.name

Основные способы получения данных в Django

Использование менеджера объектов (objects.all(), objects.get())

Менеджер объектов (objects) предоставляет методы для выполнения запросов к базе данных.

objects.all(): Возвращает все записи из таблицы.

all_campaigns: models.QuerySet[AdCampaign] = AdCampaign.objects.all()
for campaign in all_campaigns:
    print(campaign.name)

objects.get(): Возвращает одну запись, соответствующую заданным критериям. Если записей несколько или ни одной, вызывает исключение.
```
try:
    campaign: AdCampaign = AdCampaign.objects.get(pk=1)  # pk - primary key
    print(campaign.name)
except AdCampaign.DoesNotExist:
    print("Campaign not found")
```

Фильтрация данных с помощью objects.filter() и objects.exclude()

objects.filter(): Возвращает записи, соответствующие заданным критериям.

# Выбираем кампании с бюджетом больше 1000
expensive_campaigns: models.QuerySet[AdCampaign] = AdCampaign.objects.filter(budget__gt=1000)
for campaign in expensive_campaigns:
    print(campaign.name, campaign.budget)

objects.exclude(): Возвращает записи, не соответствующие заданным критериям.

# Выбираем кампании, у которых название не 'Test Campaign'
non_test_campaigns: models.QuerySet[AdCampaign] = AdCampaign.objects.exclude(name='Test Campaign')
for campaign in non_test_campaigns:
    print(campaign.name)

Поиск данных с помощью objects.get(), обработка исключений DoesNotExist

При использовании objects.get() важно обрабатывать исключение DoesNotExist, которое возникает, если запись не найдена.

try:
    campaign: AdCampaign = AdCampaign.objects.get(name="Nonexistent Campaign")
    print(campaign.start_date)
except AdCampaign.DoesNotExist:
    print("Campaign with this name does not exist.")

Получение определенных полей с помощью values() и values_list()

values(): Возвращает QuerySet, состоящий из словарей, где ключи — имена полей.

campaign_names_and_budgets: models.QuerySet[dict] = AdCampaign.objects.values('name', 'budget')
for item in campaign_names_and_budgets:
    print(item['name'], item['budget'])

values_list(): Возвращает QuerySet, состоящий из кортежей, содержащих значения указанных полей. Может принимать аргумент flat=True для получения списка значений, если указано только одно поле.
```
campaign_names: models.QuerySet[str] = AdCampaign.objects.values_list('name', flat=True)
for name in campaign_names:
    print(name)
```

Продвинутые методы запросов в Django

Использование Q-объектов для сложных запросов

Q-объекты позволяют строить сложные запросы с использованием логических операторов (& — AND, | — OR, ~ — NOT).

from django.db.models import Q

# Выбираем кампании, начавшиеся после 2023-01-01 ИЛИ имеющие бюджет больше 5000
complex_campaigns: models.QuerySet[AdCampaign] = AdCampaign.objects.filter(
    Q(start_date__gt='2023-01-01') | Q(budget__gt=5000)
)
for campaign in complex_campaigns:
    print(campaign.name, campaign.start_date, campaign.budget)

Агрегация данных: Count, Sum, Avg, Max, Min

Django предоставляет функции агрегации для вычисления статистических данных.

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

# Общее количество кампаний
total_campaigns: int = AdCampaign.objects.count()
print(f"Total campaigns: {total_campaigns}")

# Суммарный бюджет всех кампаний
total_budget: float = AdCampaign.objects.aggregate(Sum('budget'))['budget__sum']
print(f"Total budget: {total_budget}")

# Средний бюджет кампании
average_budget: float = AdCampaign.objects.aggregate(Avg('budget'))['budget__avg']
print(f"Average budget: {average_budget}")

# Максимальный бюджет
max_budget: float = AdCampaign.objects.aggregate(Max('budget'))['budget__max']
print(f"Max budget: {max_budget}")

Запросы, охватывающие отношения между моделями (ForeignKey, ManyToManyField)

Предположим, есть модель Keyword, связанная с AdCampaign через ForeignKey:

class Keyword(models.Model):
    name: models.CharField = models.CharField(max_length=100)
    campaign: models.ForeignKey = models.ForeignKey(AdCampaign, on_delete=models.CASCADE)

    def __str__(self) -> str:
        return self.name

Получение ключевых слов для конкретной кампании:

campaign: AdCampaign = AdCampaign.objects.get(pk=1)
keywords: models.QuerySet[Keyword] = campaign.keyword_set.all() #Django automatically creates reverse relation
for keyword in keywords:
    print(keyword.name)

Raw SQL запросы: когда и как их использовать

Иногда требуется выполнить сложные запросы, которые сложно выразить с помощью ORM. В таких случаях можно использовать raw SQL.

from django.db import connection

with connection.cursor() as cursor:
    cursor.execute("SELECT * FROM your_app_adcampaign WHERE budget > %s", [1000])
    results = cursor.fetchall()

for row in results:
    print(row)

Важно: Используйте raw SQL с осторожностью, чтобы избежать SQL-инъекций. Всегда экранируйте данные, передаваемые в запрос.

Оптимизация запросов к базе данных в Django

Использование selectrelated() и prefetchrelated() для уменьшения количества запросов

select_related(): Используется для оптимизации запросов с ForeignKey и OneToOneField. Позволяет получить связанные объекты одним запросом.
prefetch_related(): Используется для оптимизации запросов с ManyToManyField и ForeignKey (обратные связи). Позволяет получить связанные объекты несколькими запросами, но уменьшает общее количество запросов.

Пример:

#Без оптимизации (N+1 проблема)
campaigns: models.QuerySet[AdCampaign] = AdCampaign.objects.all()
for campaign in campaigns:
    keywords = campaign.keyword_set.all() # Each iteration makes new query

#С оптимизацией
campaigns: models.QuerySet[AdCampaign] = AdCampaign.objects.prefetch_related('keyword_set').all()
for campaign in campaigns:
    keywords = campaign.keyword_set.all() # Uses pre-fetched data

Индексы базы данных: как их использовать для ускорения запросов

Индексы позволяют ускорить поиск данных по определенным полям. Создайте индексы для полей, которые часто используются в фильтрах и сортировках. Добавьте db_index=True в определение поля в модели Django или используйте миграции.

class AdCampaign(models.Model):
    name: models.CharField = models.CharField(max_length=200, db_index=True)
    ...

Отложенная загрузка (defer() и only())

defer(): Исключает загрузку указанных полей из базы данных. Используется, когда эти поля не нужны для текущей операции.
only(): Загружает только указанные поля из базы данных. Используется, когда нужны только несколько полей.

#Загружаем все поля, кроме description
campaigns: models.QuerySet[AdCampaign] = AdCampaign.objects.defer('description').all()

#Загружаем только поля name и budget
campaigns: models.QuerySet[AdCampaign] = AdCampaign.objects.only('name', 'budget').all()

Кэширование результатов запросов

Кэширование позволяет сохранить результаты запросов в кэше, чтобы избежать повторных обращений к базе данных. Django предоставляет различные уровни кэширования (например, memcached, Redis).

from django.core.cache import cache

# Пытаемся получить данные из кэша
campaigns: list[AdCampaign] | None = cache.get('all_campaigns')

if campaigns is None:
    # Если в кэше нет данных, получаем их из базы данных
    campaigns = list(AdCampaign.objects.all())
    # Сохраняем данные в кэше на 60 секунд
    cache.set('all_campaigns', campaigns, 60)

for campaign in campaigns:
    print(campaign.name)

Примеры и лучшие практики

Реальные примеры запросов для типичных задач

Получить все кампании, запущенные в определенный период:

start_date: str = '2023-01-01'
end_date: str = '2023-03-31'
campaigns: models.QuerySet[AdCampaign] = AdCampaign.objects.filter(start_date__gte=start_date, end_date__lte=end_date)

Получить кампании с максимальным бюджетом:

max_budget: float = AdCampaign.objects.aggregate(Max('budget'))['budget__max']
campaigns: models.QuerySet[AdCampaign] = AdCampaign.objects.filter(budget=max_budget)

Получить кампании, содержащие определенное ключевое слово (регистронезависимый поиск):
```
keyword: str = 'sale'
campaigns: models.QuerySet[AdCampaign] = AdCampaign.objects.filter(name__icontains=keyword)
```

Обработка ошибок и исключений при работе с базой данных

При работе с базой данных необходимо обрабатывать возможные ошибки и исключения:

DoesNotExist: Возникает при использовании objects.get(), если запись не найдена.
MultipleObjectsReturned: Возникает при использовании objects.get(), если найдено несколько записей, соответствующих критериям.
IntegrityError: Возникает при нарушении ограничений целостности базы данных (например, при попытке добавить запись с неуникальным значением).

Советы по написанию эффективного и читаемого кода для работы с базой данных

Используйте осмысленные имена для моделей и полей.
Добавляйте комментарии для объяснения сложных запросов.
Используйте select_related() и prefetch_related() для оптимизации запросов.
Избегайте циклов при работе с большим количеством данных. По возможности, используйте bulk operations (например, bulk_create()).
Разделяйте логику получения данных и логику представления данных (например, используйте сервисные слои).

Добавить комментарий

Можно ли взломать плагин WordPress и как это происходит?

WordPress управляет более чем 40% всех сайтов в интернете, и его функциональность во многом зависит от обширной экосистемы плагинов.

2
2026

WordPress: Как безопасно добавить код в шапку, подвал и через плагины

Каждый владелец сайта на WordPress рано или поздно сталкивается с необходимостью добавить пользовательский код.

2
2026

Как работают темы в WordPress: полное руководство по механизму функционирования

Темы WordPress — это не просто визуальное оформление сайта; они являются фундаментальным элементом, который определяет не только его внешний вид, но и значительную часть функциональности и пользовательского опыта.

2
2026