Жизненный цикл поддержки mssql-python

Драйвер mssql-python является официальным драйвером Python от Microsoft для SQL Server, База данных SQL Azure, Управляемый экземпляр SQL Azure и SQL Database Microsoft Fabric. Драйвер активно поддерживается на GitHub и выпускается через PyPI. В этой статье рассматриваются вопросы версионирования, совместимости платформ и сроков поддержки.

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

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

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

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

Журнал версий

Версия Дата выпуска Status Ключевые особенности
1.12.0 Июль 2026 г. Текущая версия Автономный mssql-python-odbc пакет-компаньон, исправление тайм-аута подключения при массовом копировании, исправление CLR UDT при массовом копировании
1.11.0 Июль 2026 г. Previous Фиксация/откат в менеджере контекста, исправление для Apple Silicon, исправление массового копирования service principal
1.10.0 Июнь 2026 г. Previous Массовое копирование с ActiveDirectoryServicePrincipal, исправления для Arrow VARCHAR
1.9.0 Июнь 2026 г. Previous Массовое копирование с объектами Row, улучшенная типизация параметров NULL
1.8.0 Май 2026 г. Previous Массовое копирование с помощью ActiveDirectoryMSI, индексация строк по строковому ключу
1.7.1 Май 2026 г. Previous Колёса RHEL 8, более широкие параллельные маршруты и исправления Unicode
1.6.0 Апрель 2026 г. Previous Очистка строки подключения на основе парсера, исправления параллелизма при подключении/отключении
1.5.0 Апрель 2026 г. Previous извлечение Arrow, sql_variant, собственный UUID
1.4.0 Февраль 2025 г. Previous Поддержка массового копирования (BCP)
1.3.0 Январь 2025 г. Previous Класс настроек, конфигурация модуля
1.2.0 Ноябрь 2024 г. Previous Методы обнаружения схем
1.1.0 Сентябрь 2024 г. Previous Пользовательские выходные преобразователи
1.0.0 Июль 2024 г. Previous Первый общедоступный релиз

Important

Только текущая версия (1.12.0) получила новые функции и исправления ошибок. Предыдущие версии остаются функциональными, но не получают обновлений. Обновитесь до последней версии для лучшего опыта.

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

Драйвер mssql-python требует Python 3.10 или новее. Если вы начинаете новый проект, ориентируйтесь на самый новый поддерживаемый релиз Python в матрице совместимости для самого длинного окна поддержки. Если вы ограничены старой версией Python (3.9 или раньше), используйте pyodbc.

версия Python Состояние поддержки
Python 3.14 Поддерживается
Python 3.13 Поддерживается
Python 3.12 Поддерживается
Python 3.11 Поддерживается
Python 3.10 Поддерживается (минимум)
Python 3.9 и более ранние версии Не поддерживаются

Important

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

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

Драйвер mssql-python использует протокол TDS и работает со всеми активно поддерживаемыми версиями SQL Server.

версия SQL Server Состояние поддержки
Все поддерживаемые версии Microsoft SQL Server полностью поддерживается.

Службы SQL Azure

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

Microsoft Fabric

Endpoint Состояние поддержки
База данных SQL в Fabric полностью поддерживается.
Хранилище данных Fabric Поддерживается
Конечная точка аналитики SQL (Lakehouse) Поддерживается
Конечная точка аналитики SQL (зеркальной базы данных) Поддерживается

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

Драйвер mssql-python использует DDBC (Direct Database Connectivity) и не требует установки драйвера Microsoft ODBC. Удаление внешней зависимости упрощает развертывание, особенно в контейнерах и CI/CD-конвейерах.

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

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

В следующих таблицах перечислены функции SQL Server и их статус поддержки в текущей версии (1.12.0) драйвера mssql-python. Если нужная функция не поддерживается (например, Always Encrypted или MARS), рассмотрите вариант использования pyodbc . Для получения информации о функциях, добавленных в более ранних версиях, см. раздел «Что нового в mssql-python».

Функции SQL Server

Функция Поддержка mssql-python
Зашифрованные подключения (TLS) Поддерживается
Всегда зашифровано Не поддерживаются
аутентификация Microsoft Entra Поддерживается
Несколько активных результирующих наборов (MARS) Не поддерживаются
Копирование больших объемов данных (BCP) Поддерживается
получение Apache Arrow Поддерживается
столбцы sql_variant Поддерживается
Собственный UUID Поддерживается
Устойчивость подключения Поддерживается
Маршрутизация только для чтения Поддерживается

Соответствие DB-API 2.0

Функция Support
Интерфейс модуля Compliant
Интерфейс соединения Compliant
Интерфейс курсора В основном соответствует требованиям
Типовые объекты Compliant
Исключения Compliant
callproc() Не реализовано

Замечание

Метод callproc() не реализован. Вызывайте хранимые процедуры, используя инструкции EXECUTE со стандартными методами запросов.

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

Драйвер mssql-python имеет минимальные зависимости:

Зависимость Purpose Версия
azure-identity Проверка подлинности идентификатора Microsoft Entra Требуется (>= 1.12.0)
mssql-python-odbc Пакет-компаньон, который отправляет бинарные коды драйверов ODBC Требуется (== 18.6.2) по состоянию на mssql-python 1.12.0

Команда pip install mssql-python автоматически устанавливает mssql-python-odbc пакет компаньона. Когда его нет, драйвер возвращается к ODBC-бинарным данным, встроенным в колесо mssql-python . Вам не нужно отдельно устанавливать драйвер Microsoft ODBC для SQL Server.

Переход с pyodbc

Драйвер mssql-python упрощает развертывание (не требуется драйвер ODBC) и обеспечивает встроенный пул соединений. Основные различия, которые нужно учитывать при миграции:

Соображение Примечания.
Стиль параметров PYODBC использует qmark позиционные параметры. mssql-python по умолчанию использует именованные параметры pyformat и также поддерживает qmark для совместимости.
Доступ к строкам Доступ к атрибутам поддерживается в обоих случаях.
Хранимые процедуры Используйте EXECUTE (нет callproc).
Пулинг соединений Встроенный пул в драйвере mssql-python.

См. Переход с pyodbc для получения подробных инструкций.

Миграция с pymssql

Драйвер pymssql больше не поддерживается активно. Драйвер mssql-python предлагает поддерживаемую альтернативу с похожим синтаксисом соединений, но современными функциями, такими как встроенный пул соединений и аутентификация Microsoft Entra.

Соображение Примечания.
Зависимость FreeTDS Необязательно. Драйвер mssql-python использует DDBC.
Параметры подключения Похожий стиль, но имена параметров разные.
Доступ к строкам Оба поддерживают словарные и атрибутные шаблоны доступа.
Хранимые процедуры Используйте EXECUTE (нет callproc).

См. раздел Migrate from pymssql для подробных рекомендаций.

Политика нарушения изменений

  • Основные версии (2.0, 3.0): Крупные изменения версий означают нарушения изменений в API.
  • Небольшие версии (1.4, 1.5): Включают новые функции и сохраняют обратную совместимость.
  • Версии патча (1.4.1, 1.4.2): Включайте только исправления ошибок.

Команда фиксирует срочные изменения в заметках релиза и предоставляет руководства по миграции.

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

Драйвер mssql-python часто выпускает небольшие версии. Регулярно проверяйте обновления, особенно перед развертыванием в продакшене.

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

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

import mssql_python
print(mssql_python.__version__)

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

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

pip install --upgrade mssql-python

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

  • Смотрите репозиторий GitHub.
  • Проверьте наличие новых релизов на PyPI.
  • Просмотрите журнал изменений для каждого релиза.

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

Проблемы с GitHub

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

Documentation

Community

  • Stack Overflow: Помечайте вопросы тегом mssql-python.
  • Обсуждения на GitHub: используйте для общих вопросов и обсуждений.

Связанные материалы

  • Last updated on