As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Conectar-se ao Amazon DocumentDB usando o DataGrip
O [DataGrip](https://www.jetbrains.com/help/datagrip/documentdb.html) é 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. É possível fazer seu download pelo [JetBrains](https://www.jetbrains.com/datagrip/download/#section=windows).
+ 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](connect-ec2.md).
+ Alternativa a uma 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](https://aws.amazon.com/blogs/database/securely-access-amazon-documentdb-with-mongodb-compatibility-locally-using-aws-client-vpn/).
## Conectar-se usando o DataGrip
1. Inicie o DataGrip no seu computador e crie um **Novo projeto**.
1. 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**
1. No **Database Explorer**, clique no ícone novo (**\+**) na barra de ferramentas. Navegue até **Fonte de dados** e selecione **DocumentDB**.
1. Na página **Fontes de dados** na guia **Geral**, verifique se há um link para **Fazer o download dos arquivos de driver ausentes** na parte inferior da área de configurações da conexão. Clique neste link para fazer o download dos drivers necessários para interagir com um banco de dados. Para obter um link direto para fazer o download, consulte os [drivers JDBC da JetBrains](https://www.jetbrains.com/datagrip/jdbc-drivers/).
1. Na guia **Geral**, especifique os detalhes da conexão:
1. No campo **Host**, especifique o endpoint do cluster Amazon DocumentDB.
1. A **porta** já está definida como 27017. Altere-a se seu cluster foi implantado em uma porta diferente.
1. Em **Método de autenticação**, escolha **Nome e senha do usuário**.
1. Insira as informações de nome de usuário e senha.
1. O campo **Banco de dados** é opcional. É possível especificar o banco de dados ao qual deseja conectar-se.
1. O campo **URL** é preenchido automaticamente à medida que você adiciona os detalhes acima.
1. 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.
1. Insira o nome de usuário e senha da sua instância do Amazon EC2.
1. Em **Tipo de autenticação**, escolha **Par de chave**.
1. 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.
1. 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** como está.
**nota**
É possível fazer o download do certificado a partir deste local ou com este comando: wget [https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem](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.
1. 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.
1. 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](https://www.jetbrains.com/datagrip/features/) para obter mais atributos avançados, dicas sobre como trabalhar com o Amazon DocumentDB e outros sistemas de banco de dados.