Поддержка и жизненный цикл mssql-django

Пакет mssql-django — это официальная серверная часть базы данных Django, поддерживаемая Microsoft для SQL Server, База данных SQL Azure, Управляемый экземпляр SQL Azure и базы данных SQL в Microsoft Fabric. Он активно поддерживается на GitHub и выпущен через PyPI. На этой странице рассматривается управление версиями, совместимость платформ и политика поддержки.

Поддержка версий

Всегда используйте последний выпуск для получения новых функций, улучшений производительности и исправлений безопасности. Новые возможности добавляются только в текущий выпуск.

Текущая версия

Версия 1.7.4 — это текущий общий выпуск (GA).

Определения состояния поддержки

Используйте эти значения состояния в таблице версий:

Статус Meaning
Текущая версия Получает новые функции, исправления ошибок и исправления безопасности.
Предыдущее Архивный релиз. Остается доступным, но не получает обновления.

История версий

Версия Дата выпуска Статус Версии Django Ключевые особенности
1.7.4 Июль 2026 г. Текущая версия 3.2 - 6.0 GROUP BY исправления для спрятанных %% литералав с реальными параметрами и для IntegerChoices параметров в сырых запросах
1.7.3 Июнь 2026 г. Previous 3.2 - 6.0 FA001 исправление для Authentication= режимов, отличных ActiveDirectoryMsiот подклассированных DatabaseWrapperKeyError исправлений (регрессия от 1.7.1)
1.7.2 Май 2026 г. Previous 3.2 - 6.0 Исправление часового пояса datetimeoffset, Now() исправление часового пояса, .explain() исправление совместимости
1.7.1 Апрель 2026 г. Previous 3.2 - 6.0 Исправление для базы данных SQL в Fabric, исправление нисходящего индекса AlterField
1.7 Март 2026 г. Previous 3.2 - 6.0 Поддержка Django 6.0, драйвер ODBC 18 по умолчанию, поддержка SQL Server 2025
1.6 Август 2025 г. Previous 3.2 - 5.2 Поддержка Django 5.1 и 5.2, улучшенная функциональность JSON
1.5 Апрель 2024 г. Previous 3.2 - 5.0 supports_comments флаг, AutoField исправления
1.4 Январь 2024 г. Previous 3.2 - 5.0 Поддержка Django 5.0, поддержка db_comment
1.3 Май 2023 г. Previous 3.2 - 4.2 Поддержка Django 4.2, с учетом регистра Replace
1.2 Декабрь 2022 г. Previous 3.2 - 4.1 Поддержка Django 4.1, поддержка часового пояса в JSONField Управляемый экземпляр SQL Azure
1.1 Июль 2022 г. Previous 3.2 - 4.0 Первоначальный выпуск с поддержкой Django 3.2 и 4.0

Версии до версии 1.1 были предварительно выпущены и не перечислены.

Important

Исправления и новые функции поставляются только в новых выпусках. Старые версии по-прежнему доступны на PyPI, но исправления в них задним числом не вносятся. Чтобы получить исправления ошибок или исправления системы безопасности, обновите его до последнего выпуска.

Подробные заметки о выпуске см. в статье "Новые возможности mssql-django".

Совместимость версий Django и Python

Каждый выпуск Django поддерживает определенные версии Python. При выборе версий убедитесь в совместимости Django, Python и mssql-django:

Версия Django Версии Python
6.0 3.12, 3.13, 3.14
5,2 3.10, 3.11, 3.12, 3.13
5.1 3.10, 3.11, 3.12, 3.13
5.0 3.10, 3.11, 3.12
4.2 3.8, 3.9, 3.10, 3.11, 3.12
4.1 3.8, 3.9, 3.10, 3.11
4.0 3.8, 3.9, 3.10
3.2 3.8, 3.9, 3.10

Important

Всегда используйте поддерживаемую версию Python. Старые версии Python не получают обновления системы безопасности.

совместимость версий SQL Server

Серверная mssql-django часть работает со всеми поддерживаемыми версиями SQL Server.

Службы SQL Azure

Service Состояние поддержки
База данных SQL Azure полностью поддерживается.
Управляемый экземпляр Azure SQL полностью поддерживается.

Microsoft Fabric

Конечная точка Состояние поддержки
База данных SQL в Fabric полностью поддерживается.

Совместимость драйверов ODBC

Серверная mssql-django часть требует внешнего драйвера ODBC, в отличие от mssql-python драйвера, использующего подключение к базе данных Direct (DDBC).

mssql-django Начиная с версии 1.7 серверная часть по умолчанию использует драйвер ODBC 18 для SQL Server и автоматически возвращается в ODBC Driver 17, если версия 18 не установлена. Это можно переопределить, указав driver параметр в конфигурации базы данных.

Драйвер ODBC Состояние поддержки
Microsoft драйвер ODBC 18 для SQL Server Полностью поддерживается (по умолчанию)
Microsoft ODBC Драйвер 17 для SQL Server Полная поддержка (резервный вариант)
Драйвер ODBC FreeTDS Поддерживается

Инструкции по установке см. в разделе "Скачать драйвер ODBC для SQL Server".

Совместимость операционной системы

mssql-django серверная часть работает везде, где поддерживаются Python и драйвер ODBC. Действия по установке драйвера ODBC зависят от операционной системы. Сведения об установке mssql-django для конкретной платформы см. в разделе "Установка mssql-django ".

Операционная система Architecture Состояние поддержки
Windows 11 x64, ARM64 Поддерживается
Windows Server 2019, 2022, 2025 x64 Поддерживается
Ubuntu 22.04, 24.04 x64, ARM64 Поддерживается
Debian 11, 12 x64, ARM64 Поддерживается
Red Hat Enterprise Linux 8, 9 x64, ARM64 Поддерживается
macOS 14, 15 Intel, Apple Silicon (ARM64) Поддерживается
Alpine Linux x64 Поддерживается (требуется слой совместимости glibc или FreeTDS)

Совместимость компонентов

В следующих таблицах перечислены функции Django и SQL Server и их состояние поддержки в серверной mssql-django части. Дополнительные сведения о неподдерживаемых функциях см. в разделе "Ограничения" и неподдерживаемые функции в mssql-django.

Функции Django ORM

Feature Поддержка mssql-django
Migrations Yes
QuerySet API-интерфейс Yes
JSONField Да (SQL Server 2016+)
bulk_create / bulk_update Yes
Транзакции базы данных Yes
inspectdb с --schema Yes
DISTINCT ON нет
__regex / __iregex Поиск Частично (требуется настройка сборки CLR; недоступна в База данных SQL Azure)
SmallAutoField Yes
select_for_update() Да (NOWAIT и SKIP_LOCKED; of не поддерживается)
Функции окна Yes
GeneratedField (вычисляемые столбцы) Да (Django 5.0 и более поздних версий)
CompositePrimaryKey Частично (Django 5.2 и более поздних версий; см. ограничения)
db_comment Да (Django 4.2 и более поздние версии)
Охватывающие индексы (include) Да (Django 4.2 и более поздние версии)
NthValue нет

Функции SQL Server

Feature Поддержка mssql-django
Зашифрованные подключения (TLS) Yes
Всегда зашифровано Yes
аутентификация Microsoft Entra Yes
Несколько активных результирующих наборов (MARS) Да (через pyodbc)
Хранимые процедуры Да (через cursor.execute)
SNAPSHOT изоляция Да (требуется конфигурация уровня базы данных)
Маршрутизация только для чтения Yes

Требования к зависимости

Пакет mssql-django автоматически устанавливает следующие зависимости:

Зависимость Purpose Требуемая версия
Django Веб-платформа >= 3,2
pyodbc Драйвер базы данных ODBC для Python >= 3.0
pytz Поддержка часовых поясов (используется серверной частью для преобразования datetime, независимо от USE_TZ) Any

Серверная mssql-django часть также требует установки драйвера ODBC Microsoft для SQL Server в хост-системе. Дополнительные сведения см. в разделе "Установка mssql-django".

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

  • Дополнительные версии (1.6, 1.7): включите поддержку новых версий Django, новые функции и исправления ошибок. Обеспечение обратной совместимости.
  • Версии патча (1.7.1, 1.7.2, 1.7.3, 1.7.4): Включайте только исправления ошибок.

Команда документирует критические изменения в заметках о выпуске. Сведения о новых возможностях mssql-django см. в заметках для конкретной версии.

Как оставаться в курсе

Серверная mssql-django часть выпускает новые версии для отслеживания выпусков Django. Проверьте наличие обновлений при обновлении Django.

Проверка установленной версии

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

pip show mssql-django

Обновление до последней версии

Обновите до последней версии:

pip install --upgrade mssql-django

Подписка на обновления

Получите поддержку

Microsoft оказывает поддержку через mssql-django, GitHub и каналы сообщества.

Проблемы с GitHub

Сообщите об ошибках и функциях запроса в GitHub:

Сообщая о проблеме, укажите версию Django, версию Python, версию SQL Server, версию драйвера ODBC и минимальный пример, воспроизводящий проблему.

Contribute

Приветствуются вклады сообщества. Дополнительные сведения о Соглашении о лицензировании вкладов участников (CLA) и процессе отправки материалов см. в руководстве по участию в проекте.

Сообщество

Связанный контент

  • Last updated on