Cykl życia wsparcia dla mssql-python

Sterownik mssql-python to oficjalny sterownik Python firmy Microsoft dla SQL Server, Azure SQL Database, Azure SQL Managed Instance oraz bazy danych SQL w Microsoft Fabric. Sterownik jest aktywnie utrzymywany na GitHub i udostępniany przez PyPI. Ten artykuł obejmuje wersjonowanie, kompatybilność platform oraz harmonogramy wsparcia.

Obsługa wersji

Zawsze korzystaj z najnowszej wersji, aby uzyskać nowe funkcje, poprawić wydajność i poprawić zabezpieczenia. Nowe możliwości są dodawane tylko do bieżącej wersji.

Bieżąca wersja

Wersja 1.11.0 to aktualna wersja ogólnodostępna (GA).

Historia wersji

Wersja Data wydania Status Kluczowe funkcje
1.11.0 Lipiec 2026 r. Aktualny Zatwierdzanie/wycofywanie dla menedżera kontekstu, poprawka dla Apple Silicon, poprawka zbiorczego kopiowania jednostki usługi
1.10.0 Czerwiec 2026 r. Wstecz Kopiowanie zbiorcze za pomocą ActiveDirectoryServicePrincipal, poprawki dotyczące typu VARCHAR w Arrow
1.9.0 Czerwiec 2026 r. Wstecz Kopiowanie masowe z obiektami wiersza, ulepszone typowanie parametrów NULL
1.8.0 Maj 2026 r. Wstecz Kopiowanie zbiorcze za pomocą ActiveDirectoryMSI, indeksowanie wierszy za pomocą klucza ciągowego
1.7.1 Maj 2026 r. Wstecz RHEL 8 kół, szersze współbieżności i poprawki Unicode
1.6.0 Kwiecień 2026 r. Wstecz Oparte na parserze oczyszczanie parametrów połączenia, poprawki współbieżności łączenia/rozłączania
1.5.0 Kwiecień 2026 r. Wstecz Arrow fetch, sql_variant, natywny identyfikator UUID
1.4.0 Luty 2025 rok Wstecz Obsługa kopiowania zbiorczego (BCP)
1.3.0 Stycznia 2025 Wstecz Klasa ustawień, konfiguracja modułu
1.2.0 Listopad 2024 Wstecz Metody odkrywania schematów
1.1.0 Wrzesień 2024 roku Wstecz Niestandardowe przetworniki wyjściowe
1.0.0 Lipiec 2024 r. Wstecz Pierwsze wydanie GA

Important

Tylko aktualna wersja (1.11.0) otrzymuje nowe funkcje i poprawki błędów. Poprzednie wersje nadal działają, ale nie otrzymują aktualizacji. Zaktualizuj do najnowszej wersji, aby uzyskać najlepsze doświadczenie.

zgodność wersji Python

Sterownik mssql-python wymaga Python 3.10 lub nowszy. Jeśli zaczynasz nowy projekt, celuj w najnowszą wspieraną wersję Python w macierzy kompatybilności, aby uzyskać najdłuższe okno wsparcia. Jeśli ogranicza Cię starsza wersja Python (3.9 lub wcześniejsza), użyj pyodbc.

wersja Python Status wsparcia
Python 3.14 Wsparte
Python 3.13 Wsparte
Python 3.12 Wsparte
Python 3.11 Wsparte
Python 3.10 Wspierane (minimum)
Python 3.9 i wcześniejsze Niewspierane

Important

Zawsze używaj obsługiwanej wersji Python. Starsze wersje Python nie otrzymują aktualizacji zabezpieczeń.

zgodność wersji SQL Server

Sterownik mssql-python korzysta z protokołu TDS i działa ze wszystkimi aktywnie wspieranymi wersjami SQL Server.

wersja SQL Server Status wsparcia
Wszystkie obsługiwane wersje Microsoft SQL Server W pełni wspierane

Usługi Azure SQL

Service Status wsparcia
Azure SQL Database W pełni wspierane
Azure SQL Managed Instance W pełni wspierane
Azure Synapse Analytics (dedykowane pule) Wsparte

Microsoft Fabric

Endpoint Status wsparcia
Baza danych SQL na platformie Fabric W pełni wspierane
Hurtownia danych Fabric Wsparte
Analityczny punkt końcowy SQL (Lakehouse) Wsparte
Punkt końcowy analizy SQL (dublowana baza danych) Wsparte

Zgodność systemu operacyjnego

Sterownik mssql-python korzysta z DDBC (Direct Database Connectivity) i nie wymaga instalacji sterownika Microsoft ODBC. Usunięcie zewnętrznej zależności upraszcza wdrażanie, zwłaszcza w kontenerach i potokach CI/CD.

System operacyjny Architecture Status wsparcia
Windows 11 x64, ARM64 Wsparte
Windows Server 2019, 2022, 2025 x64 Wsparte
Ubuntu 22.04, 24.04, 26.04 x64, ARM64 Wsparte
Debian 11, 12 x64, ARM64 Wsparte
Red Hat Enterprise Linux 8, 9 x64, ARM64 Wsparte
macOS 14, 15, 26 Intel, Apple Silicon (ARM64) Wsparte
Alpine Linux x64 Wsparte

Zgodność funkcji

Poniższe tabele przedstawiają funkcje SQL Server oraz ich status wsparcia w aktualnej wersji (1.11.0) sterownika mssql-python. Jeśli potrzebna funkcja nie jest obsługiwana (np. Always Encrypted lub MARS), rozważ użycie pyodbc zamiast tego. Informacje o funkcjach dodanych we wcześniejszych wersjach znajdziesz w artykule Co jest nowe w mssql-python.

Funkcje programu SQL Server

Funkcja Wsparcie mssql-python
Połączenia szyfrowane (TLS) Wsparte
Zawsze szyfrowane Niewspierane
Uwierzytelnianie usługi Microsoft Entra Wsparte
Wiele aktywnych zestawów wyników (MARS) Niewspierane
Kopiowanie zbiorcze (BCP) Wsparte
Pobieranie Apache Arrow Wsparte
sql_variant kolumny Wsparte
Natywny UUID Wsparte
Odporność połączenia Wsparte
Rutowanie tylko odczytu Wsparte

Zgodność z DB-API 2.0

Funkcja Support
Interfejs modułu Zgodne
Interfejs połączenia Zgodne
Interfejs kursora W większości zgodny z przepisami
Obiekty typu Zgodne
Wyjątki Zgodne
callproc() Nie zaimplementowano

Note

Metoda callproc() nie jest zaimplementowana. Wywołuj procedury przechowywane, używając EXECUTE instrukcji ze standardowymi metodami zapytań.

Wymagania dotyczące zależności

Sterownik mssql-python ma minimalne zależności:

Zależność Purpose Wersja
azure-identity Uwierzytelnianie za pomocą Microsoft Entra ID Wymagane (>= 1.12.0)

Sterownik mssql-python nie wymaga instalacji sterownika Microsoft ODBC.

Migracja z pyodbc

Sterownik mssql-python upraszcza wdrożenie (nie jest wymagany sterownik ODBC) i zapewnia wbudowaną pulę połączeń. Główne różnice, na które warto zaplanować podczas migracji:

Rozważenie Notatki
Styl parametrów pyodbc wykorzystuje qmark parametry pozycyjne. mssql-python domyślnie używa parametrów nazwanych pyformat i obsługuje również qmark w celu zachowania zgodności.
Dostęp do wierszy Dostęp do atrybutów jest obsługiwany w obu przypadkach.
Procedury przechowywane Użyj EXECUTE (nie callproc).
Buforowanie połączeń Wbudowana pula w sterowniku mssql-python.

Zobacz Migrate from pyodbc, aby uzyskać szczegółowe wskazówki.

Migracja z pymssql

Sterownik pymssql nie jest już aktywnie utrzymywany. Sterownik mssql-python oferuje wspieraną alternatywę z podobną składnią połączeń, ale z nowoczesnymi funkcjami, takimi jak wbudowana pula połączeń i uwierzytelnianie Microsoft Entra.

Rozważenie Notatki
Zależność FreeTDS Niewymagane. Sterownik mssql-python używa DDBC.
Parametry połączenia Podobny styl, ale inne nazwy parametrów.
Dostęp do wierszy Oba obsługują dostęp w stylu słownikowym oraz przez atrybuty.
Procedury przechowywane Użyj EXECUTE (nie callproc).

Szczegółowe wskazówki można znaleźć w Migrate from pymssql.

Polityka łamania zmian

  • Główne wersje (2.0, 3.0): Główne zmiany wersji oznaczają łamanie zmian API.
  • Wersje mniejsze (1.4, 1.5): Wprowadzają nowe funkcje i zachowują kompatybilność wsteczną.
  • Wersje poprawek (1.4.1, 1.4.2): Zawierają wyłącznie poprawki błędów.

Zespół dokumentuje najważniejsze zmiany w notatkach wydań i udostępnia przewodniki migracji.

Jak być na bieżąco

Sterownik mssql-python często wydaje drobne wersje. Regularnie sprawdzajcie aktualizacje na bieżąco, zwłaszcza przed wdrożeniami produkcyjnymi.

Sprawdzanie zainstalowanej wersji

Sprawdź, która wersja sterownika jest obecnie zainstalowana w Twoim środowisku:

import mssql_python
print(mssql_python.__version__)

Uaktualnianie do najnowszej wersji

Zaktualizuj do najnowszej wersji, aby uzyskać najnowsze funkcje i poprawki bezpieczeństwa.

pip install --upgrade mssql-python

Subskrybowanie aktualizacji

  • Obserwuj repozytorium GitHub.
  • Sprawdź PyPI pod kątem nowych wydań.
  • Przejrzyj dziennik zmian dla każdej wersji.

Uzyskiwanie wsparcia

Problemy z usługą GitHub

Zgłaszaj błędy i proś o nowe funkcje na GitHubie:

Documentation

Community

  • Stack Overflow: Oznacz pytania tagiem mssql-python.
  • Dyskusje na GitHub: Używaj do ogólnych pytań i dyskusji.

Treści powiązane

  • Last updated on