Instalace mssql-pythonu

Ovladač mssql-python je oficiální Microsoft Python ovladač pro SQL Server, Azure SQL Database, Azure SQL Managed Instance a SQL databázi v Microsoft Fabric. Nainstalujte ovladač na Windows, Linux nebo macOS pomocí pip nebo conda.

Předpoklady

  • Ovladač vyžaduje Python 3.10 nebo novější a nepodporuje starší verze Python.
  • Pro instalaci pomocí pip, správce balíčků, který je součástí Pythonu.
  • Pro instalaci použijte správce balíčků conda.

Important

Ovladač mssql-python používá DDBC (Direct Database Connectivity), který interně spravuje a zahrnuje vrstvu ODBC. Nemusíte instalovat Microsoft ODBC ovladač pro SQL Server zvlášť.

Instalace z PyPI

Nainstalujte ovladač pomocí pip:

pip install mssql-python

Aktualizace stávající instalace:

pip install --upgrade mssql-python

Instalace konkrétní verze:

pip install mssql-python==1.16.0

Příkaz pip install mssql-python také instaluje dva doprovodné balíčky, které ovladač vyžaduje za běhu:

  • mssql-python-odbcdodává binární soubory Microsoft ODBC Driver 18.
  • mssql-python-rs obsahuje runtime Rust, který pohání hromadné kopírování a volitelný poskytovatel mssql-odbc.

Od verze 1.16.0 mssql-python připíná oba balíčky na přesné verze. Starší verze nevyžadují mssql-python-rs. Pro piny podle verzí viz Požadavky na závislosti.

Nainstalovat pomocí conda

Ovladač je také dostupný v kanálu microsoft na Anaconda.org:

conda install -c microsoft mssql-python

Balíček conda je samostatný balíček. Zahrnuje Python bindings, binární soubory ovladačů ODBC a runtime Rust, takže conda instaluje jeden balíček místo tří. Běh pip list v prostředí stále ukazuje mssql-python-odbc a mssql-python-rs, protože balíček conda obsahuje metadata těchto balíčků. Conda vybírá verzi, která odpovídá vaší platformě a verzi Python, a spravuje upgrady:

conda update -c microsoft mssql-python

Nainstalujte balíček buď pomocí conda, nebo pip v daném prostředí, ne obojím.

Balíček Conda obsahuje tyto požadavky na platformu:

Platform Verze Pythonu Requirement
Windows x64 3.10 až 3.15 None.
Windows ARM64 3.12 až 3.15 None.
Linux x64, Linux ARM64 3.10 až 3.15 Glibc 2.34 a pozdější verze. Použijte pip v systému Red Hat Enterprise Linux (RHEL) 8, Alpine Linux a dalších distribucích se starším glibc nebo s muslem.
macOS Intel, macOS Apple Silicon 3.10 až 3.15 verze macOS 15 a novější. Šifrovaná připojení vyžadují nainstalovaný OpenSSL v systému, jak je popsáno v článku macOS. Ovladač nenačítá OpenSSL z prostředí conda.

Ověření instalace

Po instalaci ověřte, že ovladač funguje:

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

Očekávaný výstup:

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

Poznámky specifické pro platformu

Windows

Ovladač je dodáván jako předpřipravený balíček wheel, který obsahuje všechny potřebné součásti.

Linux

Ovladač vyžaduje určité systémové knihovny pro autentizaci a dynamické načítání pomocí Kerberos. Nainstalujte je pomocí správce balíčků vaší distribuce:

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

Na RHEL 8 a dalších distribucích kompatibilních s glibc 2.28 (AlmaLinux 8, Rocky Linux 8) se ovladač instaluje ze standardního manylinux_2_28 kolečka publikovaného pro PyPI.

Alpine Linux:

apk add libltdl krb5-libs libstdc++

macOS

Ovladač je dodáván jako tlustý universal2 binární soubor, který běží nativně jak na Mac Apple Silicon (arm64), tak Intel (x86_64). Nepotřebujete samostatnou instalaci unixODBC.

Ovladač vyžaduje OpenSSL. Nainstalujte ho pomocí Homebrew:

brew install openssl

Pokud narazíte na chyby související se SSL, ujistěte se, že je OpenSSL správně propojený:

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

Virtuální prostředí

Pro předejít konfliktům instalujte Python balíčky ve virtuálním prostředí:

# 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

Vývojová instalace

Chcete-li nainstalovat ovladač s vývojovými závislostmi pro přispívání k ovladači:

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

Řešení problémů s instalací

pip install selže s chybou „nenalezena žádná odpovídající distribuce“

Ujistěte se, že používáte Python 3.10 nebo starší:

python --version

Pokud používáte starší verzi Python, upgradujte Python nebo použijte Pyenv pro správu více verzí.

Chyba importu po instalaci

Pokud vidíte ModuleNotFoundError: No module named 'mssql_python', ověřte si, že používáte stejné Python prostředí, kde jste balíček nainstalovali.

pip show mssql-python

Chyby oprávnění na Linuxu/macOS

Pokud narazíte na chyby oprávnění, vyhněte se používání sudo pip. Místo toho použijte virtuální prostředí nebo vlajku --user .

pip install --user mssql-python

Související obsah

  • Poslední aktualizace v