

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á.

# Conecte-se ao Amazon DocumentDB usando DataGrip
<a name="data-grip-connect"></a>

[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 se conectar ao seu cluster Amazon DocumentDB usando DataGrip, permitindo que você gerencie e consulte facilmente seus dados usando uma interface gráfica.

## Pré-requisitos
<a name="data-grip-prerequisites"></a>
+ DataGrip IDE instalado em sua máquina. Você pode baixá-lo em [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 para uma instância do Amazon EC2, uma conexão VPN ou se você já estiver acessando sua AWS infraestrutura usando uma VPN segura. Se você preferir essa opção, siga as instruções para [acessar com segurança o Amazon DocumentDB usando](https://aws.amazon.com/blogs/database/securely-access-amazon-documentdb-with-mongodb-compatibility-locally-using-aws-client-vpn/). AWS Client VPN

## Conecte-se usando DataGrip
<a name="data-grip-connect-steps"></a>

1. Inicie DataGrip no seu computador e crie um **novo projeto**.  
![DataGrip tela de boas-vindas com a opção Novo Projeto destacada.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/welcome.png)

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**, escolha o novo ícone (**\+**) na barra de ferramentas. Navegue até **Fonte de dados** e selecione **DocumentDB**.  
![A lista suspensa para + mostra o submenu Fonte de dados. O DocumentDB é selecionado nesse submenu.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/explorer.png)

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. Escolha esse link para baixar os drivers necessários para interagir com um banco de dados. Para obter um link de download direto, consulte os drivers [JetBrains JDBC.](https://www.jetbrains.com/datagrip/jdbc-drivers/)  
![Interface de fontes de dados e drivers com o link Baixar arquivos de driver ausentes destacado.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/missing-driver.png)

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 anteriores.  
![Campos de host, porta, autenticação, banco de dados e URL na guia Geral na interface Fontes de dados e drivers.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/connection.png)

1. Na **SSH/SSL**guia, habilite **Usar túnel SSH** e escolha o í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.  
![A SSH/SSL guia na interface de fontes de dados e drivers com a opção Usar túnel SSH selecionada e o ícone de configuração SSH destacado. O ícone abre a interface Configurações de SSH exibida.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/ssh-tunnel.png)

1. Na **SSH/SSL**guia, 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.  
![SSH/SSL guia na interface Fontes de dados e drivers com as configurações de SSL ativadas.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/use-ssl.png)

1. Na guia **Esquemas**, escolha **Todos os bancos de dados** ou insira o filtro “\*: \*” no campo **Padrão do esquema**. Escolha **Testar conexão** para testar a conexão.  
![A guia Esquemas na interface Fontes de dados e drivers com a opção Todos os bancos de dados selecionada. Uma mensagem de êxito aparece acima do link Testar conexão.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/schemas.png)

1. Depois que a conexão for testada com sucesso, escolha **OK** para salvar a configuração da fonte de dados.

## DataGrip features
<a name="data-grip-features"></a>

DataGrip fornece vários recursos para ajudar você a trabalhar com o Amazon DocumentDB de forma eficiente:
+ **Editor SQL** — Escreva e execute SQL-like consultas em suas coleções do DocumentDB usando o editor SQL em. 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 em. DataGrip
+ **Exportar e importar dados** — Transfira dados entre o Amazon DocumentDB e outros bancos de dados usando os recursos DataGrip de exportação e importação do Amazon.

Consulte a [DataGrip documentação oficial para obter](https://www.jetbrains.com/datagrip/features/) recursos e dicas mais avançados sobre como trabalhar com o Amazon DocumentDB e outros sistemas de banco de dados.