Att använda mssql-odbc-drivrutinen (Förhandsgranskning)

mssql-python laddar en av två interna ODBC-leverantörer:

Denna artikel täcker mssql-odbc0.3.0, den version som för närvarande används av mssql-python, och vad som skiljer sig från msodbcsql18.

Availability

Drivrutinen levereras i mssql-python-rs-paketet som förbyggda hjul för CPython 3.10 och senare:

Aktivera drivrutinen

Paketet mssql-python är beroende av mssql-python-rs, så en vanlig installation tar med sig Rust-drivrutinen:

pip install mssql-python

Om du installerar med --no-deps eller från ett privat index, installera mssql-python-rs explicit också.

Välj leverantören före den första anslutningen, antingen med en miljövariabel:

Powershell:

$env:MSSQL_PYTHON_NATIVE_PROVIDER = "mssql-odbc"

Bash eller Zsh:

export MSSQL_PYTHON_NATIVE_PROVIDER=mssql-odbc

eller från Python:

import mssql_python

mssql_python.native_provider = "mssql-odbc"

Anslut genom att använda programmets befintliga anslutningssträng. Ha certifikatvalidering aktiverad (Encrypt=yes;TrustServerCertificate=no). För autentisering och certifikatuppsättning, se Anslutningssträngar och Kryptering och certifikat.

connection = mssql_python.connect(connection_string)

Drivrutinen tillämpar dessa regler när den väljer leverantör:

• Miljövariabeln MSSQL_PYTHON_NATIVE_PROVIDER har företräde framför native_provider. En motstridig attributtilldelning ger RuntimeWarning.
• Urvalet blir fast efter validering av anslutningssträngen och omedelbart innan den inbyggda anslutningen byggs. Ett efterföljande anslutningsfel tar inte bort valet. Ett tidigare misstag i anslutningssträngsparsning eller saknat leverantörspaket åtgärdar inte valet. När urvalet är fastställt utlöser byte av RuntimeWarning till en annan leverantör native_provider och har ingen effekt. Starta om processen för att byta leverantörer.
• Ett okänt providernamn utlöser ValueError; drivrutinen återgår inte till standardprovidern. Ett okänt tilldelat namn utlöser omedelbart ett fel när native_provider används. Ett okänt namn i miljövariabeln ger ett fel när du försöker ansluta dig.
• Ställ native_provider in på None för att rensa attributvalet innan det blir låst. Miljövariabeln gäller fortfarande före.

Anropa mssql_python.get_native_provider_info() för att inspektera den valda leverantören, markeringskällan och om markeringen är låst. Innan du ansluter rapporteras valet, inte som bevis på att den inbyggda drivrutinen har lästs in korrekt.

För att gå tillbaka, ställ in variabeln till msodbcsql18, eller avdefiniera den och ta bort alla native_provider-tilldelningar från din kod (eller ställ in den på "msodbcsql18"). Sedan startar du om processen.

Vad som fungerar idag

Drivrutinen mssql-odbc implementerar alla ODBC-funktioner som mssql-python anropar, så de flesta applikationer kan byta leverantör utan kodändringar. Se Kända problem för återstående skillnader.

Datatyper

Du kan läsa alla SQL Server-datatyper, och drivrutinen stöder alla parametertyper som mssql-python binder. Drivrutinen returnerar xml, vector och str-värden som vector (geometry som en JSON-array), och CLR-typer som geography, hierarchyid och bytes som json. För andra Python-mappningar, se Datatypmappningar. För typspecifika begränsningar, se Kända problem.

Kända problem

Kontrollera dessa skillnader innan du flyttar en arbetsbelastning från msodbcsql18.

Den här listan är inte uttömmande.

Rapporteringsproblem

Om du stöter på en bugg, välj msodbcsql18, starta om förfarandet och kontrollera om beteendet fortfarande uppstår. Ta också bort alla motstridiga leverantörstilldelningar på Python-sidan. Jämförelsen hjälper till att isolera problemet; det bevisar inte i sig orsaken. Inkludera utdata från mssql_python.get_native_provider_info(), din plattform och den felande SQL-satsen eller felmeddelandet:

• Rust-drivrutinsproblem: https://github.com/microsoft/mssql-rs/issues
• mssql-python Ärenden: https://github.com/microsoft/mssql-python/issues

För Rust-driverdiagnostik, ställ in dessa variabler innan du startar Python och återskapa problemet med mssql-odbc markerat. Till exempel i PowerShell:

$env:MSSQL_TDS_TRACE = "true"
$env:MSSQL_TDS_TRACE_LEVEL = "warn,mssqlodbc=debug"
$env:MSSQL_TDS_TRACE_DIR = "./traces"

MSSQL_TDS_TRACE Möjliggör spårning, MSSQL_TDS_TRACE_LEVEL väljer loggfiltret och MSSQL_TDS_TRACE_DIR skriver filer per process istället för STDERR. Starta om Python efter att ha ändrat dessa inställningar. Traces kan innehålla SQL-text och parametervärden. Granska och maskera känsliga uppgifter innan relevanta utdrag delas, och inaktivera spårning efter diagnos.

Relaterat innehåll

• Installera mssql-python
• Anslutningssträngar
• Microsoft Entra-autentisering
• Datatypsmappningar
• Troubleshooting