Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der mssql-python-Treiber ist Microsoft offizieller Python-Treiber für SQL Server, Azure SQL-Datenbank, Azure SQL Managed Instance und SQL Database in Microsoft Fabric. Der Treiber wird aktiv auf GitHub gepflegt und über PyPI freigegeben. Dieser Artikel behandelt Versionierung, Plattformkompatibilität und Support-Zeitpläne.
Versionsunterstützung
Verwenden Sie immer die neueste Version, um neue Funktionen, Leistungsverbesserungen und Sicherheitsupdates zu erhalten. Neue Funktionen werden nur zur aktuellen Version hinzugefügt.
Aktuelle Version
Version 1.11.0 ist die aktuelle allgemein verfügbare Version (GA).
Versionsverlauf
| Version | Erscheinungsdatum | Status | Wichtigste Funktionen |
|---|---|---|---|
| 1.11.0 | Juli 2026 | Aktuell | Fehlerbehebung für Commit/Rollback im Kontextmanager, Apple-Silicon-Fehlerbehebung, Fehlerbehebung für Massenkopieren mit Dienstprinzipalen |
| 1.10.0 | Juni 2026 | Previous | Massenkopie mit ActiveDirectoryServicePrincipal, Arrow VARCHAR-Korrekturen |
| 1.9.0 | Juni 2026 | Previous | Massenkopieren mit Zeilenobjekten, verbesserte Typisierung von NULL-Parametern |
| 1.8.0 | Mai 2026 | Previous | Massenkopieren mit ActiveDirectoryMSI, Zeilenindizierung mit String-Schlüsseln |
| 1.7.1 | Mai 2026 | Previous | RHEL 8-Wheels, breitere Unterstützung für Parallelität und Unicode-Korrekturen |
| 1.6.0 | April 2026 | Previous | Parserbasierte Verbindungszeichenfolge Sanitization, Connect/Disconnect-Gleichzeitigkeits-Fixierungen |
| 1.5.0 | April 2026 | Previous | Arrow-Abruf, sql_variant, native UUID |
| 1.4.0 | Februar 2025 | Previous | Unterstützung für Massenkopien (BCP) |
| 1.3.0 | Januar 2025 | Previous | Settings-Klasse, Modulkonfiguration |
| 1.2.0 | November 2024 | Previous | Methoden zur Schema-Entdeckung |
| 1.1.0 | September 2024 | Previous | Benutzerdefinierte Ausgabekonverter |
| 1.0.0 | Juli 2024 | Previous | Erste GA-Veröffentlichung |
Important
Nur die aktuelle Version (1.11.0) erhält neue Funktionen und Fehlerbehebungen. Frühere Versionen sind weiterhin funktionsfähig, erhalten aber keine Updates. Upgrade auf die neueste Version für das beste Erlebnis.
Python Versionskompatibilität
Der mssql-python-Treiber benötigt Python 3.10 oder neuer. Wenn du ein neues Projekt startest, ziele auf die neueste unterstützte Python-Version in der Kompatibilitätsmatrix für das längste Supportfenster. Wenn du auf eine ältere Python-Version (3.9 oder früher) beschränkt bist, nutze stattdessen pyodbc.
| Python-Version | Status der Unterstützung |
|---|---|
| Python 3.14 | Unterstützt |
| Python 3.13 | Unterstützt |
| Python 3.12 | Unterstützt |
| Python 3.11 | Unterstützt |
| Python 3.10 | Unterstützt (mindestens) |
| Python 3.9 und früher | Nicht unterstützt |
Important
Verwenden Sie immer eine unterstützte Python Version. Ältere Python Versionen erhalten keine Sicherheitsupdates.
SQL Server Versionskompatibilität
Der mssql-python-Treiber verwendet das TDS-Protokoll und funktioniert mit allen aktiv unterstützten SQL Server-Versionen.
| SQL Server-Version | Status der Unterstützung |
|---|---|
| Alle unterstützten Versionen von Microsoft SQL Server | Vollständig unterstützt |
Azure SQL-Dienste
| Service | Status der Unterstützung |
|---|---|
| Azure SQL-Datenbank | Vollständig unterstützt |
| Verwaltete Azure SQL-Instanz | Vollständig unterstützt |
| Azure Synapse Analytics (dedizierte Pools) | Unterstützt |
Microsoft Fabric
| Endpunkt | Status der Unterstützung |
|---|---|
| SQL-Datenbank in Fabric | Vollständig unterstützt |
| Fabric Data Warehouse | Unterstützt |
| SQL-Analytics-Endpunkt (Lakehouse) | Unterstützt |
| SQL-Analytics-Endpunkt (gespiegelte Datenbank) | Unterstützt |
Betriebssystemkompatibilität
Der mssql-python-Treiber verwendet DDBC (Direct Database Connectivity) und benötigt keine Installation des Microsoft ODBC-Treibers. Das Entfernen der externen Abhängigkeit vereinfacht die Bereitstellung, insbesondere in Containern und CI/CD-Pipelines.
| Betriebssystem | Architecture | Status der Unterstützung |
|---|---|---|
| Windows 11 | x64, ARM64 | Unterstützt |
| Windows Server 2019, 2022, 2025 | x64 | Unterstützt |
| Ubuntu 22.04, 24.04, 26.04 | x64, ARM64 | Unterstützt |
| Debian 11, 12 | x64, ARM64 | Unterstützt |
| Red Hat Enterprise Linux 8, 9 | x64, ARM64 | Unterstützt |
| macOS 14, 15, 26 | Intel, Apple Silicon (ARM64) | Unterstützt |
| Alpine Linux | x64 | Unterstützt |
Kompatibilität von Funktionen
Die folgenden Tabellen listen SQL Server-Funktionen und deren Unterstützungsstatus in der aktuellen Version (1.11.0) des mssql-python-Treibers auf. Wenn eine Funktion, die du brauchst, nicht unterstützt wird (wie Always Encrypted oder MARS), solltest du stattdessen pyodbc verwenden. Informationen zu Funktionen, die in früheren Versionen hinzugefügt wurden, finden Sie unter Was ist neu in mssql-python.
SQL Server Funktionen
| Funktion | MSSQL-Python-Unterstützung |
|---|---|
| Verschlüsselte Verbindungen (TLS) | Unterstützt |
| Immer Verschlüsselt | Nicht unterstützt |
| Microsoft Entra-Authentifizierung | Unterstützt |
| MARS (Multiple Active Result Sets, mehrere aktive Resultsets) | Nicht unterstützt |
| Massenkopie (BCP) | Unterstützt |
| Apache Arrow abrufen | Unterstützt |
| sql_variant Spalten | Unterstützt |
| Native UUID | Unterstützt |
| Verbindungsstabilität | Unterstützt |
| Schreibgeschütztes Routing | Unterstützt |
DB-API 2.0-Konformität
| Funktion | Support |
|---|---|
| Modulschnittstelle | Konform |
| Verbindungsschnittstelle | Konform |
| Cursor-Schnittstelle | Meistens konform |
| Typobjekte | Konform |
| Ausnahmen | Konform |
callproc() |
Nicht implementiert |
Note
Die Methode callproc() wird nicht umgesetzt. Rufen Sie gespeicherte Prozeduren durch Verwendung von EXECUTE Anweisungen mit Standard-Abfragemethoden auf.
Anforderungen an Abhängigkeiten
Der mssql-python-Treiber hat minimale Abhängigkeiten:
| Abhängigkeit | Purpose | Version |
|---|---|---|
| Azure-Identity | Microsoft Entra ID-Authentifizierung | Erforderlich (>= 1.12.0) |
Der mssql-python-Treiber erfordert keine Installation eines Microsoft ODBC-Treibers.
Migration von Pyodbc
Der mssql-python-Treiber vereinfacht die Bereitstellung (kein ODBC-Treiber erforderlich) und bietet integriertes Connection Pooling. Die wichtigsten Unterschiede, auf die man beim Migrieren achten sollte:
| Consideration | Hinweise |
|---|---|
| Parameterstil | Pyodbc verwendet qmark Positionsparameter. mssql-python verwendet standardmäßig pyformat als benannte Parameter und unterstützt zur Kompatibilität auch qmark. |
| Zeilenzugriff | Attributzugriff wird in beiden unterstützt. |
| Gespeicherte Prozeduren | Verwenden EXECUTE (ohne callproc). |
| Verbindungspooling | Eingebautes Pooling im mssql-python-Treiber. |
Siehe Migration from pyodbc für detaillierte Anleitungen.
Migration von pymssql
Der pymssql-Treiber wird nicht mehr aktiv gepflegt. Der mssql-python-Treiber bietet eine unterstützte Alternative mit ähnlicher Verbindungssyntax, aber modernen Funktionen wie integriertem Connection Pooling und Microsoft Entra-Authentifizierung.
| Consideration | Hinweise |
|---|---|
| FreeTDS-Abhängigkeit | Nicht erforderlich. Der mssql-python-Treiber verwendet DDBC. |
| Verbindungsparameter | Ähnlicher Stil, aber unterschiedliche Parameternamen. |
| Zeilenzugriff | Beide unterstützen Wörterbuch- und Attributzugriffsmuster. |
| Gespeicherte Prozeduren | Verwenden EXECUTE (ohne callproc). |
Siehe Migrate from pymssql für detaillierte Anleitungen.
Richtlinie für kompatibilitätsbrechende Änderungen
- Hauptversionen (2.0, 3.0): Große Versionsänderungen bedeuten fehlerhafte API-Änderungen.
- Nebenversionen (1.4, 1.5): Neue Funktionen enthalten und Abwärtskompatibilität erhalten.
- Patch-Versionen (1.4.1, 1.4.2): Enthalten nur Fehlerbehebungen.
Das Team dokumentiert aktuelle Änderungen in den Release Notes und stellt Migrationsleitfäden bereit.
So bleiben Sie auf dem neuesten Stand
Der mssql-python-Treiber veröffentlicht häufig kleinere Versionen. Überprüfen Sie regelmäßig auf Updates, besonders vor Produktionsdeployments.
Überprüfen der installierten Version
Überprüfen Sie, welche Version des Treibers derzeit in Ihrer Umgebung installiert ist:
import mssql_python
print(mssql_python.__version__)
Upgrade auf die neueste Version
Aktualisieren Sie auf die neueste Version, um die neuesten Funktionen und Sicherheitskorrekturen zu nutzen.
pip install --upgrade mssql-python
Abonnieren von Updates
- Schau dir das GitHub-Repository an.
- Schau dir PyPI für neue Veröffentlichungen an.
- Überprüfen Sie das Änderungsprotokoll für jede Version.
Unterstützung erhalten
GitHub-Probleme
Melden von Fehlern und Anfordern von Features für GitHub:
Documentation
Community
- Stack Overflow: Markiere Fragen mit
mssql-python. - GitHub-Diskussionen: Verwendung für allgemeine Fragen und Diskussionen.