Ondersteuningslevenscyclus voor mssql-python

De mssql-python driver is Microsoft's officiële Python-driver voor SQL Server, Azure SQL Database, Azure SQL Managed Instance en SQL Database in Microsoft Fabric. De driver wordt actief onderhouden op GitHub en vrijgegeven via PyPI. Dit artikel behandelt versiebeheer, platformcompatibiliteit en ondersteuningstijdlijnen.

Versieondersteuning

Gebruik altijd de nieuwste release om nieuwe functies, prestatieverbeteringen en beveiligingsfixes te krijgen. Nieuwe mogelijkheden worden alleen toegevoegd aan de huidige release.

Huidige versie

Versie 1.11.0 is de huidige algemeen beschikbare GA-release.

Versiegeschiedenis

Versie Releasedatum Status Belangrijkste kenmerken
1.11.0 Juli 2026 Huidig Context manager commit/rollback, oplossing voor Apple Silicon, oplossing voor service principal-bulkkopie
1.10.0 Juni 2026 Previous Bulkkopie met ActiveDirectoryServicePrincipal, Arrow VARCHAR-correcties
1.9.0 Juni 2026 Previous Bulk-kopie met Row-objecten, verbeterde NULL-parametertypering
1.8.0 Mei 2026 Previous Bulk-kopiëren met ActiveDirectoryMSI, rijstring-sleutelindexering
1.7.1 Mei 2026 Previous RHEL 8 wheels, uitgebreidere ondersteuning voor gelijktijdigheid en Unicode-correcties
1.6.0 April 2026 Previous Parsergestuurde opschoning van verbindingsreeksen, oplossingen voor gelijktijdigheidsproblemen bij verbinden/verbreken
1.5.0 April 2026 Previous Arrow fetch, sql_variant, native UUID
1.4.0 Februari 2025 Previous Ondersteuning voor bulkkopieën (BCP)
1.3.0 januari 2025 Previous Instellingen, klasse, moduleconfiguratie
1.2.0 november 2024 Previous Methoden voor schema-ontdekking
1.1.0 2024 september Previous Aangepaste uitgangsomzetters
1.0.0 Juli 2024 Previous Eerste GA-release

Important

Alleen de huidige versie (1.11.0) krijgt nieuwe functies en bugfixes. Eerdere versies functioneren nog wel, maar krijgen geen updates. Upgrade naar de nieuwste versie voor de beste ervaring.

Python versiecompatibiliteit

De mssql-python driver vereist Python 3.10 of nieuwer. Als je een nieuw project start, richt je dan op de nieuwste ondersteunde Python-release in de compatibiliteitsmatrix voor het langste ondersteuningsvenster. Als je beperkt bent tot een oudere Python-versie (3.9 of eerder), gebruik dan pyodbc.

Python-versie Ondersteuningsstatus
Python 3.14 Supported
Python 3.13 Supported
Python 3.12 Supported
Python 3.11 Supported
Python 3.10 Ondersteund (minimaal)
Python 3.9 en eerder Niet ondersteund

Important

Gebruik altijd een ondersteunde Python-versie. Oudere Python versies ontvangen geen beveiligingsupdates.

compatibiliteit met SQL Server-versie

De mssql-python-driver gebruikt het TDS-protocol en werkt met alle actief ondersteunde SQL Server-versies.

SQL Server-versie Ondersteuningsstatus
Alle ondersteunde versies van Microsoft SQL Server Volledig ondersteund

Azure SQL Services

Dienst Ondersteuningsstatus
Azure SQL Database Volledig ondersteund
Azure SQL Managed Instance (een beheerde database-instantie van Azure) Volledig ondersteund
Azure Synapse Analytics (toegewezen pools) Supported

Microsoft Fabric

Eindpunt Ondersteuningsstatus
Een SQL-database in Fabric Volledig ondersteund
Fabric Data Warehouse Supported
SQL-analyse-eindpunt (Lakehouse) Supported
SQL-analyse-eindpunt (gespiegelde database) Supported

Compatibiliteit van besturingssysteem

De mssql-python driver gebruikt DDBC (Direct Database Connectivity) en vereist niet dat de Microsoft ODBC Driver wordt geïnstalleerd. Het verwijderen van externe afhankelijkheid vereenvoudigt de deployment, vooral in containers en CI/CD-pijplijnen.

besturingssysteem Architecture Ondersteuningsstatus
Windows 11 x64, ARM64 Supported
Windows Server 2019, 2022, 2025 x64 Supported
Ubuntu 22.04, 24.04, 26.04 x64, ARM64 Supported
Debian 11, 12 x64, ARM64 Supported
Red Hat Enterprise Linux 8, 9 x64, ARM64 Supported
macOS 14, 15, 26 Intel, Apple Silicon (ARM64) Supported
Alpine Linux x64 Supported

Functiecompatibiliteit

De volgende tabellen geven SQL Server-functies en hun ondersteuningsstatus weer in de huidige versie (1.11.0) van de mssql-python-driver. Als een functie die je nodig hebt niet wordt ondersteund (zoals Always Encrypted of MARS), overweeg dan in plaats daarvan pyodbc te gebruiken. Voor informatie over functies die in eerdere versies zijn toegevoegd, zie Wat nieuw is in mssql-python.

SQL Server functies

Feature mssql-python ondersteuning
Versleutelde verbindingen (TLS) Supported
Altijd versleuteld Niet ondersteund
Microsoft Entra-authenticatie Supported
Meerdere actieve resultatensets (MARS) Niet ondersteund
Bulkkopie (BCP) Supported
Apache Arrow ophalen Supported
sql_variant kolommen Supported
Inheemse UUID Supported
Verbindingstolerantie Supported
Alleen-lezenroutering Supported

DB-API 2.0-compatibiliteit

Feature Support
Moduleinterface Compliant
Verbindingsinterface Compliant
Cursorinterface Grotendeels conform
Typ objecten Compliant
Exceptions Compliant
callproc() Niet geïmplementeerd

Opmerking

De callproc() methode is niet geïmplementeerd. Roep opgeslagen procedures aan met behulp van EXECUTE statements met standaard querymethoden.

Afhankelijkheidsvereisten

De mssql-python-driver heeft minimale afhankelijkheden:

Afhankelijkheid Purpose Versie
azure-identity Microsoft Entra ID-verificatie Vereist (>= 1.12.0)

De mssql-python driver vereist geen installatie van een Microsoft ODBC driver.

Migratie vanuit pyodbc

De mssql-python-driver vereenvoudigt de implementatie (geen ODBC-driver nodig) en biedt ingebouwde verbindingspooling. De belangrijkste verschillen om rekening mee te houden bij migratie:

Consideratie Aantekeningen
Parameterstijl Pyodbc gebruikt qmark positionele parameters. mssql-python gebruikt standaard pyformat benoemde parameters en ondersteunt ook qmark voor compatibiliteit.
Rijtoegang Attribuuttoegang wordt in beide ondersteund.
opgeslagen procedures Gebruik EXECUTE (geen callproc).
Groepsgewijze verbindingen Ingebouwde pooling in de mssql-python driver.

Zie Migreren van pyodbc voor gedetailleerde richtlijnen.

Migratie van pymssql

De pymssql-driver wordt niet langer actief onderhouden. De mssql-python driver biedt een ondersteund alternatief met vergelijkbare verbindingssyntaxis, maar moderne functies zoals ingebouwde connection pooling en Microsoft Entra-authenticatie.

Consideratie Aantekeningen
FreeTDS-afhankelijkheid Niet vereist. De mssql-python-driver gebruikt DDBC.
Verbindingsparameters Vergelijkbare stijl, maar andere parameternamen.
Rijtoegang Beide ondersteunen woordenboekstijl en attribuuttoegangspatronen.
opgeslagen procedures Gebruik EXECUTE (geen callproc).

Zie Migreren van pymssql voor gedetailleerde richtlijnen.

Beleid voor het breken van wijzigingen

  • Belangrijke versies (2.0, 3.0): Grote versiewijzigingen betekenen dat API-wijzigingen breken.
  • Kleine versies (1.4, 1.5): Nieuwe functies toevoegen en achterwaartse compatibiliteit behouden.
  • Patchversies (1.4.1, 1.4.2): Alleen bugfixes bevatten.

Het team documenteert incompatibele wijzigingen in releaseopmerkingen en biedt migratiehandleidingen aan.

Hoe blijf ik op de hoogte

De mssql-python-driver brengt vaak kleine versies uit. Controleer regelmatig op updates, vooral vóór productie-implementaties.

Geïnstalleerde versie controleren

Controleer welke versie van de driver momenteel in jouw omgeving is geïnstalleerd:

import mssql_python
print(mssql_python.__version__)

Upgraden naar de nieuwste versie

Update naar de nieuwste release om de nieuwste functies en beveiligingsupdates te krijgen.

pip install --upgrade mssql-python

Abonneren op updates

  • Bekijk de GitHub-repository.
  • Bekijk PyPI voor nieuwe releases.
  • Bekijk de wijzigingslijst voor elke release.

Ondersteuning zoeken

GitHub-problemen

Fouten en aanvraagfuncties melden op GitHub:

Documentation

Community

  • Stack Overflow: Tag vragen met mssql-python.
  • GitHub-discussies: Gebruik voor algemene vragen en discussies.

Verwante onderwerpen

  • Last updated on