Migrare al driver ODBC 2.x - Amazon Athena

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Migrare al driver ODBC 2.x

Poiché la maggior parte dei parametri di connessione ODBC 2.x di Athena è retrocompatibile con il driver ODBC 1.x, con il driver Athena ODBC 2.x puoi riutilizzare la maggior parte della stringa di connessione esistente. Tuttavia, i seguenti parametri di connessione richiedono delle modifiche.

Livello di log

Sebbene l'attuale driver ODBC offra una gamma di opzioni di registrazione disponibili, a partire da LOG_OFF (0) aLOG_TRACE (6), il driver Amazon Athena ODBC 2.x inizialmente aveva solo due valori: 0 (disabilitato) e 1 (abilitato). A partire dalla versione 2.0.6.0, il driver ora supporta livelli di registrazione più granulari con funzionalità di registrazione avanzate:

  • OFF- La registrazione è disabilitata

  • ERROR- Vengono registrati solo i messaggi di errore

  • WARN- Vengono registrati i messaggi di avviso e gli errori

  • INFO- Vengono registrati i messaggi informativi, gli avvisi e gli errori

  • DEBUG- Vengono registrate informazioni dettagliate di debug e tutti i messaggi di livello inferiore

  • TRACE- Il livello di registrazione più dettagliato, include tutti i messaggi

Per ulteriori informazioni sulla registrazione di log con il driver ODBC 2.x, consulta Opzioni di registrazione.

Driver ODBC 1.x Driver ODBC 2.x
Nome stringa connessione LogLevel LogLevel
Tipo parametro Facoltativo Facoltativo
Valore predefinito 0 OFF
Valori possibili 0-6

Per le versioni precedenti alla 2.0.6.0: 0,1

Per la versione 2.0.6.0 e successive:,,,, OFF ERROR WARN INFO DEBUG TRACE

Esempio stringa connessione LogLevel=6; LogLevel=INFO;
Nota

Nella versione 2.0.6.0 e successive, il framework di registrazione è stato ottimizzato per ridurre i ritardi operativi e l'eccessiva generazione di file di registro, fornendo al contempo informazioni diagnostiche più dettagliate attraverso questi livelli di registro granulari. Ogni livello include tutti i messaggi provenienti dai livelli sottostanti.

MetadataRetrievalMethod

L'attuale driver ODBC offre varie opzioni per recuperare i metadati da Athena. Il driver ODBC di Amazon Athena rende MetadataRetrievalMethod obsoleto e utilizza sempre l'API di Amazon Athena per estrarre i metadati.

Athena introduce il flag QueryExternalCatalogs per eseguire query su cataloghi esterni. Per eseguire query sui cataloghi esterni con l'attuale driver ODBC, imposta MetadataRetrievalMethod su ProxyAPI. Per eseguire query sui cataloghi esterni con l'attuale driver ODBC di Athena, imposta QueryExternalCatalogs su 1.

Driver ODBC 1.x Driver ODBC 2.x
Nome stringa connessione MetadataRetrievalMethod QueryExternalCatalogs
Tipo parametro Facoltativo Facoltativo
Valore predefinito Auto 0
Valori possibili Auto, AWS Glue, ProxyAPI, Query 0,1
Esempio stringa connessione MetadataRetrievalMethod=ProxyAPI; QueryExternalCatalogs=1;

Test di connessione

Quando esegui il test di connessione di un driver ODBC 1.x, il driver esegue una query SELECT 1 che genera due file nel bucket Amazon S3: uno per il set di risultati e uno per i metadati. La connessione del test viene addebitata in base alla policy dei Prezzi di Amazon Athena.

Quando si esegue il test di una connessione con un driver ODBC 2.x, il driver richiama l'azione API GetWorkGroupAthena. La chiamata utilizza il tipo di autenticazione e il provider di credenziali corrispondente che hai indicato per recuperare le credenziali. Non è previsto alcun costo per il test di connessione quando utilizzi il driver ODBC 2.x, inoltre il test non genera risultati di query nel bucket Amazon S3.