Conecte-se usando o driver JDBC do Amazon DocumentDB - Amazon DocumentDB
Começar

Conecte-se usando o driver JDBC do Amazon DocumentDB

O driver JDBC para o Amazon DocumentDB fornece uma interface relacional SQL para desenvolvedores e permite a conectividade a partir de ferramentas de BI, como Tableau e DbVisualizer.

Para obter informações mais detalhadas, consulte a documentação do driver JDBC do Amazon DocumentDB no GitHub.

Tópicos

Começar

Etapa 1. Criar Amazon DocumentDB Cluster

Se você não tiver um cluster do Amazon DocumentDB criado, crie um usando as instruções na seção Conceitos básicos do Guia do desenvolvedor do Amazon DocumentDB.

nota

O Amazon DocumentDB é um serviço somente de nuvem privada virtual (VPC). Se você estiver se conectando a partir de uma máquina local, fora da VPC do cluster, precisará criar uma conexão SSH com uma instância do Amazon EC2. Nesse caso, inicie seu cluster usando as instruções em Conecte-se com EC2. Consulte Usando um túnel SSH para se conectar ao Amazon DocumentDB para obter mais informações sobre tunelamento SSH e quando você pode precisar dele.

Etapa 2. Instalação do JRE ou JDK

Dependendo da sua aplicação de BI, talvez seja necessário garantir que uma versão 8 ou posterior da instalação do JRE ou JDK de 64 bits esteja instalada no seu computador. É possível fazer o download do Java SE Runtime Environment 8 aqui.

Etapa 3. Faça o download do driver JDBC DocumentDB

Faça o download do driver JDBC do DocumentDB aqui. O driver é empacotado como um único arquivo JAR (por exemplo, documentdb-jdbc-1.0.0-all.jar).

Etapa 4: Usando um túnel SSH para se conectar ao Amazon DocumentDB

Os clusters do Amazon DocumentDB (compatível com MongoDB) são implantados dentro de uma Amazon Virtual Private Cloud (Amazon VPC). Eles podem ser acessados ​​diretamente por instâncias do Amazon EC2 ou outros AWS serviços implantados na mesma Amazon VPC. Além disso, o Amazon DocumentDB pode ser acessado por instâncias do EC2 ou outros AWS serviços em diferentes VPCs na mesma AWS Região ou outras regiões por meio de peering de VPC.

É possível usar o tunelamento SSH (também conhecido como encaminhamento de portas) para acessar seus recursos do Amazon DocumentDB, de fora da VPC do cluster. Esse será o caso da maioria dos usuários que não executam suas aplicações em uma VM na mesma VPC do cluster DocumentDB.

Para criar um túnel SSH, você precisa de uma instância do Amazon EC2 em execução na mesma Amazon VPC que seu cluster do Amazon DocumentDB. É possível usar uma instância do EC2 existente na mesma VPC que seu cluster ou criar uma instância. É possível configurar um túnel SSH para o cluster do Amazon DocumentDB sample-cluster.node.us-east-1.docdb.amazonaws.com executando o seguinte comando em seu computador local.

ssh -i "ec2Access.pem" -L 27017:sample-cluster.node.us-east-1.docdb.amazonaws.com:27017 ubuntu@ec2-34-229-221-164.compute-1.amazonaws.com -N

O sinalizador -L é usado para encaminhar uma porta local. Esse é um pré-requisito para se conectar a qualquer ferramenta de BI em execução em um cliente fora da sua VPC. Depois de executar a etapa acima, você pode passar para as próximas etapas da ferramenta de BI de sua escolha.

Para obter mais informações sobre o tunelamento SSH, consulte a documentação sobre Como usar um túnel SSH para se conectar ao Amazon DocumentDB.