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.

Předpoklady

  • Ovladač vyžaduje Python 3.10 nebo novější a nepodporuje starší verze Python.
  • správce balíčků pip (součástí Python 3.4+).

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

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

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

  • Last updated on