# Parámetros de conexión avanzados
<a name="jdbc-v3-driver-advanced-connection-parameters"></a>

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

**Topics**
+ [Parámetros de cifrado de resultado](#jdbc-v3-driver-result-encryption-parameters)
+ [Parámetros de obtención de resultados](#jdbc-v3-driver-result-fetching-parameters)
+ [Parámetros de configuración de resultados](#jdbc-v3-driver-result-config)
+ [Parámetros de reutilización de resultados de las consultas](#jdbc-v3-driver-query-result-reuse-parameters)
+ [Parámetros de sondeo de ejecución de consultas](#jdbc-v3-driver-query-execution-polling-parameters)
+ [Parámetros de invalidación del punto de conexión](#jdbc-v3-driver-endpoint-override-parameters)
+ [Parámetros de configuración del proxy](#jdbc-v3-driver-proxy-configuration-parameters)
+ [Parámetros de registro](#jdbc-v3-driver-logging-parameters)
+ [Nombre de la aplicación](#jdbc-v3-driver-application-name)
+ [Prueba de conexión](#jdbc-v3-driver-connection-test)
+ [Número de reintentos](#jdbc-v3-driver-number-of-retries)
+ [Tiempo de espera de la red](#jdbc-v3-driver-networktimeoutmillis)

## Parámetros de cifrado de resultado
<a name="jdbc-v3-driver-result-encryption-parameters"></a>

Tenga en cuenta los siguientes puntos:
+ La clave AWS KMS debe especificarse cuando `EncryptionOption` es `SSE_KMS` o `CSE_KMS`.
+ La clave AWS KMS no se puede especificar cuando `EncryptionOption` no se especifica o cuando `EncryptionOption` es `SSE_S3`.

### Opciones de cifrado
<a name="jdbc-v3-driver-encryption-option"></a>

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](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html) en la *Referencia de la API de Amazon Athena*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valores posibles | 
| --- | --- | --- | --- | --- | 
| EncryptionOption | S3OutputEncOption (obsoleto) | Opcional | none | SSE\$1S3, SSE\$1KMS, CSE\$1KMS | 

### Clave de KMS
<a name="jdbc-v3-driver-kms-key"></a>

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](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html) en *Referencia de la API de Amazon Athena*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| KmsKey | S3OutputEnckMSKey (obsoleto) | Opcional | none | 

## Parámetros de obtención de resultados
<a name="jdbc-v3-driver-result-fetching-parameters"></a>

### Buscador de resultados
<a name="jdbc-v3-driver-result-fetcher"></a>

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

El buscador de resultados predeterminado, `auto`, descarga los resultados de las consultas directamente desde Amazon S3 sin utilizar las API de Athena. Cuando la descarga directa de S3 no es posible, como, por ejemplo, cuando los resultados de las consultas se cifran con la opción `CSE_KMS`, recurre automáticamente a la API `GetQueryResultsStream`.

Se recomienda usar el buscador `auto` en la mayoría de las situaciones. Si sus políticas de IAM o sus políticas de bucket de S3 utilizan la condición [s3:CalledVia](security-iam-athena-calledvia.md) para limitar el acceso a las solicitudes de objetos de S3 desde Athena, el buscador `auto` primero intenta descargar los resultados de S3 y, a continuación, recurre a utilizar la API `GetQueryResultsStream`. En esta situación, puede configurar el ResultFetcher como `GetQueryResultsStream` para evitar una llamada adicional a la API.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valores posibles | 
| --- | --- | --- | --- | --- | 
| ResultFetcher | none | Opcional | auto | auto, S3, GetQueryResults, GetQueryResultsStream | 

### Tamaño de recuperación
<a name="jdbc-v3-driver-fetch-size"></a>

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


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| FetchSize | RowsToFetchPerBlock (obsoleto) | Opcional | 0 | 
+ El buscador `GetQueryResults` siempre utilizará un tamaño de página de 1000, que es el valor máximo que admite la llamada a la API. Cuando el tamaño de la búsqueda es superior a 1000, se realizan varias llamadas sucesivas a la API para llenar el búfer por encima del mínimo.
+ El buscador `GetQueryResultsStream` utilizará el tamaño de búsqueda configurado como tamaño de página, o 10 000 de forma predeterminada.
+ El buscador `S3` utilizará el tamaño de búsqueda configurado como tamaño de página, o 10 000 de forma predeterminada.

## Parámetros de configuración de resultados
<a name="jdbc-v3-driver-result-config"></a>

### Propietario del bucket esperado
<a name="jdbc-v3-driver-exp-bucket-owner"></a>

ID de la cuenta del propietario del bucket de S3 esperado. Si el ID de la cuenta que proporciona no coincide con el propietario real del bucket, la solicitud fallará. Para obtener más información sobre cómo verificar el propietario del bucket de S3, consulte [Verificación de la propiedad del bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-owner-condition.html#bucket-owner-condition-use).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ExpectedBucketOwner | none | Opcional | none | 

### Opción ACL
<a name="jdbc-v3-driver-acl"></a>

Indica que se debe configurar una ACL predefinida de Amazon S3 para controlar la propiedad de los resultados de las consultas almacenadas. Para obtener más información sobre `AclOption`, consulte [AclConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_AclConfiguration.html).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valores posibles | 
| --- | --- | --- | --- | --- | 
| AclOption | none | Opcional | none | BUCKET\$1OWNER\$1FULL\$1CONTROL | 

## Parámetros de reutilización de resultados de las consultas
<a name="jdbc-v3-driver-query-result-reuse-parameters"></a>

### Habilitar la reutilización de resultados
<a name="jdbc-v3-driver-enable-result-reuse"></a>

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](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| EnableResultReuseByAge | none | Opcional | FALSO | 

### Antigüedad máxima de reutilización de resultados
<a name="jdbc-v3-driver-result-reuse-max-age"></a>

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](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| MaxResultReuseAgeInMinutes | none | Opcional | 60 | 

## Parámetros de sondeo de ejecución de consultas
<a name="jdbc-v3-driver-query-execution-polling-parameters"></a>

### Intervalo mínimo de sondeo de ejecución de consultas
<a name="jdbc-v3-driver-minimum-query-execution-polling-interval"></a>

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


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| MinQueryExecutionPollingIntervalMillis | MinQueryExecutionPollingInterval (obsoleto) | Opcional | 100 | 

### Intervalo máximo de sondeo de ejecución de consultas
<a name="jdbc-v3-driver-maximum-query-execution-polling-interval"></a>

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


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| MaxQueryExecutionPollingIntervalMillis | MaxQueryExecutionPollingInterval (obsoleto) | Opcional | 5000 | 

### Multiplicador del intervalo de sondeo de ejecución de consultas
<a name="jdbc-v3-driver-query-execution-polling-interval-multiplier"></a>

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`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| QueryExecutionPollingIntervalMultiplier | none | Opcional | 2 | 

## Parámetros de invalidación del punto de conexión
<a name="jdbc-v3-driver-endpoint-override-parameters"></a>

### Anulación del punto de conexión de Athena
<a name="jdbc-v3-driver-athena-endpoint-override"></a>

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

Tenga en cuenta los siguientes puntos:
+ Si los protocolos `https://` o `http://` no se especifican en la URL proporcionada, el controlador inserta el prefijo `https://`.
+ Si no se especifica este parámetro, el controlador utiliza un punto de conexión predeterminado.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| AthenaEndpoint | EndpointOverride (obsoleto) | Opcional | none | 

### Anulación del punto de conexión del servicio de transmisión de Athena
<a name="jdbc-v3-driver-athena-streaming-service-endpoint-override"></a>

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:
+ Si los protocolos `https://` o `http://` no se especifican en la URL proporcionada, el controlador inserta el prefijo `https://`.
+ Si no se especifica ningún puerto en la URL proporcionada, el controlador inserta el puerto 444 del servicio de transmisión.
+ Si no se especifica el parámetro `AthenaStreamingEndpoint`, el controlador utiliza la anulación `AthenaEndpoint`. Si no se especifican las anulaciones `AthenaStreamingEndpoint` o `AthenaEndpoint`, el controlador utiliza un punto de conexión de transmisión predeterminado.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| AthenaStreamingEndpoint | StreamingEndpointOverride (obsoleto) | Opcional | none | 

### Anulación del punto de conexión de Lake Formation
<a name="jdbc-v3-driver-athena-lake-formation-endpoint-override"></a>

El punto de conexión que el controlador utilizará para el servicio Lake Formation cuando utilice la API AWS Lake Formation [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) 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:
+ Si los protocolos `https://` o `http://` no se especifican en la URL proporcionada, el controlador inserta el prefijo `https://`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| LakeFormationEndpoint |  LfEndpointOverride (obsoleto)  | Opcional | none | 

### Anulación del punto de conexión S3
<a name="jdbc-v3-driver-athena-s3-endpoint-override"></a>

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:
+ Si los protocolos `https://` o `http://` no se especifican en la URL proporcionada, el controlador inserta el prefijo `https://`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| S3Endpoint | Ninguno | Opcional | none | 

### Anulación del punto de conexión STS
<a name="jdbc-v3-driver-athena-sts-endpoint-override"></a>

El punto de conexión que el controlador utilizará para el servicio AWS STS cuando utilice la API AWS STS [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) 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:
+ Si los protocolos `https://` o `http://` no se especifican en la URL proporcionada, el controlador inserta el prefijo `https://`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| StendPoint | StsEndpointOverride (obsoleto) | Opcional | none | 

### Anulación del punto de conexión SSO OIDC
<a name="jdbc-v3-driver-athena-sso-oidc-endpoint-override"></a>

El punto de conexión que el controlador usará cuando se utilice `ClientConfiguration.endpointOverride` para anular el punto de conexión HTTP predeterminado del cliente SSO OIDC. Para obtener más información, consulte [ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| SSOOIDCEndpointOverride |  | Opcional | none | 

### Anulación del punto de conexión de administración de SSO
<a name="jdbc-v3-driver-athena-sso-admin-endpoint-override"></a>

El punto de conexión que el controlador usará cuando se utilice `ClientConfiguration.endpointOverride` para anular el punto de conexión HTTP predeterminado del cliente SSO Admin. Para obtener más información, consulte [ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| SSOAdminEndpointOverride |  | Opcional | none | 

## Parámetros de configuración del proxy
<a name="jdbc-v3-driver-proxy-configuration-parameters"></a>

### Host del proxy.
<a name="jdbc-v3-driver-proxy-host"></a>

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

**nota**  
 Asegúrese de incluir el protocolo `https://` o `http://` al principio de la URL de `ProxyHost`. 


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ProxyHost | none | Opcional | none | 

### Puerto del proxy.
<a name="jdbc-v3-driver-proxy-port"></a>

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 del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ProxyPort | none | Opcional | none | 

### Nombre de usuario del proxy
<a name="jdbc-v3-driver-proxy-username"></a>

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


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ProxyUsername | ProxyUID (obsoleto) | Opcional | none | 

### Contraseña del proxy.
<a name="jdbc-v3-driver-proxy-password"></a>

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


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ProxyPassword | ProxyPWD (obsoleto) | Opcional | none | 

### Hosts exentos de proxy
<a name="jdbc-v3-driver-proxy-exempt-hosts"></a>

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`).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ProxyExemptHosts | NonProxyHosts | Opcional | none | 

### Proxy habilitado para proveedores de identidad
<a name="jdbc-v3-driver-proxy-enabled-for-identity-providers"></a>

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


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| El proxy está habilitado para el IDP | UseProxyForIdP | Opcional | FALSO | 

## Parámetros de registro
<a name="jdbc-v3-driver-logging-parameters"></a>

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

### Nivel de registro
<a name="jdbc-v3-driver-logging-parameters-log-level"></a>

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

**nota**  
Recomendamos configurar solo el parámetro `LogPath`, a menos que tenga requisitos especiales. Si se establece solo el parámetro `LogPath`, se habilita el registro y se utiliza el nivel de registro predeterminado `TRACE`. El nivel de registro `TRACE` proporciona el registro más detallado.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valores posibles | 
| --- | --- | --- | --- | --- | 
| LogLevel | none | Opcional | SEGUIMIENTO | DESACTIVADO, ERROR, ADVERTENCIA, INFORMACIÓN, DEPURACIÓN, RASTREO | 

### Ruta de registro
<a name="jdbc-v3-driver-logging-parameters-log-path"></a>

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 del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| LogPath | none | Opcional | none | 

## Nombre de la aplicación
<a name="jdbc-v3-driver-application-name"></a>

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.

**nota**  
También puede establecer el nombre de la aplicación llamando `setApplicationName` al objeto `DataSource`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ApplicationName | none | Opcional | none | 

## Prueba de conexión
<a name="jdbc-v3-driver-connection-test"></a>

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.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ConnectionTest | none | Opcional | TRUE | 

**nota**  
Una prueba de conexión envía una consulta `SELECT 1` a Athena para comprobar que la conexión se ha configurado correctamente. Esto significa que se almacenarán dos archivos en Amazon S3 (el conjunto de resultados y los metadatos) y se pueden aplicar cargos adicionales de acuerdo con la política de [precios de Amazon Athena](https://aws.amazon.com/athena/pricing).

## Número de reintentos
<a name="jdbc-v3-driver-number-of-retries"></a>

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


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| NumRetries | MaxErrorRetry (obsoleto) | Opcional | none | 

## Tiempo de espera de la red
<a name="jdbc-v3-driver-networktimeoutmillis"></a>

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`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
|  NetworkTimeoutMillis  | none | Opcional | none |