# Como acessar o Amazon RDS usando o AWS Toolkit for JetBrains
Ao usar o Amazon Relational Database Service (Amazon RDS), é possível provisionar e gerenciar sistemas de banco de dados relacional SQL na nuvem. Ao usar o AWS Toolkit for JetBrains, é possível se conectar e interagir com os seguintes mecanismos de banco de dados do Amazon RDS:
+ Aurora: um banco de dados relacional compatível com MySQL e PostgreSQL compilado para a nuvem. Para obter mais informações, consulte o [https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html).
+ MySQL: o Amazon RDS oferece suporte a vários versionamentos importantes do banco de dados relacional de código aberto. Para obter mais informações, consulte [MySQL on Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html) no *Guia do usuário do Amazon RDS*.
+ PostgreSQL: o Amazon RDS oferece suporte a vários versionamentos importantes do banco de dados relacional de objeto de código aberto. Para obter mais informações, consulte [PostgreSQL on Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html) no *Guia do usuário do Amazon RDS*.
Os tópicos a seguir descrevem os pré-requisitos para acessar bancos de dados do RDS e como usar o AWS Toolkit for JetBrains para se conectar a uma instância de banco de dados.
**Topics**
+ [Pré-requisitos para acessar bancos de dados do Amazon RDS](rds-access-prerequisities.md)
+ [Como se conectar a um banco de dados do Amazon RDS](rds-connection.md)
# Pré-requisitos para acessar bancos de dados do Amazon RDS
Antes de se conectar a um banco de dados do Amazon RDS usando o AWS Toolkit for JetBrains, você precisa concluir as seguintes tarefas:
+ [Criar uma instância de banco de dados e configurar seu método de autenticação](#db-authentication)
+ [Baixar e instalar o DataGrip](#datagrip-info)
## Como criar uma instância de banco de dados do Amazon RDS e configurar um método de autenticação
O AWS Toolkit for JetBrains permite que você se conecte a uma instância de banco de dados do Amazon RDS que já foi criada e configurada na AWS. Uma instância de banco de dados é um ambiente de banco de dados isolado na nuvem que pode conter vários bancos de dados criados por usuários. Para obter informações sobre a criação de instâncias de banco de dados para os mecanismos de banco de dados compatíveis, consulte [Getting started with Amazon RDS resources](Amazon RDS User GuideCHAP_GettingStarted.html) no *Guia do usuário do Amazon RDS*.
Ao se conectar a um banco de dados usando o AWS Toolkit for JetBrains, os usuários podem optar por se autenticar usando as credenciais do IAM ou o Secrets Manager. A tabela a seguir descreve os principais atributos e recursos de informação para ambas as opções.
****
| Métodos de autenticação | Como funciona | Mais informações |
| --- | --- | --- |
| Conectar-se com credenciais do IAM | Com a autenticação do banco de dados do IAM, você não precisa armazenar as credenciais de usuário no banco de dados, pois a autenticação é gerenciada externamente usando as credenciais do AWS Identity and Access Management (IAM).Por padrão, a autenticação de banco de dados do IAM está desabilitada nas instâncias dos clusters de banco de dados. Você pode habilitar a autenticação de banco de dados do IAM (ou desabilitá-la novamente) usando o Console de gerenciamento da AWS, a AWS CLI ou a API. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/toolkit-for-jetbrains/latest/userguide/rds-access-prerequisities.html) |
| Conectar-se com o AWS Secrets Manager | Quem administra um banco de dados pode armazenar credenciais para um banco de dados em segredo no Secrets Manager. O Secrets Manager criptografa e armazena as credenciais secretamente como o *texto de segredo protegido*. Quando uma aplicação com permissões acessa o banco de dados, o Secrets Manager descriptografa o texto secreto protegido e o retorna por um canal seguro. O cliente analisa as credenciais retornadas, a string de conexão e todas as outras informações necessárias e, em seguida, utiliza essas informações para acessar o banco de dados. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/toolkit-for-jetbrains/latest/userguide/rds-access-prerequisities.html) |
## Como trabalhar com bancos de dados do Amazon RDS usando o DataGrip
Depois de se conectar a uma fonte de dados do Amazon RDS, você pode começar a interagir com ela. Ao usar o DataGrip do JetBrains, você pode realizar tarefas de banco de dados, como escrever SQL, executar consultas e importar ou exportar dados. Os atributos fornecidos pelo DataGrip também estão disponíveis no plug-in de banco de dados para uma variedade de IDEs do JetBrains. Para obter informações sobre o DataGrip, consulte [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/).
# Como se conectar a um banco de dados do Amazon RDS
Com o **Explorador da AWS**, você pode selecionar um banco de dados do Amazon RDS, escolher um método de autenticação e, em seguida, definir as configurações de conexão. Após testar a conexão com êxito, você pode começar a interagir com a fonte de dados usando o DataGrip daJetBrains.
**Importante**
Certifique-se de ter concluído os [pré-requisitos](rds-access-prerequisities.md) para permitir que os usuários acessem e interajam com os bancos de dados do Amazon RDS.
Selecione uma aba para obter instruções sobre como se conectar a uma instância de banco de dados usando seu método de autenticação preferencial.
------
#### [ Connect with IAM credentials ]
1. Abra o AWS Explorer, se ainda não estiver aberto.
1. Clique no nó do **Amazon RDS** para expandir a lista de mecanismos de banco de dados compatíveis.
1. Clique em um nó do mecanismo de banco de dados compatível (Aurora, MySQL ou PostgreSQL) para expandir a lista de instâncias de banco de dados disponíveis.
**nota**
Se você selecionar Aurora, poderá escolher entre expandir um cluster do MySQL e um cluster do PostgreSQL.
1. Clique com o botão direito em um banco de dados e escolha **Conectar-se com as credenciais do IAM**.
**nota**
Você pode também escolher **Copiar ARN** para adicionar o Nome do Recurso da Amazon (ARN) do banco de dados à sua área de transferência.
1. Na caixa de diálogo **Fonte de dados e drivers**, faça o seguinte para garantir que uma conexão com o banco de dados possa ser aberta:
+ No painel **Fontes de dados importadas**, confirme se a fonte de dados correta está selecionada.
+ Se uma mensagem indicar que você precisa **Baixar arquivos de driver ausentes**, escolha **Ir para o driver** (o ícone de chave inglesa) para baixar os arquivos necessários.
1. Na aba **Geral** do painel **Configurações**, confirme se os seguintes campos exibem os valores corretos:
+ **Host ou porta**: o endpoint e a porta usados para conexões com o banco de dados. Para bancos de dados do Amazon RDS hospedados na Nuvem AWS, os endpoints sempre terminam com `rds.amazon.com`. Se você estiver se conectando a uma instância de banco de dados por meio de um proxy, use esses campos para especificar os detalhes da conexão do proxy.
+ **Autenticação**: **AWS IAM** (autenticação usando credenciais do IAM).
+ **Usuário**: o nome da sua conta de usuário do banco de dados.
+ **Credenciais**: as credenciais usadas para acessar sua conta da AWS.
+ **Região**: a região da AWS em que o banco de dados está hospedado.
+ **Host ou porta do RDS**: o endpoint e a porta do banco de dados, conforme listado no Console de gerenciamento da AWS. Se você estiver usando um endpoint diferente para se conectar a uma instância de banco de dados, especifique os detalhes da conexão do proxy nos campos **Host ou porta** (descritos anteriormente).
+ **Banco de dados**: o nome do banco de dados.
+ **URL**: o URL que o IDE do JetBrains usará para se conectar ao banco de dados.
![\[Configurações de conexão para um banco de dados do Amazon RDS com credenciais do IAM usadas para autenticação.\]](http://docs.aws.amazon.com/pt_br/toolkit-for-jetbrains/latest/userguide/images/rds-auth-iam.png)
**nota**
Para obter uma descrição completa das definições de conexão que você pode configurar usando a caixa de diálogo **Fonte de dados e drivers**, consulte a [documentação para o IDE do JetBrains](https://www.jetbrains.com/help/) que você está usando.
1. Para verificar se as definições de conexão estão corretas, escolha **Testar conexão**.
Uma marca de seleção verde indica um teste bem-sucedido.
1. Escolha **Aplicar** para aplicar suas configurações e, em seguida, escolha **OK** para começar a trabalhar com a fonte de dados.
A janela da ferramenta **Banco de dados** é aberta. Isso exibe as fontes de dados disponíveis como uma árvore com nós representando elementos do banco de dados, como esquemas, tabelas e chaves.
**Importante**
Para usar a janela de ferramentas **Banco de dados**, você deve primeiro baixar e instalar o DataGrip do JetBrains. Para obter mais informações, consulte [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/).
------
#### [ Connect with Secrets Manager ]
1. Abra o AWS Explorer, se ainda não estiver aberto.
1. Clique no nó do **Amazon RDS** para expandir a lista de mecanismos de banco de dados compatíveis.
1. Clique em um nó do mecanismo de banco de dados compatível (Aurora, MySQL ou PostgreSQL) para expandir a lista de instâncias de banco de dados disponíveis.
**nota**
Se você selecionar Aurora, poderá escolher entre expandir um cluster do MySQL e um cluster do PostgreSQL.
1. Clique com o botão direito em um banco de dados e escolha **Conectar-se com o Secrets Manager**.
**nota**
Você pode também escolher **Copiar ARN** para adicionar o Nome do Recurso da Amazon (ARN) do banco de dados à sua área de transferência.
1. Na caixa de diálogo **Selecionar um segredo de banco de dados**, use o campo suspenso para selecionar credenciais para o banco de dados e, em seguida, escolha **Criar**.
1. Na caixa de diálogo **Fonte de dados e drivers**, faça o seguinte para garantir que uma conexão com o banco de dados possa ser aberta:
+ No painel **Fontes de dados importadas**, confirme se a fonte de dados correta está selecionada.
+ Se uma mensagem indicar que você precisa **Baixar arquivos de driver ausentes**, escolha **Ir para o driver** (o ícone de chave inglesa) para baixar os arquivos necessários.
1. Na aba **Geral** do painel **Configurações**, confirme se os seguintes campos exibem os valores corretos:
+ **Host ou porta**: o endpoint e a porta usados para conexões com o banco de dados. Para bancos de dados do Amazon RDS hospedados na Nuvem AWS, os endpoints sempre terminam com `rds.amazon.com`. Se você estiver se conectando a um banco de dados por meio de um banco de dados proxy, use esses campos para especificar os detalhes da conexão do proxy.
+ **Autenticação**: **SecretsManager Auth** (autenticação usando o AWS Secrets Manager).
+ **Credenciais**: as credenciais usadas para acessar sua conta da AWS.
+ **Região**: a região da AWS em que o banco de dados está hospedado.
+ **Nome secreto ou ARN**: o nome e o ARN do segredo que contém as credenciais de autenticação. Para substituir as configurações de conexão nos campos **Host ou porta**, selecione a caixa de seleção **Usar o URL e a porta do segredo**.
+ **Banco de dados**: o nome da instância do banco de dados que você selecionou no **Explorador da AWS**.
+ **URL**: o URL que o IDE do JetBrains usará para se conectar ao banco de dados.
**nota**
Se você estiver usando o Secrets Manager para autenticação, não há campos para nome de usuário e senha para o banco de dados. Essas informações estão contidas na parte de dados secretos criptografados de um segredo.
![\[Configurações de conexão com credenciais do IAM usadas para autenticação.\]](http://docs.aws.amazon.com/pt_br/toolkit-for-jetbrains/latest/userguide/images/rds-auth-asm.png)
**nota**
Para obter uma descrição completa das definições de conexão que você pode configurar usando a caixa de diálogo **Fonte de dados e drivers**, consulte a [documentação para o IDE do JetBrains](https://www.jetbrains.com/help/) que você está usando.
1. Para verificar se as definições de conexão estão corretas, escolha **Testar conexão**.
Uma marca de seleção verde indica um teste bem-sucedido.
1. Escolha **Aplicar** para aplicar suas configurações e, em seguida, escolha **OK** para começar a trabalhar com a fonte de dados.
A janela da ferramenta **Banco de dados** é aberta. Isso exibe as fontes de dados disponíveis como uma árvore com nós representando elementos do banco de dados, como esquemas, tabelas e chaves.
**Importante**
Para usar a janela de ferramentas **Banco de dados**, você deve primeiro baixar e instalar o DataGrip do JetBrains. Para obter mais informações, consulte [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/).
------