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

Você pode usar uma conexão JDBC para se conectar ao Amazon Athena em muitas ferramentas e aplicações de clientes SQL de terceiros.

## Requisitos do sistema
<a name="jdbc-v3-driver-system-requirements"></a>
+ Ambiente de runtime do Java 8 (ou superior)
+ Pelo menos 20 MB de espaço em disco disponível

## Considerações e limitações
<a name="jdbc-v3-driver-considerations-and-limitations"></a>

A seguir estão algumas considerações e limitações do driver JDBC 3.x. do Athena.
+ **Registro em log**: o driver 3.x usa o [SLF4J](https://www.slf4j.org/manual.html), que é uma camada de abstração que permite o uso de qualquer um dos diversos sistemas de registro em log em runtime.
+ **Criptografia**: quando usa o captador do Amazon S3 com a opção de criptografia do `CSE_KMS`, o cliente do Amazon S3 não pode descriptografar os resultados armazenados em um bucket do Amazon S3. Se você precisar de criptografia `CSE_KMS`, poderá continuar a usar o buscador de streaming. Está nos planos a compatibilidade com a criptografia `CSE_KMS` com o buscador Amazon S3.

## Download do driver JDBC 3.x
<a name="jdbc-v3-driver-download"></a>

Esta seção contém informações de download e licença para o driver JDBC 3.x.

**Importante**  
Quando você usar o driver JDBC 3.x, preste atenção aos seguintes requisitos:  
**Porta 444 aberta**: mantenha a porta 444, que o Athena usa para fazer uma transmissão dos resultados das consultas, aberta para o tráfego de saída. Ao usar um endpoint do PrivateLink para se conectar ao Athena, verifique se o grupo de segurança anexado ao endpoint do PrivateLink está aberto para o tráfego de entrada na porta 444. 
**Política athena:GetQueryResultsStream**: adicione a ação de política `athena:GetQueryResultsStream` para as entidades principais do IAM que usam o driver JDBC. Essa ação de política não é exposta diretamente com a API. Ela apenas é usada com drivers ODBC e JDBC como parte do suporte a resultados de transmissão. Para visualizar um exemplo de política, consulte [AWSPolítica gerenciada : AWSQuicksightAthenaAccess](security-iam-awsmanpol.md#awsquicksightathenaaccess-managed-policy). 

Para baixar o driver JDBC versão 3.x do Amazon Athena, acesse os links a seguir.

### Jar com dependências do driver JDBC
<a name="jdbc-v3-driver-download-uber-jar"></a>

O download a seguir empacota o driver e todas as suas dependências no mesmo arquivo `.jar`. Esse download é comumente usado para clientes SQL de terceiros.

[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)

### Jar sem dependências do driver JDBC
<a name="jdbc-v3-driver-download-lean-jar"></a>

O download a seguir é um arquivo `.zip` que contém o `.jar` sem dependências para o driver e arquivos `.jar` separados para as dependências do driver. Esse download é comumente usado para aplicações personalizadas que podem ter dependências conflitantes com as dependências que o driver usa. Esse download é útil se você quiser escolher quais dependências do driver incluir no jar sem dependências e quais excluir se a aplicação personalizada já contiver uma ou mais dependências.

[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)

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

O link a seguir contém o contrato de licença do driver JDBC 3.x.

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

## Propagação de identidade confiável com JDBC
<a name="jdbc-v3-driver-trusted-identity"></a>

Agora é possível se conectar ao Amazon Athena usando drivers JDBC com recursos de login único por meio do Centro de Identidade do AWS Identity and Access Management. Quando você acessa o Athena a partir de ferramentas como PowerBI, Tableau ou DBeaver, sua identidade e permissões são propagadas automaticamente para o Athena por meio do Centro de Identidade do IAM. Para obter mais informações, consulte [Usar a propagação de identidade confiável com drivers do Amazon Athena](using-trusted-identity-propagation.md).

**Topics**
+ [Requisitos do sistema](#jdbc-v3-driver-system-requirements)
+ [Considerações e limitações](#jdbc-v3-driver-considerations-and-limitations)
+ [Download do driver JDBC 3.x](#jdbc-v3-driver-download)
+ [Propagação de identidade confiável com JDBC](#jdbc-v3-driver-trusted-identity)
+ [Conceitos básicos do driver JDBC 3.x](jdbc-v3-driver-getting-started.md)
+ [Parâmetros de conexão do JDBC 3.x do Amazon Athena](jdbc-v3-driver-connection-parameters.md)
+ [Outra configuração do JDBC 3.x](jdbc-v3-driver-other-configuration.md)
+ [Notas de versão do JDBC 3.x do Amazon Athena](jdbc-v3-driver-release-notes.md)
+ [Versões anteriores do driver JDBC 3.x driver do Athena](jdbc-v3-driver-previous-versions.md)

# Conceitos básicos do driver JDBC 3.x
<a name="jdbc-v3-driver-getting-started"></a>

Use as informações desta seção para começar a usar o driver JDBC 3.x do Amazon Athena.

**Topics**
+ [Instruções de instalação](#jdbc-v3-driver-installation-instructions)
+ [Executar o driver](#jdbc-v3-driver-running-the-driver)
+ [Configurar o driver](#jdbc-v3-driver-configuring-the-driver)
+ [Atualizar o driver Athena JDBC v2](#jdbc-v3-driver-upgrading-from-the-athena-jdbc-v2-driver-to-v3)

## Instruções de instalação
<a name="jdbc-v3-driver-installation-instructions"></a>

Você pode usar o driver JDBC 3.x em uma aplicação personalizada ou em um cliente SQL de terceiros.

### Em uma aplicação personalizada
<a name="jdbc-v3-driver-installation-in-a-custom-application"></a>

Baixe o arquivo `.zip` que contém o jar do driver e suas dependências. Cada dependência tem seu próprio arquivo `.jar`. Adicione o jar do driver como uma dependência na sua aplicação personalizada. Adicione seletivamente as dependências do jar do driver, com base em você já ter ou não adicionado essas dependências à aplicação de outra fonte.

### Em um cliente SQL de terceiros
<a name="jdbc-v3-driver-installation-in-a-third-party-sql-client"></a>

Baixe o arquivo jar com dependências do driver e adicione-o ao cliente SQL de terceiros seguindo as instruções para esse cliente.

## Executar o driver
<a name="jdbc-v3-driver-running-the-driver"></a>

Para executar o driver, você pode usar uma aplicação personalizada ou um cliente SQL de terceiros.

### Em uma aplicação personalizada
<a name="jdbc-v3-driver-running-in-a-custom-application"></a>

Use a interface JDBC para interagir com o driver JDBC em um programa. O código a seguir mostra um exemplo de aplicação 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
}
```

### Em um cliente SQL de terceiros
<a name="jdbc-v3-driver-running-in-a-third-party-sql-client"></a>

Siga a documentação do cliente SQL que você está usando. Normalmente, você usa a interface gráfica do usuário do cliente SQL para inserir e enviar a consulta, e os resultados da consulta são exibidos na mesma interface.

## Configurar o driver
<a name="jdbc-v3-driver-configuring-the-driver"></a>

Você pode usar os parâmetros de conexão para configurar o driver JDBC do Amazon Athena. Para obter os parâmetros de conexão compatíveis, consulte [Parâmetros de conexão do JDBC 3.x do Amazon Athena](jdbc-v3-driver-connection-parameters.md).

### Em uma aplicação personalizada
<a name="jdbc-v3-driver-configuring-in-a-custom-application"></a>

Para definir os parâmetros de conexão do driver JDBC em uma aplicação personalizada, faça um dos seguintes procedimentos:
+ Adicione os nomes dos parâmetros e seus valores a um objeto `Properties`. Quando você chamar `Connection#connect`, passe esse objeto junto com a URL. Para obter um exemplo, consulte o exemplo de aplicação Java em [Executar o driver](#jdbc-v3-driver-running-the-driver).
+ Na string de conexão (a URL), use o formato a seguir para adicionar os nomes dos parâmetros e seus valores diretamente após o prefixo do protocolo.

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

  Use um ponto e vírgula no final de cada par nome/valor do parâmetro e não deixe espaço em branco após o ponto e vírgula, como no exemplo a seguir.

  ```
  String url = "jdbc:athena://WorkGroup=primary;Region=us-east-1;...;";AthenaDriver driver = new AthenaDriver();Connection connection = driver.connect(url, null);
  ```
**nota**  
Se um parâmetro for especificado tanto na string de conexão quanto no objeto `Properties`, o valor na string de conexão terá precedência. Não é recomendável especificar o mesmo parâmetro em ambos os lugares.
+ Adicione os valores dos parâmetros como argumentos aos métodos de `AthenaDataSource`, como no exemplo a seguir.

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

### Em um cliente SQL de terceiros
<a name="jdbc-v3-driver-configuring-in-a-third-party-sql-client"></a>

Siga as instruções do cliente SQL que você estiver usando. Normalmente, o cliente fornece uma interface gráfica de usuário para inserir os nomes dos parâmetros e seus valores.

## Atualizar o driver Athena JDBC v2
<a name="jdbc-v3-driver-upgrading-from-the-athena-jdbc-v2-driver-to-v3"></a>

A maioria dos parâmetros de conexão do JDBC versão 3 é compatível retroativamente com o driver JDBC versão 2 (Simba). Isso significa que uma string de conexão da versão 2 pode ser reutilizada com a versão 3 do driver. Porém, alguns parâmetros de conexão foram alterados. Essas mudanças estão descritas aqui. Ao atualizar para o driver JDBC versão 3, atualize a configuração existente, se for o caso.

### Classe do driver
<a name="jdbc-v3-driver-upgrading-driver-class"></a>

Algumas ferramentas de BI solicitam que você forneça a classe do driver, encontrada no arquivo `.jar` do driver JDBC. A maioria das ferramentas encontra essa classe automaticamente. O nome totalmente qualificado da classe no driver da versão 3 é `com.amazon.athena.jdbc.AthenaDriver`. No driver da versão 2, a classe era `com.simba.athena.jdbc.Driver`.

### String de conexão
<a name="jdbc-v3-driver-upgrading-connection-string"></a>

O driver da versão 3 usa `jdbc:athena://` como protocolo no início do URL da string de conexão do JDBC. O driver da versão 3 também é compatível com o protocolo `jdbc:awsathena://` da versão 2, mas o uso do protocolo da versão 2 foi descontinuado. Para evitar comportamentos indefinidos, a versão 3 não aceita strings de conexão que comecem com `jdbc:awsathena://` se a versão 2 (ou qualquer outro driver que aceite strings de conexão que comecem com `jdbc:awsathena://`) tiver sido registrada com a classe [DriverManager](https://docs.oracle.com/javase/8/docs/api/java/sql/DriverManager.html).

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

O driver da versão 2 usa nomes totalmente qualificados para identificar os diferentes provedores de credenciais (por exemplo, `com.simba.athena.amazonaws.auth.DefaultAWSCredentialsProviderChain`). O driver da versão 3 usa nomes mais curtos (por exemplo, `DefaultChain`). Os novos nomes são descritos nas seções correspondentes para cada provedor de credenciais.

[Os provedores de credenciais personalizadas escritos para o driver da versão 2 precisam ser modificados para que o driver da versão 3 implemente a interface [AWSCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html) a partir do novo AWS SDK para Java em vez da interface AWSCredentialsProvider](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/AWSCredentialsProvider.html) a partir do AWS SDK para Java anterior.

`PropertiesFileCredentialsProvider` não é suportado no driver JDBC 3.x. O provedor foi usado no driver JDBC 2.x, mas pertence à versão anterior do AWS SDK para Java, que está chegando ao fim do suporte. Para obter a mesma funcionalidade no driver JDBC 3.x, use o provedor [Credenciais do perfil de configuração da AWS](jdbc-v3-driver-aws-configuration-profile-credentials.md).

### Nível de log
<a name="jdbc-v3-driver-upgrading-log-level"></a>

A tabela a seguir mostra as diferenças nos parâmetros de `LogLevel` dos drivers JDBC versão 2 e versão 3.


****  

| Versão do driver JDBC | Nome do parâmetro | Tipo de parâmetro | Valor padrão | Possíveis valores | Exemplo de string de conexão | 
| --- | --- | --- | --- | --- | --- | 
| v2 | LogLevel | Opcional | 0 | 0-6 | LogLevel=6; | 
| v3 | LogLevel | Opcional | TRACE | OFF, ERROR, WARN, INFO, DEBUG, TRACE | LogLevel=INFO; | 

### Recuperação da ID da consulta
<a name="jdbc-v3-driver-upgrading-query-id-retrieval"></a>

No driver da versão 2, você desempacota uma instância de `Statement` em `com.interfaces.core.IStatementQueryInfoProvider`, uma interface que tem dois métodos: `#getPReparedQueryId` e `#getQueryId`. Você pode usar esses métodos para obter o ID de execução da consulta que foi executada.

No driver da versão 3, você desempacota as instâncias `Statement`, `PreparedStatement` e `ResultSet` na interface `com.amazon.athena.jdbc.AthenaResultSet`. A interface tem um método: `#getQueryExecutionId`.

# Parâmetros de conexão do JDBC 3.x do Amazon Athena
<a name="jdbc-v3-driver-connection-parameters"></a>

Os parâmetros de conexão compatíveis são divididos aqui em três seções: [Parâmetros básicos de conexão](jdbc-v3-driver-basic-connection-parameters.md), [Parâmetros avançados de conexão](jdbc-v3-driver-advanced-connection-parameters.md) e [Parâmetros de conexão de autenticação](jdbc-v3-driver-authentication-connection-parameters.md). As seções Parâmetros de conexão avançados e Parâmetros de conexão de autenticação têm subseções que agrupam os parâmetros relacionados.

**Topics**
+ [Parâmetros básicos de conexão](jdbc-v3-driver-basic-connection-parameters.md)
+ [Parâmetros avançados de conexão](jdbc-v3-driver-advanced-connection-parameters.md)
+ [Parâmetros de conexão de autenticação](jdbc-v3-driver-authentication-connection-parameters.md)

# Parâmetros básicos de conexão
<a name="jdbc-v3-driver-basic-connection-parameters"></a>

As seções a seguir descrevem os parâmetros básicos de conexão do driver JDBC 3.x.

## Região
<a name="jdbc-v3-driver-region"></a>

A Região da AWS onde as consultas serão executadas. Para conferir a lista de regiões, consulte [Amazon Athena endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/athena.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Região | AwsRegion (obsoleto) | Obrigatório (mas se não for fornecido, será pesquisado usando [DefaultAwsRegionProviderChain](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/regions/providers/DefaultAwsRegionProviderChain.html))  | nenhuma | 

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

O catálogo que contém os bancos de dados e as tabelas que serão acessados com o driver. Para obter mais informações sobre o catálogo de dados, consulte [DataCatalog](https://docs.aws.amazon.com/athena/latest/APIReference/API_DataCatalog.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Catálogo | nenhuma | Opcional | AwsDataCatalog | 

## Banco de dados
<a name="jdbc-v3-driver-database"></a>

A banco de dados em que as consultas serão executadas. As tabelas que não são explicitamente qualificadas com um nome de banco de dados são resolvidas para esse banco de dados. Para obter informações sobre bancos de dados, consulte [Banco de dados](https://docs.aws.amazon.com/athena/latest/APIReference/API_Database.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Banco de dados | Schema | Opcional | padrão | 

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

O grupo de trabalho no qual as consultas serão executadas. Para obter mais informações sobre grupos de trabalho, consulte [Grupo de trabalho](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| WorkGroup | nenhuma | Opcional | principal | 

## Local de saída
<a name="jdbc-v3-driver-output-location"></a>

O local do Amazon S3 em que os resultados de consultas serão armazenados. Para obter informações sobre o local de saída, consulte [ResultConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultConfiguration.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| OutputLocation | S3OutputLocation (obsoleto) | Obrigatório (a menos que o grupo de trabalho especifique um local de saída) | nenhuma | 

# Parâmetros avançados de conexão
<a name="jdbc-v3-driver-advanced-connection-parameters"></a>

As seções a seguir descrevem os parâmetros avançados de conexão para o driver JDBC 3.x.

**Topics**
+ [Parâmetros da criptografia de resultados](#jdbc-v3-driver-result-encryption-parameters)
+ [Parâmetros de busca de resultados](#jdbc-v3-driver-result-fetching-parameters)
+ [Parâmetros de configuração do resultado](#jdbc-v3-driver-result-config)
+ [Parâmetros de reutilização dos resultados da consulta](#jdbc-v3-driver-query-result-reuse-parameters)
+ [Parâmetros de sondagem da execução de uma consulta](#jdbc-v3-driver-query-execution-polling-parameters)
+ [Parâmetros de substituição de endpoint](#jdbc-v3-driver-endpoint-override-parameters)
+ [Parâmetros de configuração de proxy](#jdbc-v3-driver-proxy-configuration-parameters)
+ [Parâmetros de registro em log](#jdbc-v3-driver-logging-parameters)
+ [Nome da aplicação](#jdbc-v3-driver-application-name)
+ [Teste de conexão](#jdbc-v3-driver-connection-test)
+ [Número de novas tentativas](#jdbc-v3-driver-number-of-retries)
+ [Tempo limite de rede](#jdbc-v3-driver-networktimeoutmillis)

## Parâmetros da criptografia de resultados
<a name="jdbc-v3-driver-result-encryption-parameters"></a>

Observe os seguintes pontos:
+ A chave do AWS KMS deve ser especificada quando `EncryptionOption` é `SSE_KMS` ou `CSE_KMS`.
+ A chave do AWS KMS não pode ser especificada quando a `EncryptionOption` não está especificada ou quando a `EncryptionOption` é `SSE_S3`.

### Opção de criptografia
<a name="jdbc-v3-driver-encryption-option"></a>

O tipo de criptografia a ser usado nos resultados de consultas quando eles são armazenados no Amazon S3. Para obter mais informações sobre as opções de criptografia, consulte [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html) na *Amazon Athena API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Possíveis valores | 
| --- | --- | --- | --- | --- | 
| EncryptionOption | S3OutputEncOption (obsoleto) | Opcional | nenhuma | SSE\$1S3, SSE\$1KMS, CSE\$1KMS | 

### Chave do KMS
<a name="jdbc-v3-driver-kms-key"></a>

O ARN ou ID da chave do KMS, se `SSE_KMS` ou `CSE_KMS` for escolhido como a opção de criptografia. Para obter mais informações, consulte [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html) na *Amazon Athena API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| KmsKey | S3OutputEncKMSKey (obsoleto) | Opcional | nenhuma | 

## Parâmetros de busca de resultados
<a name="jdbc-v3-driver-result-fetching-parameters"></a>

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

O buscador que será usado para baixar resultados das consultas.

O buscador de resultados padrão, `auto`, baixa os resultados das consultas diretamente do Amazon S3 sem usar as APIs do Athena. Quando não é possível fazer o download direto do S3, como nos casos em que os resultados da consulta estão criptografados com a opção `CSE_KMS`, o Athena automaticamente usa a API `GetQueryResultsStream` como alternativa.

O uso do buscador `auto` é recomendado na maioria das situações. Se suas políticas do IAM ou as políticas para o bucket do S3 usarem a condição [s3:CalledVia](security-iam-athena-calledvia.md) com a finalidade de limitar o acesso às solicitações de objetos do S3 provenientes do Athena, o buscador `auto` tentará primeiro fazer o download dos resultados do S3 e, em seguida, recorrerá à API `GetQueryResultsStream`. Nessa situação, é possível configurar o ResultFetcher para `GetQueryResultsStream`, evitando uma chamada de API adicional.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Possíveis valores | 
| --- | --- | --- | --- | --- | 
| ResultFetcher | nenhuma | Opcional | auto | auto, S3, GetQueryResults e GetQueryResultsStream | 

### Tamanho da busca
<a name="jdbc-v3-driver-fetch-size"></a>

O valor desse parâmetro é usado como o mínimo para buffers internos e como tamanho das páginas de destino ao buscar resultados. O valor 0 (zero) significa que o driver deve usar seus próprios padrões conforme descrito abaixo. O valor máximo é 1.000.000.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| FetchSize | RowsToFetchPerBlock (obsoleto) | Opcional | 0 | 
+ O buscador `GetQueryResults` sempre usará um tamanho de página de 1.000, que é o valor máximo permitido para a chamada de API. Quando o tamanho da busca é maior do de 1.000, várias chamadas sucessivas de API são feitas para preencher o buffer acima do mínimo.
+ O buscador `GetQueryResultsStream` usa o tamanho de busca configurado como o tamanho de página, ou 10.000 por padrão.
+ O buscador `S3` usa o tamanho de busca configurado como o tamanho de página, ou 10.000 por padrão.

## Parâmetros de configuração do resultado
<a name="jdbc-v3-driver-result-config"></a>

### Expected bucket owner (Proprietário esperado do bucket)
<a name="jdbc-v3-driver-exp-bucket-owner"></a>

O ID da conta do proprietário esperado do bucket do S3. Se o ID da conta que você fornecer não corresponder ao proprietário real do bucket, a solicitação falhará. Para obter mais informações sobre como verificar o proprietário do bucket do S3, consulte [Verificar a propriedade do bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-owner-condition.html#bucket-owner-condition-use).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ExpectedBucketOwner | nenhuma | Opcional | nenhuma | 

### Opção ACL
<a name="jdbc-v3-driver-acl"></a>

Indica que uma ACL predefinida do Amazon S3 deve ser configurada para controlar o proprietário dos resultados da consulta armazenados. Para mais informações sobre `AclOption`, consulte [AclConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_AclConfiguration.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Possíveis valores | 
| --- | --- | --- | --- | --- | 
| AclOption | nenhuma | Opcional | nenhuma | BUCKET\$1OWNER\$1FULL\$1CONTROL | 

## Parâmetros de reutilização dos resultados da consulta
<a name="jdbc-v3-driver-query-result-reuse-parameters"></a>

### Habilitar a reutilização de resultados
<a name="jdbc-v3-driver-enable-result-reuse"></a>

Especifica se os resultados anteriores para a mesma consulta poderão reutilizados quando uma consulta for executada. Para obter informações sobre a reutilização de resultados de consulta, consulte [ResultReuseByAgeConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| EnableResultReuseByAge | nenhuma | Opcional | FALSE | 

### Idade máxima para reutilização dos resultados
<a name="jdbc-v3-driver-result-reuse-max-age"></a>

Especifica, em minutos, a idade máxima do resultado de uma consulta anterior que o Athena deve considerar para reutilização. Para obter informações sobre a idade máxima para reutilização de resultados, consulte [ResultReuseByAgeConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| MaxResultReuseAgeInMinutes | nenhuma | Opcional | 60 | 

## Parâmetros de sondagem da execução de uma consulta
<a name="jdbc-v3-driver-query-execution-polling-parameters"></a>

### Intervalo mínimo para a sondagem da execução de uma consulta
<a name="jdbc-v3-driver-minimum-query-execution-polling-interval"></a>

O tempo mínimo, em milissegundos, a ser aguardado antes de sondar o Athena sobre o status da execução de uma consulta.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| MinQueryExecutionPollingIntervalMillis | MinQueryExecutionPollingInterval (obsoleto) | Opcional | 100 | 

### Intervalo máximo para sondagem da execução de uma consulta
<a name="jdbc-v3-driver-maximum-query-execution-polling-interval"></a>

O tempo máximo, em milissegundos, a ser aguardado antes de sondar o Athena sobre o status da execução de uma consulta.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| MaxQueryExecutionPollingIntervalMillis | MaxQueryExecutionPollingInterval (obsoleto) | Opcional | 5000 | 

### Multiplicador do intervalo de sondagem da execução de uma consulta
<a name="jdbc-v3-driver-query-execution-polling-interval-multiplier"></a>

O fator de aumento do período de sondagem. Por padrão, a sondagem começa com o valor de `MinQueryExecutionPollingIntervalMillis` e dobra a cada sondagem até atingir o valor de `MaxQueryExecutionPollingIntervalMillis`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| QueryExecutionPollingIntervalMultiplier | nenhuma | Opcional | 2 | 

## Parâmetros de substituição de endpoint
<a name="jdbc-v3-driver-endpoint-override-parameters"></a>

### Substituição do endpoint do Athena
<a name="jdbc-v3-driver-athena-endpoint-override"></a>

O endpoint que o driver usará para fazer chamadas de API para o Athena.

Observe os seguintes pontos:
+ Se os protocolos `https://` ou `http://` não forem especificados na URL fornecida, o driver inserirá o prefixo `https://`.
+ Se esse parâmetro não for especificado, o driver usará um endpoint padrão.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| AthenaEndpoint | EndpointOverride (obsoleto) | Opcional | nenhuma | 

### Substituição de endpoint de serviço de streaming do Athena
<a name="jdbc-v3-driver-athena-streaming-service-endpoint-override"></a>

O endpoint que o driver usará para baixar os resultados das consultas quando usar o serviço de streaming do Athena. O serviço de streaming do Athena está disponível na porta 444.

Observe os seguintes pontos:
+ Se os protocolos `https://` ou `http://` não forem especificados na URL fornecida, o driver inserirá o prefixo `https://`.
+ Se uma porta não for especificada na URL fornecida, o driver inserirá a porta 444 do serviço de streaming.
+ Se o parâmetro `AthenaStreamingEndpoint` não for especificado, o driver usará a substituição do `AthenaEndpoint`. Se nem o `AthenaStreamingEndpoint` nem a substituição do `AthenaEndpoint` forem especificados, o driver usará um endpoint de streaming padrão.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| AthenaStreamingEndpoint | StreamingEndpointOverride (obsoleto) | Opcional | nenhuma | 

### Substituição de endpoint do LakeFormation
<a name="jdbc-v3-driver-athena-lake-formation-endpoint-override"></a>

O endpoint que o driver usará para o serviço Lake Formation quando usar a API [AssumeDecorateRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) do AWS Lake Formation para recuperar credenciais temporárias. Se esse parâmetro não for especificado, o driver usará um endpoint padrão do Lake Formation.

Observe os seguintes pontos:
+ Se os protocolos `https://` ou `http://` não forem especificados na URL fornecida, o driver inserirá o prefixo `https://`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| LakeFormationEndpoint |  LfEndpointOverride (obsoleto)  | Opcional | nenhuma | 

### Substituição de endpoint do S3
<a name="jdbc-v3-driver-athena-s3-endpoint-override"></a>

O endpoint que o driver usará para baixar os resultados das consultas quando usar o buscador do Amazon S3. Se esse parâmetro não for especificado, o driver usará um endpoint padrão do Amazon S3.

Observe os seguintes pontos:
+ Se os protocolos `https://` ou `http://` não forem especificados na URL fornecida, o driver inserirá o prefixo `https://`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| S3Endpoint | Nenhum | Opcional | nenhuma | 

### Substituição de endpoint do STS
<a name="jdbc-v3-driver-athena-sts-endpoint-override"></a>

O endpoint que o driver usará para o serviço AWS STS quando usar a API [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) do AWS STS para recuperar as credenciais temporárias. Se esse parâmetro não for especificado, o driver usará um endpoint padrão do AWS STS.

Observe os seguintes pontos:
+ Se os protocolos `https://` ou `http://` não forem especificados na URL fornecida, o driver inserirá o prefixo `https://`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| StsEndpoint | StsEndpointOverride(obsoleto) | Opcional | nenhuma | 

### Substituição de endpoint OIDC de SSO
<a name="jdbc-v3-driver-athena-sso-oidc-endpoint-override"></a>

O endpoint que o driver usará ao utilizar `ClientConfiguration.endpointOverride` para substituir o endpoint HTTP padrão para o cliente SSO OIDC. Para obter mais informações, consulte [ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| SSOOIDCEndpointOverride |  | Opcional | nenhuma | 

### Substituição do endpoint de SSO Admin
<a name="jdbc-v3-driver-athena-sso-admin-endpoint-override"></a>

O endpoint que o driver usará ao utilizar `ClientConfiguration.endpointOverride` para substituir o endpoint HTTP padrão para o cliente de SSO Admin. Para obter mais informações, consulte [ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| SSOAdminEndpointOverride |  | Opcional | nenhuma | 

## Parâmetros de configuração de proxy
<a name="jdbc-v3-driver-proxy-configuration-parameters"></a>

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

A URL do host proxy. Use esse parâmetro se você precisar que as solicitações do Athena passem por um proxy.

**nota**  
 Certifique-se de incluir o protocolo `https://` ou `http://` no início da URL do `ProxyHost`. 


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ProxyHost | nenhuma | Opcional | nenhuma | 

### Porta do proxy
<a name="jdbc-v3-driver-proxy-port"></a>

A porta a ser usada no host proxy. Use esse parâmetro se você precisar que as solicitações do Athena passem por um proxy.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ProxyPort | nenhuma | Opcional | nenhuma | 

### Nome de usuário do proxy
<a name="jdbc-v3-driver-proxy-username"></a>

O nome de usuário para autenticação no servidor proxy. Use esse parâmetro se você precisar que as solicitações do Athena passem por um proxy.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ProxyUsername | ProxyUID (obsoleto) | Opcional | nenhuma | 

### Senha do proxy
<a name="jdbc-v3-driver-proxy-password"></a>

A senha para a autenticação no servidor proxy. Use esse parâmetro se você precisar que as solicitações do Athena passem por um proxy.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ProxyPassword | ProxyPWD (obsoleto) | Opcional | nenhuma | 

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

Um conjunto dos nomes de host aos quais o driver se conecta sem usar um proxy quando o uso de proxy está habilitado (ou seja, quando os parâmetros de conexão `ProxyHost` e `ProxyPort` estão definidos). Os hosts devem ser separados pelo caractere barra vertical (`|`) (por exemplo, `host1.com|host2.com`).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ProxyExemptHosts | NonProxyHost | Opcional | nenhuma | 

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

Especifica se um proxy deverá ser usado quando o driver se conectar a um provedor de identidades.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ProxyEnabledForIdP | UseProxyForIdP | Opcional | FALSE | 

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

Esta seção descreve os parâmetros relacionados a registro em log.

### Nível de log
<a name="jdbc-v3-driver-logging-parameters-log-level"></a>

Especifica o nível para o registro em log do driver. Nada é registrado em log, a menos que o parâmetro `LogPath` também esteja definido.

**nota**  
Recomendamos definir somente o parâmetro `LogPath`, a menos que você tenha requisitos especiais. Definir somente o parâmetro `LogPath` habilita o registro em log e usa o nível de log padrão `TRACE`. O nível do registro em log `TRACE` fornece o registro em log mais detalhado.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Possíveis valores | 
| --- | --- | --- | --- | --- | 
| LogLevel | nenhuma | Opcional | TRACE | OFF, ERROR, WARN, INFO, DEBUG, TRACE | 

### Caminho do log.
<a name="jdbc-v3-driver-logging-parameters-log-path"></a>

O caminho para um diretório no computador que executa o driver no qual os logs do driver serão armazenados. Um arquivo de log com um nome exclusivo será criado no diretório especificado. Se definido, habilita o registro em log do driver.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| LogPath | nenhuma | Opcional | nenhuma | 

## Nome da aplicação
<a name="jdbc-v3-driver-application-name"></a>

O nome da aplicação que usa o driver. Se um valor for especificado para esse parâmetro, esse valor será incluído na string de agente do usuário das chamadas de API que o driver fizer para o Athena.

**nota**  
Você também pode definir o nome da aplicação chamando `setApplicationName` no objeto `DataSource`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ApplicationName | nenhuma | Opcional | nenhuma | 

## Teste de conexão
<a name="jdbc-v3-driver-connection-test"></a>

Se definido como `TRUE`, o driver executa um teste de conexão toda vez que uma conexão JDBC é criada, mesmo que uma consulta não seja executada na conexão.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ConnectionTest | nenhuma | Opcional | TRUE | 

**nota**  
Um teste de conexão envia uma consulta `SELECT 1` ao Athena para verificar se a conexão foi configurada corretamente. Isso significa que dois arquivos serão armazenados no Amazon S3 (o conjunto de resultados e os metadados), e tarifas adicionais podem ser aplicadas de acordo com a [política de preços do Amazon Athena](https://aws.amazon.com/athena/pricing).

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

O número máximo de vezes que o driver deve reenviar uma solicitação recuperável para o Athena.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| NumRetries | MaxErrorRetry (obsoleto) | Opcional | nenhuma | 

## Tempo limite de rede
<a name="jdbc-v3-driver-networktimeoutmillis"></a>

O tempo limite de rede controla a quantidade de tempo que o driver espera para que uma conexão de rede seja estabelecida. Isso inclui o tempo necessário para enviar solicitações de API. Em raras circunstâncias, pode ser útil alterar o tempo limite da rede. Por exemplo, você pode querer aumentar o tempo limite para pausas longas na coleta de resíduos. Definir este parâmetro de conexão é equivalente a usar o método `setNetworkTimeout` em um objeto `Connection`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
|  NetworkTimeoutMillis  | nenhuma | Opcional | nenhuma | 

# Parâmetros de conexão de autenticação
<a name="jdbc-v3-driver-authentication-connection-parameters"></a>

O driver JDBC 3.x do Athena é compatível com vários métodos de autenticação. Os parâmetros de conexão necessários dependem do método de autenticação usado.

**Topics**
+ [IAM](jdbc-v3-driver-iam-credentials.md)
+ [Padrão](jdbc-v3-driver-default-credentials.md)
+ [Perfil de configuração da AWS](jdbc-v3-driver-aws-configuration-profile-credentials.md)
+ [Perfil da instância](jdbc-v3-driver-instance-profile-credentials.md)
+ [Personalizada](jdbc-v3-driver-custom-credentials.md)
+ [JWT](jdbc-v3-driver-jwt-credentials.md)
+ [Propagação de identidade confiável JWT](jdbc-v3-driver-jwt-tip-credentials.md)
+ [Propagação de identidade confiável via 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)
+ [Azure AD do navegador](jdbc-v3-driver-browser-azure-ad-credentials.md)
+ [SAML do navegador](jdbc-v3-driver-browser-saml-credentials.md)
+ [DataZone IdC](jdbc-v3-driver-datazone-idc.md)
+ [DataZone IAM](jdbc-v3-driver-datazone-iamcp.md)

# Credenciais do IAM
<a name="jdbc-v3-driver-iam-credentials"></a>

Você pode usar suas credenciais do IAM para se conectar ao Amazon Athena com o driver JDBC definindo os parâmetros de conexão a seguir.

## Usuário
<a name="jdbc-v3-driver-user"></a>

Seu ID de chave de acesso da AWS. Para obter informações sobre chaves de acesso, consulte [Credenciais de segurança da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) no *Guia do usuário do IAM*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Usuário | AccessKeyId | Obrigatório | nenhuma | 

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

O ID da chave secreta da AWS. Para obter informações sobre chaves de acesso, consulte [Credenciais de segurança da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) no *Guia do usuário do IAM*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Senha | SecretAccessKey | Opcional | nenhuma | 

## Token de sessão
<a name="jdbc-v3-driver-session-token"></a>

Caso esteja usando credenciais temporárias da AWS, você deve especificar o token da sessão. Para obter informações sobre credenciais temporárias, consulte [Credenciais de segurança temporárias no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html), no *Guia do usuário do IAM*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| SessionToken | nenhuma | Opcional | nenhuma | 

# Credenciais padrão
<a name="jdbc-v3-driver-default-credentials"></a>

Você pode usar as credenciais padrão que configura no sistema cliente para se conectar ao Amazon Athena definido os parâmetros de conexão a seguir. Para obter informações sobre o uso de credenciais padrão, consulte [Usar a cadeia de fornecedores de credenciais padrão](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html#credentials-default) no *Guia do desenvolvedor do AWS SDK para Java*.

## Provedor de credenciais
<a name="jdbc-v3-driver-credentials-provider"></a>

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como `DefaultChain`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | DefaultChain | 

# Credenciais do perfil de configuração da AWS
<a name="jdbc-v3-driver-aws-configuration-profile-credentials"></a>

Você pode usar as credenciais armazenadas em um perfil de configuração da AWS definindo os parâmetros de conexão a seguir. Os perfis de configuração da AWS geralmente são armazenados em arquivos no diretório `~/.aws`. Para obter informações sobre os perfis de configuração da AWS, consulte [Use profiles](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/credentials-profiles.html) no *AWS SDK para Java Developer Guide*.

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

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como `ProfileCredentials`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | ProfileCredentials | 

## Profile name
<a name="jdbc-v3-driver-profile-name"></a>

O nome do perfil de configuração da AWS cujas credenciais devem ser usadas para autenticar a solicitação ao Athena.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ProfileName | nenhuma | Obrigatório | nenhuma | 

**nota**  
O nome do perfil também pode ser especificado como o valor do parâmetro `CredentialsProviderArguments`, embora esse uso esteja obsoleto.

# Credenciais de perfil de instância
<a name="jdbc-v3-driver-instance-profile-credentials"></a>

Esse tipo de autenticação é usado em instâncias do Amazon EC2. Um *perfil de instância* é um perfil associado a uma instância do Amazon EC2. O uso de um provedor de credenciais de perfil de instância delega o gerenciamento de credenciais da AWS ao Serviço de metadados de instância do Amazon EC2. Isso elimina a necessidade de desenvolvedores armazenarem credenciais permanentemente na instância do Amazon EC2 ou de se preocuparem com o rodízio ou o gerenciamento de credenciais temporárias.

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

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como `InstanceProfile`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | InstanceProfile | 

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

Você pode usar esse tipo de autenticação para fornecer suas próprias credenciais usando uma classe Java que implemente a interface [AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html).

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

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como o nome de classe totalmente qualificado da classe personalizada que implementa a interface [AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html). No runtime, essa classe deve estar no caminho da classe Java da aplicação que usa o driver JDBC.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | O nome da classe totalmente qualificado da implementação personalizada do AwsCredentialsProvider | 

## Argumentos do provedor de credenciais
<a name="jdbc-v3-driver-credentials-provider-arguments"></a>

Uma lista separada por vírgulas de argumentos de string para o construtor do provedor de credenciais personalizadas.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| CredentialsProviderArguments | AwsCredentialsProviderArguments (obsoleto) | Opcional | nenhuma | 

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

Com esse tipo de autenticação, você pode usar um token Web JSON (JWT) obtido de um provedor de identidades externo como parâmetro de conexão para autenticação no Athena. O provedor externo de credenciais já deve ser federado com a AWS.

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

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como `JWT`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | JWT | 

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

O token JWT obtido de um provedor de identidades federado externo. Esse token será usado para autenticação no Athena.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| JwtWebIdentityToken | web\$1identity\$1token (obsoleto) | Obrigatório | nenhuma | 

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

O nome do recurso da Amazon (ARN) da função a ser assumida. Para obter informações sobre como assumir perfis, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *AWS Security Token Service API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| JwtRoleArn | role\$1arn (obsoleto) | Obrigatório | nenhuma | 

## Nome da sessão do perfil do JWT
<a name="jdbc-v3-driver-jwt-role-session-name"></a>

O nome da sessão quando você usa as credenciais do JWT para autenticação. O nome pode ser qualquer nome que você escolher.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| JwtRoleSessionName | role\$1session\$1name (obsoleto) | Obrigatório | nenhuma | 

## Duração da sessão da função
<a name="jdbc-v3-driver-jwt-role-session-duration"></a>

A duração, em segundos, da sessão do perfil. Para obter mais informações, consulte [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html) na *AWS Security Token Service API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (obsoleto) | Opcional | 3600 | 

# JWT com integração ao Centro de Identidade
<a name="jdbc-v3-driver-jwt-tip-credentials"></a>

Esse tipo de autenticação permite usar um JSON Web Token (JWT) obtido de um provedor de identidades externo como parâmetro de conexão para autenticação no Athena. É possível usar este plug-in para habilitar o suporte para identidades corporativas por meio da propagação de identidade confiável. Para obter mais informações sobre como usar a propagação de identidade confiável com drivers, consulte [Usar a propagação de identidade confiável com drivers do Amazon Athena](using-trusted-identity-propagation.md). Você também pode [configurar e implantar recursos usando o CloudFormation](using-trusted-identity-propagation-cloudformation.md).

Com a propagação de identidade confiável, o contexto de identidade é adicionado a um perfil do IAM para identificar o usuário que está solicitando acesso aos recursos da AWS. Para obter informações sobre como habilitar e usar a propagação de identidade confiável, consulte [O que é propagação de identidade confiável?](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation.html).

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

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como `JWT_TIP`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | JWT\$1TIP | 

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

O token JWT obtido de um provedor de identidades federado externo. Esse token será usado para autenticação no Athena. O cache de token é habilitado por padrão e permite que o mesmo token de acesso do Centro de Identidade seja usado em todas as conexões de driver. Recomendamos fornecer um novo token JWT ao "Testar a conexão", pois o token trocado está presente somente quando a instância do driver está ativa.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| JwtWebIdentityToken | web\$1identity\$1token (obsoleto) | Obrigatório | nenhuma | 

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

O nome do recurso da Amazon (ARN) do grupo de trabalho do Amazon Athena. Para obter mais informações sobre grupos de trabalho, consulte [WorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| WorkGroupArn | nenhuma | Obrigatório | primary | 

## ARN de perfil de aplicação JWT
<a name="jdbc-v3-driver-jwt-tip-application-role-arn"></a>

O ARN da função a ser assumida Esse perfil é usado para a troca de JWT, obtenção do ARN da aplicação gerenciada pelo cliente do Centro de Identidade do IAM por meio de tags de grupo de trabalho e obtenção do ARN do perfil de acesso. Para obter mais informações sobre como assumir perfis, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ApplicationRoleArn | nenhuma | Obrigatório | nenhuma | 

## Nome da sessão do perfil do JWT
<a name="jdbc-v3-driver-jwt-tip-role-session-name"></a>

O nome da sessão ao autenticar com credenciais JWT. Pode ser qualquer nome de sua escolha.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| JwtRoleSessionName | role\$1session\$1name (obsoleto) | Obrigatório | nenhuma | 

## Duração da sessão da função
<a name="jdbc-v3-driver-jwt-tip-session-duration"></a>

A duração, em segundos, da sessão do perfil. Para obter mais informações, consulte [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (obsoleto) | Opcional | 3600 | 

## ARN do perfil de acesso JWT
<a name="jdbc-v3-driver-jwt-tip-access-role-arn"></a>

O ARN da função a ser assumida Esse é o perfil assumido pelo serviço Athena para fazer chamadas em seu nome. Para obter informações sobre como assumir perfis, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *Referência da API do AWS Security Token Service*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| AccessRoleArn | nenhuma | Opcional | nenhuma | 

## ARN da aplicação gerenciado pelo cliente do Centro de Identidade do IAM
<a name="jdbc-v3-driver-jwt-tip-customer-idc-application-arn"></a>

O ARN da aplicação gerenciado pelo cliente do Centro de Identidade do IAM. Para obter mais informações, consulte [Aplicações gerenciadas pelo cliente](https://docs.aws.amazon.com/singlesignon/latest/userguide/customermanagedapps.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| CustomerIdcApplicationArn | nenhuma | Opcional | nenhuma | 

# Baseado em navegador com integração ao Centro de Identidade
<a name="jdbc-v3-driver-browser-oidc-tip-credentials"></a>

Esse tipo de autenticação permite buscar um novo JSON Web Token (JWT) de um provedor de identidades externo e autenticá-lo com o Athena. É possível usar este plug-in para habilitar o suporte para identidades corporativas por meio da propagação de identidade confiável. Para obter mais informações sobre como usar a propagação de identidade confiável com drivers, consulte [Usar a propagação de identidade confiável com drivers do Amazon Athena](using-trusted-identity-propagation.md). Você também pode [configurar e implantar recursos usando o CloudFormation](using-trusted-identity-propagation-cloudformation.md).

Com a propagação de identidade confiável, o contexto de identidade é adicionado a um perfil do IAM para identificar o usuário que está solicitando acesso aos recursos da AWS. Para obter informações sobre como habilitar e usar a propagação de identidade confiável, consulte [O que é propagação de identidade confiável?](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation.html).

**nota**  
O plug-in foi projetado especificamente para ambientes de área de trabalho de usuário único. Em ambientes compartilhados, como o Windows Server, os administradores do sistema são responsáveis por estabelecer e manter os limites de segurança entre os usuários.

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

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como `BrowserOidcTip`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | BrowserOidcTip | 

## URL de configuração bem conhecido do IDP
<a name="jdbc-v3-driver-browser-oidc-tip-idp-well-known-config"></a>

O URL de configuração bem conhecido do IDP é o endpoint que fornece os detalhes de configuração do OpenID Connect para seu provedor de identidades. Esse URL geralmente termina com `.well-known/openid-configuration` e contém metadados essenciais sobre os endpoints de autenticação, os recursos compatíveis e as chaves de assinatura de token. Por exemplo, se você estiver usando o *Okta*, o URL poderá ser similar a `https://your-domain.okta.com/.well-known/openid-configuration`.

Para a solução de problemas: se você receber erros de conexão, verifique se esse URL pode ser acessado pela sua rede e retorna um JSON de configuração válido do *OpenID Connect*. O URL deve poder ser acessado pelo cliente onde o driver está instalado e deve ser fornecido pelo administrador do provedor de identidades.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| IdpWellKnownConfigurationUrl | nenhuma | Obrigatório | nenhuma | 

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

O identificador de cliente emitido para a aplicação pelo provedor do OpenID Connect.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| OidcClientId | nenhuma | Obrigatório | nenhuma | 

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

O nome do recurso da Amazon (ARN) do grupo de trabalho do Amazon Athena que contém as tags de configuração da propagação de identidade confiável. Para obter mais informações sobre grupos de trabalho, consulte [WorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html). 

**nota**  
Esse parâmetro é diferente do parâmetro `Workgroup` que especifica onde as consultas serão executadas. Você deve definir os dois parâmetros:  
`WorkgroupArn`: aponta para o grupo de trabalho que contém as tags de configuração de propagação de identidade confiável
`Workgroup`: especifica o grupo de trabalho em que as consultas serão executadas
Embora normalmente façam referência ao mesmo grupo de trabalho, ambos os parâmetros devem ser definidos explicitamente para uma operação adequada.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| WorkGroupArn | nenhuma | Obrigatório | primary | 

## ARN de perfil de aplicação JWT
<a name="jdbc-v3-driver-browser-oidc-tip-application-role-arn"></a>

O ARN do perfil que será assumido na troca do JWT. Esse perfil é usado para a troca de JWT, obtenção do ARN da aplicação gerenciada pelo cliente do Centro de Identidade do IAM por meio de tags de grupo de trabalho e obtenção do ARN do perfil de acesso. Para obter mais informações sobre como assumir perfis, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html). 


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ApplicationRoleArn | nenhuma | Obrigatório | nenhuma | 

## Nome da sessão do perfil do JWT
<a name="jdbc-v3-driver-browser-oidc-tip-role-session-name"></a>

Um nome para a sessão do IAM. Esse pode ser qualquer nome que você deseje usar, mas, em geral, você passa o nome ou identificador que está associado ao usuário que está usando a aplicação. Dessa forma, as credenciais de segurança temporárias que a aplicação usa estão associadas a esse usuário. 


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| JwtRoleSessionName | role\$1session\$1name (obsoleto) | Obrigatório | nenhuma | 

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

O clientSecret é uma chave confidencial emitida pelo seu provedor de identidades que é usada para autenticar sua aplicação (cliente). Embora esse parâmetro seja opcional e possa não ser necessário para todos os fluxos de autenticação, ele fornece uma camada adicional de segurança quando usado. Se sua configuração de IDP exigir um segredo de cliente, você deverá incluir esse parâmetro com o valor fornecido pelo administrador do provedor de identidades.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| OidcClientSecret | nenhuma | Opcional | nenhuma | 

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

O escopo especifica o nível de acesso que sua aplicação está solicitando do provedor de identidades. Você deve incluir `openid` no escopo para receber um token de ID contendo reivindicações essenciais de identidade do usuário. Seu escopo pode precisar incluir permissões adicionais, como `email` ou `profile`, dependendo de quais reivindicações de usuário seu provedor de identidades (como *Microsoft Entra ID*) está configurado para incluir no token de ID. Essas reivindicações são essenciais para o mapeamento adequado da *Propagação de identidade confiável*. Se o mapeamento de identidades de usuários falhar, verifique se seu escopo inclui todas as permissões necessárias e se seu provedor de identidades está configurado para incluir as reivindicações necessárias no token de ID. Essas reivindicações devem corresponder à configuração de mapeamento do *Emissor de tokens confiáveis* no Centro de Identidade do IAM. 


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Escopo | nenhuma | Opcional | openid email offline\$1access | 

## Duração da sessão da função
<a name="jdbc-v3-driver-browser-oidc-tip-role-session-duration"></a>

A duração, em segundos, da sessão do perfil. Para obter mais informações, consulte [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (obsoleto) | Opcional | 3600 | 

## ARN do perfil de acesso JWT
<a name="jdbc-v3-driver-browser-oidc-tip-access-role-arn"></a>

O ARN do perfil que o Athena assume para fazer chamadas em seu nome. Para obter informações sobre como assumir perfis, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *Referência da API do AWS Security Token Service*. 


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| AccessRoleArn | nenhuma | Opcional | nenhuma | 

## ARN da aplicação gerenciado pelo cliente do Centro de Identidade do IAM
<a name="jdbc-v3-driver-browser-oidc-tip-customer-idc-application-arn"></a>

O ARN da aplicação gerenciado pelo cliente do Centro de Identidade do IAM. Para obter mais informações, consulte [Aplicações gerenciadas pelo cliente](https://docs.aws.amazon.com/singlesignon/latest/userguide/customermanagedapps.html).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| CustomerIdcApplicationArn | nenhuma | Opcional | nenhuma | 

## Número da porta do provedor de identidades
<a name="jdbc-v3-driver-browser-oidc-tip-idp-port-number"></a>

O número da porta local a ser usada para o servidor de retorno de chamada do OAuth 2.0. Isso é usado como redirect\$1uri, e você precisará inseri-lo na lista de permissões em sua aplicação do IDP. O redirect\$1uri padrão gerado é: http://localhost:7890/athena

**Atenção**  
Em ambientes compartilhados, como Windows Terminal Servers ou Remote Desktop Services, a porta de loopback (padrão: 7890) é compartilhada entre todos os usuários na mesma máquina. Os administradores do sistema podem mitigar possíveis riscos de sequestro de portas por meio de:  
Configuração de números de porta diferentes para diferentes grupos de usuários
Uso de políticas de segurança do Windows para restringir o acesso às portas
Implementação do isolamento de rede entre as sessões do usuário
Se esses controles de segurança não puderem ser implementados, recomendamos usar o plug-in de [propagação de identidade confiável via JWT](jdbc-v3-driver-jwt-tip-credentials.md), que não requer uma porta de loopback.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| IdpPortNumber | nenhuma | Opcional | 7890 | 

## Tempo limite de resposta do provedor de identidades
<a name="jdbc-v3-driver-browser-oidc-tip-idp-response-timeout"></a>

O tempo limite em segundos para aguardar a resposta de retorno de chamada do OAuth 2.0.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | nenhuma | Opcional | 120 | 

## Habilitar o armazenamento em cache de tokens
<a name="jdbc-v3-driver-browser-oidc-tip-enable-token-caching"></a>

O parâmetro EnableTokenCaching determina se o driver armazena em cache o token de autenticação entre as conexões. Definir EnableTokenCaching como true reduz os prompts de autenticação e melhora a experiência do usuário, mas deve ser usado com cautela. Essa configuração é mais adequada para ambientes de área de trabalho de usuário único. Em ambientes compartilhados como o Windows Server, é recomendável mantê-lo desabilitado para evitar o possível compartilhamento de tokens entre usuários com strings de conexão semelhantes. 

Para implantações empresariais usando ferramentas como o Tableau Server, recomendamos usar o plug-in de [propagação de identidade confiável via JWT](jdbc-v3-driver-jwt-tip-credentials.md) em vez desse método de autenticação. 


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| EnableTokenCaching | nenhuma | Opcional | FALSE | 

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

Um mecanismo de autenticação baseado em SAML que permite a autenticação no Athena usando o provedor de identidades do Azure AD. Esse método pressupõe que uma federação já tenha sido configurada entre o Athena e o Azure AD.

**nota**  
Alguns dos nomes de parâmetros presentes nesta seção têm aliases. Os aliases são equivalentes funcionais dos nomes dos parâmetros e foram fornecidos para disponibilizar a compatibilidade retroativa com o driver JDBC 2.x. Como os nomes dos parâmetros foram aprimorados para seguir uma convenção de nomenclatura mais clara e consistente, recomendamos que você os use em vez dos aliases, que foram descontinuados. 

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

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como `AzureAD`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | AzureAD | 

## Usuário
<a name="jdbc-v3-driver-azure-ad-user"></a>

O endereço de e-mail do usuário do Azure AD a ser usado para autenticação no Azure AD.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Usuário | UID (obsoleto) | Obrigatório | nenhuma | 

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

A senha do usuário do Azure AD.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Senha | PWD (obsoleto) | Obrigatório | nenhuma | 

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

O ID de locatário da aplicação do Azure AD.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| AzureAdTenantId | tenant\$1id (obsoleto) | Obrigatório | nenhuma | 

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

O ID de cliente da aplicação do Azure AD.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| AzureAdClientId | client\$1id (obsoleto) | Obrigatório | nenhuma | 

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

O segredo de cliente da aplicação do Azure AD.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| AzureAdClientSecret | client\$1secret (obsoleto) | Obrigatório | nenhuma | 

## Perfil preferencial
<a name="jdbc-v3-driver-preferred-role"></a>

O nome do recurso da Amazon (ARN) da função a ser assumida. Para obter informações sobre perfis de ARN, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *AWS Security Token Service API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (obsoleto) | Opcional | nenhuma | 

## Duração da sessão da função
<a name="jdbc-v3-driver-role-session-duration"></a>

A duração, em segundos, da sessão do perfil. Para obter mais informações, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *AWS Security Token Service API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (obsoleto) | Opcional | 3600 | 

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

Especifica se a ação da API [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) do Lake Formation deverá ser usada para recuperar credenciais temporárias do IAM em vez da ação da API [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) do AWS STS.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | nenhuma | Opcional | FALSE | 

# Credenciais do Okta
<a name="jdbc-v3-driver-okta-credentials"></a>

Um mecanismo de autenticação baseado em SAML que permite a autenticação no Athena usando o provedor de identidades do Okta. Esse método pressupõe que uma federação já tenha sido configurada entre o Athena e o Okta.

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

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como `Okta`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | Okta | 

## Usuário
<a name="jdbc-v3-driver-okta-user"></a>

O endereço de e-mail do usuário do Okta a ser usado para autenticação no Okta.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Usuário | UID (obsoleto) | Obrigatório | nenhuma | 

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

A senha para o usuário do Okta.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Senha | PWD (obsoleto) | Obrigatório | nenhuma | 

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

O URL de sua organização Okta. É possível extrair o parâmetro `idp_host` do URL do **link de incorporação** em sua aplicação Okta. Para obter as etapas, consulte [Recuperar informações de configuração de ODBC do Okta](odbc-okta-plugin.md#odbc-okta-plugin-retrieve-odbc-configuration-information-from-okta). O primeiro segmento depois de `https://`, até `okta.com`, inclusive, é o host de IdP (por exemplo, `trial-1234567.okta.com` para uma URL que começa com `https://trial-1234567.okta.com`).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| OktaHostName | IdP\$1Host (obsoleto) | Obrigatório | nenhuma | 

## ID da aplicação do Okta
<a name="jdbc-v3-driver-okta-application-id"></a>

O identificador de duas partes da aplicação. Você pode extrair o ID da aplicação da URL do **link embutido** na aplicação do Okta. Para obter as etapas, consulte [Recuperar informações de configuração de ODBC do Okta](odbc-okta-plugin.md#odbc-okta-plugin-retrieve-odbc-configuration-information-from-okta). O ID da aplicação são os dois últimos segmentos do URL, inclusive a barra no meio. Os segmentos são duas strings de 20 caracteres com uma mistura de números e letras maiúsculas e minúsculas (por exemplo, )., `Abc1de2fghi3J45kL678/abc1defghij2klmNo3p4`).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| OktaAppId | App\$1ID (obsoleto) | Obrigatório | nenhuma | 

## Nome da aplicação do Okta
<a name="jdbc-v3-driver-okta-application-name"></a>

O nome da aplicação do Okta.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| OktaAppName | App\$1Name (obsoleto) | Obrigatório | nenhuma | 

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

Se você configurou o Okta para exigir a autenticação multifator (MFA), precisará especificar o tipo de MFA do Okta e os parâmetros adicionais, dependendo do segundo fator que quiser usar.

O tipo de MFA do Okta é o segundo tipo de fator de autenticação (depois da senha) a ser usado para autenticação no Okta. Os segundos fatores compatíveis incluem as notificações por push enviadas pela aplicação Okta Verify e as senhas temporárias de uso único (TOTPs) geradas pelo Okta Verify, pelo Google Authenticator ou enviadas por SMS. As políticas de segurança de cada organização determinam se a MFA é necessária ou não para o login do usuário.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Possíveis valores | 
| --- | --- | --- | --- | --- | 
| OktaMfaType | okta\$1mfa\$1type (obsoleto) | Obrigatório, se o Okta for configurado para exigir MFA | nenhuma | oktaverifywithpush, oktaverifywithtotp, googleauthenticator, smsauthentication | 

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

O número de telefone para o qual o Okta enviará uma senha temporária de uso único por SMS quando o tipo de `smsauthentication` MFA for escolhido. O número de telefone deve ser um número de telefone nos EUA ou no Canadá.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| OktaPhoneNumber | okta\$1phone\$1number (obsoleto) | Obrigatório, se OktaMfaType for smsauthentication | nenhuma | 

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

A duração, em segundos, de espera até que o usuário confirme o recebimento de uma notificação por push do Okta antes que o driver gere uma exceção de tempo limite.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| OktaMfaWaitTime | okta\$1mfa\$1wait\$1time (obsoleto) | Opcional | 60 | 

## Perfil preferencial
<a name="jdbc-v3-driver-okta-preferred-role"></a>

O nome do recurso da Amazon (ARN) da função a ser assumida. Para obter informações sobre perfis de ARN, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *AWS Security Token Service API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (obsoleto) | Opcional | nenhuma | 

## Duração da sessão da função
<a name="jdbc-v3-driver-role-okta-session-duration"></a>

A duração, em segundos, da sessão do perfil. Para obter mais informações, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *AWS Security Token Service API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (obsoleto) | Opcional | 3600 | 

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

Especifica se a ação da API [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) do Lake Formation deverá ser usada para recuperar credenciais temporárias do IAM em vez da ação da API [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) do AWS STS.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | nenhuma | Opcional | FALSE | 

# Uso do Ping
<a name="jdbc-v3-driver-ping-credentials"></a>

Um mecanismo de autenticação baseado em SAML que permite a autenticação no Athena usando o provedor de identidades Ping Federate. Esse método pressupõe que uma federação já tenha sido configurada entre o Athena e o Ping Federate.

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

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como `Ping`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | Ping | 

## Usuário
<a name="jdbc-v3-driver-ping-user"></a>

O endereço de e-mail do usuário do Ping Federate a ser usado para autenticação no Ping Federate.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Usuário | UID (obsoleto) | Obrigatório | nenhuma | 

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

A senha do usuário do Ping Federate.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Senha | PWD (obsoleto) | Obrigatório | nenhuma | 

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

O endereço do servidor Ping. Para encontrar seu endereço, acesse o URL a seguir e visualize o campo **Endpoint da aplicação de SSO**.

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


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| PingHostName | IdP\$1Host (obsoleto) | Obrigatório | nenhuma | 

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

O número da porta a ser usada para se conectar ao host de IdP.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| PingPortNumber | IdP\$1Port (obsoleto) | Obrigatório | nenhuma | 

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

O endereço do provedor de serviços. Para encontrar o endereço do provedor de serviços, acesse o URL a seguir e visualize o campo **Endpoint da aplicação de SSO**.

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


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
|  PingPartnerSpId  | Partner\$1SPID (obsoleto) | Obrigatório | nenhuma | 

## Perfil preferencial
<a name="jdbc-v3-driver-ping-preferred-role"></a>

O nome do recurso da Amazon (ARN) da função a ser assumida. Para obter informações sobre perfis de ARN, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *AWS Security Token Service API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (obsoleto) | Opcional | nenhuma | 

## Duração da sessão da função
<a name="jdbc-v3-driver-role-ping-session-duration"></a>

A duração, em segundos, da sessão do perfil. Para obter mais informações, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *AWS Security Token Service API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (obsoleto) | Opcional | 3600 | 

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

Especifica se a ação da API [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) do Lake Formation deverá ser usada para recuperar credenciais temporárias do IAM em vez da ação da API [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) do AWS STS.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | nenhuma | Opcional | FALSE | 

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

Um mecanismo de autenticação baseado em SAML que viabiliza a autenticação no Athena usando o Microsoft Active Directory Federation Services (AD FS). Esse método pressupõe que o usuário já configurou uma federação entre o Athena e o AD FS.

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

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como `ADFS`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | ADFS | 

## Usuário
<a name="jdbc-v3-driver-adfs-credentials-user"></a>

O endereço de e-mail do usuário do AD FS a ser usado para autenticação no AD FS.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Usuário | UID (obsoleto) | Necessário para a autenticação baseada em formulário. Opcional para a autenticação integrada do Windows. | nenhuma | 

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

A senha do usuário do AD FS.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Senha | PWD (obsoleto) | Necessário para a autenticação baseada em formulário. Opcional para a autenticação integrada do Windows. | nenhuma | 

## Nome de host do ADFS
<a name="jdbc-v3-driver-adfs-credentials-adfshostname"></a>

O endereço do servidor AD FS.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| AdfsHostName | IdP\$1Host (obsoleto) | Obrigatório | nenhuma | 

## Número da porta do ADFS
<a name="jdbc-v3-driver-adfs-credentials-adfsportnumber"></a>

O número da porta a ser usada para se conectar ao servidor do AD FS.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| AdfsPortNumber | IdP\$1Port (obsoleto) | Obrigatório | nenhuma | 

## Parte confiável do ADFS
<a name="jdbc-v3-driver-adfs-credentials-adfsrelyingparty"></a>

A parte confiável. Use esse parâmetro para substituir o URL do endpoint da parte confiável do AD FS.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| AdfsRelyingParty | LoginToRP (obsoleto) | Opcional | urn:amazon:webservices | 

## WIA habilitado no ADFS
<a name="jdbc-v3-driver-adfs-credentials-adfswiaenabled"></a>

Booliano. Use esse parâmetro para habilitar a autenticação integrada do Windows (WIA) com o AD FS.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| AdfsWiaEnabled | none | Opcional | FALSE | 

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

O nome do recurso da Amazon (ARN) da função a ser assumida. Para obter informações sobre perfis 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) na *Referência do API do AWS Security Token Service*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (obsoleto) | Opcional | nenhuma | 

## Duração da sessão da função
<a name="jdbc-v3-driver-adfs-credentials-role-session-duration"></a>

A duração, em segundos, da sessão do perfil. Para obter mais informações, consulte [https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *Referência de APIs do AWS Security Token Service*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (obsoleto) | Opcional | 3600 | 

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

Especifica se deve usar a ação da API [https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) do Lake Formation para recuperar as credenciais temporárias do IAM em vez da ação de API [https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) do AWS STS.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | none | Opcional | FALSE | 

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

O Browser Azure AD é um mecanismo de autenticação baseado em SAML que funciona com o provedor de identidades do Azure AD e é compatível com autenticação multifator. Ao contrário do mecanismo padrão de autenticação do Azure AD, esse mecanismo não requer nome de usuário, senha ou segredo do cliente nos parâmetros de conexão. Assim como o mecanismo de autenticação padrão do Azure AD, o Browser Azure AD também pressupõe que o usuário já tenha configurado a federação entre o Athena e o Azure AD.

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

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como `BrowserAzureAD`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | BrowserAzureAD | 

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

O ID de locatário da aplicação do Azure AD


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| AzureAdTenantId | tenant\$1id (obsoleto) | Obrigatório | nenhuma | 

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

O ID de cliente da aplicação do Azure AD


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| AzureAdClientId | client\$1id (obsoleto) | Obrigatório | nenhuma | 

## Tempo limite de resposta do provedor de identidades
<a name="jdbc-v3-driver-identity-provider-response-timeout"></a>

O período de tempo, em segundos, até o driver parar de esperar a resposta SAML do Azure AD.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | idp\$1response\$1timeout (obsoleto) | Opcional | 120 | 

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

O nome do recurso da Amazon (ARN) da função a ser assumida. Para obter informações sobre perfis de ARN, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *AWS Security Token Service API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (obsoleto) | Opcional | nenhuma | 

## Duração da sessão da função
<a name="jdbc-v3-driver-browser-azure-ad-role-session-duration"></a>

A duração, em segundos, da sessão do perfil. Para obter mais informações, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *AWS Security Token Service API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (obsoleto) | Opcional | 3600 | 

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

Especifica se a ação da API [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) do Lake Formation deverá ser usada para recuperar credenciais temporárias do IAM em vez da ação da API [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) do AWS STS.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | nenhuma | Opcional | FALSE | 

# Credenciais do Browser SAML
<a name="jdbc-v3-driver-browser-saml-credentials"></a>

O Browser SAML é um plug-in de autenticação genérico que pode funcionar com provedores de identidades baseados em SAML e é compatível com autenticação multifator.

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

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como `BrowserSaml`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | BrowserSaml | 

## URL de login de autenticação única
<a name="jdbc-v3-driver-single-sign-on-login-url"></a>

O URL de autenticação única para a aplicação no provedor de identidades baseado em SAMAL.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| SsoLoginUrl | login\$1url (obsoleto) | Obrigatório | nenhuma | 

## Escutar porta
<a name="jdbc-v3-driver-listen-port"></a>

O número da porta que é usada para receber a resposta do SAML. Esse valor deve corresponder à URL com a qual você configurou o provedor de identidades baseado em SAML (por exemplo, `http://localhost:7890/athena`).


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ListenPort | listen\$1port (obsoleto) | Opcional | 7890 | 

## Tempo limite de resposta do provedor de identidades
<a name="jdbc-v3-driver-single-sign-on-login-url-identity-provider-response-timeout"></a>

O período de tempo, em segundos, até o driver parar de esperar a resposta SAML do Azure AD.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | idp\$1response\$1timeout (obsoleto) | Opcional | 120 | 

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

O nome do recurso da Amazon (ARN) da função a ser assumida. Para obter informações sobre perfis de ARN, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *AWS Security Token Service API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (obsoleto) | Opcional | nenhuma | 

## Duração da sessão da função
<a name="jdbc-v3-driver-single-sign-on-login-url-role-session-duration"></a>

A duração, em segundos, da sessão do perfil. Para obter mais informações, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *AWS Security Token Service API Reference*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (obsoleto) | Opcional | 3600 | 

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

Especifica se a ação da API [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) do Lake Formation deverá ser usada para recuperar credenciais temporárias do IAM em vez da ação da API [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) do AWS STS.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | nenhuma | Opcional | FALSE | 

# Provedor de credenciais DataZone IdC
<a name="jdbc-v3-driver-datazone-idc"></a>

Um mecanismo de autenticação que permite a conexão com dados controlados pelo DataZone no Athena usando o Centro de Identidade do IAM.

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

O provedor de credenciais que será usado para autenticar solicitações à AWS. Defina o valor desse parâmetro como `DataZoneIdc`. Observe que o alias `AWSCredentialsProviderClass` está obsoleto; em vez disso, use o nome do parâmetro `CredentialsProvider`.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | Valor a ser usado | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (obsoleto) | Obrigatório | nenhuma | DataZoneIdc | 

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

Identificador do domínio DataZone a ser usado.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| DataZoneDomainId | nenhuma | Obrigatório | nenhuma | 

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

Identificador do ambiente DataZone a ser usado.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| DataZoneEnvironmentId | nenhuma | Obrigatório | nenhuma | 

## Região de domínio DataZone
<a name="jdbc-v3-driver-datazone-idc-datazone-domain-region"></a>

O local Região da AWS é onde seu domínio DataZone é provisionado.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| DataZoneDomainRegion | nenhuma | Obrigatório | nenhuma | 

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

O local Região da AWS onde seu ambiente DataZone e o grupo de trabalho Athena são provisionados.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Região | nenhuma | Obrigatório | nenhuma | 

## URL do emissor do Centro de Identidade do IAM
<a name="jdbc-v3-driver-datazone-idc-iam-identity-center-issuer-url"></a>

O URL do emissor da instância do Centro de Identidade do IAM que o domínio DataZone usa.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| IdentityCenterIssuerUrl | nenhuma | Obrigatório | nenhuma | 

## Substituição de endpoint do DataZone
<a name="jdbc-v3-driver-datazone-idc-datazone-endpoint-override"></a>

O endpoint da API DataZone a ser usado em vez do padrão para a Região da AWS fornecida.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| DataZoneEndpointOverride | nenhuma | Opcional | nenhuma | 

## Habilitar o armazenamento em cache de tokens
<a name="jdbc-v3-driver-datazone-idc-enable-token-caching"></a>

Quando habilitado, permite que o mesmo token de acesso do Centro de Identidade do IAM seja usado nas conexões do driver. Isso impede que ferramentas SQL que criam várias conexões de driver iniciem várias janelas do navegador. Se você habilitar esse parâmetro, recomendamos que você feche a ferramenta SQL imediatamente após usá-la para limpar o cache de tokens e exigir uma nova autenticação.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| EnableTokenCaching | nenhuma | Opcional | FALSE | 

## Escutar porta
<a name="jdbc-v3-driver-datazone-idc-listen-port"></a>

O número da porta que escuta a resposta do Centro de Identidade do IAM.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| ListenPort | nenhuma | Opcional | 8000 | 

## Tempo limite de resposta do provedor de identidades
<a name="jdbc-v3-driver-datazone-idc-identity-provider-response-time-out"></a>

O período de tempo, em segundos, até o driver parar de esperar a resposta do Centro de Identidade do IAM.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | nenhuma | Opcional | 120 | 

# Provedor de credenciais DataZone IAM
<a name="jdbc-v3-driver-datazone-iamcp"></a>

Um mecanismo de autenticação que usa credenciais do IAM para se conectar a dados governados pelo DataZone no Athena.

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

Identificador do domínio DataZone a ser usado.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| DataZoneDomainId | nenhuma | Obrigatório | nenhuma | 

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

Identificador do ambiente DataZone a ser usado.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| DataZoneEnvironmentId | nenhuma | Obrigatório | nenhuma | 

## Região de domínio DataZone
<a name="jdbc-v3-driver-datazone-iamcp-datazone-domain-region"></a>

O local Região da AWS é onde seu domínio DataZone é provisionado.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| DataZoneDomainRegion | nenhuma | Obrigatório | nenhuma | 

## Substituição de endpoint do DataZone
<a name="jdbc-v3-driver-datazone-iamcp-datazone-endpoint-override"></a>

O endpoint da API DataZone a ser usado em vez do padrão para a Região da AWS fornecida.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| DataZoneEndpointOverride | nenhuma | Opcional | nenhuma | 

## Usuário
<a name="jdbc-v3-driver-datazone-iamcp-user"></a>

Seu ID de chave de acesso da AWS. Para obter mais informações sobre chaves de acesso, consulte [Credenciais de segurança da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) no *Guia do usuário do IAM*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Usuário | AccessKeyId | Opcional | nenhuma | 

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

O ID da chave secreta da AWS. Para obter mais informações sobre chaves de acesso, consulte [Credenciais de segurança da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) no *Guia do usuário do IAM*.


****  

| Nome do parâmetro | Alias | Tipo de parâmetro | Valor padrão | 
| --- | --- | --- | --- | 
| Senha | SecretAccessKey | Opcional | nenhuma | 

# Outra configuração do JDBC 3.x
<a name="jdbc-v3-driver-other-configuration"></a>

As seções a seguir descrevem algumas configurações adicionais para o driver JDBC 3.x.

## Tempo limite de rede
<a name="jdbc-v3-driver-network-timeout"></a>

O tempo limite de rede controla a quantidade de tempo em milissegundos que o driver espera para que uma conexão de rede seja estabelecida. Isso inclui o tempo necessário para enviar solicitações de API. Após esse período, o driver gera uma exceção de tempo limite. Em raras circunstâncias, pode ser útil alterar o tempo limite da rede. Por exemplo, você pode querer aumentar o tempo limite para pausas longas na coleta de resíduos.

Para configurá-lo, chame o método `setNetworkTimeout` em um objeto `Connection` JDBC. Esse valor pode ser alterado durante o ciclo de vida da conexão JDBC. Para ter mais informações, consulte [setNetworkTimeout](https://docs.oracle.com/javase/8/docs/api/java/sql/Connection.html#setNetworkTimeout-java.util.concurrent.Executor-int-) na documentação do Oracle JDBC API. Usar o método `setNetworkTimeout` equivale a definir o parâmetro de conexão [Tempo limite de rede](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-networktimeoutmillis). 

O exemplo a seguir define o tempo limite de rede como 5.000 milissegundos.

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

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

O tempo, em segundos, que o driver aguardará a conclusão de uma consulta no Athena após enviá-la. Após esse período, o driver tenta cancelar a consulta enviada e gera uma exceção de tempo limite.

O tempo limite da consulta não pode ser definido como um parâmetro de conexão. Para configurá-lo, chame o método `setQueryTimeout` em um objeto `Statement` JDBC. Esse valor pode ser alterado durante o ciclo de vida de uma instrução JDBC. O valor padrão desse parâmetro é `0` (zero). Um valor `0` significa que as consultas podem ser executadas até a sua conclusão (respeitados os [Service Quotas](service-limits.md)).

Os exemplos a seguir definem o tempo limite de consulta como 5.000 milissegundos.

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

# Notas de versão do JDBC 3.x do Amazon Athena
<a name="jdbc-v3-driver-release-notes"></a>

Estas notas de versão fornece detalhes de melhorias e correções no driver JDBC 3.x do Amazon Athena.

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

Lançado em 21/11/2025

### Melhorias
<a name="jdbc-v3-driver-release-notes-2025-11-21-improvements"></a>
+ **Plug-in de autenticação confiável de propagação de identidade do OIDC via navegador**: foi adicionado um novo plug-in de autenticação que permite a autenticação otimizada baseada em navegador com provedores de identidades do OpenID Connect (OIDC). Esse plug-in gerencia o fluxo completo do OAuth 2.0 por meio do seu navegador padrão, busca automaticamente o JSON Web Token (JWT) e se integra à propagação de identidade confiável. Projetado especificamente para ambientes de área de trabalho de usuário único, ele fornece uma experiência de autenticação mais simplificada em comparação com o tratamento manual do JWT. Para obter informações sobre a propagação de identidade confiável, consulte [O que é propagação de identidade confiável?](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html).

### Correções
<a name="jdbc-v3-driver-release-notes-2025-11-21-fixes"></a>
+ **Suporte aprimorado à precisão do carimbo de data e hora**: o driver agora oferece suporte total à precisão de milissegundos e nanossegundos nos valores de carimbos de data e hora retornados das consultas do Athena por meio do método `getTimestamp()`.
+ **Tratamento aprimorado de tipos complexos**: foram corrigidos problemas com a análise de tipos de dados aninhados (matrizes, estruturas e mapas) em ambas as operações de metadados gerais e `DatabaseMetaData#getColumns`, garantindo informações de tipo precisas para estruturas de dados complexas.
+ **Registro em log de erros aprimorado**: o registro em log foi aprimorado para falhas de busca de metadados do S3, fornecendo mensagens de erro mais claras e melhores informações de diagnóstico.

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

Lançada em 10/9/2025

### Melhorias
<a name="jdbc-v3-driver-release-notes-2025-09-10-improvements"></a>
+ **Plug-in de autenticação de propagação de identidade confiável JWT**: foi adicionado um novo plug-in de autenticação para oferecer suporte à integração da propagação de identidade confiável do JWT com drivers JDBC. Esse tipo de autenticação permite usar um JSON Web Token (JWT) obtido de um provedor de identidades externo como parâmetro de conexão para autenticação no Athena. Com a propagação de identidade confiável, o contexto de identidade é adicionado a um perfil do IAM para identificar o usuário que está solicitando acesso aos recursos da AWS. Para obter informações sobre como habilitar e usar a propagação de identidade confiável, consulte [O que é propagação de identidade confiável?](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html).
+ **Suporte a endpoints SSO OIDC e SSO Admin personalizados**: foi adicionado suporte a endpoints SSO OIDC e admin SSO personalizados no driver JDBC. Esse aprimoramento permite que você especifique seus próprios endpoints para serviços de SSO ao executar o JDBC por trás de VPCs.
+ **Atualização da versão do AWS SDK**: atualizamos a versão do AWS SDK usada no driver para 2.32.16 e atualizamos as dependências do projeto para a versão 3.6.0.

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

lançada em 17/07/2025

### Melhorias
<a name="jdbc-v3-driver-release-notes-2025-07-17-improvements"></a>
+ **Recursos de registro em log**: registro em log aprimorado das buscas do S3, elevando o nível do log a `INFO` e adicionando métricas para contagens de linhas, desvios e comprimento de objetos. Implementado rastreamento do ciclo de vida das conexões e otimizada a performance geral do registro em log.
+ **Tratamento de caracteres especiais**: melhor tratamento dos caracteres especiais para padrões `LIKE` em nomes de esquemas e de catálogos.
+ **Gerenciamento do estado da conexão**: gerenciamento aprimorado do estado da conexão para evitar possíveis erros, evitando chamadas de API após a conexão ser fechada e adicionando verificações de segurança para operações de consulta durante o encerramento.

### Correções
<a name="jdbc-v3-driver-release-notes-2025-07-17-fixes"></a>
+ **Metadados de consultas DDL**: corrigido o problema de `NoSuchKeyFound` com o tratamento de metadados de consultas DDL.

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

Liberado em 18/3/2025

### Melhorias
<a name="jdbc-v3-driver-release-notes-2025-03-18-improvements"></a>
+ **Parâmetros de configuração do resultado**: adição de suporte a dois novos parâmetros de conexão `ExpectedBucketOwner` e `AclOption`. Para obter mais informações, consulte [Parâmetros de configuração do resultado](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-result-config).
+ **Versão do AWS SDK**: a versão do AWS SDK usada no driver foi atualizada para 2.30.22.

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

Liberado em 18/2/2025

### Melhorias
<a name="jdbc-v3-driver-release-notes-2025-02-18-improvements"></a>
+ **Buscador de resultados**: agora, o driver seleciona automaticamente o método mais rápido para fazer o download dos resultados das consultas. Isso dispensa a necessidade de configurar manualmente o buscador na maioria das situações. Para obter mais informações, consulte [Parâmetros de busca de resultados](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-result-fetching-parameters).

### Correções
<a name="jdbc-v3-driver-release-notes-2025-02-18-fixes"></a>
+ **ResultSet**: agora, o driver lida com a iteração sobre os conjuntos de resultados de instruções de DDL que não produzem objetos de resultados no S3. Além disso, o driver retorna um objeto `ResultSet` vazio, em vez de um objeto com anulação, quando `GetQueryResultsStream` retorna uma página completamente em branco.
+ **ResultsStream**: o processo de transmissão de resultados foi otimizado ao remover chamadas desnecessárias para contar o número de linhas nos buffers internos.
+ **getTables**: a chamada `GetTables` foi otimizada ao lidar com os tipos de tabela com base nas respostas `ListTableMetadata` e `GetTableMetadata`.

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

Lançado em 30/10/2024

### Melhorias
<a name="jdbc-v3-driver-release-notes-2024-10-30-improvements"></a>
+ **Autenticação DataZone** — Foi adicionado suporte para os plug-ins de autenticação DataZone `DataZoneIdC` e `DataZoneIAM`. Para obter mais informações, consulte [Provedor de credenciais DataZone IdC](jdbc-v3-driver-datazone-idc.md) e [Provedor de credenciais DataZone IAM](jdbc-v3-driver-datazone-iamcp.md).
+ **Tempo limite da rede** — O tempo limite da rede agora pode ser definido usando o parâmetro de conexão `NetworkTimeoutMillis`. Anteriormente, ele só podia ser definido no próprio objeto `Connection`. Para obter mais informações, consulte [Tempo limite de rede](jdbc-v3-driver-other-configuration.md#jdbc-v3-driver-network-timeout).

### Correções
<a name="jdbc-v3-driver-release-notes-2024-10-30-fixes"></a>
+ **Manipulação de objetos vazios do S3** — O driver agora manipula objetos vazios no buscador do S3 em vez de lançar uma exceção Intervalo não satisfatório no Amazon S3.
+ **Registro** — O driver não registra mais a mensagem Itens solicitados para execução da consulta [...], mas a assinatura é cancelada após o consumo dos resultados da consulta.
+ **Strings de parâmetros vazios** — O driver agora manipula strings vazias presentes em um parâmetro de conexão como se o parâmetro não estivesse presente. Isso resolve problemas que ocorriam quando algumas ferramentas de BI passavam inadvertidamente strings vazias que causavam tentativas de autenticação não intencionais.

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

lançada em 29/07/2024

### Melhorias
<a name="jdbc-v3-driver-release-notes-2024-07-29-improvements"></a>
+ **Mapeamento de tipos de dados**: melhoria na conformidade com a especificação JDBC alterando a forma como o driver mapeia os tipos de dados `tinyint`, `smallint`, `row` e `struct` para objetos Java.
+ **Atualização da versão do AWS SDK**: a versão do AWS SDK usada no driver foi atualizada para 2.26.23.

### Correções
<a name="jdbc-v3-driver-release-notes-2024-07-29-fixes"></a>
+ **Comentários**: corrigido um problema com comentários de linha no final de uma instrução.
+ **Listagem de banco de dados**: corrigido um problema no qual listar os bancos de dados poderia entrar em um loop infinito quando a última página retornada pela API `ListDatabases` paginada estivesse vazia.

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

Lançado em 03/07/2024

### Melhorias
<a name="jdbc-v3-driver-release-notes-2024-07-03-improvements"></a>
+ **Provedor de credenciais de JWT** — Foi adicionado suporte para durações de sessão especificadas pelo usuário. Para obter mais informações, consulte [Duração da sessão da função](jdbc-v3-driver-jwt-credentials.md#jdbc-v3-driver-jwt-role-session-duration).

### Correções
<a name="jdbc-v3-driver-release-notes-2024-07-03-fixes"></a>
+ **Pool de threads** — Criado um `ThreadPoolExecutor` por conexão para tarefas assíncronas para evitar o uso do pool `ForkJoin`.
+ **Provedores de credenciais** — O host proxy agora é analisado para obter o esquema e o host quando o cliente HTTP está configurado para IdPs externos.
+ **Provedor de credenciais padrão** — Garantimos que o provedor de credenciais padrão não possa ser fechado pelo código do cliente.
+ **getColumns** — Corrigido um problema de propriedade da coluna `ORDINAL_COLUMN` no método `DatabaseMetaData#getColumns`.
+ **ResultSet** — Foi adicionado suporte para `Infinity`, `-Infinity` e `NaN` para `ResultSet.`. Corrigida uma discrepância entre o tipo de coluna retornado das operações de catálogo e o conjunto de resultados de uma consulta concluída.

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

Lançado em 26/04/2024

### Melhorias
<a name="jdbc-v3-driver-release-notes-2024-02-26-improvements"></a>
+ **Desempenho da operação de catálogo**: o desempenho foi aprimorado para operações de catálogo que não usam caracteres curinga.
+ **Alteração do intervalo mínimo de pesquisa**: o padrão do intervalo mínimo de pesquisa foi modificado para reduzir o número de chamadas de API que o driver faz para o Athena. As conclusões de consultas ainda são detectadas o mais rápido possível.
+ **Possibilidade de descoberta de ferramentas de BI**: o driver ficou mais facilmente detectável para ferramentas de business intelligence.
+ **Mapeamento de tipos de dados**: o mapeamento de tipos de dados para os tipos de dados DDL do Athena `binary`, `array` e `struct`foi aprimorado.
+ **Versão do AWS SDK**: a versão do AWS SDK usada no driver foi atualizada para 2.25.34.

### Correções
<a name="jdbc-v3-driver-release-notes-2024-02-26-fixes"></a>
+ **Listagens de tabelas de catálogos federados**: corrigido um problema que fazia com que catálogos federados retornassem uma lista vazia de tabelas.
+ **getSchemas**: corrigido um problema que fazia com que o método JDBC [DatabaseMetaData\$1getSchemas](https://docs.oracle.com/javase/8/docs/api/java/sql/DatabaseMetaData.html#getSchemas--) buscasse bancos de dados somente do catálogo padrão, e não de todos os catálogos.
+ **getColumns**: corrigido um problema que fazia com que um catálogo nulo fosse retornado quando o método JDBC [DatabaseMetaData\$1getSchemas](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-) era chamado com um nome de catálogo nulo.

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

Lançado em 15/02/2024

### Melhorias
<a name="jdbc-v3-driver-release-notes-2024-02-15-improvements"></a>
+ Suporte adicionado para autenticação integrada do Windows por meio do Microsoft Active Directory Federation Services (AD FS) e autenticação com base em formulário.
+ Para compatibilidade com versões anteriores da versão 2.x, o subprotocolo JDBC `awsathena` agora é aceito, mas produz um aviso de depreciação. Em vez disso, use o subprotocolo JDBC `athena`.
+ `AwsDataCatalog` agora é o padrão para o parâmetro do catálogo, e `default` é o padrão para o parâmetro do banco de dados. Essas alterações garantem que os valores corretos do catálogo e do banco de dados atuais sejam retornados em vez de nulos.
+ Em conformidade com a especificação JDBC, `IS_AUTOINCREMENT` e `IS_GENERATEDCOLUMN` agora retornam uma string vazia em vez de `NO`.
+ O tipo de dados `int` do Athena agora é mapeado para o mesmo tipo de JDBC `integer` do Athena, em vez de para `other`.
+ Quando os metadados da coluna do Athena não contêm os campos opcionais `precision` e `scale`, o driver agora retorna zero para os valores correspondentes em uma coluna `ResultSet`.
+ A versão do AWS SDK foi atualizada para 2.21.39.

### Correções
<a name="jdbc-v3-driver-release-notes-2024-02-15-fixes"></a>
+ Foi corrigido um problema com `GetQueryResultsStream` que causava a ocorrência de uma exceção quando resultados de texto simples do Athena tinham uma contagem de colunas inconsistente com a contagem de colunas nos metadados de resultados do Athena.

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

Lançado em 16/11/2023

O driver Athena JDBC 3.x é o driver de nova geração que oferece melhor desempenho e compatibilidade. O driver JDBC 3.x é compatível com a leitura de resultados de consultas diretamente no Amazon S3, o que melhora o desempenho de aplicações que consomem resultados de consultas de grande porte. O novo driver também tem menos dependências de terceiros, o que facilita a integração com ferramentas de BI e aplicações personalizadas.

# Versões anteriores do driver JDBC 3.x driver do Athena
<a name="jdbc-v3-driver-previous-versions"></a>

Recomendamos muito que você use a [versão mais recente](jdbc-v3-driver.md) do driver JDBC 3.x. A versão mais recente do driver contém as melhorias e correções mais recentes. Use uma versão mais antiga somente se sua aplicação apresentar incompatibilidades com a versão mais recente.

## Jar com dependências do driver JDBC
<a name="jdbc-v3-driver-download-uber-jar-previous"></a>

O download a seguir empacota o driver e todas as suas dependências no mesmo arquivo `.jar`. Esse download é comumente usado para clientes SQL de terceiros.
+ [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)
+ [uber jar 3.5.1](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)

## Jar sem dependências do driver JDBC
<a name="jdbc-v3-driver-download-lean-jar"></a>

O download a seguir é um arquivo `.zip` que contém o `.jar` sem dependências para o driver e arquivos `.jar` separados para as dependências do driver. Esse download é comumente usado para aplicações personalizadas que podem ter dependências conflitantes com as dependências que o driver usa. Esse download é útil se você quiser escolher quais dependências do driver incluir no jar sem dependências e quais excluir se a aplicação personalizada já contiver uma ou mais dependências.
+ [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)
+ [lean jar 3.5.1](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)