Novità in Microsoft.Data.SqlClient

Microsoft.Data.SqlClient viene distribuito indipendentemente da .NET. Questo articolo riassume le caratteristiche significative, i cambiamenti comportamentali e i cambiamenti di compatibilità in ogni linea di rilascio. Le tabelle di rilascio includono ogni pubblicazione di pacchetti stabili, inclusi ogni hotfix e pacchetto non elencato. Per ogni aggiornamento di correzione e dipendenza, consulta le note complete di rilascio nel repository SqlClient.

Versioni correnti

Non usare le versioni preview in produzione. Le API e il comportamento delle anteprime possono cambiare prima della disponibilità generale (GA).

Le tabelle delle release e i riassunti della disponibilità generale utilizzano il mese di pubblicazione NuGet. L'articolo sul ciclo di vita elenca le date di rilascio ufficiali, che possono variare. Per le finestre di supporto, vedi ciclo di vita del supporto driver SqlClient.

7.1 STS

La versione 7.1 è arrivata a disponibilità generale a settembre 2026. È l'attuale linea STS.

Caratteristiche e cambiamenti

• SqlBatchsupporto su .NET Framework.
• Sovraccarichi asincroni SqlConnection.GetSchemaAsync .
• Segnalazione dell'identità dell'applicazione attraverso SqlConnection.RegisteredApplication e la versione 2 del payload TDS USERAGENT. Imposta la proprietà prima di aprire la connessione. Il valore non fa parte della chiave del pool di connessione, quindi una connessione fisica riutilizzata indica l'applicazione che l'ha creata originariamente. L'identità dell'applicazione è una telemetria fornita dal client, non costituisce una base per l'autorizzazione o altre decisioni di sicurezza.
• Alias di stringhe di connessione come ColumnEncryption, ConnectTimeout, FailoverPartner, PacketSize, e WorkstationId.
• Pseudo-colonne di grafo SQL di mapping per $node_id, $edge_id, $from_id e $to_id in SqlBulkCopy.
• Il tipo SQL Server json nella raccolta DataTypes restituita da SqlConnection.GetSchema, incluso in Azure SQL.
• Applicazione tramite adesione volontaria Connection Idle Timeout tramite Switch.Microsoft.Data.SqlClient.UseLegacyIdleTimeoutBehavior=false. Il timeout di inattività predefinito è di 300 secondi; 0 disabilita la scadenza del tempo inattivo. Il comportamento predefinito del pooling rimane invariato.
• Una modalità di timeout per la connessione opt-in che include il tempo trascorso in attesa di una connessione dal pool tramite Switch.Microsoft.Data.SqlClient.UseOverallConnectTimeoutForPoolWait=true. L'interruttore è impostato su false per impostazione predefinita.
• Supporto ampliato per transazioni, recupero di connessioni rotte, riscaldamento pool, rimozione delle connessioni inattive, recupero delle connessioni non rilasciate e diagnostica nel pool di connessione V2. Il pool rimane in valutazione e richiede ulteriori azioni Switch.Microsoft.Data.SqlClient.UseConnectionPoolV2.
• Metodi asincroni sui provider di key store Always Encrypted. Il driver non chiama ancora questi metodi durante l'esecuzione dei comandi, quindi non rendono asincrone le operazioni Always Encrypted esistenti.
• Ho aggiornato i pacchetti SNI nativi alla versione 7.1.0. I target applicativi supportati rimangono .NET Framework 4.6.2 e versioni successive e .NET 8 e versioni successive.

Cambiamenti di compatibilità

• SqlConnectionStringBuilder.TransparentNetworkIPResolutionè obsoleto su .NET Framework. Utilizzare invece MultiSubnetFailover. Questa modifica aggiunge un avviso in tempo di compilazione; non modifica il comportamento a runtime né il valore predefinito di nessuna delle due opzioni.
• SqlBatchCommand.CommandBehavior e i CommandBehavior passati a SqlBatch.ExecuteReader vengono rispettati. Le versioni precedenti ignoravano queste impostazioni.
• L'opzione di connessione Type System Version=SQL Server 2000 obsoleta ora genera ArgumentException quando apri la connessione. Usa un valore supportato come Latest.

La versione 7.1 include anche le correzioni per la convalida dei certificati e dell'enclave incluse nelle versioni 6.1.7 e 7.0.3. Quando abiliti la validazione del certificato su SNI gestito, ServerCertificate confronta il file del certificato configurato con il certificato presentato dal server. Un file invalido o illeggibile fa fallire la connessione invece di bypassare il controllo del certificato configurato. L'attestazione dell'enclave tramite Virtual Secure Mode (VSM) e Host Guardian Service (HGS) verifica che la chiave pubblica dell'enclave sia legata al report di attestazione firmato. Riprova questi percorsi quando aggiorni da una versione precedente priva di queste correzioni.

Correzioni principali

• Risolte le connessioni pool che rimanevano rotte dopo un TransactionScope rollback, che poteva causare il fallimento di una chiamata successiva BeginTransaction().
• Corretti i nomi letterali dei server IPv6 su Named Pipes in SNI gestito.
• Corretti overflow di parametri di grandi dimensioni decimal con precisione e scala esplicite, parametri DateOnly e parametri con valori di tabella che usano sql_variant, e i casi in cui i dati di colonna trasmessi in streaming venivano saltati dopo IsDBNull().
• Corretti i contatori del pool di connessione, l'inutile attività del timer di manutenzione del pool e le regressioni del throughput di apertura/chiusura V2 del pool di connessione.
• Corretta la logica di ritentazione configurabile che registra un gestore permanente di risoluzione assembly a livello di processo su .NET moderno. Gli assembly di tentativi personalizzati devono trovarsi nella directory base dell'applicazione; le dipendenze caricate dopo la costruzione del provider devono risolversi tramite la normale risoluzione delle dipendenze applicative o un gestore fornito dall'applicazione.

Rilasci

La versione 7.1.0 di Azure Key Vault Provider implementa i metodi asincroni del provider di key store e corregge la crescita della cache e i client di chiave duplicati in concorrenza. Questi metodi asincroni avvantaggiano le chiamate dirette al provider; i percorsi di esecuzione dei comandi del driver utilizzano ancora operazioni sulle chiavi sincrone. L'estensione Azure e le astrazioni delle estensioni allineano le versioni senza modifiche pubbliche alle API.

Per la cronologia delle anteprime, consulta le note di rilascio per preview1, preview2 e preview3.

7.0 STS

La versione 7.0 ha raggiunto la disponibilità generale a marzo 2026. Rimane supportato fino al 17 dicembre 2026, tre mesi dopo il rilascio della versione 7.1.

Caratteristiche e cambiamenti

• L'autenticazione Microsoft Entra fornita dal driver è passata dal pacchetto core a Microsoft.Data.SqlClient.Extensions.Azure. Aggiungi il pacchetto di estensioni quando usi la modalità di autenticazione Active Directory.
• Il pacchetto core non dipende più da Azure.Core, Azure.Identity, o da Libreria di Autenticazione Microsoft (MSAL).
• SqlConnection.SspiContextProvider supporta la negoziazione personalizzata di token Kerberos e NTLM. L'identità del provider fa parte della chiave del pool di connessione.
• Il routing migliorato per Azure SQL Hyperscale e le repliche di lettura denominate viene negoziato automaticamente.
• Eventi diagnosticali di comandi, connessioni e transazioni fortemente tipati sono disponibili su .NET Framework e .NET moderno.
• SqlConfigurableRetryFactory.BaselineTransientErrors Espone la lista predefinita degli errori transitori del driver.
• Active Directory Password L'autenticazione è obsoleta. Utilizzare l'autenticazione interattiva per le applicazioni utente, l'autenticazione del service principal per i servizi o l'identità gestita per i carichi di lavoro ospitati su Azure.
• Il supporto dei target inizia con .NET Framework 4.6.2 e .NET 8. Il driver supporta anche la compilazione e l'esecuzione su .NET 10.

Il multiplexing dei pacchetti per le letture asincrone rimane una funzionalità di anteprima ed è opt-in nella versione 7.0. Testa le opzioni di compatibilità con i carichi di lavoro di produzione e mantieni un percorso di rollback.

Rilasci

6.1 LTS

La versione 6.1.0 è stata rilasciata a luglio 2025, ma successivamente è stata rimossa dalla lista a causa di regressioni critiche. La versione 6.1.1, rilasciata nell'agosto 2025, ha definito la versione LTS 6.1 supportata.

Caratteristiche e cambiamenti

• Trasporto vettoriale nativo di SQL Server 2025 tramite SqlVector<T>, inizialmente per vettori in virgola mobile a precisione singola.
• Un asset di riferimento .NET Standard 2.0 per la compatibilità delle librerie. Questo asset non è un'implementazione di runtime. Le applicazioni eseguibili devono utilizzare un asset runtime supportato per .NET Framework o .NET.
• Lavoro sulla multiplexazione di pacchetti opt-in per letture asincrone di grandi dimensioni e sulla gestione degli endpoint per database SQL in Microsoft Fabric.
• Migliorato il supporto nativo per la compilazione Ahead-of-Time (AOT).
• Ridotte le allocazioni nei percorsi di connessione e di elaborazione TDS.
• Le basi interne per l'estensibilità della Security Support Provider Interface (SSPI) pubblica sono state aggiunte nella versione 7.0.

Non distribuire la versione 6.1.0. La versione 6.1.1 ha annullato le modifiche interessate al rilevamento dei pacchetti e al replay.

Rilasci

Release precedenti

Le seguenti linee di rilascio non sono più supportate. Usa i loro riepiloghi quando pianifichi un aggiornamento su più versioni di driver.

6.0

La versione 6.0 ha raggiunto la disponibilità generale a gennaio 2025. La patch finale è stata la 6.0.5, rilasciata a gennaio 2026.

• Aggiunto il supporto JSON nativo di SQL Server tramite Microsoft.Data.SqlTypes.SqlJson, incluse operazioni di lettura, scrittura, streaming e copia bulk.
• Aggiunti payload diagnostici pubblici e fortemente tipati per gli eventi di comando, connessione e transazione.
• Aggiunto OpenAsync(SqlConnectionOverrides, CancellationToken), incluso OpenWithoutRetry.
• Aggiunto il supporto per DateOnly e TimeOnly nei parametri strutturati DataTable e SqlDataRecord.
• Aggiunta la compatibilità .NET 9.
• Eliminato .NET Standard e .NET 6 asset runtime. Le destinazioni supportate divennero .NET Framework 4.6.2 e versioni successive e .NET 8 e versioni successive.
• Limitato EnableOptimizedParameterBinding ai comandi di testo.

Rilasci

5,2

La versione 5.2 ha raggiunto la disponibilità generale a febbraio 2024. La patch finale è stata la 5.2.3, rilasciata nell'aprile 2025.

• Aggiunto SqlConnection.AccessTokenCallback per l'acquisizione asincrona del token compatibile con il pool.
• Aggiunto SqlBatch e SqlBatchCommand in .NET 6 e versioni successive.
• Aggiunto SqlDiagnosticListener il supporto per .NET Standard.
• Aggiunto 64 bit SqlBulkCopy.RowsCopied64. La proprietà precedente RowsCopied rimane un intero a 32 bit.
• Autenticazione Active Directory Workload Identity aggiunta.
• Aggiunta la compatibilità per .NET 8 e piattaforme big-endian.
• Impostato UseOneSecFloorInTimeoutCalculationDuringLogin su true per impostazione predefinita.
• Usa NegotiateAuthentication per SSPI gestito su .NET 7 e versioni successive.

Rilasci

5.1

La versione 5.1 è stata resa disponibile in disponibilità generale a gennaio 2023. L'ultima patch è stata la 5.1.9, rilasciata a gennaio 2026.

• Aggiunta la compatibilità per .NET 6 e eliminato .NET Core 3.1.
• Aggiunto il supporto per DateOnly e TimeOnly per i valori dei parametri e GetFieldValue.
• Aggiunto TLS 1.3 in .NET e nei percorsi del codice nativi di SQL Server Network Interface (SNI).
• Aggiunto ServerCertificate per una corrispondenza esatta del certificato con Encrypt=Mandatory e Encrypt=Strict.
• Aggiunto il supporto per Windows ARM64 per .NET Framework.
• Ho reso pubblico il SqlConnectionEncryptOption parser delle stringhe.
• La versione 5.1.3 ha corretto il percorso di declassamento di crittografia CVE-2024-0056 e la validazione della catena dei certificati.

Rilasci

5,0

La versione 5.0 ha raggiunto la disponibilità generale nell'agosto 2022. L'ultima patch è stata la 5.0.2, rilasciata a marzo 2023.

• Aggiunto TDS 8.0 tramite Encrypt=Strict. La modalità Strict avvia TLS prima dello scambio di login TDS e valida sempre il certificato server.
• Modificato SqlConnectionStringBuilder.Encrypt da bool a SqlConnectionEncryptOption.
• Spostati i tipi di runtime del common language (CLR) di SQL Server nel pacchetto con versioni Microsoft.SqlServer.Server separate.
• Opzioni aggiunte Server SPN e Failover Server SPN di connessione.
• Aggiunto il supporto agli alias di SQL Server per Windows nell'attuale .NET.
• Aggiunto SqlDataSourceEnumerator su Windows.
• Rimosso il supporto per .NET Framework 4.6.1.

Rilasci

4.1

La versione 4.1 ha raggiunto la disponibilità generale a gennaio 2022. L'ultima patch è stata la 4.1.1, rilasciata a settembre 2022.

• Aggiunto Attestation Protocol=None per enclave di Virtualizzazione basata sulla Sicurezza (VBS).
• Parallelizzazione delle richieste del protocollo di risoluzione di SQL Server su Linux e macOS quando MultiSubnetFailover è abilitato.
• Corretti i controlli della lista di revoca dei certificati durante l'autenticazione.
• Corretto l'autenticazione Microsoft Entra, i valori di null SqlBinary e rowversion, e il comportamento di collazione UTF-8.

Rilasci

4.0

La versione 4.0 ha raggiunto la disponibilità generale nel novembre 2021. La patch finale è stata la 4.0.6, rilasciata nell'agosto 2024.

• Cambiato il valore predefinito di Encrypt da false a true.
• Aggiunto SqlCommand.EnableOptimizedParameterBinding per comandi con molti parametri.
• Aggiunto SqlFileStream per Windows tramite l'implementazione dello standard .NET.
• Aggiunta la compatibilità delle istanze LocalDB condivise in SNI gestito.
• Aggiunto GetFieldValue<T> e GetFieldValueAsync<T> per XmlReader, TextReader, e Stream.
• Rimosso l'interruttore di sicurezza dalla logica di ritentazione configurabile. Retry è rimasto disabilitato finché un'applicazione non configurava un provider.
• Modificati gli errori di autenticazione di Microsoft Entra per generare SqlException invece di AggregateException.
• Rimosso il supporto per .NET Core 2.1.
• La versione 4.0.5 ha corretto il percorso di downgrade di crittografia CVE-2024-0056 e la validazione della catena dei certificati.

Rilasci

3.1

La versione 3.1 ha raggiunto la disponibilità generale a marzo 2022. L'ultima patch è stata la 3.1.7, rilasciata nell'agosto 2024.

• Aggiunto Attestation Protocol=None per gli enclave VBS.
• Sono stati aggiunti gli errori SQL 42108 e 42109 all'elenco predefinito degli errori transitori.
• Aggiunta la compatibilità Windows ARM64 per .NET Framework nella versione 3.1.2.
• Ridotte le richieste ripetute di token Microsoft Entra tramite acquisizione silenziosa di token nella versione 3.1.3.
• Corretto il percorso di downgrade di crittografia CVE-2024-0056 nella 3.1.5.
• Pulizia delle transazioni corretta prima del pooling e gestione del timeout dei token Microsoft Entra nella versione 3.1.7.

Rilasci

3.0

La versione 3.0 ha raggiunto la disponibilità generale a giugno 2021. L'ultima patch è stata la 3.0.1, rilasciata a settembre 2021.

• Aggiunta una logica di ritentazione configurabile per le operazioni di connessione e comando. Nella versione 3.0, è rimasto opt-in dietro Switch.Microsoft.Data.SqlClient.EnableRetryLogic.
• Aggiunti EventCounters per l'attività di connessione e del pool.
• Aggiunta Active Directory Default l'autenticazione tramite Azure.Identity.
• Aggiunta la registrazione del provider di archiviazione chiave Always Encrypted con ambito connessione e comando.
• Aggiunta la preferenza per l'indirizzo IP TCP/IP.
• Modificato l'autenticazione dell'identità gestita assegnata dall'utente per usare l'ID client invece dell'ID oggetto in User Id.
• Ho cambiato i valori null SQL rowversion in modo che restituiscano DBNull invece di un array di byte vuoto. Uno switch AppContext ha mantenuto il comportamento meno recente.
• Ho aumentato l'obiettivo minimo del framework .NET da 4.6 a 4.6.1.

I provider dell'archivio chiavi di sistema hanno la precedenza sui fornitori registrati su una connessione o comando a partire dalla versione 3.0. Rinomina un provider personalizzato se il suo nome è in conflitto con quello di un provider integrato.

Rilasci

2.1

La versione 2.1 è stata resa generalmente disponibile nel novembre 2020. L'ultima patch è stata la 2.1.7, rilasciata a gennaio 2024.

• Esteso Always Encrypted alle piattaforme .NET Standard 2.0 supportate.
• Aggiunta del supporto per enclave sicuro su Unix per .NET Core e su tutte le piattaforme che supportano .NET Standard 2.1.
• Aggiunta Active Directory Device Code Flow e gestita l'autenticazione dell'identità gestita.
• Aggiunti hook di personalizzazione per l'autenticazione interattiva e del codice del dispositivo.
• Metadati del livello di classificazione di sensibilità aggiunti.
• Aggiunto SqlConnection.ServerProcessId.
• Aggiunta l'opzione di connessione Command Timeout come predefinita per i comandi creati da una connessione.
• La versione 2.1.7 ha corretto il vettore di downgrade della crittografia CVE-2024-0056.

Rilasci

2.0

La versione 2.0 ha raggiunto la disponibilità generale a giugno 2020. La patch finale è stata la 2.0.1, rilasciata nell'agosto 2020.

• È stata aggiunta l'autenticazione Active Directory Integrated e Active Directory Interactive su .NET Core e .NET Standard.
• Aggiunta autenticazione Active Directory Service Principal.
• Aggiunta Microsoft.Data.SqlClient.EventSource la tracciatura.
• Aggiunti il supporto keep-alive TCP multipiattaforma e un'implementazione di rete gestita opt-in su Windows per test e debug. Il percorso gestito non supportava l'autenticazione di Windows non di dominio.
• Ho aggiunto SqlBulkCopy.RowsCopied e ordinato i suggerimenti per la copia in blocco.
• Aggiunto SqlConnection.Open(SqlConnectionOverrides.OpenWithoutRetry).
• Aggiunto il supporto per Windows ARM tramite la Microsoft.Data.SqlClient.SNI.runtime dipendenza.
• Ha iniziato a validare il certificato server quando un server forza la cifratura, incluso quando la stringa di connessione imposta Encrypt=false. Le connessioni possono fallire dopo questo aggiornamento se il certificato non è attendibile o il suo nome non corrisponde al server.
• Ho cambiato la gestione della scala dei parametri decimali per usare un arrotondamento compatibile con SQL Server.

Rilasci

1.1

La versione 1.1 ha raggiunto la disponibilità generale nel novembre 2019. L'ultima patch è stata la 1.1.4, rilasciata a marzo 2021.

• Aggiunto Always Encrypted con enclave sicure su target supportati per .NET Framework e .NET Core.
• Aggiunta |DataDirectory| l'espansione in AttachDBFilename su .NET Core.
• Letture asincrone migliorate con memorizzazione nella cache del buffer di destinazione multipacchetto.
• Riduzione del sovraccarico degli snapshot in TdsParserStateObject e SqlDataReader.
• Corretti nelle patch successive gli errori nello stato di timeout e nelle intestazioni Multiple Active Result Sets (MARS).

Rilasci

1.0

Microsoft.Data.SqlClient 1.0 ha raggiunto la disponibilità generale nell'agosto 2019. L'ultima patch è stata la 1.0.19269.1, rilasciata a settembre 2019.

• Introdotto il provider spedito separatamente Microsoft.Data.SqlClient.
• Supporta .NET Framework 4.6 e versioni successive, .NET Core 2.1 e versioni successive e .NET Standard 2.0.
• Aggiunta l'autenticazione Active Directory Interactive su .NET Framework.
• Aggiunta l'autenticazione Active Directory Password in .NET Core.
• Aggiunta di metadati di classificazione della sensibilità dei dati su SqlDataReader.
• Aggiunto il supporto per la collation SQL Server 2019 UTF-8.
• Aggiunto il supporto per Always Encrypted su .NET Core.

Rilasci

Per un'applicazione che passa dal provider più vecchio, usa Migrate from System.Data.SqlClient to Microsoft.Data.SqlClient invece di leggere solo le note di rilascio.

Note di rilascio del pacchetto opzionale

I pacchetti opzionali hanno le proprie note di rilascio. A partire dalla versione 7.0.2, sono distribuiti con versioni allineate al driver core.

Non fare riferimento diretto a Microsoft.Data.SqlClient.Internal.Logging. È una dipendenza interna condivisa dai pacchetti driver.

Valutare un aggiornamento

1. Identifica ogni driver e ogni versione di pacchetto opzionale usati direttamente o transitivamente.
2. Leggi le note di rilascio di ogni versione secondaria e principale attraversata dall'aggiornamento.
3. Controlla il ciclo di vita del supporto driver SqlClient per la compatibilità del framework target e del database.
4. Aggiorna tutti i pacchetti correlati a versioni compatibili.
5. Compila e testa l'autenticazione, la crittografia, il pooling di connessioni, i parametri, le transazioni, i ritentativi, la diagnostica e l'output della distribuzione dell'applicazione.

Per i comandi di installazione e distribuzione, vedi Installare, aggiornare e distribuire Microsoft.Data.SqlClient.

Contenuti correlati

• Installare, aggiornare e distribuire Microsoft.Data.SqlClient
• Ciclo di vita del supporto per il driver SqlClient
• Migra da System.Data.SqlClient a Microsoft.Data.SqlClient
• Note di rilascio di Microsoft.Data.SqlClient