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, começando de LOG_OFF (0) a LOG_TRACE (6), o driver ODBC do Amazon Athena tem apenas dois valores: 0 (desabilitado) e 1 (habilitado).
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 |
0 |
| Possíveis valores | 0-6 |
0,1 |
| Exemplo de string de conexão | LogLevel=6; |
LogLevel=1; |
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.
