Installieren von mssql-python

Der Treiber mssql-python ist Microsoft offizieller Python-Treiber für SQL Server, Azure SQL-Datenbank, Azure SQL Managed Instance und SQL Database in Microsoft Fabric. Installiere den Treiber unter Windows, Linux oder macOS mit pip.

Voraussetzungen

  • Der Treiber benötigt Python 3.10 oder neuer und unterstützt keine früheren Python-Versionen.
  • pip-Paketmanager (enthalten mit Python 3.4+).

Important

Der mssql-python-Treiber verwendet DDBC (Direct Database Connectivity), das die ODBC-Schicht intern bündelt und verwaltet. Du musst den Microsoft ODBC-Treiber für SQL Server nicht separat installieren.

Installieren über PyPI

Installieren Sie den Treiber mit Pip:

pip install mssql-python

So aktualisieren Sie eine vorhandene Installation:

pip install --upgrade mssql-python

So installieren Sie eine bestimmte Version

pip install mssql-python==1.11.0

Überprüfen der Installation

Nach der Installation überprüfen Sie, ob der Treiber funktioniert:

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}")

Erwartete Ausgabe:

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

Plattformspezifische Hinweise

Windows

Der Treiber wird als vorkompiliertes Wheel bereitgestellt, das alle notwendigen Komponenten enthält.

Linux

Der Treiber benötigt bestimmte Systembibliotheken für Kerberos-Authentifizierung und dynamisches Laden. Installiere sie mit dem Paketmanager deiner Distribution:

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

Unter RHEL 8 und anderen mit glibc 2.28 kompatiblen Distributionen (AlmaLinux 8, Rocky Linux 8) wird der Treiber aus dem auf PyPI veröffentlichten Standard-manylinux_2_28-Wheel installiert.

Alpine Linux:

apk add libltdl krb5-libs

macOS

Der Treiber wird als universal2 dicker Binärcode ausgeliefert, der sowohl auf Apple Silicon (arm64) als auch auf Intel (x86_64) Macs nativ läuft. Du brauchst keine separate unixODBC-Installation.

Der Treiber benötigt OpenSSL. Installieren Sie es mit Homebrew:

brew install openssl

Wenn Sie auf SSL-bezogene Fehler stoßen, stellen Sie sicher, dass OpenSSL korrekt verknüpft ist:

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

Virtuelle Umgebungen

Um Konflikte zu vermeiden, installieren Sie Python-Pakete in einer virtuellen Umgebung:

# 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

Entwicklungsinstallation

Um den Treiber mit Entwicklungsabhängigkeiten für die Mitarbeit am Treiber zu installieren:

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

Beheben von Installationsproblemen

`pip install` schlägt mit „keine passende Distribution“ fehl

Stellen Sie sicher, dass Sie Python 3.10 oder neuere verwenden:

python --version

Wenn du eine ältere Python-Version verwendest, upgrade Python oder nutze pyenv, um mehrere Versionen zu verwalten.

Importfehler nach der Installation

Wenn du siehstModuleNotFoundError: No module named 'mssql_python', überprüfe, dass du dieselbe Python-Umgebung verwendest, in der du das Paket installiert hast.

pip show mssql-python

Berechtigungsfehler auf Linux/macOS

Wenn Sie auf Berechtigungsfehler stoßen, vermeiden Sie die Verwendung von sudo pip. Verwenden Sie stattdessen eine virtuelle Umgebung oder die Flagge --user .

pip install --user mssql-python

Verwandte Inhalte

  • Last updated on