A mssql-python támogatási életciklusa

Az mssql-python illesztőprogram a Microsoft hivatalos Python-illesztőprogramja az SQL Serverhez, az Azure SQL Database-hez, az Azure SQL Managed Instance-hez és a Microsoft Fabricben található SQL-adatbázishoz. A drivert a GitHubon aktívan karbantartják, és a PyPI-n keresztül teszik közzé. Ez a cikk a verziószerkesztést, platformkompatibilitást és támogatási idővonalakat tárgyalja.

Verziótámogatás

Mindig használd a legújabb verziót, hogy új funkciókat, teljesítményjavításokat és biztonsági javításokat kapj. Az új képességek csak az aktuális kiadáshoz lesznek hozzáadva.

Aktuális verzió

Az 1.11.0 verzió a jelenlegi általános elérhetőségi (GA) kiadás.

Verzióelőzmények

Változat Megjelenési dátum Status Legfontosabb funkciók
1.11.0 2026. július Aktuális Kontextuskezelőhöz kapcsolódó commit/rollback, Apple Silicon javítás, a szolgáltatásnév tömeges másolásának javítása
1.10.0 2026. június Előző Tömeges másolás az ActiveDirectoryServicePrincipal használatával, Arrow VARCHAR javítások
1.9.0 2026. június Előző Tömeges másolás Row objektumokkal, javított NULL paraméterek típuskezelése
1.8.0 2026. május Előző Tömeges másolás ActiveDirectoryMSI-vel, sorsor-kulcs indexálás
1.7.1 2026. május Előző RHEL 8-hoz készült wheel csomagok, szélesebb körű párhuzamossági és Unicode-javítások
1.6.0 2026. április Előző Parseralapú kapcsolati sztring-megtisztítás, a csatlakozás/leválasztás egyidejűségével kapcsolatos hibajavítások
1.5.0 2026. április Előző Arrow-lekérés, sql_variant, natív UUID
1.4.0 február 2025. Előző Tömeges másolattámogatás (BCP)
1.3.0 Január 2025. Előző Beállítások osztály, modul konfiguráció
1.2.0 2024. november Előző Sémafelfedezési módszerek
1.1.0 2024. szeptember Előző Egyedi kimeneti konverterek
1.0.0 2024. július Előző Első általánosan elérhető kiadás

Important

Csak a jelenlegi verzió (1.11.0) kap új funkciókat és hibajavításokat. A korábbi verziók működőképesek maradnak, de nem kapnak frissítéseket. Frissíts a legújabb verzióra a legjobb élményért.

Python verzió kompatibilitás

Az mssql-python illesztőprogramhoz Python 3.10 vagy újabb verziót igényel. Ha új projektet kezdesz, a kompatibilitási mátrixban a leghosszabb támogatási ablakot célozd meg a legújabb támogatott Python kiadásban. Ha egy régebbi Python verzióra vagy korlátozva (3.9 vagy ankarabb), használd inkább a pyodbc-t.

Python-verzió Támogatási állapot
Python 3.14 Támogatott
Python 3.13 Támogatott
Python 3.12 Támogatott
Python 3.11 Támogatott
Python 3.10 Támogatott (minimum)
Python 3.9 és korábbi verziók Nem támogatott

Important

Mindig használjon támogatott Python verziót. A régebbi Python verziók nem kapnak biztonsági frissítéseket.

SQL Server verziókompatibilitás

Az mssql-python illezőprogram a TDS protokollt használja, és minden aktívan támogatott SQL Server verzióval működik.

SQL Server-verzió Támogatási állapot
A Microsoft SQL Server összes támogatott verziója Teljes mértékben támogatott

Azure SQL-szolgáltatások

Service Támogatási állapot
Azure SQL Database Teljes mértékben támogatott
Azure SQL Managed Instance Teljes mértékben támogatott
Azure Synapse Analytics (dedikált készletek) Támogatott

Microsoft Fabric

Endpoint Támogatási állapot
SQL-adatbázis a Fabricben Teljes mértékben támogatott
Fabric adattárház Támogatott
SQL-elemzési végpont (Lakehouse) Támogatott
SQL-elemzési végpont (tükrözött adatbázis) Támogatott

Operációs rendszer kompatibilitása

Az mssql-python illesztőprogram DDBC-t (Direct Database Connectivity) használja, és nem szükséges a Microsoft ODBC illezőprogramot telepíteni. A külső függőség eltávolítása egyszerűsíti a telepítést, különösen konténerekben és CI/CD vezetékekben.

Operációs rendszer Architecture Támogatási állapot
Windows 11 x64, ARM64 Támogatott
Windows Server 2019, 2022, 2025 x64 Támogatott
Ubuntu 22.04, 24.04, 26.04 x64, ARM64 Támogatott
Debian 11, 12 x64, ARM64 Támogatott
Red Hat Enterprise Linux 8, 9 x64, ARM64 Támogatott
macOS 14, 15, 26 Intel, Apple Silicon (ARM64) Támogatott
Alpine Linux x64 Támogatott

Funkciókompatibilitás

Az alábbi táblázatok az SQL Server funkcióit és támogatási státuszusukat a mssql-python illezőprogramjának jelenlegi verziójában (1.11.0) sorolják. Ha egy szükséges funkció nem támogatott (például a Always Encrypted vagy a MARS), fontold meg a pyodbc használatát helyette. A korábbi verziókban hozzáadott funkciókról információért lásd: Mi újság az mssql-pythonban.

SQL Server funkciók

Feature mssql-python támogatás
Titkosított kapcsolatok (TLS) Támogatott
Always Encrypted (mindig titkosítva) Nem támogatott
Microsoft Entra-hitelesítés Támogatott
Több aktív eredményhalmaz (MARS) Nem támogatott
Tömeges másolás (BCP) Támogatott
Apache Arrow lekérés Támogatott
sql_variant típusú oszlopok Támogatott
Native UUID Támogatott
Kapcsolat rugalmassága Támogatott
Írásvédett útválasztás Támogatott

DB-API 2.0 megfelelőség

Feature Support
Modul interfész Megfelelő
Kapcsolati felület Megfelelő
Kurzor interfész Többnyire engedékeny
Típus objektumok Megfelelő
Kivételek Megfelelő
callproc() Nincs implementálva

Megjegyzés:

A callproc() módszer nincs megvalósítva. Tárolt eljárásokat hívhat meg EXECUTE utasításokkal, szabványos lekérdezési metódusok használatával.

Függőségi követelmények

Az mssql-python illesztőprogramnak minimális függőségei vannak:

Függőség Alkalmazás célja Változat
azure-identity Microsoft Entra ID-hitelesítés Kötelező (>= 1.12.0)

Az mssql-python illezőprogramhoz nem szükséges Microsoft ODBC illezser telepítése.

Migráció a pyodbc-ből

Az mssql-python illesztőprogram leegyszerűsíti a telepítést (ODBC illezser nélkül) és beépített kapcsolati poolingot biztosít. A fő különbségek, amikre érdemes megtervezni a migráció során:

Consideration Jegyzetek
Paraméterstílus A PyoDBC pozíciós paramétereket használ qmark . Az MSSQL-Python alapértelmezett paramétereket használ pyformat , és támogatja a kompatibilitást is qmark .
Sorhozzáférés Mindkét attribútum-hozzáférés támogatott.
Tárolt eljárások Használd EXECUTE (nem callproc).
Kapcsolatmegosztás Beépített kapcsolatcsoportosítás az mssql-python illesztőprogramban.

Részletes útmutatásért lásd: Migrate from pyodbc .

Migráció a pymssql-ből

A pymssql drivert már nem karbantartják aktívan. Az mssql-python illesztőprogram támogatott alternatívát kínál hasonló kapcsolatszintaxissal, de modern funkciókkal, mint a beépített kapcsolati pooling és a Microsoft Entra hitelesítés.

Consideration Jegyzetek
FreeTDS függőség Nem kötelező. Az mssql-python illezser DDBC-t használ.
Kapcsolati paraméterek Hasonló stílus, de eltérő paraméternevek.
Sorhozzáférés Mindkettő támogatja a szótár-stílusú és attribútum-hozzáférési mintákat.
Tárolt eljárások Használd EXECUTE (nem callproc).

Részletes útmutatásért lásd a Migrate from pymssql-t .

Változások megtörése

  • Főbb verziók (2.0, 3.0): A főbb verzióváltozások az API változások meghibásítását jelentik.
  • Kisebb verziók (1.4, 1.5): Új funkciók hozzáadása és visszafelé kompatibilitás fenntartása.
  • Javítási verziók (1.4.1, 1.4.2): Csak hibajavításokat tartalmaz.

A csapat dokumentálja a kiadási jegyzetekben megjelent változásokat, és migrációs útmutatókat biztosít.

Az aktuális állapot megőrzése

Az mssql-python illezőgép gyakran ad ki kisebb verziókat. Rendszeresen ellenőrizd a frissítéseket, különösen a gyártási bevezetés előtt.

Telepített verzió ellenőrzése

Ellenőrizd, melyik illesztőprogramverzió van telepítve jelenleg a környezetedben:

import mssql_python
print(mssql_python.__version__)

Frissítés a legújabb verzióra

Frissítsd a legújabb kiadást, hogy megkapd a legújabb funkciókat és biztonsági javításokat.

pip install --upgrade mssql-python

Feliratkozás a frissítésekre

Támogatás kérése

GitHub-problémák

Hibák jelentése és szolgáltatások kérése a GitHub:

Documentation

Community

  • Stack Overflow: Címkézz a kérdéseket .mssql-python
  • GitHub beszélgetések: Általános kérdésekhez és vitákhoz használjuk.

Kapcsolódó tartalom

  • Last updated on