Životní cyklus podpory pro mssql-python

Ovladač mssql-python je oficiální Python ovladač Microsoft pro SQL Server, Azure SQL Database, Azure SQL Managed Instance a SQL databázi v Microsoft Fabric. Ovladač je aktivně udržován na GitHub a zveřejňován přes PyPI. Tento článek se zabývá verzováním, kompatibilitou platforem a časovými harmonogramy podpory.

Podpora verzí

Vždy používejte nejnovější verzi k získání nových funkcí, zlepšení výkonu a bezpečnostních oprav. Nové funkce se přidají jenom do aktuální verze.

Aktuální verze

Verze 1.16.0 je aktuální vydání v obecné dostupnosti (GA).

Historie verzí

Verze Datum vydání Stav Klíčové funkce
1.16.0 Října 2026 Aktuální Python 3.15, conda balíčky, opt-in mssql-odbc nativní poskytovatel, row._mapping, vyžadovaný mssql-python-rs doprovodný balíček
1.15.0 Září 2026 Předchozí Nativní zpracování setinputsizes(), podpora memoryview v Binary(), modulové konstanty typů SQL Serveru, nativní jádro ARM64 v balíčcích wheel pro Windows ARM64
1.14.0 Srpen 2026 Předchozí Nativní kanál pro svazování parametrů, connect(timeout=) nastavuje časový limit ověřování, hromadné kopírování přijímá timeout=0, typy Arrow View při hromadném kopírování
1.13.0 Srpen 2026 Předchozí Hromadná kopie Apache Arrow, parametr token_provider, sdružování připojení s ohledem na identitu, požadovaný doprovodný balíček mssql-python-odbc
1.12.0 Červenec 2026 Předchozí Samostatný mssql-python-odbc doprovodný balíček, oprava časového limitu připojení při hromadném kopírování, oprava CLR UDT při hromadném kopírování
1.11.0 Červenec 2026 Předchozí Context manager commit/rollback, oprava Apple Silicon, oprava hromadného kopírování service principal
1.10.0 Červen 2026 Předchozí Hromadné kopírování pomocí ActiveDirectoryServicePrincipal, opravy typu VARCHAR v Arrow
1.9.0 Červen 2026 Předchozí Hromadná kopie pomocí řádkových objektů, vylepšené typování NULL parametrů
1.8.0 Květen 2026 Předchozí Hromadné kopírování pomocí ActiveDirectoryMSI, indexování řetězcových klíčů řádků
1.7.1 Květen 2026 Předchozí RHEL 8 kol, širší souběžnost a Unicode opravy
1.6.0 Duben 2026 Předchozí Sanitace připojovacího řetězce založená na parseru, opravy problémů se souběžným připojením/odpojením
1.5.0 Duben 2026 Předchozí Arrow fetch, sql_variant, UUID v nativním formátu
1.4.0 Únor 2026 Předchozí Podpora hromadných kopií (BCP)
1.3.0 Leden 2026 Předchozí Třída nastavení, konfigurace modulu
1.2.0 Leden 2026 Předchozí Metody objevování schémat
1.1.0 Prosinec 2025 Předchozí Vlastní výstupní měniče
1.0.0 listopad 2025 Předchozí První vydání GA

Important

Pouze aktuální verze (1.16.0) dostává nové funkce a opravy chyb. Předchozí verze zůstávají funkční, ale nedostávají aktualizace.

Kompatibilita verzí Python

Ovladač mssql-python vyžaduje Python 3.10 nebo starší. Pokud začínáte nový projekt, zaměřte se na nejnovější podporované vydání Python v matici kompatibility pro co nejdelší období podpory.

verze Pythonu Stav podpory
Python 3.15 Podporováno
Python 3.14 Podporováno
Python 3.13 Podporováno
Python 3.12 Podporováno
Python 3.11 Podporováno
Python 3.10 Podporováno (minimum)
Python 3.9 a starší verze Nepodporováno

Important

Vždy používejte podporovanou Python verzi. Starší Python verze nedostávají aktualizace zabezpečení.

Kompatibilita verzí SQL Server

Ovladač mssql-python používá protokol TDS a funguje se všemi aktivně podporovanými verzemi SQL Server.

verze SQL Server Stav podpory
Všechny podporované verze Microsoft SQL Server Plně podporovaná

Služby Azure SQL

Service Stav podpory
Azure SQL Database Plně podporovaná
Azure SQL Managed Instance Plně podporovaná
Azure Synapse Analytics (vyhrazené fondy) Podporováno

Microsoft Fabric

Endpoint Stav podpory
SQL databáze v prostředí Fabric Plně podporovaná
Datový sklad Fabrique Podporováno
Analytický koncový bod SQL (Lakehouse) Podporováno
SQL analytics endpoint (zrcadlená databáze) Podporováno

Kompatibilita operačního systému

Ovladač mssql-python používá DDBC (Direct Database Connectivity) a nevyžaduje instalaci ovladače Microsoft ODBC. Odstranění externí závislosti zjednodušuje nasazení, zejména v kontejnerech a CI/CD pipeline.

Operační systém Architecture Stav podpory
Windows 11 x64, ARM64 Podporováno
Windows Server 2019, 2022, 2025 x64 Podporováno
Ubuntu 22.04, 24.04, 26.04 x64, ARM64 Podporováno
Debian 11, 12, 13 x64, ARM64 Podporováno
Red Hat Enterprise Linux 8, 9 x64, ARM64 Podporováno
macOS 15 a novější Intel, Apple Silicon (ARM64) Podporováno
Alpine Linux x64, ARM64 Podporováno

Kompatibilita funkcí

Následující tabulky uvádějí funkce SQL Server a jejich stav podpory v aktuální verzi (1.16.0) ovladače mssql-python. Pokud není podporována funkce, kterou potřebujete, například Always Encrypted nebo MARS, zvažte místo toho použití pyodbc . Pro informace o funkcích přidaných v dřívějších verzích viz Co je nové v mssql-python.

funkce SQL Server

funkce Podpora mssql-python
Šifrovaná připojení (TLS) Podporováno
Trvale šifrováno Nepodporováno
Ověřovací systém Microsoft Entra Podporováno
Několik aktivních sad výsledků (MARS) Nepodporováno
Hromadné kopírování (BCP) Podporováno
Apache Arrow načtení Podporováno
sql_variant sloupky Podporováno
Nativní UUID Podporováno
Odolnost nečinného spojení (ConnectRetryCount) Podporováno
Směrování pouze pro čtení Podporováno
Parametry s hodnotou typu tabulka (TVP) Nepodporováno

DB-API Shoda s verzí 2.0

funkce Support
Rozhraní modulu Kompatibilní
Rozhraní pro připojení Kompatibilní
Rozhraní kurzoru Většinou poslušný
Typové objekty Kompatibilní
Výjimky Kompatibilní
callproc() Není implementováno

Note

Metoda callproc() není implementována. Volejte uložené procedury pomocí EXECUTE příkazů se standardními metodami dotazů.

Požadavky na závislost

Ovladač mssql-python má minimální závislosti:

Závislost Purpose Verze
azure-identity ověřování pomocí Microsoft Entra ID Povinné (>= 1.12.0)
mssql-python-odbc Doprovodný balíček, který posílá binární soubory ovladačů ODBC Povinné od mssql-python 1.13.0. Verze 1.16.0 připíná == 18.6.2.2. Verze 1.13.0 až 1.15.0 připínají == 18.6.2.1.
mssql-python-rs Doprovodný balíček, který obsahuje runtime Rust pro hromadné kopírování a mssql-odbc poskytovatele Povinné (== 0.3.0) od mssql-python 1.16.0

Příkaz pip install mssql-python automaticky nainstaluje oba doprovodné balíčky. Balíček mssql-python-odbc poskytuje binární soubory ovladačů ODBC, které se načítají při startu. Nemusíte instalovat Microsoft ODBC ovladač pro SQL Server zvlášť. Balíček mssql-python-rs poskytuje mssql_py_core modul.

Doprovodné balíčky jsou vyžadovány za běhu. Řidič se nevrací k binárkám uvnitř mssql-python kola. Pro mssql-python 1.16.0 instalujte mssql-python-odbc==18.6.2.2 a mssql-python-rs==0.3.0 explicitně za těchto podmínek:

  • Instalujete pomocí --no-deps.
  • Instalujete z privátního indexu, který nezrcadlí doprovodné balíčky.

Conda balíček z kanálu microsoft zahrnuje oba payloady do jednoho conda balíčku. Více informací najdete v části Instalace pomocí conda.

Migrace z pyodbc

Ovladač mssql-python zjednodušuje nasazení (není potřeba ODBC ovladač) a poskytuje vestavěné poolování připojení. Hlavní rozdíly, na které je třeba při migraci počítat:

Consideration Poznámky
Styl parametrů PyodBC používá qmark polohové parametry. mssql-python ve výchozím nastavení používá pojmenované parametry pyformat a kvůli kompatibilitě podporuje také qmark.
Přístup k řádkům Přístup k atributům je podporován v obou variantách.
Uložené procedury Použijte EXECUTE (ne callproc).
Sdílení připojení Vestavěné poolování v ovladači mssql-python.

Podrobné informace najdete v Migrate from pyodbc .

Migrace z pymssql

Ovladač pymssql již není aktivně udržován. Ovladač mssql-python nabízí podporovanou alternativu s podobnou syntaxí spojení, ale moderními funkcemi jako vestavěné poolování spojení a autentizaci Microsoft Entra.

Consideration Poznámky
Závislost na FreeTDS Nepovinné. Ovladač mssql-python používá DDBC.
Parametry připojení Podobný styl, ale jiné názvy parametrů.
Přístup k řádkům Oba podporují slovníkový přístup i přístup přes atributy.
Uložené procedury Použijte EXECUTE (ne callproc).

Podrobné pokyny naleznete v článku Migrate from pymssql .

Pravidla pro porušení změn

  • Hlavní verze (2.0, 3.0): Zásadní změny verzí znamenají porušení API změn.
  • Menší verze (1.4, 1.5): Zahrnují nové funkce a zachovávají zpětnou kompatibilitu.
  • Verze s patchem (1.4.1, 1.4.2): Obsahují pouze opravy chyb.

Tým dokumentuje aktuální změny v poznámkách k vydání a poskytuje průvodce migrací.

Jak zůstat aktuální

Ovladač mssql-python často vydává menší verze. Pravidelně kontrolujte aktualizace, zejména před nasazením do produkce.

Kontrola nainstalované verze

Ověřte, která verze ovladače je aktuálně nainstalovaná ve vašem prostředí:

import mssql_python
print(mssql_python.__version__)

Upgrade na nejnovější verzi

Aktualizujte na nejnovější verzi a získejte nejnovější funkce a bezpečnostní opravy.

pip install --upgrade mssql-python

Přihlášení k odběru aktualizací

  • Sledujte repozitář GitHub.
  • Podívejte se na PyPI pro novinky.
  • Prohlédněte si changelog pro každé vydání.

Získání podpory

Problémy s GitHubem

Hlášení chyb a žádostí o funkce v GitHub:

Documentation

Community

  • Stack Overflow: Označte otázky štítkem mssql-python.
  • GitHub diskuse: Použijte pro obecné otázky a diskuze.

Související obsah

  • Poslední aktualizace v