Wat is er nieuw in mssql-python

Dit artikel vermeldt wat er veranderd is in elke release van de mssql-python driver, eerst de nieuwste. Elke sectie behandelt nieuwe functies, gedragswijzigingen en bugfixes voor één versie.

Voor de versies die Microsoft momenteel ondersteunt, zie Support-levenscyclus.

mssql-python 1.14.0

Releasedatum: augustus 2026

Enhancements

Parameterdetectie en binding worden uitgevoerd in native code

Detectie van parametertypen en binding worden nu uitgevoerd in één natieve pijplijn in plaats van via afzonderlijke Python-aanroepen per parameter. Deze wijziging lost een belangrijke prestatiebottleneck op, met hogere end-to-end doorvoerverbeteringen bij grotere operaties zoals bulkinserts. Er is geen wijziging van de applicatie nodig.

Fouten opgelost

Het argument timeout voor connect() stelt de querytimeout in in plaats van de authenticatietimeout

Het timeout argument bepaalt SQL_ATTR_LOGIN_TIMEOUT en begrenst nu de authenticatiepoging, wat de naam van het argument en de documentatie beschrijven. In eerdere versies werd dit de querytime-out per instructie, zodat connect(timeout=30) niet beperkte hoe lang een verbindingspoging kon duren, en query's na 30 seconden afbrak. De query-time-out per instructie blijft beschikbaar als de eigenschap Connection.timeout.

Voor meer informatie, zie Verbindingstimeout.

bulkcopy() afgewezen timeout=0

Een timeout van 0 veroorzaakte een validatiefout, ook al betekent 0 dat er geen time-out is in de onderliggende bulk copy-API. De methode accepteert 0 nu en schakelt de time-out uit voor de operatie. Negatieve, niet-gehele en booleaanse waarden worden nog steeds afgewezen.

Voor meer informatie, zie Bulk copy.

Cleanup verving de oorspronkelijke Arrow fetch-uitzondering

Wanneer het ophalen via een Arrow-reader mislukte, veroorzaakte het opschoonpad van de driver een tweede foutmelding die de oorspronkelijke fout verving, waardoor de aanroepende code een opschoonfout te zien kreeg in plaats van de reden waarom het ophalen was mislukt. Cleanup controleert nu eerst de cursorstatus en behoudt de oorspronkelijke uitzondering.

executemany() fouten bij decimale conversie inclusief parameterwaarden

Een fout bij de conversie van een decimale waarde in executemany() meldde de problematische waarde via de onderliggende uitzondering, waardoor klantgegevens in applicatielogs en monitoringsystemen terecht konden komen. De fout rapporteert nu alleen de rijindex, de kolomindex en het waardetype.

Zie Foutafhandeling voor meer informatie.

Bulk kopiëren van Arrow View-typen geweigerd

bulkcopy_arrow() kon geen Arrow View-arrays met variabele lengte verwerken, dus moesten Polars-string_viewkolommen eerst worden omgezet met DataFrame.to_arrow() String View-waarden en NULLs gaan nu rechtstreeks via de Arrow C Data Interface.

Voor meer informatie, zie Polars-integratie.

Het laden van Windows-extensies gebruikte de host-CPU-architectuur

Op Windows koos de driver zijn native extensie op basis van de host-CPU in plaats van de draaiende interpreter, dus x64 Python op een ARM64-host laadde via een fallbackpad en schreef meldingen naar stdout. De loader haalt nu de architectuur af van de interpreter en rapporteert de fallbacks als waarschuwingen.

mssql-python 1.13.0

Releasedatum: augustus 2026

Enhancements

De binaire bestanden van het ODBC-stuurprogramma zijn alleen beschikbaar in mssql-python-odbc

Versie 1.13.0 verwijdert de libs/ fallback van het mssql-python wiel en verklaart mssql-python-odbc==18.6.2.1 in install_requires. Het commando pip install mssql-python levert nog steeds een werkende driver op. Installeer mssql-python-odbc expliciet als je met --no-deps installeert, of vanuit een privé-index die deze niet spiegelt.

Zie Installatie voor meer informatie.

Bulkkopiëren vanuit Apache Arrow-bronnen

De nieuwe cursor.bulkcopy_arrow() methode laadt data die al in Apache Arrow-formaat is, zonder eerst elke rij om te zetten in Python-objecten. Het doorgeven van een Arrow-bron aan bulkcopy() veroorzaakt nu TypeError.

Raadpleeg voor meer informatie Apache Arrow-integratie en Bulk copy.

token_providerparameter voor Microsoft Entra-credentials

De connect()-functie en de Connection-klasse accepteren een token_provider-argument, dus je kunt een referentieobject zoals DefaultAzureCredential doorgeven in plaats van een verificatiemodus op te geven in de verbindingsreeks. Het argument kan niet samen worden gebruikt met het trefwoord Authentication en met tokens die via attrs_before worden doorgegeven, en ondersteunt alleen het bereik van de commerciële Azure-cloud.

Zie Microsoft Entra-verificatie voor meer informatie.

Identiteitsbewuste verbindingspooling

De verbindingspool scheidt nu verbindingen op basis van Microsoft Entra-identiteit. In eerdere versies was de pool alleen gebaseerd op de verbindingsreeks, dus kon deze een verbinding die voor één gebruiker was geauthenticeerd toewijzen aan een verzoek van een andere gebruiker. De driver verkrijgt ook alleen een token wanneer een verbindingsverzoek niet uit de pool kan worden afgehandeld, en vernieuwt een gepoolde verbinding wanneer het token daarvan binnen 5 minuten verloopt.

Voor meer informatie, zie Connection pooling.

Fouten opgelost

executemany() voegde geen rijen in als NULL-waarden na de eerste rij voorkwamen

Een executemany()-aanroep waarbij numerieke waarden die niet NULL waren en NULL-waarden werden gemengd, voegde geen rijen in en wierp geen uitzondering op wanneer de eerste NULL pas na de eerste rij voorkwam. Dit gedrag beïnvloedde de parameters van tinyint, smallint, int en float . De driver initialiseert nu ODBC-indicatoren voor elke numerieke parameter met vaste breedte vóór de uitvoering van de array.

Een SQL_WVARCHAR uitvoeromzetter transformeerde niet-stringkolommen

Het registreren van een enkele stringomzetter transformeerde ook int-, decimale en datumwaarden , omdat de driver terugviel op de SQL_WVARCHAR omzetter voor elke kolom zonder eigen omzetter. De driver gebruikt die fallback nu alleen wanneer het gemapte Python-type str van de kolom of bytesis.

Output-converters die op basis van een integer-SQL-typecode waren geregistreerd, werden nooit uitgevoerd

Converters geregistreerd met een integer SQL-typecode, zoals SQL_DECIMAL, werden opgeslagen maar nooit aangeroepen, omdat de driver alleen op het Python-type in cursor.descriptiondispatchte. De driver dispatcht nu eerst de integercode, daarna het Python-type, en vervolgens de SQL_WVARCHAR fallback.

Raadpleeg voor meer informatie Aangepaste typeconverters.

Het sluiten van een Arrow-lezer gaf de server-sidecursor niet vrij

Het sluiten van een Arrow-lezer liet de cursor aan serverzijde toegewezen en de bovenliggende Cursor in een inconsistente toestand achter, omdat cursor.arrow_reader() een ruwe pyarrow.RecordBatchReader retourneerde. De methode geeft nu een wrapper terug waarvan de close() methode de server-side cursor loslaat en de cursorstatus reset, en de wrapper werkt als contextmanager.

Voor meer informatie, zie Apache Arrow-integratie.

Een gedeeltelijk geïnitialiseerde cursor werd omhoog AttributeError gebracht in Cursor.__del__

Een cursor waarvan de initialisator faalde, gaf een AttributeError als niet-ophaalbare uitzondering tijdens de afvalverzameling.

Cursor.__init__ werd gegenereerd voordat het de attributen closed en hstmt instelde, die __del__ vervolgens probeerde te lezen. De initializer stelt nu beide attributen in vóór elke code die kan worden opgeroepen, en __del__ beschermt zijn loggingsaanroep zodat deze veilig blijft tijdens het afsluiten van de interpreter.

mssql-python 1.12.0

Releasedatum: juli 2026

Enhancements

Losstaand mssql-python-odbc aanvullend pakket

De ODBC-driver-binaries worden nu afzonderlijk gepubliceerd als mssql-python-odbc, een data-only companion package die vastgepind is aan versie 18.6.2. Je hoeft geen code te wijzigen, want pip install mssql-python het bijbehorende pakket wordt erbij geïnstalleerd. De systeemeigen loader geeft de voorkeur aan het bijbehorende pakket en valt terug op de binaire bestanden die in de mssql-python wheel zijn gebundeld als dat niet aanwezig is.

Zie Installatie voor meer informatie.

Fouten opgelost

cursor.bulkcopy() gebruikt nu de verbindingstimeout van de ouderverbinding

bulkcopy() gebruikt nu de Connect-timeout van de ouderverbinding, die je instelt met connect(..., timeout=<seconds>). Voorheen gebruikte de aparte verbinding die bulkcopy opent een hardgecodeerde verbindingstimeout van 15 seconden die je niet kon overschrijven in Python. Een ouderverbinding die met timeout=0 wordt aangemaakt krijgt nog steeds de standaard 15 seconden.

Voor meer informatie, zie Bulk copy.

cursor.bulkcopy() ondersteunt CLR-door de gebruiker gedefinieerde typekolommen

cursor.bulkcopy() mislukte eerder met Protocol Error: Unsupported TDS type for bulk copy: 0xF0 voor elke doelkolom die een door de gebruiker gedefinieerd Common Language Runtime-type (CLR) gebruikte, inclusief de ingebouwde typen geography, geometry en hierarchyid. De driver wijst CLR UDT-kolommen nu op protocolniveau toe aan varbinary(max) en streamt de door jou aangeleverde bytes als IBinarySerialize-payload van de UDT. De oplossing zit in mssql_py_core 0.1.7.

Voor meer informatie, zie Bulk copy en Data type mappings.

mssql-python 1.11.0

Releasedatum: juli 2026

Enhancements

Verbeterde contextmanager-semantiek

with connection: bevestigt nu de transactie wanneer het blok zonder fouten wordt afgesloten, en draait deze terug wanneer een uitzondering het blok verlaat.

Zie Transactiebeheer voor meer informatie.

Fouten opgelost

• Een GIL-deadlock in het ODBC-afbouwpad (conn.close() en cursor.close()) en in SQLDescribeParam voor parameters met de waarde None in SSH-tunnel- en in-process-forwarderconfiguraties opgelost.
• Vaste BINARY en VARBINARY NULL-parameters in tijdelijke tabellen en tabelvariabelen. Wanneer automatische typeresolutie faalt, geeft de driver nu een Python-waarschuwing met expliciete cursor.setinputsizes() richtlijnen.
• Probleem opgelost waarbij import mssql_python faalde op Apple Silicon bij een schone installatie (regressie in 1.8.0). De gebundelde ODBC dylib-afhankelijkheden zijn nu herschreven voor zowel arm64 en x86_64 architecturen.
• Er is een GIL-deadlock in de Rust-kern opgelost waardoor bulkkopieën vastliepen bij authenticatie met Authentication=ActiveDirectoryServicePrincipal.

mssql-python 1.10.0

Releasedatum: juni 2026

Enhancements

ActiveDirectoryServicePrincipal-ondersteuning voor bulkkopieën

cursor.bulkcopy() ondersteunt nu Authentication=ActiveDirectoryServicePrincipal, zodat je bulkgegevens kunt invoegen met Service Principal-referenties.

Voor meer informatie, zie Bulk copy en Microsoft Entra authenticatie.

Fouten opgelost

• Problemen met niet-ASCII-gegevens in het Arrow-ophaalpad voor VARCHAR en CHAR zijn opgelost.
• Vaste verbindingstime-outs tijdens bulkbelasting.

mssql-python 1.9.0

Releasedatum: juni 2026

Enhancements

Rijobjecten bulkkopiëren

cursor.bulkcopy() accepteert nu direct gehaalde Row objecten in plaats van handmatige tuple-conversie te vereisen.

Voor meer informatie, zie Bulk copy en Row objects.

Fouten opgelost

• Vaste wielverpakking, dus simdutf altijd statisch gekoppeld.
• Grote inserts opgelost in DECIMAL.
• Onjuiste typefallback voor NULL-parameters opgelost.
• Vaste uitzonderingen voor pickle en unpickle retourritten.
• Probleem opgelost in nextset(), zodat PRINT-berichten tussen resultaatsets heen behouden blijven.
• Probleem met de afhandeling van Row opgelost in het fallback-pad voor executemany() data-at-execution.
• Vaste typecontrole van de fetch-methode voor statische analysetools.

mssql-python 1.8.0

Releasedatum: mei 2026

Enhancements

ActiveDirectoryMSI-ondersteuning voor bulkkopieën

cursor.bulkcopy() ondersteunt nu Authentication=ActiveDirectoryMSI voor door het systeem toegewezen en door de gebruiker toegewezen beheerde identiteiten.

Voor meer informatie, zie Bulk copy en Microsoft Entra authenticatie.

Rijindexering met tekenreekssleutel

Je kunt nu rijwaarden bijvoorbeeld op kolomnaam row["col"]benaderen , naast positionele indexering en attribuuttoegang.

Voor meer informatie, zie Rijobjecten.

Upgrade van de meegeleverde ODBC-driver

De meegeleverde Microsoft ODBC-driver voor SQL Server werd bijgewerkt naar 18.6.2.1.

Fouten opgelost

• Problemen met de levensduur van het uitgestelde verbindingsattribuut in tokengebaseerde authenticatie opgelost.
• Herhaald parseren van verbindingsreeksen in het authenticatiepad is opgelost.
• Vaste executemany() type annotaties voor sequentie-invoer.

mssql-python 1.7.1

Releasedatum: mei 2026

Enhancements

Uitgebreide wieldekking en prestatieverbeteringen

Deze release omvat:

• RHEL 8-compatibele wielen.
• Gerestaureerde macOS Python 3.10 universal2 wielen.
• Verbeterde UTF-16-verwerking via simdutf.
• Geoptimaliseerd execute() hot pad.

Prestatie-impact: De batchuitvoeringsdoorvoer verbetert door hotpadoptimalisaties in de execute() methode.

Zie Installatie voor meer informatie.

Fouten opgelost

• Authenticatiefouten opgelost zodat ze DB-API uitzonderingen genereren mssql_python in plaats van RuntimeError.
• Verlengde GIL-release over het blokkeren van ODBC-uitvoering, fetch, transactie en verbindingsattribuutaanroepen.
• Problemen met executemany() opgelost wanneer decimale waarden van teken veranderen.
• Inconsistente decodering van CP1252 VARCHAR op verschillende platforms opgelost.
• cursor.bulkcopy()-fouten voor lege tekenreeksen in kolommen NVARCHAR(MAX) en VARCHAR(MAX) opgelost.

mssql-python 1.6.0

Releasedatum: april 2026

Enhancements

Op parser gebaseerde opschoning van verbindingsreeksen

Verbindingsstring-sanitatie gebruikt nu een parser in plaats van reguliere expressies, dus verbindingsreeksen die speciale tekens bevatten in wachtwoordvelden en versterkte waarden worden correct geparseerd.

Zie Verbindingsreeksen voor meer informatie.

Fouten opgelost

• GIL-release gerepareerd tijdens het blokkeren van ODBC-verbindingen en -ontkoppelingen.
• Crashproblemen met setinputsizes() en SQL_DECIMAL hints SQL_NUMERIC opgelost.
• Onjuist fetchone() gedrag voor ODBC-catalogusmethoden is gecorrigeerd.
• Fouten met een ongeldige cursorstatus opgelost wanneer reset_cursor=False wordt gebruikt.
• Vaste executemany() type hints voor mapping-gebaseerde parameterreeksen.
• Een paddoorloopbeveiliging toegevoegd voor setup_logging(log_file_path=...).

mssql-python 1.5.0

Releasedatum: april 2026

Nieuwe functies

Ondersteuning voor het ophalen van Apache Arrow

Drie nieuwe cursormethoden bieden hoogpresterende kolomgegevensopvraging via de Arrow C Data Interface:

• cursor.arrow() geeft een volledige pyarrow.Table terug.
• cursor.arrow_batch() geeft een enkele pyarrow.RecordBatchterug.
• cursor.arrow_reader() geeft een pyarrow.RecordBatchReader terug voor streaming.

Deze methoden maken geen Python-object voor elke waarde. Voor volledige documentatie, zie Apache Arrow-integratie.

ondersteuning voor het type sql_variant

De driver detecteert sql_variant nu kolommen tijdens het ophalen, lost hun onderliggende basistype op en levert correct getypte Python-waarden terug in plaats van ruwe bytes.

Zie Toewijzingen van gegevenstypen voor meer informatie.

Ingebouwde UUID-ondersteuning

Een nieuwe native_uuid instelling bepaalt of UNIQUEIDENTIFIER kolommen worden teruggegeven als uuid.UUID objecten (standaard) of als pyodbc-compatibele hoofdletterstrings. Configureer het op moduleniveau of per verbinding.

Voor meer informatie, zie Moduleconfiguratie.

Rijklasse openbare export

De Row klasse wordt nu op het hoogste niveau geëxporteerd voor type-annotaties.

Voor meer informatie, zie Rijobjecten.

Fouten opgelost

• Opgelost: onjuiste detectie van ? binnen tussen vierkante haken geplaatste identifiers, stringliteralen en commentaar.
• Vaste NULL-parameterbinding voor VARBINARY kolommen (veroorzaakt geen impliciete conversiefouten meer).
• Vaste datetime.time waarden waarbij microseconden verloren gaan bij retouren voor TIME(1) doorgaande TIME(7) kolommen.
• Ophaalpad voor Arrow gecorrigeerd zodat fracties van seconden correct worden opgenomen voor TIME-kolommen.
• Opgeloste bulkkopie met Microsoft Entra ID-authenticatiemethoden (verouderde inloggegevens veroorzaken geen validatiefouten meer).
• Azure Identity-credential-instanties op moduleniveau gecachet voor verbeterde authenticatieprestaties.

mssql-python 1.4.0

Releasedatum: februari 2026

Nieuwe functies

Ondersteuning voor bulkkopieën

Het snel laden van bulkgegevens is nu beschikbaar via cursor.bulkcopy(). De methode accepteert opties voor batch_size, timeout, , column_mappings, keep_identity, check_constraints, table_lockkeep_nulls, , fire_triggers, en use_internal_transaction.

Voor meer informatie, zie Bulk copy.

Improvements

• Prestatieoptimalisaties voor grote resultatensets.
• Verminderd geheugengebruik tijdens batchbewerkingen.
• Verbeterde foutmeldingen voor mislukte bulk-kopieeracties.

mssql-python 1.3.0

Releasedatum: januari 2026

Nieuwe functies

Settings-klasse

Configureer module-breed gedrag via de nieuwe Settings klasse, die de lowercase instelling voor kolomnamen in cursor.descriptionbevat.

Voor meer informatie, zie Moduleconfiguratie.

Improvements

• Betere afhandeling van verbindingstimeout tijdens Azure SQL failover.
• Verbeterde compatibiliteit met Python 3.13.

mssql-python 1.2.0

Releasedatum: januari 2026

Nieuwe functies

Methoden voor schema-ontdekking

Nieuwe cursormethoden verkennen databasemetadata: tables(), , , primaryKeys(), procedures()foreignKeys(), , statistics(), en getTypeInfo()columns().

Voor meer informatie, zie Schema discovery.

Improvements

• Verbeterde metadata-caching voor herhaalde schema-query's.
• Betere verwerking van berekende kolommen in columns()-resultaten.

mssql-python 1.1.0

Releasedatum: december 2025

Nieuwe functies

Aangepaste uitgangsomzetters

Registreer aangepaste functies om kolomwaarden tijdens het ophalen te transformeren, met add_output_converter(), get_output_converter(), , remove_output_converter()en clear_output_converters().

Raadpleeg Aangepaste typeconverters voor meer informatie.

Improvements

• Betere foutmeldingen voor mislukte typeconversies.
• Ondersteuning voor converterfuncties die None retourneren.

mssql-python 1.0.0

Releasedatum: november 2025

Eerste GA-release

De eerste algemene beschikbaarheidsrelease van mssql-python, Microsoft's native Python-driver voor SQL Server.

Voor meer informatie, zie mssql-python driver.

Kernfuncties

• DDBC-architectuur: Directe databaseconnectiviteit zonder ODBC-driverinstallatie te vereisen.
• DB-API 2.0-conformiteit: Standaard Python database-interface.
• Verbindingspooling: Ingebouwd beheer van de verbindingspool.
• Microsoft Entra-authenticatie: Volledige ondersteuning voor Azure-identiteitsgebaseerde authenticatie.
• TLS-encryptie: Beveiligde verbindingen met certificaatvalidatie.

Verbindingsmogelijkheden

• 21 verbindingsreeks-zoekwoorden.
• 9 authenticatiemodi (SQL, Windows en 7 Microsoft Entra ID-methoden).
• Autocommitbeheer.
• Uitvoeringsmethoden: execute(), executemany(), en batch_execute().
• Verbindingsattributen via set_attr() en getinfo().
• Ondersteuning voor contextmanagers.

Cursorkenmerken

• Standaard fetchmethoden: fetchone(), fetchmany(), . fetchall()
• Uitgebreide methoden: fetchval(), skip().
• Uitvoeringsmethoden: execute() en executemany().
• Rijobjecten met attribuut- en indextoegang.
• Navigatie met meerdere resultaatsets met nextset().

Ondersteuning voor gegevenstypen

• Alle systeemeigen typen van SQL Server.
• Python↔SQL-typetoewijzingen.
• SQL-typeconstanten voor expliciete typering (bijvoorbeeld, mssql_python.SQL_DECIMAL).
• NULL-afhandeling als PythonNone.

Transactieondersteuning

• Handmatig vastleggen en terugdraaien.
• Autocommit-modus.
• Isolatieniveaucontrole.
• Deadlock-detectie en -hantering.

Verificatiemodi

Upgrade

Afkomstig van pyodbc

Voor gedetailleerde migratierichtlijnen, zie Migreren van pyodbc.

Belangrijkste verschillen:

• Zowel ? (qmark) als %(name)s (pyformat) parameterstijlen worden ondersteund. Je bestaande ? queries werken zonder wijzigingen.
• Geen methode callproc() . Gebruik EXECUTE in plaats daarvan statements.
• Ingebouwde verbindingspooling.
• Geen externe ODBC-driverafhankelijkheid.

Uit pymssql

Voor gedetailleerde migratierichtlijnen, zie Migreren van pymssql.

Belangrijkste verschillen:

• Vervang de parameteraanduidingen %s en %d door ? of %(name)s.
• Gebruik een verbindingsreeks in plaats van positionele argumenten.
• Geen FreeTDS-afhankelijkheid.
• Meerdere gelijktijdige cursors per verbinding.
• Rijobjecten met attribuuttoegang vervangen as_dict=True.

Tussen versies van mssql-python

Upgrade de driver om nieuwe functies en oplossingen te krijgen.

pip install --upgrade mssql-python

Bekijk de release notes op eventuele breaking changes voordat je de productiesystemen upgradet.

Roadmap

Voor aankomende functies en de ontwikkelingsroute, zie de GitHub-repository.

Verwante onderwerpen

• Microsoft Python Driver voor SQL Server - mssql-python
• Ondersteuningslevenscyclus voor mssql-python
• Installeer mssql-python
• GitHub releases