Conecte-se usando o driver ODBC do Amazon DocumentDB - Amazon DocumentDB

Conecte-se usando o driver ODBC do Amazon DocumentDB

O driver ODBC para o Amazon DocumentDB fornece uma interface SQL relacional para desenvolvedores e permite a conectividade a partir de ferramentas de BI, como Power BI Desktop e Microsoft Excel.

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

Começar

Etapa 1. Criar clusters do Amazon DocumentDB

Se você ainda não tem um cluster do Amazon DocumentDB, há várias maneiras de começar.

nota

O Amazon DocumentDB é uma nuvem privada virtual (VPC) apenas de serviço. 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 Usar um túnel SSH para se conectar ao Amazon DocumentDB para obter mais informações sobre tunelamento SSH e quando você precisar dele.

Etapa 2. Instalação do JRE ou JDK

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

Etapa 3. Faça o download do driver ODBC do Amazon DocumentDB

Faça o download do driver ODBC do Amazon DocumentDB aqui. Escolha o instalador adequado (por exemplo, documentdb-odbc-1.0.0.msi). Siga o guia de instalação.

Etapa 4. Usar um túnel SSH para se conectar ao Amazon DocumentDB

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

No entanto, suponha que seu caso de uso exija que você (ou sua aplicação) acesse 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 Amazon DocumentDB. Ao se conectar de fora da VPC, é possível usar o tunelamento SSH (também conhecido como encaminhamento de portas) para acessar seus recursos do Amazon 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 ao executar 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, é possível 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.