Migración al controlador ODBC 2.x - Amazon Athena
Nivel de registroMetadataRetrievalMethodPrueba de conexión

Migración al controlador ODBC 2.x

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

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.

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

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

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.

Al probar la conexión de un controlador ODBC 2.x, el controlador llama a la acción de la API de Athena GetWorkGroup. 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.