View a markdown version of this page

Driver JDBC 3.x do Athena - Amazon Athena
Requisitos do sistemaConsiderações e limitaçõesDownload do driver JDBC 3.xPropagação de identidade confiável com JDBC

Driver JDBC 3.x do Athena

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

  • 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 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, 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.

  • Tipos de tabela: o método DatabaseMetaData.getTables relata as tabelas externas e federadas do Athena como o tipo de tabela TABLE do JDBC. Ele relata as visualizações do Athena como VIEW. Ao passar um filtro de tipo de tabela para getTables, use os nomes TABLE e VIEW do JDBC. Não use os nomes de tipo de tabela do Athena, como EXTERNAL_TABLE ou VIRTUAL_VIEW.

Download do driver JDBC 3.x

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.

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

Jar com dependências do driver JDBC

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.8.0 uber jar

Jar sem dependências do driver JDBC

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.8.0 lean jar

Licença

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

Licença

Propagação de identidade confiável com JDBC

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.

Tópicos