Uso de Athena con el controlador JDBC - Amazon Athena

Uso de Athena con el controlador JDBC

Puede utilizar una conexión JDBC para conectar Athena con herramientas de inteligencia empresarial y otras aplicaciones, como SQL Workbench. Para ello, utilice los enlaces de Amazon S3 de esta página para descargar, instalar y configurar el controlador JDBC de Athena. Para obtener información sobre los permisos, consulte Acceso a través de conexiones JDBC y ODBC. A partir de la versión 2.0.24, hay dos versiones del controlador disponibles: una que incluye el SDK de AWS, y una que no lo incluye.

importante

Cuando utilice el controlador JDBC, asegúrese de tener en cuenta los siguientes requisitos:

  • Abrir el puerto 444: mantenga el puerto 444, que Athena utiliza para transmitir los resultados de las consultas, abierto al tráfico saliente. Cuando utilice un punto de enlace de PrivateLink para conectarse a Athena, asegúrese de que el grupo de seguridad asociado al punto de enlace de PrivateLink esté abierto al tráfico entrante en el puerto 444. Si el puerto 444 está bloqueado, puede recibir el mensaje de error [Simba][AthenajDBC](100123) An error has occurred. Exception during column initialization.

  • Athena: política de flujo de resultados de consulta: agregue la acción de política athena:GetQueryResultsStream para las entidades principales de IAM que utilizan el controlador JDBC. Esta acción de política no se expone directamente con la API. Solo se utiliza con los controladores ODBC y JDBC como parte de la compatibilidad con los resultados de streaming. Para ver una política de ejemplo, consulte Política administrada de AWS: AWSQuicksightAthenaAccess.

Controlador JDBC con AWS SDK

El controlador JDBC versión 2.0.31 cumple con los estándares de datos de las versiones 4.1 y 4.2 de la API de JDBC. Para obtener información sobre la verificación de la versión de Java Runtime Environment (JRE) que utiliza, consulte la documentación de Java. La versión de JRE depende de la versión de la API de JDBC que utiliza con el controlador.

Descargue el controlador que corresponda a su versión del JDK y de los estándares de datos de JDBC:

  • El archivo AthenaJDBC41.jar es compatible con JDBC 4.1 y requiere JDK 7.0 o posterior.

  • El archivo AthenaJDBC42.jar es compatible con JDBC 4.2 y requiere JDK 8.0 o posterior.

La siguiente descarga de archivos .zip contiene los archivos .jar para JDBC 4.1 y 4.2 e incluye el AWS SDK.

Controlador JDBC sin AWS SDK

El controlador JDBC versión 2.0.31 cumple con los estándares de datos de las versiones 4.1 y 4.2 de la API de JDBC. Para obtener información sobre la verificación de la versión de Java Runtime Environment (JRE) que utiliza, consulte la documentación de Java. La versión de JRE depende de la versión de la API de JDBC que utiliza con el controlador.

Descargue el controlador que corresponda a su versión del JDK y de los estándares de datos de JDBC. Estos archivos no incluyen el SDK de AWS:

  • El archivo AthenaJDBC41.jar es compatible con JDBC 4.1 y requiere JDK 7.0 o posterior.

  • El archivo AthenaJDBC42.jar es compatible con JDBC 4.2 y requiere JDK 8.0 o posterior.

La siguiente descarga de archivos .zip contiene los archivos .jar para JDBC 4.1 y 4.2. No incluye el SDK de AWS.

Notas de la versión, contrato de Licencia y avisos del controlador JDBC

Después de descargar la versión que necesita, lea las notas de la versión y examine el contrato de licencia y los avisos.

Documentación del controlador JDBC

Descargue la documentación siguiente del controlador:

Notas del controlador JDBC

Uso del controlador JDBC para varios catálogos de datos

Para usar el controlador JDBC para varios catálogos de datos con Athena (por ejemplo, cuando se usa un metaalmacén externo de Hive o consultas federadas), incluya MetadataRetrievalMethod=ProxyAPI en la cadena de conexión JDBC.