Python: Django ORM
2026-02-26 22:48 Diff
https://ru.hexlet.io/courses/python-django-orm/lessons/model/theory_unit

Модель — это воплощение понятия предметной области в коде приложения. В Django ORM каждая модель представлена классом в коде и таблицей в базе данных:

  1. Модель представляется классом только в языках с классами. Технически она может быть чем угодно в зависимости от языка.
  2. Поля модели описывают одноимённые столбцы таблицы и одновременно являются свойствами (properties) класса, что позволяет им следить, например, за присваиваемыми полям значениями. В других ORM и других языках столбцы могут быть описаны иначе.
  3. Связь "Модель-Таблица" — это особенность паттерна Active Record. В другом подходе, называемом Data Mapper, всё может быть по-другому.
  4. Поле USERNAME_FIELD представляет собой строку, описывающую имя поля в модели пользователя, которая используется в качестве уникального идентификатора. Обычно это какой-то логин, но это также может быть адрес электронной почты или любой другой уникальный идентификатор. Поле должно быть уникальным

Единственное, что нужно для работы модели — создать таблицу в базе данных. Для чего, в свою очередь, потребуется миграция. Django генерирует миграции по команде makemigrations и применяет по команде migrate:

Миграции создаются и сохраняются внутри каждого приложения, что позволяет поставлять миграции вместе с остальным кодом и использовать одни и те же приложения в разных проектах.

После того, как миграции были применены, модель можно использовать: создавать сущности, сохранять их в базу и обновлять:

Из примера выше видно, что при создании или обновлении сущности, используется метод save(), а Django ORM сама распознает что происходит: создание или обновление.

Сущности можно также создавать и с помощью метода .create() у специальной сущности — менеджера. Дело в том, что за каждой моделью закреплён хотя бы один менеджер, получить доступ к которому можно через атрибут .objects. Менеджер отвечает за операции, относящиеся не к одной конкретной сущности, а к самой таблице. Метод .create() воздействует на таблицу, создавая в ней новую запись:

После того как сущность сохранена в базу, её можно извлечь. Самый простой способ сделать это - воспользоваться методом .get() менеджера. Он выполняет поиск по первичному ключу.