Instalowanie biblioteki mssql-python

Sterownik mssql-python jest oficjalnym sterownikiem Microsoft Python dla SQL Server, Azure SQL Database, Azure SQL Managed Instance oraz bazy danych SQL w Microsoft Fabric. Zainstaluj sterownik na Windows, Linux lub macOS, używając pip.

Wymagania wstępne

  • Sterownik wymaga Python 3.10 lub nowszego i nie obsługuje wcześniejszych wersji Python.
  • menedżer pakietów pip (dołączony do Python 3.4+).

Important

Sterownik mssql-python wykorzystuje DDBC (Direct Database Connectivity), które łączy i zarządza warstwą ODBC wewnętrznie. Nie musisz osobno instalować sterownika Microsoft ODBC dla SQL Server.

Instalacja z PyPI

Zainstaluj sterownik za pomocą pip:

pip install mssql-python

Aby uaktualnić istniejącą instalację:

pip install --upgrade mssql-python

Aby zainstalować określoną wersję:

pip install mssql-python==1.11.0

Weryfikowanie instalacji

Po instalacji sprawdź, czy sterownik działa:

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

Oczekiwane dane wyjściowe:

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

Uwagi specyficzne dla platformy

Windows

Sterownik jest dostarczany jako wstępnie zbudowany pakiet wheel, który zawiera wszystkie niezbędne składniki.

Linux

Sterownik wymaga określonych bibliotek systemowych do uwierzytelniania Kerberos i dynamicznego ładowania. Zainstaluj je za pomocą menedżera pakietów w twojej dystrybucji:

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

W systemie RHEL 8 i innych dystrybucjach zgodnych z glibc 2.28 (AlmaLinux 8, Rocky Linux 8) sterownik instaluje się ze standardowego pakietu manylinux_2_28 wheel opublikowanego w PyPI.

Alpine Linux:

apk add libltdl krb5-libs

macOS

Sterownik jest dostępny jako gruby universal2 binarny plik natywny zarówno na Apple Silicon (arm64), jak i Intel (x86_64) Macach. Nie potrzebujesz osobnej instalacji unixODBC.

Sterownik wymaga OpenSSL. Zainstaluj ją za pomocą Homebrew:

brew install openssl

Jeśli napotkasz błędy związane z SSL, upewnij się, że OpenSSL jest prawidłowo połączone:

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

Środowiska wirtualne

Aby uniknąć konfliktów, instaluj pakiety Python w środowisku wirtualnym:

# 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

Instalacja rozwojowa

Aby zainstalować sterownik wraz z zależnościami programistycznymi do prac nad nim:

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

Rozwiązywanie problemów z instalacją

Instalacja PIP nie udaje się przy "braku dopasowania dystrybucji"

Upewnij się, że używasz Python 3.10 lub nowszy:

python --version

Jeśli używasz starszej wersji Python, zaktualizuj Python lub użyj Pyenv do zarządzania wieloma wersjami.

Błąd importu po instalacji

Jeśli zobaczysz ModuleNotFoundError: No module named 'mssql_python', sprawdź, czy używasz tego samego środowiska Python, w którym zainstalowałeś pakiet.

pip show mssql-python

Błędy uprawnień na Linux/macOS

Jeśli napotkasz błędy uprawnień, unikaj używania sudo pip. Zamiast tego użyj środowiska wirtualnego lub flagi --user .

pip install --user mssql-python

Treści powiązane

  • Last updated on