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. Le pilote est activement maintenu sur GitHub et publié via PyPI. Cet article traite du versionnement, de la compatibilité des plateformes et des délais de support.
Support de version
Utilisez toujours la dernière version pour obtenir de nouvelles fonctionnalités, des améliorations de performance et des corrections de sécurité. Les nouvelles fonctionnalités sont ajoutées uniquement à la version actuelle.
Version actuelle
La version 1.11.0 est la version actuelle en disponibilité générale (GA).
Historique des versions
| Version | Date de sortie | Status | Principales fonctionnalités |
|---|---|---|---|
| 1.11.0 | Juillet 2026 | Actuel | Validation/annulation du gestionnaire de contexte, correction pour Apple Silicon, correction de la copie en masse du principal de service |
| 1.10.0 | Juin 2026 | Previous | Copie en bloc avec ActiveDirectoryServicePrincipal, correctifs pour Arrow VARCHAR |
| 1.9.0 | Juin 2026 | Previous | Copie en bloc avec des objets Row, amélioration du type des paramètres NULL |
| 1.8.0 | Mai 2026 | Previous | Copie en bloc avec ActiveDirectoryMSI, indexation des lignes par clé de chaîne |
| 1.7.1 | Mai 2026 | Previous | RHEL 8 roues, concurrence plus large et corrections Unicode |
| 1.6.0 | Avril 2026 | Previous | Assainissement des chaînes de connexion par l’analyseur, correctifs de concurrence pour la connexion/déconnexion |
| 1.5.0 | Avril 2026 | Previous | Collecte de flèches, sql_variant, UUID natif |
| 1.4.0 | Février 2025 | Previous | Support de la copie en masse (BCP) |
| 1.3.0 | Janvier 2025 | Previous | classe de paramètres, configuration du module |
| 1.2.0 | Novembre 2024 | Previous | Méthodes de découverte de schéma |
| 1.1.0 | Septembre 2024 | Previous | Convertisseurs de sortie personnalisés |
| 1.0.0 | Juillet 2024 | Previous | Version initiale en disponibilité générale |
Important
Seule la version actuelle (1.11.0) reçoit de nouvelles fonctionnalités et des corrections de bugs. Les versions précédentes restent fonctionnelles mais ne reçoivent pas de mises à jour. Passez à la dernière version pour une expérience optimale.
compatibilité des versions Python
Le pilote mssql-python nécessite Python 3.10 ou une version ultérieure. Si vous commencez un nouveau projet, ciblez la dernière version Python prise en charge dans la matrice de compatibilité pour la fenêtre de support la plus longue. Si vous êtes limité à une version ancienne de Python (3.9 ou antérieure), utilisez pyodbc à la place.
| Version de Python | État de la prise en charge |
|---|---|
| Python 3.14 | Soutenu |
| Python 3.13 | Soutenu |
| Python 3.12 | Soutenu |
| Python 3.11 | Soutenu |
| Python 3.10 | Pris en charge (minimum) |
| Python 3.9 et versions antérieures | Non pris en charge |
Important
Utilisez toujours une version de Python prise en charge. Les versions antérieures Python ne reçoivent pas de mises à jour de sécurité.
compatibilité des versions SQL Server
Le pilote mssql-python utilise le protocole TDS et fonctionne avec toutes les versions de SQL Server activement prises en charge.
| Version de SQL Server | État de la prise en charge |
|---|---|
| Toutes les versions prises en charge de Microsoft SQL Server | Entièrement prise en charge |
Services SQL d'Azure
| Service | État de la prise en charge |
|---|---|
| Azure SQL Database | Entièrement prise en charge |
| Azure SQL Managed Instance (Instance gérée Azure SQL) | Entièrement prise en charge |
| Azure Synapse Analytics (pools dédiés) | Soutenu |
Microsoft Fabric
| Point de terminaison | État de la prise en charge |
|---|---|
| Base de données SQL dans Fabric | Entièrement prise en charge |
| Entrepôt de données Fabric | Soutenu |
| Point de terminaison d’analytique SQL (Lakehouse) | Soutenu |
| Point de terminaison d’analytique SQL (base de données mise en miroir) | Soutenu |
Compatibilité du système d’exploitation
Le pilote mssql-python utilise DDBC (Direct Database Connectivity) et ne nécessite pas l'installation du pilote Microsoft ODBC. La suppression de la dépendance externe simplifie le déploiement, en particulier dans les conteneurs et les pipelines CI/CD.
| Système d'exploitation | Architecture | État de la prise en charge |
|---|---|---|
| Windows 11 | x64, ARM64 | Soutenu |
| Windows Server 2019, 2022, 2025 | x64 | Soutenu |
| Ubuntu 22.04, 24.04, 26.04 | x64, ARM64 | Soutenu |
| Debian 11, 12 | x64, ARM64 | Soutenu |
| Red Hat Enterprise Linux 8, 9 | x64, ARM64 | Soutenu |
| macOS 14, 15, 26 | Intel, Apple Silicon (ARM64) | Soutenu |
| Alpine Linux | x64 | Soutenu |
Compatibilité des fonctionnalités
Les tableaux suivants listent les fonctionnalités de SQL Server et leur statut de support dans la version actuelle (1.11.0) du pilote mssql-python. Si une fonctionnalité dont vous avez besoin n’est pas prise en charge (comme Always Encrypted ou MARS), envisagez d’utiliser pyodbc à la place. Pour des informations sur les fonctionnalités ajoutées dans les versions antérieures, voir Nouveautés dans mssql-python.
fonctionnalités SQL Server
| Fonctionnalité | Prise en charge de mssql-python |
|---|---|
| Connexions chiffrées (TLS) | Soutenu |
| Toujours Chiffré | Non pris en charge |
| Authentification par Microsoft Entra | Soutenu |
| MARS (Multiple Active Result Sets) | Non pris en charge |
| Copie en bloc (BCP) | Soutenu |
| Récupération Apache Arrow | Soutenu |
| sql_variant Colonnes | Soutenu |
| UUID autochtone | Soutenu |
| Résilience des connexions | Soutenu |
| Routage en lecture seule | Soutenu |
Conformité à DB-API 2.0
| Fonctionnalité | Support |
|---|---|
| Interface de module | Compliant |
| Interface de connexion | Compliant |
| Interface de curseur | Principalement compliant |
| Objets types | Compliant |
| Exceptions | Compliant |
callproc() |
Non implémenté |
Note
La callproc() méthode n’est pas mise en œuvre. Appelez des procédures stockées à l’aide d’instructions EXECUTE et de méthodes de requête standard.
Exigences en matière de dépendance
Le pilote mssql-python a des dépendances minimales :
| Dépendance | Purpose | Version |
|---|---|---|
| azure-identity | Authentification par Microsoft Entra ID | Obligatoire (>= 1.12.0) |
Le pilote mssql-python ne nécessite pas d'installation du pilote Microsoft ODBC.
Migration depuis pyodbc
Le pilote mssql-python simplifie le déploiement (aucun pilote ODBC requis) et offre un pooling de connexions intégré. Les principales différences à prévoir lors de la migration :
| Considérations | Notes |
|---|---|
| Style de paramètre | PYODBC utilise qmark des paramètres de position. mssql-python utilise par défaut des paramètres nommés pyformat et prend également en charge qmark par souci de compatibilité. |
| Accès aux lignes | L’accès aux attributs est pris en charge dans les deux cas. |
| Procédures stockées | Utiliser EXECUTE (non callproc). |
| Regroupement de connexions | Pooling intégré dans le pilote mssql-python. |
Voir Migrer depuis pyodbc pour des conseils détaillés.
Migration depuis pymssql
Le pilote pymssql n’est plus maintenu activement. Le pilote mssql-python propose une alternative prise en charge avec une syntaxe de connexion similaire mais des fonctionnalités modernes comme le pooling de connexions intégré et l’authentification Microsoft Entra.
| Considérations | Notes |
|---|---|
| Dépendance FreeTDS | Non obligatoire. Le pilote mssql-python utilise DDBC. |
| Paramètres de connexion | Style similaire, mais noms de paramètres différents. |
| Accès aux lignes | Les deux prennent en charge les modes d’accès de type dictionnaire et par attribut. |
| Procédures stockées | Utiliser EXECUTE (non callproc). |
Voir Migrer depuis pymssql pour des conseils détaillés.
Politique relative aux modifications incompatibles
- Versions majeures (2.0, 3.0) : Les changements majeurs de version signifient des changements d’API en rupture.
- Versions mineures (1.4, 1.5) : Inclure de nouvelles fonctionnalités et maintenir la rétrocompatibilité.
- Versions correctives (1.4.1, 1.4.2) : Incluent uniquement les corrections de bugs.
L’équipe documente les changements de nouveauté dans les notes de version et fournit des guides de migration.
Comment rester en cours
Le pilote mssql-python publie fréquemment des versions mineures. Vérifiez régulièrement les mises à jour, surtout avant les déploiements en production.
Vérifier la version installée
Vérifiez quelle version du pilote est actuellement installée dans votre environnement :
import mssql_python
print(mssql_python.__version__)
Mettre à niveau vers la dernière version
Mettez à jour la dernière version pour obtenir les dernières fonctionnalités et correctifs de sécurité.
pip install --upgrade mssql-python
S’abonner aux mises à jour
- Surveillez le dépôt GitHub.
- Consultez PyPI pour les nouvelles versions.
- Consultez le journal des modifications pour chaque version.
Obtenir de l’aide
problèmes de GitHub
Signaler les bogues et les fonctionnalités de demande sur GitHub :
Documentation
Community
- Stack Overflow : Étiquetez les questions avec
mssql-python. - Discussions sur GitHub : Utilisez pour des questions générales et des discussions.