Ž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.14.0 je aktuální finální vydání (GA).

Historie verzí

Verze Datum vydání Stav Klíčové funkce
1.14.0 Srpen 2026 Aktuální 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.14.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.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 x64, ARM64 Podporováno
Red Hat Enterprise Linux 8, 9 x64, ARM64 Podporováno
macOS 14, 15, 26 Intel, Apple Silicon (ARM64) Podporováno
Alpine Linux x64 Podporováno

Kompatibilita funkcí

Následující tabulky uvádějí funkce SQL Server a jejich stav podpory v aktuální verzi (1.14.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 fetch Podporováno
sql_variant sloupky Podporováno
Nativní UUID Podporováno
Odolnost připojení Podporováno
Směrování pouze pro čtení Podporová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 Vyžadováno (== 18.6.2.1) od verze mssql-python 1.13.0

Příkaz pip install mssql-python automaticky nainstaluje mssql-python-odbc doprovodný balíček. Tento balíček poskytuje binárky ovladačů ODBC, které se načítají při startu. Nemusíte instalovat Microsoft ODBC ovladač pro SQL Server zvlášť.

Doprovodný balíček je vyžadován při běhu. Řidič se nevrací k binárkám uvnitř mssql-python kola. Instalujte mssql-python-odbc==18.6.2.1 explicitně za těchto podmínek:

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

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

  • Last updated on