Ограничения¶

Новые классы CheckConstraint и UniqueConstraint позволяют добавлять пользовательские ограничения базы данных. Ограничения добавляются в модели с помощью опции Meta.constraints.

Минорные изменения¶

Серверный API базы данных¶

В этом разделе описаны изменения, которые могут потребоваться в сторонних базах данных.

• Сторонние базы данных должны реализовать поддержку ограничений проверки таблиц или установить для параметра DatabaseFeatures.supports_table_check_constraints значение False.

• Сторонние базы данных должны реализовывать поддержку игнорирования ограничений или ошибок уникальности при вставке или установке для DatabaseFeatures.supports_ignore_conflicts значения False.

• Сторонние базы данных должны реализовать интроспекцию для DurationField или установить для DatabaseFeatures.can_introspect_duration_field значение False.

• DatabaseFeatures.uses_savepoints теперь по умолчанию имеет значение True.

• Сторонние базы данных должны реализовать поддержку частичных индексов или установить для DatabaseFeatures.supports_partial_indexes значение False.

• DatabaseIntrospection.table_name_converter() и column_name_converter() удалены. Сторонним базам данных может потребоваться вместо этого реализовать DatabaseIntrospection.identifier_converter(). В этом случае имена ограничений, которые возвращает DatabaseIntrospection.get_constraints(), должны быть нормализованы с помощью identifier_converter().

• Генерация SQL для индексов перенесена из Index в SchemaEditor, и добавлены следующие SchemaEditor методы:

  • _create_primary_key_sql() и _delete_primary_key_sql()

  • _delete_index_sql() (для сопряжения с _create_index_sql())

  • _delete_unique_sql (для сопряжения с _create_unique_sql())

  • _delete_fk_sql() (для пары с _create_fk_sql())

  • _create_check_sql() и _delete_check_sql()

• Третий аргумент DatabaseWrapper.__init__(), allow_thread_sharing, удален.

Действия администратора больше не собираются из базовых классов ModelAdmin.¶

Например, в старых версиях Django:

from django.contrib import admin


class BaseAdmin(admin.ModelAdmin):
    actions = ["a"]


class SubAdmin(BaseAdmin):
    actions = ["b"]

SubAdmin будет иметь действия 'a' и 'b'.

Теперь действия следуют стандартному наследованию Python. Чтобы получить тот же результат, что и раньше:

class SubAdmin(BaseAdmin):
    actions = BaseAdmin.actions + ["b"]

django.contrib.gis¶

• Поддержка GDAL 1.9 и 1.10 прекращена.

TransactionTestCase сериализованная загрузка данных¶

Первоначальные миграции данных теперь загружаются в TransactionTestCase в конце теста, после очистки базы данных. В более старых версиях эти данные загружались в начале теста, но это мешает опции test --keepdb работать корректно (база данных была пуста в конце всего набора тестов). Это изменение не должно повлиять на ваши тесты, если вы не настроили внутренние компоненты TransactionTestCase.

sqlparse является обязательной зависимостью¶

Чтобы упростить некоторые части обработки базы данных Django, sqlparse 0.2.2+ теперь является обязательной зависимостью. Он автоматически устанавливается вместе с Django.

псевдонимы cached_property¶

В использовании как:

from django.utils.functional import cached_property


class A:
    @cached_property
    def base(self):
        return ...

    alias = base

псевдоним не кэшируется. Там, где проблема может быть обнаружена (Python 3.6 и более поздние версии), такое использование теперь вызывает ошибку «TypeError: невозможно назначить одно и то же кэшированное_свойство двум разным именам («базовый» и «псевдоним»).

Используйте это вместо этого:

import operator


class A:
    ...

    alias = property(operator.attrgetter("base"))

Разрешения для прокси-моделей¶

Разрешения для прокси-моделей теперь создаются с использованием типа контента прокси-модели, а не типа контента конкретной модели. Миграция обновит существующие разрешения при запуске migrate.

В администраторе изменение прозрачно для прокси-моделей, имеющих ту же метку app_label, что и их конкретная модель. Однако в более старых версиях пользователи с разрешениями на прокси-модель с отличной app_label от конкретной модели не могли получить доступ к модели в администраторе. Сейчас это исправлено, но вы можете проверить назначения разрешений для таких моделей прокси ([add|view|change|delete]_myproxy) перед обновлением, чтобы убедиться, что новый доступ подходит.

Наконец, строки разрешений модели прокси должны быть обновлены, чтобы использовать собственную app_label. Например, для app.MyProxyModel, наследуемого от other_app.ConcreteModel, обновите user.has_perm('other_app.add_myproxymodel') до user.has_perm('app.add_myproxymodel').

Объединение активов формы «Меди໶

Ресурсы формы «Медиа» теперь объединяются с использованием алгоритма топологической сортировки, поскольку старый алгоритм попарного слияния в некоторых случаях недостаточен. Файлы CSS и JavaScript, не содержащие своих зависимостей, теперь могут сортироваться неправильно (в то время как старый алгоритм по совпадению выдавал правильные результаты).

Проверьте все классы Media на наличие отсутствующих зависимостей. Например, виджеты, зависящие от django.jQuery, должны указывать js=['admin/js/jquery.init.js', ...] при объявлении медиа-ресурсов формы <assets-as-a-static-definition>`.

Разнообразный¶

• Чтобы улучшить читаемость, поле формы UUIDField теперь отображает значения через тире, например: 550e8400-e29b-41d4-a716-446655440000 вместо 550e8400e29b41d4a716446655440000.

• В SQLite PositiveIntegerField и PositiveSmallIntegerField теперь включают проверочное ограничение для предотвращения отрицательных значений в базе данных. Если у вас есть недопустимые данные и вы запустили миграцию, которая воссоздает таблицу, вы увидите сообщение «Ошибка ограничения CHECK».

• Для обеспечения совместимости с серверами WSGI тестовый клиент теперь устанавливает заголовок Content-Length в виде строки, а не целого числа.

• Возвращаемое значение django.utils.text.slugify() больше не помечается как безопасное для HTML.

• Символом усечения по умолчанию, используемым фильтрами шаблонов urlizetrunc, truncatechars, truncatechars_html, truncatewords и truncatewords_html, теперь является настоящий символ многоточия (…) вместо 3 точек. Возможно, вам придется адаптировать некоторые сравнения результатов тестов.

• Поддержка путей байтовых строк в загрузчике файловой системы шаблона удалена.

• django.utils.http.urlsafe_base64_encode() теперь возвращает строку вместо байтовой строки, а django.utils.http.urlsafe_base64_decode() больше не может передавать байтовую строку.

• Поддержка cx_Oracle < 6.0 удалена.

• Минимальная поддерживаемая версия mysqlclient увеличена с 1.3.7 до 1.3.13.

• Минимальная поддерживаемая версия SQLite увеличена с 3.7.15 до 3.8.3.

• В попытке предоставить больше семантических данных запроса NullBooleanSelect теперь отображает значения <option> значения unknown, true и false вместо 1, 2 и 3. В целях обратной совместимости старые значения по-прежнему принимаются как данные.

• Group.name max_length увеличено с 80 до 150 символов.

• Тесты, нарушающие ограничения базы данных с возможностью отсрочки, теперь выдают ошибку при запуске на SQLite 3.20+, как и на других бэкэндах, поддерживающих такие ограничения.

• Чтобы выявить ошибки использования, тесты Client и django.utils.http.urlencode() теперь вызывают TypeError, если None передается как значение для кодирования, поскольку None не может быть закодировано в данных GET и POST. Либо передайте пустую строку, либо опустите значение.

• Команда управления ping_google теперь по умолчанию использует https вместо http для URL-адреса карты сайта. Если ваш сайт использует http, используйте новую опцию ping_google --sitemap-use-http. Если вы используете функцию django.contrib.sitemaps.ping_google, установите для нового аргумента sitemap_uses_https значение False.

• runserver больше не поддерживает pyinotify (заменён на Watchman).

• Агрегатные функции Avg, StdDev и Variance теперь возвращают Decimal вместо float, если входные данные имеют Decimal.

• Тесты на SQLite не пройдут, если приложения без миграции связаны с приложениями с миграцией. Это было задокументировано с тех пор, как в Django 1.7 были добавлены миграции, но теперь оно работает более надежно. Вы увидите, что тесты завершаются неудачно с ошибками типа нет такой таблицы: <app_label>_<model>. Это наблюдалось в нескольких сторонних приложениях, модели которых находились в тестах без миграции. Для таких моделей необходимо добавить миграции.

• Предоставление целого числа в аргументе key cache.delete() или cache.get() теперь вызывает ValueError.

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

  Примечание

  Возможность обработки файлов .po, содержащих различные уравнения множественного числа для одного и того же языка, была добавлена ​​в Django 2.2.12.

Модель Meta.ordering больше не влияет на запросы GROUP BY.¶

Meta.ordering модели, влияющий на запросы GROUP BY (например, .annotate().values()), является распространенным источником путаницы. Такие запросы теперь выдают предупреждение об устаревании с советом добавить order_by() для сохранения текущего запроса. Meta.ordering будет игнорироваться в таких запросах, начиная с Django 3.1.

Разнообразный¶

• django.utils.timezone.FixedOffset устарел в пользу datetime.timezone.

• Недокументированный псевдоним QuerySetPaginator для django.core.paginator.Paginator устарел.

• Модель FloatRangeField и поля формы в django.contrib.postgres устарели в пользу нового имени DecimalRangeField, чтобы соответствовать базовому типу данных numrange, используемому в базе данных.

• Параметр FILE_CHARSET устарел. Начиная с Django 3.1, файлы, считываемые с диска, должны иметь кодировку UTF-8.

• django.contrib.staticfiles.storage.CachedStaticFilesStorage устарел из-за имеющихся у него неразрешимых проблем. Вместо этого используйте ManifestStaticFilesStorage или стороннее облачное хранилище.

• RemoteUserBackend.configure_user() теперь передается request в качестве первого позиционного аргумента, если он его принимает. Поддержка переопределений, которые ее не принимают, будет удалена в Django 3.1.

• Атрибуты SimpleTestCase.allow_database_queries, TransactionTestCase.multi_db и TestCase.multi_db устарели в пользу SimpleTestCase.databases, TransactionTestCase.databases и TestCase.databases. Эти новые атрибуты позволяют объявлять зависимости баз данных, чтобы предотвратить утечку состояния между неожиданными запросами к базам данных не по умолчанию. Предыдущее поведение allow_database_queries=True и multi_db=True может быть достигнуто путем установки databases='__all__'.