

# Driver JDBC 2.x do Athena
<a name="jdbc-v2"></a>

Você pode usar uma conexão JDBC para conectar o Athena às ferramentas de inteligência de negócios e outras aplicações, como o [SQL Workbench](http://www.sql-workbench.eu/downloads.html). Para isso, use os links do Amazon S3 nesta página para baixar, instalar e configurar o driver JDBC 2.x do Athena. Para obter informações sobre como criar o URL da conexão JDBC, consulte o [guia de instalação e configuração do driver JDBC](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/Simba+Amazon+Athena+JDBC+Connector+Install+and+Configuration+Guide.pdf), disponível para download. Para obter informações sobre permissões, consulte [Controlar o acesso por conexões JDBC e ODBC](policy-actions.md). Para enviar comentários sobre o driver JDBC, envie um e-mail para [athena-feedback@amazon.com](mailto:athena-feedback@amazon.com). A partir da versão 2.0.24, duas versões do driver estão disponíveis: uma que inclui o AWS SDK e uma que não o inclui.

**Importante**  
Ao usar o driver JDBC, observe os 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. Se a porta 444 estiver bloqueada, você pode receber a mensagem de erro [Simba][AthenaJDBC](100123) Ocorreu um erro. Exceção durante a inicialização da coluna. 
**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). 
**Uso do driver JDBC para diversos catálogos de dados**: para usar o driver JDBC para diversos catálogos de dados com o Athena (por exemplo, ao usar um [metastore do Hive externo](connect-to-data-source-hive.md) ou [consultas federadas](federated-queries.md)), inclua `MetadataRetrievalMethod=ProxyAPI` em sua string de conexão JDBC. 
**Drivers 4.1**: a partir de 2023, a compatibilidade do driver para a versão 4.1 do JDBC será descontinuado. Nenhuma atualização adicional será lançada. Se você estiver usando um driver JDBC 4.1, é altamente recomendado fazer a migração para o driver 4.2. 

## Driver JDBC 2.x com AWS SDK
<a name="download-the-jdbc-driver"></a>

A versão 2.2.2 do driver JDBC está em conformidade com o padrão de dados de API do JDBC 4.2 e requer o JDK 8.0 ou posterior. Para obter informações sobre como verificar a versão do Java Runtime Environment (JRE) que você usa, consulte a [documentação](https://www.java.com/en/download/help/version_manual.html) do Java.

Use o link a seguir para baixar do arquivo `.jar` do driver JDBC 4.2.
+ [AthenaJDBC42-2.2.2.1000.jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/AthenaJDBC42-2.2.2.1000.jar)

O download do arquivo `.zip` contém o arquivo `.jar` para o JDBC 4.2 e inclui o SDK da AWS e a documentação, as notas de lançamento, as licenças e os contratos que o acompanham.
+ [SimbaAthenaJDBC-2.2.2.1000.zip](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/SimbaAthenaJDBC-2.2.2.1000.zip)

## Driver JDBC 2.x sem AWS SDK
<a name="download-the-jdbc-driver-no-sdk"></a>

A versão 2.2.2 do driver JDBC está em conformidade com o padrão de dados de API do JDBC 4.2 e requer o JDK 8.0 ou posterior. Para obter informações sobre como verificar a versão do Java Runtime Environment (JRE) que você usa, consulte a [documentação](https://www.java.com/en/download/help/version_manual.html) do Java.

Use o link a seguir para baixar o arquivo `.jar` do driver JDBC 4.2 sem o SDK da AWS.
+ [AthenaJDBC42-2.2.2.1001.jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1001/AthenaJDBC42-2.2.2.1001.jar)

O download do arquivo `.zip` contém o arquivo `.jar` para o JDBC 4.2 e a documentação, as notas de lançamento, as licenças e os contratos que o acompanham. O AWS SDK não está incluído.
+ [SimbaAthenaJDBC-2.2.2.1001.zip](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1001/SimbaAthenaJDBC-2.2.2.1001.zip)

## Notas da versão, contrato de licença e avisos do driver JDBC 2.x
<a name="atelong-jdbc-driver-license-agreement"></a>

Depois de fazer download da versão de que você precisa, leia as notas de release e revise o Contrato de licença e as notificações. 
+ [Notas de lançamento](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/release-notes.txt)
+ [Contrato de licença](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/LICENSE.txt)
+ [Notificações](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/NOTICES.txt)
+ [Licenças de terceiros](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/third-party-licenses.txt)

## Documentação do driver JDBC 2.x
<a name="jdbc-v2-documentation"></a>

Faça download da seguinte documentação do driver:
+ [Guia de instalação e configuração do driver JDBC](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/Simba+Amazon+Athena+JDBC+Connector+Install+and+Configuration+Guide.pdf). Use este guia para instalar e configurar o driver.
+ [Guia de migração do driver JDBC](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/Simba+Amazon+Athena+JDBC+Connector+Migration+Guide.pdf). Use este guia para migrar de versões anteriores para a versão atual.