Parámetros de conexión avanzados

En las siguientes secciones se describen los parámetros de conexión avanzados del controlador JDBC 3.x.

Parámetros de cifrado de resultado

Tenga en cuenta los siguientes puntos:

Opciones de cifrado

El tipo de cifrado que se utilizará para los resultados de las consultas tal como se almacenan en Amazon S3. Para obtener más información sobre las opciones de cifrado, consulte EncryptionConfiguration en la Referencia de la API de Amazon Athena.

Clave de KMS

El ARN o ID de la clave KMS, si se elige SSE_KMS o CSE_KMS se elige como opción de cifrado. Para obtener más información, consulte EncryptionConfiguration en Referencia de la API de Amazon Athena.

Parámetros de obtención de resultados

Buscador de resultados

El buscador que se utilizará para descargar los resultados de las consultas.

Los buscadores disponibles son idénticos en el sentido de que todos devuelven resultados de Amazon S3, pero difieren en términos de rendimiento e implementación. El buscador de resultados predeterminado, S3, descarga los resultados de las consultas directamente desde Amazon S3 sin utilizar las API de Athena. La opción S3 es la más rápida en la mayoría de casos, pero no está disponible si 1) los resultados de la consulta están cifrados con CSE_KMS o 2) si la política que permite al usuario acceder a los resultados de la consulta solo permite llamadas de Athena mediante s3:CalledVia. La opción ResultFetcher=GetQueryResultsStream utiliza la API de transmisión del conjunto de resultados y es equivalente a la configuración UseResultsetStreaming = 1 en el controlador JDBC 2.x.

Tamaño de recuperación

El valor de este parámetro se utiliza como mínimo para los búferes internos y como tamaño de la página de destino cuando se obtienen los resultados. El valor 0 (cero) significa que el controlador debe usar sus valores predeterminados tal y como se describe a continuación. El valor máximo es 1 000 000

Parámetros de reutilización de resultados de las consultas

Habilitar la reutilización de resultados

Especifica si se pueden reutilizar los resultados anteriores de la misma consulta cuando se ejecuta una consulta. Para obtener información sobre la reutilización de los resultados de la consulta, consulte ResultReuseByAgeConfiguration.

Antigüedad máxima de reutilización de resultados

Especifica, en minutos, la antigüedad máxima de un resultado de consulta anterior que Athena debe tener en cuenta para su reutilización. Para obtener información sobre la antigüedad máxima de reutilización de los resultados, consulte ResultReuseByAgeConfiguration.

Parámetros de sondeo de ejecución de consultas

Intervalo mínimo de sondeo de ejecución de consultas

Valor mínimo en milisegundos que debe esperarse antes de sondear Athena para determinar el estado de ejecución de la consulta.

Intervalo máximo de sondeo de ejecución de consultas

Valor máximo en milisegundos que debe esperarse antes de sondear Athena para determinar el estado de ejecución de la consulta.

Multiplicador del intervalo de sondeo de ejecución de consultas

Factor para aumentar el periodo de sondeo. De forma predeterminada, el sondeo comienza con el valor de MinQueryExecutionPollingIntervalMillis y se duplica con cada sondeo hasta alcanzar el valor de MaxQueryExecutionPollingIntervalMillis.

Parámetros de invalidación del punto de conexión

Anulación del punto de conexión de Athena

El punto de conexión que el controlador utilizará para realizar llamadas de API a Athena.

Tenga en cuenta los siguientes puntos:

Anulación del punto de conexión del servicio de transmisión de Athena

El punto de conexión que el controlador utilizará para descargar los resultados de las consultas cuando utilice el servicio de transmisión de Athena. El servicio de transmisión de Athena está disponible a través del puerto 444.

Tenga en cuenta los siguientes puntos:

Anulación del punto de conexión de Lake Formation

El punto de conexión que el controlador utilizará para el servicio Lake Formation cuando utilice la API AWS Lake Formation AssumeDecoratedRoleWithSAML para recuperar credenciales temporales. Si no se especifica este parámetro, el controlador utiliza un punto de conexión de Lake Formation predeterminado.

Tenga en cuenta los siguientes puntos:

Anulación del punto de conexión S3

El punto de conexión que el controlador utilizará para descargar los resultados de las consultas cuando utilice el buscador de Amazon S3. Si no se especifica este parámetro, el controlador utiliza un punto de conexión de Amazon S3 predeterminado.

Tenga en cuenta los siguientes puntos:

Anulación del punto de conexión STS

El punto de conexión que el controlador utilizará para el servicio AWS STS cuando utilice la API AWS STS AssumeRoleWithSAML para recuperar credenciales temporales. Si no se especifica este parámetro, el controlador utiliza un punto de conexión AWS STS predeterminado.

Tenga en cuenta los siguientes puntos:

Parámetros de configuración del proxy

Host del proxy.

La URL del host proxy. Utilice este parámetro si necesita que las solicitudes de Athena pasen por un proxy.

Puerto del proxy.

El puerto que se utilizará en el host proxy. Utilice este parámetro si necesita que las solicitudes de Athena pasen por un proxy.

Nombre de usuario del proxy

Nombre de usuario para autenticarse con el servidor proxy. Utilice este parámetro si necesita que las solicitudes de Athena pasen por un proxy.

Contraseña del proxy.

Contraseña para autenticarse en el servidor proxy. Utilice este parámetro si necesita que las solicitudes de Athena pasen por un proxy.

Hosts exentos de proxy

Conjunto de nombres de host a los que el controlador se conecta sin usar un proxy cuando el proxy está habilitado (es decir, cuando los parámetros de conexión ProxyHost y ProxyPort están configurados). Los hosts deben estar separados por el carácter de barra vertical (|) (por ejemplo, host1.com|host2.com).

Proxy habilitado para proveedores de identidad

Especifica si se debe utilizar un proxy cuando el controlador se conecte a un proveedor de identidad.

Parámetros de registro

En esta sección se describen los parámetros relacionados con el registro.

Nivel de registro

Especifica el nivel de registro del complemento. No se registra nada a menos que el parámetro LogPath también esté establecido.

Ruta de registro

La ruta a un directorio del equipo en el que se ejecuta el controlador y en el que se guardarán los registros del controlador. Se creará un archivo de registro con un nombre único en el directorio especificado. Si está configurado, habilita el registro del controlador.

Nombre de la aplicación

El nombre de la aplicación que utiliza el controlador. Si se especifica un valor para este parámetro, el valor se incluye en la cadena del agente de usuario de las llamadas a la API que el controlador realiza a Athena.

Prueba de conexión

Si se establece en TRUE, el controlador realiza una prueba de conexión cada vez que se crea una conexión JDBC, incluso si no se ejecuta una consulta en la conexión.

Número de reintentos

Número máximo de veces que el controlador debe volver a enviar una solicitud recuperable a Athena.

Tiempo de espera de la red

El tiempo de espera de conexión es la cantidad de tiempo que el controlador esperará a que se establezca una conexión. Esto incluye el tiempo que se tarda en enviar las solicitudes de API. En raras ocasiones, puede resultar útil cambiar el tiempo de espera de la red. Por ejemplo, puede que desee aumentar el tiempo de espera por si las pausas de recopilación de elementos no utilizados se alargan. Establecer este parámetro de conexión es equivalente a usar el método setNetworkTimeout en un objeto Connection.