Criar uma instância de banco de dados PostgreSQL e conectar-se a um banco de dados em uma instância de banco de dados PostgreSQL - Amazon Relational Database Service

Criar uma instância de banco de dados PostgreSQL e conectar-se a um banco de dados em uma instância de banco de dados PostgreSQL

A maneira mais fácil de criar uma instância de banco de dados é usar o AWS Management Console. Depois de criar a instância de banco de dados, é possível usar os utilitários de cliente SQL padrão para se conectar à instância de banco de dados, como o utilitário pgAdmin. Neste exemplo, crie uma instância de banco de dados que executa o mecanismo de banco de dados PostgreSQL chamado database-1 com uma classe de instância de banco de dados db.r6g.large e 100 gibibytes (GiB) de armazenamento.

Importante

É necessário concluir as tarefas em Configuração do Amazon RDS antes de criar ou se conectar a uma instância de banco de dados.

Não há cobrança para criar uma conta da AWS. No entanto, ao concluir este tutorial, você poderá incorrer em custos para os recursos da AWS utilizados. Se esses recursos não forem mais necessários após a conclusão do tutorial, você poderá excluí-los.

Criar uma instância de banco de dados PostgreSQL

O bloco de construção básico do Amazon RDS é a instância do banco de dados. Este ambiente é onde você executa seus bancos de dados PostgreSQL.

Você pode usar a opção Easy create (Criação fácil) para criar uma instância de banco de dados executando o PostgreSQL com o AWS Management Console. Com a opção Easy create (Criação fácil) habilitada, é necessário especificar apenas o tipo do mecanismo de banco de dados, o tamanho da instância de banco de dados e o identificador da instância de banco de dados. A opção Easy create (Criação fácil) usa a configuração padrão para as outras opções de configuração. Com a opção Easy create (Criação fácil) desabilitada, em vez de Easy create (Criação fácil), você deve especificar mais opções de configuração ao criar um banco de dados, incluindo aquelas para disponibilidade, segurança, backups e manutenção.

Neste exemplo, use a opção Easy Create (Criação fácil) para criar uma instância de banco de dados executando o mecanismo de banco de dados PostgreSQL com uma classe de instância de banco de dados db.r6g.large.

nota

Para obter informações sobre como criar instâncias de banco de dados com o Standard create (Criação padrão), consulte Criar uma instância de banco de dados do Amazon RDS. Se desejar usar o nível gratuito, use Standard create (Criação padrão).

Para criar uma instância de banco de dados PostgreSQL com a criação fácil

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No canto superior direito do console do Amazon RDS, escolha a região da AWS na qual você deseja criar a instância de banco de dados.

  3. No painel de navegação, escolha Databases (Bancos de dados).

  4. Selecione a opção Create database (Criar banco de dados) e verifique se a opção Easy Create (Criação fácil) está habilitada.

    
    							Opção Easy create (Criação fácil)
  5. Em Configuration (Configuração), escolha PostgreSQL.

  6. Em DB instance size (Tamanho da instância de banco de dados), escolha Dev/Test (Desenvolvimento/teste).

  7. Em DB instance identifier (Identificador da instância de banco de dados), insira um nome para a instância de banco de dados ou deixe o nome padrão.

  8. Em Master username (Nome de usuário mestre), insira um nome para o usuário mestre ou deixe o nome padrão.

    A página Create database (Criar banco de dados) deve ser semelhante à seguinte imagem.

    
    							Página Create database (Criar banco de dados)
  9. Para usar uma senha primária gerada automaticamente para a instância de banco de dados, verifique se a caixa de seleção Auto generate a password (Gerar uma senha automaticamente) está selecionada.

    Para inserir sua senha primária, desmarque a caixa de seleção Auto generate a password (Gerar uma senha automaticamente) e insira a mesma senha em Master password (Senha primária) e em Confirm password (Confirmar senha).

  10. (Opcional) Abra View default settings for Easy create (Visualizar as configurações padrão da criação fácil).

    
    							Configurações de instância do RDS para PostgreSQL

    Você pode examinar as configurações padrão usadas com a opção Easy Create (Criação fácil). A coluna Editable after database is created (Editável após a criação do banco de dados) mostra quais opções podem ser alteradas após a criação do banco de dados.

    • Para alterar configurações com No (Não) nessa coluna, use Standard create (Criação padrão).

    • Para alterar configurações com Yes (Sim) nessa coluna, é possível usar Standard Create (Criação padrão) ou modificar a instância de banco de dados após ela ser criada para alterar as configurações.

    Observe as seguintes considerações importantes para alterar as configurações padrão:

    • Em alguns casos, é possível que sua instância de banco de dados use uma nuvem privada virtual (VPC) específica baseada no serviço Amazon VPC. Ou talvez você precise de um grupo de sub-rede ou grupo de segurança específico. Em caso afirmativo, use a opção Standard create (Criação padrão) para especificar esses recursos. Você pode ter criado esses recursos enquanto configurava o Amazon RDS. Para obter mais informações, consulte Fornecer acesso à instância de banco de dados na VPC criando um grupo de segurança.

    • Caso deseje poder acessar a instância de banco de dados de um cliente fora da sua VPC, use Standard create (Criação padrão) para definir Public access (Acesso público) como Yes (Sim).

      Se a instância de banco de dados deve ser privada, mantenha a opção Public access (Acesso público definida como No (Não).

    • Se desejar usar o nível gratuito, use Standard create (Criação padrão) para definir a versão do PostgreSQL inferior à versão 13 e, em seguida, escolha Free tier (Nível gratuito) em Templates (Modelos).

  11. Escolha Create database (Criar banco de dados).

    Se você optar por usar uma senha gerada automaticamente, o botão View credential details (Ver detalhes da credencial) será exibido na página Databases (Bancos de dados).

    Para visualizar o nome de usuário mestre e a senha da instância de banco de dados, escolha View credential details (Ver detalhes da credencial).

    
    							Credenciais de usuário mestre após a geração automática da senha.

    Para se conectar à instância de banco de dados como o usuário mestre, use o nome de usuário e a senha exibidos.

    Importante

    Não é possível visualizar a senha do usuário mestre novamente. Caso você não a registre, talvez seja necessário alterá-la.

    Se for necessário alterar a senha do usuário mestre depois que a instância de banco de dados estiver disponível, será possível modificar a instância de banco de dados para fazer isso. Para obter mais informações sobre a modificação de uma instância de banco de dados , consulte Modificar uma instância de banco de dados do Amazon RDS.

  12. Em Databases (Bancos de dados), escolha o nome da nova instância de banco de dados PostgreSQL.

    No console do RDS, os detalhes da nova instância de banco de dados são exibidos. A instância de banco de dados permanecerá no status Creating (Criando) até estar pronta para uso. Quando o status muda para Available (Disponível), você pode se conectar à instância de banco de dados. Dependendo da classe da instância de banco de dados e da quantidade de armazenamento, pode levar até 20 minutos para que a nova instância esteja disponível.

    
    							Captura de tela dos detalhes da instância de banco de dados.

Conectar-se a uma instância de banco de dados PostgreSQL

Depois que o Amazon RDS provisiona a sua instância de banco de dados, você pode usar qualquer aplicação cliente padrão SQL para se conectar à instância. A seguir, você verá duas formas de se conectar a uma instância de banco de dados PostgreSQL. O primeiro exemplo usa o pgAdmin, uma popular ferramenta de administração e desenvolvimento de código aberto para o PostgreSQL. Você pode baixar e usar pgAdmin sem ter uma instância local do PostgreSQL no computador cliente. O segundo exemplo usa psql, um utilitário de linha de comando que faz parte de uma instalação do PostgreSQL. Para usar o psql, certifique-se de ter o PostgreSQL ou o cliente psql instalado no computador cliente.

Antes de tentar se conectar à instância de banco de dados, verifique se a instância de banco de dados está associada a um grupo de segurança que fornece acesso a ela. Para obter mais informações, consulte Fornecer acesso à instância de banco de dados na VPC criando um grupo de segurança.

Em alguns casos, você pode ter dificuldade para se conectar à instância de banco de dados. Assim, o problema geralmente ocorre com as regras de acesso que você configurou no grupo de segurança que atribuiu à instância do banco de dados. Se você não especificou o grupo de segurança apropriado ao criar a instância de banco de dados, é possível modificar a instância de banco de dados para alterar seu grupo de segurança. Para obter mais informações, consulte Modificar uma instância de banco de dados do Amazon RDS.

Se sua instância de banco de dados estiver acessível ao público, o grupo de segurança associado deverá ter regras de entrada para os endereços IP que vão acessá-la. Se sua instância de banco de dados for privada, seu grupo de segurança associado deverá ter regras de entrada para o grupo de segurança de cada recurso que vai acessá-la, como o grupo de segurança de uma instância do Amazon EC2.

Para obter mais informações sobre como se conectar à sua instância de banco de dados do PostgreSQL, consulte Conectar a uma instância de banco de dados executando o mecanismo de banco de dados do PostgreSQL. Se você não conseguir se conectar à sua instância de banco de dados, consulte Solucionar problemas de conexões com a sua instância RDS for PostgreSQL.

Usar pgAdmin para se conectar a uma instância de banco de dados PostgreSQL

Para se conectar a uma instância de banco de dados PostgreSQL usando pgAdmin

  1. Encontre o endpoint (nome de DNS) e o número da porta para sua instância de banco de dados.

    1. Abra o console do RDS e escolha Databases (Bancos de dados) para exibir uma lista das instâncias de banco de dados.

    2. Escolha o nome da instância de banco de dados do PostgreSQL para exibir os detalhes.

    3. Na guia Connectivity & security (Conectividade e segurança), copie o endpoint. Além disso, anote o número da porta. Você precisará do endpoint e do número da porta para conectar-se à instância de banco de dados.

      
    										Conectar-se à instância de banco de dados PostgreSQL
    4. Na guia Configuration (Configuração), anote o nome do banco de dados. Você não precisa dele para se conectar utilizando pgAdmin, mas sim para se conectar utilizando psql.

      
    										Nome do banco de dados na guia Configuration (Configuração)
  2. Instalar pgAdmin a partir de http://www.pgadmin.org/. Você pode fazer download e usar pgAdmin sem ter uma instância local do PostgreSQL no computador cliente.

  3. Inicie o aplicativo pgAdmin no computador cliente.

  4. Escolha Add Server (Adicionar servidor) no menu File (Arquivo).

  5. Na caixa de diálogo New Server Registration (Registro do novo servidor), insira o endpoint da instância de banco de dados (por exemplo, database-1.123456789012.us-west-1.rds.amazonaws.com) na caixa Host. Não inclua os dois-pontos nem o número da porta, como mostrado no console do Amazon RDS (database-1.c6c8dntfzzhgv0.us-west-1.rds.amazonaws.com:5432).

    Insira a porta que você atribuiu à instância de banco de dados na Port (Porta). Digite o nome de usuário e a senha de usuário que você digitou ao criar a instância de banco de dados em Username (Nome do usuário) e Password (Senha).

    
								Conexão com o PostgreSQL
  6. Escolha OK.

  7. Em Object browser (Navegador do objeto), expanda Server Groups (Grupos de servidores). Escolha o servidor (a instância de banco de dados) que você criou e escolha o nome do banco de dados.

    
								Conexão com o PostgreSQL
  8. Clique no ícone de plugin e escolha PSQL Console (Console do PSQL). A janela de comando psql abrirá para o banco de dados padrão criado.

    
								Conexão com o PostgreSQL
  9. Use a janela de comando para inserir comandos SQL ou psql. Digite \q para fechar a janela.

Usar psql para se conectar a uma instância de banco de dados PostgreSQL

Se o computador cliente tiver o PostgreSQL instalado, você poderá usar uma instância local do psql para se conectar a uma instância de banco de dados PostgreSQL. Para se conectar à sua instância de banco de dados PostgreSQL utilizando psql, forneça as informações do host, o número da porta, as credenciais de acesso e o nome do banco de dados. É possível obter esses detalhes seguindo a primeira etapa do procedimento para Usar pgAdmin para se conectar a uma instância de banco de dados PostgreSQL

O formato a seguir é usado para se conectar a uma instância de banco de dados PostgreSQL no Amazon RDS.

psql --host=DB_instance_endpoint --port=port --username=master_user_name --password --dbname=database_name

Por exemplo, o comando a seguir se conecta a um banco de dados chamado mypgdb em uma instância de banco de dados PostgreSQL chamada mypostgresql usando credenciais fictícias.

psql --host=database-1.123456789012.us-west-1.rds.amazonaws.com --port=5432 --username=awsuser --password --dbname=postgres

Excluir uma instância de banco de dados

Depois de se conectar à instância de banco de dados de exemplo que você criou, exclua essa instância para que não seja mais cobrado por ela.

Para excluir uma instância de banco de dados sem snapshot de banco de dados final

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, escolha Databases (Bancos de dados).

  3. Escolha a instância de banco de dados que você deseja excluir.

  4. Em Actions, selecione Delete.

  5. Em Create final snapshot? (Criar snapshot final?), selecione No (Não) e escolha a confirmação.

  6. Escolha Delete (Excluir).