Installera mssql-python

Drivrutinen mssql-python är Microsoft officiella Python-drivrutin för SQL Server, Azure SQL Database, Azure SQL Managed Instance och SQL database i Microsoft Fabric. Installera drivrutinen på Windows, Linux eller macOS genom att använda pip eller conda.

Förutsättningar

• Drivrutinen kräver Python 3.10 eller senare och stöder inte tidigare Python-versioner.
• Om du vill installera med pip, använd pakethanteraren pip, som ingår i Python.
• För att installera med conda använder du pakethanteraren conda.

Installera från PyPI

Installera drivrutinen med pip:

pip install mssql-python

Så här uppgraderar du en befintlig installation:

pip install --upgrade mssql-python

Så här installerar du en specifik version:

pip install mssql-python==1.16.0

Kommandot pip install mssql-python installerar också två följeslagarpaket som drivrutinen kräver vid körning:

• mssql-python-odbc innehåller Microsoft ODBC Driver 18-binärfiler.
• mssql-python-rs innehåller Rust-runtime som driver bulkkopiering och opt-in-leverantören mssql-odbc.

Från och med version 1.16.0 låser mssql-python exakta versioner av båda paketen. Tidigare versioner kräver inte mssql-python-rs. För pins per version, se Beroendekrav.

Installera från conda

Drivrutinen finns också tillgänglig på microsoft-kanalen på Anaconda.org:

conda install -c microsoft mssql-python

conda-paketet är ett självförsörjande paket. Den inkluderar Python-bindningarna, ODBC-drivrutinsbinärerna och Rust-runtime, så conda installerar ett paket istället för tre. När man kör pip list i miljön visas mssql-python-odbc fortfarande och mssql-python-rs, eftersom Conda-paketet inkluderar deras paketmetadata. Conda väljer den build som matchar din plattform och Python-version, och hanterar uppgraderingar:

conda update -c microsoft mssql-python

Installera drivrutinen med antingen Conda eller Pip i en given miljö, inte båda.

Conda-paketet har dessa plattformskrav:

Kontrollera installationen

Efter installationen, kontrollera att drivrutinen fungerar:

import mssql_python

print(f"mssql-python version: {mssql_python.__version__}")
print(f"DB-API level: {mssql_python.apilevel}")
print(f"Thread safety: {mssql_python.threadsafety}")
print(f"Parameter style: {mssql_python.paramstyle}")

Förväntat resultat:

mssql-python version: 1.16.0
DB-API level: 2.0
Thread safety: 1
Parameter style: pyformat

Plattformsspecifika anteckningar

Windows

Föraren levereras som ett färdigbyggt hjul som inkluderar alla nödvändiga komponenter.

Linux

Drivrutinen kräver vissa systembibliotek för Kerberos-autentisering och dynamisk laddning. Installera dem med din distributions pakethanterare:

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install libltdl7 libkrb5-3 libgssapi-krb5-2

Red Hat/CentOS/Fedora:

sudo dnf install libtool-ltdl krb5-libs

Alpine Linux:

apk add libltdl krb5-libs libstdc++

macOS

Drivrutinen levereras som en universal2 tjock binär fil som körs nativt på både Apple Silicon (arm64) och Intel (x86_64) Macs. Du behöver inte en separat unixODBC-installation.

Drivrutinen kräver OpenSSL. Installera det med Homebrew:

brew install openssl

Om du stöter på SSL-relaterade fel, se till att OpenSSL är korrekt länkat:

export LDFLAGS="-L/opt/homebrew/opt/openssl/lib"
export CPPFLAGS="-I/opt/homebrew/opt/openssl/include"

Virtuella miljöer

För att undvika konflikter, installera Python-paket i en virtuell miljö:

# Create a virtual environment
python -m venv .venv

# Activate it (Windows)
.venv\Scripts\activate

# Activate it (Linux/macOS)
source .venv/bin/activate

# Install the driver
pip install mssql-python

Utvecklingsinstallation

För att installera drivrutinen med utvecklingsberoenden om du vill bidra till drivrutinen:

git clone https://github.com/microsoft/mssql-python.git
cd mssql-python
pip install -e ".[dev]"

Felsöka installationsproblem

PIP-installationen misslyckas med "ingen matchande distribution"

Se till att du använder Python 3.10 eller senare:

python --version

Om du använder en äldre Python-version, uppgradera Python eller använd pyenv för att hantera flera versioner.

Importfel efter installation

Om du serModuleNotFoundError: No module named 'mssql_python', kontrollera att du använder samma Python-miljö där du installerade paketet.

pip show mssql-python

Behörighetsfel på Linux/macOS

Om du stöter på behörighetsfel, undvik att använda sudo pip. Använd istället en virtuell miljö eller flaggan --user .

pip install --user mssql-python

Relaterat innehåll

• Snabbstart: Ansluta med drivrutinen mssql-python för Python
• Anslutningssträngar för mssql-python
• mssql-python GitHub-repositorium