Django ORM

ORM (англ. Object-Relational Mapping, рус. объектно-реляционное отображение, или преобразование) — технология программирования, которая связывает базы данных с концепциями объектно-ориентированных языков программирования, создавая «виртуальную объектную базу данных». Существуют как проприетарные, так и свободные реализации этой технологии.

Настройка базы данных

Запуск DB

В ходе обучения мы уже начали работать с базой Postgresql, для запуска базы мы будем испльзовать Docker.

# Стартуем базу
mkdir pgdata # директория которая будет хранить данные базы даже если контейнер будет удален
docker run -p 5432:5432 -e POSTGRES_PASSWORD=some_password -v ${PWD}/pgdata:/var/lib/postgresql/data postgres

Конфигурация

Соединение с базой настраивается в файле settings.py. Для настройки надо поменять переменную DATABASES.

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'mydatabase',
        'USER': 'mydatabaseuser',
        'PASSWORD': 'mypassword',
        'HOST': '127.0.0.1',
        'PORT': '5432',
    }
}

Как можно заметить соединений с базами может быть несколько

Модели

Django ORM позволяет нам описывать структуру базы данных с помощью классов.

Описывая модели - мы описываем таблицы в нашей DB.
Описывая поля моделей - мы описываем колонки и их типы в таблицах.

Основной модуль, который вы будете использовать при работе с базой это django.db. Для описания модели вам понадобится использовать класс django.db.Model и поля из django.db.fields.

from django.db.models import Model
from django.db.models.fields import TextField, CharField, AutoField


class Post(Model):
    id = AutoField()
    title = CharField()
    description = TextField()

Поля моделей

Классы полей в Django соответствуют некоторым типам в СУБД.

Django filed type	Postgres type	Для чего
`AutoField`	`SERIAL`	Поле для хранения айдишников. Базовая модель уже имее одно такое поле `id`
`BooleanFiled`	`BOOLEAN`
`CharField`	`VARCHAR(255)`	Текстовое поле n-длины (n - максимум)
`DateField`	`DATE`	Поле хранящее дату
`TimeField`	`TIME`	Поле хранящее время
`DateTimeField`	`TIMESTAMP`	Поле хранящее дату и время
`DurationField`	`INTERVAL`	Поле хранящее промежуток времени
`DecimalField`	`DECIMAL`	Числа в определенной точностью
`FloatField`	`REAL`	Числа с плавающей точкой
`TextField`	`TEXT`	Текстовое поле неограниченной длины

Выше я описал стандартные типы полей, но Django предоставляет и дополнительные типы, это уже известные вам типы но с некоторыми настройками. Например:

Django filed type	Для чего
`SlugFiled`	Это `CharField` с подключенным валидатором и включеным индексом по этому полю
`EmailField`	Это `CharField` с подключенным валидатором
`FileFiled`	Это `CharField` с особенными методами

Справка по полямhttps://docs.djangoproject.com/en/3.0/ref/models/fields/#autofield

Миграции

В примере выше мы описали модель(таблицу) но база сама не изменится в соответствии с этой моделью, нам надо сгенерировать миграцию.

Миграция - код описывающий изменения в базе данных, после изменения модели нам, зачастую, требуется привести базу к состоянию описанному в моделе, для этого генерируется миграция.

# Генерация миграций
python3 ./manage.py createmigrations

При вызове этой комманды произойдет проверка соответствия базы и кода, если требудется - будут сгенерированны миграции.

Чтобы применить миграцию надо набрать:

# Применение миграций
python3 ./manage.py migrate

ModelManager

Это особый класс, предоставляющий методы для работы с базой данных и

Связи моделей

Между сущностями в нашем приложении могут существовать связи, давайте сразу пример:

У нас приложение с фильмами, у фильмов есть комментарии и жанры. Какие связи между этими сущьностями?

OneToMany - У одного фильма может быть множество комментариев, такая связь со стороны фильма называется "Один ко многим"
ManyToOne - Комментарии принадлежат определенному фильму, их может быть множесто, такая связь будет называться "Многие к одному"
ManyToMany - У фильма может быть несколько жанров и у жанров множество фильмов принадлежащих к ним. Эта связь называется "Многие ко многим"
OneToOne - Здесь чуть сложнее, представим, что пользователи на нашем сайте разделены на профили и аккаунты, у одного аккаунта может быть тлько один профиль. Такая связь называется "Один к одному"