# Migrar para o driver ODBC 2.x
<a name="odbc-v2-driver-migrating"></a>

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
<a name="odbc-v2-driver-migrating-log-level"></a>

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](odbc-v2-driver-logging-options.md).


****  

|  | 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`<br />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
<a name="odbc-v2-driver-migrating-metadataretrievalmethod"></a>

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
<a name="odbc-v2-driver-migrating-connection-test"></a>

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](https://aws.amazon.com/athena/pricing/).

Quando você testa uma conexão do driver ODBC 2.x, o driver chama a ação da API [GetWorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetWorkGroup.html) 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.