Note di rilascio per JDBC 3.x di Amazon Athena

Multi-catalog navigazione: aggiunto il supporto per la navigazione in più cataloghi per le funzionalità di Lakehouse. Il driver può ora scoprire e connettersi a tutti i cataloghi in ambienti di catalogo federati, abilitando l'uso di S3 Tables e la federazione dei cataloghi tramite Amazon Athena.

Plugin di autenticazione Browser SSO OIDC: aggiunto un nuovo plug-in di autenticazione per Identity Center. AWS Identity and Access Management Questo plug-in consente l'autenticazione single sign-on basata su browser senza interruzioni utilizzando il codice di autorizzazione con flusso PKCE. Per ulteriori informazioni, consulta Credenziali SSO OIDC del browser.

SageMaker autenticazione: è stato aggiunto il supporto per la connessione tramite DataZoneProjectId i plugin di autenticazione e. SageMakerBrowserIdc SageMakerIam Ora puoi connetterti ai tuoi SageMaker progetti e lavorare con i dati del tuo strumento di terze parti preferito. Per ulteriori informazioni, consultare SageMaker Browser (IDC Credentials Provider) e SageMaker Provider di credenziali IAM.

Caching di autenticazione del browser: è stato aggiunto il supporto per la memorizzazione nella cache dei token in memoria ai plug-in di autenticazione BrowserSaml e BrowserAzure AD. Quando EnableTokenCaching è impostato sutrue, il driver memorizza nella cache i token di autenticazione tra le connessioni, riducendo il numero di richieste di autenticazione del browser.

AWS Aggiornamento della versione SDK: abbiamo aggiornato la versione AWS SDK utilizzata nel driver alla 2.46.3 e abbiamo aggiornato le dipendenze del progetto per la versione 3.8.0.

Gestione di data e ora: il driver ora gestisce correttamente le date pre-gregoriane, le transizioni dell'ora legale, le conversioni di fuso orario e la precisione in nanosecondi nei valori di data, ora e timestamp.

Dichiarazioni preparate: le istruzioni preparate ora funzionano correttamente quando sono presenti commenti finali.

Caratteri speciali nei nomi delle tabelle: i getColumns metodi getTables and ora gestiscono correttamente i nomi di tabella contenenti caratteri speciali come +$, o..

ResultSet.getObject— ResultSet.getObject() ora lancia SQLException al posto di NullPointerException oClassCastException, in conformità con le specifiche JDBC.

OutputLocation compatibilità: il parametro di s3_staging_dir connessione del driver 2.x è ora riconosciuto correttamente come alias per. OutputLocation

Ciclo di vita della connessione: il driver ora chiude correttamente i pool di thread interni quando la connessione viene chiusa o quando viene modificato il timeout di rete, evitando perdite di thread.

Browser OIDC Plugin di autenticazione affidabile per la propagazione dell'identità: aggiunto un nuovo plug-in di autenticazione che consente l'autenticazione basata su browser senza interruzioni con i provider di identità OpenID Connect (OIDC). Questo plugin gestisce l'intero flusso OAuth 2.0 tramite il browser predefinito, recupera automaticamente il JSON Web Token (JWT) e si integra con la propagazione affidabile delle identità. Progettato specificamente per ambienti desktop a utente singolo, offre un'esperienza di autenticazione più semplificata rispetto alla gestione manuale di JWT. Per ulteriori informazioni sulla propagazione delle identità attendibili, consulta Cos'è la propagazione dell'identità affidabile? .

Supporto migliorato per la precisione del timestamp: il driver ora supporta completamente la precisione in millisecondi e nanosecondi nei valori di timestamp restituiti dalle query Athena tramite il metodo. getTimestamp()

Migliore gestione dei tipi complessi: sono stati risolti i problemi relativi all'analisi dei tipi di dati annidati (array, strutture e mappe) sia nelle operazioni generali sui metadati che in quelle generali, garantendo informazioni di tipo accurate per strutture di dati complesse. DatabaseMetaData#getColumns

Registrazione degli errori migliorata: registrazione migliorata per gli errori di recupero dei metadati S3, che fornisce messaggi di errore più chiari e migliori informazioni diagnostiche.

Plugin di autenticazioneJWT Trusted Identity Propagation: aggiunto un nuovo plug-in di autenticazione per supportare l’integrazione della propagazione delle identità JWT Trusted Identity Propagation con i driver JDBC. Con questo tipo di autenticazione, è possibile utilizzare un token Web JSON (JWT) ottenuto da un gestore delle identità esterno come parametro di connessione per l’autenticazione con Athena. Con la propagazione affidabile delle identità, il contesto dell'identità viene aggiunto a un ruolo IAM per identificare l'utente che richiede l'accesso alle risorse. AWS Per informazioni sull’attivazione e l’utilizzo della propagazione attendibile delle identità, consultare What is trusted identity propagation?.

Supporto degli endpoint di amministrazione SSO OIDC e SSO personalizzati: è stato aggiunto il supporto per gli endpoint SSO OIDC e SSO Admin personalizzati nel driver JDBC. Questo miglioramento consente di specificare i propri endpoint per i servizi SSO quando si esegue JDBC dietro VPC.

AWS Aggiornamento della versione SDK: abbiamo aggiornato la versione AWS SDK utilizzata nel driver alla 2.32.16 e abbiamo aggiornato le dipendenze del progetto per la versione 3.6.0.

Funzionalità di logging: funzionalità di fetch logging S3 migliorate elevando il livello di registro a INFO e aggiungendo metriche per il conteggio delle righe, gli offset e la lunghezza degli oggetti. Monitoraggio del ciclo di vita della connessione implementato e prestazioni di logging complessive ottimizzate.

Gestione dei caratteri speciali: gestione migliorata dei caratteri speciali per i modelli LIKE nei nomi di schemi e cataloghi.

Gestione dello statodi connessione: migliore gestione dello stato di connessione per prevenire potenziali errori impedendo le chiamate API dopo la chiusura della connessione e aggiungendo controlli di sicurezza per le operazioni di interrogazione durante l’arresto.

Metadati dellequery DDL: è stato risolto il problema NoSuchKeyFound relativo alla gestione dei metadati delle query DDL.

Parametri di configurazione dei risultati: è stato aggiunto il supporto per due nuovi parametri di connessione ExpectedBucketOwner e AclOption. Per ulteriori informazioni, consultare sui Parametri di configurazione dei risultati.

AWS Versione SDK: la versione AWS SDK utilizzata nel driver è stata aggiornata alla 2.30.22.

Result Fetcher: il driver ora seleziona automaticamente il metodo più veloce per scaricare i risultati delle query. Ciò elimina la necessità di configurare manualmente il fetcher nella maggior parte dei casi. Per ulteriori informazioni, consultare Parametri di recupero dei risultati.

ResultSet— Il driver ora gestisce l'iterazione sui set di risultati delle istruzioni DDL che non producono oggetti di risultato su S3. Restituisce inoltre un oggetto vuoto ResultSet anziché null quando GetQueryResultsStream restituisce una pagina completamente vuota.

ResultsStream— Lo streaming dei risultati è stato ottimizzato rimuovendo le chiamate non necessarie per contare il numero di righe nei buffer interni.

GetTables: la chiamata GetTables è stata ottimizzata gestendo i tipi di tabella in base alle risposte ListTableMetadata e GetTableMetadata.

DataZone autenticazione: è stato aggiunto il supporto per i plugin DataZone DataZoneIdC di autenticazione e. DataZoneIAM Per ulteriori informazioni, consultare SageMaker Browser (IDC Credentials Provider) e SageMaker Provider di credenziali IAM.

Timeout di rete: ora è possibile impostare il timeout di rete utilizzando il parametro di connessione NetworkTimeoutMillis. In precedenza poteva essere impostato solo sull’oggetto Connection stesso. Per ulteriori informazioni, consulta Timeout di rete.

Gestione degli oggetti vuoti in S3: il driver ora gestisce gli oggetti vuoti nel fetcher S3 invece di generare un'eccezione Range Not Satisfiable di Amazon S3.

Registrazione: il driver non registra più il messaggio Items required for query execution [...], but subscription is cancelled dopo aver consumato i risultati della query.

Stringhe di parametri vuote: il driver ora gestisce le stringhe vuote presenti in un parametro di connessione come se il parametro non fosse presente. In questo modo vengono risolti i problemi che si verificavano quando alcuni strumenti di BI passavano inavvertitamente stringhe vuote che causavano tentativi di autenticazione non intenzionali.

Mappatura dei tipi di dati: è stata migliorata la conformità alle specifiche JDBC modificando il modo in cui il driver mappa i tipi di dati tinyint, smallint, row, e struct sugli oggetti Java.

AWS Aggiornamento della versione SDK: la versione AWS SDK utilizzata nel driver è stata aggiornata alla 2.26.23.

Commenti: è stato risolto un problema relativo ai commenti di riga alla fine di una dichiarazione.

Elenco dei database: è stato risolto un problema in base al quale i database di elenchi potevano entrare in un ciclo infinito quando l’ultima pagina restituita dall’API ListDatabases impaginata era vuota.

Provider di credenziali JWT: è stato aggiunto supporto per le durate delle sessioni specificate dall’utente. Per ulteriori informazioni, consulta Durata della sessione del ruolo.

Pool di thread: ne è stato creato uno ThreadPoolExecutor a connessione per attività asincrone in modo da evitare l’utilizzo del pool ForkJoin.

Provider di credenziali: l'host proxy viene ora analizzato per ottenere lo schema e l'host quando il client HTTP è configurato per l'esterno. IdPs

Provider di credenziali predefinito: viene garantito che il provider di credenziali predefinito non possa essere chiuso dal codice client.

getColumns: risolto un problema relativo alla proprietà delle colonne ORDINAL_COLUMN nel metodo DatabaseMetaData#getColumns.

ResultSet— È stato aggiunto il supporto NaN per Infinity e ha ResultSet. risolto una discrepanza tra il tipo di colonna restituito dalle operazioni di catalogo e il set di risultati di una query completata. -Infinity

Prestazioni del funzionamento del catalogo: le prestazioni sono state migliorate per le operazioni di catalogo che non utilizzano caratteri jolly.

Modifica dell’intervallo minimo di polling: l’impostazione predefinita dell’intervallo di polling minimo è stata modificata per ridurre il numero di chiamate API che il driver effettua verso Athena. I completamenti delle query vengono comunque rilevati il prima possibile.

Individuabilità degli strumenti BI: il driver è stato reso più facilmente individuabile per gli strumenti di business intelligence.

Mappatura dei tipi di dati: la mappatura dei tipi di dati sui tipi di dati Athena binary e array e DDL struct è stata migliorata.

AWS Versione SDK: la versione AWS SDK utilizzata nel driver è stata aggiornata alla 2.25.34.

Elenchi di tabelle di cataloghi federati: è stato risolto un problema che causava la restituzione di un elenco vuoto di tabelle da parte dei cataloghi federati.

GetSchemas: è stato risolto un problema a causa del quale il metodo JDBC DatabaseMetaData#getSchemas recuperava i database solo dal catalogo predefinito anziché da tutti i cataloghi.

getColumns — È stato risolto un problema che causava la restituzione di un catalogo nullo quando il metodo JDBC DatabaseMetaData #getColumns veniva chiamato con un nome di catalogo nullo.

È stato aggiunto il supporto per Microsoft Active Directory Federation Services (ADFS), Windows Integrated Authentication e autenticazione tramite modulo.

Per motivi di retrocompatibilità con la versione 2.x, il sottoprotocollo JDBC awsathena è ora accettato ma genera un avviso di obsolescenza. Utilizzare invece il sottoprotocollo JDBC athena.

AwsDataCatalog è ora l’impostazione predefinita per il parametro del catalogo e default è l’impostazione predefinita per il parametro del database. Queste modifiche assicurano che vengano restituiti valori corretti per il catalogo e il database correnti anziché non validi.

In conformità con la specifica JDBC, IS_AUTOINCREMENT e IS_GENERATEDCOLUMN ora restituiscono una stringa vuota anziché NO.

Il tipo di dati Athena int ora viene mappato allo stesso tipo JDBC di Athena integer anziché a other.

Quando i metadati della colonna di Athena non contengono i campi opzionali precision e scale, il driver ora restituisce zero per i valori corrispondenti in una colonna ResultSet.

La versione AWS SDK è stata aggiornata alla 2.21.39.

È stato risolto un problema con GetQueryResultsStream che causava un'eccezione quando i risultati di testo normale di Athena avevano un conteggio di colonne non coerente con il conteggio di colonne presente nei metadati dei risultati di Athena.