Supportlivscykel för mssql-python

mssql-python-drivrutinen är Microsoft officiella Python-drivrutin för SQL Server, Azure SQL Database, Azure SQL Managed Instance och SQL Database i Microsoft Fabric. Drivrutinen underhålls aktivt på GitHub och släpps via PyPI. Den här artikeln handlar om versionshantering, plattformskompatibilitet och supporttidslinjer.

Versionsstöd

Använd alltid den senaste versionen för att få nya funktioner, prestandaförbättringar och säkerhetsfixar. Nya funktioner läggs bara till i den aktuella versionen.

Aktuell version

Version 1.11.0 är den nuvarande allmänna tillgänglighetsversionen (GA).

Versionshistorik

Version Frisläppningsdatum Status Viktiga funktioner
1.11.0 Juli 2026 Nuvarande Kontexthanterare commit/rollback, korrigering för Apple Silicon, korrigering för masskopiering för service principal
1.10.0 Juni 2026 Previous Bulkkopiering med ActiveDirectoryServicePrincipal, korrigeringar för VARCHAR i Arrow
1.9.0 Juni 2026 Previous Bulkkopiering med radobjekt, förbättrad NULL-parametertypning
1.8.0 Maj 2026 Previous Bulkkopiering med ActiveDirectoryMSI, radsträngsnyckelindexering
1.7.1 Maj 2026 Previous RHEL 8 wheels, utökat stöd för samtidighet och Unicode-korrigeringar
1.6.0 April 2026 Previous Parser-baserad rensning av anslutningssträngar, korrigeringar för samtidighetsproblem vid anslutning/frånkoppling
1.5.0 April 2026 Previous Arrow fetch, sql_variant, intern UUID
1.4.0 Februari 2025 Previous Stöd för masskopiering (BCP)
1.3.0 januari 2025 Previous Inställningsklass, modulkonfiguration
1.2.0 november 2024 Previous Metoder för schemaupptäckt
1.1.0 2024 september Previous Specialanpassade utgångsomformere
1.0.0 juli 2024 Previous Första GA-versionen

Important

Endast den nuvarande versionen (1.11.0) får nya funktioner och buggfixar. Tidigare versioner fungerar fortfarande men får inga uppdateringar. Uppgradera till den senaste versionen för bästa upplevelse.

Python versionskompatibilitet

MSSQL-python-drivrutinen kräver Python 3.10 eller senare. Om du startar ett nytt projekt, sikta på den nyaste stödda Python-versionen i kompatibilitetsmatrisen för det längsta supportfönstret. Om du är begränsad till en äldre Python-version (3.9 eller tidigare), använd pyodbc istället.

Python-version Status för support
Python 3.14 Stöds
Python 3.13 Stöds
Python 3.12 Stöds
Python 3.11 Stöds
Python 3.10 Stödd (minimum)
Python 3.9 och tidigare Stöds ej

Important

Använd alltid en Python version som stöds. Äldre Python versioner får inte säkerhetsuppdateringar.

SQL Server versionskompatibilitet

mssql-python-drivrutinen använder TDS-protokollet och fungerar med alla aktivt stödda SQL Server-versioner.

SQL Server-versionen Status för support
Alla stödda versioner av Microsoft SQL Server Stöds fullt ut

Azure SQL-tjänster

Service Status för support
Azure SQL Database Stöds fullt ut
Hanterad instans i Azure SQL Stöds fullt ut
Azure Synapse Analytics (dedikerade pooler) Stöds

Microsoft Fabric

Endpoint Status för support
SQL-databasen i Fabric Stöds fullt ut
Fabric-datalager Stöds
SQL-analysändpunkt (Lakehouse) Stöds
SQL-analysslutpunkt (speglad databas) Stöds

Kompatibilitet för operativsystem

mssql-python-drivrutinen använder DDBC (Direct Database Connectivity) och kräver inte att Microsoft ODBC-drivrutinen är installerad. Att ta bort det externa beroendet förenklar distributionen, särskilt i containrar och CI/CD-pipelines.

Operativsystem Architecture Status för support
Windows 11 x64, ARM64 Stöds
Windows Server 2019, 2022, 2025 x64 Stöds
Ubuntu 22.04, 24.04, 26.04 x64, ARM64 Stöds
Debian 11, 12 x64, ARM64 Stöds
Red Hat Enterprise Linux 8, 9 x64, ARM64 Stöds
macOS 14, 15, 26 Intel, Apple Silicon (ARM64) Stöds
Alpine Linux x64 Stöds

Funktionskompatibilitet

Följande tabeller listar SQL Server-funktioner och deras stödstatus i den aktuella versionen (1.11.0) av mssql-python-drivrutinen. Om en funktion du behöver inte stöds (som Always Encrypted eller MARS), överväg att använda pyodbc istället. För information om funktioner som lagts till i tidigare versioner, se Vad är nytt i mssql-python.

SQL Server funktioner

Feature MSSQL-Python-stöd
Krypterade anslutningar (TLS) Stöds
Alltid Krypterad Stöds ej
Microsoft Entra-autentisering Stöds
Flera aktiva resultatuppsättningar (MARS) Stöds ej
Masskopiering (BCP) Stöds
Apache Arrow hämtar Stöds
sql_variant-kolumner Stöds
Inbyggd UUID Stöds
Anslutningsmotståndskraft Stöds
Skrivskyddad routning Stöds

Överensstämmelse med DB-API 2.0

Feature Support
Modulgränssnitt Godkänd
Anslutningsgränssnitt Godkänd
Markörgränssnitt I stort sett uppfyller kraven
typobjekt Godkänd
undantag Godkänd
callproc() Inte implementerad

Note

Metoden callproc() är inte implementerad. Anropa lagrade procedurer genom att använda EXECUTE satser med standardfrågemetoder.

Beroendekrav

mssql-python-drivrutinen har minimala beroenden:

Beroende Purpose Version
azure-identity Microsoft Entra ID-autentisering Krävs (>= 1.12.0)

MSSQL-python-drivrutinen kräver ingen installation av Microsoft ODBC-drivrutin.

Migration från pyodbc

mssql-python-drivrutinen förenklar distributionen (ingen ODBC-drivrutin krävs) och erbjuder inbyggd anslutningspool. De viktigaste skillnaderna att planera för vid migrering:

Övervägande Noteringar
Parameterstil Pyodbc använder qmark positionsparametrar. mssql-python använder pyformat som standard för namngivna parametrar och stöder även qmark för kompatibilitet.
Radåtkomst Attributåtkomst stöds i båda.
Lagrade procedurer Använd EXECUTE (ingen callproc).
Anslutningspoolning Inbyggd poolning i mssql-python-drivrutinen.

Se Migrera från pyodbc för detaljerad vägledning.

Migrering från pymssql

Pymssql-drivrutinen underhålls inte längre aktivt. mssql-python-drivrutinen erbjuder ett stödjande alternativ med liknande anslutningssyntax men moderna funktioner som inbyggd anslutningspoolning och Microsoft Entra-autentisering.

Övervägande Noteringar
FreeTDS-beroende Krävs inte. MSSQL-python-drivrutinen använder DDBC.
Anslutningsparametrar Liknande stil, men olika parameternamn.
Radåtkomst Båda har stöd för åtkomstmönster i ordboksstil och attributåtkomst.
Lagrade procedurer Använd EXECUTE (ingen callproc).

Se Migrera från pymssql för detaljerad vägledning.

Policy för kompatibilitetsbrytande ändringar

  • Huvudversioner (2.0, 3.0): Ändringar av huvudversion indikerar inkompatibla API-ändringar.
  • Mindre versioner (1.4, 1.5): Inkludera nya funktioner och behåll bakåtkompatibilitet.
  • Patchversioner (1.4.1, 1.4.2): Inkluderar endast buggfixar.

Teamet dokumenterar brytande ändringar i versionsanteckningar och tillhandahåller migreringsguider.

Så här håller du dig uppdaterad

mssql-python-drivrutinen släpper ofta mindre versioner. Kontrollera regelbundet efter uppdateringar, särskilt innan produktionsdistributioner.

Kontrollera installerad version

Verifiera vilken version av drivrutinen som för närvarande är installerad i din miljö:

import mssql_python
print(mssql_python.__version__)

Uppgradera till den senaste versionen

Uppdatera till den senaste versionen för att få de senaste funktionerna och säkerhetsfixarna.

pip install --upgrade mssql-python

Prenumerera på uppdateringar

  • Titta på GitHub-arkivet.
  • Kolla PyPI för nya releaser.
  • Gå igenom ändringsloggen för varje release.

Få support

GitHub-problem

Rapportera buggar och begärandefunktioner på GitHub:

Documentation

Community

  • Stack Overflow: Tagga frågor med mssql-python.
  • GitHub-diskussioner: Används för allmänna frågor och diskussioner.