Co nowego w Microsoft. Data.SqlClient

Microsoft. Data.SqlClient jest dostępny niezależnie od .NET. Ten artykuł podsumowuje istotne funkcje, zmiany w zachowaniu oraz zmiany kompatybilności w każdej linii wydawniczej. Tabele wydań zawierają wszystkie opublikowane stabilne wersje pakietów, w tym każdą poprawkę hotfix i każdy pakiet niewidoczny na liście. Każdą aktualizację poprawek i zależności można znaleźć w pełnych notatkach dotyczących wydania w repozytorium SqlClient.

Bieżące wersje

Nie używaj wersji podpremierowych w produkcji. Interfejsy API w wersji zapoznawczej i ich działanie mogą ulec zmianie przed udostępnieniem w ramach ogólnej dostępności (GA).

Tabele wydawnictw i podsumowania ogólnej dostępności wykorzystują miesiąc publikacji NuGet. Artykuł o cyklu życia zawiera oficjalne daty premiery, które mogą się różnić. Aby uzyskać informacje o oknach wsparcia, zobacz cykl życia wsparcia sterowników SqlClient.

Zapowiedź 7.1

Linia podglądowa 7.1 rozszerza batch proces, odkrywanie schematów, pulowanie połączeń oraz Always Encrypted API. Zmiany wprowadzone do wersji 7.1.0-preview3 obejmują:

• SqlBatchwsparcie dla .NET Framework.
• Przeciążenia asynchroniczne SqlConnection.GetSchemaAsync .
• Alisy łańcuchów połączeń takie jak ColumnEncryption, ConnectTimeout, FailoverPartner, PacketSize, oraz WorkstationId.
• Mapowania pseudokolumn SQL Graph dla $node_id, $edge_id, $from_id oraz $to_id w SqlBulkCopy.
• Wymuszanie limitu czasu bezczynności połączenia jako opcji.
• Opcjonalny tryb limitu czasu połączenia, który obejmuje czas oczekiwania na połączenie z puli.
• Dalszy rozwój eksperymentalnej puli połączeń opartej na kanałach.
• Metody asynchroniczne na dostawcach przechowywania kluczy zawsze szyfrowanych. Sterownik nie wywołuje jeszcze tych metod podczas wykonywania poleceń, więc nie sprawiają one, że istniejące operacje Always Encrypted stają się asynchroniczne.

SqlBatchCommand.CommandBehavior jest uwzględniany od tego wiersza. Wcześniejsze wersje ignorowały tę własność. Przestarzała opcja połączenia Type System Version=SQL Server 2000 teraz zgłasza ArgumentException.

Preview3 zmienia także walidację certyfikatów i walidację enklaw. ServerCertificate zawsze porównuje skonfigurowany plik certyfikatu z certyfikatem prezentowanym przez serwer. Nieprawidłowy lub nieczytelny plik teraz powoduje awarię połączenia zamiast wracać do weryfikacji nazwy hosta. Poświadczanie enklawy w Wirtualnym trybie bezpiecznym (VSM) i usłudze Host Guardian Service (HGS) teraz weryfikuje, że klucz publiczny enklawy jest powiązany z podpisanym raportem poświadczenia. Przetestuj ponownie te ścieżki po przejściu z wcześniejszej wersji zapoznawczej.

Przeczytaj notatki do wersji preview1,preview2 i preview3 przed przetestowaniem tej linii.

7.0 STS

Wersja 7.0 trafiła do ogólnej dostępności w marcu 2026 roku. To aktualna linia STS.

Cechy i zmiany

• Uwierzytelnianie Microsoft Entra za pomocą sterownika przeniosło się z pakietu podstawowego do Microsoft.Data.SqlClient.Extensions.Azure. Dodaj pakiet rozszerzenia, gdy korzystasz z trybu Active Directory uwierzytelniania.
• Pakiet podstawowy nie zależy już od Azure.Core, Azure.Identity, ani Microsoft Authentication Library (MSAL).
• SqlConnection.SspiContextProvider obsługuje niestandardowe negocjacje tokenów Kerberos i NTLM. Tożsamość dostawcy jest częścią klucza puli połączeń.
• Ulepszone routowanie dla Azure SQL Hyperscale oraz nazwanych replik odczytu jest negocjowane automatycznie.
• Silnie typowane zdarzenia diagnostyczne dotyczące poleceń, połączeń i transakcji są dostępne w .NET Framework oraz w bieżącej platformie .NET.
• SqlConfigurableRetryFactory.BaselineTransientErrors ujawnia domyślną listę błędów przejściowych sterownika.
• Active Directory Password uwierzytelnianie jest przestarzałe. Używaj uwierzytelniania interaktywnego dla aplikacji użytkowników, uwierzytelniania przez podmiot usługi dla usług lub zarządzanej tożsamości dla obciążeń hostowanych w Azure.
• Wsparcie docelowe zaczyna się od .NET Framework 4.6.2 i .NET 8. Sterownik obsługuje także budowanie i uruchamianie na .NET 10.

Multipleksowanie pakietów dla odczytów asynchronicznych pozostaje funkcjonalnością podglądową i jest opcjonalne w wersji 7.0. Testuj przełączniki zgodności w środowisku produkcyjnym i zachowaj możliwość wycofania zmian.

Nowości

6.1 LTS

Wersja 6.1.0 została wydana w lipcu 2025 roku, ale później została usunięta z listy z powodu krytycznych regresji. Wersja 6.1.1, wydana w sierpniu 2025 roku, ustanowiła wspieraną linię 6.1 LTS.

Cechy i zmiany

• Natywna obsługa przesyłania wektorów w SQL Server 2025 przez SqlVector<T>, początkowo dla wektorów zmiennoprzecinkowych pojedynczej precyzji.
• Referencyjny zasób .NET Standard 2.0 dla kompatybilności bibliotek. Ten asset nie jest implementacją w czasie rzeczywistym. Aplikacje wykonywalne muszą korzystać z obsługiwanego zasobu uruchomieniowego .NET lub .NET Framework.
• Opcjonalne multipleksowanie pakietów dla dużych asynchronicznych operacji odczytu oraz obsługa punktów końcowych dla bazy danych SQL w Microsoft Fabric.
• Ulepszone natywne wsparcie dla kompilacji Ahead-of-Time (AOT).
• Zmniejszono alokacje w ścieżkach przetwarzania łączeń i TDS.
• W wersji 7.0 dodano wewnętrzne podstawy na potrzeby publicznej rozszerzalności interfejsu Security Support Provider Interface (SSPI).

Nie wdrażaj wersji 6.1.0. Wersja 6.1.1 cofnęła zmiany w wykrywaniu i odtwarzaniu pakietów.

Nowości

Poprzednie linie wydawnicze

Poniższe linie wersji nie są już obsługiwane. Korzystaj z tych podsumowań, gdy planujesz aktualizację obejmującą wiele wersji sterowników.

6.0

Wersja 6.0 trafiła do ogólnej dostępności w styczniu 2025 roku. Ostatnia poprawka miała numer 6.0.5 i została wydana w styczniu 2026 roku.

• Dodano natywną obsługę formatu JSON w SQL Server za pośrednictwem Microsoft.Data.SqlTypes.SqlJson, w tym obsługę odczytu, zapisu, strumieniowania i kopiowania zbiorczego.
• Dodano publicznie dostępne, silnie typowane ładunki diagnostyczne dla zdarzeń polecenia, połączenia i transakcji.
• Dodano OpenAsync(SqlConnectionOverrides, CancellationToken), w tym OpenWithoutRetry.
• Dodano obsługę SqlDataRecord i DataTable w parametrach strukturalnych DateOnly i TimeOnly.
• Dodano wsparcie dla .NET 9.
• Usunięto zasoby środowiska uruchomieniowego .NET Standard i .NET 6. Obsługiwane cele to .NET Framework 4.6.2 i późniejsze wersje oraz .NET 8 i nowsze.
• Ograniczono EnableOptimizedParameterBinding do poleceń tekstowych.

Nowości

5.2

Wersja 5.2 trafiła do ogólnej dostępności w lutym 2024 roku. Ostatnią łatką była wersja 5.2.3, wydana w kwietniu 2025 roku.

• Dodano SqlConnection.AccessTokenCallback na potrzeby asynchronicznego uzyskiwania tokenów zgodnego z pulą.
• Dodano SqlBatch i SqlBatchCommand w wersjach .NET 6 i nowszych.
• Dodano SqlDiagnosticListener wsparcie dla standardu .NET.
• Dodano SqlBulkCopy.RowsCopied64 w wersji 64-bitowej. Starsza RowsCopied własność pozostaje 32-bitową liczbą całkowitą.
• Dodano uwierzytelnianie Active Directory Workload Identity.
• Dodano wsparcie dla platform .NET 8 i big-endian.
• Zmieniono UseOneSecFloorInTimeoutCalculationDuringLogin, ustawiając domyślnie true.
• Użyto NegotiateAuthentication dla zarządzanego interfejsu SSPI w platformie .NET 7 i nowszych wersjach.

Nowości

5.1

Wersja 5.1 trafiła do ogólnej dostępności w styczniu 2023 roku. Ostatnia poprawka to wersja 5.1.9, wydana w styczniu 2026 roku.

• Dodano wsparcie dla .NET 6 i zrezygnowano z .NET Core 3.1.
• Dodano obsługę DateOnly i TimeOnly dla wartości parametrów oraz GetFieldValue.
• Dodano obsługę protokołu TLS 1.3 w platformie .NET oraz w ścieżkach natywnego interfejsu sieciowego SQL Server (SNI).
• Dodano ServerCertificate do dokładnego dopasowywania certyfikatów za pomocą Encrypt=Mandatory i Encrypt=Strict.
• Dodano wsparcie dla Windows ARM64 dla .NET Framework.
• Upubliczniłem parser SqlConnectionEncryptOption ciągów znaków.
• Wersja 5.1.3 naprawiła ścieżkę degradacji szyfrowania CVE-2024-0056 oraz walidację łańcucha certyfikatów.

Nowości

5.0

Wersja 5.0 weszła do ogólnej dostępności w sierpniu 2022 roku. Ostatnią łatką była wersja 5.0.2, wydana w marcu 2023 roku.

• Dodano TDS 8.0 za pośrednictwem Encrypt=Strict. Tryb ścisły uruchamia TLS przed wymianą logowania TDS i zawsze weryfikuje certyfikat serwera.
• Zmieniono SqlConnectionStringBuilder.Encrypt z bool na .SqlConnectionEncryptOption
• Przeniesiono typy SQL Server common language runtime (CLR) do osobno wersjonowanego Microsoft.SqlServer.Server pakietu.
• Dodano opcje połączeń Server SPN i Failover Server SPN.
• Dodano obsługę aliasów SQL Server w systemie Windows w bieżącej platformie .NET.
• Dodano SqlDataSourceEnumerator w systemie Windows.
• Porzuciłem .NET Framework 4.6.1.

Nowości

4.1

Wersja 4.1 trafiła do ogólnej dostępności w styczniu 2022 roku. Ostatnia poprawka miała numer 4.1.1 i została wydana we wrześniu 2022 roku.

• Dodano Attestation Protocol=None dla enklaw zabezpieczeń opartych na wirtualizacji (VBS).
• Równoległe wysyłanie żądań protokołu rozpoznawania SQL Server w systemach Linux i macOS, gdy funkcja MultiSubnetFailover jest włączona.
• Naprawiono sprawdzanie listy unieważnionych certyfikatów podczas uwierzytelniania.
• Naprawiono uwierzytelnianie Microsoft Entra, wartości null SqlBinary i rowversion oraz zachowanie sortacji UTF-8.

Nowości

4.0

Wersja 4.0 trafiła do ogólnej dostępności w listopadzie 2021 roku. Ostatnia poprawka to 4.0.6, wydana w sierpniu 2024 roku.

• Zmieniono domyślną wartość Encrypt z na falsetrue.
• Dodano SqlCommand.EnableOptimizedParameterBinding do poleceń z wieloma parametrami.
• Dodano SqlFileStream dla Windows poprzez implementację standardu .NET.
• Dodano wsparcie dla współdzielonych instancji LocalDB w zarządzanym SNI.
• Dodano GetFieldValue<T> i GetFieldValueAsync<T> dla XmlReader, TextReader, oraz Stream.
• Usunięto przełącznik bezpieczeństwa z konfigurowalnej logiki powtórek. Próba powtórna pozostała wyłączona, dopóki aplikacja nie skonfigurowała dostawcy usług.
• Zmieniono błędy uwierzytelniania Microsoft Entra tak, aby zgłaszały SqlException zamiast AggregateException.
• Porzuciłem .NET Core 2.1.
• Wersja 4.0.5 naprawiła ścieżkę degradacji szyfrowania CVE-2024-0056 oraz walidację łańcucha certyfikatów.

Nowości

3.1

Wersja 3.1 trafiła do ogólnej dostępności w marcu 2022 roku. Ostatnia poprawka miała numer 3.1.7 i została wydana w sierpniu 2024 roku.

• Dodano Attestation Protocol=None dla enklaw VBS.
• Dodano błędy SQL 42108 i 42109 do domyślnej listy błędów przejściowych.
• Dodano wsparcie dla Windows ARM64 dla .NET Framework w wersji 3.1.2.
• Ograniczono powtarzające się żądania tokenów Microsoft Entra dzięki cichemu pozyskiwaniu tokenów w wersji 3.1.3.
• Naprawiono ścieżkę degradacji szyfrowania CVE-2024-0056 w wersji 3.1.5.
• Naprawiono czyszczenie transakcji przed pulowaniem oraz obsługę limitu czasu tokenu Microsoft Entra w wersji 3.1.7.

Nowości

3.0

Wersja 3.0 weszła do ogólnej dostępności w czerwcu 2021 roku. Ostatnią łatką była wersja 3.0.1, wydana we wrześniu 2021 roku.

• Dodano konfigurowalną logikę powtórek dla operacji połączenia i poleceń. W wersji 3.0 pozostało opcjonalne za Switch.Microsoft.Data.SqlClient.EnableRetryLogic.
• Dodano liczniki EventCounters dla aktywności połączeń i puli.
• Dodano Active Directory Default uwierzytelnianie za pośrednictwem Azure.Identity.
• Dodano rejestrację dostawcy przechowywania klucza z zakresem połączenia i poleceń.
• Dodano preferencję adresu IP TCP.
• Zmieniono uwierzytelnianie zarządzanej tożsamości przypisanej przez użytkownika tak, aby używało identyfikatora klienta zamiast identyfikatora obiektu w User Id.
• Zmieniono wartości zerowe SQL rowversion tak, aby zwracały DBNull zamiast pustej tablicy bajtów. Przełącznik AppContext zachował starsze zachowanie.
• Podniesiono minimalną docelową wersję platformy .NET Framework z 4.6 do 4.6.1.

Dostawcy przechowywania kluczy systemowych mają pierwszeństwo przed dostawcami zarejestrowanymi na połączeniu lub poleceniu od wersji 3.0. Zmień nazwę niestandardowego dostawcy, jeśli jego nazwa koliduje z wbudowanym dostawcą.

Nowości

2.1

Wersja 2.1 trafiła do ogólnej dostępności w listopadzie 2020 roku. Ostatnia łatka to wersja 2.1.7, wydana w styczniu 2024 roku.

• Rozszerzono funkcję Always Encrypted o obsługę platform .NET Standard 2.0.
• Dodano wsparcie dla bezpiecznej enklawy na Unix dla .NET Core oraz na platformach .NET Standard 2.1.
• Dodano Active Directory Device Code Flow oraz uwierzytelnianie za pomocą tożsamości zarządzanej.
• Dodano punkty dostosowywania dla uwierzytelniania interaktywnego i uwierzytelniania za pomocą kodu urządzenia.
• Dodano metadane rankingowe klasyfikacji wrażliwości.
• Dodano element SqlConnection.ServerProcessId.
• Dodano Command Timeout opcję połączenia jako domyślną dla poleceń utworzonych przez połączenie.
• Wersja 2.1.7 naprawiła ścieżkę obniżenia szyfrowania CVE-2024-0056.

Nowości

2.0

Wersja 2.0 trafiła do ogólnej dostępności w czerwcu 2020 roku. Ostatnią aktualizacją była wersja 2.0.1, wydana w sierpniu 2020 roku.

• Dodano uwierzytelnianie Active Directory Integrated i Active Directory Interactive w środowiskach .NET Core i .NET Standard.
• Dodano uwierzytelnianie Active Directory Service Principal.
• Dodano Microsoft.Data.SqlClient.EventSource śledzenie.
• Dodano obsługę TCP keep-alive na wielu platformach oraz opcjonalną zarządzaną implementację sieciową w systemie Windows na potrzeby testowania i debugowania. Ścieżka zarządzana nie obsługiwała uwierzytelniania systemu Windows nienależącego do domeny.
• Dodano SqlBulkCopy.RowsCopied oraz uporządkowano wskazówki dotyczące kopiowania zbiorczego.
• Dodano element SqlConnection.Open(SqlConnectionOverrides.OpenWithoutRetry).
• Dodano wsparcie dla Windows ARM dzięki zależnościMicrosoft.Data.SqlClient.SNI.runtime.
• Rozpoczęto weryfikację certyfikatu serwera, gdy serwer wymusza szyfrowanie, w tym gdy parametry połączenia ustawiają Encrypt=false. Połączenia mogą się zerwać po tej aktualizacji, jeśli certyfikat nie jest zaufany lub jego nazwa nie zgadza się z serwerem.
• Zmieniono obsługę skali parametrów dziesiętnych na stosowanie zaokrągleń zgodnych z SQL Server.

Nowości

1.1

Wersja 1.1 weszła do ogólnej dostępności w listopadzie 2019 roku. Ostatnia poprawka miała numer 1.1.4 i została wydana w marcu 2021 roku.

• Dodano funkcję Always Encrypted z bezpiecznymi enklawami w obsługiwanych wersjach platform .NET Framework i .NET Core.
• Dodano |DataDirectory| rozszerzenie AttachDBFilename do .NET Core.
• Ulepszone odczyty asynchroniczne dzięki wielopaketowemu buforowaniu bufora docelowego.
• Zmniejszono narzut związany z migawkami w TdsParserStateObject i SqlDataReader.
• Naprawiono błędy nagłówków związane ze stanem przekroczenia limitu czasu oraz Multiple Active Result Sets (MARS) w późniejszych poprawkach.

Nowości

1.0

Microsoft. Data.SqlClient 1.0 osiągnął ogólną dostępność w sierpniu 2019 roku. Ostatnia aktualizacja miała numer 1.0.19269.1 i została wydana we wrześniu 2019 roku.

• Wprowadzono dostawcę Microsoft.Data.SqlClient dostarczanego oddzielnie.
• Obsługiwane wersje .NET Framework 4.6 i nowsze, wersje .NET Core 2.1 i nowsze, a także standard .NET 2.0.
• Dodano uwierzytelnianie Active Directory Interactive w programie .NET Framework.
• Dodano Active Directory Password uwierzytelnianie dla .NET Core.
• Dodano metadane klasyfikacji poufności danych na SqlDataReader.
• Dodano wsparcie dla kolacji UTF-8 w SQL Server 2019.
• Dodano wsparcie dla Always Encrypted w .NET Core.

Nowości

W przypadku aplikacji migrującej ze starszego dostawcy użyj Migrate from System.Data.SqlClient to Microsoft.Data.SqlClient zamiast opierać się wyłącznie na informacjach o wydaniu.

Opcjonalne notatki dotyczące wydania pakietu

Opcjonalne pakiety mają własne informacje o wydaniu. Począwszy od wersji 7.0.2 są wydawane w wersji zgodnej z głównym sterownikiem.

Nie odwołuj się bezpośrednio do Microsoft.Data.SqlClient.Internal.Logging. To wewnętrzna zależność współdzielona przez pakiety sterowników.

Oceń aktualizację

1. Zidentyfikuj każdy sterownik oraz opcjonalną wersję pakietu używaną bezpośrednio lub przechodnie.
2. Przeczytaj informacje o wydaniu dla każdej wersji pomniejszej i głównej, przez którą przechodzi aktualizacja.
3. Sprawdź cykl wsparcia sterowników SqlClient pod kątem kompatybilności docelowego frameworka i bazy danych.
4. Zaktualizuj wszystkie powiązane pakiety do kompatybilnych wersji.
5. Zbuduj i testuj uwierzytelnianie, szyfrowanie, pulowanie połączeń, parametry, transakcje, powtórki, diagnostykę oraz wyniki wdrożenia.

Aby uzyskać polecenia instalacyjne i wdrożeniowe, zobacz Install, aktualizuj i wdrażaj Microsoft. Data.SqlClient.

Treści powiązane

• Zainstaluj, aktualizuj i wdrażaj Microsoft. Data.SqlClient
• Cykl życia wsparcia sterownika SqlClient
• Migracja z System.Data.SqlClient do Microsoft. Data.SqlClient
• Informacje o wydaniu Microsoft.Data.SqlClient