Note di rilascio per ODBC 2.x di Amazon Athena

• È stato risolto un problema che causava SQLTables l'SQLColumnsomissione di tabelle nella posizione 200 circa e successive all'interno di uno schema. Ciò si verificava quando il driver riceveva due pagine vuote consecutive durante l'impaginazione dei risultati dei metadati.

• È stato risolto un problema che causava la restituzione di zero righe anziché tutte le Power BI righe da parte delle ADO.NET applicazioni da parte delle applicazioni. Il driver ora considera un modello di stringa vuoto come una restrizione, che corrisponde a tutti i valori.

• È stato risolto un problema che causava SQLColumns l'errore su tipi di colonna non riconosciuti dal driver, ad esempio uuid o. json Queste colonne sono ora riportate con il tipo SQLVARCHAR. La TYPE_NAME colonna continua a riportare il nome del tipo Athena.

• È stato risolto un problema che impediva alle connessioni che utilizzano il plug-in di SageMakerBrowserIdc autenticazione di rispondere fino allo scadere del timeout di risposta del provider di identità al momento dell'impostazione del parametro. SSOOIDCEndpointOverride

• È stato risolto un problema che faceva sì che il driver ignorasse il SSOEndpointOverride parametro per le connessioni che utilizzano il plug-in di autenticazione. BrowserSSOOIDC

• È stato risolto un problema che causava l'interruzione delle connessioni tramite un server proxy con errori di risoluzione DNS (Domain Name System) quando il proxy eseguiva la risoluzione DNS. I client HTTP creati internamente dall' AWS SDK ora utilizzano le impostazioni proxy configurate dal driver.

• È stato risolto un problema che impediva la verifica del certificato Transport Layer Security (TLS) su Linux quando il TrustedCerts parametro non era impostato. Il driver ora individua il pacchetto CA in fase di esecuzione e rispetta le variabili di ambiente e. CURL_CA_BUNDLE SSL_CERT_FILE Il pacchetto CA risolto viene applicato anche ai client HTTP creati internamente dall' AWS SDK.

• È stato risolto un problema che impediva l'installazione del driver Linux su distribuzioni con glibc 2.28, tra cui Red Hat Enterprise Linux 8 e Rocky Linux 8. Il driver Linux ora si basa su una versione di base 2.28 e richiede glibc 2.28 o versioni successive. glibc Su SUSE Linux Enterprise Server 15, usa SP3 o versione successiva, che fornisce una versione compatibile. glibc

• È stato risolto un problema che poteva causare l'arresto anomalo del driver Linux quando un'applicazione host che aveva già caricato una OpenSSL libreria diversa, ad esempio un R ambiente, caricava il driver. Il driver ora limita i simboli esportati all'API ODBC in modo che la libreria di crittografia in dotazione non sia influenzata da quella dell'applicazione host. OpenSSL

• È stato risolto un problema che causava l'invio da parte del driver di richieste ai provider di identità senza un'intestazione. User-Agent

  Azione richiesta: modifica dell' User-Agent intestazione

  Questa versione modifica l'User-Agentintestazione del driver per Athena, AWS Glue, Amazon S3 e le richieste di provider di identità supportate. L'autenticazione integrata di Windows continua a utilizzare un browser. User-Agent

  Se soddisfi le condizioni delle aws:UserAgent policy IAM, i filtri di registro o le regole di accesso del provider di identità del driver, aggiorna il pattern a. User-Agent *lib/AmazonAthenaODBC#* Questo modello non corrisponde alle richieste di autenticazione integrata di Windows.

• È stato risolto un problema che poteva causare SageMakerBrowserIdc il fallimento BrowserSSOOIDC dell'autenticazione sugli host con AWS credenziali ambientali. Il driver non è più SigV4-signs l'SSO OIDC RegisterClient e CreateToken le richieste utilizzate da questi plugin. BrowserSSOOIDCinoltre non sono più richieste SSO. SigV4-signs GetRoleCredentials CreateTokenWithIAMle richieste rimangono SigV4-signed.

• Sono stati risolti problemi che potevano causare la restituzione di risultati parziali da parte di Amazon S3 a causa di errori temporanei di recupero dei risultati. I problemi potevano inoltre causare l'interruzione della risposta del driver quando lo stream terminava con un record CSV multilinea non terminato con virgolette. L'autista ora effettua fino a tre tentativi per blocco. Ogni tentativo recupera l'intervallo di byte dall'offset del flusso corrente. Tra un tentativo e l'altro, il driver ricrea il client Amazon S3 in modo che il nuovo tentativo possa utilizzare credenziali aggiornate. Gli errori non transitori, come l'accesso negato, vengono restituiti senza un nuovo tentativo. Se il file dei risultati termina prematuramente, le applicazioni ora ricevono SQL_ERROR invece delle righe parziali seguite da. SQL_NO_DATA

• È stato risolto un problema relativo al modo in cui il driver formatta i valori dei parametri a cui si associava. SQLBindParameter Il driver ora invia ogni valore come valore letterale SQL digitato e sfugge alle virgolette singole al suo interno, quindi un valore che contiene una virgoletta non viene più interpretato come parte della query. I parametri delle stringhe non sono più inclusi. CAST(value AS CHAR(n)) Un valore che contiene un carattere null incorporato viene ora rifiutato con. SQL_ERROR Questo comportamento corrisponde al driver Amazon Athena JDBC 3.x.

  Azione richiesta: spazi finali nei parametri delle stringhe associate

  Poiché il driver non invia più i parametri di stringa come CHAR valori, i confronti con essi non ignorano più gli spazi finali. Un predicato come WHERE column = ? quello delle righe precedentemente corrispondenti i cui valori di colonna differiscono dal valore associato solo negli spazi finali ora restituisce un numero inferiore di righe. Se l'applicazione dipende dal comportamento precedente, ritaglia entrambi i lati del confronto, ad esempio. WHERE rtrim(column) = rtrim(?)

• È stato risolto un problema a causa del quale i parametri associati SQL_NULL_DATA a null venivano inviati come valori anziché come. NULL Un SQL_DOUBLE parametro null SQL_REAL o è stato inviato come. SQL_FLOAT 0.0 Un parametro null di qualsiasi altro tipo è stato inviato come stringa. NULL Per i parametri di stringa, questo valore corrisponde alle righe che contengono il testo. NULL Le query che associano parametri di data e ora nulli non sono riuscite. Il driver ora invia NULL un parametro nullo di qualsiasi tipo.

• È stato aggiunto il parametro di UserAgentPrivacyMode connessione opzionale. Imposta questo parametro su 1 per omettere i metadati dell'ambiente di runtime dall'User-Agentintestazione delle richieste del provider di identità, mantenendoli al contempo. lib/AmazonAthenaODBC#<version> Le richieste ai AWS servizi, tra cui Athena, AWS Glue e Amazon S3, includono sempre l'intestazione completa. User-Agent

• È stato risolto un problema che causava il fallimento di alcune richieste di autenticazione basate su browser a causa di un'intestazione mancante. Content-Length

• È stato risolto un problema che causava il tronco dei parametri di interrogazione quando si utilizzavano le associazioni. SQL_C_WCHAR

• Il file di licenza include ora un riferimento ai Termini di servizio. AWS

• SageMaker autenticazione: è stato aggiunto il supporto per i plugin di autenticazione e SageMaker . SageMakerBrowserIdc SageMakerIam Ora puoi connetterti ai tuoi SageMaker progetti e lavorare con i dati del tuo strumento di terze parti preferito. Per ulteriori informazioni, consulta SageMaker Browser IDC e SageMaker IAM.

• 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.

• Programma di installazione universale macOS: il driver macOS è ora distribuito come un unico binario universale che supporta le architetture ARM e Intel, semplificando l'installazione su tutto l'hardware Mac.

• Migrazione del client HTTP: è stata rimossa la dipendenza libcurl dai binari ODBC eseguendo la migrazione al client HTTP SDK CRT. AWS Il client CRT utilizza lo stack TLS nativo della piattaforma e l'archivio di fiducia del sistema, migliorando l'affidabilità della connessione ed eliminando le dipendenze transitive da OpenSSL e zlib.

• È stato aggiunto il supporto per STS per l'assunzione di ruoli tra account. ExternalId AssumeRole ExternalIdViene letto dalla configurazione del AWS profilo.

• Convalida del certificato SSL abilitata per impostazione predefinita: il driver ora applica la verifica del certificato SSL durante la connessione ai provider di identità. Se utilizzi un provider di identità locale senza un certificato SSL valido, devi impostarlo in modo esplicito nella stringa di connessione. SSL_Insecure=1 Per ulteriori informazioni, consulta SSL non sicuro (IdP).

• TLS 1.2 applicato come minimo: il driver non accetta più connessioni TLS 1.0 o TLS 1.1 ai provider di identità. Tutte le connessioni IdP ora richiedono TLS 1.2 o versione successiva.

• Flusso di autenticazione BrowserSSOOIDC aggiornato: il plug-in BrowserSSOOIDC ora utilizza il codice di autorizzazione con PKCE anziché l'autorizzazione del codice del dispositivo. Un nuovo parametro listen_port opzionale (predefinito 7890) è disponibile per il server di callback OAuth 2.0. Potrebbe essere necessario inserire questa porta nella propria rete nell'elenco delle autorizzazioni consentite. L'ambito predefinito è cambiato in. sso:account:access Per ulteriori informazioni, consulta Browser SSO OIDC.

• BrowserSSOOidc: migrazione da Device Code flow a Authorization Code con PKCE per una maggiore sicurezza.

• BrowserAzureAD — Aggiunto PKCE (Proof Key for Code Exchange) al flusso di autorizzazione OAuth 2.0 per prevenire attacchi di intercettazione del codice di autorizzazione.

• BrowserSAML: è stata aggiunta la protezione RelayState CSRF per prevenire gli attacchi di iniezione di token SAML.

• Cache delle credenziali: a partire dalla versione 2.1.0.0, le credenziali memorizzate nella cache vengono archiviate come JSON in testo semplice nella user-profile/.athena-odbc/ directory con autorizzazioni di file limitate all'utente proprietario, coerentemente con il modo in cui la CLI protegge le credenziali archiviate localmente. AWS

• Profilo IAM: supporto aggiunto e fonti di credenziali in aggiunta a quelle esistenti. EcsContainer Environment Ec2InstanceMetadata

• Parser di stringhe di connessione: implementata la corretta gestione degli escape ODBC. }}

• Interrogazioni sul catalogo: è stato aggiunto l'escape dell'identificatore SQL per i nomi degli schemi e i modelli di tabella.

• Corrispondenza dei modelli ODBC: la corrispondenza basata su regex è stata sostituita con il matcher wildcard diretto ODBC LIKE.

• Analisi XML: sono stati aggiunti il limite di profondità di ricorsione (100 livelli) e il limite di dimensione (1 MB) per i token SAML.

• Autenticazione ADFS: è stato aggiunto un limite di dimensione della risposta (200 KB) per le risposte del server ADFS.

• È stata risolta la neutralizzazione impropria di elementi speciali nei componenti di autenticazione che potevano consentire l'esecuzione del codice o il reindirizzamento del flusso di autenticazione tramite parametri di connessione predefiniti. Influisce sui plugin BrowsersSOOIDC, AD e BrowserSAML. BrowserAzure

• È stata corretta la neutralizzazione impropria di elementi speciali nei componenti di elaborazione delle query che potevano consentire la negazione del servizio o l'iniezione SQL tramite metadati di tabella predisposti.

• Risolto il problema della convalida errata dei certificati durante la connessione ai provider di identità.

• Sono stati corretti i controlli di sicurezza dell'autenticazione mancanti nei flussi di autenticazione basati su browser, tra cui PKCE per OAuth, protezione CSRF per SAML, memorizzazione sicura delle credenziali e associazione esclusiva alla porta di callback.

• Risolto il problema del consumo incontrollato di risorse nell'analisi dei componenti che poteva consentire l'interruzione del servizio tramite modelli di input predefiniti, risposte illimitate del server o payload XML profondamente annidati.

• È stato risolto un problema che non SQLTables restituiva SQLColumns risultati quando si utilizzavano cataloghi federati tra più account in UseSingleCatalogAndSchema=1 modalità di importazione Power BI.

• Plugin di autenticazione Browser Trusted Identity Propagation: aggiunto un nuovo plug-in di autenticazione per supportare l'autenticazione OpenID Connect (OIDC) basata su browser con propagazione dell'identità affidabile. Questo plugin offre un'esperienza di autenticazione senza interruzioni gestendo l'intero flusso OAuth 2.0 tramite il browser predefinito, recuperando automaticamente il JSON Web Token (JWT) e integrandosi con la propagazione affidabile delle identità. Il plugin è progettato specificamente per ambienti desktop a utente singolo. Per informazioni sull’attivazione e l’utilizzo della propagazione attendibile delle identità, consultare What is trusted identity propagation?.

• Framework di registrazione migliorato: il meccanismo di registrazione del driver è notevolmente migliorato grazie a:

  • Introduzione di livelli di registro più granulari oltre alle opzioni di base 0/1

  • Rimozione delle istruzioni di registro ridondanti

  • Ottimizzazione del framework di registrazione per includere informazioni diagnostiche rilevanti

  • Risoluzione dei problemi di prestazioni che causavano ritardi operativi

  • Ridurre la generazione eccessiva di file di registro quando la registrazione è abilitata

• Ottimizzazione del recuperatore dei risultati: è stato risolto un problema a causa del quale le limitazioni dei parametri di fetch size venivano applicate erroneamente ai recuperatori di risultati in streaming e non in streaming. La limitazione ora viene applicata correttamente solo ai dispositivi di recupero dei risultati non in streaming.

Il driver ODBC v2.0.5.1 di Amazon Athena contiene le seguenti correzioni ai plugin di autenticazione basati su browser.

• Validazione implementata per il controllo dell’URL di accesso e dello schema.

• Meccanismo di avvio del browser migliorato su Linux per utilizzare le API di sistema, con conseguente miglioramento della stabilità e della sicurezza.

• Plugin di autenticazione JWT Trusted Identity Provider (TIP): aggiunto un nuovo plug-in di autenticazione per supportare l’integrazione di JWT Trusted Identity Provider (TIP) con i driver ODBC. Con questo tipo di autenticazione, puoi utilizzare un token Web JSON (JWT) ottenuto da un gestore delle identità esterno come parametro di connessione per l’autenticazione con Athena. Con TIP, il contesto di 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 di TIP, consulta What is Trusted Identity Propagation? .

• Supporto per endpoint di amministrazione SSO personalizzati: è stato aggiunto il supporto per gli endpoint di amministrazione SSO personalizzati nel driver ODBC. Questo miglioramento consente di specificare i propri endpoint per i servizi SSO quando si esegue ODBC 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 2.0.5.0.

• Result Fetcher: il driver ora seleziona automaticamente il metodo per scaricare i risultati della query. Ciò elimina la necessità di configurare manualmente il fetcher nella maggior parte delle situazioni. Per ulteriori informazioni, consulta Sistema di recupero (fetcher) dei risultati.

• La libreria Curl è stata aggiornata alla 8.12.1.

• Configurazione proxy fissa per il profilo IAM durante la connessione a STS. La correzione consente di utilizzare il profilo IAM per una corretta autenticazione.

• Leggi tutte le opzioni di configurazione aggiuntive per il profilo IAM con plugin di autenticazione. Ciò includeUseProxyForIdP, SSL_InsecureLakeformationEnabled, e la risoluzione LoginToRP di configurazioni errate per i plugin interessati.

• Risolto il problema della funzione arrotondata che consentiva l’inserimento di un secondo parametro opzionale. Elabora con successo le interrogazioni contenenti la sintassi di escape.

• Dimensioni fisse delle colonne TIME WITH TIME ZONE e tipi di TIMESTAMP WITH TIME ZONE dati. I valori con timestamp e tipo di dati del fuso orario non verranno troncati.

• Aggiunto il supporto MFA per il plug-in di autenticazione Okta su piattaforme Linux e Mac.

• Sia la libreria athena-odbc.dll che il programma di installazione AmazonAthenaODBC-2.x.x.x.msi per Windows sono ora firmati.

• È stato aggiornato il file cacert.pem del certificato CA installato con il driver.

• È stato migliorato il tempo necessario per elencare le tabelle nei cataloghi Lambda. Per i tipi di LAMBDA catalogo, il driver ODBC può ora inviare una SHOW TABLES query per ottenere un elenco di tabelle disponibili. Per ulteriori informazioni, consulta Utilizzare query per elencare tabelle.

• È stato introdotto il parametro di connessione UseWCharForStringTypes per riportare i tipi di dati di stringa utilizzando SQL_WCHAR e SQL_WVARCHAR. Per ulteriori informazioni, consulta Utilizzare WCHAR per i tipi di stringhe.

• È stato corretto un avviso di danneggiamento del registro che si verificava quando lo strumento veniva utilizzato. Get-OdbcDsn PowerShell

• È stata aggiornata la logica di analisi per gestire i commenti all’inizio delle stringhe di query.

• I tipi di dati relativi alla data e all’ora ora consentono lo zero nel campo dell’anno.

• Sono stati aggiunti due parametri di connessione, StringColumnLength e ComplexTypeColumnLength, che è possibile utilizzare per modificare la lunghezza predefinita delle colonne per stringhe e tipi di dati complessi. Per ulteriori informazioni, consulta Lunghezza della colonna di stringa e Lunghezza della colonna di tipo complesso.

• È stato aggiunto il supporto per i sistemi operativi Linux e macOS (Intel e ARM). Per ulteriori informazioni, consulta Linux e macOS.

• AWS-SDK-CPP è stato aggiornato alla versione del tag 1.11.245.

• La libreria curl è stata aggiornata alla versione 8.6.0.

• È stato risolto un problema che causava la segnalazione di valori errati nei metadati del set di risultati per tipi di dati simili a stringhe nella colonna precision.

• Migliore sicurezza dei thread dei driver ODBC per tutte le interfacce.

• Quando la registrazione è abilitata, ora i valori datetime vengono registrati con una precisione di millisecondi.

• Durante l'autenticazione con il plug-in Browser SSO OIDC, ora il terminale si apre per mostrare all'utente il codice del dispositivo.

• È stato risolto un problema di rilascio della memoria che si verificava durante l'analisi dei risultati dall'API di streaming.

• Le richieste per le interfacce SQLTablePrivileges(), SQLSpecialColumns(), SQLProcedureColumns() e SQLProcedures() ora restituiscono set di risultati vuoti.

• Funzionalità della cache di file aggiunta per i plug-in di autenticazione basati su browser di Browser Azure AD, Browser SSO OIDC e Okta.

  Gli strumenti di BI come Power BI e i plug-in basati su browser utilizzano più finestre del browser. Il nuovo parametro di connessione alla cache dei file consente di memorizzare nella cache le credenziali temporanee e di riutilizzarle tra i molteplici processi aperti dalle applicazioni di BI.

• Le applicazioni possono ora interrogare le informazioni sul set di risultati dopo la preparazione di un'istruzione.

• I timeout predefiniti di connessione e richiesta sono stati aumentati in modo da poter essere utilizzati con reti client più lente. Per ulteriori informazioni, consulta Timeout di connessione e Richiedi il timeout.

• Sono state aggiunte le sovrascritture degli endpoint per SSO e SSO OIDC. Per ulteriori informazioni, consulta Sostituzioni degli endpoint.

• È stato aggiunto un parametro di connessione per passare un argomento URI per una richiesta di autenticazione a Ping. Puoi usare questo parametro per aggirare la limitazione del ruolo singolo di Lake Formation. Per ulteriori informazioni, consulta Parametro URI di Ping.

• È stato risolto un problema di overflow di numeri interi che si verificava quando si utilizzava il meccanismo di associazione basato sulle righe.

• Timeout rimosso dall'elenco dei parametri di connessione richiesti per il plug-in di autenticazione Browser SSO OIDC.

• Sono state aggiunte le interfacce mancanti per SQLStatistics(), SQLPrimaryKeys(), SQLForeignKeys() e SQLColumnPrivileges() ed è stata aggiunta la possibilità di restituire set di risultati vuoti su richiesta.

• È stata aggiunta la registrazione di log URI al plug-in di autenticazione Okta.

• È stato aggiunto il parametro di ruolo preferito al plug-in del provider di credenziali esterne.

• Aggiunta in corso della gestione del prefisso del profilo nel nome del profilo del file di configurazione AWS .

• È stato corretto un problema di Regione AWS utilizzo che si verificava durante l'utilizzo con Lake Formation e AWS STS i client.

• Le chiavi di partizione mancanti sono state ripristinate nell'elenco delle colonne della tabella.

• È stato aggiunto il tipo di autenticazione BrowserSSOOIDC mancante al profilo AWS .