Nouveautés chez Microsoft. Data.SqlClient

Microsoft. Data.SqlClient est livré indépendamment de .NET. Cet article résume les fonctionnalités significatives, les changements de comportement et les changements de compatibilité de chaque gamme de sortie. Les tableaux de publication incluent toutes les publications de paquets stables, y compris chaque correctif urgent et chaque paquet non répertorié. Pour chaque correction et mise à jour de dépendance, consultez les notes de version complètes dans le dépôt SqlClient.

Versions actuelles

N’utilisez pas les versions de prévisualisation en production. Les API et comportements des prévisualisations peuvent changer avant la disponibilité générale (GA).

Les tableaux de sortie et les résumés de disponibilité générale utilisent le mois de publication NuGet. L’article sur le cycle de vie liste les dates officielles de sortie, qui peuvent différer. Pour les fenêtres de support, voir le cycle de vie du support des pilotes SqlClient.

version préliminaire 7.1

La version préliminaire 7.1 étend le traitement par lots, la découverte de schémas, la mise en pool de connexions et les API Always Encrypted. Les changements jusqu’à la version 7.1.0-preview3 incluent :

• SqlBatchprise en charge sur .NET Framework.
• Surcharges asynchrones SqlConnection.GetSchemaAsync .
• Aliases de chaînes de connexion telles que ColumnEncryption, ConnectTimeout, FailoverPartner, PacketSize, et WorkstationId.
• Mappages de pseudo-colonnes SQL Graph pour $node_id, $edge_id, $from_id et $to_id dans SqlBulkCopy.
• Application facultative du délai d’inactivité de la connexion.
• Un mode de délai d’attente de connexion volontaire qui inclut le temps passé à attendre une connexion regroupée.
• Poursuite du développement du pool de connexions expérimental basé sur des canaux.
• Méthodes asynchrones sur les fournisseurs de stockage de clés Always Crypted. Le pilote n’appelle pas encore ces méthodes lors de l’exécution des commandes, donc elles ne rendent pas les opérations Always Encrypted existantes asynchrones.

SqlBatchCommand.CommandBehavior est pris en compte à partir de cette ligne. Les versions antérieures ignoraient cette propriété. L’option de connexion obsolète Type System Version=SQL Server 2000 génère maintenant une ArgumentException.

Preview3 modifie également la validation des certificats et de l’enclave. ServerCertificate compare toujours le fichier de certificat configuré avec le certificat présenté par le serveur. Un fichier invalide ou illisible échoue alors à la connexion au lieu de recourir à la validation du nom d’hôte. L’attestation en mode sécurisé virtuel (VSM) et en service de garde hôte (HGS) vérifie désormais que la clé publique de l’enclave est liée au rapport d’attestation signé. Testez à nouveau ces parcours lorsque vous quittez une version préliminaire antérieure.

Lisez les notes de version pour preview1, preview2 et preview3 avant de tester cette ligne.

7.0 STS

La version 7.0 a atteint une disponibilité générale en mars 2026. C’est la gamme STS actuelle.

Caractéristiques et changements

• L’authentification Microsoft Entra fournie par le pilote est passée du package de base à Microsoft.Data.SqlClient.Extensions.Azure. Ajoutez le package d’extension lorsque vous utilisez un Active Directory mode d’authentification.
• Le package de base ne dépend plus de Azure.Core, Azure.Identity, ni de Microsoft Authentication Library (MSAL).
• SqlConnection.SspiContextProvider prend en charge la négociation personnalisée des jetons Kerberos et NTLM. L’identité du fournisseur fait partie de la clé du pool de connexion.
• Le routage amélioré pour Azure SQL Hyperscale et les réplices de lecture nommées sont négociés automatiquement.
• Des événements de diagnostic de commande, de connexion et de transaction fortement typés sont disponibles sur .NET Framework et les versions actuelles de .NET.
• SqlConfigurableRetryFactory.BaselineTransientErrors Expose la liste d’erreurs transitoires par défaut du pilote.
• Active Directory Password l’authentification est obsolète. Utilisez l’authentification interactive pour les applications utilisateurs, l’authentification par principal de service pour les services, ou l’identité managée pour les charges de travail hébergées sur Azure.
• La prise en charge commence à partir de .NET Framework 4.6.2 et de .NET 8. Le pilote supporte également la compilation et l’exécution sur .NET 10.

Le multiplexage de paquets pour les lectures asynchrones reste une fonctionnalité en préversion et doit être activé explicitement dans la version 7.0. Testez les options de compatibilité avec des charges de travail de production et prévoyez une procédure de retour arrière.

Mises à jour

6.1 LTS

La version 6.1.0 est sortie en juillet 2025, mais a ensuite été retirée de la liste en raison de régressions critiques. La version 6.1.1, publiée en août 2025, a marqué la mise en place de la branche 6.1 LTS prise en charge.

Caractéristiques et changements

• Prise en charge native du transport de vecteurs dans SQL Server 2025 via SqlVector<T>, initialement pour des vecteurs en virgule flottante à simple précision.
• Un asset de référence .NET Standard 2.0 pour la compatibilité des bibliothèques. Cet asset n’est pas une implémentation à l’exécution. Les applications exécutables doivent utiliser un composant d’exécution pris en charge pour .NET ou .NET Framework.
• Le multiplexage de paquets par option fonctionne pour les lectures asynchrones volumineuses et la gestion des terminaux pour la base de données SQL dans Microsoft Fabric.
• Prise en charge améliorée de la compilation native Ahead-of-Time (AOT).
• Réduction des allocations dans les chemins de connexion et de traitement TDS.
• Les bases internes de l’extension publique de la Security Support Provider Interface (SSPI) ont été posées dans la version 7.0.

Ne déployez pas la version 6.1.0. La version 6.1.1 a annulé les changements affectés de détection et de relecture des paquets.

Mises à jour

Lignes de sorties précédentes

Les lignes de sortie suivantes ne sont plus prises en charge. Utilisez leurs résumés lorsque vous planifiez une mise à niveau sur plusieurs versions de pilotes.

6.0

La version 6.0 a atteint une disponibilité générale en janvier 2025. Le dernier correctif était la 6.0.5, sortie en janvier 2026.

• Ajout du support JSON natif de SQL Server via Microsoft.Data.SqlTypes.SqlJson, incluant les chemins de lecture, d’écriture, de streaming et de copie en masse.
• Ajout de charges utiles de diagnostic publiques et fortement typées pour les événements de commande, de connexion et de transaction.
• Ajout de OpenAsync(SqlConnectionOverrides, CancellationToken), y compris OpenWithoutRetry.
• Ajout de la prise en charge de DateOnly et TimeOnly dans les paramètres structurés DataTable et SqlDataRecord.
• Ajout du support .NET 9.
• Suppression des ressources d’exécution pour .NET Standard et .NET 6. Les cibles prises en charge devinrent .NET Framework 4.6.2 et versions ultérieures, ainsi que .NET 8 et versions ultérieures.
• Limité EnableOptimizedParameterBinding aux commandes textuelles.

Mises à jour

5.2

La version 5.2 a été disponible en février 2024. Le dernier patch était la 5.2.3, sortie en avril 2025.

• Ajout de SqlConnection.AccessTokenCallback pour l’obtention asynchrone de jetons, compatible avec les pools.
• Ajout de SqlBatch et de SqlBatchCommand dans .NET 6 et les versions ultérieures.
• Ajout de la prise en charge de SqlDiagnosticListener sur .NET Standard.
• Ajout de 64 bits SqlBulkCopy.RowsCopied64. La propriété plus ancienne RowsCopied reste un entier 32 bits.
• Ajout de l’Active Directory Workload Identity authentification.
• Ajout du support .NET 8 et des plateformes big-endian.
• Modification de UseOneSecFloorInTimeoutCalculationDuringLogin pour utiliser true par défaut.
• Utilisé NegotiateAuthentication pour le SSPI géré sur .NET 7 et versions ultérieures.

Mises à jour

5,1

La version 5.1 a atteint une disponibilité générale en janvier 2023. Le dernier patch était la 5.1.9, sortie en janvier 2026.

• Ajout du support .NET 6 et suppression de .NET Core 3.1.
• Ajout de la prise en charge de DateOnly et TimeOnly pour les valeurs de paramètres et GetFieldValue.
• Ajout de TLS 1.3 en .NET et des chemins natifs SQL Server Network Interface (SNI).
• Ajouté ServerCertificate pour obtenir une correspondance exacte des certificats avec Encrypt=Mandatory et Encrypt=Strict.
• Ajout du support Windows ARM64 pour .NET Framework.
• Le parseur de chaînes SqlConnectionEncryptOption est désormais public.
• La version 5.1.3 a corrigé le chemin de rétrogradation du chiffrement CVE-2024-0056 et la validation de la chaîne de certificats.

Mises à jour

5.0

La version 5.0 a été disponible en août 2022. Le dernier patch était la 5.0.2, sorti en mars 2023.

• Ajout de TDS 8.0 via Encrypt=Strict. Le mode strict lance TLS avant l’échange de connexion TDS et valide toujours le certificat serveur.
• Changé SqlConnectionStringBuilder.Encrypt de bool à SqlConnectionEncryptOption.
• Types CLR de SQL Server déplacés vers le package Microsoft.SqlServer.Server, versionné séparément.
• Ajout des options de connexion Server SPN et Failover Server SPN.
• Ajout de la prise en charge des alias Windows SQL Server dans la version actuelle de .NET.
• Ajout de SqlDataSourceEnumerator sous Windows.
• J’ai abandonné le framework .NET 4.6.1.

Mises à jour

4.1

La version 4.1 a atteint une disponibilité générale en janvier 2022. Le dernier patch était la 4.1.1, sortie en septembre 2022.

• Ajout de Attestation Protocol=None pour les enclaves de sécurité basée sur la virtualisation (VBS).
• Requêtes du protocole de résolution SQL Server parallélisées sur Linux et macOS lorsque MultiSubnetFailover est activé.
• Vérification fixe de la liste de la révocation de certificats lors de l’authentification.
• Correction de l’authentification Microsoft Entra, des valeurs null SqlBinary et rowversion, ainsi que du comportement de collation UTF-8.

Mises à jour

4,0

La version 4.0 a été disponible en novembre 2021. Le dernier patch était la 4.0.6, sortie en août 2024.

• Changement de valeur Encrypt par défaut de de false à true.
• Ajouté SqlCommand.EnableOptimizedParameterBinding pour des commandes avec de nombreux paramètres.
• Ajouté SqlFileStream pour Windows via l’implémentation .NET Standard.
• Ajout du support des instances LocalDB partagées dans SNI géré.
• Ajouté GetFieldValue<T> et GetFieldValueAsync<T> pour XmlReader, TextReader, et Stream.
• Suppression de l’interrupteur de sécurité de la logique de réessayage configurable. Retry restait désactivé jusqu’à ce qu’une application configure un fournisseur.
• Les échecs d’authentification à Microsoft Entra génèrent désormais SqlException au lieu de AggregateException.
• J’ai abandonné .NET Core 2.1.
• La version 4.0.5 a corrigé le chemin de rétrogradation du chiffrement CVE-2024-0056 et la validation de la chaîne de certificats.

Mises à jour

3.1

La version 3.1 a atteint une disponibilité générale en mars 2022. Le dernier patch était la 3.1.7, sorti en août 2024.

• Ajout de Attestation Protocol=None pour les enclaves VBS.
• Ajout des erreurs SQL 42108 et 42109 à la liste d’erreurs transitoires par défaut.
• Ajout du support Windows ARM64 pour .NET Framework dans la version 3.1.2.
• Réduction des demandes répétées de jeton Microsoft Entra grâce à l’acquisition silencieuse de jeton dans la version 3.1.3.
• Correction du chemin de rétrogradation du chiffrement CVE-2024-0056 dans la version 3.1.5.
• Correction du nettoyage des transactions avant la mise en pool et de la gestion du délai d’expiration des jetons Microsoft Entra dans la version 3.1.7.

Mises à jour

3.0

La version 3.0 a été disponible en juin 2021. Le dernier patch était la 3.0.1, sortie en septembre 2021.

• Ajout d’une logique de réessayage configurable pour les opérations de connexion et de commande. Dans la version 3.0, cette fonctionnalité restait activable uniquement via Switch.Microsoft.Data.SqlClient.EnableRetryLogic.
• Ajout d’EventCounters pour l’activité de connexion et de pool.
• Ajout de l’authentification Active Directory Default via Azure.Identity.
• Ajout de l’enregistrement du fournisseur de stockage de clés Always Encrypted à portée de connexion et commande.
• Ajout de la préférence d’adresse IP TCP.
• Modification de l’authentification de l’identité managée assignée par l’utilisateur pour utiliser l’ID client au lieu de l’ID d’objet dans User Id.
• Modifié les valeurs NULL SQL rowversion pour renvoyer DBNull au lieu d’un tableau d’octets vide. Un commutateur AppContext a conservé l’ancien comportement.
• Augmentation de l’objectif minimum du cadre .NET de 4.6 à 4.6.1.

Les fournisseurs de stockage de clés système ont la priorité sur ceux enregistrés sur une connexion ou une commande à partir de la version 3.0. Renommer un fournisseur personnalisé si son nom entre en conflit avec un fournisseur intégré.

Mises à jour

2.1

La version 2.1 a été disponible en novembre 2020. Le dernier patch était la 2.1.7, sortie en janvier 2024.

• Extension de Toujours Chiffré aux plateformes .NET Standard 2.0 prises en charge.
• Ajout du support sécurisé de l’enclave sur Unix pour .NET Core et sur les plateformes .NET Standard 2.1.
• Ajout de Active Directory Device Code Flow et de l’authentification par identité gérée.
• Ajout de points d’extension pour l’authentification interactive et l’authentification par code d’appareil.
• Ajout des métadonnées de rang de classification de sensibilité.
• Ajout de SqlConnection.ServerProcessId.
• J’ai ajouté l’option Command Timeout de connexion comme référence par défaut pour les commandes créées par une connexion.
• La version 2.1.7 a corrigé le chemin de rétrogradation du chiffrement CVE-2024-0056.

Mises à jour

2.0

La version 2.0 a atteint sa disponibilité générale en juin 2020. Le dernier correctif était la 2.0.1, sorti en août 2020.

• Ajout de l’authentification Active Directory Integrated et Active Directory Interactive pour .NET Core et .NET Standard.
• Ajout de l’Active Directory Service Principal authentification.
• Ajout du Microsoft.Data.SqlClient.EventSource traçage.
• Ajout d’un mécanisme TCP de maintien de connexion multiplateforme et d’une implémentation optionnelle de mise en réseau gérée sous Windows pour les tests et le débogage. Le chemin géré ne supportait pas l'Authentification Windows non-domaine.
• Ajout de SqlBulkCopy.RowsCopied et réorganisation des indices de copie en masse.
• Ajout de SqlConnection.Open(SqlConnectionOverrides.OpenWithoutRetry).
• Ajout du support Windows ARM via la Microsoft.Data.SqlClient.SNI.runtime dépendance.
• A commencé à valider le certificat serveur lorsqu’un serveur force le chiffrement, y compris lorsque la chaîne de connexion définit Encrypt=false. Les connexions peuvent échouer après cette mise à niveau si le certificat n’est pas fiable ou si son nom ne correspond pas au serveur.
• Modification de la gestion de l’échelle des paramètres décimaux pour utiliser un arrondi compatible SQL Server.

Mises à jour

1.1

La version 1.1 a atteint une disponibilité générale en novembre 2019. Le dernier patch était la 1.1.4, sorti en mars 2021.

• Ajout de Always Encrypted avec des enclaves sécurisées sur les cibles .NET Framework et .NET Core prises en charge.
• Ajout |DataDirectory| d’une extension AttachDBFilename sur .NET Core.
• Lectures asynchrones améliorées avec la mise en cache multipaquets cible-buffer.
• Réduction de la surcharge liée aux instantanés dans TdsParserStateObject et SqlDataReader.
• Correction des erreurs liées à l’état de temporisation et à l’en-tête Multiple Active Result Sets (MARS) dans des correctifs ultérieurs.

Mises à jour

1.0

Microsoft. Data.SqlClient 1.0 a atteint la disponibilité générale en août 2019. Le dernier correctif était 1.0.19269.1, publié en septembre 2019.

• Ajout du fournisseur Microsoft.Data.SqlClient distribué séparément.
• Supportait .NET Framework 4.6 et versions ultérieures, .NET Core 2.1 et versions ultérieures, ainsi que .NET Standard 2.0.
• Ajout de l’authentification Active Directory Interactive dans .NET Framework.
• Ajout de l’authentification Active Directory Password sur .NET Core.
• Ajout de métadonnées de classification de la sensibilité des données sur SqlDataReader.
• Ajout du support de la compilation SQL Server 2019 UTF-8.
• Ajout du support Always Encrypted sur .NET Core.

Mises à jour

Pour une application qui passe de l’ancien fournisseur, utilisez Migrer de System.Data.SqlClient vers Microsoft. Data.SqlClient au lieu de ne lire que les notes de version.

Notes de sortie optionnelles du paquet

Les packs optionnels ont leurs propres notes de sortie. À partir de la version 7.0.2, ils sont livrés en version alignée avec le pilote principal.

Ne faites pas directement référence à Microsoft.Data.SqlClient.Internal.Logging. C’est une dépendance interne partagée par les packages de pilotes.

Évaluer une mise à jour

1. Identifier chaque pilote et chaque version optionnelle du package utilisée directement ou de manière transitive.
2. Lisez les notes de version pour chaque version mineure et majeure concernée par la mise à jour.
3. Vérifiez le cycle de vie du support des pilotes SqlClient pour vérifier la compatibilité du framework cible et des bases de données.
4. Mettez à jour tous les paquets associés vers des versions compatibles.
5. Construisez et testez l’authentification de l’application, le chiffrement, le pooling de connexions, les paramètres, les transactions, les tentatives, les diagnostics et les résultats de déploiement.

Pour les commandes d’installation et de déploiement, voir Installer, mettre à jour et déployer Microsoft. Data.SqlClient.

Contenu connexe

• Installer, mettre à jour et déployer Microsoft. Data.SqlClient
• Cycle de vie de prise en charge du pilote SqlClient
• Migrer de System.Data.SqlClient vers Microsoft. Data.SqlClient
• Notes de version de Microsoft.Data.SqlClient