Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le pilote mssql-python est le pilote Python officiel de Microsoft pour SQL Server, Azure SQL Database, Azure SQL Managed Instance et SQL Database dans Microsoft Fabric. Installez le package sur Windows, Linux ou macOS en utilisant pip ou conda.
Logiciels requis
- Le pilote nécessite Python 3.10 ou une version ultérieure et ne prend pas en charge les versions antérieures de Python.
- Pour installer avec pip, utilisez le gestionnaire de paquets pip, qui est inclus avec Python.
- Pour installer avec le gestionnaire de paquets conda.
Important
Le pilote mssql-python utilise DDBC (Direct Database Connectivity), qui regroupe et gère en interne la couche ODBC. Vous n'avez pas besoin d'installer séparément le pilote Microsoft ODBC pour SQL Server.
Installer à partir de PyPI
Installez le pilote en utilisant pip :
pip install mssql-python
Pour mettre à niveau une installation existante :
pip install --upgrade mssql-python
Pour installer une version spécifique :
pip install mssql-python==1.16.0
La pip install mssql-python commande installe également deux paquets compagnons que le pilote nécessite à l’exécution :
-
mssql-python-odbcfournit les binaires Microsoft ODBC Driver 18. -
mssql-python-rslivre le runtime Rust qui alimente la copie en vrac et le fournisseur optionnelmssql-odbc.
À partir de la version 1.16.0, mssql-python épingle les versions exactes des deux paquets. Les versions antérieures ne nécessitent pas mssql-python-rs. Pour les pins par version, voir Exigences de dépendance.
Installer depuis conda
Le pilote est également disponible sur la microsoft chaîne Anaconda.org :
conda install -c microsoft mssql-python
Le package conda est autonome. Il inclut les liaisons Python, les binaires de pilotes ODBC et le runtime Rust, donc conda installe un seul paquet au lieu de trois. L’exécution pip list dans l’environnement affiche mssql-python-odbc toujours et mssql-python-rs, car le package conda inclut leurs métadonnées de package. Conda sélectionne le build qui correspond à votre plateforme et à la version Python, et gère les mises à jour :
conda update -c microsoft mssql-python
Installez le driver avec Conda ou Pip dans un environnement donné, pas les deux.
Le package conda contient les exigences suivantes de la plateforme :
| Platform | Versions de Python | Requirement |
|---|---|---|
| Windows x64 | 3.10 à 3.15 | Aucun. |
| Windows ARM64 | 3.12 à 3.15 | Aucun. |
| Linux x64, Linux ARM64 | 3.10 à 3.15 | glibc 2.34 et versions ultérieures. Utilisez pip sur Red Hat Enterprise Linux (RHEL) 8, Alpine Linux et d’autres distributions avec un glibc plus ancien ou avec musl. |
| macOS Intel, macOS Apple Silicon | 3.10 à 3.15 | macOS 15 et versions ultérieures. Les connexions chiffrées nécessitent qu’OpenSSL soit installé sur le système, comme décrit dans la documentation macOS. Le pilote ne charge pas OpenSSL depuis l’environnement Conda. |
Vérifier l’installation
Après l’installation, vérifiez que le pilote fonctionne :
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}")
Sortie attendue :
mssql-python version: 1.16.0
DB-API level: 2.0
Thread safety: 1
Parameter style: pyformat
Notes spécifiques à la plateforme
Windows
Le pilote est livré comme un wheel prédéfini qui comprend tous les composants nécessaires.
Linux
Le pilote nécessite certaines bibliothèques système pour l’authentification Kerberos et le chargement dynamique. Installez-les via le gestionnaire de paquets de votre 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
Sur RHEL 8 et d’autres distributions compatibles avec glibc 2.28 (AlmaLinux 8, Rocky Linux 8), le pilote s’installe depuis le wheel standard manylinux_2_28 publié sur PyPI.
Alpine Linux :
apk add libltdl krb5-libs libstdc++
macOS
Le pilote est fourni sous la forme d’un universal2 fat binaire qui s’exécute nativement à la fois sur les Mac Apple Silicon (arm64) et sur les Mac Intel (x86_64). Vous n’avez pas besoin d’une installation séparée d’unixODBC.
Le pilote nécessite OpenSSL. Installez-le en utilisant Homebrew :
brew install openssl
Si vous rencontrez des erreurs liées à SSL, assurez-vous qu’OpenSSL est correctement lié :
export LDFLAGS="-L/opt/homebrew/opt/openssl/lib"
export CPPFLAGS="-I/opt/homebrew/opt/openssl/include"
Environnements virtuels
Pour éviter les conflits, installez des paquets Python dans un environnement virtuel :
# 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
Installation de développement
Pour installer le pilote avec des dépendances de développement afin de contribuer au pilote :
git clone https://github.com/microsoft/mssql-python.git
cd mssql-python
pip install -e ".[dev]"
Résoudre des problèmes d’installation
L’installation de pip échoue avec l’erreur « aucune distribution correspondante »
Assurez-vous d'utiliser Python 3.10 ou une version ultérieure :
python --version
Si vous utilisez une version Python plus ancienne, mettez à jour Python ou utilisez pyenv pour gérer plusieurs versions.
Erreur d’importation après installation
Si vous voyezModuleNotFoundError: No module named 'mssql_python', vérifiez que vous utilisez le même environnement Python que celui où vous avez installé le paquet.
pip show mssql-python
Erreurs d’autorisation sur Linux/macOS
Si vous rencontrez des erreurs d’autorisation, évitez d’utiliser sudo pip. Utilisez plutôt un environnement virtuel ou le --user drapeau.
pip install --user mssql-python