Django Models: типы полей и их параметры в моделях
Разбираем типы полей моделей в Django, назначение и особенности использования. Рассмотрим параметры: null, blank, default, choices, unique и другие.
Прежде мы рассмотрели что такое модели в Django, в этой статье рассмотрим какие поля с параметрами в них можно использовать.
CharField используется для хранения строк ограниченной длины. Он подходит для таких данных, как название статьи, имя пользователя, заголовок страницы или название категории. При объявлении этого поля необходимо указать параметр max_length, определяющий максимальную длину строки.
title = models.CharField(max_length=200)Пример Charfield в Django Models
В этом примере поле title предназначено для хранения строки длиной не более 200 символов.
Параметр max_length позволяет задать ограничение, соответствующее требованиям приложения.
Для хранения больших текстовых значений в Django используется TextField. Оно подходит для описаний, содержимого статей, комментариев и других текстов, длина которых заранее неизвестна.
content = models.TextField()пример в Django Models поле TextField
В отличие от CharField, для TextField обычно не указывают max_length, поскольку это поле предназначено для текста произвольной длины.
При этом фактические ограничения на объём хранимого текста могут зависеть от используемой базы данных.
IntegerField предназначен для хранения целых чисел.
Его можно использовать для количества товаров, числа просмотров, возраста или других значений, которые не требуют дробной части.
views = models.IntegerField(default=0)пример в Django Models поле IntegerField
В данном примере поле views хранит количество просмотров, а параметр default=0 задаёт значение по умолчанию.
Если при создании объекта значение поля не указано, Django использует ноль.
У IntegerField имеется аналог PositiveIntegerField (от 0 до 2147483647) , предназначенный для хранения положительных целых чисел и нуля, то есть не допускает отрицательные значения.
Также Django предоставляет PositiveSmallIntegerField (от 0 до 32767 ) и PositiveBigIntegerField (от 0 до 9223372036854775807), отличающиеся диапазоном допустимых значений.
FloatField используется для хранения чисел с плавающей точкой. Оно подходит для значений, которым не требуется фиксированное количество знаков после десятичного разделителя, например веса, температуры, расстояния и других измеряемых величин.
temperature = models.FloatField()пример в Django Models поле FloatField
Для финансовых операций лучше подходит DecimalField, о котором речь идет ниже.
DecimalField используется для хранения десятичных чисел с фиксированной точностью.
Это особенно важно при работе с денежными суммами, ценами и другими значениями, для которых нежелательны погрешности двоичного представления чисел с плавающей точкой.
В приведённом ниже примере можно хранить значения с двумя знаками после десятичного разделителя, а общее количество цифр не должно превышать десяти.
price = models.DecimalField(
max_digits=10,
decimal_places=2,
)пример в Django Models поле DecimalField
Параметр max_digits задаёт максимальное общее количество цифр, включая цифры до и после десятичного разделителя.
Параметр decimal_places определяет количество цифр после него.
Для денежных значений обычно предпочтительнее использовать DecimalField, а не FloatField, поскольку он обеспечивает десятичную точность, необходимую для финансовых расчётов.
Для хранения логических значений применяется BooleanField.
Такое поле может представлять состояние, которое имеет два варианта интерпретации: включено или выключено, опубликовано или нет, активно или неактивно.
is_published = models.BooleanField(default=False)пример в Django Models поле BooleanField
Здесь поле is_published определяет, опубликована ли статья.
По умолчанию значение равно False, то есть статья считается неопубликованной.
Подобные поля часто используются для управления состоянием объектов и реализации простых условий в приложении.
Для работы с датами и временем Django предоставляет два распространённых типа полей: DateField и DateTimeField.
DateField используется для хранения даты без указания времени.
Например, его можно применять для даты рождения, даты начала действия договора или даты публикации, если время не имеет значения.
created_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)пример в Django Models поле DateTimeField
TimeField используется для хранения только времени.
Например, его использование уместно для начала времени занятий, в случаях когда время требуется хранить независимо от даты.
start_time = models.TimeField(default="09:00")пример в Django Models поле TimeField
DateTimeField предназначен для хранения даты вместе со временем.
Он подходит для фиксации момента создания записи, последнего изменения объекта или времени выполнения определённого действия.
created_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)пример в Django Models поле DateTimeField
В этом примере created_at автоматически получает дату и время при первоначальном создании объекта, а updated_at обновляется при каждом сохрании объекта через обычный вызов save().
Эти параметры удобны для отслеживания жизненного цикла записей без необходимости вручную указывать временные значения.
EmailField предназначен для хранения адресов электронной почты.
По своей сути это специализированное строковое поле, которое предоставляет встроенную проверку формата email при помощи стандартной валидации в Django.
email = models.EmailField()пример в Django Models поле EmailField
Такое поле подходит для хранения контактных адресов пользователей, авторов публикаций или клиентов. При необходимости можно дополнительно указать max_length, blank, null и другие параметры, доступные для соответствующего поля.
Важно учитывать, что EmailField не проверяет фактического существование почтового ящика и не подтверждает принадлежность адреса конкретному человеку.
Поле проверяет только соответствие значения ожидаемому формату при выполнении валидации.
UUIDField используется для хранения уникальных идентификаторов UUID (Universally Unique Identifier).
В отличие от обычного автоинкрементного id, UUID не зависит от последовательности записей и может генерироваться независимо от базы данных.
id = models.UUIDField(
primary_key=True,
default=uuid.uuid4,
editable=False,
)пример в Django Models поле UUIDField
Параметр default=uuid.uuid4 задаёт создание нового UUID (пример: 6827b7ca-b545-4632-a1e7-a9f0eabe9daa) при создании объекта.
Важно передавать функцию uuid.uuid4, без указания скобок (), ведь вызов будет происходить отдельно для каждой записи.
primary_key=True делает UUID первичным ключом модели вместо автоматически создаваемого поля id, а editable=False исключает его из автоматически создаваемых полей в формах админ панели (Django Admin ) и ModelForm.
UUID удобно использовать, когда идентификаторы должны быть абсолютно уникальными, в том числе вне своей таблицы, например при обмене данными между несколькими системами.
JSONField используется для хранения структурированных данных в формате JSON.
В поле можно сохранять словари, списки, строки, числа, логические значения и None.
Такое поле удобно использовать, когда данные меняют структуру, так как нет необходимости пересоздавать поля и делать миграции.
metadata = models.JSONField(default=dict, blank=True)пример в Django Models поле JSONField
Важно передавать dict без скобок, чтобы Django создавал новый словарь каждый раз, а не использовал один общий изменяемый объект.
Параметр default=dict задаёт пустой словарь в качестве значения по умолчанию.
JSONField поддерживается разными СУБД, но возможности работы с JSON и особенности хранения зависят от используемой базы данных.
SlugField используется для хранения идентификаторов ссылок (URL), то есть коротких текстовых значений, которые обычно формируются из заголовка статьи или названия объекта.
Slug делает URL более читаемыми и удобными для пользователей и поисковых систем.
slug = models.SlugField(
max_length=200,
unique=True,
)пример в Django Models поле SlugField
Параметр max_length задаёт максимальную длину значения.
unique=True ставит ограничение и гарантирует, что у разных записей не будет одинаковых slug, что особенно важно, если по этому полю выполняется поиск объекта.
По умолчанию SlugField допускает только ASCII-буквы, цифры, дефисы и символы подчёркивания.
Чтобы разрешить Unicode-символы, например кириллицу, можно указать allow_unicode=True.
URLField используется для хранения URL-адресов, например ссылок на сайты, внешние ресурсы или страницы социальных сетей.
website = models.URLField(
max_length=200,
blank=True,
)пример в Django Models поле URLField
Параметр max_length задаёт максимальную длину URL-адреса, по умолчанию 200 знаков.
blank=True позволяет оставить поле пустым при заполнении форм и прохождении валидации.
URLField является подклассом CharField, поэтому хранит URL как строку.
Для работы с загружаемыми файлами Django предоставляет FileField.
Поле позволяет хранить информацию о файле и управлять его расположением в файловом хранилище приложения.
document = models.FileField(upload_to="documents/")пример в Django Models поле FileField
Параметр upload_to задаёт путь к папке, в которой будут загружаться файлы.
В базе данных обычно сохраняется путь файла текстом, а не содержимое файла.
Сам файл размещается в хранилище указанном в настройках, по умолчанию это файловая система машины.
Для изображений используется ImageField.
Поле работает по аналогичному принципу, но дополнительно поддерживает проверку того, что загруженный файл является изображением.
Для использования этого поля необходимо установить библиотеку Pillow.
image = models.ImageField(upload_to="images/")пример в Django Models поле ImageField
ImageField часто применяется для фотографий пользователей, изображений товаров и иллюстраций к публикациям.
При работе с загружаемыми файлами важно учитывать ограничения размера, допустимые форматы и требования к безопасности.
Помимо типа данных, каждое поле модели может иметь дополнительные параметры, позволяющие управлять его поведением.
Такие параметры задаются при объявлении поля и помогают определить, какие значения допустимы, что происходит при отсутствии значения и как поле используется в формах.
Рассмотрим некоторые из них в списке ниже:
null=Trueпозволяет хранитьNULLв базе данныхblank=Trueразрешает оставлять поле пустым при валидацииchoicesзадаёт список допустимых значений для поляTextChoicesиIntegerChoicesпозволяют определять варианты выбора с помощью перечислений
db_columnзадаёт собственное имя столбца в базе данныхdb_commentдобавляет комментарий к столбцу в базе данныхdb_defaultзадаёт значение по умолчанию на уровне базы данныхdb_index=Trueпозволяет создать индекс для ускорения определённых запросовdb_tablespaceзадаёт табличное пространство для индекса поля, если СУБД поддерживает эту возможностьdefaultзадаёт значение по умолчанию для поля при создании объектаeditable=Falseисключает поле из форм и административной панели Djangoerror_messagesпозволяет переопределить стандартные сообщения об ошибках валидацииhelp_textдобавляет поясняющий текст для поля в формах и административной панелиprimary_key=Trueделает поле первичным ключом моделиunique=Trueгарантирует уникальность значения поля в базе данныхunique_for_date/unique_for_month/unique_for_yearзапрещает повторение значения поля для одной и той же даты / месяца / годаverbose_nameзадаёт понятное название поля для отображения в формах и административной панелиvalidatorsпозволяет указать дополнительные функции проверки значения поля
В Django выбор типа поля модели (Field) зависит от характера хранимых данных, их формата, допустимых значений и операций, которые приложение будет выполнять с этими данными.
Правильно выбранный тип поля позволяет обеспечить целостность данных, упростить их обработку и эффективнее организовать хранение в базе данных.
Для удобства выбора вы можете опираться на следующую таблицу:
| Тип поля | Назначение | Пример использования | Особенности |
|---|---|---|---|
| CharField | Хранение коротких строк | Имя, название статьи, заголовок | Требует указания max_length, максимальной длины строки |
| TextField | Хранение длинного текста | Текст статьи, описание товара, комментарий | Подходит для текста произвольной длины; max_length не обязателен |
| IntegerField | Хранение целых чисел | Количество товаров, возраст, число просмотров | Подходит для положительных и отрицательных целых чисел |
| PositiveIntegerField | Хранение неотрицательных целых чисел | Количество участников, остаток товаров | Предназначен для значений от нуля и выше |
| FloatField | Хранение чисел с плавающей точкой | Температура, физические измерения | Возможны погрешности при представлении дробных чисел |
| DecimalField | Хранение десятичных чисел с заданной точностью | Цена товара, стоимость заказа | Позволяет задавать общее количество цифр и число знаков после запятой |
| BooleanField | Хранение логических значений | Опубликована ли статья, активен ли пользователь | Принимает True или False |
| DateField | Хранение даты | Дата рождения, дата публикации | Содержит дату без времени |
| TimeField | Хранение времени | Время начала мероприятия | Содержит время без даты |
| DateTimeField | Хранение даты и времени | Дата создания записи, время изменения | Подходит для фиксации момента создания или изменения объекта |
| EmailField | Хранение адреса электронной почты | Email пользователя | Выполняет проверку формата адреса при валидации |
| URLField | Хранение интернет-адреса | Ссылка на сайт, адрес источника | Предназначен для URL и проверяет его формат при валидации |
| SlugField | Хранение строк для URL | django-type-fields-url | Обычно используется для человекочитаемых адресов страниц |
| UUIDField | Хранение уникальных идентификаторов UUID | Идентификатор заказа или объекта | Удобен, когда требуется идентификатор, не основанный на последовательном числе |
| FileField | Хранение ссылки на загруженный файл | Документ, архив | В базе хранится путь к файлу, а сам файл обычно находится в файловом хранилище |
| ImageField | Хранение ссылки на изображение | Аватар, фотография товара | Работает с изображениями и требует Pillow |
Если у вас остались вопросы по полям в Django моделях, можете обратиться за консультацией к программисту.
По необходимости вы можете обратиться за консультацией
Вам может быть интересно
Переменные окружения и секретные ключи в Python
Django приложение в Docker: запускаем по шагам
Как получить данные из Wordstat от Яндекса по API на Python
Django CBV: готовые классы на примере Generic Base View
Что такое CMS простыми словами: обзор функционала
