Migrar para o driver ODBC 2.x - Amazon Athena
Nível de logMetadataRetrievalMethodTeste de conexão

Migrar para o driver ODBC 2.x

Como a maioria dos parâmetros de conexão do ODBC 2.x do Athena é compatível com versões anteriores do driver ODBC 1.x, é possível reutilizar a maior parte da string de conexão existente com o driver ODBC 2.x do Athena. Porém, os parâmetros de conexão a seguir necessitam de modificações.

Nível de log

Embora o driver ODBC atual forneça uma variedade de opções de registro em log disponíveis, indo de LOG_OFF (0) a LOG_TRACE (6), o driver ODBC 2.x do Amazon Athena tinha inicialmente somente dois valores: 0 (desabilitado) e 1 (habilitado). A partir da versão 2.0.6.0, o driver agora é compatível com níveis de registro em log mais granulares com recursos de registro em log aprimorados:

  • OFF: o registro em log está desabilitado

  • ERROR: somente as mensagens de erro são registradas em log

  • WARN: os erros e as mensagens de aviso são registrados em log

  • INFO: os erros, os avisos e as mensagens informativas são registrados em log

  • DEBUG: as informações detalhadas de depuração, além de todas as mensagens de nível inferior são registradas em log

  • TRACE: o nível de registro em log mais detalhado, inclui todas as mensagens

Para obter mais informações sobre o registro em log do driver ODBC 2.x, consulte Opções de registro em log.

Driver ODBC 1.x Driver ODBC 2.x
Nome da string de conexão LogLevel LogLevel
Tipo de parâmetro Opcional Opcional
Valor padrão 0 OFF
Possíveis valores 0-6

Para versões anteriores à 2.0.6.0: 0,1

Para a versão 2.0.6.0 e posteriores: OFF , ERROR, WARN, INFO, DEBUG, TRACE
Exemplo de string de conexão LogLevel=6; LogLevel=INFO;
nota

Na versão 2.0.6.0 e posteriores, o framework de registro em log foi otimizado para reduzir os atrasos operacionais e a geração excessiva de arquivos de logs, ao mesmo tempo em que fornece informações de diagnóstico mais detalhadas por meio desses níveis granulares de logs. Cada nível inclui todas as mensagens dos níveis abaixo dele.

MetadataRetrievalMethod

O driver ODBC atual oferece várias opções para recuperar os metadados do Athena. O driver ODBC do Amazon Athena descontinua o MetadataRetrievalMethod e sempre usa a API do Amazon Athena para extrair metadados.

O Athena inclui o sinalizador QueryExternalCatalogs para consultar catálogos externos. Para consultar catálogos externos com o driver ODBC atual, defina MetadataRetrievalMethod como ProxyAPI. Para consultar catálogos externos com o driver ODBC do Athena, defina QueryExternalCatalogs como 1.

Driver ODBC 1.x Driver ODBC 2.x
Nome da string de conexão MetadataRetrievalMethod QueryExternalCatalogs
Tipo de parâmetro Opcional Opcional
Valor padrão Auto 0
Possíveis valores Auto, AWS Glue, ProxyAPI, Query 0,1
Exemplo de string de conexão MetadataRetrievalMethod=ProxyAPI; QueryExternalCatalogs=1;

Teste de conexão

Quando você testa uma conexão do driver ODBC 1.x, o driver executa uma consulta SELECT 1 que gera dois arquivos no bucket do Amazon S3: um para o conjunto de resultados e outro para os metadados. A conexão de teste é cobrada conforme a política de preços do Amazon Athena.

Quando você testa uma conexão do driver ODBC 2.x, o driver chama a ação da API GetWorkGroup do Athena. A chamada usa o tipo de autenticação e o provedor de credenciais correspondente que você especificou para recuperar credenciais. Não há cobrança pelo teste de conexão ao usar o driver ODBC 2.x, e o teste não gera resultados de consulta no bucket do Amazon S3.