Was gibt es Neues bei Microsoft? Data.SqlClient

Microsoft. Data.SqlClient wird unabhängig von .NET ausgeliefert. Dieser Artikel fasst die bedeutenden Merkmale, Verhaltensänderungen und Kompatibilitätsänderungen in jeder Release-Reihe zusammen. Die Release-Tabellen enthalten jede Veröffentlichung eines stabilen Pakets, einschließlich aller Hotfix- und nicht gelisteten Pakete. Für jedes Fix- und Abhängigkeitsupdate siehe die vollständigen Versionsnotizen im SqlClient-Repository.

Aktuelle Releases

Verwende keine Vorschau-Veröffentlichungen in der Produktion. Vorschau-APIs und das Verhalten können sich vor der allgemeinen Verfügbarkeit (GA) ändern.

Veröffentlichungstabellen und allgemeine Verfügbarkeitsübersichten verwenden den NuGet-Veröffentlichungsmonat. Der Lebenszyklusartikel listet offizielle Veröffentlichungsdaten auf, die variieren können. Für Support-Fenster siehe SqlClient-Treiber-Support-Lebenszyklus.

7.1 Vorschau

Die Vorschauzeile 7.1 erweitert Batching, Schema-Discovery, Connection Pooling und Always Encrypted APIs. Änderungen bis einschließlich 7.1.0-preview3 umfassen:

• SqlBatchUnterstützung im .NET Framework.
• Asynchrone SqlConnection.GetSchemaAsync Überlastungen.
• Verbindungsstring-Aliase wie ColumnEncryption, ConnectTimeout, FailoverPartner, PacketSize, und WorkstationId.
• SQL-Graph-Pseudo-Spaltenabbildungen für $node_id, $edge_id, , $from_idund $to_id in SqlBulkCopy.
• Optionale Durchsetzung des Leerlauf-Timeouts für Verbindungen.
• Ein Opt-in-Verbindungs-Timeout-Modus, der die Zeit umfasst, die auf eine gepoolte Verbindung gewartet wird.
• Weiterentwicklung des experimentellen kanalbasierten Verbindungspools.
• Asynchrone Methoden für Schlüsselspeicheranbieter von Always Encrypted. Der Treiber ruft diese Methoden während der Befehlsausführung noch nicht auf, sodass bestehende Always Encryption-Operationen nicht asynchron werden.

SqlBatchCommand.CommandBehavior wird ab dieser Zeile berücksichtigt. Frühere Versionen ignorierten die Eigenschaft. Die veraltete Type System Version=SQL Server 2000 Verbindungsoption wirft nun ein ArgumentException.

Preview3 ändert außerdem die Validierung von Zertifikaten und Enklaven. ServerCertificate vergleicht immer die konfigurierte Zertifikatsdatei mit dem vom Server präsentierten Zertifikat. Eine ungültige oder unlesbare Datei scheitert nun an der Verbindung, anstatt auf die Host-Name-Validierung zurückzufallen. Die Enklave-Attestierung im Virtual Secure Mode (VSM) und Host Guardian Service (HGS) bestätigt nun, dass der öffentliche Schlüssel der Enklave an den signierten Attestationsbericht gebunden ist. Teste diese Pfade erneut, wenn du von einer früheren Vorschauversion wechselst.

Lesen Sie die Release Notes für Preview1,Preview2 und Preview3, bevor Sie diese Reihe testen.

7.0 STS

Version 7.0 erreichte im März 2026 die allgemeine Verfügbarkeit. Es ist die aktuelle STS-Linie.

Merkmale und Änderungen

• Die vom Treiber bereitgestellte Microsoft Entra-Authentifizierung wurde aus dem Core-Paket in Microsoft.Data.SqlClient.Extensions.Azure verschoben. Fügen Sie das Erweiterungspaket hinzu, wenn Sie einen Active DirectoryAuthentifizierungsmodus verwenden.
• Das Core-Paket hängt nicht mehr von Azure.Identity, Azure.Core oder der Microsoft Authentication Library (MSAL) (MSAL) ab.
• SqlConnection.SspiContextProvider unterstützt die benutzerdefinierte Kerberos- und NTLM-Token-Aushandlung. Die Provider-Identität ist Teil des Verbindungspool-Schlüssels.
• Verbessertes Routing für Azure SQL Hyperscale und benannte Lesereplikate wird automatisch ausgehandelt.
• Stark typisierte Befehle, Verbindungen und Transaktionsdiagnoseereignisse sind im .NET Framework und im aktuellen .NET verfügbar.
• SqlConfigurableRetryFactory.BaselineTransientErrors macht die Standardliste transienter Fehler des Treibers verfügbar.
• Active Directory Password Die Authentifizierung ist veraltet. Verwenden Sie interaktive Authentifizierung für Benutzeranwendungen, Service Principal Authentication für Services oder Managed Identity für Azure-gehostete Workloads.
• Die Zielunterstützung beginnt bei .NET Framework 4.6.2 und .NET 8. Der Treiber unterstützt außerdem das Erstellen und Ausführen von .NET 10.

Paketmultiplexing für asynchrone Lesevorgänge bleibt in Version 7.0 weiterhin eine Vorschaufunktion und muss explizit aktiviert werden. Kompatibilitätsschalter an Produktions-Workloads testen und eine Rollback-Möglichkeit beibehalten.

Veröffentlichungen

6.1 LTS

Version 6.1.0 wurde im Juli 2025 veröffentlicht, wurde jedoch später wegen kritischer Regressionen aus dem Programm genommen. Version 6.1.1, veröffentlicht im August 2025, etablierte die unterstützte 6.1 LTS-Linie.

Merkmale und Änderungen

• Native SQL Server 2025-Vektorübertragung über SqlVector<T>, zunächst für Gleitkommavektoren mit einfacher Genauigkeit.
• Ein .NET Standard 2.0 Referenz-Asset zur Bibliothekskompatibilität. Dieses Asset ist keine Laufzeitimplementierung. Ausführbare Anwendungen müssen ein unterstütztes .NET- oder .NET Framework-Runtime-Asset verwenden.
• Opt-in-Paketmultiplexing funktioniert für große asynchrone Lesungen und Endpunkt-Handhabung für SQL-Datenbanken in Microsoft Fabric.
• Verbesserte native Unterstützung für Ahead-of-Time (AOT) Kompilierungen.
• Reduzierte Zuweisungen in Verbindungs- und TDS-Verarbeitungspfaden.
• Die internen Grundlagen für die öffentliche Erweiterbarkeit der Security Support Provider Interface (SSPI) wurden in Version 7.0 hinzugefügt.

Bereite Version 6.1.0 nicht aus. Version 6.1.1 hat die betroffenen Änderungen zur Paketerkennung und -wiederholung rückgängig gemacht.

Veröffentlichungen

Frühere Veröffentlichungslinien

Die folgenden Release-Linien werden nicht mehr unterstützt. Nutze deren Zusammenfassungen, wenn du ein Upgrade über mehrere Treiberversionen hinweg planst.

6.0

Version 6.0 erreichte im Januar 2025 die allgemeine Verfügbarkeit. Der letzte Patch war 6.0.5 und wurde im Januar 2026 veröffentlicht.

• Native SQL Server-JSON-Unterstützung wurde durch Microsoft.Data.SqlTypes.SqlJson hinzugefügt, einschließlich Lese-, Schreib-, Streaming- und Bulk-Copy-Pfaden.
• Öffentliche, streng typisierte Diagnosedaten für Befehls-, Verbindungs- und Transaktionsereignisse wurden hinzugefügt.
• Hinzugefügt wurde OpenAsync(SqlConnectionOverrides, CancellationToken), einschließlich OpenWithoutRetry.
• Unterstützung für TimeOnly und DataTable in SqlDataRecord- und DateOnly-strukturierten Parametern hinzugefügt.
• .NET 9-Unterstützung hinzugefügt.
• .NET Standard und .NET 6 Laufzeit-Assets fallen gelassen. Unterstützte Zielplattformen sind nun .NET Framework 4.6.2 und spätere Versionen sowie .NET 8 und spätere Versionen.
• Beschränkt EnableOptimizedParameterBinding auf Textbefehle.

Veröffentlichungen

5,2

Version 5.2 erreichte im Februar 2024 die allgemeine Verfügbarkeit. Der letzte Patch war 5.2.3 und wurde im April 2025 veröffentlicht.

• SqlConnection.AccessTokenCallback für asynchronen, pool-kompatiblen Tokenabruf hinzugefügt.
• Hinzugefügt SqlBatch und SqlBatchCommand in .NET 6 und höheren Versionen.
• Unterstützung für .NET Standard hinzugefügtSqlDiagnosticListener.
• 64-Bit-SqlBulkCopy.RowsCopied64 hinzugefügt. Die ältere RowsCopied Eigenschaft bleibt eine 32-Bit-Ganzzahl.
• Active Directory Workload Identity-Authentifizierung hinzugefügt.
• .NET 8 und Big-Endian-Plattformunterstützung hinzugefügt.
• UseOneSecFloorInTimeoutCalculationDuringLogin wurde standardmäßig auf true festgelegt.
• Verwendet NegotiateAuthentication für verwaltetes SSPI unter .NET 7 und neueren Versionen.

Veröffentlichungen

5.1

Version 5.1 erreichte im Januar 2023 die allgemeine Verfügbarkeit. Der letzte Patch war 5.1.9 und wurde im Januar 2026 veröffentlicht.

• .NET 6-Unterstützung wurde hinzugefügt und .NET Core 3.1 gestrichen.
• Unterstützung für DateOnly und TimeOnly für Parameterwerte und GetFieldValue hinzugefügt.
• Unterstützung für TLS 1.3 in .NET sowie in nativen Pfaden der SQL Server Network Interface (SNI) hinzugefügt.
• Hinzugefügt ServerCertificate für eine exakte Zertifikatsübereinstimmung mit Encrypt=Mandatory und Encrypt=Strict.
• Windows ARM64-Unterstützung für das .NET Framework hinzugefügt.
• Der SqlConnectionEncryptOption String-Parser wurde öffentlich gemacht.
• Version 5.1.3 korrigierte den CVE-2024-0056-Verschlüsselungs-Downgrade-Pfad und die Zertifikatskette-Validierung.

Veröffentlichungen

5.0

Version 5.0 erreichte im August 2022 die allgemeine Verfügbarkeit. Der letzte Patch war 5.0.2 und wurde im März 2023 veröffentlicht.

• TDS 8.0 bis Encrypt=Strict hinzugefügt. Der Strict-Modus startet TLS vor dem TDS-Login-Austausch und validiert immer das Serverzertifikat.
• Wechselte SqlConnectionStringBuilder.Encrypt von bool zu SqlConnectionEncryptOption.
• SQL Server Common Language Runtime (CLR)-Typen wurden auf das separat versionierte Microsoft.SqlServer.Server Paket verschoben.
• Server SPN und Failover Server SPN Verbindungsoptionen hinzugefügt.
• Ich habe Windows SQL Server Alias-Unterstützung bei der aktuellen .NET hinzugefügt.
• Hinzugefügt SqlDataSourceEnumerator auf Windows.
• .NET Framework 4.6.1 habe ich fallen gelassen.

Veröffentlichungen

4.1

Version 4.1 erreichte im Januar 2022 die allgemeine Verfügbarkeit. Der letzte Patch war 4.1.1 und wurde im September 2022 veröffentlicht.

• Attestation Protocol=None für virtualisierungsbasierte Sicherheits-(VBS)-Enklaven hinzugefügt.
• Parallelisierte Anforderungen an das SQL Server Resolution Protocol unter Linux und macOS, wenn MultiSubnetFailover aktiviert ist.
• Fehler bei der Prüfung von Zertifikatswiderrufslisten während der Authentifizierung behoben.
• Die Microsoft Entra-Authentifizierung, NULLSqlBinary- und rowversion-Werte sowie das Verhalten der UTF-8-Sortierung wurden korrigiert.

Veröffentlichungen

4,0

Version 4.0 erreichte im November 2021 die allgemeine Verfügbarkeit. Der letzte Patch war 4.0.6 und wurde im August 2024 veröffentlicht.

• Der Standardwert von Encrypt wurde von false in true geändert.
• SqlCommand.EnableOptimizedParameterBinding für Befehle mit vielen Parametern hinzugefügt.
• SqlFileStream für Windows durch die Implementierung von .NET Standard hinzugefügt.
• Unterstützung für gemeinsame LocalDB-Instanzen im verwalteten SNI hinzugefügt.
• Hinzugefügt GetFieldValue<T> und GetFieldValueAsync<T> für XmlReader, TextReader, und Stream.
• Den Sicherheitsschalter aus der konfigurierbaren Wiederholungslogik entfernt. Retry blieb deaktiviert, bis eine Anwendung einen Anbieter konfigurierte.
• Microsoft Entra-Authentifizierungsfehler wurden so geändert, dass statt AggregateExceptionSqlException ausgelöst wird.
• .NET Core 2.1 habe ich fallen gelassen.
• Version 4.0.5 behob den mit CVE-2024-0056 verbundenen Downgrade-Pfad bei der Verschlüsselung sowie die Validierung der Zertifikatskette.

Veröffentlichungen

3.1

Version 3.1 erreichte im März 2022 die allgemeine Verfügbarkeit. Der letzte Patch war 3.1.7 und wurde im August 2024 veröffentlicht.

• Hinzugefügt Attestation Protocol=None für VBS-Enklaven.
• SQL-Fehler 42108 und 42109 wurden zur Standard-Liste der transienten Fehler hinzugefügt.
• Windows ARM64-Unterstützung für das .NET Framework wurde in 3.1.2 hinzugefügt.
• In 3.1.3 wurden wiederholte Microsoft Entra-Token-Anfragen durch den Erwerb stiller Token reduziert.
• Der CVE-2024-0056-Verschlüsselungs-Downgrade-Pfad wurde in 3.1.5 behoben.
• Bereinigung von Transaktionen vor dem Pooling und Behandlung von Timeouts bei Microsoft Entra-Token in 3.1.7 behoben.

Veröffentlichungen

3.0

Version 3.0 erreichte im Juni 2021 die allgemeine Verfügbarkeit. Der letzte Patch war 3.0.1 und wurde im September 2021 veröffentlicht.

• Konfigurierbare Wiederholungslogik für Verbindungs- und Befehlsoperationen hinzugefügt. In Version 3.0 musste es weiterhin über Switch.Microsoft.Data.SqlClient.EnableRetryLogic aktiviert werden.
• EventCounters für Verbindung und Pool-Aktivitäten wurden hinzugefügt.
• Azure.IdentityAuthentifizierung über Active Directory Default hinzugefügt.
• Verbindungsbezogene und befehlsbezogene Registrierung des Always Encrypted Keystore-Anbieters wurden hinzugefügt.
• Die Präferenz für die TCP-IP-Adresse wurde hinzugefügt.
• Die Authentifizierung mit benutzerseitig zugewiesener verwalteter Identität wurde in User Id so geändert, dass anstelle der Objekt-ID die Client-ID verwendet wird.
• SQL-Rowversion-Nullwerte wurden so geändert, dass sie statt eines leeren Byte-Arrays zurückgegeben DBNull werden. Ein AppContext-Switch bewahrte das ältere Verhalten.
• Das Mindestziel für das .NET Framework wurde von 4.6 auf 4.6.1 erhöht.

Ab Version 3.0 haben Anbieter von Systemschlüsselspeichern Vorrang vor Anbietern, die für eine Verbindung oder einen Befehl registriert sind. Einen benutzerdefinierten Anbieter umbenennen, wenn sein Name mit dem eines integrierten Anbieters kollidiert.

Veröffentlichungen

2.1

Version 2.1 erreichte im November 2020 die allgemeine Verfügbarkeit. Der letzte Patch war 2.1.7 und wurde im Januar 2024 veröffentlicht.

• Erweitert Always Encrypted auf unterstützte .NET Standard 2.0 Plattformen.
• Unterstützung für Secure Enclaves unter Unix für .NET Core sowie plattformübergreifend für .NET Standard 2.1 hinzugefügt.
• Active Directory Device Code Flow und die Authentifizierung mit verwalteter Identität wurden hinzugefügt.
• Anpassungshaken für interaktive und Gerätecode-Authentifizierung wurden hinzugefügt.
• Sensitivitätsklassifikations-Rang-Metadaten hinzugefügt.
• SqlConnection.ServerProcessId wurde hinzugefügt.
• Command Timeout Die Verbindungsoption wurde als Standard für Befehle hinzugefügt, die durch eine Verbindung erstellt werden.
• Version 2.1.7 korrigierte den Downgrade-Pfad der CVE-2024-0056-Verschlüsselung.

Veröffentlichungen

2.0

Version 2.0 erreichte im Juni 2020 die allgemeine Verfügbarkeit. Der letzte Patch war 2.0.1 und wurde im August 2020 veröffentlicht.

• Active Directory Integrated und Active Directory Interactive-Authentifizierung für .NET Core und .NET Standard hinzugefügt.
• Authentifizierung Active Directory Service Principal hinzugefügt.
• Microsoft.Data.SqlClient.EventSource Ablaufverfolgung hinzugefügt.
• Plattformübergreifendes TCP-Keep-alive und eine opt-in verwaltete Netzwerkimplementierung auf Windows für Tests und Debugging hinzugefügt. Der verwaltete Pfad unterstützte keine Windows-Authentifizierung außerhalb der Domäne.
• SqlBulkCopy.RowsCopied hinzugefügt und Hinweise zum Massenkopieren geordnet.
• SqlConnection.Open(SqlConnectionOverrides.OpenWithoutRetry) wurde hinzugefügt.
• Windows-ARM-Unterstützung wurde durch die Abhängigkeit Microsoft.Data.SqlClient.SNI.runtime hinzugefügt.
• Begann mit der Überprüfung des Serverzertifikats, wenn ein Server Verschlüsselung erzwingt, auch wenn die Verbindungszeichenfolge Encrypt=false festlegt. Verbindungen können nach diesem Upgrade ausfallen, wenn das Zertifikat nicht vertrauenswürdig ist oder der Name nicht mit dem Server übereinstimmt.
• Die Behandlung der Dezimalskalierung von Parametern wurde so geändert, dass eine mit SQL Server kompatible Rundung verwendet wird.

Veröffentlichungen

1.1

Version 1.1 erreichte im November 2019 die allgemeine Verfügbarkeit. Der letzte Patch war 1.1.4 und wurde im März 2021 veröffentlicht.

• Always Encrypted mit sicheren Enklaven auf unterstützten .NET Framework- und .NET Core-Zielen hinzugefügt.
• |DataDirectory|-Unterstützung in AttachDBFilename in .NET Core hinzugefügt.
• Verbesserte asynchrone Lesevorgänge mit Zwischenspeicherung im Zielpuffer für mehrere Pakete.
• Der Snapshot-Overhead in TdsParserStateObject und SqlDataReader wurde reduziert.
• Behebung von Timeout-State- und Multiple Active Result Sets (MARS)-Headerfehlern in späteren Patches.

Veröffentlichungen

1.0

Microsoft. Data.SqlClient 1.0 erreichte im August 2019 die allgemeine Verfügbarkeit. Der letzte Patch war 1.0.19269.1 und wurde im September 2019 veröffentlicht.

• Stellte den separat ausgelieferten Microsoft.Data.SqlClient-Anbieter vor.
• Unterstützte .NET Framework 4.6 und spätere Versionen, .NET Core 2.1 und spätere Versionen sowie .NET Standard 2.0.
• Active Directory InteractiveAuthentifizierung wurde im .NET Framework hinzugefügt.
• Active Directory Password-Authentifizierung für .NET Core hinzugefügt.
• Metadaten zur Klassifizierung der Datensensitivität auf SqlDataReader hinzugefügt.
• SQL Server 2019 UTF-8 Kollierungsunterstützung hinzugefügt.
• Unterstützung für Always Encrypted unter .NET Core hinzugefügt.

Veröffentlichungen

Für eine Anwendung, die vom älteren Anbieter migriert wird, verwenden Sie Migrate from System.Data.SqlClient to Microsoft.Data.SqlClient, anstatt sich allein auf die Release Notes zu verlassen.

Optionale Paket-Veröffentlichungshinweise

Optionale Pakete haben eigene Release-Notes. Ab Version 7.0.2 liefern sie die Version aus, die an den Kerntreiber angepasst ist.

Referenziere Microsoft.Data.SqlClient.Internal.Logging nicht direkt. Es handelt sich um eine interne Abhängigkeit, die von Treiberpaketen geteilt wird.

Bewerten Sie ein Update

1. Identifizieren Sie jeden Treiber und jede optionale Paketversion, die direkt oder transitiv verwendet werden.
2. Lesen Sie die Release Notes für jede kleine und große Version, die durch das Update überschritten wurde.
3. Überprüfen Sie den Supportlebenszyklus des SqlClient-Treibers hinsichtlich der Kompatibilität mit dem Zielframework und der Datenbank.
4. Aktualisieren Sie alle zugehörigen Pakete auf kompatible Versionen.
5. Erstellen und testen Sie die Authentifizierung, Verschlüsselung, Verbindungspooling, Parameter, Transaktionen, Wiederholungsversuche, Diagnosefunktionen und Bereitstellungsausgabe der Anwendung.

Für Installations- und Bereitstellungsbefehle siehe Installieren, aktualisieren und deployen Microsoft. Data.SqlClient.

Verwandte Inhalte

• Microsoft.Data.SqlClient installieren, aktualisieren und bereitstellen
• Lebenszyklus der SqlClient-Treiberunterstützung
• Migration von System.Data.SqlClient zu Microsoft. Data.SqlClient
• Microsoft. Data.SqlClient Veröffentlichungshinweise