Note sulla versione per Microsoft JDBC Driver per SQL Server

Articolo
01/02/2025

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

12.8

Scarica 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
Data di rilascio: 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
Data di rilascio: 22 agosto 2024

Modifiche nella versione 12.8.1:

Modifica della registrazione MSAL da FINER a FINEST

Correzione dei problemi nella versione 12.8.1:

Modificato DESTINATION_COL_METADATA_LOCK, in SQLServerBulkCopy, affinché 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à.

Scarica Microsoft JDBC Driver 12.8.1 per SQL Server (zip)
Download 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, il driver consente ora la memorizzazione nella cache delle credenziali indicate in precedenza.
Permetti l'archiviazione nella cache dell'oggetto `SQLServerBulkCopy` quando si utilizza la copia bulk per l'inserimento 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 dei metadati delle colonne di destinazione a livello di connessione nella copia in blocco.	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 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	Supporto per i campi tra virgolette contenenti interruzioni di riga mancava per garantire il pieno supporto a RFC4180; questo 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	La visibilità dell'enumerazione `SQLServerSortOrder` è stata modificata in pubblica, il che consente agli utenti una maggiore flessibilità nelle query che utilizzano questa enumerazione.
Rimuovere `synchronized` dalle sostituzioni di socket	Aggiunti in modo non corretto nelle modifiche precedenti per conformarsi agli standard di controllo del codice, i metodi selezionati modificati non devono infatti essere sincronizzati e vengono modificati per 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	Aggiunto un maggior numero di registrazioni per gli scenari di caching dei token per agevolare il debug.

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 del parsing per le parentesi nelle procedure memorizzate e nelle funzioni	Correzione di un problema in cui la chiamata a una funzione con parentesi alla fine di un'istruzione di chiamata, ad esempio function() rispetto a function, comportava che il valore restituito fosse sempre pari a 0. Questa modifica è stata una regressione dalla versione 12.6.2-> 12.6.3. Problema GitHub n. 2463.
Risolto un errore per cui il driver non rispettava `CallableStatement` con 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` dove il driver non la richiede.	`TokenCredentialClass` non è necessario in `SQLServerSecurityUtility` e può causare un'eccezione `NoClassDefFoundError` emessa in modo non corretto. Questa correzione rimuove l'importazione, sostituendola con un `Object`generico . Problema GitHub n. 2439.
Correzione dell'errore di conversione della stringa di timestamp per CallableStatements	Abbiamo corretto un'eccezione di conversione che si verificava quando si chiamava un parametro in/out di `DateTime` mentre si impostava un valore di `String`. Problema GitHub n. 2436.
Correzione del costruttore SqlAuthenticationToken per accettare il parametro corretto	Il costruttore di SQLAuthenticationToken era errato perché utilizzava un parametro di input in secondi invece che 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 l'instaurazione della connessione, ma non deve avere alcun limite superiore dopo che il driver è stato connesso. Questa modifica corregge tale comportamento. 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 (ovvero con un server collegato) ha generato un errore che indica che il flusso del protocollo TDS non è valido. Problema GitHub n. 2344.
Correzione del corretto escape dei parametri di `schema` per `getProcedures` e `getProcedureColumns`	I metodi `SQLServerDatabaseMetadata`, `getProcedures` e `getProcedureColumns` non hanno eseguito 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 la copia in blocco	In questo modo viene risolto un problema per cui, quando si usa la copia bulk con valori `Money` o `SmallMoney`, la conversione da e verso i 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. Questa modifica risolve il problema. 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 `ActivityCorrelatorThreadLocal`	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 venivano incapsulate nelle chiamate `sp_executesql` utilizzando la logica precedente; questa modifica corregge tale comportamento.

Versioni precedenti

12.6

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

Numero di versione: 12.6.4
Data di rilascio: 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
Data di rilascio: 29 agosto 2024

Correzione dei problemi 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)
Scarica 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 il denaro e le piccole somme siano compresi nell'intervallo corretto per la copia in massa
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 ora chiama direttamente le stored procedure, anziché avvolgere la procedura attorno 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 una configurazione esterna aggiuntiva.
Aggiunta la proprietà della stringa di connessione `useDefaultJaasConfig`	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 `useDefaultJaasConfig`	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 usano la categoria di registrazione di reindirizzamento e possono essere utilizzati al livello di registrazione FINE. La resilienza delle connessioni inattive utilizza la categoria di registrazione "Resiliency" e può essere utilizzata 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.
Aggiunti più errori che dovrebbero diventare RMFAIL	Aggiunta di altri casi, "reimpostazione della connessione per peer" e "timeout della connessione", che dovrebbe corrispondere a RMFAIL
Modifica della modalità di utilizzo dei timestamp nella copia bulk	Modificare il comportamento della copia bulk dalla serializzazione e deserializzazione degli oggetti Timestamp all'uso diretto degli oggetti, migliorando così le prestazioni quando un utente utilizza molti Timestamp.
Si è modificato `socketTimeout` per assicurarsi che sia correttamente minore di `loginTimeout`	In precedenza `socketTimeout` agiva in modo indipendente da `loginTimeout`, che causava un comportamento potenzialmente confuso in cui il driver impiegava più tempo del previsto per scadere. Questo problema è stato risolto in modo che `socketTimeout` abbia sempre un limite superiore uguale a `loginTimeout`.
Modificata la cache PreparedStatement in modo che venga cancellata 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`, `gson`, `antlr` e `bouncycastle`.

Correzioni nella versione 12.6

Fix	Dettagli
È stato corretto un controllo Null mancante per e.getCause()	Correzione di un problema a causa del quale, quando un'eccezione non ha alcuna causa, viene passata l'eccezione stessa, impedendone la perdita. 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.
Correzione di un problema relativo ai timestamp e alla copia in blocco per l'inserimento batch	Il fuso orario fisso non veniva applicato correttamente ai timestamp quando venivano inseriti tramite batch insert con copia in blocco. Problema GitHub n. 2271.
Correzione dei getter mancanti e dei setter per `useBulkCopyForBatchInsert`	Correzione di un problema per cui il comportamento non era lo stesso tra `SQLServerConnection` e `SQLServerConnectionPoolProxy`, quando invece avrebbe dovuto esserlo, poiché in quest'ultimo mancavano un getter e un setter per `useBulkCopyForBatchInsert`. Problema GitHub n. 2245.
Correzione della query dei metadati di copia bulk per l'uso dei dati memorizzati nella cache, se disponibile	Correzione di un problema per cui, nonostante i dati fossero memorizzati nella cache, venivano effettuate comunque chiamate ai metadati di colonna ogni volta. Problema GitHub n. 2224.
Correzione di un controllo mancante della scala BigDecimal per i valori TVP	Correzione di un problema per cui, quando si scrivono valori di riga TVP, i valori di input non venivano filtrati correttamente in base alla scala di BigDecimal. Problema GitHub n. 2222.
Correzione dello schemaPattern in SQLServerDatabaseMetadata per garantire che i metodi che usano correttamente il parametro eseggano l'escape.	Correzione di un problema a causa del quale schemaPattern era l'unico modello non sottoposto a escape in SQLServerDatabaseMetadata. Problema GitHub n. 2186.
Correzione di un problema a causa del quale è stato restituito un valore SQLState null durante il tentativo di convertire una data in un valore long	Correzione di un problema per cui, quando `xopenStates` è impostato su true, il driver non restituisce il codice di stato SQL-99 previsto in un'istanza specifica. Problema GitHub n. 2167.
Correzione dell'errore getMetaData per le query contenenti TOP	Correzione di un problema per cui, quando si usa il qualificatore TOP in una query, il driver restituisce un errore relativo a ParameterMetadata. Problema GitHub n. 1776.
Correzione di un problema di analisi dei nomi di tabella quando si usano inserimenti batch	Correzione di un problema per cui le istruzioni di insert con spazi bianchi mancanti funzionavano come previsto nelle situazioni normali, ma non quando si usano inserimenti batch. Problema GitHub n. 1534.
Correzione di un problema relativo a ParameterMetadata e agli indici non validi	Correzione di un problema relativo al controllo non corretto di ParameterMetadata e alla generazione di eccezioni per un indice non valido 0. 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 effettuata per ignorare le colonne calcolate quando si utilizza la copia massiva per l'inserimento batch	Correzione del comportamento della copia in blocco per ignorare le colonne calcolate e consentire inserimenti batch, quando in precedenza l'inserimento falliva e restituiva un errore che indicava tali colonne calcolate.
Correzione del comportamento del driver relativo alle firme durante l'utilizzo dell'archivio di chiavi Java e di Azure Key Vault	Correzione di un problema per cui il driver non verificava correttamente la firma, quando si usa il Java Key Store, e aggiungendo una nuova API per firmare i metadati della chiave master della colonna (e restituire la firma generata) per l'uso con il Java Key Store e Azure Key Vault.
Correzione della conversione errata di DateTimeOffset di getObject()	Correzione di un problema durante la chiamata a ResultSet.getObject() in una colonna DATETIMEOFFSET, con LocalDate/LocalTime/LocalDateTime come argomento della classe, il valore nella colonna verrà 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:

Ripristino del controllo IBM al controllo del fornitore e aggiunta di un controllo aggiuntivo del nome della macchina virtuale per rimuovere 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é Azure Synapse non supporta la sintassi usata in `supportTransaction`.
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`, `antlr` e `bouncycastle`.

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`	Correzione di un problema per cui, se `metaQuery` non restituisce alcun risultato dopo l'esecuzione di una stored procedure, questo problema avrebbe restituito 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	Correzione di un problema per cui l'utilizzo di `useBulkCopyForBatchInsert=true` può causare una confusione tra colonne e dati non validi. Problema GitHub n. 1992.
Correzione della gestione degli errori XA per rilanciare XAER_RMFAIL invece di XAER_RMERR	Correzione di un problema per cui il driver restituirà XAException con codice di errore XAER_RMERR se si verificasse un failover di SQL Server dal nodo primario al nodo 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	È stata aggiunta una proprietà di connessione `datetimeParameterType`, che consente agli utenti di specificare esplicitamente le conversioni in `datetime` o `datetime2`, offrendo una maggiore compatibilità con i database più vecchi.

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	Correzione di un problema a causa del quale, dopo l'errore SQL, lo stato SQL e il codice di errore hanno mostrato 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 mancante alla correzione precedente di DONE_ERROR, in cui il driver ha ignorato lo stato DONE_ERROR dal 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 a causa del quale i batch non sono stati cancellati correttamente in caso di errore quando si usa l'aggiornamento bulk. 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 `ipaddresspreference` 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 si utilizza `ActiveDirectoryServicePrincipal`e manca MSAL.
Timeout di resilienza della connessione inattiva rifattorizzato per utilizzare un SharedTimer esistente	Migliorata efficienza con resilienza per connessioni inattive usando il 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	Versioni aggiornate 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 dell'asserzione non riuscita che si verifica quando si annulla l'istruzione "insert into"	Correzione di un problema per cui il driver può generare un'asserzione quando si annulla un'istruzione GitHub Issue #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 #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 IMPORTANTE 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 di riconnessione 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	Correzione di un problema a causa del quale trustStorePassword è null quando si usa applicationIntent=ReadOnly
Problema GitHub n. 1568	Correzione di un problema in cui il token reindirizzato contiene un'istanza denominata nel nome del server
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:

Correzione di un problema relativo al segreto del client vuoto durante l'autenticazione di 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:

Correzione di un problema di incompatibilità tra SQLServerConnectionPoolProxy e delayLoadingLobs.
Correzione di un potenziale problema di NullPointerException con delayLoadingLobs
Correzione di un problema nella decrittografia delle chiavi di crittografia delle colonne quando si utilizza l'archivio dei 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 incide sul seguente elenco di tipi di dati temporali: nel formato "SQL Server datatype" (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 caricata nel repository Maven per facilitare 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.	Le carenze nella logica di analisi 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` • `org.osgi.service.jdbc.DataSourceFactory`
Aggiunta l'implementazione di Activator.	• `org.osgi.service.jdbc.DataSourceFactory` • `org.osgi.service.jdbc.DataSourceFactory`

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. • `org.osgi.service.jdbc.DataSourceFactory` • `org.osgi.service.jdbc.DataSourceFactory`
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 informazioni dettagliate, 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 quando si esegue una query.
Socket timeout per specificare il numero di millisecondi da attendere prima che si verifichi un timeout durante la lettura o l'accettazione di un 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 versione è 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 è "Driver version: 6.0.7507.100", si dispone del pacchetto JDBC Driver 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", si dispone del pacchetto JDBC Driver 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

Scarica Microsoft JDBC Driver 4.1 per SQL Server (exe autoestraente)
Scaricare Microsoft JDBC Driver 4.1 per SQL Server (tar.gz)

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.

4.0

Scarica Microsoft JDBC Driver 4.0 per SQL Server (exe autoestraente)
Scaricare Microsoft JDBC Driver 4.0 per SQL Server (tar.gz)

Numero di versione: 4.0.2206
Data di rilascio: 6 marzo 2012

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