Installer mssql-python

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 pilote sur Windows, Linux ou macOS en utilisant pip.

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.
• gestionnaire de paquets pip (inclus avec Python 3.4+).

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

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.11.0
DB-API level: 2.0
Thread safety: 1
Parameter style: pyformat

Notes spécifiques à la plateforme

Windows

Le conducteur est livré comme une roue préassemblée 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

Alpine Linux :

apk add libltdl krb5-libs

macOS

Le pilote est fourni sous la forme d’un universal2 binaire universel 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 « 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

Contenu connexe

• Démarrage rapide : Connectez-vous et interrogez
• Informations de référence sur les chaînes de connexion
• Dépôt GitHub mssql-python