# Migración al controlador ODBC 2.x
<a name="odbc-v2-driver-migrating"></a>

Como la mayoría de los parámetros de conexión ODBC 2.x de Athena son compatibles con versiones anteriores del controlador ODBC 1.x, puede reutilizar la mayor parte de la cadena de conexión existente con el controlador ODBC 2.x de Athena. Sin embargo, es necesario modificar los siguientes parámetros de conexión.

## Nivel de registro
<a name="odbc-v2-driver-migrating-log-level"></a>

Si bien el controlador ODBC actual ofrece una gama de opciones de registro disponibles, desde `LOG_OFF (0)` hasta `LOG_TRACE (6)`, el controlador ODBC de Amazon Athena 2.x inicialmente solo tenía dos valores: 0 (desactivado) y 1 (habilitado). A partir de la versión 2.0.6.0, el controlador ahora admite niveles de registro más detallados con capacidades de registro mejoradas:
+ `OFF`: los registros están desactivados
+ `ERROR`: solo se registran los mensajes de error
+ `WARN`: se registran los mensajes de advertencia y los errores
+ `INFO`: se registran los errores, los mensajes informativos y los avisos
+ `DEBUG`: se registra la información detallada de depuración y todos los mensajes de nivel inferior
+ `TRACE`: el nivel de registro más detallado, incluye todos los mensajes

Para obtener más información sobre el registro del controlador ODBC 2.x, consulte [Opciones de registro](odbc-v2-driver-logging-options.md).


****  

|  | Controlador ODBC 1.x | Controlador ODBC 2.x | 
| --- | --- | --- | 
| Nombre de la cadena de conexión | LogLevel | LogLevel | 
| Tipo de parámetro | Opcional | Opcional | 
| Predeterminado | 0 | OFF | 
| Valores posibles | 0-6 | Para las versiones anteriores a la versión 2.0.6.0: `0,1` Para la versión 2.0.6.0 y posteriores: `OFF`, `ERROR`, `WARN`, `INFO`, `DEBUG`, `TRACE` | 
| Ejemplo de la cadena de conexión | LogLevel=6; | LogLevel=INFO; | 

**nota**  
En la versión 2.0.6.0 y posteriores, el marco de registro se optimizó para reducir los retrasos operativos y la generación excesiva de archivos de registro, al tiempo que proporciona información de diagnóstico más detallada a través de estos niveles de registro detallado. Cada nivel incluye todos los mensajes de los niveles inferiores.

## MetadataRetrievalMethod
<a name="odbc-v2-driver-migrating-metadataretrievalmethod"></a>

El controlador ODBC actual ofrece varias opciones para recuperar los metadatos de Athena. El controlador ODBC de Amazon Athena ya no utiliza `MetadataRetrievalMethod` y siempre usa la API de Amazon Athena para extraer metadatos.

Se ha incorporado la marca `QueryExternalCatalogs` en Athena para consultar catálogos externos. Para consultar catálogos externos con el controlador ODBC actual, configure `MetadataRetrievalMethod` en `ProxyAPI`. Para consultar catálogos externos con el controlador ODBC de Athena, configure `QueryExternalCatalogs` en `1`.


****  

|  | Controlador ODBC 1.x | Controlador ODBC 2.x | 
| --- | --- | --- | 
| Nombre de la cadena de conexión | MetadataRetrievalMethod | QueryExternalCatalogs | 
| Tipo de parámetro | Opcional | Opcional | 
| Predeterminado | Auto | 0 | 
| Valores posibles | Auto, AWS Glue, ProxyAPI, Query | 0,1 | 
| Ejemplo de la cadena de conexión | MetadataRetrievalMethod=ProxyAPI; | QueryExternalCatalogs=1; | 

## Prueba de conexión
<a name="odbc-v2-driver-migrating-connection-test"></a>

Al probar la conexión de un controlador ODBC 1.x, el controlador ejecuta una consulta `SELECT 1` que genera dos archivos en el bucket de Amazon S3: uno para el conjunto de resultados y otro para los metadatos. La conexión de prueba se cobra de acuerdo con la política de [precios de Amazon Athena](https://aws.amazon.com/athena/pricing/).

Al probar la conexión de un controlador ODBC 2.x, el controlador llama a la acción de la API de Athena [GetWorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetWorkGroup.html). La llamada utiliza el tipo de autenticación y el proveedor de credenciales correspondiente que especificó para recuperar las credenciales. La prueba de conexión es gratuita si utiliza el controlador ODBC 2.x y no genera resultados de consultas en el bucket de Amazon S3.