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.

Förutsättningar

  • Drivrutinen kräver Python 3.10 eller senare och stöder inte tidigare Python-versioner.
  • pip-pakethanterare (ingår i Python 3.4+).

Important

mssql-python-drivrutinen använder DDBC (Direct Database Connectivity), som paketerar och hanterar ODBC-lagret internt. Du behöver inte installera Microsoft ODBC-drivrutinen för SQL Server separat.

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.11.0

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.11.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

Note

På RHEL 8 och andra glibc 2.28-kompatibla distributioner (AlmaLinux 8, Rocky Linux 8) installeras drivrutinen från standardhjulet manylinux_2_28 som publicerats till PyPI.

Alpine Linux:

apk add libltdl krb5-libs

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

  • Last updated on