Novità in Microsoft. Data.SqlClient

Microsoft. Data.SqlClient viene pubblicato 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.

Anteprima 7.1

La linea di anteprima 7.1 estende batching, scoperta di schema, pool di connessione e API Always Critted. Le modifiche fino a 7.1.0-preview3 includono:

• SqlBatchsupporto su .NET Framework.
• Sovraccarichi asincroni SqlConnection.GetSchemaAsync .
• Alias di stringhe di connessione come ColumnEncryption, ConnectTimeout, FailoverPartner, PacketSize, e WorkstationId.
• Pseudo-colonne di grafo SQL per $node_id, $edge_id, $from_id, e $to_id in SqlBulkCopy.
• Applicazione del timeout della connessione idle opt-in.
• Una modalità timeout della connessione con opt-in che include il tempo trascorso in attesa di una connessione in pool.
• Ulteriore sviluppo del pool sperimentale di connessione basato su canali.
• Metodi asincroni sui provider di key store Always Critty. Il driver non chiama ancora questi metodi durante l'esecuzione dei comandi, quindi non rendono asincrone le operazioni Always Encrypted esistenti.

SqlBatchCommand.CommandBehavior è onorato a partire da questa linea. Le versioni precedenti ignoravano la proprietà. L'opzione di connessione obsoleta Type System Version=SQL Server 2000 ora genera un ArgumentException.

Preview3 modifica anche la validazione dei certificati e dell'enclave. ServerCertificate confronta sempre il file di certificato configurato con il certificato presentato dal server. Un file invalido o illeggibile ora fallisce la connessione invece di tornare alla validazione del nome host. L'attestazione dell'enclave tramite Virtual Secure Mode (VSM) e Host Guardian Service (HGS) ora verifica che la chiave pubblica dell'enclave sia legata al rapporto di attestazione firmato. Riprova questi percorsi quando ti sposti da un'anteprima precedente.

Leggi le note di rilascio per preview1, preview2 e preview3 prima di testare questa linea.

7.0 STS

La versione 7.0 è stata disponibile in generale a marzo 2026. È l'attuale linea STS.

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 una Active Directory modalità di autenticazione.
• 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 Kerberos e token 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 nominate sono negoziate automaticamente.
• Eventi diagnosticali di comandi, connessioni e transazioni fortemente tipati sono disponibili su .NET Framework e .NET attuale.
• 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 principale servizio 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. Test compatibilità con i carichi di lavoro di produzione e mantengono 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 stabilito la linea supportata 6.1 LTS.

Caratteristiche e cambiamenti

• Trasporto vettoriale nativo SQL Server 2025 attraverso 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 in tempo reale. Le applicazioni eseguibili devono utilizzare un asset runtime supportato per .NET Framework o .NET.
• La multiplexazione di pacchetti opt-in funziona per letture asincrone di grandi dimensioni e gestione degli endpoint per database SQL in Microsoft Fabric.
• Migliorato il supporto nativo per la compilazione Ahead-of-Time (AOT).
• Ridotto delle allocazioni nei percorsi di connessione e di elaborazione TDS.
• Le basi interne per l'estensibilità dell'interfaccia pubblica di supporto al supporto del fornitore di sicurezza (SSPI) sono state aggiunte nella versione 7.0.

Non distribuire la versione 6.1.0. La versione 6.1.1 ha ripristinato le modifiche di rilevamento e riproduzione dei pacchetti interessate.

Rilasci

Linee di uscita 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 è stata disponibile a generale a gennaio 2025. La patch finale è stata la 6.0.5, rilasciata a gennaio 2026.

• Aggiunta la compatibilità nativa SQL Server JSON tramite Microsoft.Data.SqlTypes.SqlJson, inclusi percorsi di lettura, scrittura, streaming e copia in massa.
• Aggiunti payload diagnostici pubblici e fortemente tipati per gli eventi di comando, connessione e transazione.
• Aggiunto OpenAsync(SqlConnectionOverrides, CancellationToken), incluso OpenWithoutRetry.
• Aggiunta DateOnly e TimeOnly supporto e DataTableSqlDataRecord parametri strutturati.
• Aggiunta la compatibilità .NET 9.
• Eliminato .NET Standard e .NET 6 asset runtime. I target supportati divennero .NET Framework 4.6.2 e versioni successive e .NET 8 e versioni successive.
• Limitato EnableOptimizedParameterBinding ai comandi testuali.

Rilasci

5,2

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

• Aggiunto SqlConnection.AccessTokenCallback per l'acquisizione asincrona e compatibile con il pool.
• Aggiunto SqlBatch e SqlBatchCommand attivo .NET 6 e versioni successive.
• Aggiunta SqlDiagnosticListener la compatibilità con .NET Standard.
• Aggiunto 64 bit SqlBulkCopy.RowsCopied64. La proprietà più vecchia RowsCopied rimane un intero a 32 bit.
• Autenticazione aggiunta Active Directory Workload Identity .
• Aggiunta la compatibilità per .NET 8 e piattaforme big-endian.
• Cambiato UseOneSecFloorInTimeoutCalculationDuringLogin per predefinito in true.
• Utilizzato NegotiateAuthentication per SSPI gestito su .NET 7 e versioni successive.

Rilasci

5.1

La versione 5.1 è stata disponibile in 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.
• Aggiunta DateOnly e TimeOnly supporto per i valori dei parametri e GetFieldValue.
• Aggiunto TLS 1.3 in .NET e percorsi nativi SQL Server Network Interface (SNI).
• Aggiunto ServerCertificate per una corrispondenza esatta del certificato con Encrypt=Mandatory e Encrypt=Strict.
• Aggiunta la compatibilità 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 è stata disponibile in generale nell'agosto 2022. L'ultima patch è stata la 5.0.2, rilasciata a marzo 2023.

• Aggiunto TDS 8.0 fino a Encrypt=Strict. La modalità Strict avvia TLS prima dello scambio di login TDS e valida sempre il certificato server.
• Cambiato SqlConnectionStringBuilder.Encrypt da bool a SqlConnectionEncryptOption.
• Ho spostato 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 Windows SQL Server supporto agli alias su .NET attuali.
• Aggiunto SqlDataSourceEnumerator su Windows.
• Ho abbandonato il framework .NET 4.6.1.

Rilasci

4.1

La versione 4.1 è stata disponibile a 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).
• Richieste parallelizzate del protocollo di risoluzione SQL Server su Linux e macOS quando MultiSubnetFailover è abilitato.
• Controlli fissi 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 è arrivata a 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à di istanze LocalDB nella gestione SNI.
• Aggiunto GetFieldValue<T> e GetFieldValueAsync<T> per XmlReader, TextReader, e Stream.
• Ho rimosso l'interruttore di sicurezza dalla logica di ritentazione configurabile. Retry rimaneva disabilitato finché un'applicazione non configurava un provider.
• Ho cambiato i fallimenti dell'autenticazione Microsoft Entra in throw SqlException invece di AggregateException.
• Ho abbandonato .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 è stata disponibile in 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.
• Ridotta 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 è stata disponibile in 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 3.0, rimaneva opt-in dietro Switch.Microsoft.Data.SqlClient.EnableRetryLogica .
• Aggiunti EventCounter per l'attività di connessione e 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.
• 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 delle versioni di riga SQL per restituirli DBNull invece di un array di byte vuoto. Un commutatore AppContext ha mantenuto il comportamento più vecchio.
• Ho aumentato l'obiettivo minimo del framework .NET da 4.6 a 4.6.1.

I provider di archiviazione chiave 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 è raggiunta la disponibilità generale nel novembre 2020. L'ultima patch è stata la 2.1.7, rilasciata a gennaio 2024.

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

Rilasci

2.0

La versione 2.0 è stata disponibile a giugno 2020. La patch finale è stata la 2.0.1, rilasciata nell'agosto 2020.

• Aggiunta Active Directory Integrated e Active Directory Interactive autenticazione su .NET Core e .NET Standard.
• Autenticazione aggiunta Active Directory Service Principal .
• Aggiunta Microsoft.Data.SqlClient.EventSource la tracciatura.
• Aggiunta la modalità TCP cross-platform keep-alive e un'implementazione di rete gestita opt-in su Windows per test e debug. Il percorso gestito non supportava l'autenticazione di Windows non a dominio.
• Ho aggiunto SqlBulkCopy.RowsCopied e ordinato suggerimenti in copia in massa.
• Aggiunto SqlConnection.Open(SqlConnectionOverrides.OpenWithoutRetry).
• Aggiunta la supporto 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 è affidabile 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 è stata disponibile in 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 il framework .NET e il core .NET.
• Aggiunta |DataDirectory| l'espansione AttachDBFilename su .NET Core.
• Letture asincrone migliorate con cache multipacket target-buffer.
• Riduzione del sovraccarico degli snapshot in TdsParserStateObject e SqlDataReader.
• Errori di header state di timeout e Multiple Active Result Sets (MARS) corretti nelle patch successive.

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.

• Ho introdotto il fornitore spedito Microsoft.Data.SqlClient separatamente.
• Supportava .NET Framework 4.6 e versioni successive, .NET Core 2.1 e versioni successive, e .NET Standard 2.0.
• Aggiunta Active Directory Interactive l'autenticazione su .NET Framework.
• Aggiunta Active Directory Password l'autenticazione su .NET Core.
• Aggiunta di metadati di classificazione della sensibilità dei dati su SqlDataReader.
• Aggiunta la collation SQL Server 2019 UTF-8.
• Aggiunta la compatibilità Always Critt su .NET Core.

Rilasci

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

Note opzionali sul rilascio del pacchetto

I pacchetti opzionali hanno le proprie note di rilascio. A partire dalla versione 7.0.2, vengono distribuiti in versione allineata con il driver core.

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

Valuta un aggiornamento

1. Identifica ogni driver e ogni versione opzionale del pacchetto utilizzata direttamente o in modo transitivo.
2. Leggi le note di rilascio di ogni versione minore e maggiore intercalata 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 alle versioni compatibili.
5. Compila e testa l'autenticazione, la crittografia, il pooling di connessioni, i parametri, le transazioni, i tentativi, la diagnostica e l'output di distribuzione dell'applicazione.

Per i comandi di installazione e deployment, vedi Installa, aggiorna e distribuisce 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
• Microsoft. Note di rilascio di Data.SqlClient