# Controlador JDBC 3.x de Athena
<a name="jdbc-v3-driver"></a>

Puede utilizar el controlador Athena JDBC para conectarse a Amazon Athena desde distintas aplicaciones y herramientas de cliente SQL de terceros.

## Requisitos del sistema
<a name="jdbc-v3-driver-system-requirements"></a>
+ Entorno de tiempo de ejecución Java 8 (o superior)
+ Contar con al menos 20 MB de espacio disponible en el disco

## Consideraciones y limitaciones
<a name="jdbc-v3-driver-considerations-and-limitations"></a>

A continuación, se presentan algunas consideraciones y limitaciones del controlador Athena JDBC 3.x.
+ **Registro**: el controlador 3.x utiliza [SLF4J](https://www.slf4j.org/manual.html), que es una capa de abstracción que permite el uso de algunos sistemas de registro en tiempo de ejecución.
+ **Cifrado**: al utilizar el buscador de Amazon S3 con la opción de cifrado `CSE_KMS`, el cliente de Amazon S3 no puede descifrar el resultado almacenado en el bucket de Amazon S3. Si necesita cifrado `CSE_KMS`, puede seguir utilizando el buscador de transmisiones. Se prevé habilitar soporte para el cifrado `CSE_KMS` con el buscador de Amazon S3.

## Descarga del controlador JDBC 3.x
<a name="jdbc-v3-driver-download"></a>

Esta sección contiene información sobre la descarga y la licencia del controlador JDBC 3.x.

**importante**  
Cuando utilice el controlador JDBC 3.x, 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 conexión de PrivateLink para conectarse a Athena, asegúrese de que el grupo de seguridad asociado al punto de conexión de PrivateLink esté abierto al tráfico entrante en el puerto 444. 
**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 transmisión. Para ver una política de ejemplo, consulte [AWSPolítica administrada de : AWSQuicksightAthenaAccess](security-iam-awsmanpol.md#awsquicksightathenaaccess-managed-policy). 

Para descargar el controlador JDBC 3.x de Amazon Athena, visite los siguientes enlaces.

### Controlador uber jar JDBC
<a name="jdbc-v3-driver-download-uber-jar"></a>

La siguiente descarga empaqueta el controlador y todas sus dependencias en el mismo archivo `.jar`. Esta descarga se suele utilizar para clientes SQL de terceros.

[3.7.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.7.0/athena-jdbc-3.7.0-with-dependencies.jar)

### Controlador lean jar JDBC
<a name="jdbc-v3-driver-download-lean-jar"></a>

La siguiente descarga es un archivo `.zip` que contiene la versión lean `.jar` del controlador y archivos `.jar` separados para las dependencias del controlador. Esta descarga se suele utilizar para aplicaciones personalizadas que pueden tener dependencias que entren en conflicto con las dependencias que utiliza el controlador. Esta descarga resulta útil si desea elegir qué dependencias de controladores desea incluir en el lean jar y cuáles excluir si la aplicación personalizada ya contiene una o más de ellas.

[3.7.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.7.0/athena-jdbc-3.7.0-lean-jar-and-separate-dependencies-jars.zip)

### Licencia
<a name="jdbc-v3-driver-license"></a>

El siguiente enlace contiene el acuerdo de licencia del controlador JDBC 3.x.

[Licencia](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.7.0/LICENSE.txt)

## Propagación de identidad de confianza con JDBC
<a name="jdbc-v3-driver-trusted-identity"></a>

Ahora se puede conectar a Amazon Athena mediante controladores JDBC con capacidades de inicio de sesión único a través de AWS Identity and Access Management Identity Center. Al acceder a Athena desde herramientas como Power BI, Tableau o DBeaver, la identidad y los permisos se propagan automáticamente a Athena a través de IAM Identity Center. Para obtener más información, consulte [Uso de la propagación de identidad de confianza con controladores de Amazon Athena](using-trusted-identity-propagation.md).

**Topics**
+ [Requisitos del sistema](#jdbc-v3-driver-system-requirements)
+ [Consideraciones y limitaciones](#jdbc-v3-driver-considerations-and-limitations)
+ [Descarga del controlador JDBC 3.x](#jdbc-v3-driver-download)
+ [Propagación de identidad de confianza con JDBC](#jdbc-v3-driver-trusted-identity)
+ [Introducción al controlador JDBC 3.x](jdbc-v3-driver-getting-started.md)
+ [Parámetros de conexión JDBC 3.x de Amazon Athena](jdbc-v3-driver-connection-parameters.md)
+ [Otra configuración de JDBC 3.x](jdbc-v3-driver-other-configuration.md)
+ [Notas de la versión de JDBC 3.x de Amazon Athena](jdbc-v3-driver-release-notes.md)
+ [Versiones anteriores del controlador JDBC 3.x de Athena](jdbc-v3-driver-previous-versions.md)

# Introducción al controlador JDBC 3.x
<a name="jdbc-v3-driver-getting-started"></a>

Utilice la información de esta sección para empezar a usar el controlador JDBC 3.x de Amazon Athena.

**Topics**
+ [Instrucciones de instalación](#jdbc-v3-driver-installation-instructions)
+ [Ejecución del controlador](#jdbc-v3-driver-running-the-driver)
+ [Configuración del controlador](#jdbc-v3-driver-configuring-the-driver)
+ [Actualización desde el controlador Athena JDBC v2](#jdbc-v3-driver-upgrading-from-the-athena-jdbc-v2-driver-to-v3)

## Instrucciones de instalación
<a name="jdbc-v3-driver-installation-instructions"></a>

Puede utilizar el controlador JDBC 3.x en una aplicación personalizada o desde un cliente SQL de terceros.

### En una aplicación personalizada
<a name="jdbc-v3-driver-installation-in-a-custom-application"></a>

Descargue el archivo `.zip` que contiene el archivo jar del controlador y sus dependencias. Cada dependencia tiene su propio archivo `.jar`. Agregue el archivo jar del controlador como una dependencia en la aplicación personalizada. Agregue de forma selectiva las dependencias del contenedor de controladores en función de si ya las ha agregado a su aplicación desde otra fuente.

### En un cliente SQL de terceros
<a name="jdbc-v3-driver-installation-in-a-third-party-sql-client"></a>

Descargue el archivo uber jar del controlador y agréguelo al cliente SQL de terceros siguiendo las instrucciones de ese cliente.

## Ejecución del controlador
<a name="jdbc-v3-driver-running-the-driver"></a>

Para ejecutar el controlador, puede utilizar una aplicación personalizada o un cliente SQL de terceros.

### En una aplicación personalizada
<a name="jdbc-v3-driver-running-in-a-custom-application"></a>

Utilice la interfaz de JDBC para interactuar con el controlador JDBC desde un programa. El siguiente código muestra un ejemplo de aplicación Java personalizada.

```
public static void main(String args[]) throws SQLException {
    Properties connectionParameters = new Properties();
    connectionParameters.setProperty("Workgroup", "primary");
    connectionParameters.setProperty("Region", "us-east-2");
    connectionParameters.setProperty("Catalog", "AwsDataCatalog");
    connectionParameters.setProperty("Database","sampledatabase");
    connectionParameters.setProperty("OutputLocation","s3://amzn-s3-demo-bucket");
    connectionParameters.setProperty("CredentialsProvider","DefaultChain");
    String url = "jdbc:athena://";
    AthenaDriver driver = new AthenaDriver();
    Connection connection = driver.connect(url, connectionParameters);
    Statement statement = connection.createStatement();
    String query = "SELECT * from sample_table LIMIT 10";
    ResultSet resultSet = statement.executeQuery(query);
    printResults(resultSet); // A custom-defined method for iterating over a
                             // result set and printing its contents
}
```

### En un cliente SQL de terceros
<a name="jdbc-v3-driver-running-in-a-third-party-sql-client"></a>

Siga la documentación del cliente SQL que esté utilizando. Normalmente, se utiliza la interfaz gráfica de usuario del cliente SQL para introducir y enviar la consulta, y los resultados de la consulta se muestran en la misma interfaz.

## Configuración del controlador
<a name="jdbc-v3-driver-configuring-the-driver"></a>

Puede usar los parámetros de conexión para configurar el controlador JDBC de Amazon Athena. Para obtener información sobre los parámetros de conexión compatibles, consulte [Parámetros de conexión JDBC 3.x de Amazon Athena](jdbc-v3-driver-connection-parameters.md).

### En una aplicación personalizada
<a name="jdbc-v3-driver-configuring-in-a-custom-application"></a>

Para configurar los parámetros de conexión del controlador JDBC en una aplicación personalizada, realice una de las siguientes acciones:
+ Añada los nombres de los parámetros y sus valores a un objeto `Properties`. Cuando llame a `Connection#connect`, pase ese objeto junto con la URL. Por ejemplo, consulte la aplicación de muestra Java en [Ejecución del controlador](#jdbc-v3-driver-running-the-driver).
+ En la cadena de conexión (la URL), utilice el siguiente formato para añadir los nombres de los parámetros y sus valores directamente después del prefijo del protocolo.

  ```
  <parameterName>=<parameterValue>;
  ```

  Utilice un punto y coma al final de cada par de nombre y valor de parámetro y no deje ningún espacio en blanco después del punto y coma, como en el siguiente ejemplo.

  ```
  String url = "jdbc:athena://WorkGroup=primary;Region=us-east-1;...;";AthenaDriver driver = new AthenaDriver();Connection connection = driver.connect(url, null);
  ```
**nota**  
Si se especifica un parámetro tanto en la cadena de conexión como en el objeto `Properties`, el valor de la cadena de conexión tiene prioridad. No se recomienda especificar el mismo parámetro en ambos lugares.
+ Agregue los valores de los parámetros como argumentos a los métodos de `AthenaDataSource`, como en el siguiente ejemplo.

  ```
  AthenaDataSource dataSource = new AthenaDataSource();
      dataSource.setWorkGroup("primary");
      dataSource.setRegion("us-east-2");
      ...
      Connection connection = dataSource.getConnection();
      ...
  ```

### En un cliente SQL de terceros
<a name="jdbc-v3-driver-configuring-in-a-third-party-sql-client"></a>

Siga las instrucciones del cliente SQL que esté utilizando. Normalmente, el cliente proporciona una interfaz gráfica de usuario para introducir los nombres de los parámetros y sus valores.

## Actualización desde el controlador Athena JDBC v2
<a name="jdbc-v3-driver-upgrading-from-the-athena-jdbc-v2-driver-to-v3"></a>

La mayoría de los parámetros de conexión de la versión 3 de JDBC son compatibles con versiones anteriores de la versión 2 (Simba) del controlador JDBC. Esto significa que una cadena de conexión de la versión 2 se puede reutilizar con la versión 3 del controlador. Sin embargo, algunos parámetros de conexión han cambiado. Estos cambios se describen aquí. Cuando actualice a la versión 3 del controlador JDBC, actualice la configuración existente si es necesario.

### Clase de controlador
<a name="jdbc-v3-driver-upgrading-driver-class"></a>

Algunas herramientas de BI le piden que proporcione la clase de controlador del archivo del controlador JDBC `.jar`. La mayoría de las herramientas encuentran esta clase automáticamente. El nombre completo de la clase en el controlador de la versión 3 es `com.amazon.athena.jdbc.AthenaDriver`. En el controlador de la versión 2, la clase era `com.simba.athena.jdbc.Driver`.

### Cadena de conexión
<a name="jdbc-v3-driver-upgrading-connection-string"></a>

El controlador de la versión 3 utiliza `jdbc:athena://` para el protocolo al principio de la URL de la cadena de conexión de JDBC. El controlador de la versión 3 también es compatible con el protocolo de la versión 2 de `jdbc:awsathena://`; sin embargo, el uso del protocolo de la versión 2 está obsoleto. Para evitar comportamientos indefinidos, la versión 3 no acepta cadenas de conexión que comiencen con `jdbc:awsathena://` si la versión 2 (o cualquier otro controlador que acepte cadenas de conexión que comiencen con `jdbc:awsathena://`) se registró en la clase [DriverManager](https://docs.oracle.com/javase/8/docs/api/java/sql/DriverManager.html).

### Proveedores de credenciales
<a name="jdbc-v3-driver-upgrading-credentials-providers"></a>

El controlador de la versión 2 utiliza nombres totalmente cualificados para identificar a los distintos proveedores de credenciales (por ejemplo, `com.simba.athena.amazonaws.auth.DefaultAWSCredentialsProviderChain`. El controlador de la versión 3 utiliza nombres más cortos (por ejemplo, `DefaultChain`). Los nuevos nombres se describen en las secciones correspondientes de cada proveedor de credenciales.

Los proveedores de credenciales personalizadas escritos para la versión 2 del controlador deben modificarse para que la versión 3 del controlador implemente la interfaz [AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html) desde el nuevo AWS SDK para Java en lugar de la interfaz [AWSCredentialsProvider](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/AWSCredentialsProvider.html) del AWS SDK para Java anterior.

El `PropertiesFileCredentialsProvider` no es compatible con el controlador JDBC 3.x. El proveedor se utilizó en el controlador JDBC 2.x, pero pertenece a la versión anterior del AWS SDK para Java, que está a punto de finalizar su período de soporte. Para lograr la misma funcionalidad en el controlador JDBC 3.x, utilice el proveedor [Credenciales del perfil de configuración AWS](jdbc-v3-driver-aws-configuration-profile-credentials.md) en su lugar.

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

En la siguiente tabla se muestran las diferencias en los parámetros `LogLevel` de los controladores JDBC de la versión 2 y la versión 3.


****  

| Versión del controlador JDBC | Nombre del parámetro | Tipo de parámetro | Predeterminado | Valores posibles | Ejemplo de la cadena de conexión | 
| --- | --- | --- | --- | --- | --- | 
| v2 | LogLevel | Opcional | 0 | De 0 a 6 | LogLevel=6; | 
| v3 | LogLevel | Opcional | SEGUIMIENTO | DESACTIVADO, ERROR, ADVERTENCIA, INFORMACIÓN, DEPURACIÓN, RASTREO | LogLevel=INFO; | 

### Recuperación del ID de consulta
<a name="jdbc-v3-driver-upgrading-query-id-retrieval"></a>

En el controlador de la versión 2, se desempaqueta una instancia `Statement` en `com.interfaces.core.IStatementQueryInfoProvider`, que es una interfaz que tiene dos métodos: `#getPReparedQueryId` y `#getQueryId`. Puedes usar estos métodos para obtener el identificador de ejecución de una consulta que se ha ejecutado.

En el controlador de la versión 3, desempaquete las instancias `Statement`, `PreparedStatement`, y `ResultSet` en la interfaz `com.amazon.athena.jdbc.AthenaResultSet`. La interfaz tiene un método: `#getQueryExecutionId`.

# Parámetros de conexión JDBC 3.x de Amazon Athena
<a name="jdbc-v3-driver-connection-parameters"></a>

Los parámetros de conexión compatibles se dividen aquí en tres secciones: [Parámetros de conexión básicos](jdbc-v3-driver-basic-connection-parameters.md), [Parámetros de conexión avanzados](jdbc-v3-driver-advanced-connection-parameters.md) y [Parámetros de conexión de autenticación](jdbc-v3-driver-authentication-connection-parameters.md). Las secciones Parámetros de conexión avanzados y Parámetros de conexión de autenticación tienen subsecciones que agrupan parámetros relacionados.

**Topics**
+ [Parámetros de conexión básicos](jdbc-v3-driver-basic-connection-parameters.md)
+ [Parámetros de conexión avanzados](jdbc-v3-driver-advanced-connection-parameters.md)
+ [Parámetros de conexión de autenticación](jdbc-v3-driver-authentication-connection-parameters.md)

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

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

## Región
<a name="jdbc-v3-driver-region"></a>

El lugar Región de AWS donde se ejecutarán las consultas. Para obtener una lista de las regiones, consulte [Puntos de conexión y cuotas de Amazon Athena](https://docs.aws.amazon.com/general/latest/gr/athena.html).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Región | AwsRegion (obsoleto) | Obligatorio (pero si no se proporciona, se buscará mediante la cadena [DefaultAWSRegionProviderChain](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/regions/providers/DefaultAwsRegionProviderChain.html))  | none | 

## Catálogo
<a name="jdbc-v3-driver-catalog"></a>

El catálogo que contiene las bases de datos y las tablas a las que se accederá con el controlador. Para obtener más información sobre los catálogos, consulte [DataCatalog](https://docs.aws.amazon.com/athena/latest/APIReference/API_DataCatalog.html).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Catálogo | none | Opcional | AwsDataCatalog | 

## Database
<a name="jdbc-v3-driver-database"></a>

La base de datos en la que se ejecutarán las consultas. Las tablas que no estén calificadas explícitamente con un nombre de base de datos se resuelven en esta base de datos. Para obtener información sobre las bases de datos, consulte [Base de datos](https://docs.aws.amazon.com/athena/latest/APIReference/API_Database.html).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Database | Esquema | Opcional | predeterminado | 

## Grupo de trabajo
<a name="jdbc-v3-driver-workgroup"></a>

El grupo de trabajo en el que se ejecutarán las consultas. Para obtener información acerca de los grupos de trabajo, consulte [Grupo de trabajo](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html).


****  

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

## Ubicación de salida
<a name="jdbc-v3-driver-output-location"></a>

Especifica la ubicación en Amazon S3 en la que se almacenan los resultados de las consultas. Para obtener información sobre la ubicación de las salidas, consulte [ResultConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultConfiguration.html).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| OutputLocation | S3OutputLocation (obsoleto) | Obligatorio (a menos que el grupo de trabajo especifique una ubicación de salida) | none | 

# 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 | 

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

El controlador Athena JDBC 3.x admite varios métodos de autenticación. Los parámetros de conexión necesarios dependen del método de autenticación que utilice.

**Topics**
+ [IAM](jdbc-v3-driver-iam-credentials.md)
+ [Predeterminado](jdbc-v3-driver-default-credentials.md)
+ [Perfil de configuración AWS](jdbc-v3-driver-aws-configuration-profile-credentials.md)
+ [Perfil de instancia](jdbc-v3-driver-instance-profile-credentials.md)
+ [Personalizado](jdbc-v3-driver-custom-credentials.md)
+ [JWT](jdbc-v3-driver-jwt-credentials.md)
+ [Propagación de identidad de confianza con JWT](jdbc-v3-driver-jwt-tip-credentials.md)
+ [Propagación de identidades de confianza del navegador](jdbc-v3-driver-browser-oidc-tip-credentials.md)
+ [Azure AD](jdbc-v3-driver-azure-ad-credentials.md)
+ [Okta](jdbc-v3-driver-okta-credentials.md)
+ [Ping](jdbc-v3-driver-ping-credentials.md)
+ [AD FS](jdbc-v3-driver-adfs-credentials.md)
+ [Browser Azure AD](jdbc-v3-driver-browser-azure-ad-credentials.md)
+ [Browser SAML](jdbc-v3-driver-browser-saml-credentials.md)
+ [IdC para DataZone](jdbc-v3-driver-datazone-idc.md)
+ [IAM para DataZone](jdbc-v3-driver-datazone-iamcp.md)

# Credenciales de IAM
<a name="jdbc-v3-driver-iam-credentials"></a>

Puede utilizar sus credenciales de IAM con el controlador JDBC para conectarse a Amazon Athena configurando los siguientes parámetros de conexión.

## Usuario
<a name="jdbc-v3-driver-user"></a>

El ID de la clave de acceso de AWS. Para obtener más información sobre las claves de acceso, consulte las [credenciales de seguridad de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) en la *Guía del usuario de IAM*


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Usuario | AccessKeyId | Obligatorio | none | 

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

ID de su clave secreta de AWS. Para obtener más información sobre las claves de acceso, consulte las [credenciales de seguridad de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) en la *Guía del usuario de IAM*


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Contraseña | SecretAccessKey | Opcional | none | 

## Token de sesión
<a name="jdbc-v3-driver-session-token"></a>

Si utiliza credenciales de AWS temporales, debe especificar el token de sesión. Para obtener información acerca de las credenciales temporales, consulte [Credenciales de seguridad temporales en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) en la *Guía del usuario de IAM*.


****  

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

# Credenciales predeterminadas
<a name="jdbc-v3-driver-default-credentials"></a>

Puede utilizar las credenciales predeterminadas que configure en su sistema cliente para conectarse a Amazon Athena configurando los siguientes parámetros de conexión. Para obtener información sobre el uso de las credenciales predeterminadas, consulte [Uso de la cadena de proveedores de credenciales predeterminadas](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html#credentials-default) en la *Guía para desarrolladores de AWS SDK para Java*.

## Proveedor de credenciales
<a name="jdbc-v3-driver-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor del parámetro en `DefaultChain`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | DefaultChain | 

# Credenciales del perfil de configuración AWS
<a name="jdbc-v3-driver-aws-configuration-profile-credentials"></a>

Puede utilizar las credenciales almacenadas en un perfil de configuración de AWS configurando los siguientes parámetros de conexión. Los perfiles de configuración de AWS se almacenan normalmente en archivos del directorio `~/.aws`). Para obtener información sobre los perfiles de configuración AWS, consulte [Uso de perfiles](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/credentials-profiles.html) en la *Guía para desarrolladores de AWS SDK para Java*.

## Proveedor de credenciales
<a name="jdbc-v3-driver-aws-configuration-profile-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor del parámetro en `ProfileCredentials`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | ProfileCredentials | 

## Profile name (Nombre de perfil)
<a name="jdbc-v3-driver-profile-name"></a>

El nombre del perfil de configuración de AWS cuyas credenciales deben usarse para autenticar la solicitud a Athena.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ProfileName | none | Obligatorio | none | 

**nota**  
El nombre del perfil también se puede especificar como el valor del parámetro `CredentialsProviderArguments`, aunque está en desuso.

# Credenciales del perfil de instancia
<a name="jdbc-v3-driver-instance-profile-credentials"></a>

Este tipo de autenticación se utiliza en instancias de Amazon EC2. Un *perfil de instancia* es un perfil adjunto a una instancia de Amazon EC2. El uso de un proveedor de credenciales de perfil de instancia delega la administración de las credenciales de AWS al Servicio de metadatos de instancias de Amazon EC2. Esto elimina la necesidad de que los desarrolladores almacenen en credenciales de forma permanente en la instancia de Amazon EC2 o se preocupen de rotar o administrar credenciales temporales.

## Proveedor de credenciales
<a name="jdbc-v3-driver-instance-profile-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor del parámetro en `InstanceProfile`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | InstanceProfile | 

# Credenciales personalizadas
<a name="jdbc-v3-driver-custom-credentials"></a>

Puede usar este tipo de autenticación para proporcionar sus propias credenciales mediante una clase Java que implemente la interfaz [AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html).

## Proveedor de credenciales
<a name="jdbc-v3-driver-custom-credentials-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor de este parámetro en el nombre de clase completo de la clase personalizada que implementa la interfaz [AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html). En tiempo de ejecución, esa clase debe estar en la ruta de clases de Java de la aplicación que usa el controlador JDBC.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | El nombre de clase completo de la implementación personalizada de AwsCredentialsProvider | 

## Argumentos del proveedor de credenciales
<a name="jdbc-v3-driver-credentials-provider-arguments"></a>

Lista separada por comas de argumentos de cadena para el constructor del proveedor de credenciales personalizadas.


****  

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

# Credenciales JWT
<a name="jdbc-v3-driver-jwt-credentials"></a>

Con este tipo de autenticación, puede utilizar un token web JSON (JWT) obtenido de un proveedor de identidad externo como parámetro de conexión para autenticarse con Athena. El proveedor externo de credenciales ya debe estar federado con AWS.

## Proveedor de credenciales
<a name="jdbc-v3-driver-jwt-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor del parámetro en `JWT`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | JWT | 

## Token de identidad web JWT
<a name="jdbc-v3-driver-jwt-web-identity-token"></a>

El token JWT obtenido de un proveedor de identidad federado externo. Este token se utilizará para autenticarse con Athena.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| JwtWebIdentityToken | web\$1identity\$1token (obsoleto) | Obligatorio | none | 

## Rol ARN de JWT
<a name="jdbc-v3-driver-jwt-role-arn"></a>

El nombre de recurso de Amazon (ARN) del rol que se asignará. Para obtener información acerca de los roles de ARN, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| JwtRoleArn | role\$1arn (obsoleto) | Obligatorio | none | 

## Nombre de sesión del rol JWT
<a name="jdbc-v3-driver-jwt-role-session-name"></a>

El nombre de la sesión cuando se utilizan las credenciales de JWT para la autenticación. El nombre puede ser cualquier nombre que usted elija.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| JwtRoleSessionName | role\$1session\$1name (obsoleto) | Obligatorio | none | 

## Duración de la sesión de rol
<a name="jdbc-v3-driver-jwt-role-session-duration"></a>

La duración de la sesión del rol en segundos. Para obtener más información, consulte [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duración (obsoleto) | Opcional | 3600 | 

# Integración de JWT con Identity Center
<a name="jdbc-v3-driver-jwt-tip-credentials"></a>

Este tipo de autenticación permite usar un JSON Web Token (JWT) obtenido de un proveedor de identidades externo como parámetro de conexión para autenticarse con Athena. Se puede usar este complemento para habilitar la compatibilidad con identidades corporativas mediante la propagación de identidad de confianza. Para obtener más información sobre cómo utilizar la propagación de identidad de confianza con controladores, consulte [Uso de la propagación de identidad de confianza con controladores de Amazon Athena](using-trusted-identity-propagation.md). También puede [configurar e implementar recursos mediante CloudFormation](using-trusted-identity-propagation-cloudformation.md).

Con la propagación de identidad de confianza, se agrega el contexto de identidad a un rol de IAM para identificar al usuario que solicita acceso a los recursos de AWS. Para obtener información sobre cómo habilitar y usar la propagación de identidad de confianza, consulte [¿Qué es la propagación de identidad de confianza?](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation.html).

## Proveedor de credenciales
<a name="jdbc-v3-driver-jwt-tip-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor del parámetro en `JWT_TIP`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | JWT\$1TIP | 

## Token de identidad web JWT
<a name="jdbc-v3-driver-jwt-tip-web-identity-token"></a>

El token JWT obtenido de un proveedor de identidad federado externo. Este token se utilizará para autenticarse con Athena. El almacenamiento en caché de tokens está habilitado de forma predeterminada y permite usar el mismo token de acceso de Identity Center en las conexiones del controlador. Se recomienda proporcionar un token JWT nuevo al “probar la conexión”, ya que el token intercambiado solo está presente mientras la instancia del controlador esté activa.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| JwtWebIdentityToken | web\$1identity\$1token (obsoleto) | Obligatorio | none | 

## WorkgroupArn
<a name="jdbc-v3-driver-jwt-tip-workgroup-arn"></a>

El nombre de recurso de Amazon (ARN) del grupo de trabajo de Amazon Athena. Para obtener información acerca de los grupos de trabajo, consulte [Grupo de trabajo](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| WorkGroupArn | none | Obligatorio | primario | 

## ARN de rol de aplicación JWT
<a name="jdbc-v3-driver-jwt-tip-application-role-arn"></a>

ARN del rol que se va a adoptar. Este rol se utiliza para el intercambio de JWT, la obtención del ARN de la aplicación administrada por el cliente de IAM Identity Center mediante etiquetas de grupos de trabajo y la obtención del ARN de rol de acceso. Para obtener más información sobre cómo asumir roles, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ApplicationRoleArn | none | Obligatorio | none | 

## Nombre de sesión del rol JWT
<a name="jdbc-v3-driver-jwt-tip-role-session-name"></a>

El nombre de la sesión al autenticarse con credenciales JWT. Puede elegir cualquier nombre.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| JwtRoleSessionName | role\$1session\$1name (obsoleto) | Obligatorio | none | 

## Duración de la sesión de rol
<a name="jdbc-v3-driver-jwt-tip-session-duration"></a>

La duración de la sesión del rol en segundos. Para obtener más información, consulte [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duración (obsoleto) | Opcional | 3600 | 

## ARN del rol de acccceso JWT
<a name="jdbc-v3-driver-jwt-tip-access-role-arn"></a>

ARN del rol que se va a adoptar. Este es el rol que asume el servicio de Athena para realizar llamadas en su nombre. Para obtener más información sobre cómo asumir roles, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

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

## ARN de la aplicación administrada por el cliente de IAM Identity Center
<a name="jdbc-v3-driver-jwt-tip-customer-idc-application-arn"></a>

El ARN de la aplicación administrada por el cliente de IAM Identity Center. Para obtener más información, consulte [aplicaciones administradas por el cliente](https://docs.aws.amazon.com/singlesignon/latest/userguide/customermanagedapps.html).


****  

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

# Basado en navegador con la integración de Identity Center
<a name="jdbc-v3-driver-browser-oidc-tip-credentials"></a>

Este tipo de autenticación permite obtener un nuevo token web JSON (JWT) de un proveedor de identidades externo y se autentica con Athena. Se puede usar este complemento para habilitar la compatibilidad con identidades corporativas mediante la propagación de identidad de confianza. Para obtener más información sobre cómo utilizar la propagación de identidad de confianza con controladores, consulte [Uso de la propagación de identidad de confianza con controladores de Amazon Athena](using-trusted-identity-propagation.md). También puede [configurar e implementar recursos mediante CloudFormation](using-trusted-identity-propagation-cloudformation.md).

Con la propagación de identidad de confianza, se agrega el contexto de identidad a un rol de IAM para identificar al usuario que solicita acceso a los recursos de AWS. Para obtener información sobre cómo habilitar y usar la propagación de identidad de confianza, consulte [¿Qué es la propagación de identidad de confianza?](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation.html).

**nota**  
El complemento está diseñado específicamente para entornos de escritorio de un solo usuario. En entornos compartidos como Windows Server, los administradores del sistema son responsables de establecer y mantener los límites de seguridad entre los usuarios.

## Proveedor de credenciales
<a name="jdbc-v3-driver-browser-oidc-tip-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor del parámetro en `BrowserOidcTip`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | BrowserOidcTip | 

## URL de configuración conocida de IdP
<a name="jdbc-v3-driver-browser-oidc-tip-idp-well-known-config"></a>

La URL de configuración conocida de IdP es el punto de conexión que proporciona los detalles de configuración de OpenID Connect para su proveedor de identidades. Por lo general, esta URL termina por `.well-known/openid-configuration` y contiene metadatos esenciales sobre los puntos de conexión de autenticación, las características compatibles y las claves de firma de token. Por ejemplo, si utiliza *Okta*, la URL podría tener este aspecto: `https://your-domain.okta.com/.well-known/openid-configuration`.

Para solucionar problemas: si recibe errores de conexión, compruebe que se puede acceder a esta URL desde su red y que devuelva un JSON de configuración de *OpenID Connect* válido. El cliente en el que esté instalado el controlador debe poder acceder a la URL y debe proporcionarla el administrador del proveedor de identidades.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| IdpWellKnownConfigurationUrl | none | Obligatorio | none | 

## Identificador de clientes
<a name="jdbc-v3-driver-browser-oidc-tip-client-id"></a>

El identificador de clientes emitido a la aplicación por el proveedor de OpenID Connect.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| OidcClientId | none | Obligatorio | none | 

## WorkgroupArn
<a name="jdbc-v3-driver-browser-oidc-tip-workgroup-arn"></a>

El nombre de recurso de Amazon (ARN) del grupo de trabajo de Amazon Athena que contiene las etiquetas de configuración de propagación de identidades de confianza. Para obtener información acerca de los grupos de trabajo, consulte [Grupo de trabajo](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html). 

**nota**  
Este parámetro es diferente del parámetro `Workgroup` que especifica dónde se ejecutarán las consultas. Debe establecer ambos parámetros:  
`WorkgroupArn`: señala el grupo de trabajo que contiene las etiquetas de configuración de propagación de identidades de confianza.
`Workgroup`: especifica el grupo de trabajo en el que se ejecutarán las consultas.
Si bien suelen hacer referencia al mismo grupo de trabajo, ambos parámetros deben configurarse de forma explícita para que funcionen correctamente.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| WorkGroupArn | none | Obligatorio | primario | 

## ARN de rol de aplicación JWT
<a name="jdbc-v3-driver-browser-oidc-tip-application-role-arn"></a>

El ARN del rol que se asumirá en el intercambio de JWT. Este rol se utiliza para el intercambio de JWT, la obtención del ARN de la aplicación administrada por el cliente de IAM Identity Center mediante etiquetas de grupos de trabajo y la obtención del ARN de rol de acceso. Para obtener más información sobre cómo asumir roles, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html). 


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ApplicationRoleArn | none | Obligatorio | none | 

## Nombre de sesión del rol JWT
<a name="jdbc-v3-driver-browser-oidc-tip-role-session-name"></a>

Un nombre para la sesión de IAM. Puede ser cualquier valor, pero normalmente se transfiere el nombre o identificador asociado con el usuario que utiliza la aplicación. De esa manera, las credenciales de seguridad temporales que la aplicación usará se asocian con ese usuario. 


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| JwtRoleSessionName | role\$1session\$1name (obsoleto) | Obligatorio | none | 

## Secreto del cliente
<a name="jdbc-v3-driver-browser-oidc-tip-client-secret"></a>

El clientSecret es una clave confidencial emitida por su proveedor de identidades que se utiliza para autenticar su aplicación (cliente). Si bien este parámetro es opcional y puede que no sea obligatorio para todos los flujos de autenticación, proporciona una capa de seguridad adicional cuando se usa. Si la configuración de su IDP requiere un secreto de cliente, debe incluir este parámetro con el valor proporcionado por el administrador del proveedor de identidades.


****  

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

## Ámbito
<a name="jdbc-v3-driver-browser-oidc-tip-scope"></a>

El ámbito especifica el nivel de acceso que la aplicación solicita al proveedor de identidades. Debe incluir `openid` en el ámbito para recibir un token de ID que contenga las notificaciones de identidad esenciales del usuario. Es posible que el ámbito deba incluir permisos adicionales, como `email` o `profile`, según en qué notificaciones de usuario esté configurado su proveedor de identidades (como *Microsoft Entra ID*) para incluir en el token de ID. Estas notificaciones son esenciales para una asignación adecuada de la *propagación de identidades de confianza*. Si la asignación de identidades de los usuarios no funciona, compruebe que su ámbito incluya todos los permisos necesarios y que su proveedor de identidades esté configurado para incluir las notificaciones necesarias en el token de ID. Estas notificaciones deben coincidir con la configuración de asignación de *emisores de tokens de confianza* en IAM Identity Center. 


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Ámbito | none | Opcional | openid email offline\$1access | 

## Duración de la sesión de rol
<a name="jdbc-v3-driver-browser-oidc-tip-role-session-duration"></a>

La duración de la sesión del rol en segundos. Para obtener más información, consulte [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duración (obsoleto) | Opcional | 3600 | 

## ARN del rol de acccceso JWT
<a name="jdbc-v3-driver-browser-oidc-tip-access-role-arn"></a>

El ARN del rol que Athena asume para realizar llamadas en su nombre. Para obtener más información sobre cómo asumir roles, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*. 


****  

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

## ARN de la aplicación administrada por el cliente de IAM Identity Center
<a name="jdbc-v3-driver-browser-oidc-tip-customer-idc-application-arn"></a>

El ARN de la aplicación administrada por el cliente de IAM Identity Center. Para obtener más información, consulte [aplicaciones administradas por el cliente](https://docs.aws.amazon.com/singlesignon/latest/userguide/customermanagedapps.html).


****  

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

## Número del puerto del proveedor de identidades
<a name="jdbc-v3-driver-browser-oidc-tip-idp-port-number"></a>

El número de puerto local que se utilizará para el servidor de devolución de llamadas de OAuth 2.0. Se usa como redirect\$1uri y tendrá que incluirlo en una lista de permisos en su aplicación de IdP. El redirect\$1uri generado de forma predeterminada es: http://localhost:7890/athena

**aviso**  
En entornos compartidos, como servidores de terminales Windows o servicios de escritorio remoto, el puerto de bucle invertido (valor predeterminado: 7890) se comparte entre todos los usuarios de la misma máquina. Los administradores de sistemas pueden mitigar los posibles riesgos de secuestro de puertos de la siguiente manera:  
Configuración de diferentes números de puerto para diferentes grupos de usuarios
Uso de las políticas de seguridad de Windows para restringir el acceso a los puertos
Implementación del aislamiento de la red entre las sesiones de usuario
Si estos controles de seguridad no se pueden implementar, recomendamos utilizar en su lugar el complemento de [propagación de identidades de confianza de JWT](jdbc-v3-driver-jwt-tip-credentials.md), que no requiere un puerto de bucle invertido.


****  

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

## Tiempo de respuesta del proveedor de identidad
<a name="jdbc-v3-driver-browser-oidc-tip-idp-response-timeout"></a>

El tiempo de espera en segundos para esperar la respuesta de devolución de llamada de OAuth 2.0.


****  

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

## Activar el almacenamiento en caché de tokens
<a name="jdbc-v3-driver-browser-oidc-tip-enable-token-caching"></a>

El parámetro EnableTokenCaching determina si el controlador almacena en caché el token de autenticación entre conexiones. Si se establece EnableTokenCaching en true, se reducen las peticiones de autenticación y se mejora la experiencia del usuario, pero se debe utilizar con precaución. Esta configuración es la más adecuada para entornos de escritorio de un solo usuario. En entornos compartidos, como Windows Server, se recomienda mantener esta opción deshabilitada para evitar el posible intercambio de tokens entre usuarios con cadenas de conexión similares. 

Para las implementaciones empresariales que utilizan herramientas como Tableau Server, recomendamos utilizar el complemento de [propagación de identidades de confianza de JWT](jdbc-v3-driver-jwt-tip-credentials.md) en lugar de este método de autenticación. 


****  

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

# Credenciales de Azure AD
<a name="jdbc-v3-driver-azure-ad-credentials"></a>

Un mecanismo de autenticación basado en SAML que permite la autenticación en Athena mediante el proveedor de identidad de Azure AD. Este método supone que ya se ha establecido una federación entre Athena y Azure AD.

**nota**  
Algunos de los nombres de los parámetros de esta sección tienen alias. Los alias son equivalentes funcionales de los nombres de los parámetros y se han proporcionado para permitir la retrocompatibilidad con el controlador de JDBC 2.x. Debido a que los nombres de los parámetros se han mejorado para que sigan una convención de nomenclatura más clara y coherente, se recomienda utilizarlos en lugar de los alias, que han quedado obsoletos. 

## Proveedor de credenciales
<a name="jdbc-v3-driver-azure-ad-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor del parámetro en `AzureAD`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | AzureAD | 

## Usuario
<a name="jdbc-v3-driver-azure-ad-user"></a>

La dirección de correo electrónico del usuario de Azure AD que se utilizará para la autenticación con Azure AD.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Usuario | UID (obsoleto) | Obligatorio | none | 

## Contraseña
<a name="jdbc-v3-driver-azure-ad-password"></a>

La contraseña del usuario de Azure AD.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Contraseña | PWD (obsoleto) | Obligatorio | none | 

## ID de inquilino de Azure AD
<a name="jdbc-v3-driver-azure-ad-tenant-id"></a>

ID de inquilino de su aplicación de Azure AD.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ID de inquilino de Azure | tenant\$1id (obsoleto) | Obligatorio | none | 

## ID de cliente de Azure AD
<a name="jdbc-v3-driver-azure-ad-client-id"></a>

ID de cliente de su aplicación de Azure AD.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| AzureAdClientId | client\$1id (obsoleto) | Obligatorio | none | 

## Secreto de cliente de Azure
<a name="jdbc-v3-driver-azure-ad-client-secret"></a>

El secreto de cliente de su aplicación de Azure AD.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| El secreto del cliente de Azure Read | client\$1secret (obsoleto) | Obligatorio | none | 

## Rol preferido
<a name="jdbc-v3-driver-preferred-role"></a>

El nombre de recurso de Amazon (ARN) del rol que se asignará. Para obtener información acerca de los roles de ARN, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (obsoleto) | Opcional | none | 

## Duración de la sesión de rol
<a name="jdbc-v3-driver-role-session-duration"></a>

La duración de la sesión del rol en segundos. Para obtener más información, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duración (obsoleto) | Opcional | 3600 | 

## Lake Formation habilitada
<a name="jdbc-v3-driver-lake-formation-enabled"></a>

Utiliza la acción de la API de Lake Formation [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) para recuperar las credenciales de IAM temporales en lugar de la acción de la API de AWS STS [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html).


****  

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

# Credenciales de Okta
<a name="jdbc-v3-driver-okta-credentials"></a>

Un mecanismo de autenticación basado en SAML que permite la autenticación en Athena mediante el proveedor de identidad de Okta. Este método supone que ya se ha establecido una federación entre Athena y Okta.

## Proveedor de credenciales
<a name="jdbc-v3-driver-okta-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor del parámetro en `Okta`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | Okta | 

## Usuario
<a name="jdbc-v3-driver-okta-user"></a>

La dirección de correo electrónico del usuario de Okta que se utilizará para la autenticación con Okta.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Usuario | UID (obsoleto) | Obligatorio | none | 

## Contraseña
<a name="jdbc-v3-driver-okta-password"></a>

La contraseña del usuario Okta.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Contraseña | PWD (obsoleto) | Obligatorio | none | 

## Nombre de host de Okta
<a name="jdbc-v3-driver-okta-host-name"></a>

La URL de su organización de Okta. Puede extraer el parámetro `idp_host` de la URL de **Incrustar enlace** en la aplicación de Okta. Para ver los pasos, consulte [Recuperación de información de configuración de ODBC desde Okta](odbc-okta-plugin.md#odbc-okta-plugin-retrieve-odbc-configuration-information-from-okta). El primer segmento que sigue a `https://`, incluido `okta.com`, es el host del proveedor de identidad (por ejemplo, `trial-1234567.okta.com` para una URL que empiece por `https://trial-1234567.okta.com`).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| OktaHostName | IdP\$1Host (obsoleto) | Obligatorio | none | 

## ID de aplicación de Okta
<a name="jdbc-v3-driver-okta-application-id"></a>

El identificador de dos partes de su aplicación. Puede extraer el ID de la aplicación de la URL del **enlace incrustado** en la aplicación de Okta. Para ver los pasos, consulte [Recuperación de información de configuración de ODBC desde Okta](odbc-okta-plugin.md#odbc-okta-plugin-retrieve-odbc-configuration-information-from-okta). El ID de la aplicación son los dos últimos segmentos de la URL, incluida la barra del medio. Los segmentos son dos cadenas de 20 caracteres con una combinación de números y letras mayúsculas y minúsculas (por ejemplo, `Abc1de2fghi3J45kL678/abc1defghij2klmNo3p4`).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| OktaAppId | App\$1ID (obsoleto) | Obligatorio | none | 

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

El nombre de su aplicación de Okta.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| OktaAppName | App\$1Name (obsoleto) | Obligatorio | none | 

## Tipo de MFA de Okta
<a name="jdbc-v3-driver-okta-mfa-type"></a>

Si ha configurado Okta para que requiera la autenticación multifactor (MFA), debe especificar el tipo de MFA de Okta y los parámetros adicionales en función del segundo factor que desee utilizar.

El tipo MFA de Okta es el segundo tipo de factor de autenticación (después de la contraseña) que se utiliza para autenticarse con Okta. Los segundos factores admitidos incluyen las notificaciones push enviadas a través de la aplicación Okta Verify y las contraseñas temporales de un solo uso (TOTP) generadas por Okta Verify, Google Authenticator o enviadas por SMS. Las políticas de seguridad de las organizaciones individuales determinan si se requiere o no la MFA para el inicio de sesión de los usuarios.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valores posibles | 
| --- | --- | --- | --- | --- | 
| OktaMfaType | okta\$1mfa\$1type (obsoleto) | Obligatorio, si Okta está configurado para requerir MFA | none | oktaverifywithpush, oktaverifywithtotp, googleauthenticator, smsauthentication | 

## Número de teléfono de Okta
<a name="jdbc-v3-driver-okta-phone-number"></a>

El número de teléfono al que Okta enviará una contraseña temporal de un solo uso mediante SMS cuando se elija el tipo de MFA `smsauthentication`. El número de teléfono debe ser un número de teléfono de EE. UU. o Canadá.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| OktaPhoneNumber | okta\$1phone\$1number (obsoleto) | Obligatorio si OkTamfaType es smsauthentication | none | 

## Tiempo de espera de MFA de Okta
<a name="jdbc-v3-driver-okta-mfa-wait-time"></a>

El tiempo, en segundos, que se tarda en esperar a que el usuario confirme una notificación automática de Okta antes de que el controlador emita una excepción de tiempo de espera.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| OktaMfaWaitTime | okta\$1mfa\$1wait\$1time (obsoleto) | Opcional | 60 | 

## Rol preferido
<a name="jdbc-v3-driver-okta-preferred-role"></a>

El nombre de recurso de Amazon (ARN) del rol que se asignará. Para obtener información acerca de los roles de ARN, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (obsoleto) | Opcional | none | 

## Duración de la sesión de rol
<a name="jdbc-v3-driver-role-okta-session-duration"></a>

La duración de la sesión del rol en segundos. Para obtener más información, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duración (obsoleto) | Opcional | 3600 | 

## Lake Formation habilitada
<a name="jdbc-v3-driver-okta-lake-formation-enabled"></a>

Utiliza la acción de la API de Lake Formation [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) para recuperar las credenciales de IAM temporales en lugar de la acción de la API de AWS STS [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html).


****  

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

# Credenciales de Ping
<a name="jdbc-v3-driver-ping-credentials"></a>

Un mecanismo de autenticación basado en SAML que permite la autenticación en Athena mediante el proveedor de identidad de Ping. Este método supone que ya se ha establecido una federación entre Athena y Ping.

## Proveedor de credenciales
<a name="jdbc-v3-driver-ping-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor del parámetro en `Ping`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | Ping | 

## Usuario
<a name="jdbc-v3-driver-ping-user"></a>

La dirección de correo electrónico del usuario federado de Ping que se utilizará para la autenticación federada con Ping.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Usuario | UID (obsoleto) | Obligatorio | none | 

## Contraseña
<a name="jdbc-v3-driver-ping-password"></a>

La contraseña para el usuario federado de Ping.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Contraseña | PWD (obsoleto) | Obligatorio | none | 

## PingHostName
<a name="jdbc-v3-driver-ping-host-name"></a>

La dirección del servidor de Ping. Para encontrar la dirección, visite la siguiente URL y consulte el campo **Punto de conexión de la aplicación de SSO**.

```
https://your-pf-host-#:9999/pingfederate/your-pf-app#/spConnections
```


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| PingHostName | IdP\$1Host (obsoleto) | Obligatorio | none | 

## PingPortNumber
<a name="jdbc-v3-driver-ping-port-number"></a>

El número de puerto que se va a utilizar para conectarse al host del proveedor de identidad.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| PingPortNumber | IdP\$1Port (obsoleto) | Obligatorio | none | 

## PingPartnerSpId
<a name="jdbc-v3-driver-ping-partner-spid"></a>

La dirección del proveedor de servicios. Para encontrar la dirección del proveedor de servicios, visite la siguiente URL y consulte el campo **Punto de conexión de la aplicación de SSO**.

```
https://your-pf-host-#:9999/pingfederate/your-pf-app#/spConnections
```


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
|  PingPartnerSpId  | Partner\$1SPID (obsoleto) | Obligatorio | none | 

## Rol preferido
<a name="jdbc-v3-driver-ping-preferred-role"></a>

El nombre de recurso de Amazon (ARN) del rol que se asignará. Para obtener información acerca de los roles de ARN, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (obsoleto) | Opcional | none | 

## Duración de la sesión de rol
<a name="jdbc-v3-driver-role-ping-session-duration"></a>

La duración de la sesión del rol en segundos. Para obtener más información, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duración (obsoleto) | Opcional | 3600 | 

## Lake Formation habilitada
<a name="jdbc-v3-driver-ping-lake-formation-enabled"></a>

Utiliza la acción de la API de Lake Formation [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) para recuperar las credenciales de IAM temporales en lugar de la acción de la API de AWS STS [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html).


****  

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

# Credenciales de AD FS
<a name="jdbc-v3-driver-adfs-credentials"></a>

Un mecanismo de autenticación basado en SAML que permite la autenticación en Athena mediante los servicios de federación de Microsoft Active Directory (AD FS). Este método supone que el usuario ya ha establecido una federación entre Athena y AD FS.

## Proveedor de credenciales
<a name="jdbc-v3-driver-adfs-credentials-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor del parámetro en `ADFS`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | ADFS | 

## Usuario
<a name="jdbc-v3-driver-adfs-credentials-user"></a>

La dirección de correo electrónico del usuario de AD FS que se utilizará para la autenticación con AD FS.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Usuario | UID (obsoleto) | Necesario para la autenticación basada en formularios. Opcional para la autenticación integrada de Windows. | none | 

## Contraseña
<a name="jdbc-v3-driver-adfs-credentials-password"></a>

La contraseña del usuario de AD FS.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Contraseña | PWD (obsoleto) | Necesario para la autenticación basada en formularios. Opcional para la autenticación integrada de Windows. | none | 

## Nombre del host de AD FS
<a name="jdbc-v3-driver-adfs-credentials-adfshostname"></a>

Dirección del servidor de AD FS.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| AdfsHostName | IdP\$1Host (obsoleto) | Obligatorio | none | 

## Número del puerto de AD FS
<a name="jdbc-v3-driver-adfs-credentials-adfsportnumber"></a>

El número de puerto que se va a utilizar para conectarse al servidor de AD FS.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| AdfsPortNumber | IdP\$1Port (obsoleto) | Obligatorio | none | 

## Usuario de confianza de AD FS
<a name="jdbc-v3-driver-adfs-credentials-adfsrelyingparty"></a>

El usuario de confianza. Utilice este parámetro para anular la URL del punto de conexión del usuario de confianza de AD FS.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| AdfsRelyingParty | LoginToRP (obsoleto) | Opcional | urn:amazon:webservices | 

## WIA de AD FS habilitado
<a name="jdbc-v3-driver-adfs-credentials-adfswiaenabled"></a>

Booleano. Use este parámetro para habilitar la autenticación integrada de Windows (WIA) con AD FS.


****  

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

## Rol preferido
<a name="jdbc-v3-driver-adfs-credentials-preferred-role"></a>

El nombre de recurso de Amazon (ARN) del rol que se asignará. Para obtener información sobre los roles de ARN, consulte [https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (obsoleto) | Opcional | none | 

## Duración de la sesión de rol
<a name="jdbc-v3-driver-adfs-credentials-role-session-duration"></a>

La duración de la sesión del rol en segundos. Para obtener más información, consulte [https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duración (obsoleto) | Opcional | 3600 | 

## Lake Formation habilitada
<a name="jdbc-v3-driver-adfs-credentials-lake-formation-enabled"></a>

Especifica si se debe utilizar la acción de la API de Lake Formation [https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) para recuperar las credenciales de IAM temporales en lugar de la acción de la API [https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) de AWS STS.


****  

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

# Credenciales de Browser Azure AD
<a name="jdbc-v3-driver-browser-azure-ad-credentials"></a>

Browser Azure AD es un complemento de autenticación basado en SAML que funciona con el proveedor de identidad de Azure AD y admite la autenticación multifactor. A diferencia del mecanismo de autenticación estándar de Azure AD, este mecanismo no requiere un nombre de usuario, contraseña o secreto de cliente en los parámetros de conexión. Al igual que el mecanismo de autenticación estándar de Azure AD, Browser Azure AD también asume que el usuario ya ha configurado la federación entre Athena y Azure AD.

## Proveedor de credenciales
<a name="jdbc-v3-driver-browser-azure-ad-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor del parámetro en `BrowserAzureAD`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | BrowserAzureAD | 

## ID de inquilino de Azure AD
<a name="jdbc-v3-driver-browser-azure-ad-azure-ad-tenant-id"></a>

El ID de inquilino de su aplicación Azure AD


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ID de inquilino de Azure | tenant\$1id (obsoleto) | Obligatorio | none | 

## ID de cliente de Azure AD
<a name="jdbc-v3-driver-browser-azure-ad-azure-ad-client-id"></a>

El ID de cliente de su aplicación Azure AD


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| AzureAdClientId | client\$1id (obsoleto) | Obligatorio | none | 

## Tiempo de respuesta del proveedor de identidad
<a name="jdbc-v3-driver-identity-provider-response-timeout"></a>

El tiempo, en segundos, antes de que el controlador deje de esperar la respuesta de SAML de Azure AD.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | idp\$1response\$1timeout (obsoleto) | Opcional | 120 | 

## Rol preferido
<a name="jdbc-v3-driver-browser-azure-ad-preferred-role"></a>

El nombre de recurso de Amazon (ARN) del rol que se asignará. Para obtener información acerca de los roles de ARN, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (obsoleto) | Opcional | none | 

## Duración de la sesión de rol
<a name="jdbc-v3-driver-browser-azure-ad-role-session-duration"></a>

La duración de la sesión del rol en segundos. Para obtener más información, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duración (obsoleto) | Opcional | 3600 | 

## Lake Formation habilitada
<a name="jdbc-v3-driver-browser-azure-ad-lake-formation-enabled"></a>

Utiliza la acción de la API de Lake Formation [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) para recuperar las credenciales de IAM temporales en lugar de la acción de la API de AWS STS [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html).


****  

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

# Credenciales del navegador SALM
<a name="jdbc-v3-driver-browser-saml-credentials"></a>

El navegador SAML es un complemento de autenticación genérico que puede funcionar con proveedores de identidad basados en SAML y admitir la autenticación multifactor.

## Proveedor de credenciales
<a name="jdbc-v3-driver-browser-saml-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor del parámetro en `BrowserSaml`.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | BrowserSaml | 

## URL de inicio de sesión único
<a name="jdbc-v3-driver-single-sign-on-login-url"></a>

La URL de inicio de sesión único para la aplicación en el proveedor de identidad basado en SAML.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| SsoLoginUrl | login\$1url (obsoleto) | Obligatorio | none | 

## Puerto de escucha
<a name="jdbc-v3-driver-listen-port"></a>

El número del puerto que se usa para escuchar la respuesta de SAML. Este valor debe coincidir con la URL con la que se configuró el proveedor de identidad basado en SAML (por ejemplo, `http://localhost:7890/athena`).


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| ListenPort | listen\$1port (obsoleto) | Opcional | 7890 | 

## Tiempo de respuesta del proveedor de identidad
<a name="jdbc-v3-driver-single-sign-on-login-url-identity-provider-response-timeout"></a>

El tiempo, en segundos, antes de que el controlador deje de esperar la respuesta de SAML de Azure AD.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | idp\$1response\$1timeout (obsoleto) | Opcional | 120 | 

## Rol preferido
<a name="jdbc-v3-driver-single-sign-on-login-url-preferred-role"></a>

El nombre de recurso de Amazon (ARN) del rol que se asignará. Para obtener información acerca de los roles de ARN, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (obsoleto) | Opcional | none | 

## Duración de la sesión de rol
<a name="jdbc-v3-driver-single-sign-on-login-url-role-session-duration"></a>

La duración de la sesión del rol en segundos. Para obtener más información, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) en la *Referencia de la API de AWS Security Token Service*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duración (obsoleto) | Opcional | 3600 | 

## Lake Formation habilitada
<a name="jdbc-v3-driver-single-sign-on-login-url-lake-formation-enabled"></a>

Utiliza la acción de la API de Lake Formation [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) para recuperar las credenciales de IAM temporales en lugar de la acción de la API de AWS STS [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html).


****  

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

# Proveedor de credenciales de IdC para DataZone
<a name="jdbc-v3-driver-datazone-idc"></a>

Un mecanismo de autenticación que permite conectarse a datos gobernados por DataZone en Athena mediante IAM Identity Center.

## Proveedor de credenciales
<a name="jdbc-v3-driver-datazone-idc-credentials-provider"></a>

El proveedor de credenciales que se utilizará para autenticar las solicitudes de AWS. Establezca el valor del parámetro en `DataZoneIdc`. Tenga en cuenta que el alias `AWSCredentialsProviderClass` está obsoleto; utilice el nombre del parámetro `CredentialsProvider` en su lugar.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | Valor para usar | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obligatorio | none | DataZoneIdc | 

## Identificador de dominio de DataZone
<a name="jdbc-v3-driver-datazone-idc-datazone-domain-identifier"></a>

Identificador del dominio de DataZone que se va a utilizar.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| DataZoneDomainId | none | Obligatorio | none | 

## Identificador del entorno de DataZone
<a name="jdbc-v3-driver-datazone-idc-datazone-environment-identifier"></a>

Identificador del entorno de DataZone que se va a utilizar.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| DataZoneEnvironmentId | none | Obligatorio | none | 

## Región del dominio de DataZone
<a name="jdbc-v3-driver-datazone-idc-datazone-domain-region"></a>

La Región de AWS donde se aprovisiona su dominio de DataZone.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| DataZoneDomainRegion | none | Obligatorio | none | 

## Región
<a name="jdbc-v3-driver-datazone-idc-region"></a>

La Región de AWS donde se aprovisionan su entorno de DataZone y su grupo de trabajo de Athena.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Región | none | Obligatorio | none | 

## Dirección URL del emisor de IAM Identity Center
<a name="jdbc-v3-driver-datazone-idc-iam-identity-center-issuer-url"></a>

La URL del emisor de la instancia de IAM Identity Center que utiliza el dominio de DataZone.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| IdentityCenterIssuerUrl | none | Obligatorio | none | 

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

El punto de conexión de la API de DataZone que se utilizará en lugar del punto de conexión predeterminado para la Región de AWS proporcionada.


****  

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

## Activar el almacenamiento en caché de tokens
<a name="jdbc-v3-driver-datazone-idc-enable-token-caching"></a>

Cuando está activado, permite utilizar el mismo token de acceso de IAM Identity Center en todas las conexiones de los controladores. Esto impide que las herramientas de SQL que crean múltiples conexiones de controladores abran varias ventanas del navegador. Si activa este parámetro, le recomendamos que cierre la herramienta SQL inmediatamente después de usarla para borrar la caché de tokens y requerir una nueva autenticación.


****  

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

## Puerto de escucha
<a name="jdbc-v3-driver-datazone-idc-listen-port"></a>

El número de puerto que escucha la respuesta de IAM Identity Center.


****  

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

## Tiempo de respuesta del proveedor de identidad
<a name="jdbc-v3-driver-datazone-idc-identity-provider-response-time-out"></a>

El tiempo, en segundos, antes de que el controlador deje de esperar la respuesta de IAM Identity Center.


****  

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

# Proveedor de credenciales de IAM para DataZone
<a name="jdbc-v3-driver-datazone-iamcp"></a>

Un mecanismo de autenticación que utiliza las credenciales de IAM para conectarse a los datos gobernados por DataZone en Athena.

## Identificador de dominio de DataZone
<a name="jdbc-v3-driver-datazone-iamcp-datazone-domain-identifier"></a>

Identificador del dominio de DataZone que se va a utilizar.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| DataZoneDomainId | none | Obligatorio | none | 

## Identificador del entorno de DataZone
<a name="jdbc-v3-driver-datazone-iamcp-datazone-environment-identifier"></a>

Identificador del entorno de DataZone que se va a utilizar.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| DataZoneEnvironmentId | none | Obligatorio | none | 

## Región del dominio de DataZone
<a name="jdbc-v3-driver-datazone-iamcp-datazone-domain-region"></a>

La Región de AWS donde se aprovisiona su dominio de DataZone.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| DataZoneDomainRegion | none | Obligatorio | none | 

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

El punto de conexión de la API de DataZone que se utilizará en lugar del punto de conexión predeterminado para la Región de AWS proporcionada.


****  

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

## Usuario
<a name="jdbc-v3-driver-datazone-iamcp-user"></a>

El ID de la clave de acceso de AWS. Para obtener más información sobre las claves de acceso, consulte [Credenciales de seguridad de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) en la *Guía del usuario de IAM*.


****  

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

## Contraseña
<a name="jdbc-v3-driver-datazone-iamcp-password"></a>

ID de su clave secreta de AWS. Para obtener más información sobre las claves de acceso, consulte [Credenciales de seguridad de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) en la *Guía del usuario de IAM*.


****  

| Nombre del parámetro | Alias | Tipo de parámetro | Predeterminado | 
| --- | --- | --- | --- | 
| Contraseña | SecretAccessKey | Opcional | none | 

# Otra configuración de JDBC 3.x
<a name="jdbc-v3-driver-other-configuration"></a>

En las siguientes secciones se describen algunos ajustes de configuración adicionales para el controlador JDBC 3.x.

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

El tiempo de espera de conexión es la cantidad de tiempo en milisegundos que el controlador esperará a que se establezca una conexión. Esto incluye el tiempo que se tarda en enviar las solicitudes de API. Transcurrido este tiempo, el controlador lanza una excepción de tiempo de espera. 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.

Para configurarlo, llame al método `setNetworkTimeout` en un objeto `Connection` JDBC. Este valor se puede cambiar durante el ciclo de vida de la conexión JDBC. Para obtener más información, consulte [setNetworkTimeout](https://docs.oracle.com/javase/8/docs/api/java/sql/Connection.html#setNetworkTimeout-java.util.concurrent.Executor-int-) en la documentación de la API JDBC de Oracle. El uso del método `setNetworkTimeout` equivale a configurar el parámetro de conexión [Tiempo de espera de la red](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-networktimeoutmillis). 

En el siguiente ejemplo, se establece el tiempo de espera de la red en 5000 milisegundos.

```
...
AthenaDriver driver = new AthenaDriver();
Connection connection = driver.connect(url, connectionParameters);
connection.setNetworkTimeout(null, 5000);
...
```

## Tiempo de espera de consulta
<a name="jdbc-v3-driver-query-timeout"></a>

Período de tiempo, en segundos, que el controlador esperará a que se complete una consulta en Athena después de que se haya enviado. Transcurrido este tiempo, el controlador intenta cancelar la consulta enviada y lanza una excepción de tiempo de espera.

El tiempo de espera de la consulta no se puede configurar como parámetro de conexión. Para configurarlo, llame al método `setQueryTimeout` en un objeto `Statement` JDBC. Este valor se puede cambiar durante el ciclo de vida de la instrucción de JDBC. El valor predeterminado de este parámetro es `0` (cero). Un valor de `0` significa que las consultas se pueden ejecutar hasta que se completen (sujeto a [Service Quotas](service-limits.md)).

El siguiente ejemplo establece el tiempo de espera de la consulta en 5 segundos.

```
...
AthenaDriver driver = new AthenaDriver();
Connection connection = driver.connect(url, connectionParameters);
Statement statement = connection.createStatement();
statement.setQueryTimeout(5);
...
```

# Notas de la versión de JDBC 3.x de Amazon Athena
<a name="jdbc-v3-driver-release-notes"></a>

Estas notas de lanzamiento proporcionan detalles sobre las mejoras y correcciones en el controlador JDBC 3.x de Amazon Athena.

## 3.7.0
<a name="jdbc-v3-driver-release-notes-2025-11-21"></a>

Publicado el 21/11/2025

### Mejoras
<a name="jdbc-v3-driver-release-notes-2025-11-21-improvements"></a>
+ **Complemento de autenticación de propagación de identidades de confianza del navegador**: se añadió un nuevo complemento de autenticación que permite una autenticación sin problemas basada en el navegador con proveedores de identidades de OpenID Connect (OIDC). Este complemento gestiona todo el flujo de OAuth 2.0 a través del navegador predeterminado, obtiene automáticamente el token web JSON (JWT) y se integra con una propagación de identidades de confianza. Diseñado específicamente para entornos de escritorio de un solo usuario, proporciona una experiencia de autenticación más simplificada en comparación con el manejo manual del JWT. Para obtener información sobre la propagación de identidades de confianza, consulte [¿Qué es la propagación de identidades de confianza?](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html)

### Correcciones
<a name="jdbc-v3-driver-release-notes-2025-11-21-fixes"></a>
+ **Compatibilidad mejorada con la precisión de las marcas de tiempo**: el controlador ahora es totalmente compatible con la precisión de milisegundos y nanosegundos en los valores de las marcas de tiempo devueltos por las consultas de Athena a través del método `getTimestamp()`.
+ **Gestión mejorada de tipos de datos complejos**: se han corregido los problemas relacionados con el análisis de tipos de datos anidados (matrices, estructuras y asignaciones) tanto en las operaciones de metadatos generales como de `DatabaseMetaData#getColumns`, lo que garantiza una información de tipo precisa para estructuras de datos complejas.
+ **Registro de errores mejorado**: registro mejorado de los errores de recuperación de metadatos de S3, lo que proporciona mensajes de error más claros y mejor información de diagnóstico.

## 3.6.0
<a name="jdbc-v3-driver-release-notes-2025-09-10"></a>

Publicado el 10/09/2025

### Mejoras
<a name="jdbc-v3-driver-release-notes-2025-09-10-improvements"></a>
+ **Complemento de autenticación de propagación de identidad de confianza con JWT**: se agregó un nuevo complemento de autenticación para admitir la integración de la propagación de identidad de confianza con JWT en los controladores JDBC. Este tipo de autenticación permite usar un JSON Web Token (JWT) obtenido de un proveedor de identidades externo como parámetro de conexión para autenticarse con Athena. Con la propagación de identidad de confianza, se agrega el contexto de identidad a un rol de IAM para identificar al usuario que solicita acceso a los recursos de AWS. Para obtener información sobre cómo habilitar y usar la propagación de identidad de confianza, consulte [¿Qué es la propagación de identidad de confianza?](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html).
+ **Compatibilidad con puntos de conexión personalizados de SSO OIDC y SSO Admin**: se agregó compatibilidad para puntos de conexión personalizados de SSO OIDC y SSO Admin en el controlador JDBC. Esta mejora permite especificar sus propios puntos de conexión para los servicios de SSO al ejecutar JDBC detrás de VPC.
+ **Actualización de la versión de AWS SDK**: actualizamos la versión de AWS SDK utilizada en el controlador a la 2.32.16 y actualizamos las dependencias del proyecto para la versión 3.6.0.

## 3.5.1
<a name="jdbc-v3-driver-release-notes-2025-07-17"></a>

Publicado el 17/07/2025

### Mejoras
<a name="jdbc-v3-driver-release-notes-2025-07-17-improvements"></a>
+ **Capacidades de registro**: se mejoró el registro de recuperación de S3 al elevar el nivel de registro a `INFO` y agregar métricas para el recuento de filas, las compensaciones y la longitud de los objetos. Se implementó el seguimiento del ciclo de vida de las conexiones y se optimizó el rendimiento general del registro.
+ **Gestión de caracteres especiales**: gestión mejorada de los caracteres especiales para patrones `LIKE` en los nombres de esquemas y catálogos.
+ **Administración del estado de la conexión**: se ha mejorado la administración del estado de la conexión para evitar posibles errores, lo que evita las llamadas a la API tras el cierre de la conexión y agrega controles de seguridad para las operaciones de consulta durante el cierre.

### Correcciones
<a name="jdbc-v3-driver-release-notes-2025-07-17-fixes"></a>
+ **Metadatos de consulta DDL**: se ha corregido el problema `NoSuchKeyFound` con la gestión de los metadatos de consulta DDL.

## 3.5.0
<a name="jdbc-v3-driver-release-notes-2025-03-18"></a>

Publicado el 18/03/2025

### Mejoras
<a name="jdbc-v3-driver-release-notes-2025-03-18-improvements"></a>
+ **Parámetros de configuración de resultados**: se agregó compatibilidad para dos nuevos parámetros de conexión `ExpectedBucketOwner` y `AclOption`. Para obtener más información, consulte [Parámetros de configuración de resultados](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-result-config).
+ **Versión del AWS SDK**: la versión del AWS SDK que se utilizó en el controlador se actualizó a la versión 2.30.22.

## 3.4.0
<a name="jdbc-v3-driver-release-notes-2025-02-18"></a>

Publicado el 18/02/2025

### Mejoras
<a name="jdbc-v3-driver-release-notes-2025-02-18-improvements"></a>
+ **Buscador de resultados**: el controlador ahora selecciona automáticamente el método más rápido para descargar los resultados de las consultas. Esto elimina la necesidad de configurar de forma manual el buscador en la mayoría de las situaciones. Para obtener más información, consulte [Parámetros de obtención de resultados](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-result-fetching-parameters).

### Correcciones
<a name="jdbc-v3-driver-release-notes-2025-02-18-fixes"></a>
+ **ResultSet**: el controlador ahora gestiona la iteración sobre los conjuntos de resultados de las instrucciones DDL que no producen objetos de resultado en S3. También devuelve un objeto `ResultSet` vacío en lugar de nulo cuando `GetQueryResultsStream` devuelve una página completamente vacía.
+ **ResultsStream**: la transmisión de resultados se ha optimizado mediante la eliminación de las llamadas innecesarias para contar el número de filas en los búferes internos.
+ **GetTables**: la llamada `GetTables` se ha optimizado mediante la gestión de los tipos de tablas en función de las respuestas `ListTableMetadata` y `GetTableMetadata`.

## 3.3.0
<a name="jdbc-v3-driver-release-notes-2024-10-30"></a>

Lanzamiento: 30/10/2024

### Mejoras
<a name="jdbc-v3-driver-release-notes-2024-10-30-improvements"></a>
+ **Autenticación de DataZone**: se agregó soporte para los complementos de autenticación de DataZone `DataZoneIdC` y `DataZoneIAM`. Para obtener más información, consulte [Proveedor de credenciales de IdC para DataZone](jdbc-v3-driver-datazone-idc.md) y [Proveedor de credenciales de IAM para DataZone](jdbc-v3-driver-datazone-iamcp.md).
+ **Tiempo de espera de la red**: el tiempo de espera de la red ahora se puede configurar mediante el parámetro de conexión `NetworkTimeoutMillis`. Anteriormente, solo se podía configurar en el propio objeto `Connection`. Para obtener más información, consulte [Tiempo de espera de la red](jdbc-v3-driver-other-configuration.md#jdbc-v3-driver-network-timeout).

### Correcciones
<a name="jdbc-v3-driver-release-notes-2024-10-30-fixes"></a>
+ **Gestión de objetos vacíos en S3**: el controlador ahora gestiona los objetos vacíos en el buscador de S3 en lugar de producir una excepción de Amazon S3 Range Not Satisfiable.
+ **Registro**: el controlador ya no registra el mensaje Elementos solicitados para la ejecución de la consulta [...], pero la suscripción está cancelada tras consumir los resultados de la consulta.
+ **Cadenas de parámetros vacías**: el controlador ahora maneja las cadenas vacías presentes en un parámetro de conexión como si el parámetro no estuviera presente. Esto resuelve los problemas que se producían cuando algunas herramientas de BI transferían inadvertidamente cadenas vacías que provocaban intentos de autenticación no deseados.

## 3.2.2
<a name="jdbc-v3-driver-release-notes-2024-07-29"></a>

Lanzamiento: 29/07/2024

### Mejoras
<a name="jdbc-v3-driver-release-notes-2024-07-29-improvements"></a>
+ **Asignación de tipos de datos**: se mejoró el cumplimiento de la especificación de JDBC al cambiar la manera en que el controlador asigna los tipos de datos `tinyint`, `smallint`, `row` y `struct` a los objetos de Java.
+ **Actualización de la versión del SDK de AWS**: la versión del SDK de AWS que se utilizó en el controlador se actualizó a la versión 2.26.23.

### Correcciones
<a name="jdbc-v3-driver-release-notes-2024-07-29-fixes"></a>
+ **Comentarios**: se corrigió un problema con los comentarios de línea al final de una instrucción.
+ **Enumeración de bases de datos**: se solucionó un problema por el cual la enumeración de las bases de datos podía entrar en un bucle infinito cuando la última página devuelta por la API `ListDatabases` paginada estaba vacía.

## 3.2.1
<a name="jdbc-v3-driver-release-notes-2024-07-03"></a>

Se lanzó el 03/07/2024

### Mejoras
<a name="jdbc-v3-driver-release-notes-2024-07-03-improvements"></a>
+ **Proveedor de credenciales JWT**: se agregó compatibilidad para duraciones de sesión especificadas por el usuario. Para obtener más información, consulte [Duración de la sesión de rol](jdbc-v3-driver-jwt-credentials.md#jdbc-v3-driver-jwt-role-session-duration).

### Correcciones
<a name="jdbc-v3-driver-release-notes-2024-07-03-fixes"></a>
+ **Grupo de subprocesos**: se creó un `ThreadPoolExecutor` por conexión para tareas asincrónicas a fin de evitar el uso del grupo `ForkJoin`.
+ **Proveedores de credenciales**: ahora el host proxy se analiza para obtener el esquema y el host cuando el cliente HTTP está configurado para IdP externos.
+ **Proveedor de credenciales predeterminado**: se aseguró que el código de cliente no pueda cerrar el proveedor de credenciales predeterminado.
+ **getColumns**: se ha corregido un problema con las propiedades de las columnas `ORDINAL_COLUMN` en el método `DatabaseMetaData#getColumns`.
+ **ResultSet**: se agregó compatibilidad con `Infinity`, `-Infinity` y `NaN` para `ResultSet.`. Se corrigió una discrepancia entre el tipo de columna devuelto por las operaciones de catálogo y el conjunto de resultados de una consulta completada.

## 3.2.0
<a name="jdbc-v3-driver-release-notes-2024-02-26"></a>

Se lanzó el 26/04/2024

### Mejoras
<a name="jdbc-v3-driver-release-notes-2024-02-26-improvements"></a>
+ **Rendimiento del funcionamiento del catálogo**: se ha mejorado el rendimiento de las operaciones de catálogo que no utilizan caracteres comodín.
+ **Cambio del intervalo mínimo de sondeo**: el intervalo mínimo de sondeo predeterminado se ha modificado para reducir la cantidad de llamadas a la API que el controlador realiza a Athena. Las finalizaciones de consultas se siguen detectando lo antes posible.
+ **Capacidad de detección de las herramientas de inteligencia empresarial**: se ha hecho que el controlador sea más fácil de detectar para las herramientas de inteligencia empresarial.
+ **Asignación de tipos de datos**: se ha mejorado la asignación de tipos de datos a los tipos de datos DDL `binary`, `array` y `struct` de Athena.
+ **Versión del AWS SDK**: la versión del AWS SDK que se utilizó en el controlador se actualizó a la versión 2.25.34.

### Correcciones
<a name="jdbc-v3-driver-release-notes-2024-02-26-fixes"></a>
+ **Listados de tablas del catálogo federado**: se corrigió un problema que causaba que los catálogos federados devolvieran una lista vacía de tablas.
+ **getSchemas**: se corrigió un problema que hacía que el método JDBC [DatabaseMetaData\$1getSchemas](https://docs.oracle.com/javase/8/docs/api/java/sql/DatabaseMetaData.html#getSchemas--) recuperara las bases de datos solo del catálogo predeterminado en lugar de todos los catálogos.
+ **getColumns**: se corrigió un problema que provocaba que se devolviera un catálogo nulo cuando se llamaba al método JDBC [DatabaseMetaData\$1getColumns](https://docs.oracle.com/javase/8/docs/api/java/sql/DatabaseMetaData.html#getColumns-java.lang.String-java.lang.String-java.lang.String-java.lang.String-) con un nombre de catálogo nulo.

## 3.1.0
<a name="jdbc-v3-driver-release-notes-2024-02-15"></a>

Publicado el 15/02/2024

### Mejoras
<a name="jdbc-v3-driver-release-notes-2024-02-15-improvements"></a>
+ Se añadió compatibilidad con la autenticación basada en formularios de autenticación integrada de Windows de Microsoft Active Directory Federation Services (AD FS).
+ Para garantizar la compatibilidad con versiones anteriores de la versión 2.x, ahora se acepta el subprotocolo `awsathena` JDBC, pero genera una advertencia de obsolescencia. En su lugar, utilice el subprotocolo JDBC `athena`.
+ `AwsDataCatalog` es ahora el valor predeterminado para el parámetro del catálogo y `default` es el valor predeterminado para el parámetro de la base de datos. Estos cambios garantizan que se devuelvan los valores correctos para el catálogo y la base de datos actuales en lugar de nulos.
+ De conformidad con la especificación JDBC, `IS_AUTOINCREMENT` y `IS_GENERATEDCOLUMN` ahora devuelven una cadena vacía en lugar de `NO`.
+ El tipo de datos `int` de Athena ahora se asigna al mismo tipo JDBC que el `integer` de Athena en lugar de a `other`.
+ Cuando los metadatos de las columnas de Athena no contienen los campos opcionales `precision` y `scale`, el controlador ahora devuelve cero para los valores correspondientes de una columna de `ResultSet`.
+ La versión del AWS SDK se ha actualizado a la versión 2.21.39.

### Correcciones
<a name="jdbc-v3-driver-release-notes-2024-02-15-fixes"></a>
+ Se corrigió un problema con `GetQueryResultsStream` que provocaba que se produjera una excepción cuando los resultados de texto sin formato de Athena tenían un recuento de columnas inconsistente con el recuento de columnas en los metadatos de los resultados de Athena.

## 3.0.0
<a name="jdbc-v3-driver-release-notes-2023-11-16"></a>

Se lanzó el 16/11/2023

El controlador Athena JDBC 3.x es un controlador de nueva generación que ofrece mejor rendimiento y compatibilidad. El controlador JDBC 3.x es compatible con la lectura de los resultados de las consultas directamente desde Amazon S3, lo que mejora el rendimiento de las aplicaciones que consumen resultados de consultas de gran tamaño. El nuevo controlador también tiene menos dependencias de terceros, lo que facilita la integración con las herramientas de inteligencia empresarial y las aplicaciones personalizadas.

# Versiones anteriores del controlador JDBC 3.x de Athena
<a name="jdbc-v3-driver-previous-versions"></a>

Le recomendamos que utilice la [última versión](jdbc-v3-driver.md) del controlador JDBC 3.x. La última versión del controlador contiene las mejoras y correcciones más recientes. Utilice una versión anterior solo si la aplicación presenta incompatibilidades con la versión más reciente.

## Controlador uber jar JDBC
<a name="jdbc-v3-driver-download-uber-jar-previous"></a>

La siguiente descarga empaqueta el controlador y todas sus dependencias en el mismo archivo `.jar`. Esta descarga se suele utilizar para clientes SQL de terceros.
+ [3.6.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.6.0/athena-jdbc-3.6.0-with-dependencies.jar)
+ [3.5.1 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.5.1/athena-jdbc-3.5.1-with-dependencies.jar)
+ [3.5.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.5.0/athena-jdbc-3.5.0-with-dependencies.jar)
+ [3.4.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.4.0/athena-jdbc-3.4.0-with-dependencies.jar)
+ [3.3.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.3.0/athena-jdbc-3.3.0-with-dependencies.jar)
+ [3.2.2 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.2/athena-jdbc-3.2.2-with-dependencies.jar)
+ [3.2.1 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.1/athena-jdbc-3.2.1-with-dependencies.jar)
+ [3.2.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.0/athena-jdbc-3.2.0-with-dependencies.jar)
+ [3.1.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.1.0/athena-jdbc-3.1.0-with-dependencies.jar)
+ [3.0.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.0.0/athena-jdbc-3.0.0-with-dependencies.jar)

## Controlador lean jar JDBC
<a name="jdbc-v3-driver-download-lean-jar"></a>

La siguiente descarga es un archivo `.zip` que contiene la versión lean `.jar` del controlador y archivos `.jar` separados para las dependencias del controlador. Esta descarga se suele utilizar para aplicaciones personalizadas que pueden tener dependencias que entren en conflicto con las dependencias que utiliza el controlador. Esta descarga resulta útil si desea elegir qué dependencias de controladores desea incluir en el lean jar y cuáles excluir si la aplicación personalizada ya contiene una o más de ellas.
+ [3.6.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.6.0/athena-jdbc-3.6.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.5.1 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.5.1/athena-jdbc-3.5.1-lean-jar-and-separate-dependencies-jars.zip)
+ [3.5.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.5.0/athena-jdbc-3.5.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.4.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.4.0/athena-jdbc-3.4.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.3.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.3.0/athena-jdbc-3.3.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.2.2 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.2/athena-jdbc-3.2.2-lean-jar-and-separate-dependencies-jars.zip)
+ [3.2.1 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.1/athena-jdbc-3.2.1-lean-jar-and-separate-dependencies-jars.zip)
+ [3.2.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.0/athena-jdbc-3.2.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.1.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.1.0/athena-jdbc-3.1.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.0.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.0.0/athena-jdbc-3.0.0-lean-jar-and-separate-dependencies-jars.zip)