Co je nového v Microsoftu. Data.SqlClient

Microsoft. Data.SqlClient je dodáván nezávisle na .NET. Tento článek shrnuje významné funkce, změny chování a kompatibilitu v každé linii vydání. Tabulky vydání zahrnují všechny publikace stabilních balíčků, včetně všech hotfixů a nezařazených balíčků. Pro každou opravu a aktualizaci závislostí viz kompletní poznámky k vydání v repozitáři SqlClient.

Aktuální verze

Řada vydání Nejnovější verze Datum vydání Support
7.1 7.1.0 Září 2026 Standardní dlouhodobá podpora (STS)
7.0 7.0.3 Září 2026 Standardní dlouhodobá podpora (STS)
6.1 6.1.7 Září 2026 Dlouhodobá podpora (LTS)

Nepoužívejte předběžná vydání v produkčním prostředí. Preview API a chování se mohou změnit před obecnou dostupností (GA).

Tabulky vydání a souhrny obecné dostupnosti používají měsíc vydávání NuGet. Článek o životním cyklu uvádí oficiální data vydání, která se mohou lišit. Pro okna podpory viz životní cyklus podpory ovladačů SqlClient.

7.1 STS

Verze 7.1 byla všeobecně dostupná v září 2026. Je to současná linka STS.

Vlastnosti a změny

  • SqlBatchpodpora pro .NET Framework.
  • Asynchronní SqlConnection.GetSchemaAsync přetížení.
  • Hlášení identity aplikací prostřednictvím SqlConnection.RegisteredApplication a verze 2 TDS USERAGENT payloadu. Nastavte vlastnost před otevřením připojení. Hodnota není součástí klíče fondu připojení, takže znovu použité fyzické připojení vrací informaci o aplikaci, která ho původně vytvořila. Identita aplikace je telemetrie dodávaná klientem, nikoli základ pro autorizaci nebo jiné bezpečnostní rozhodnutí.
  • Aliasy spojovacích řetězců jako ColumnEncryption, ConnectTimeout, FailoverPartner, PacketSize, a .WorkstationId
  • Mapování pseudosloupců SQL Graph pro $node_id, $edge_id, $from_id a $to_id v SqlBulkCopy.
  • Typ SQL Server json v kolekci DataTypes vrácené funkcí SqlConnection.GetSchema, včetně Azure SQL.
  • Vynucení opt-in Connection Idle Timeout prostřednictvím Switch.Microsoft.Data.SqlClient.UseLegacyIdleTimeoutBehavior=false. Výchozí časový limit nečinnosti je 300 sekund; 0 vypne vypršení po době nečinnosti. Výchozí chování poolování zůstává nezměněno.
  • Volitelný režim časového limitu připojení, který zahrnuje čas strávený čekáním na připojení z fondu přes Switch.Microsoft.Data.SqlClient.UseOverallConnectTimeoutForPoolWait=true. Přepínač se ve výchozím nastavení nastaví na false.
  • Rozšířená podpora transakcí, obnova přerušených spojení, zahřátí poolu, odstraňování nečinných připojení, navrácení uniklých připojení a diagnostika v connection poolu V2. Fond je stále vyhodnocován a vyžaduje Switch.Microsoft.Data.SqlClient.UseConnectionPoolV2.
  • Asynchronní metody u poskytovatelů úložiště klíčů pro Always Encrypted. Ovladač tyto metody zatím při vykonávání příkazů nevolá, takže stávající operace Always Encrypted nejsou asynchronní.
  • Aktualizovány nativní balíčky SNI na verzi 7.1.0. Podporovanými cíli aplikací zůstávají .NET Framework 4.6.2 a novější verze a .NET 8 a novější verze.

Změny kompatibility

  • SqlConnectionStringBuilder.TransparentNetworkIPResolutionje na .NET Framework zastaralý. Místo toho použijte MultiSubnetFailover. Tato změna přidává varování při kompilaci; nemění chování běhu ani výchozí nastavení žádné z možností.
  • SqlBatchCommand.CommandBehavior a CommandBehavior předané do SqlBatch.ExecuteReader jsou respektovány. Starší verze tato nastavení ignorovaly.
  • Zastaralá Type System Version=SQL Server 2000 možnost připojení nyní při otevření připojení vyvolá ArgumentException. Použijte podporovanou hodnotu, například Latest.

Verze 7.1 také obsahuje opravy ověřování certifikátů a enklávy, které byly servisovány ve verzích 6.1.7 a 7.0.3. Když povolíte validaci certifikátů na spravovaném SNI, ServerCertificate porovná konfigurovaný soubor certifikátu s certifikátem, který server předloží. Neplatný nebo nečitelný soubor způsobí selhání spojení namísto obejití konfigurované kontroly certifikátů. Ověření enklávy pomocí virtuálního zabezpečeného režimu (VSM) a služby Host Guardian Service (HGS) ověřuje, že veřejný klíč enklávy je vázán na podepsanou potvrzovací zprávu. Tyto cesty znovu otestujte, když budete upgradovat z předchozí verze bez těchto oprav.

Klíčové opravy

  • Opravena připojení ve fondu, která po rollbacku TransactionScope zůstávala přerušená, což mohlo způsobit selhání pozdějšího volání BeginTransaction().
  • Opraveny literální názvy serverů IPv6 přes pojmenované kanály ve spravovaném SNI.
  • Opraveno přetečení velkých parametrů decimal s explicitní přesností a škálováním, parametrů DateOnly a tabulkových parametrů pomocí sql_variant a přeskakování streamovaných sloupcových dat po IsDBNull().
  • Opraveny čítače fondu připojení, zbytečná aktivita časovače údržby fondu a regrese propustnosti při otevírání a zavírání fondu připojení V2.
  • Opravená konfigurovatelná logika opakovaných pokusů, která registruje trvalou obslužnou rutinu pro překlad assembly pro celý proces na moderním .NET. Vlastní sestavy pro opakované pokusy musí být v základním adresáři aplikace; závislosti načtené po vytvoření poskytovatele musí být přeloženy pomocí standardního mechanismu řešení závislostí aplikace nebo pomocí obslužné rutiny poskytované aplikací.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
7.1.0 Září 2026 Vydání v obecné dostupnosti, včetně kumulativních změn z cyklu Preview 7.1.

Important

Upgradujte přímo odkazované doplňkové balíčky na 7.1.0 spolu s jádrovým ovladačem, včetně Microsoft.Data.SqlClient.Extensions.Azure, Microsoft.Data.SqlClient.Extensions.Abstractions, a Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider. Nechť se Microsoft.Data.SqlClient.Internal.Logging vyřeší tranzitivně. Zarovnané sestavy si zachovávají AssemblyVersion 7.0.0.0, takže aktualizace z verze 7.0.2 nebo 7.0.3 nevyžaduje nová přesměrování vazeb rozhraní .NET Framework. Když aktualizujete z verze 7.0.0 nebo 7.0.1, zkontrolujte jednorázové změny verzí sestavení popsané v poznámkách k verzi 7.0.2.

Vydání Azure Key Vault Provider 7.1.0 implementuje asynchronní metody poskytovatele úložiště klíčů a opravuje růst cache a duplicitní klienty klíčů při souběžném zpracování. Tyto asynchronní metody jsou přínosem pro přímá volání poskytovatele; cesty vykonávání příkazů ovladače stále používají synchronní operace s klíči. Rozšíření Azure a abstrakce rozšíření mají sladěné verze vydání bez změn veřejného API.

Pro historii náhledů viz poznámky k vydání pro preview1, preview2 a preview3.

7.0 STS

Verze 7.0 byla všeobecně dostupná v březnu 2026. Podpora zůstává až do 17. prosince 2026, tedy tři měsíce po vydání verze 7.1.

Vlastnosti a změny

  • Ovladačem poskytovaná autentizace Microsoft Entra byla přesunuta z jádra balíčku do Microsoft.Data.SqlClient.Extensions.Azure. Přidejte rozšíření při použití autentizačního služba Active Directory režimu.
  • Základní balíček již nezávisí na Azure.Core, Azure.Identity, ani Identity a ověřování Microsoftu (MSAL).
  • SqlConnection.SspiContextProvider podporuje vlastní vyjednávání tokenů Kerberos a NTLM. Identita poskytovatele je součástí klíče poolu připojení.
  • Vylepšené směrování pro Azure SQL Hyperscale a pojmenované repliky pro čtení se sjednává automaticky.
  • Striktně typované diagnostické události pro příkazy, připojení a transakce jsou k dispozici v rozhraní .NET Framework i v aktuálním .NET.
  • SqlConfigurableRetryFactory.BaselineTransientErrors odhaluje výchozí seznam přechodných chyb ovladače.
  • služba Active Directory Password Autentizace je zastaralá. Používejte interaktivní autentizaci pro uživatelské aplikace, autentizaci principálu služby pro služby nebo spravovanou identitu pro pracovní zátěže hostované v Azure.
  • Podpora cílových verzí je k dispozici od .NET Framework 4.6.2 a .NET 8. Ovladač také podporuje budování a spouštění na .NET 10.

Multiplexování paketů pro asynchronní čtení zůstává funkcí náhledu a je v 7.0 dobrovolně zajišťováno. Testujte kompatibilitní změny s produkčními zátěžemi a udržujte cestu zpětného návratu.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
7.0.0 Březen 2026 Obecné uvolnění.
7.0.1 Duben 2026 Byly opraveny dotazy na metadata SqlBulkCopy pro SQL Server 2016 a vyhrazené fondy SQL služby Azure Synapse Analytics, opravena metadata vektorových polí, přidána chybějící závislost na rozhraní .NET Framework System.Data.Common a přidáno předávání typů pro autentizační abstrakce.
7.0.2 Červen 2026 Sjednotil základní ovladač a doprovodné balíčky, zvýšil odolnost parsování tokenů TDS, opravil zpracování mezipaměti pro ověřování podpisů v Always Encrypted a opravil chyby při rušení a při voláních s null bufferem GetBytes a GetChars.
7.0.3 Září 2026 Aktualizoval jsem SNI na 6.0.3. Opraven přístup k metadatům SqlBulkCopy, trasování alokací, ověřování ServerCertificate ve spravovaném SNI, ověřování attestačního klíče enklávy Always Encrypted, výchozí nastavení TNIR AccessTokenCallback v .NET Frameworku, zachování stavu ověřování a konfigurovatelné zjišťování sestavení při opakování. Konfliktní nastavení autentizace SSPI a tokenů nyní vyvolá chybu InvalidOperationException. Rozšíření Aligned Azure opravuje parsování autority Entra pro připojení k Dataverse a Dynamics 365.

Important

Od 7.0.2 zarovnejte přímé odkazy na Microsoft.Data.SqlClient, Microsoft.Data.SqlClient.Extensions.Azure, Microsoft.Data.SqlClient.Extensions.Abstractions, a Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider. Nechť se Microsoft.Data.SqlClient.Internal.Logging vyřeší tranzitivně. V .NET Framework se verze sestavení Extensions.Azure, Extensions.Abstractions a Internal.Logging změnily z 1.0.0.0 na 7.0.0.0. Znovu sestavte aplikaci nebo přidejte přesměrování vazeb, když aktualizujete tyto balíčky.

6.1 LTS

Verze 6.1.0 byla vydána v červenci 2025, ale později byla kvůli kritickým regresím vyřazena. Verze 6.1.1, vydaná v srpnu 2025, zavedla podporovanou řadu 6.1 LTS.

Vlastnosti a změny

  • Nativní přenos vektorů v SQL Serveru 2025 přes SqlVector<T>, zpočátku pro vektory s pohyblivou řádovou čárkou s jednoduchou přesností.
  • Referenční asset pro .NET Standard 2.0 pro kompatibilitu s knihovnami. Tato položka není implementací za běhu. Spustitelné aplikace musí používat podporovaný .NET nebo .NET Framework runtime asset.
  • Volitelná podpora multiplexování paketů pro velká asynchronní čtení a zpracování koncových bodů pro databázi SQL v Microsoft Fabric.
  • Vylepšená podpora nativní kompilace Ahead-of-Time (AOT).
  • Snížili jsme počet alokací při zpracování připojení a TDS.
  • Interní základy pro rozšiřitelnost veřejného rozhraní Security Support Provider Interface (SSPI) byly přidány v 7.0.

Nenasazujte verzi 6.1.0. Verze 6.1.1 vrátila zpět dotčené změny detekce a přehrávání paketů.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
6.1.0 Červenec 2025 Obecné uvolnění. Tento balíček byl kvůli kritickým regresím nezařazen. Nepoužívejte ho.
6.1.1 Srpen 2025 Obnovil jsem změny v detekci částečných paketů, opravách a přehrávání z verze 6.1.0. Korigované vektorové referenční sestavy a SqlVector<T>.Null.
6.1.2 Říjen 2025 Opravena raná inicializace výkonnostních čítačů, nahrazení vlastních autentizačních poskytovatelů a souběžnost poolu, která znemožnila využití maximální velikosti nakonfigurovaného poolu.
6.1.3 listopad 2025 Přidáno IgnoreServerProvidedFailoverPartner pro základní skupiny dostupnosti a vlastní porty. Opravena předčasná inicializace metrik EventSource.
6.1.4 Leden 2026 Přidáno EnableMultiSubnetFailoverByDefault. Opravené SqlDataAdapter selhání dávkování a záporné počty aktivních spojení v metrikách poolu.
6.1.5 Duben 2026 Byla odstraněna zbytečná práce se službou Service Principal Name (SPN) a systémem Domain Name System (DNS) pro neintegrované ověřování, bylo zajištěno, že ExecuteScalar předává chyby serveru vrácené po datech, a byly opraveny datové typy metadat vektorů.
6.1.6 Červen 2026 Přidána volitelná podpora zprostředkovatele Windows Web Account Manager (WAM), zpřísněno parsování tokenů TDS, opravena selhání podpisu hlavního klíče sloupce uloženého v mezipaměti a opravena validace argumentů GetChars.
6.1.7 Září 2026 Aktualizoval jsem SNI na 6.0.3. Opravena byla ServerCertificate validace na spravovaném SNI, ověření attestačního klíče enclave Always Encrypted, AccessTokenCallback výchozí nastavení TNIR v .NET Frameworku, stav tokenové autentizace v klíčích fondu připojení, ověřování certifikátu před přihlášením pomocí zpětného volání a konfigurovatelný překlad sestavení pro opakované pokusy.

Předchozí verze

Následující řady verzí již nejsou podporovány. Použijte jejich shrnutí, když plánujete upgrade na více verzí ovladačů.

6.0

Verze 6.0 byla všeobecně dostupná v lednu 2025. Poslední patch byl 6.0.5, vydaný v lednu 2026.

  • Přidána nativní podpora formátu JSON v SQL Serveru pomocí Microsoft.Data.SqlTypes.SqlJson, včetně podpory pro čtení, zápis, streamování a hromadné kopírování.
  • Přidány veřejné, silně typované diagnostické payloady pro příkazy, spojení a transakční události.
  • Přidáno OpenAsync(SqlConnectionOverrides, CancellationToken), včetně OpenWithoutRetry.
  • Byla přidána podpora DateOnly a TimeOnly ve strukturovaných parametrech DataTable a SqlDataRecord.
  • Přidána podpora .NET 9.
  • Vyřadil jsem runtime assety .NET Standard a .NET 6. Podporovanými cíli se staly .NET Framework 4.6.2 a novějšími verzemi a .NET 8 a pozdějšími verzemi.
  • Omezeno EnableOptimizedParameterBinding na textové příkazy.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
6.0.0 ledna 2025 Obecné uvolnění. Tento balíček není na NuGetu uveden a poznámky v upstream neobsahují důvod.
6.0.1 ledna 2025 Opraveny SqlClientDiagnostic odkazovaná rozhraní API, varování týkající se starších verzí TLS a závislosti.
6.0.2 Duben 2025 Opraveny možné chyby při příjmu ze socketu způsobené hodnotou null, rozhraní API pro reference SqlJson, výstupní parametry JSON a závislosti.
6.0.3 Říjen 2025 Bylo zabráněno nahrazení vlastních autentizačních poskytovatelů a opravena souběžnost fondu, která nedostatečně využívala Max Pool Size.
6.0.4 listopad 2025 Přidáno Switch.Microsoft.Data.SqlClient.IgnoreServerProvidedFailoverPartner pro základní skupiny dostupnosti, které používají vlastní TCP porty.
6.0.5 Leden 2026 Byla opravena obsluha hodnoty null v dávkovém RPC, přidáno Switch.Microsoft.Data.SqlClient.EnableMultiSubnetFailoverByDefault a aktualizovány závislosti.

5.2

Verze 5.2 byla všeobecně dostupná v únoru 2024. Poslední patch byl 5.2.3, vydaný v dubnu 2025.

  • Přidáno SqlConnection.AccessTokenCallback pro asynchronní získávání tokenu kompatibilní s fondem.
  • Přidáno SqlBatch a SqlBatchCommand na verzích .NET 6 a novějších.
  • Byla přidána podpora SqlDiagnosticListener pro .NET Standard.
  • Přidáno 64bitové SqlBulkCopy.RowsCopied64. Starší RowsCopied vlastnost zůstává 32bitovým celým číslem.
  • Přidáno služba Active Directory Workload Identity ověření.
  • Přidána podpora .NET 8 a platforem typu big-endian.
  • Výchozí hodnota UseOneSecFloorInTimeoutCalculationDuringLogin byla změněna na true.
  • Používá se NegotiateAuthentication pro spravované SSPI na verzích .NET 7 a novějších.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
5.2.0 Únor 2024 Obecné uvolnění.
5.2.1 Květen 2024 Opravena připojení k pojmenovaným instancím v Linuxu přes porty, FireInfoMessageEventOnUserErrors, tabulkové parametry typu datetimeoffset(n), opožděné OpenAsync a zachování AccessTokenCallback pomocí SqlConnection.Clone().
5.2.2 Srpen 2024 Pevné časové limity tokenů, spravované připojení SNI socketů, cílení assembleru, SSPI opakovaní, uživatelsky definované čtení typů a šifrovaná data čtečky. Aktualizované balíčky identit pro CVE-2024-35255.
5.2.3 Duben 2025 Opravena byla možná selhání při příjmu ze socketu způsobená hodnotou null a nekonzistence v referenčních sestaveních, povolena byla záporná čísla přechodných chyb a byly aktualizovány závislosti.

5.1

Verze 5.1 byla všeobecně dostupná v lednu 2023. Poslední patch byl 5.1.9, vydaný v lednu 2026.

  • Přidal jsem podporu .NET 6 a vyřadil .NET Core 3.1.
  • Byla přidána podpora pro DateOnly a TimeOnly hodnot parametrů a GetFieldValue.
  • Byla přidána podpora TLS 1.3 do .NET a nativních cest rozhraní SQL Server Network Interface (SNI).
  • Přidáno ServerCertificate pro přesnou shodu certifikátů s Encrypt=Mandatory a Encrypt=Strict.
  • Přidána podpora Windows ARM64 pro .NET Framework.
  • Zpřístupněn analyzátor řetězců SqlConnectionEncryptOption.
  • Verze 5.1.3 opravila cestu degradace šifrování CVE-2024-0056 a validaci řetězce certifikátů.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
5.1.0 leden 2023 Obecné uvolnění.
5.1.1 Březen 2023 Opraveno hlášení chyb funkce Always Encrypted, transakce v režimu přesměrování, omezování tokenů, selhání TDS RPC u rozsáhlých dotazů a zpracování hodnot null GetBytesAsync.
5.1.2 Října 2023 Byly opraveny uživatelské instance SQL Express, opakované pokusy pro enklávy, LocalDB, hodnoty tvůrce připojovacího řetězce, převod konfigurace SqlConnectionEncryptOption a přechodné chyby OpenAsync.
5.1.3 ledna 2024 Byla opravena chyba CVE-2024-0056 a ověřování certifikačního řetězce.
5.1.4 ledna 2024 Opraveno uváznutí v distribuované transakci .NET a aktualizována komponenta Azure.Identity kvůli CVE-2023-36414.
5.1.5 ledna 2024 Opraveno čištění transakcí před sdružováním připojení a selhání při převodu data a času v Always Encrypted. Aktualizovány závislosti IdentityModel pro CVE-2024-21319.
5.1.6 Srpen 2024 Opravené OpenAsync, autentizační časové limity a selhání čekajících dat u šifrovaných čteček. Aktualizovány závislosti identity pro CVE-2024-35255 a instance v mezipaměti TokenCredential.
5.1.7 Duben 2025 Byla opravena možná chyba s hodnotou null při příjmu přes socket, sjednoceny zdrojové a referenční sestavy a aktualizovány závislosti.
5.1.8 listopad 2025 Přidáno Switch.Microsoft.Data.SqlClient.IgnoreServerProvidedFailoverPartner, opraveno zpracování značky pořadí bajtů UTF-8 při hromadném kopírování, modernizováno vytváření MSAL a aktualizovány závislosti.
5.1.9 Leden 2026 Přesunuli jsme časování Environment.TickCount do SqlStatistics a aktualizovali závislosti specifické pro framework.

5.0

Verze 5.0 byla všeobecně dostupná v srpnu 2022. Poslední patch byl 5.0.2, vydaný v březnu 2023.

  • Přidáno TDS 8.0 až .Encrypt=Strict Přísný režim spustí TLS před výměnou přihlášení do TDS a vždy ověřuje certifikát serveru.
  • Změněno SqlConnectionStringBuilder.Encrypt z bool na SqlConnectionEncryptOption.
  • Přesunuli jsme typy CLR pro SQL Server do samostatně verzovaného balíčku Microsoft.SqlServer.Server.
  • Přidány Server SPNFailover Server SPN možnosti připojení.
  • Přidána podpora aliasů Windows SQL Serveru v aktuálním .NET.
  • Přidáno SqlDataSourceEnumerator v systému Windows.
  • Opustil jsem .NET Framework 4.6.1.

Important

Změna typu SqlConnectionStringBuilder.Encrypt narušuje binární kompatibilitu. Typy odebrané z Microsoft.Data.SqlClient.Server také vyžadují změny ve zdroji, aby používaly Microsoft.SqlServer.Server. Znovu zkompilujte aplikace a knihovny, aktualizujte obory názvů a zkontrolujte konflikty oborů názvů, pokud na System.Data.SqlClient stále existují odkazy.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
5.0.0 Srpen 2022 Obecné uvolnění.
5.0.1 Říjen 2022 Obnoveno HostNameInCertificate v .NET Frameworku a opraveno zablokování pozornosti, SqlConnectionStringBuilder.Encrypt, registrace při zrušení, řízené zaseknutí SNI, kolace UTF-8 a pád SNI aplikační domény.
5.0.2 Březen 2023 Opraveny únik paměti při asynchronním čtení, režim přesměrování TransactionScope, chyby funkce Always Encrypted, selhání volání TDS RPC při velkých dotazech a uváznutí distribuovaných transakcí.

4.1

Verze 4.1 byla všeobecně dostupná v lednu 2022. Poslední patch byl 4.1.1, vydaný v září 2022.

  • Přidáno Attestation Protocol=None pro enklávy zabezpečení založené na virtualizaci (VBS).
  • Paralelní požadavky protokolu SQL Server Resolution Protocol v Linuxu a macOS při povolení MultiSubnetFailover.
  • Během ověřování se kontroluje seznam odvolání certifikátů s pevnou kontrolou.
  • Byly opraveny ověřování Microsoft Entra, hodnoty null SqlBinary a rowversion a chování řazení UTF-8.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
4.1.0 leden 2022 Obecné uvolnění.
4.1.1 Září 2022 Byla opravena selhání seznamu odvolaných certifikátů, byly paralelizovány požadavky protokolu SQL Server Resolution Protocol pro MultiSubnetFailover a byla opravena selhání související s ověřováním Microsoft Entra, rowversion, UTF-8 a aplikačními doménami SNI.

4.0

Verze 4.0 byla všeobecně dostupná v listopadu 2021. Poslední patch byl 4.0.6, vydaný v srpnu 2024.

  • Změnila jsem výchozí hodnotu Encrypt z false na .true
  • Přidáno SqlCommand.EnableOptimizedParameterBinding u příkazů s mnoha parametry.
  • Přidáno SqlFileStream pro Windows prostřednictvím implementace .NET Standard.
  • Přidána podpora sdílených instancí LocalDB v spravovaném SNI.
  • Přičte GetFieldValue<T> a GetFieldValueAsync<T> pro XmlReader, TextReader, a .Stream
  • Odstraněn bezpečnostní spínač z konfigurovatelné logiky opakování. Opakování zůstalo zakázáno, dokud aplikace nenakonfigurovala poskytovatele.
  • Selhání ověřování Microsoft Entra nyní vyvolají SqlException místo AggregateException.
  • Zrušeno .NET Core 2.1.
  • Verze 4.0.5 opravila cestu degradace šifrování CVE-2024-0056 a validaci řetězce certifikátů.

Important

Protože je ve verzi 4.0 a novějších verzích šifrování ve výchozím nastavení nastaveno na true, může upgrade odhalit problémy s důvěryhodností certifikátu nebo nesoulad názvu serveru. Nevypínejte šifrování, abyste obešli tyto chyby. Nainstalujte certifikát důvěryhodného serveru nebo nakonfigurujte validaci certifikátů pro nasazení.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
4.0.0 Listopad 2021 Obecné uvolnění.
4.0.1 leden 2022 Přidána podpora pro SuppressInsecureTLSWarning a opraveny problémy s protokolem Kerberos v .NET 6, názvy kanálů v LocalDB a souběžné dotazy na enklávy.
4.0.2 Září 2022 Byla opravena selhání seznamu odvolaných certifikátů, byly paralelizovány požadavky protokolu SQL Server Resolution Protocol pro MultiSubnetFailover a byla opravena selhání související s ověřováním Microsoft Entra, rowversion, UTF-8 a aplikačními doménami SNI.
4.0.3 Duben 2023 Bylo sníženo omezování tokenů u účtů v mezipaměti a opravena selhání TDS RPC při velkých dotazech.
4.0.4 Října 2023 Opraveny asynchronní opakované pokusy enklávy, záložní mechanismus pro LocalDB a spravované SNI, verze souborů a korelace aktivity připojení.
4.0.5 ledna 2024 Byla opravena chyba CVE-2024-0056 a ověřování certifikačního řetězce.
4.0.6 Srpen 2024 Pevné čištění transakčních událostí před sdružováním a ActiveDirectoryAuthenticationProvider.AcquireTokenAsync řešení časového limitu.

3.1

Verze 3.1 byla všeobecně dostupná v březnu 2022. Poslední patch byl 3.1.7, vydaný v srpnu 2024.

  • Přidáno Attestation Protocol=None pro enklávy VBS.
  • Přidány SQL chyby 42108 a 42109 do výchozího seznamu přechodných chyb.
  • Přidáno podpora Windows ARM64 pro .NET Framework ve verzi 3.1.2.
  • Snížena opakovaná poptávka na tokeny Microsoft Entra prostřednictvím tichého získávání tokenů ve verzi 3.1.3.
  • Ve verzi 3.1.5 byla opravena zranitelnost CVE-2024-0056 umožňující snížení úrovně šifrování.
  • Fixní čištění transakcí před poolováním a řešení timeoutu tokenů Microsoft Entra ve verzi 3.1.7.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
3.1.0 Březen 2022 Obecné uvolnění.
3.1.1 Srpen 2022 Opraveny hodnoty null SqlBinaryrowversion, selhání protokolu Kerberos v .NET 6 a selhání ověřování Microsoft Entra způsobená odkazem na hodnotu null.
3.1.2 Únor 2023 Byla přidána podpora .NET Frameworku pro Windows ARM64 a byly opraveny problémy s bezpečností vláken seznamu opakování, uváznutím distribuovaných transakcí, řazením UTF-8 a ověřováním uložených procedur.
3.1.3 Březen 2023 Bylo omezeno omezování tokenů Microsoft Entra pomocí AcquireTokenSilent a opravena selhání RPC TDS při velkých dotazech.
3.1.4 Října 2023 Byly opraveny asynchronní opakované pokusy enklávy, záložní mechanismus pro LocalDB a spravované SNI, verze souborů, korelace aktivit připojení a formátování EventSource.
3.1.5 ledna 2024 Byla opravena chyba CVE-2024-0056 a ověřování certifikačního řetězce.
3.1.6 Srpen 2024 Tento balíček nebyl řádně podepsán a byl nezveřejněný. Soubor s poznámkami k vydání z upstreamu neexistuje. Použijte místo toho verzi 3.1.7.
3.1.7 Srpen 2024 Opraveno čištění transakčních událostí před poolováním, časové limity autentizace, podepsání assembleru a pád SNI aplikační domény.

3.0

Verze 3.0 byla všeobecně dostupná v červnu 2021. Poslední patch byl 3.0.1, vydaný v září 2021.

  • Přidána konfigurovatelná logika opakovaných pokusů pro operace připojení a provádění příkazů. Ve verzi 3.0 to stále zůstalo jako volitelná funkce za Switch.Microsoft.Data.SqlClient.EnableRetryLogic.
  • Přidány EventCountery pro připojení a aktivitu poolu.
  • Přidáno služba Active Directory Default ověření přes Azure.Identity.
  • Přidána registrace poskytovatele úložiště klíčů Always Encrypted s rozsahem připojení a příkazu.
  • Přidána předvolba adresy TCP/IP.
  • Změnila se autentizace spravované identity přiřazené uživatelem tak, aby v User Id používala místo ID objektu ID klienta.
  • Změněny hodnoty SQL rowversion null tak, aby se vracely DBNull místo prázdného pole bajtů. Přepínač AppContext zachoval starší chování.
  • Minimální cíl pro .NET Framework byl zvýšen z 4.6 na 4.6.1.

Poskytovatelé úložiště systémových klíčů mají od verze 3.0 přednost před poskytovateli registrovanými u připojení nebo příkazu. Přejmenujte vlastního poskytovatele, pokud jeho název koliduje s vestavěným poskytovatelem.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
3.0.0 Červen 2021 Obecné uvolnění.
3.0.1 Září 2021 Byly opraveny problémy s blokujícím navazováním připojení k Microsoft Entra, se stavem povýšení transakcí, s vyžadovaným šifrováním, s rekurzí při opakovaných pokusech, s uváznutími a s nepoužitelnými připojeními.

2.1

Verze 2.1 byla všeobecně dostupná v listopadu 2020. Poslední patch byl 2.1.7, vydaný v lednu 2024.

  • Rozšířili jsme podporu funkce Always Encrypted na podporované platformy .NET Standard 2.0.
  • Přidána podpora zabezpečených enkláv na Unixu pro .NET Core a napříč platformami .NET Standard 2.1.
  • Přidány služba Active Directory Device Code Flow a ověřování pomocí spravované identity.
  • Přidány body pro přizpůsobení pro interaktivní ověřování a ověřování pomocí kódu zařízení.
  • Byla přidána metadata úrovně klasifikace citlivosti.
  • Přidáno SqlConnection.ServerProcessId.
  • Přidáno je možnost Command Timeout připojení jako výchozí pro příkazy vytvořené připojením.
  • Verze 2.1.7 opravila cestu degradace šifrování CVE-2024-0056.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
2.1.0 Listopad 2020 Obecné uvolnění.
2.1.1 Prosinec 2020 Pevná systémově přiřazená spravovaná identita v Azure Functions, Unix Kerberos a TCP keep-alive.
2.1.2 Březen 2021 Byly opraveny pojmenované instance systému Unix, nesprávné výsledky při vypršení časového limitu, nezabezpečené zpracování DTD, názvy SPN protokolu Kerberos, chybějící závislosti ukládání do mezipaměti, trasování a hlavičky MARS.
2.1.3 Květen 2021 Bylo zabráněno poškození transakčních dat při otevřených sadách výsledků a byl opraven souběh mezi SinglePhaseCommit a TransactionEnded.
2.1.4 Září 2021 Zajištěná spojení selžou, když je potřeba šifrování, a pevná spojení vstupují do nepoužitelného stavu.
2.1.5 Srpen 2022 Přidáno ověření délky uložených procedur CommandText a opravená autentizace .NET 6 Kerberos a SqlTypeWorkarounds.
2.1.6 Duben 2023 Opravena byla selhání TDS RPC u rozsáhlých dotazů v SqlCommand.ExecuteReaderAsync, konflikty výchozího řazení UTF-8 a deadlocky při odesílání signálu attention.
2.1.7 ledna 2024 Byla opravena chyba CVE-2024-0056 a ověřování certifikačního řetězce.

2.0

Verze 2.0 byla všeobecně dostupná v červnu 2020. Poslední patch byl 2.0.1, vydaný v srpnu 2020.

  • Byla přidána autentizace služba Active Directory Integrated a služba Active Directory Interactive pro .NET Core a .NET Standard.
  • Přidáno služba Active Directory Service Principal ověření.
  • Přidáno Microsoft.Data.SqlClient.EventSource trasování.
  • Přidána podpora TCP keep-alive napříč platformami a volitelná spravovaná implementace síťové komunikace v systému Windows pro testování a ladění. Spravovaná cesta nepodporovala nedoménové ověřování systému Windows.
  • Přidány SqlBulkCopy.RowsCopied a seřazeny pokyny pro hromadné kopírování.
  • Přidáno SqlConnection.Open(SqlConnectionOverrides.OpenWithoutRetry).
  • Přidána podpora Windows ARM prostřednictvím závislosti Microsoft.Data.SqlClient.SNI.runtime.
  • Začalo se ověřovat certifikát serveru, pokud server vynucuje šifrování, včetně případů, kdy je v připojovacím řetězci nastaveno Encrypt=false. Připojení může po této aktualizaci selhat, pokud certifikát není důvěryhodný nebo jeho název neodpovídá serveru.
  • Změnilo se zpracování škálování desetinných parametrů na použití zaokrouhlování kompatibilního se SQL Server.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
2.0.0 Červen 2020 Obecné uvolnění.
2.0.1 Srpen 2020 Přidána konfigurace ověřování vhodná pro koexistenci a opraveny chyby v expiraci tokenů ve fondu, zpracování přechodných chyb, ukládání enklávy do mezipaměti a nativním předběžném přihlášení SNI.

1.1

Verze 1.1 byla všeobecně dostupná v listopadu 2019. Poslední patch byl 1.1.4, vydaný v březnu 2021.

  • Byla přidána podpora Always Encrypted se zabezpečenými enklávami pro podporované cílové platformy .NET Framework a .NET Core.
  • Přidána expanze |DataDirectory| v AttachDBFilename na platformě .NET Core.
  • Vylepšené asynchronní čtení s vícepaketovým cacheováním target-bufferu.
  • Snížená režie snapshotu v TdsParserStateObject a SqlDataReader.
  • Byly opraveny chyby ve stavu časového limitu a v hlavičkách Multiple Active Result Sets (MARS) v pozdějších aktualizacích.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
1.1.0 Listopad 2019 Obecné uvolnění.
1.1.1 Únor 2020 Vrátil jsem asynchronní SNIPacket změny, které způsobovaly zablokování, a opravil rozsah závislostí SNI.
1.1.2 2020. dubna Byla přidána uživatelská jména pro interaktivní ověřování služby služba Active Directory a opraveno uchovávání hesel a hlavičky protokolu MARS TDS.
1.1.3 Květen 2020 Zabránil jsem přerušeným transakcím v zapojení do pooled connection a vrátil zpět regresivní opravu hlavičky MARS.
1.1.4 Březen 2021 Opraveny chybné výsledky související se stavem časového limitu a chyby v hlavičkách MARS v rozhraní .NET Framework 4.8 a novějších verzích.

1.0

Microsoft. Data.SqlClient 1.0 dosáhl obecné dostupnosti v srpnu 2019. Poslední patch byl 1.0.19269.1, vydaný v září 2019.

  • Zavedli jsme samostatně dodávaného poskytovatele Microsoft.Data.SqlClient.
  • Podporoval verze .NET Framework 4.6 a vyšší, verze .NET Core 2.1 a pozdější, a .NET Standard 2.0.
  • Přidána služba Active Directory Interactive autentizace na .NET Framework.
  • Přidáno služba Active Directory Password ověřování pro .NET Core.
  • Přidána metadata o klasifikaci citlivosti dat na SqlDataReader.
  • Přidána podpora kolace UTF-8 v SQL Server 2019.
  • Přidána podpora Always Encrypted na .NET Core.

Vydání

Verze Uvolněno Změny relevantní pro zákazníka
1.0.19239.1 Srpen 2019 Obecné uvolnění. Opraveno opětovné použití připojení po selhání transakcí, publikování SNI, zpracování nezávislé na globalizaci a rozšíření hodnot null při hromadném kopírování.
1.0.19249.1 Září 2019 Opraveno velké vícepaketové čtení dat v systému Unix.
1.0.19269.1 Září 2019 Obnoveno SqlCommand.StatementCompleted, přidáno chybějící SqlConnectionStringBuilder.Authentication a vrácena zpět nekompatibilní SqlAuthenticationParameters.Resource změna API.

Pro aplikaci přecházející od staršího poskytovatele použijte Migrate ze System.Data.SqlClient do Microsoft. Data.SqlClient místo čtení pouze poznámek k vydání.

Nepovinné poznámky k vydání balíčku

Volitelné balíčky mají své vlastní poznámky k vydání. Počínaje verzí 7.0.2 jsou vydávány ve verzi sladěné s hlavním ovladačem.

Package Poznámky k vydání
Microsoft.Data.SqlClient.Extensions.Azure Poznámky k vydání rozšíření Azure
Microsoft.Data.SqlClient.Extensions.Abstractions Poznámky k vydání abstrakcí rozšíření
Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider Poznámky k verzi Azure Key Vault Provider

Neodkazujte přímo na Microsoft.Data.SqlClient.Internal.Logging. Je to interní závislost sdílená ovladačovými balíčky.

Zhodnoťte aktualizaci

  1. Identifikujte každý ovladač a volitelnou verzi balíčku, která je použita přímo nebo tranzitivně.
  2. Přečtěte si poznámky k vydání pro každou vedlejší a hlavní verzi, přes kterou aktualizace přechází.
  3. Zkontrolujte životní cyklus podpory ovladačů SqlClient kvůli kompatibilitě cílového frameworku a databáze.
  4. Aktualizujte všechny související balíčky na kompatibilní verze.
  5. Sestavte a otestujte autentizaci aplikace, šifrování, poolování spojení, parametry, transakce, opakovaní, diagnostiku a výstupy nasazení.

Pro příkazy pro instalaci a nasazení viz Instalace, aktualizace a nasazení Microsoft. Data.SqlClient.

Související obsah

  • Poslední aktualizace v