Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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.