Wat is er nieuw bij Microsoft. Data.SqlClient

Microsoft. Data.SqlClient wordt onafhankelijk van .NET geleverd. Dit artikel vat de belangrijke kenmerken, gedragswijzigingen en compatibiliteitswijzigingen in elke releaselijn samen. De releasetabellen bevatten alle stabiele pakketpublicaties, inclusief alle hotfixes en niet-vermelde pakketten. Voor elke fix- en afhankelijkheidsupdate, zie de volledige release notes in de SqlClient-repository.

Huidige releases

Gebruik geen preview-releases in productie. Preview-API's en gedrag kunnen veranderen vóór General Availability (GA).

Releasetabellen en algemene beschikbaarheidssamenvattingen gebruiken de NuGet-publicatiemaand. Het levenscyclusartikel vermeldt officiële releasedatums, die kunnen verschillen. Voor ondersteuningsvensters, zie SqlClient driver support lifecycle.

7.1 Preview

De 7.1-previewreeks breidt batching, schemadetectie, verbindingspooling en Always Encrypted API’s uit. Wijzigingen via 7.1.0-preview3 zijn onder andere:

• SqlBatchOndersteuning op .NET Framework.
• Asynchrone SqlConnection.GetSchemaAsync overbelasting.
• Verbindingsstringaliasen zoals ColumnEncryption, ConnectTimeout, FailoverPartner, , PacketSizeen WorkstationId.
• Toewijzingen van SQL Graph-pseudokolommen voor $node_id, $edge_id, $from_id en $to_id in SqlBulkCopy.
• Optionele afdwinging van de time-out bij inactiviteit.
• Een opt-in verbindingstime-out modus die tijd omvat die wordt besteed aan het wachten op een gepoolde verbinding.
• Verdere ontwikkeling van de experimentele kanaalgebaseerde verbindingspool.
• Asynchrone methoden voor Always Encrypted-sleutelarchiefproviders. De driver roept deze methoden nog niet aan tijdens de uitvoering van commando's, dus maken ze bestaande Always Encrypted bewerkingen niet asynchroon.

SqlBatchCommand.CommandBehavior wordt geëerd door in deze lijn te beginnen. Eerdere versies negeerden de eigenschap. De verouderde Type System Version=SQL Server 2000 verbindingsoptie genereert nu een ArgumentException.

Preview3 verandert ook de validatie van certificaten en enclave. ServerCertificate vergelijkt altijd het geconfigureerde certificaatbestand met het certificaat dat door de server wordt gepresenteerd. Een ongeldig of onleesbaar bestand faalt nu in de verbinding in plaats van terug te vallen op hostnaamvalidatie. Virtual Secure Mode (VSM) en Host Guardian Service (HGS) enclave-attestatie verifieert nu dat de publieke sleutel van de enclave gebonden is aan het ondertekende attestatierapport. Test deze paden opnieuw wanneer je van een eerdere preview afgaat.

Lees de release notes voor preview1,preview2 en preview3 voordat je deze lijn test.

7.0 STS

Versie 7.0 werd in maart 2026 algemeen beschikbaar. Het is de huidige STS-lijn.

Kenmerken en veranderingen

• Door het stuurprogramma geleverde Microsoft Entra-authenticatie is verplaatst van het kernpakket naar Microsoft.Data.SqlClient.Extensions.Azure. Voeg het extensiepakket toe wanneer je een Active Directory authenticatiemodus gebruikt.
• Het kernpakket is niet langer afhankelijk van Azure.Core, Azure.Identity, of de Microsoft Authentication Library (MSAL).
• SqlConnection.SspiContextProvider ondersteunt aangepaste Kerberos en NTLM-tokenonderhandeling. De provideridentiteit maakt deel uit van de verbindingspoolsleutel.
• Verbeterde routering voor Azure SQL Hyperscale en benoemde leesreplica's wordt automatisch geregeld.
• Sterk getypeerde commando-, verbindings- en transactiediagnose-evenementen zijn beschikbaar op het .NET Framework en het huidige .NET.
• SqlConfigurableRetryFactory.BaselineTransientErrors stelt de standaard tijdelijke foutenlijst van de driver bloot.
• Active Directory Password Authenticatie wordt niet meer ondersteund. Gebruik interactieve authenticatie voor gebruikersapplicaties, service principal authenticatie voor services, of managed identity voor Azure-gehoste workloads.
• Doelondersteuning begint bij .NET Framework 4.6.2 en .NET 8. De driver ondersteunt ook het bouwen en uitvoeren op .NET 10.

Pakketmultiplexing voor asynchrone leesopdrachten blijft previewfunctionaliteit en is toegewezen in 7.0. Test compatibiliteitsschakelaars met productieworkloads en zorg dat er een rollbackmogelijkheid is.

Uitgaven

6.1 LTS

Versie 6.1.0 werd uitgebracht in juli 2025, maar werd later uit de lijst gehaald vanwege kritieke regressies. Versie 6.1.1, uitgebracht in augustus 2025, introduceerde de ondersteunde 6.1 LTS-lijn.

Kenmerken en veranderingen

• Native SQL Server 2025-transport van vectoren via SqlVector<T>, aanvankelijk voor single-precision floating-point-vectoren.
• Een .NET Standard 2.0 referentieasset voor bibliotheekcompatibiliteit. Dit asset is geen runtime-implementatie. Uitvoerbare applicaties moeten een ondersteund .NET- of .NET Framework-runtime-asset gebruiken.
• Opt-in pakketmultiplexingwerk voor grote asynchrone leesbewerkingen en eindpuntverwerking voor SQL-database in Microsoft Fabric.
• Verbeterde ingebouwde ondersteuning voor Ahead-of-Time (AOT)-compilatie.
• Verminderde toewijzingen in verbindings- en TDS-verwerkingspaden.
• Interne basis voor de publieke uitbreidbaarheid van de Security Support Provider Interface (SSPI) toegevoegd in 7.0.

Rol versie 6.1.0 niet uit. Versie 6.1.1 heeft de betreffende wijzigingen in pakketdetectie en replay teruggedraaid.

Uitgaven

Eerdere releaselijnen

De volgende releaselijnen worden niet langer ondersteund. Gebruik hun samenvattingen wanneer je een upgrade plant over meerdere driverversies.

6.0

Versie 6.0 werd in januari 2025 algemeen beschikbaar. De laatste patch was 6.0.5, uitgebracht in januari 2026.

• Native SQL Server JSON-ondersteuning toegevoegd via Microsoft.Data.SqlTypes.SqlJson, inclusief lees-, schrijf-, streaming- en bulk-copy paden.
• Publieke, sterk getypeerde diagnostische payloads toegevoegd voor commando-, verbindings- en transactiegebeurtenissen.
• Toegevoegd OpenAsync(SqlConnectionOverrides, CancellationToken), waaronder OpenWithoutRetry.
• Ondersteuning voor DateOnly en TimeOnly toegevoegd voor DataTable- en SqlDataRecord-gestructureerde parameters.
• Ondersteuning voor .NET 9 toegevoegd.
• .NET Standard en .NET 6-runtimeonderdelen verwijderd. Ondersteunde doelen werden .NET Framework 4.6.2 en latere versies en .NET 8 en latere versies.
• EnableOptimizedParameterBinding beperkt tot tekstopdrachten.

Uitgaven

5.2

Versie 5.2 werd in februari 2024 algemeen beschikbaar. De laatste patch was 5.2.3, uitgebracht in april 2025.

• Toegevoegd SqlConnection.AccessTokenCallback voor asynchrone, pool-compatibele tokenverwerving.
• Toegevoegd SqlBatch en SqlBatchCommand op .NET 6 en latere versies.
• Ondersteuning voor .NET Standard toegevoegd SqlDiagnosticListener.
• 64-bit SqlBulkCopy.RowsCopied64 toegevoegd. De oudere RowsCopied eigenschap blijft een 32-bits geheel getal.
• Active Directory Workload Identity-authenticatie toegevoegd.
• .NET 8 en big-endian platformondersteuning toegevoegd.
• Gewijzigd UseOneSecFloorInTimeoutCalculationDuringLogin zodat deze standaard op true staat.
• Gebruikt NegotiateAuthentication voor beheerde SSPI op .NET 7 en latere versies.

Uitgaven

5.1

Versie 5.1 werd in januari 2023 algemeen beschikbaar. De laatste patch was 5.1.9, uitgebracht in januari 2026.

• .NET 6-ondersteuning toegevoegd en .NET Core 3.1 is verwijderd.
• Toegevoegd DateOnly en TimeOnly ondersteuning voor parameterwaarden en GetFieldValue.
• TLS 1.3 is toegevoegd aan .NET en de systeemeigen SQL Server Network Interface (SNI)-paden.
• Toegevoegd ServerCertificate voor exacte certificaatovereenstemming met Encrypt=Mandatory en Encrypt=Strict.
• Windows ARM64-ondersteuning toegevoegd voor .NET Framework.
• De SqlConnectionEncryptOption stringparser is publiek gemaakt.
• Versie 5.1.3 verhelpt het CVE-2024-0056-downgradepad voor encryptie en de validatie van de certificaatketen.

Uitgaven

5.0

Versie 5.0 werd in augustus 2022 algemeen beschikbaar. De laatste patch was 5.0.2, uitgebracht in maart 2023.

• TDS 8.0 toegevoegd via Encrypt=Strict. Strict-modus start TLS vóór de TDS-loginuitwisseling en valideert altijd het servercertificaat.
• Veranderd SqlConnectionStringBuilder.Encrypt van bool naar SqlConnectionEncryptOption.
• De SQL Server Common Language Runtime (CLR)-typen zijn verplaatst naar het afzonderlijk geversioneerde Microsoft.SqlServer.Server-pakket.
• Toegevoegde Server SPN en Failover Server SPN verbindingsopties.
• Ondersteuning voor Windows SQL Server alias toegevoegd op de huidige .NET.
• Toegevoegd aan Windows: SqlDataSourceEnumerator.
• Ondersteuning voor .NET Framework 4.6.1 beëindigd.

Uitgaven

4.1

Versie 4.1 werd in januari 2022 algemeen beschikbaar. De laatste patch was 4.1.1, uitgebracht in september 2022.

• Ondersteuning toegevoegd Attestation Protocol=None voor op virtualisatie gebaseerde beveiliging (VBS)-enclaves.
• Paralleliseerde SQL Server Resolution Protocol-verzoeken op Linux en macOS wanneer MultiSubnetFailover ingeschakeld.
• Bevestigde controles van certificaatintrekkingslijsten tijdens authenticatie.
• Problemen met Microsoft Entra-authenticatie, null-SqlBinary- en rowversion-waarden en het gedrag van UTF-8-collatie zijn opgelost.

Uitgaven

4.0

Versie 4.0 werd in november 2021 algemeen beschikbaar. De laatste patch was 4.0.6, uitgebracht in augustus 2024.

• De standaardwaarde van Encrypt is gewijzigd van false naar true.
• Toegevoegd SqlCommand.EnableOptimizedParameterBinding voor commando's met veel parameters.
• Toegevoegd SqlFileStream voor Windows via de .NET Standard-implementatie.
• Gedeelde LocalDB-instantieondersteuning toegevoegd in beheerde SNI.
• Toegevoegd GetFieldValue<T> en GetFieldValueAsync<T> voor XmlReader, TextReader, en Stream.
• De veiligheidsschakelaar uit configureerbare herkansingslogica verwijderd. Retry bleef uitgeschakeld totdat een applicatie een provider configureerde.
• Microsoft Entra-authenticatiefouten aangepast zodat deze SqlException genereren in plaats van AggregateException.
• Ondersteuning voor .NET Core 2.1 is stopgezet.
• Versie 4.0.5 heeft het pad voor encryptiedowngrade in CVE-2024-0056 en de validatie van de certificaatketen verholpen.

Uitgaven

3.1

Versie 3.1 werd in maart 2022 algemeen beschikbaar. De laatste patch was 3.1.7, uitgebracht in augustus 2024.

• Een Attestation Protocol=None toegevoegd voor VBS-enclaves.
• SQL-fouten 42108 en 42109 toegevoegd aan de standaard tijdelijke foutenlijst.
• Windows ARM64-ondersteuning voor .NET Framework toegevoegd in 3.1.2.
• Verminderde herhaalde Microsoft Entra-tokenverzoeken via de acquisitie van stille tokens in 3.1.3.
• Het downgradepad voor encryptie in CVE-2024-0056 is opgelost in 3.1.5.
• Problemen met transactie-opruiming vóór het poolen en de afhandeling van time-outs van Microsoft Entra-tokens zijn opgelost in 3.1.7.

Uitgaven

3.0

Versie 3.0 werd in juni 2021 algemeen beschikbaar. De laatste patch was 3.0.1, uitgebracht in september 2021.

• Voegde configureerbare herprobeerlogica toe voor verbindings- en commandobewerkingen. In 3.0 bleef het optioneel achter Switch.Microsoft.Data.SqlClient.EnableRetryLogic.
• EventCounters toegevoegd voor verbinding en poolactiviteiten.
• Authenticatie toegevoegd via Azure.IdentityActive Directory Default.
• Registratie van Always Encrypted-sleutelarchiefproviders met verbindingsbereik en opdrachtsbereik is toegevoegd.
• Voorkeur voor het TCP IP-adres toegevoegd.
• Authenticatie met een door de gebruiker toegewezen beheerde identiteit gewijzigd zodat de client-ID wordt gebruikt in plaats van de object-ID in User Id.
• SQL-rowversion-nullwaarden gewijzigd zodat DBNull wordt geretourneerd in plaats van een lege byte-array. Een AppContext-schakelaar behield het oudere gedrag.
• Het minimale doel voor het .NET Framework is verhoogd van 4.6 naar 4.6.1.

Providers van systeemsleutelopslag krijgen met ingang van versie 3.0 voorrang boven providers die voor een verbinding of opdracht zijn geregistreerd. Hernoem een aangepaste provider als de naam conflicteert met die van een ingebouwde provider.

Uitgaven

2.1

Versie 2.1 werd in november 2020 algemeen beschikbaar. De laatste patch was 2.1.7, uitgebracht in januari 2024.

• Always Encrypted uitgebreid naar ondersteunde .NET Standard 2.0-platforms.
• Veilige enclave-ondersteuning toegevoegd op Unix voor .NET Core en over .NET Standard 2.1-platforms.
• Identiteitsauthenticatie toegevoegd Active Directory Device Code Flow en beheerd.
• Aanpassingshaken toegevoegd voor interactieve en apparaatcode-authenticatie.
• Gevoeligheidsclassificatie-rang metadata toegevoegd.
• SqlConnection.ServerProcessIdtoegevoegd.
• De Command Timeout-verbindingsoptie is toegevoegd als standaardoptie voor opdrachten die via een verbinding worden gemaakt.
• Versie 2.1.7 heeft het pad voor een downgrade van versleuteling in CVE-2024-0056 verholpen.

Uitgaven

2.0

Versie 2.0 werd in juni 2020 algemeen beschikbaar. De laatste patch was 2.0.1, uitgebracht in augustus 2020.

• Toegevoegd Active Directory Integrated en Active Directory Interactive authenticatie op .NET Core en .NET Standard.
• Active Directory Service Principal-authenticatie toegevoegd.
• Microsoft.Data.SqlClient.EventSource Tracering toegevoegd.
• Cross-platform TCP keep-alive en een opt-in managed networking-implementatie op Windows toegevoegd voor testen en debugging. Het beheerde pad ondersteunde geen niet-domein-Windows-verificatie.
• SqlBulkCopy.RowsCopied toegevoegd en bulk-copy-hints geordend.
• SqlConnection.Open(SqlConnectionOverrides.OpenWithoutRetry)toegevoegd.
• Windows ARM-ondersteuning toegevoegd via de Microsoft.Data.SqlClient.SNI.runtime afhankelijkheid.
• Begon het servercertificaat te valideren wanneer een server versleuteling afdwingt, ook wanneer de verbindingsreeks is ingesteld op Encrypt=false. Verbindingen kunnen na deze upgrade falen als het certificaat niet wordt vertrouwd of de naam niet overeenkomt met de server.
• De verwerking van de schaal van decimale parameters is gewijzigd zodat SQL Server-compatibele afronding wordt gebruikt.

Uitgaven

1,1

Versie 1.1 werd in november 2019 algemeen beschikbaar. De laatste patch was 1.1.4, uitgebracht in maart 2021.

• Always Encrypted met beveiligde enclaves toegevoegd op ondersteunde .NET Framework- en .NET Core-platforms.
• Toevoeging van uitbreiding van AttachDBFilename in |DataDirectory| op .NET Core.
• Verbeterde asynchrone leesbewerkingen met caching van doelbuffers voor meerdere pakketten.
• Verminderde snapshot-overhead in TdsParserStateObject en SqlDataReader.
• Problemen met de time-outstatus en headerfouten in Multiple Active Result Sets (MARS) zijn verholpen in latere patches.

Uitgaven

1.0

Microsoft. Data.SqlClient 1.0 werd in augustus 2019 algemeen beschikbaar. De laatste patch was 1.0.19269.1, uitgebracht in september 2019.

• De afzonderlijk geleverde Microsoft.Data.SqlClient provider toegevoegd.
• Ondersteunde .NET Framework 4.6 en latere versies, .NET Core 2.1 en latere versies, en .NET Standard 2.0.
• Active Directory InteractiveAuthenticatie toegevoegd aan .NET Framework.
• Active Directory PasswordAuthenticatie toegevoegd op .NET Core.
• Metadata voor gegevensgevoeligheidsclassificatie toegevoegd op SqlDataReader.
• Ondersteuning voor SQL Server 2019 UTF-8 samenvoeging toegevoegd.
• Altijd versleutelde ondersteuning toegevoegd op .NET Core.

Uitgaven

Voor een applicatie die van de oudere provider overgaat, gebruik Migrate from System.Data.SqlClient naar Microsoft. Data.SqlClient in plaats van alleen release notes te lezen.

Opmerkingen bij de release van het optionele pakket

Optionele pakketten hebben hun eigen release notes. Vanaf versie 7.0.2 lopen hun versies gelijk met die van de core-driver.

Verwijs niet direct naar Microsoft.Data.SqlClient.Internal.Logging. Het is een interne afhankelijkheid die gedeeld wordt door driverpakketten.

Evalueer een update

1. Identificeer elke driver en optionele pakketversie die direct of transitief wordt gebruikt.
2. Lees de release notes van elke kleine en grote versie die door de update is gekruist.
3. Controleer de levenscyclus van SqlClient-driverondersteuning voor compatibiliteit van het doelframework en database.
4. Werk alle gerelateerde pakketten bij naar compatibele versies.
5. Bouw en test de authenticatie, encryptie, verbindingspooling, parameters, transacties, herpogingen, diagnostiek en deployment-output van de applicatie.

Voor installatie- en deploymentcommando's, zie Installeren, updaten en deployen Microsoft. Data.SqlClient.

Verwante onderwerpen

• Installeren, bijwerken en implementeren Microsoft.Data.SqlClient
• Ondersteuningslevenscyclus van SqlClient-stuurprogramma
• Migrer van System.Data.SqlClient naar Microsoft. Data.SqlClient
• Microsoft. Data.SqlClient release-notities