Note sulla versione per Microsoft JDBC Driver per SQL Server

Articolo
08/29/2024

Questo articolo elenca le versioni del driver Microsoft JDBC per SQL Server. Per ogni versione sono elencate e descritte le modifiche.

12.8

Scaricare Microsoft JDBC Driver 12.8.1 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.8.1 per SQL Server (tar.gz)

Numero di versione: 12.8.1
Versione 22 agosto 2024

Conformità 12.8

Modifica di conformità	Dettagli
Scaricare gli aggiornamenti più recenti per il driver JDBC 12.8.	• GitHub, 12.8.0 • Maven Central
Completamente conforme alla specifica API JDBC 4.2.	I file JAR nel pacchetto 12.8 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file the mssql-jdbc-12.8.0.jre11.jar del pacchetto 12.8 deve essere usato con Java 11 (o versione successiva).
Compatibile con Java Development Kit (JDK) versione 22.0, 21.0, 17.0, 11.0 e 1.8.	Microsoft JDBC Driver 12.8 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 22.0, oltre a JDK 21.0, 17.0, 11.0 e 1.8.

Versioni 12.8

Numero di versione: 12.8.1
Versione 22 agosto 2024

Modifiche apportate alla versione 12.8.1:

Modifica della registrazione MSAL da FINER a FINEST

Problemi risolti nella versione 12.8.1:

Modificato DESTINATION_COL_METADATA_LOCK, in SQLServerBulkCopy, in modo che venga rilasciato correttamente in tutti i casi
Modifica del comportamento del driver per consentire il riutilizzo degli oggetti istruzione preparati, impedendo un errore "non sono consentite più query"
È stata ripristinata la funzionalità "Esegui stored procedure direttamente" e le successive modifiche correlate alla funzionalità.

Scaricare Microsoft JDBC Driver 12.8.1 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.8.1 per SQL Server (tar.gz)

Numero di versione: 12.8.0
Data di uscita: 31 luglio 2024

Scaricare Microsoft JDBC Driver 12.8.0 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.8.0 per SQL Server (tar.gz)

Nuove funzionalità della versione 12.8

Funzionalità	Dettagli
Supporto per Java 22	Il driver è ora compatibile con Java Development Kit (JDK) versione 22.0, oltre a JDK JDK 21.0, 17.0, 11.0 e 1.8.
Aggiunta della memorizzazione nella cache delle credenziali per le credenziali di identità gestite e credenziali di Azure predefinite	Per migliorare le prestazioni e l'affidabilità del driver, quest'ultimo consente ora la memorizzazione nella cache delle credenziali precedentemente menzionate.
Consenti memorizzazione nella `SQLServerBulkCopy` dell'oggetto quando si usa la copia bulk per l'inserimento in batch	Sostituisce il comportamento precedente, in cui ogni chiamata di `executeBatch()` ha generato un nuovo oggetto `SQLServerBulkCopy` memorizzandolo nella cache.
Aggiunta della memorizzazione nella cache a livello di connessione per i metadati della colonna di destinazione in copia bulk	Migliora le prestazioni aggiungendo la memorizzazione nella cache a livello di connessione per i metadati delle colonne di destinazione negli scenari di copia bulk. Questa funzionalità è abilitata impostando la proprietà della stringa di connessione appena aggiunta `cacheBulkCopyMetadata` su `true` (il valore predefinito è `false`).
Aggiunta di un gestore di messaggi di SQL Server e del supporto per il concatenamento di SQLException	È stato aggiunto un gestore di messaggi di SQL Server che consente diverse funzionalità, tra cui feedback aggiuntivo per query a esecuzione prolungata, registrazione degli errori universali e downgrade automatico della gravità del messaggio di errore da SQLException a SQLWarning. Questa funzionalità consente inoltre di concatenare le espressioni SQLExceptions in modo che tutti i messaggi di errore siano disponibili per l'utente. Vedere Gestione degli errori.
Supporto completo per RFC4180 per le operazioni di inserimento bulk CSV	Aggiunto il supporto per i campi tra virgolette contenenti righe nuove mancanti per garantire il supporto completo con RFC4180; tale supporto è stato ora aggiunto.
Consentire la costruzione di un'istanza `microsoft.sql.DateTimeOffset` da un valore `java.time.OffsetDateTime`	Conversione tra i due tipi di dati già esistenti nel driver usando un `Timestamp` intermediario. Questa aggiunta rimuove tale intermediario, migliorando le prestazioni e riducendo il potenziale di errori correlati al fuso orario.

Modifiche apportate alla versione 12.8

Modifica	Dettagli
L'enumerazione `SQLServerSortOrder` è ora pubblica	Modificata la visibilità dell'enumerazione `SQLServerSortOrder` in pubblico, che consente agli utenti una maggiore flessibilità nelle query che usano questa enumerazione.
Rimuovere `synchronized` dalle sostituzioni di socket	Aggiunte in modo non corretto nelle modifiche precedenti per verificare con gli standard di controllo del codice, i metodi selezionati non sono stati modificati, in effetti, devono essere sincronizzati e sono cambiati in modo da riflettere questo fatto.
Revisionate le modifiche RMERR/RMFAIL precedenti rendendo `RMFAIL` come impostazione predefinita.	Le modifiche precedenti hanno modificato il valore di `XAER_RMFAIL` in `XAER_RMERR` per i casi selezionati, tuttavia questi casi sono diventati rapidamente la maggior parte di tutti i casi trattati. La soluzione consiste nel modificare l'impostazione predefinita in `RMFAIL` e convertire in `RMERR` per l'inverso dei casi precedentemente indicati.
Dipendenze aggiornate	Versioni delle dipendenze aggiornate per `azure-identity`, `bouncycastle` e `msal`.
Supporto revisionato per `TDSType.GUID`	Migliora l'aggiunta originale del supporto per `TDSType.GUID` consentendo il passaggio diretto dell'UUID al metodo `setObject`.
Aggiunta la registrazione alla memorizzazione nella cache dei token	Aggiunta un’altra registrazione per gli scenari di memorizzazione nella cache dei token per facilitare il debug degli scenari.

Correzioni nella versione 12.8

Fix	Dettagli
Correzione della regressione con la specifica dei nomi degli argomenti nella sintassi dell'istruzione chiamabile	Correzione di una regressione dalla versione 12.6.2 --> 12.6.3 in cui CallableStatements di un determinato formato restituisce valori non corretti. Problema GitHub n. 2477.
Correzione dell'analisi per le parentesi nelle stored procedure e nelle funzioni	Risolvere un problema per cui la chiamata di una funzione con parantesi alla fine di un'istruzione chiamabile, ad esempio function() e function, con conseguente valore restituito sempre pari a 0. Questa modifica è stata una regressione dalla versione 12.6.2 --> 12.6.3. Problema GitHub n. 2463.
Correzione di un errore per cui `CallableStatement` non veniva rispettato dal driver con gli argomenti predefiniti.	Correzione di un errore di regressione da 12.5.0 --> 12.6.0, in cui gli argomenti predefiniti nelle istruzioni chiamabili venivano ignorati. Problema GitHub n. 2446.
Correzione per rimuovere la classe `TokenCredential` in cui il driver non lo richiede	`TokenCredentialClass` non è necessario in `SQLServerSecurityUtility` e può causare un'eccezione `NoClassDefFoundError` emessa in modo non corretto. Con questa correzione viene rimossa l'importazione, sostituendola con un `Object` generico. Problema GitHub n. 2439.
Correzione dell'errore di conversione della stringa di timestamp per CallableStatements	Correzione di un'eccezione di conversione che si è verificata durante la chiamata di un parametro in/out `DateTime` durante l'impostazione di un valore `String`. Problema GitHub n. 2436.
Correzione del costruttore SqlAuthenticationToken per accettare il parametro corretto	Il costruttore per SQLAuthenticationToken non è corretto, usando un parametro di input in secondi, quando dovrebbe essere espresso in millisecondi. Problema GitHub n. 2424.
Correzione per cancellare l'handle dell'istruzione preparata prima di riconnettersi	In questo modo viene risolto un problema a causa del quale gli handle non corretti venivano usati in un `SQLServerPreparedStatement` dopo la riconnessione cancellando `SQLServerPreparedStatement.prepStmtHandle` correttamente prima di riconnettersi. Problema GitHub n. 2364.
Correzione per cancellare la cache dell'istruzione preparata durante la reimpostazione della connessione al pool di istruzioni	In questo modo viene risolto un problema a causa del quale, con il pool di istruzioni abilitato, il riutilizzo di una connessione da ConnectionPool causava la mancanza o l'inserimento non corretto di voci. Problema GitHub n. 2356.
Correzione di unbind `socketTimeout` da `loginTimeout`	`socketTimeout` deve avere un limite superiore di `loginTimeout` per la connessione, ma non deve avere alcun limite superiore dopo la connessione del driver. Questo comportamento è stato risolto con questa modifica Problema GitHub n. 2354.
Correzione per controllare correttamente se il contatore `TDSCommand` è Null prima di provare a incrementare	Aggiunge un controllo `null` mancante per il contatore `TDSCommand`, impedendo un'operazione `NullPointerException` che altrimenti potrebbe verificarsi. Problema GitHub n. 2353.
Correggere le routine di chiamata con i parametri di output in base alla sintassi in quattro parti	Risolve un problema a causa del quale la chiamata di stored procedure con una sintassi in quattro parti (ad esempio con un server collegato) ha generato un errore che indica che il flusso del protocollo TDS non è valido. Problema GitHub n. 2344.
Correzione per eseguire correttamente l’escape dei parametri `schema` per `getProcedures` e `getProcedureColumns`	I metodi `SQLServerDatabaseMetadata` `getProcedures` e `getProcedureColumns` non eseguono correttamente l'escape di determinati caratteri (ad esempio `\`) per il parametro `schema`. Questa modifica risolve il problema. Problema GitHub n. 2336.
Aggiunta della mappa della cache dei token per correggere l'uso del token di autenticazione non previsto per le connessioni successive	In questo modo viene risolto un problema per cui le credenziali client potrebbero essere riutilizzate inavvertitamente. Mentre il token di autenticazione è stato memorizzato correttamente nella cache, il driver riutilizzava il token con solo il segreto client modificato. Problema GitHub n. 2334.
Correzione del supporto per la sintassi di escape `exec` per CallableStatements	In questo modo è stato risolto un problema per cui, dopo aver rimosso le chiamate `sp_executesql`/`sp_prepexec` di cui è stato eseguito il wrapping per eseguire rapidamente CallableStatements, le chiamate `EXEC` non funzionavano più. Problema GitHub n. 2325.
Correzione per assicurarsi che `Money` e `SmallMoney` siano compresi negli intervalli corretti per copia bulk	In questo modo è stato risolto un problema per cui, quando si usa copia bulk con i valori `Money` o `SmallMoney`, la conversione in/da questi valori può causare un `ArithmeticOverflowException`. Problema GitHub n. 2309.
Correzione per assicurarsi che `ResultSetMetadata` per `DataabseMetadata.getColumns()` sia corretta per tutte le colonne	I metadati restituiti non sono corretti per alcune colonne; il problema è stato risolto con questa correzione. Problema GitHub n. 2232.
Correzione per disattivare correttamente i tentativi di connessione quando `connectRetryCount` è impostato su `0`	In questo modo è stato corretto il comportamento in cui, anche con `connectRetryCount` impostato su 0, il driver ha tentato di riprovare fino a quando non è stato raggiunto `loginTimeout`. Problema GitHub n. 2232. Problema GitHub n. 2188.
Correzione per risolvere una perdita `ClassLoader` di `ActivityCorrelator` `ThreadLocal`	Risolve un problema per cui, dopo che il driver precedente cambia in `ActivityId`, `ThreadLocal` in `ActivityCorrelator` non viene mai rimosso dal thread.
Correzione dell'esecuzione di stored procedure direttamente per le chiamate RPC	Le chiamate RPC usavano la logica precedente con il wrapping nelle chiamate `sp_executesql`. Questo comportamento è stato corretto con questa modifica.

Versioni precedenti

12.6

Scaricare Microsoft JDBC Driver 12.6.4 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.6.4 per SQL Server (tar.gz)

Numero di versione: 12.6.4
Versione 29 agosto 2024

Conformità 12.6

Modifica di conformità	Dettagli
Scaricare gli aggiornamenti più recenti per il driver JDBC 12.6.	• GitHub, 12.6.0 • Maven Central
Completamente conforme alla specifica API JDBC 4.2.	I file JAR nel pacchetto 12.6 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file mssql-jdbc-12.6.0.jre11.jar del pacchetto 12.6 deve essere usato con Java 11 (o versione successiva).
Compatibile con Java Development Kit (JDK) versione 21.0, 17.0, 11.0 e 1.8.	Microsoft JDBC Driver 12.6 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 21.0, oltre a JDK 17.0, 11.0 e 1.8.

Versioni 12.6

Numero di versione: 12.6.4
Versione 29 agosto 2024

Problemi risolti nella versione 12.6.4:

È stata ripristinata la funzionalità "Esegui stored procedure direttamente" e le successive modifiche correlate alla funzionalità.

Scaricare Microsoft JDBC Driver 12.6.4 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.6.4 per SQL Server (tar.gz)

Numero di versione: 12.6.3
Data di rilascio: 20 giugno 2024

Problemi risolti nella versione 12.6.3:

Correzione del problema per cui era necessario importare la classe TokenCredential
Correzione della regressione della conversione di stringhe timestamp
Correzione della regressione del valore predefinito di SQLServerCallableStatement

Scaricare Microsoft JDBC Driver 12.6.3 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.6.3 per SQL Server (tar.gz)

Numero di versione: 12.6.2
Data di rilascio: 23 maggio 2024

Funzionalità aggiunte nella versione 12.6.2:

Aggiunta della memorizzazione nella cache delle credenziali per le credenziali di identità gestite e credenziali di Azure predefinite

Problemi risolti nella versione 12.6.2:

Verificare che money e small money siano compresi nell'intervallo corretto per la copia bulk
Controllare se il contatore TDSCommand è null prima dell'incremento
Cancellare la cache dell'istruzione preparata durante la reimpostazione della connessione al pool di istruzioni
Cancellare l'handle dell'istruzione preparata prima di riconnettersi
Le chiamate RPC per CallableStatements vengono eseguite direttamente
Correzione dell'oggetto token di autenticazione per accettare la scadenza in millisecondi
Il socketTimeout deve essere non associato da loginTimeout dopo l'apertura di una connessione riuscita

Scaricare Microsoft JDBC Driver 12.6.2 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.6.2 per SQL Server (tar.gz)

Numero di versione: 12.6.1
Data di uscita: 20 febbraio 2024

Problemi risolti nella versione 12.6.1:

Correzione della sintassi di escape "EXEC" per CallableStatements

Scaricare Microsoft JDBC Driver 12.6.1 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.6.1 per SQL Server (tar.gz)

Numero di versione: 12.6.0
Data di rilascio: 31 gennaio 2024

Scaricare Microsoft JDBC Driver 12.6.0 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.6.0 per SQL Server (tar.gz)

Nuove funzionalità della versione 12.6

Funzionalità	Dettagli
Supporto per Java 21	Il driver è ora compatibile con Java Development Kit (JDK) versione 21.0, oltre a JDK 17.0, 11.0 e 1.8.
Consentire la chiamata di stored procedure direttamente tramite l'uso della nuova proprietà di connessione `useFlexibleCallableStatements`	Il driver chiama ora direttamente le stored procedure, anziché eseguire il wrapping della procedura intorno a `exec sp_executesql`, semplificando la procedura e migliorando le prestazioni.
Aggiunta la proprietà della stringa di connessione `useDefaultJaasConfig`	Se impostato su true, consente l'autenticazione Kerberos senza ulteriore configurazione esterna.
Aggiunta la proprietà della stringa di connessione `useDefaultGSSCredential`	Se impostato su true, consente al driver di creare GSSCredential per conto dell'utente, quando si usa la GSS-API nativa per l'autenticazione Kerberos.
Aggiunta la proprietà della stringa di connessione `calcBigDecimalPrecision`	Se impostato su true, consente al driver di calcolare la precisione per gli input BigDecimal.
Sono stati aggiunti nuovi logger denominati per i tentativi di apertura delle connessioni e per le riconnessioni di resilienza delle connessioni inattive	I tentativi di apertura della connessione utilizzano la categoria di registrazione Reindirizzamento e possono essere utilizzati al livello di registrazione FINE. La resilienza delle connessioni inattive usa la categoria di registrazione Resilienza e può essere usata ai livelli di registrazione FINE o FINER.

Modifiche apportate alla versione 12.6

Modifica	Dettagli
È stato modificato il modo in cui IBM JDK viene controllato per prevenire problemi con gli ambienti OSGi	È stato modificato il controllo del solo nome del fornitore per controllare sia il nome del fornitore sia il nome della macchina virtuale.
Tutte le chiamate a MSAL sono state sincronizzate correttamente	Impedisce al driver di effettuare chiamate aggiuntive e di provare dialoghi non necessari.
Sono stati aggiunti ulteriori errori che devono essere convertiti in RMFAIL	Sono stati aggiunti altri casi, "connessione ripristinata dal peer" e "connessione interrotta", che dovrebbero corrispondere a RMFAIL
È stato modificato il modo in cui vengono utilizzati i timestamp in copia bulk	È stato modificato il comportamento di copia bulk dalla serializzazione e deserializzazione degli oggetti timestamp all'uso diretto degli oggetti, con conseguente miglioramento delle prestazioni quando un utente usa un numero elevato di timestamp.
Si è modificato `socketTimeout` per assicurarsi che sia correttamente minore di `loginTimeout`	In precedenza `socketTimeout` agiva in modo indipendente da `loginTimeout` causando un comportamento potenzialmente confuso in cui il driver impiegava più tempo del previsto per il timeout. Questo problema viene risolto in modo che `socketTimeout` abbia sempre un limite superiore uguale a `loginTimeout`.
La cache PreparedStatement è stata modificata in modo da cancellarsi prima di ogni esecuzione	La cache PreparedStatement non veniva cancellata correttamente e questo, oltre alla sua scarsa frequenza, poteva causare problemi di memoria nel tempo. Questa modifica garantisce che la cache venga pulita prima di ogni esecuzione, evitando l'accumulo di oggetti.
È stato eseguito l'aggiornamento alle dipendenze Bouncycastle più recenti	Eseguire l'aggiornamento da `bcprov-jdk15on` e `bcpkix-jdk15on` a `bcprov-jdk18on` e `bcpkix-jdk18on` poiché il precedente non viene più aggiornato.
Dipendenze aggiornate	Versioni delle dipendenze aggiornate per `azure-identity`, `azure-security-keyvault-keys`, `bouncycastle`, `h2` e `msal`.

Correzioni nella versione 12.6

Fix	Dettagli
È stato corretto un controllo Null mancante per e.getCause()	Risoluzione di un problema per cui, quando un'eccezione non ha una causa, viene passata l'eccezione stessa, evitando che vada persa. Problema GitHub n. 2299.
Correzione dei blocchi in IOBuffer per evitare problemi di deadlock che potrebbero verificarsi	Correzione dell'implementazione dei blocchi in IOBuffer, in particolare attorno a DisableSSL, per prevenire deadlock che potrebbero verificarsi in determinate situazioni. Problema GitHub n. 2288. Problema GitHub n. 2265.
Risoluzione di un problema relativo ai timestamp e alla copia bulk per l'inserimento batch	Correzione del problema con il fuso orario che non veniva applicato correttamente ai timestamp quando inserito usando l'inserimento batch con copia bulk. Problema GitHub n. 2271.
Correzione dei getter mancanti e dei setter per `useBulkCopyForBatchInsert`	Risolvere un problema per cui il comportamento non era lo stesso tra `SQLServerConnection` e `SQLServerConnnectionPoolProxy`, quando avrebbe dovuto esserlo, perché a `useBulkCopyForBatchInsert` mancavano un getter e un setter. Problema GitHub n. 2245.
Correzione della query sui metadati della copia bulk per usare i dati memorizzati nella cache, se disponibili	Risoluzione di un problema per cui, nonostante i dati fossero memorizzati nella cache, le chiamate ai metadati delle colonne venivano effettuate ogni volta. Problema GitHub n. 2224.
Correzione di un controllo mancante della scala BigDecimal per i valori TVP	Risoluzione di un problema per cui, durante la scrittura dei valori delle righe TVP, i valori di input non venivano filtrati correttamente per la scala BigDecimal. Problema GitHub n. 2222.
Correzione dello schemaPattern in SQLServerDatabaseMetadata per garantire che i metodi che utilizzano il parametro lo evadano correttamente.	Risoluzione di un problema per cui schemaPattern era l'unico criterio di escape non eseguito correttamente in SQLServerDatabaseMetadata. Problema GitHub n. 2186.
Risoluzione di un problema a causa del quale veniva restituito un valore SQLState null quando si cercava di convertire una data in una data lunga	Risoluzione di un problema per cui, quando `xopenStates` è impostato su true, il driver non restituisce il codice di stato SQL-99 previsto in una particolare istanza. Problema GitHub n. 2167.
Correzione dell'errore getMetaData per le query contenenti TOP	Risoluzione di un problema per cui, quando si usava il qualificatore TOP in una query, il driver restituiva un errore relativo a ParameterMetadata. Problema GitHub n. 1776.
Correzione di un problema di analisi dei nomi di tabella quando si usano inserimenti batch	Risoluzione di un problema per cui le istruzioni insert con spazi vuoti mancanti funzionavano correttamente nei casi normali, ma non quando si usavano inserimenti batch. Problema GitHub n. 1534.
Risoluzione di un problema relativo a ParameterMetadata e a indici non validi	Risoluzione di un problema con ParameterMetadata che non controllava correttamente e generava eccezioni per un indice 0 non valido. Problema GitHub n. 1490.
Correzione del comportamento di ActivityID in ActivityCorrelator	Correzione del modo in cui ActivityID veniva definito e usato per essere più in linea con il comportamento di altri driver Microsoft.
Correzione per ignorare le colonne calcolate quando si usa la copia bulk per l'inserimento in batch	Correzione del comportamento di copia bulk per ignorare le colonne calcolate e consentire inserimenti batch, quando in precedenza l'inserimento falliva e restituiva un errore citando tali colonne calcolate.
Correzione del comportamento del driver relativo alle firme durante l'utilizzo dell'archivio di chiavi Java e di Azure Key Vault	Risoluzione di un problema dove il driver non veniva verificato correttamente quando si usava l'archivio di chiavi Java, e aggiungeva una nuova API per firmare i metadati della chiave master della colonna (e restituire la firma generata) da usare con l'archivio di chiavi Java e Azure Key Vault
Correzione della conversione errata di DateTimeOffset di getObject()	Risoluzione di un problema che si verificava durante la chiamata a ResultSet.getObject() su una colonna DATETIMEOFF, con LocalDate/LocalTime/LocalDateTime come argomento della classe, dove il valore nella colonna veniva convertito nel fuso orario locale.

12.4

Scaricare Microsoft JDBC Driver 12.4.2 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.4.2 per SQL Server (tar.gz)

Numero di versione: 12.4.2
Data di rilascio: 27 ottobre 2023

Conformità 12.4

Modifica di conformità	Dettagli
Scaricare gli aggiornamenti più recenti per il driver JDBC 12.4.	• GitHub, 12.4.0. • Maven Central.
Completamente conforme alla specifica API JDBC 4.2.	I file JAR nel pacchetto 12.4 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file mssql-jdbc-12.4.0.jre11.jar del pacchetto 12.4 deve essere usato con Java 11 (o versione successiva).
Compatibile con Java Development Kit (JDK) versione 20.0, 17.0, 11.0 e 1.8.	Microsoft JDBC Driver 12.4 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 20.0, oltre a JDK 17.0, 11.0 e 1.8.

Versioni 12.4

Numero di versione: 12.4.2
Data di rilascio: 21 settembre 2023

Problemi risolti nella versione 12.4.2:

Il controllo IBM è stato ripristinato in controllo del fornitore ed è stato aggiunto un controllo aggiuntivo del nome della macchina virtuale per eliminare i falsi positivi

Scaricare Microsoft JDBC Driver 12.4.2 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.4.2 per SQL Server (tar.gz)

Numero di versione: 12.4.1
Data di rilascio: 24 agosto 2023

Modifiche apportate alla versione 12.4.1:

Ai nomi dei parametri SQL preparati ora viene applicata la spaziatura automatica

Problemi risolti nella versione 12.4.1:

Correzione della query di metadati getUserName nel contesto di sicurezza rappresentato nel database SQL di Azure
Correzione del rilevamento IBM JDK
Correzione del bug per cui la firma non viene verificata per l'archivio di chiavi Java e aggiunta l'API signColumnMasterkeyMetadata a JKS e AKV
Aggiunta la localizzazione delle stringhe di errore mancanti nella versione originale

Scaricare Microsoft JDBC Driver 12.4.1 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.4.1 per SQL Server (tar.gz)

Numero di versione: 12.4.0
Data di rilascio: 31 luglio 2023

Scaricare Microsoft JDBC Driver 12.4.0 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.4.0 per SQL Server (tar.gz)

Nuove funzionalità della versione 12.4

Funzionalità	Dettagli
Supporto per Java 20	Il driver è ora compatibile con Java Development Kit (JDK) versione 20.0, oltre a JDK 17.0, 11.0 e 1.8.
È stata aggiunta la proprietà della stringa di connessione di richiamata del token di accesso	Integra la richiamata del token di accesso implementata in precedenza consentendo di passare il nome della classe che implementa la richiamata nella stringa di connessione.
È stato aggiunto il supporto per ActiveDirectoryServicePrincipalCertificate	È stata migliorata l'esperienza utente supportando `ActiveDirectoryServicePrincipalCertificate` dalla libreria di identità di Azure tramite l'opzione di connessione `authentication=ActiveDirectoryServicePrincipalCertificate`.
È stato aggiunto un altro caso per XAER_RMFAIL	In alcuni casi il driver continuava a restituire XAException con l'errore XAER_RMERR. È stato aggiunto un caso aggiuntivo alla gestione degli errori XA per risolvere questo problema.

Modifiche apportate alla versione 12.4

Modifica	Dettagli
Aggiornamento della logica di autenticazione federata per l'uso della cache dei token persistente durante il recupero del token	Questo aggiornamento migliora le prestazioni negli scenari di recupero dei token e consente più facilmente la compatibilità con le versioni future di MSAL.
È stato consentito il tentativo del partner di failover in caso di timeout del socket	Consente un tentativo di riconnessione con un partner di failover fornito dopo un timeout del socket.
Miglioramento delle prestazioni durante la creazione di definizioni di tipi di parametri	Precalcolando le dimensioni delle matrici e dei generatori di stringhe usati in `buildParamTypeDefinitions` e rimuovendo le allocazioni di stringhe non richieste, è possibile migliorare le prestazioni in cui viene utilizzato questo metodo.
Modificato serverName inviato nel pacchetto `LOGIN` per includere instanceName	`serverName` viene ora accodato alla fine di `instanceName` nei pacchetti `LOGIN`.
Aggiornamento del metodo supportTransaction per riflettere se il server supporta le transazioni	Risolve un problema per cui `connection.rollback` non funzionava per il database di Azure Synapse, perché la sintassi usata in `supportTransaction` non era supportata da Azure Synapse.
Aggiornare le chiamate sp_cursor in modo che vengano passati i nomi delle tabelle anziché una stringa vuota	Risolve un problema a causa del quale sono stati ricevuti aggiornamenti incoerenti delle righe di ResultSet durante l'aggiornamento di tabelle uno-a-molti.
Aggiornamento di supportsLikeEscapeClause() per controllare Azure Data Warehouse	Risolve un problema per cui `supportsLikeEscapeClause` restituiva true per AzureDW nonostante non fosse supportato in modo esplicito.
Aggiornato alla specifica OSGi JDBC più recente	Aggiornamento da `osgi.compendium` 5.0.0 a `osgi.service.jdbc` 1.1.0 per mantenere la conformità alla specifica OSGi JDBC 8.1.0.
Dipendenze aggiornate	Versioni delle dipendenze aggiornate per `azure-identity`, `azure-security-keyvault-keys`, `gson`, `h2` e `msal`.

Correzioni nella versione 12.4

Fix	Dettagli
Correzione di problemi di prestazioni e memoria con BigDecimal	Ripristina tutte le modifiche, a partire dalla versione 12.2, relative a BigDecimal. Questa correzione risolve i problemi di prestazioni riscontrati. Gli utenti devono prestare attenzione quando si usa BigDecimal per evitare i problemi di troncamento risolti in precedenza. Problema GitHub n. 2176.
Correzione della convalida del certificato del server per encrypt=strict	Correzione per assicurarsi che il certificato del server venga convalidato correttamente nei casi in cui `encrypt` è impostato su `strict`. Problema GitHub n. 2174.
Correzione del problema con lockTimeout che non aveva effetto quando la modalità di reindirizzamento era impostata nel database di Azure	È stato il problema relativo all'impostazione di `lockTimeout`, poiché dovrebbe applicarsi solo alle connessioni dall'esterno di Azure e non dall'interno di Azure, come in precedenza. Problema GitHub n. 2110.
Correzione del conteggio elevato di thread quando si usa findSocketUsingThreading	Risolve un problema a causa del quale un'eccezione non rilevata portava all'interruzione delle chiamate in sospensione upstream, causando tentativi troppo rapidi. Problema GitHub n. 2104.
Correzione della race condition del timer condiviso	Correzione di una potenziale race condition nella classe `SharedTimer`. Problema GitHub n. 2085.
Correzione di un errore con le stored procedure e la restituzione del risultato zero `metaQuery`	Risoluzione di un problema per cui, se `metaQuery` non restituiva alcun risultato dopo l'esecuzione di una stored procedure, questo problema restituiva un errore di parametro non definito. Problema GitHub n. 2063.
Correzione dei problemi relativi agli inserimenti batch non validi quando le colonne fornite nell'inserimento differivano nell'ordine dallo schema della tabella	Risoluzione di un problema per cui l'utilizzo di `useBulkCopyForBatchInsert=true` può causare la combinazione di colonne e dati non validi. Problema GitHub n. 1992.
Correzione della gestione degli errori XA per rilanciare XAER_RMFAIL invece di XAER_RMERR	Risoluzione di un problema per cui il driver restituiva XAException con il codice di errore XAER_RMERR in caso di failover di SQL Server dal nodo primario al nodo di standby durante il commit di una transazione XA. Problema GitHub n. 1432.
Correzioni dell'ID attività e del comportamento dell'ID client per mantenere la coerenza con la specifica JDBC	Correzione del comportamento dell'ID attività per rimanere invariato per tutta la durata del processo, inviare sempre l'ID attività in `PRELOGIN` e incrementare la sequenza per ogni nuova connessione. Inoltre, è stato corretto l'ID client affinché persista per tutta la durata del processo.

12,2

Scaricare Microsoft JDBC Driver 12.2.0 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.2.0 per SQL Server (tar.gz)

Numero di versione: 12.2.0
Data di rilascio: 31 gennaio 2023

Conformità 12.2

Modifica di conformità	Dettagli
Scaricare gli aggiornamenti più recenti per il driver JDBC 12.2.	• GitHub, 12.2.0. • Maven Central.
Completamente conforme alla specifica API JDBC 4.2.	I file JAR nel pacchetto 12.2 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file mssql-jdbc-12.2.0.jre11.jar del pacchetto 12.2 deve essere usato con Java 11 (o versione successiva).
Compatibile con Java Development Kit (JDK) versione 19.0, 17.0, 11.0 e 1.8.	Microsoft JDBC Driver 12.2 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 19.0, oltre a JDK 17.0, 11.0 e 1.8.

Versioni 12.2

Scaricare Microsoft JDBC Driver 12.2.0 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 12.2.0 per SQL Server (tar.gz)

Numero di versione: 12.2.0
Data di rilascio: 31 gennaio 2023

Nuove funzionalità della versione 12.2

Funzionalità	Dettagli
Supporto per Java 19	Il driver è ora compatibile con Java Development Kit (JDK) versione 19.0, oltre a JDK 17.0, 11.0 e 1.8.
Aggiunto il supporto per la richiamata del token di accesso	Consente al codice client di registrare una richiamata su un DataSource che restituisce un token di accesso.
Aggiunta del supporto per DefaultAzureCredential	Miglioramento dell'esperienza utente supportando sia `DefaultAzureCredential` che `IntelliJCredential` dalla libreria di identità di Azure tramite l'opzione di connessione `authentication=ActiveDirectoryDefault`.
Aggiunta di una nuova proprietà di connessione datetimeParameterType per specificare il tipo di dati da usare per i parametri data/data e ora	Aggiunta di una proprietà di connessione `datetimeParameterType` che consente agli utenti di specificare in modo esplicito le conversioni in `datetime` o `datetime2`, offrendo maggiore compatibilità nei database meno recenti.

Modifiche apportate alla versione 12.2

Modifica	Dettagli
Resa semplice da usare con il driver Loom	Sostituisce `synchronized(foo)` con blocchi reentranti, migliorando le prestazioni quando si usa Loom.
L'autenticazione dell'identità gestita usa la libreria di identità di Azure	Sostituisce il codice predefinito del driver per ottenere e memorizzare nella cache i token di identità gestita con la libreria di identità di Azure. Questa modifica aggiunge il supporto dell'identità gestita per altri servizi di Azure rispetto a quelli supportati in precedenza dal driver.
Ha reso MSAL una dipendenza facoltativa	Ha reso msal4j di nuovo una dipendenza facoltativa.
Dipendenze aggiornate	Versioni delle dipendenze aggiornate per `azure-identity`, `azure-security-keyvault-keys`, `antlr4-runtime`, `bcprov-jdk15on`, `bcpkix-jdk15on` e `msal`.
Aggiornare per verificare in modo dinamico la classe ExtendedSocketOption	Risolve un errore in cui ExtendedSocketOptions mancante restituiva un `NoClassDefFoundError`.

Correzioni nella versione 12.2

Fix	Dettagli
Correzione dello stato SQL null e del codice di errore zero quando viene generata un'eccezione del database	Risoluzione di un problema per cui, dopo l'errore SQL, lo stato SQL e il codice di errore mostravano informazioni non corrette. Problema GitHub n. 2015.
Correzione del ripristino della connessione inattiva in modo che `unprocessedResponseCount` non venga decrementato eccessivamente	`unprocessedResponseCount` deve essere decrementato solo quando `doneToken.isFinal` è true, mentre veniva decrementato a prescindere. Problema GitHub n. 1971.
Correzione della connessione all'host SQLServer errato	Risolve un problema di concorrenza per cui, quando un driver si connette a più host SQLServer, potrebbe essere stabilita una connessione all'host errato. Problema GitHub n. 1964.
Correzione di un `updateCount` non corretto	Il conteggio errato degli aggiornamenti può verificarsi in entrambi i casi true/false per `enablePrepareOnFirstPreparedStatementCall` e per prepexec/prepare. Problema GitHub n. 1961.
Correzione dei problemi di concorrenza nei metodi di offuscamento di crittografia/decrittografia per la password del truststore	Aggiunta di blocchi per crittografare/decrittografare nell'offuscamento della password del truststore. Problema GitHub n. 1939.
Correzione del problema relativo alla combinazione di maiuscole e minuscole del nome dell'account della cache	Risolve un problema a causa del quale i nomi degli account venivano inviati a Microsoft Authentication Library con distinzione tra maiuscole e minuscole, causando richieste di accesso ripetute. Problema GitHub n. 1923.
Correzione del bug di annullamento delle query	Correzione del bug di annullamento delle query che si verificava in modo intermittente nelle query batch. Problema GitHub n. 1896.
Correzione degli errori delle istruzioni richiamabili	Corregge gli errori "indice fuori limite" e "parametro non definito" delle istruzioni richiamabili. Problema GitHub n. 1871.
Correzione del controllo per il token DONE durante il recupero dei set di risultati	Aggiunge un caso non risolto nella precedente correzione di DONE_ERROR, in cui il driver ignorava lo stato DONE_ERROR del server derivante da una sessione terminata. Problema GitHub n. 1846. Problema GitHub n. 1505.
Assicurarsi che batchParamValues sia cancellato in tutti i casi durante l'esecuzione di un batch	Risolve un problema per cui i batch non venivano cancellati correttamente in caso di errore durante l'utilizzo dell'aggiornamento in blocco. Problema GitHub n. 1767.
Correzione della precisione inviata quando si usa BigDecimal	Risolve un problema per cui, per impostazione predefinita, i valori BigDecimal venivano inviati con precisione massima, con conseguente arrotondamento decimale indesiderato. Problema GitHub n. 1489. Problema GitHub n. 942
Correzione del protocollo di attestazione `NONE` affinché funzioni in tutti i casi	Correzione della logica dietro il protocollo di attestazione `NONE` affinché funzioni in tutti i casi, non solo in quelli specifici.
Correzione della race condition in SecureStringUtil	Correzione di una race condition in SecureStringUtil durante la creazione di SecureStringUtil.

11.2

Scaricare Microsoft JDBC Driver 11.2.3 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 11.2.3 per SQL Server (tar.gz)

Numero di versione: 11.2.3
Data di rilascio: 12 gennaio 2023

Conformità 11.2

Modifica di conformità	Dettagli
Scaricare gli aggiornamenti più recenti per JDBC Driver 11.2.	• GitHub, 11.2.0. • Maven Central.
Completamente conforme alla specifica API JDBC 4.2.	I file JAR nel pacchetto 11.2 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file mssql-jdbc-11.20.jre17.jar dal pacchetto 11.2 deve essere usato con Java 17.
Compatibile con Java Development Kit (JDK) versione 18.0, 17.0, 11.0 e JDK 1.8.	Microsoft JDBC Driver 11.2 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 18.0, oltre a JDK 17.0, 11.0 e 1.8.

Versioni 11.2

Numero di versione: 11.2.3
Data di rilascio: 12 gennaio 2023

Problemi risolti nella versione 11.2.3:

Correzione dello stato SQL null e del codice di errore zero quando viene generata un'eccezione del database
Correzione dei conteggi errati degli aggiornamenti quando si verifica il timeout nelle query batch
Correzione della data di scadenza del token errata quando si usa Funzioni di Azure
Correzione della connessione all'host SQLServer errato

Numero di versione: 11.2.2
Data di rilascio: 15 dicembre 2022

Problemi risolti nella versione 11.2.2:

Correzione del bug di resilienza della connessione inattiva
Cancellare la cache dell'handle dell'istruzione preparata in caso di riconnessione inattiva
Correzione dell'errore relativo all'indice delle istruzioni richiamabili fuori dai limiti
Correzione del controllo per il token DONE durante il recupero dei set di risultati
Correzione dell'errore intermittente: "Errore interno durante la decrittografia: mancata corrispondenza tag!"

Scaricare Microsoft JDBC Driver 11.2.2 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 11.2.2 per SQL Server (tar.gz)

Numero di versione: 11.2.1
Data di rilascio: 8 settembre 2022

Problemi risolti nella versione 11.2.1:

Ha reso com.microsoft.azure:msal4j una dipendenza facoltativa
Correzione di un bug di annullamento delle query che si verificava in modo intermittente nelle query batch

Scaricare Microsoft JDBC Driver 11.2.1 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 11.2.1 per SQL Server (tar.gz)

Numero di versione: 11.2.0
Data di rilascio: 4 agosto 2022

Scaricare Microsoft JDBC Driver 11.2.0 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 11.2.0 per SQL Server (tar.gz)

Nuove funzionalità della versione 11.2

Funzionalità	Dettagli
Supporto per Java 18	Il driver è ora compatibile con Java Development Kit (JDK) versione 18.0, oltre a JDK 17.0, 11.0 e 1.8.
Aggiunta del supporto IPv6 configurabile	La preferenza dell'indirizzo IP per l'applicazione client può ora essere impostata tra IPv4 e IPv6. Uso della nuova impostazione di connessione `ipaddresspreference` per controllare il comportamento. Per altre informazioni, vedere Impostazione delle proprietà di connessione.
Aggiunta del supporto per la selezione del metodo di preparazione	Aggiunta della nuova proprietà della stringa di connessione prepareMethod per alternare l'uso di sp_prepare e sp_prepexec. Uso della nuova impostazione di connessione `prepareMethod` per controllare il comportamento. Per altre informazioni, vedere Impostazione delle proprietà di connessione.
Aggiunta la proprietà di connessione serverCertificate per encrypt=strict	Aggiunta una proprietà serverCertificate che rappresenta il percorso del file del certificato server (in formato PEM). Usata per la convalida quando si usa encrypt impostata su strict. Per altre informazioni, vedere Impostazione delle proprietà di connessione.
Memorizzazione della cache delle chiamate ai metadati dei parametri	Le informazioni relative alla crittografia per le query con parametri possono ora essere memorizzate nella cache. Vedere Uso di Always Encrypted con il driver JDBC.
Aggiunto il supporto per l'inserimento in blocco di valori GUID null	Risolve un problema per cui l'inserimento di valori null non era possibile in modalità di inserimento in blocco.
Aggiunto il il supporto per la memorizzazione nella cache dei token di identità gestite	Consente la memorizzazione nella cache dei token ottenuti dagli endpoint dell'identità gestita.

Modifiche apportate alla versione 11.2

Modifica	Dettagli
Supporto TDS 8.0 aggiungendo l'opzione "strict" per crittografare la proprietà di connessione	MODIFICA CHE CAUSA UN'INTERRUZIONE La crittografia della proprietà di connessione è ora di tipo stringa.
Aggiunta del controllo di negoziazione per il protocollo ALPN	Verifica che la negoziazione del protocollo Application-Layer Protocol sia sta eseguita in modo corretto.
Aggiunta di un'opzione per enclaveAttestationProtocol	Aggiunta dell'opzione per il protocollo `NONE` in modo che le enclavi sicuri possano essere usate senza attestazione.
Riordinamento di serverName possibile nella stringa di connessione	Verifica che il campo serverName della stringa di connessione non contenga un segno di uguale.
Aggiunta una migliore registrazione degli errori per la libreria MSAL mancante	È stato aggiunto un messaggio di errore quando MSAL non è presente quando si usa `ActiveDirectoryServicePrincipal`.
Timeout di resilienza della connessione inattiva rifattorizzato per utilizzare un SharedTimer esistente	Miglioramento dell'efficienza con la resilienza della connessione inattiva utilizzando un SharedTimer esistente.
Inviare TDS versione 8 in Login7 in modalità strict	Aggiunta di ulteriori informazioni al pacchetto Login7 includendo TDS versione 8 quando encrypt=strict.
Modifica del valore predefinito loginTimeout su 30 secondi	È stato modificato il valore loginTimeout predefinito da 15 secondi a 30 secondi per consentire più tempo per la risoluzione delle connessioni iniziali prima del timeout.
Dipendenza `msal4j` ora esplicita	Aggiunta di una dipendenza esplicita per `msal4j` (era una dipendenza transitiva nelle versioni precedenti).
Dipendenze aggiornate	È stato eseguito l'aggiornamento delle versioni delle dipendenze per `azure-identity` e `azure-security-keyvault-keys`.

Correzioni nella versione 11.2

Fix	Dettagli
Correzione dell'errore causato da preparedMethod=prepare	Correzione dell'errore intermittente di gestione dell'istruzione preparata null causata da sp_prepare quando viene usato con query batch problema gitHub n. 1880.
Correzione dell'errore per cui stabilire più connessioni in parallelo può generare un'eccezione IndexOutOfBoundsException	Correzione di race condition con addressList, che può causare l'eccezione IndexOutOfBoundsException quando si stabiliscono più connessioni Problema GitHub n. 1852.
Correzione del problema con l'asserzione che non si verifica quando si annulla l'istruzione "insert into"	Risoluzione di un problema a causa del quale il driver poteva effettuare un'asserzione quando si annullava un'istruzione Problema GitHub n. 1849.
Correzione del problema per cui l'eccezione non veniva generata come previsto quando la sessione veniva terminata nel database SQL	Aggiunto il controllo per il token di stato DONE_ERROR che può verificarsi da una sessione terminata nel server Problema GitHub n. 1846.
Intervallo tra tentativi di identità gestita	Correzione dell'intervallo tra tentativi di identità gestita per eseguire correttamente il backup esponenziale Problema GitHub n. 1765.
Rimossa una chiamata aggiuntiva a ExecuteCommand() all'interno di ConnectionCommand()	È stata rimossa una chiamata aggiuntiva a executeCommand, che causava problemi di prestazioni per alcuni utenti problema gitHub n. 1669.
Correzione dell'errore di token sconosciuto con selectMethod	Correzione dell'errore di token sconosciuto `0xA3` quando il cursore `selectMethod` viene usato con la classificazione dei dati.

10,2

Scaricare Microsoft JDBC Driver 10.2.3 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 10.2.3 per SQL Server (tar.gz)

Numero di versione: 10.2.3
Data di rilascio: 12 gennaio 2023

Numero di versione: 10.2.2
Data di rilascio: 13 dicembre 2022

Scaricare Microsoft JDBC Driver 10.2.2 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 10.2.2 per SQL Server (tar.gz)

Numero di versione: 10.2.1
Data di rilascio: 12 maggio 2022

Scaricare Microsoft JDBC Driver 10.2.1 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 10.2.1 per SQL Server (tar.gz)

Conformità 10.2

Modifica di conformità	Dettagli
Scaricare gli aggiornamenti più recenti per JDBC Driver 10.2.	• GitHub, 10.2.0. • Maven Central.
Completamente conforme alla specifica API JDBC 4.2.	I file JAR nel pacchetto 10.2 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file mssql-jdbc-10.20.jre17.jar dal pacchetto 10.2 deve essere usato con Java 17.
Compatibile con Java Development Kit (JDK) versione 17.0, 11.0 e 1.8.	Microsoft JDBC Driver 10.2 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 17.0, oltre a JDK 11.0 e 1.8.

Versioni 10.2

Numero di versione: 10.2.3
Data di rilascio: 12 gennaio 2023

Problemi risolti nella versione 10.2.3:

Correzione dei conteggi errati degli aggiornamenti quando si verifica il timeout nelle query batch
Correzione della data di scadenza del token errata quando si usa Funzioni di Azure
Correzione dello stato SQL null e del codice di errore zero quando viene generata un'eccezione del database

Numero di versione: 10.2.2
Data di rilascio: 13 dicembre 2022

Problemi risolti nella versione 10.2.2:

Cancellare la cache delle istruzioni preparate in caso di riconnessione della resilienza delle connessioni inattive
Correzione per l'impostazione delle opzioni estese KeepAlive
È stato risolto un problema a causa del quale il driver poteva effettuare un'asserzione quando si annullava un'istruzione
Correzione dell'errore relativo all'indice delle istruzioni richiamabili fuori dai limiti
Correzione del problema di mancata verifica della presenza di errori del token DONE, per cui le eccezioni vengono ignorate
Correzione del bug di annullamento delle query

Numero di versione: 10.2.1
Data di rilascio: 12 maggio 2022

Problemi risolti nella versione 10.2.1:

Modifica al timeout di resilienza delle connessioni inattive per l'uso di un elemento SharedTimer esistente
Correzione dell'intervallo tra tentativi di autenticazione dell'identità gestita per eseguire in modo corretto il backup esponenziale
Rimozione di una chiamata estranea a executeCommand() all'interno di connectionCommand()

Numero di versione: 10.2.0
Data di rilascio: 31 gennaio 2022

Scaricare Microsoft JDBC Driver 10.2.0 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 10.2.0 per SQL Server (tar.gz)

Nuove funzionalità della versione 10.2

Funzionalità	Dettagli
Supporto per Java 17	Il driver è ora compatibile con Java Development Kit (JDK) versione 17.0, oltre a JDK 11.0 e 1.8.
Supporto per la resilienza delle connessioni inattive	La resilienza delle connessioni inattive è ora supportata. Vedere Resilienza delle connessioni inattive.
Provider dell'archivio chiavi multiutente	Il driver supporta ora i provider dell'archivio chiavi a livello di connessione e istruzione per supportare scenari multiutente. Vedere Uso di Always Encrypted con il driver JDBC.

Modifiche apportate alla versione 10.2

Modifica	Dettagli
Crittografia predefinita impostata su true	MODIFICA CHE CAUSA UN'INTERRUZIONE La crittografia TLS è abilitata per impostazione predefinita.
Convalida del certificato quando la crittografia è impostata su false	MODIFICA CHE CAUSA UN'INTERRUZIONE Quando la crittografia è impostata su false, ma il server la richiede, il certificato verrà convalidato in base all'impostazione di connessione trustServerCertificate.
Proprietà aadSecurePrincipalId e aadSecurePrincipalSecret deprecate	Le proprietà di connessione aadSecurePrincipalId e aadSecurePrincipalSecret sono deprecate. Usare il nome utente e la password.
API getAADSecretPrincipalId rimossa	MODIFICA CHE CAUSA UN'INTERRUZIONE L'API getAADSecretPrincipalId viene rimossa per motivi di sicurezza.
Supporto per SQL_Variant	Aggiunta del supporto per il tipo di dati SQL_Variant durante il recupero di DateTimeOffset.
Chiamata non bloccante casuale in Linux	Aggiornamento per l'uso di una chiamata casuale non bloccante durante la generazione di un GUID per i pacchetti enclave.
Risoluzione CNAME per l'area di autenticazione	Aggiunta della risoluzione CNAME quando viene specificata l'area di autenticazione.
Dipendenze aggiornate	Versioni delle dipendenze aggiornate per `azure-identity`, `azure-security-keyvault-keys`, `gson` e `bouncycastle`.

Correzioni nella versione 10.2

Fix	Dettagli
TDSParser bloccato in TDS_COLMETADATA	Correzione: TDSParser bloccato in TDS_COLMETADATA, situazione che può causare un blocco per determinate query. Probleme GitHub n. 1661

9.4

Scaricare Microsoft JDBC Driver 9.4.1 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 9.4.1 per SQL Server (tar.gz)

Numero di versione: 9.4.1
Data di rilascio: 7 dicembre 2021

Conformità 9.4

Modifica di conformità	Dettagli
Scaricare gli aggiornamenti più recenti per JDBC Driver 9.4.	• GitHub, 9.4.0. • Maven Central.
Completamente conforme alla specifica API JDBC 4.2.	I file JAR nel pacchetto 9.4 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file mssql-jdbc-9.4.0.jre16.jar dal pacchetto 9.4 deve essere usato con Java 16.
Compatibile con Java Development Kit (JDK) versione 16.0, 11.0 e 1.8.	Microsoft JDBC Driver 9.4 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 16.0, oltre a JDK 11.0 e 1.8.

Versioni 9.4

Numero di versione: 9.4.1
Data di rilascio: 7 dicembre 2021

Problemi risolti nella versione 9.4.1:

Correzione del potenziale blocco quando il driver rileva TDS_COLMETADATA non supportato
Correzione della conversione di LocalDateTime e LocalTime in stringa in copia bulk

Numero di versione: 9.4.0
Data di rilascio: 30 luglio 2021

Scaricare Microsoft JDBC Driver 9.4.0 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 9.4.0 per SQL Server (tar.gz)

Nuove funzionalità della versione 9.4

Funzionalità	Dettagli
Supporto per Java 16	Il driver è ora compatibile con Java Development Kit (JDK) versione 16.0, oltre a JDK 11.0 e 1.8.
Supporto per la connessione di replica	Le connessioni di replica sono ora supportate. Vedere Impostazione delle proprietà di connessione.
Area di autenticazione Kerberos personalizzata	Il driver supporta ora la specifica di un'area di autenticazione personalizzata quando si usa l'autenticazione Kerberos. Vedere Impostazione delle proprietà di connessione.
Tentativi di apertura delle connessioni	Le proprietà di connessione `connectRetryCount` e `connectRetryInterval` vengono aggiunte per configurare i tentativi automatici durante l'apertura delle connessioni. Per informazioni sulle nuove proprietà, vedere Impostazione delle proprietà di connessione.

Modifiche nella versione 9.4

Modifica	Dettagli
Provider di Azure Key Vault	È possibile aprire più connessioni successive che specificano informazioni diverse sul provider di Azure Key Vault.
Aggiornamento dei messaggi di errore	I messaggi di errore correlati alle eccezioni enclave ora includono un collegamento a una guida per la risoluzione dei problemi. I messaggi di errore correlati agli errori di autenticazione di Active Directory ora includono la stringa di errore della libreria sottostante.
Versione del driver inviata al server	La versione del driver viene ora inviata correttamente al database durante `PRELOGIN`.
ID del processo client	L'ID del processo client viene ora inviato al server quando è in esecuzione in Java 9+. Java 8 mantiene la funzionalità precedente di invio `0` per l'ID del processo client.
Dipendenze aggiornate	Versioni delle dipendenze aggiornate per `azure-identity`, `azure-security-keyvault-keys`, `gson`, `antlr` e `bouncycastle`.
Rimozione di riferimenti non necessari	Rimozione dei riferimenti di classe specifici di Java 9 non usati dal file JAR Java 8

Correzioni nella versione 9.4

Fix	Dettagli
Problema GitHub n. 1499	Correzione: il batch ha esito negativo quando la crittografia è sempre abilitata nella stringa di connessione e viene chiamato l'elemento clearParameters.
Problema GitHub n. 1632	Correzione: perdita di memoria ridotta sulla nuova connessione.
Problema GitHub n. 1565	Risoluzione di un problema a causa del quale trustStorePassword è Null quando si usa applicationIntent=ReadOnly
Problema GitHub n. 1568	Risoluzione di un problema per cui il token reindirizzato contiene un'istanza denominata in servername
Problema GitHub n. 1531	Correzione del potenziale overflow di valori integer in TDSWriter.writeString()

9.2

Scaricare Microsoft JDBC Driver 9.2.1 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 9.2.1 per SQL Server (tar.gz)

Numero di versione: 9.2.1
Data di rilascio: 2 marzo 2021

Conformità 9.2

Modifica di conformità	Dettagli
Scaricare gli aggiornamenti più recenti per JDBC Driver 9.2.	• GitHub, 9.2.1. • Maven Central.
Completamente conforme alla specifica API JDBC 4.2.	I file JAR nel pacchetto 9.2 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file mssql-jdbc-9.2.1.jre15.jar dal pacchetto 9.2 deve essere usato con Java 15.
Compatibile con Java Development Kit (JDK) versione 15.0, 11.0 e 1.8.	Microsoft JDBC Driver 9.2 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 15.0, oltre a JDK 11.0 e 1.8.

Versioni 9.2

Numero di versione: 9.2.1
Data di rilascio: 2 marzo 2021

Problemi risolti nella versione 9.2.1:

Risoluzione di un problema relativo al fatto che il segreto client era vuoto durante l'autenticazione ActiveDirectoryServicePrincipal nell'ambiente Azure.

Numero di versione: 9.2.0
Data di rilascio: 29 gennaio 2021

Scaricare Microsoft JDBC Driver 9.2.0 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 9.2.0 per SQL Server (tar.gz)

Supporto per JDK 15

Microsoft JDBC Driver 9.2 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 15.0, oltre a JDK 11.0 e 1.8.

Aggiunta del supporto per l'autenticazione interattiva di Azure Active Directory

Aggiunta del tipo di autenticazione	Dettagli
Microsoft JDBC Driver 9.2 per SQL Server ora supporta l'autenticazione per Azure Key Vault usando l'autenticazione interattiva.	Vedere Connessione con l'autenticazione di Azure Active Directory.

Aggiunta del supporto per l'autenticazione tramite entità servizio di Azure Active Directory

Aggiunta del tipo di autenticazione	Dettagli
Microsoft JDBC Driver 9.2 per SQL Server supporta ora l'autenticazione in Azure Key Vault usando l'ID client e il segreto di un'identità dell'entità servizio.	Vedere Connessione con l'autenticazione di Azure Active Directory.

Aggiornamento della libreria Azure Key Vault per l'uso della libreria Azure Key Vault moderna

Modifiche della libreria per Azure Key Vault	Dettagli
Microsoft JDBC Driver 9.2 è stato migrato dalla libreria di Azure Key Vault di generazione precedente e dalle librerie `ADAL` alle librerie equivalenti di Azure Key Vault e Azure Identity più moderne.	MODIFICA DELLE DIPENDENZE Verificare di aggiornare le dipendenze dell'applicazione se si usa l'autenticazione di Azure Active Directory o di Azure Key Vault. Vedere i requisiti delle dipendenze quando si usa il provider di Azure Key Vault o l'autenticazione di Azure Active Directory

Abilitazione di useBulkCopyForBatchInsert per server non Azure Synapse Analytics

Modifiche di useBulkCopyForBatchInsert per server non Azure Synapse Analytics	Dettagli
Microsoft JDBC Driver 9.2 consente ora l'API di copia bulk per l'operazione di inserimento batch in server non Azure Synapse Analytics.	Vedere Uso dell'API di copia bulk per un'operazione di inserimento batch.

8.4

Scaricare Microsoft JDBC Driver 8.4 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 8.4 per SQL Server (tar.gz)

Numero di versione: 8.4.1
Data di rilascio: 27 agosto 2020

Conformità 8.4

Modifica di conformità	Dettagli
Scaricare gli aggiornamenti più recenti per il driver JDBC 8.4.	• GitHub, 8.4.1. • Maven Central.
Completamente conforme alla specifica API JDBC 4.2.	I file JAR nel pacchetto 8.4 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file mssql-jdbc-8.4.1.jre14.jar dal pacchetto 8.4 deve essere usato con Java 14.
Compatibile con Java Development Kit (JDK) versione 14.0, 11.0 e JDK 1.8.	Microsoft JDBC Driver 8.4 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 14.0, oltre a JDK 11.0 e 1.8.

Versioni 8.4

Numero di versione: 8.4.1
Data di rilascio: 27 agosto 2020
Problemi risolti:

Risoluzione di un problema relativo a SQLServerConnectionPoolProxy non compatibile con delayLoadingLobs
Correzione di un potenziale problema di NullPointerException con delayLoadingLobs
Risoluzione di un problema relativo alla decrittografia delle chiavi di crittografia della colonna quando si usa l'archivio certificati di Windows

Numero di versione: 8.4.0
Data di rilascio: 31 luglio 2020

Supporto per JDK 14

Microsoft JDBC Driver 8.4 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 14.0, oltre a JDK 11.0 e 1.8.

Aggiunto il supporto per l'autenticazione in Azure Key Vault usando l'identità gestita

Aggiunta del tipo di autenticazione	Dettagli
Microsoft JDBC Driver 8.4 per SQL Server ora supporta l'autenticazione per Azure Key Vault usando le identità gestite.	Vedere Uso di Always Encrypted con il driver JDBC.

Supporto "Extended" per la copia bulk per Azure Data Warehouse

Modifiche della copia bulk per Azure Data Warehouse	Dettagli
Microsoft JDBC Driver 8.4 aggiunge una nuova proprietà di connessione, `sendTemporalDataTypesAsStringForBulkCopy`. Questa proprietà booleana è TRUE per impostazione predefinita.	Vedere Uso della copia bulk con il driver JDBC.

Aggiunto il supporto per la memorizzazione nella cache DNS di Azure SQL

Memorizzazione nella cache DNS	Dettagli
Microsoft JDBC Driver 8.4 per SQL Server supporta ora la memorizzazione nella cache DNS per SQL Server su macchine virtuali di Azure.

Aggiunta della compatibilità con le versioni precedenti per lo streaming di oggetti LOB

Streaming LOB	Dettagli
In Microsoft JDBC Driver 8.4 per SQL Server è stata aggiunta una nuova proprietà di connessione, `delayLoadingLobs`.	Se si imposta `delayLoadingLobs` su FALSE, tutti gli oggetti LOB recuperati da ResultSet non verranno trasmessi in streaming. Ciò significa che il driver caricherà l'intero oggetto LOB in memoria in una sola volta, in modo analogo al funzionamento del driver prima della versione 6.4.

Aggiunto il supporto per l'autenticazione del certificato client per scenari di loopback

Autenticazione con certificato client	Dettagli
Microsoft JDBC Driver 8.4 per SQL Server ha aggiunto un nuovo metodo di autenticazione detto autenticazione del certificato client per gli scenari di loopback.	Vedere Autenticazione del certificato client per scenari di loopback.

8.2

Scaricare Microsoft JDBC Driver 8.2 per SQL Server (zip)
Scaricare Microsoft JDBC Driver 8.2 per SQL Server (tar.gz)

Numero di versione: 8.2.2 Data di rilascio: 24 marzo 2020

Conformità 8.2

Modifica di conformità	Dettagli
Scaricare gli aggiornamenti più recenti per il driver JDBC 8.2.	• GitHub, 8.2.2. • Maven Central.
Completamente conforme alla specifica API JDBC 4.2.	I file JAR nel pacchetto 8.2 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file mssql-jdbc-8.2.2.jre11.jar dal pacchetto 8.2 deve essere usato con Java 11.
Compatibile con Java Development Kit (JDK) versione 13.0, 11.0 e JDK 1.8.	Il driver Microsoft JDBC 8.2 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 13.0, oltre a JDK 11.0 e 1.8.

Versioni 8.2

Numero di versione: 8.2.2
Data di rilascio: 24 marzo 2020
Problemi risolti:

Aggiunta un'opzione che consente di configurare l'elenco degli endpoint Azure Key Vault attendibili

Numero di versione: 8.2.1
Data di rilascio: 26 febbraio 2020
Problemi risolti:

Correzione di un potenziale problema di NullPointerException durante il recupero dei dati come tipo java.time.LocalTime o java.time.LocalDate con SQLServerResultSet.getObject()

Numero di versione: 8.2.0
Data di rilascio: 31 gennaio 2020

Supporto per JDK 13

Il driver Microsoft JDBC 8.2 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 13.0, oltre a JDK 11.0 e 1.8.

Always Encrypted con enclave sicuri

Modifica per Always Encrypted	Dettagli
Microsoft JDBC Driver 8.2 per SQL Server ora supporta Always Encrypted con enclave sicure. I dettagli sono disponibili qui: Always Encrypted con enclavi sicure.
Ulteriori dettagli e codice di esempio.	Vedere Always Encrypted con enclave sicuri.

Miglioramento delle prestazioni durante il recupero di tipi di dati temporali da SQL Server ¹

Modifica per i tipi di dati temporali	Dettagli
Microsoft JDBC Driver 8.2 per SQL Server ha migliorato le prestazioni durante il recupero dei tipi di dati temporali da SQL Server.	Questa modifica elimina le conversioni dei tipo di dati temporali superflue eliminando l'uso di java.util.Calendar laddove possibile.
Questo miglioramento delle prestazioni interessa l’elenco dei tipi di dati temporali seguenti, nel formato "tipo di dati SQL Server" (mappatura Java).	date (java.sql.Date), datetime (java.sql.Timestamp), datetime2 (java.sql.Timestamp), smalldatetime (java.sql.Timestamp) e time (java.sql.Time).

¹ A causa delle differenze nel modo in cui vengono gestiti i fusi orari tra l'API java.util.Calendar e java.time.LocalDateTime, i tipi di dati temporali con associato un oggetto java.util.Calendar fornito dall'utente o i tipi di dati microsoft.sql.DateTimeOffset non traggono vantaggio da questo miglioramento.

Distribuzione di mssql-jdbc_auth-<version>-<arch>.dll (in precedenza sqljdbc_auth.dll) nel repository Maven

Modifica di sqljdbc_auth.dll	Dettagli
A partire da Microsoft JDBC Driver 8.2 per SQL Server, il driver si basa su mssql-jdbc_auth-<version>-<arch>.dll anziché su sqljdbc_auth.dll per usare la funzionalità di autenticazione di Azure Active Directory.
La DLL viene inoltre caricata nel repository Maven per semplificare l'accesso.	Vedere questa pagina.

Problemi noti 8.2

Problemi noti	Dettagli
Quando si usa Always Encrypted con enclave sicure con Java 8.	Gli utenti devono includere il provider BouncyCastle come dipendenza o eseguire il mapping o il caricamento di un provider di sicurezza che supporta l'algoritmo di firma RSASSA-PSS.

7.4.1

Scaricare Microsoft JDBC Driver 7.4.1 per SQL Server (self-extracting exe)
Scaricare Microsoft JDBC Driver 7.4.1 per SQL Server (tar.gz)

Numero di versione: 7.4.1
Data di rilascio: 2 agosto 2019

Conformità 7.4

Modifica di conformità	Dettagli
Scaricare gli aggiornamenti più recenti per il driver JDBC 7.4.	• GitHub, 7.4.1. • Maven Central.
Completamente conforme alla specifica API JDBC 4.2.	I file JAR nel pacchetto 7.4 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file mssql-jdbc-7.4.1.jre11.jar dal pacchetto 7.4 deve essere usato con Java 11.
Compatibile con Java Development Kit (JDK) versione 12.0, 11.0 e JDK 1.8.	Il driver Microsoft JDBC 7.4 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 12.0, oltre a JDK 11.0 e 1.8.

Versioni 7.4

Numero di versione: 7.4.1
Data di rilascio: 2 agosto 2019
Problemi risolti:

Ripristinate le nuove implementazioni API hashCode() e equals() da SQLServerDataTable e SQLServerDataColumn perché la modifica dell'API ha interrotto la compatibilità con le versioni precedenti

Numero di versione: 7.4.0
Data di rilascio: 31 luglio 2019

Supporto per JDK 12

Il driver Microsoft JDBC 7.4 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 12.0, oltre a JDK 11.0 e 1.8.

Introduzione dell'autenticazione NTLM

Modifica di NTLM	Dettagli
Supporto della modalità di autenticazione NTLM.	Questa modalità di autenticazione consente ai client Windows e non Windows di autenticarsi in SQL Server usando gli utenti del dominio Windows.
Altri dettagli e un'applicazione di esempio per usare questa modalità di autenticazione.	Vedere Connessione mediante l'autenticazione NTLM.

Introduzione dell'esecuzione di query su ParameterMetaData tramite useFmtOnly

Modifica di useFmtOnly	Dettagli
Aggiunta della proprietà di connessione useFmtOnly.	Questa funzionalità consente agli utenti di eseguire una query facoltativa su ParameterMetaData tramite l'API legacy `SET FMTONLY ON`. Questa impostazione è utile per gli scenari in cui `sp_describe_undeclared_parameters` non offre le prestazioni previste.
Altri dettagli e limitazioni.	Vedere Uso di useFMTOnly

Aggiornamento di Microsoft Azure Key Vault SDK for Java, versione 1.2.1

Modifica di Key Vault SDK	Dettagli
Aggiornamento della dipendenza di Maven da Microsoft Azure Key Vault SDK for Java alla versione 1.2.1.
Rimozione di Microsoft Azure SDK per Key Vault WebKey come dipendenza Maven.
Altre informazioni.	Vedere Dipendenze delle funzionalità di Microsoft JDBC Driver per SQL Server.

Problemi noti 7.4

Problemi noti	Dettagli
Quando si usa l'autenticazione NTLM.	Non è attualmente supportato abilitare la protezione estesa e al tempo stesso le connessioni crittografate.
Quando si usa useFmtOnly.	Malfunzionamenti nella logica di analisi di SQL. possono causare alcuni problemi con la funzionalità Vedere Uso di useFmtOnly per altri dettagli e suggerimenti per soluzioni alternative.

7.2.2

Scaricare Microsoft JDBC Driver 7.2.2 per SQL Server (self-extracting exe)
Scaricare Microsoft JDBC Driver 7.2.2 per SQL Server (tar.gz)

Numero di versione: 7.2.2
Data di rilascio: 16 aprile 2019

Conformità 7.2

Modifica di conformità	Dettagli
Scaricare gli aggiornamenti più recenti per il driver JDBC 7.2.	• GitHub, 7.2.2. • Maven Central.
Completamente conforme alla specifica API JDBC 4.2.	I file JAR nel pacchetto 7.2 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file mssql-jdbc-7.2.2.jre11.jar dal pacchetto 7.2 deve essere usato con Java 11.
Compatibile con Java Development Kit (JDK) versione 11.0 oltre a JDK 1.8.	Il driver Microsoft JDBC 7.2 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 11.0, oltre a JDK 1.8.

Versioni 7.2

Numero di versione: 7.2.2
Data di rilascio: 16 aprile 2019
Problemi risolti:

Risolti problemi relativi alla pulizia non corretta degli ActivityID

Numero di versione: 7.2.1
Data di rilascio: 11 febbraio 2019
Problemi risolti:

Risolti problemi di analisi relativi ad alcune query con parametri

Numero di versione: 7.2.0
Data di rilascio: 31 gennaio 2019

Autenticazione tramite identità gestite di Azure Active Directory

Modifica dell'identità del servizio gestita	Dettagli
Supporta la modalità di autenticazione tramite identità gestite di Active Directory.	Questa modalità di autenticazione è applicabile alle risorse di Azure con il supporto per la funzionalità "Identità" abilitato. Il driver supporta entrambi i tipi di identità gestita per l'acquisizione di accessToken per stabilire una connessione sicura.
Altri dettagli e un'applicazione di esempio per usare questa modalità di autenticazione.	Vedere Connessione con l'autenticazione di Azure Active Directory.

Introduce il supporto di Open Service Gateway Initiative (OSGi)

Modifica per OSGi	Dettagli
Aggiunta l'implementazione di DataSourceFactory.	• `org.osgi.service.jdbc.DataSourceFactory` • `com.microsoft.sqlserver.jdbc.osgi.SQLServerDataSourceFactory`
Aggiunta l'implementazione di Activator.	• `org.osgi.framework.BundleActivator` • `com.microsoft.sqlserver.jdbc.osgi.Activator`

Introduce le API SQLServerError

Modifica per le API di errore	Dettagli
Introduzione dell'API SQLServerError.	API getter per recuperare dettagli aggiuntivi sull'errore generato dal server. • `SQLServerException.getSQLServerError()` • `SQLServerError`
Altre informazioni.	Vedere Gestione degli errori.

Aggiornamento di Microsoft Azure Active Directory Authentication Library (ADAL4J) per Java, versione 1.6.3

Modifica per ADAL4J	Dettagli
Aggiornamento della dipendenza di Maven da ADAL4J alla versione 1.6.3.
Introduce Java Client Runtime for AutoRest come dipendenza Maven, versione 1.6.5.
Altre informazioni.	Vedere Dipendenze delle funzionalità di Microsoft JDBC Driver per SQL Server.

Aggiornamento di Microsoft Azure Key Vault SDK for Java, versione 1.2.0

Modifica di Key Vault SDK	Dettagli
Aggiornamento della dipendenza di Maven da Microsoft Azure Key Vault SDK for Java alla versione 1.2.0.
Introduce Microsoft Azure SDK per Key Vault WebKey come dipendenza Maven, versione 1.2.0.
Altre informazioni.	Vedere Dipendenze delle funzionalità di Microsoft JDBC Driver per SQL Server.

Problemi noti 7.2

Problemi noti	Dettagli
Query con parametri, in alcuni casi.	È stato rilasciato un aggiornamento della versione 7.2.0 (7.2.1) a febbraio 2019 per risolvere questo problema.
Pulizia di ActivityId.	È stato rilasciato un aggiornamento della versione 7.2.1 (7.2.2) ad aprile 2019 per risolvere questo problema.

7.0

Scaricare Microsoft JDBC Driver 7.0 per SQL Server (self-extracting exe)
Scaricare Microsoft JDBC Driver 7.0 per SQL Server (tar.gz)

Numero di versione: 7.0.0
Data di rilascio: 31 luglio 2018

Il driver Microsoft JDBC 7.0 per SQL Server è completamente conforme alla specifica API JDBC 4.2. I file JAR nel pacchetto 7.0 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file mssql-jdbc-7.0.0.jre10.jar dal pacchetto 7.0 deve essere usato con Java 10.

Supporto per JDK 10

Il driver Microsoft JDBC 7.0 per SQL Server è ora compatibile con Java Development Kit (JDK) versione 10.0, oltre a JDK 1.8. Questo aggiornamento espone anche Automatic-Module-Name del driver come com.microsoft.sqlserver.jdbc attraverso file manifesto corrispondente.

Supporto per tipi di dati spaziali

Il driver Microsoft JDBC 7.0 per SQL Server offre ora il supporto dei tipi di dati spaziali Geometry e Geography di SQL Server. Per altre informazioni sulle API dei tipi di dati spaziali e su come usarle, vedere Uso dei tipi di dati spaziali.

Implementazione per JDBC 4.3 che ha introdotto le API java.sql.Connection beginRequest() ed endRequest()

Il driver Microsoft JDBC 7.0 per SQL Server implementa ora le API beginRequest() e endRequest() dalla classe java.sql.Connection. Queste API sono state introdotte con la specifica JDBC 4.3 e JDK 9. Per altre informazioni sull'implementazione del driver di queste API, vedere Conformità a JDBC 4.3 per il driver JDBC.

Supporto per individuazione e classificazione dei dati SQL

Il driver Microsoft JDBC 7.0 per SQL Server fornisce supporto per l'individuazione di dati SQL e la classificazione con qualsiasi database di destinazione che supporta questa funzionalità. Il driver ora espone le API SQLServerResultSet.getSensitivityClassification() per estrarre queste informazioni dal ResultSet recuperato.

Per altre informazioni su come usare questa funzionalità con il driver JDBC, vedere l'esempio in Individuazione dati e classificazione SQL.

Aggiunta della proprietà di connessione: useBulkCopyForBatchInsert

Il driver Microsoft JDBC 7.0 per SQL Server introduce una nuova proprietà di connessione, useBulkCopyForBatchInsert. Questa proprietà è supportata solo per Azure Synapse Analytics.

Questa proprietà è disabilitata per impostazione predefinita. È possibile abilitarla per migliorare le prestazioni delle applicazioni utente quando si esegue il push di grandi quantità di dati in Azure Synapse Analytics. L'abilitazione di questa proprietà modifica il comportamento delle operazioni di inserimento batch per passare a operazioni di copia bulk con dati forniti dall'utente. Per altre informazioni su questa proprietà e le relative limitazioni, vedere Uso dell'API di copia bulk per un'operazione di inserimento batch.

Aggiunta della proprietà di connessione: cancelQueryTimeout

Il driver Microsoft JDBC 7.0 per SQL Server introduce una nuova proprietà di connessione, cancelQueryTimeout per annullare queryTimeout su oggetti java.sql.Connection e java.sql.Statement.

Aggiunta di costruttori per il provider Azure Key Vault

Il driver Microsoft JDBC 7.0 per SQL Server reintroduce un costruttore rimosso in precedenza, per SQLServerColumnEncryptionAzureKeyVaultProvider. È consentita l'autenticazione tramite un metodo personalizzato implementato su SQLServerKeyVaultAuthenticationCallback per recuperare un token di accesso.

I nuovi costruttori hanno la definizione seguente:

/* This constructor is added to provide backward compatibility with 6.0
* version of the driver. It is marked deprecated for removal in the next
* stable release.
*/
@Deprecated
public SQLServerColumnEncryptionAzureKeyVaultProvider(
        SQLServerKeyVaultAuthenticationCallback authenticationCallback,
        ExecutorService executorService) throws SQLServerException;

/*New constructor to replace the above constructor*/
public SQLServerColumnEncryptionAzureKeyVaultProvider(
            SQLServerKeyVaultAuthenticationCallback authenticationCallback) throws SQLServerException;

Aggiornamento di "Microsoft Azure Active Directory Authentication Library (ADAL4J) per Java" alla versione 1.6.0

Il driver Microsoft JDBC 7.0 per SQL Server ha aggiornato la dipendenza di Maven da "Microsoft Azure Active Directory Authentication Library (ADAL4J) fo Java" alla versione 1.6.0. Per altre informazioni sulle dipendenze, vedere Dipendenze delle funzionalità di Microsoft JDBC Driver per SQL Server.

6.4

Scaricare Microsoft JDBC Driver 6.4 per SQL Server (self-extracting exe)
Scaricare Microsoft JDBC Driver 6.4 per SQL Server (tar.gz)

Numero di versione: 6.4.0
Data di rilascio: 27 febbraio 2018

Il driver Microsoft JDBC 6.4 per SQL Server è completamente conforme alla specifica JDBC 4.1 e 4.2. I file JAR nel pacchetto 6.4 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, il file mssql-jdbc-6.4.0.jre8.jar dal pacchetto 6.4 deve essere usato con Java 8.

Supporto per JDK 9

Il driver supporta JDK versione 9.0, oltre a JDK 8.0 e 7.0.

Conformità a JDBC 4.3

Il driver supporta la specifica Java Database Connectivity API 4.3, oltre a 4.1 e 4.2. I metodi dell'API di JDBC 4.3 sono stati aggiunti ma non ancora implementati. Per informazioni dettagliate, vedere Conformità a JDBC 4.3 per il driver JDBC.

Aggiunta della proprietà di connessione: sslProtocol

Una nuova proprietà di connessione consente agli utenti di specificare la parola chiave per il protocollo TLS. I valori possibili sono: "TLS", "TLSv1", "TLSv1.1" e "TLSv1.2". Per i dettagli, vedere SSLProtocol.

Proprietà di connessione deprecata: fipsProvider

La proprietà di connessione fipsProvider è stata rimossa dall'elenco delle proprietà di connessione accettate. Per informazioni dettagliate, vedere la richiesta pull di GitHub correlata.

Aggiunta di proprietà di connessione per specificare un TrustManager personalizzato

Il driver supporta ora la specifica di un TrustManager personalizzato con le proprietà di connessione aggiunte trustManagerClass e trustManagerConstructorArg. È possibile specificare in modo dinamico un set di certificati considerati attendibili per ogni connessione, senza modificare le impostazioni globali per l'ambiente Java Virtual Machine (JVM).

Aggiunta del supporto per datetime/smallDatetime nei parametri con valori di tabella

Il driver supporta ora i tipi di dati datetime e smallDatetime quando si usano parametri con valori di tabella (TVP).

Aggiunta del supporto per il tipo di dati sql_variant

Il driver JDBC supporta ora i tipi di dati sql_variant da usare con SQL Server. Il tipo di dati sql_variant è supportato anche con funzionalità quali parametri con valori di tabella e copia bulk con le limitazioni seguenti:

Per i valori di data:

Quando si usano parametri con valori di tabella per popolare una tabella che contiene valori datetime, smalldatetime o date archiviati in una colonna sql_variant, la chiamata del metodo getDateTime(), getSmallDateTime() o getDate() sul set di risultati non funziona e genera l'eccezione seguente:

java java.lang.String cannot be cast to java.sql.Timestamp

In alternativa, usare il metodo getString() o getObject().
Uso di TVP con sql_variant per valori null:

Se si usano parametri con valori di tabella per popolare una tabella e inviare un valore NULL al tipo di colonna sql_variant, verrà generata un'eccezione. L'inserimento di un valore NULL con il tipo di colonna sql_variant in un parametro con valori di tabella non è attualmente supportato.

Implementazione della memorizzazione nella cache dei metadati delle istruzioni preparate

Il driver JDBC ha implementato la memorizzazione nella cache dei metadati per le istruzioni preparate per migliorare le prestazioni. Il driver supporta ora la memorizzazione nella cache dei metadati per le istruzioni preparate nel driver con le proprietà di connessione disableStatementPooling e statementPoolingCacheSize. Questo funzionalità è disabilitata per impostazione predefinita. Per altre informazioni, vedere Memorizzazione nella cache dei metadati delle istruzioni preparate per il driver JDBC.

Aggiunta del supporto per l'autenticazione integrata di Azure AD in Linux/macOS

Il driver JDBC ora supporta l'autenticazione integrata di Azure Active Directory in tutti i sistemi operativi supportati (Windows, Linux e macOS) con Kerberos. In alternativa, nei sistemi operativi Windows, gli utenti possono autenticarsi con mssql-jdbc_auth-<version>-<arch>.dll.

Aggiornamento di "Microsoft Azure Active Directory Authentication Library (ADAL4J) per Java" alla versione 1.4.0

Il driver JDBC ha aggiornato la dipendenza di Maven da "Microsoft Azure Active Directory Authentication Library (ADAL4J) for Java" alla versione 1.4.0. Per altre informazioni sulle dipendenze, vedere Dipendenze delle funzionalità di Microsoft JDBC Driver per SQL Server.

6.2

Scaricare Microsoft JDBC Driver 6.2 per SQL Server (self-extracting exe)
Scaricare Microsoft JDBC Driver 6.2 per SQL Server (tar.gz)

Numero di versione: 6.2.2
Data di rilascio: 29 settembre 2017

Il driver Microsoft JDBC 6.2 per SQL Server è completamente conforme alla specifica JDBC 4.1 e 4.2. I file JAR nel pacchetto 6.2 sono denominati in base alla compatibilità delle versioni di Java. Ad esempio, è consigliato l'uso del file mssql-jdbc-6.2.2.jre8.jar dal pacchetto 6.2 con Java 8.

Versioni 6.2

Numero di versione: 6.2.2
Data di rilascio: 3 ottobre 2017
Problemi risolti:

Aggiornata la dipendenza ADAL4J alla versione 1.2.0 e la dipendenza Azure Key Vault alla versione 1.0.0

Numero di versione: 6.2.1
Data di rilascio: 14 luglio 2017
Problemi risolti:

Correzione di un problema durante l'esecuzione di query senza parametri usando preparedStatement

Numero di versione: 6.2.0
Data di rilascio: 30 giugno 2017

Nota

È stato rilevato un problema con il miglioramento della memorizzazione nella cache dei metadati nella versione JDBC 6.2 RTW rilasciata il 29 giugno 2017. È stato eseguito il rollback del miglioramento e sono stati rilasciati nuovi file JAR (versione 6.2.1) in data 17 luglio 2017.

Un altro miglioramento ha aggiornato la versione della libreria dipendente da Azure Key Vault alla versione 1.0.0 e sono stati rilasciati nuovi file JAR (versione 6.2.2) in data 19 ottobre 2017.

Scaricare gli aggiornamenti più recenti per il driver JDBC 6.2 tramite i collegamenti precedenti, GitHub o Maven Central. Aggiornare i progetti per l'uso dei file JAR della versione 6.2.2. Per altre informazioni, vedere le note sulla versione per le versioni 6.2.1 e 6.2.2.

Supporto di Azure AD per Linux

Connettere le applicazioni Linux al database SQL di Azure con l'autenticazione di Azure AD tramite i metodi con nome utente/password e token di accesso.

JVM abilitate per FIPS

È ora possibile usare il driver JDBC su JVM eseguite in modalità conformità 140 FIPS (Federal informazioni Processing Standard) per soddisfare gli standard federali sulla conformità.

Miglioramenti per l'autenticazione Kerberos

Il driver JDBC include ora il supporto per:

Metodo basato su entità di sicurezza/password per le applicazioni in cui la configurazione di Kerberos non può essere modificata o non è possibile recuperare un nuovo token o keytab. Questo metodo può essere usato per l'autenticazione in un'istanza di SQL Server che consente solo l'autenticazione Kerberos.
Autenticazione tra aree di autenticazione che usa l'autenticazione integrata Kerberos senza impostare in modo esplicito il nome dell'entità servizio (SPN) del server. Il driver calcola ora automaticamente l'area di autenticazione anche quando non viene fornita.
Delega vincolata Kerberos con l'accettazione di credenziali utente rappresentate come oggetto credenziali GSS tramite l'origine dati. Queste credenziali rappresentate vengono poi usate per stabilire una connessione Kerberos.

Aggiunta dei timeout

Il driver JDBC supporta ora i timeout configurabili seguenti. È possibile modificarli in base alle esigenze dell'applicazione.

Query timeout per controllare il numero di secondi di attesa prima che si verifichi un timeout durante l'esecuzione di una query.
Socket timeout per specificare il numero di millisecondi di attesa prima che si verifichi un timeout per un'operazione di lettura o accettazione del socket.

6.1

Numero di versione 6.1.0:
Data di rilascio: 17 novembre 2016

Il driver Microsoft JDBC 6.1 per SQL Server è completamente conforme alla specifica JDBC 4.1 e 4.2. Questa è la versione open source iniziale del driver JDBC. Il codice sorgente è disponibile nel tag GitHub v6.1.0. Compila i file mssql-jdbc-6.1.0.jre8.jar e mssql-jdbc-6.1.0.jre7.jar, che corrispondono alla compatibilità delle versioni di Java.

6.0

Scaricare Microsoft JDBC Driver 6.0 per SQL Server (self-extracting exe)
Scaricare Microsoft JDBC Driver 6.0 per SQL Server (tar.gz)

Numero di versione: 6.0.8112
Data di rilascio: 17 gennaio 2017

Il driver Microsoft JDBC 6.0 per SQL Server è completamente conforme alla specifica JDBC 4.1 e 4.2. I file JAR nel pacchetto 6.0 sono denominati in base alla relativa conformità con la versione dell'API JDBC. Ad esempio, il file sqljdbc42.jar dal pacchetto 6.0 è conforme all'API JDBC 4.2. Analogamente, il file sqljdbc41.jar è conforme all'API JDBC 4.1.

Per assicurarsi di avere il file corretto sqljdbc41.jar o sqljdbc42.jar, eseguire le righe di codice seguenti. Se l'output è "Versione driver: 6.0.7507.100", è disponibile il pacchetto del driver JDBC 6.0.

Connection conn = DriverManager.getConnection("jdbc:sqlserver://<server>;encrypt=true;user=<user>;password=<password>;");
System.out.println("Driver version: " + conn.getMetaData().getDriverVersion());

Always Encrypted

Il driver supporta la funzionalità Always Encrypted in SQL Server 2016. Questa funzionalità garantisce che i dati sensibili non vengano mai visualizzati in testo non crittografato in un'istanza di SQL Server. Always Encrypted crittografa in modo trasparente i dati nell'applicazione, in modo che SQL Server debba gestire solo i dati crittografati e non i valori di testo non crittografato. In caso di compromissione dell'istanza di SQL Server o del computer host, un utente malintenzionato ottiene solo il testo crittografato dei dati sensibili. Per informazioni dettagliate, vedere Uso di Always Encrypted con il JDBC Driver.

Nomi IDN (Internationalized Domain Name)

Il driver supporta i nomi IDN (Internationalized Domain Name) per i nomi dei server. Per informazioni dettagliate, vedere "Utilizzo di International Domain Names (IDN)" nell'articolo Caratteristiche internazionali del driver JDBC.

Query con parametri

Il driver supporta ora il recupero dei metadati dei parametri con istruzioni preparate per le query complesse, ad esempio le sottoquery e/o i join. Si noti che questo miglioramento è disponibile solo quando si usa SQL Server 2012 e versioni successive.

Azure Active Directory

L'autenticazione di Azure AD è un meccanismo di connessione al database SQL di Azure tramite identità in Azure AD. Usare l'autenticazione di Azure AD per gestire centralmente le identità degli utenti del database e come alternativa all'autenticazione di SQL Server.

È possibile usare il driver JDBC 6.0 per specificare le credenziali di Azure AD nella stringa di connessione JDBC per connettersi al database SQL di Azure. Per informazioni dettagliate, vedere la proprietà di autenticazione nell'articolo Impostazione delle proprietà delle connessioni.

Parametri con valori di tabella

I parametri con valori di tabella offrono un modo semplice per effettuare il marshalling di più righe di dati da un'applicazione client di SQL Server senza richiedere più round trip o una logica speciale sul lato server per l'elaborazione dei dati. I parametri con valori di tabella possono essere usati per incapsulare le righe di dati in un'applicazione client e inviare i dati al server in un singolo comando con parametri. Le righe di dati in ingresso vengono archiviate in una variabile di tabella su cui è possibile operare tramite Transact-SQL. Per informazioni dettagliate, vedere Uso di parametri con valori di tabella.

Gruppi di disponibilità Always On

Il driver supporta ora le connessioni trasparenti ai gruppi di disponibilità Always On. Il driver individua rapidamente la topologia AlwaysOn corrente dell'infrastruttura server e si connette in modo trasparente al server attivo corrente.

4.2

Scaricare Microsoft JDBC Driver 4.2 per SQL Server (self-extracting exe)
Scaricare Microsoft JDBC Driver 4.2 per SQL Server (tar.gz)

Numero di versione: 4.2.8112
Data di rilascio: 24 agosto 2015

Il driver Microsoft JDBC 4.2 per SQL Server è completamente conforme alla specifica JDBC 4.1 e 4.2. I file JAR nel pacchetto 4.2 sono denominati in base alla relativa conformità con la versione dell'API JDBC. Ad esempio, il file sqljdbc42.jar dal pacchetto 4.2 è conforme all'API JDBC 4.2. Analogamente, il file sqljdbc41.jar è conforme all'API JDBC 4.1.

Per assicurarsi di avere il file corretto sqljdbc41.jar o sqljdbc42.jar, eseguire le righe di codice seguenti. Se l'output è "Versione driver: 4.2.6420.100", è disponibile il pacchetto del driver JDBC 4.2.

Connection conn = DriverManager.getConnection("jdbc:sqlserver://<server>;encrypt=true;user=<user>;password=<password>;");
System.out.println("Driver version: " + conn.getMetaData().getDriverVersion());

Supporto per JDK 8

Il driver supporta JDK versione 8.0, oltre a JDK 7.0, 6.0 e 5.0.

Conformità con JDBC 4.1 e 4.2

Il driver supporta le specifiche Java Database Connectivity API 4.1 e 4.2, oltre a 4.0. Per informazioni dettagliate, vedere Conformità con JDBC 4.1 per il driver JDBC e Conformità con JDBC 4.2 per il driver JDBC.

Copia bulk

La funzionalità di copia bulk viene usata per copiare rapidamente grandi quantità di dati in tabelle o viste nei database di SQL Server. Per informazioni dettagliate, vedere Uso della copia bulk con il driver JDBC.

Opzione di rollback di transazione XA

Il driver include nuove opzioni di timeout per il rollback automatico esistente di transazioni non preparate. Per informazioni dettagliate, vedere Informazioni sulle transazioni XA.

Nuova proprietà di connessione principale Kerberos

Il driver usa una nuova proprietà di connessione per aumentare la flessibilità con le connessioni Kerberos. Per informazioni dettagliate, vedere Uso dell'autenticazione integrata Kerberos per la connessione a SQL Server.

4.1

Numero di versione: 4.1.8112
Data di rilascio: 12 dicembre 2014

Supporto per JDK 7

Il driver supporta JDK versione 7.0, oltre a JDK 6.0 e 5.0.

Itanium non supportato per le applicazioni JDBC Driver

Microsoft JDBC Driver per SQL Server non è supportato sui computer Itanium.

Vedi anche

Panoramica del driver JDBC

Condividi tramite