Conecte-se ao Amazon DocumentDB usando o DataGrip

O DataGrip é um poderoso ambiente de desenvolvimento integrado (IDE), que oferece suporte a vários sistemas de banco de dados incluindo o Amazon DocumentDB. Esta seção mostra as etapas para você se conectar ao seu cluster do Amazon DocumentDB usando o DataGrip, de maneira a permitir que você gerencie e consulte facilmente seus dados usando uma interface gráfica.

Pré-requisitos

• IDE DataGrip instalado em sua máquina. Você pode fazer seu download pelo JetBrains.

• Uma instância do Amazon EC2 em execução na mesma VPC que o seu cluster do Amazon DocumentDB. Você usará essa instância para estabelecer um túnel seguro da sua máquina local para o Amazon DocumentDBCluster. Siga estas instruções para saber como Conecte usando o Amazon EC2.

• Alternativa au ma instância do Amazon EC2, uma conexão VPN, ou se já estiver acessando sua infraestrutura AWS usando uma VPN segura. Se você preferir essa opção, siga as instruções para acessar com segurança o Amazon DocumentDB usando AWS Client VPN.

Conectar-se usando o DataGrip

1. Inicie o DataGrip no seu computador e crie um Novo projeto.

   

2. Adicione uma nova fonte de dados usando uma das seguintes maneiras:

   1. No menu principal, navegue até Arquivo — Novo — Fonte de dados e selecione DocumentDB

   2. No Database Explorer, clique no ícone novo (+) na barra de ferramentas. Navegue até Fonte de dados e selecione DocumentDB.

   

3. Na página Fontes de dados na guia Geral, verifique se há um link para Baixar arquivos de driver ausentes na parte inferior da área de configurações da conexão. Clique neste link para baixar os drivers necessários para interagir com um banco de dados. Para obter um link direto para download, consulte os drivers JDBC da JetBrains.

   

4. Na guia Geral, especifique os detalhes da conexão:

   1. No campo Host, especifique o endpoint do cluster Amazon DocumentDB.

   2. A porta já está definida como 27017. Altere-a se seu cluster foi implantado em uma porta diferente.

   3. Em Método de autenticação, escolha Nome e senha do usuário.

   4. Insira as informações de nome de usuário e senha.

   5. O campo Banco de dados é opcional. Você pode especificar o banco de dados ao qual deseja conectar-se.

   6. O campo URL é preenchido automaticamente à medida que você adiciona os detalhes acima.

   

5. Na guia SSH/SSL, habilite Usar túnel SSH e então, clique no ícone para abrir a caixa de diálogo Configuração SSH. Insira as seguintes informações:

   1. No campo Host, insira o nome do host da sua instância do Amazon EC2.

   2. Insira o nome de usuário e senha da sua instância do Amazon EC2.

   3. Em Tipo de autenticação, escolha Par de chave.

   4. Insira o arquivo de chave privada.

   nota

   Se você estiver usando a opção VPN, não há necessidade de configurar o túnel SSH.

   

6. Na guia SSH/SSL, habilite Usar SSL. No campo Arquivo CA, insira o local do arquivo global-bundle.pem no seu computador. EM Modo, deixe a opção Exigir.

   nota

   Você pode baixar o certificado a partir deste local ou com este comando: wget https://aws.amazon.com/https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem

   nota

   Se você estiver tentando conectar-se ao cluster elástico Amazon DocumentDB, não precisará especificar o arquivo CA. Deixe a opção Usar SSL, bem como todas as outras opções, marcada em seus valores padrão.

   

7. Na guia Esquemas, escolha Todos os bancos de dados ou insira o filtro “*: *” no campo Padrão do esquema. Clique no link Testar conexão para testar a conexão.

   

8. Depois que a conexão for testada com sucesso, clique em OK para salvar a configuração da fonte de dados.

Atributos do DataGrip

O DataGrip fornece vários atributos para ajudar a trabalhar com o Amazon DocumentDB de forma eficiente:

• Editor SQL — Escreva e execute consultas semelhantes a SQL em suas coleções do DocumentDB usando o editor SQL no DataGrip.

• Visual Query Builder — Use o Visual Query Builder para criar consultas graficamente sem gravar código SQL.

• Gerenciamento de esquemas — Gerencie facilmente seu esquema de banco de dados, inclusive a criação, alteração e eliminação de coleções.

• Visualização de dados — Visualize e analise seus dados usando várias ferramentas de visualização disponíveis no DataGrip.

• Exportar e importar dados — Transfira dados entre o Amazon DocumentDB e outros bancos de dados usando os atributos de exportação e importação do DataGrip.

Consulte a documentação oficial do DataGrip para obter mais atributos avançados, dicas sobre como trabalhar com o Amazon DocumentDB e outros sistemas de banco de dados.