Driver JDBC 2.x do Athena - Amazon Athena

Driver JDBC 2.x do Athena

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. 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, disponível para download. Para obter informações sobre permissões, consulte Acesso por meio de conexões JDBC e ODBC. Para enviar comentários sobre o driver JDBC, envie um e-mail para 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 Política gerenciada AWS: AWSQuicksightAthenaAccess.

  • 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 ou consultas federadas), 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 versão 2.1.5 do driver JDBC está em conformidade com o padrão de dados da API 4.2 do JDBC e requer o JDK 8.0 ou versões posteriores. Para obter informações sobre como verificar a versão do Java Runtime Environment (JRE) que você usa, consulte a documentação do Java.

Use o link a seguir para baixar do arquivo .jar do driver JDBC 4.2.

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.

Driver JDBC 2.x sem AWS SDK

A versão 2.1.5 do driver JDBC está em conformidade com o padrão de dados da API 4.2 do JDBC e requer o JDK 8.0 ou versões posteriores. Para obter informações sobre como verificar a versão do Java Runtime Environment (JRE) que você usa, consulte a documentação do Java.

Use o link a seguir para baixar o arquivo .jar do driver JDBC 4.2 sem o SDK da AWS.

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.

Notas da versão, contrato de licença e avisos do driver JDBC 2.x

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.

Documentação do driver JDBC 2.x

Faça download da seguinte documentação do driver: