Criar uma instância PostgreSQL

Regiões

Este recurso está disponível nas seguintes regiões:

br-se1

br-ne1

Esta página contém um guia de como você pode criar uma nova instância postgres no DBaaS da Magalu Cloud.

Uma nova instância criada na MGC terá as seguintes características:

• Região. A instância postgres será criada na região na qual vocês está operando, seja no Console ou na CLI (por exemplo, br-se1)
• Zona de Disponibilidade. Se a instãncia postgres for single-instance (zona única) ele será criada em uma zona de disponibilidade (ou AZ, Availability Zone) assim como seus snapshots e réplicas. Se for um cluster (Multi-AZ), cada réplica será automaticamente criada em uma zona diferente. No exemplo da região br-se1, você teria as instâncias distribuídas entre as zonas br-se1-a, br-se1-b e br-se1-c.
• IP Privado. A instância postgres estará acessível apenas dentro da rede da Magalu Cloud, portanto você precisará criar uma máquina virtual ou container para acessá-lo.Para mais informações verifique aqui
• Schemas iniciais. Cada novo banco de dados PostgreSQL contará com os seguintes schemas de sistema pré-criados:
  • postgres: é o schema padrão criado automaticamente em todas as novas instalações do PostgreSQL. Ele serve como um banco de dados de conveniência para os usuários.
  • template1: é o template padrão usado para criar novos bancos de dados. Ele contém objetos padrão que são copiados para qualquer novo banco de dados criado.
  • template0: é um template imutável que serve como uma cópia de segurança do template padrão. Ele pode ser usado para criar novos bancos de dados quando o template1 foi modificado.
  • pg_catalog: é o schema que contém todas as tabelas do sistema e visões do PostgreSQL. Ele armazena informações sobre a estrutura do banco de dados, usuários, permissões e outros metadados essenciais para o funcionamento do sistema de gerenciamento de banco de dados.

Como criar uma instância PostgreSQL

Usando o Console

Aviso

Atualmente, somente a instância postgres é criada automaticamente. A criação do banco de dados deve ser realizada manualmente após o provisionamento. Para mais informações acesse aqui

1. Acesse o console Magalu Cloud.

2. No painel inicial ou menu lateral, clique em Database.

3. Clique em Criar Banco de Dados. Uma nova página para dar início a configuração do seu novo banco.

4. Depois escolha o sistema de gerenciamento de banco de dados (PostgreSQL) e a versão (16, por exemplo) em "Opções de sistema e versionamento".

5. Depois escolha o tipo de instância (configuração de vCPU e RAM):

   • Instâncias Balanced Value (BV) têm custo reduzido e são ideais para testes e desenvolvimento.
   • Instâncias Dedicated Performance (DP) oferecem alto desempenho e são indicadas para cargas críticas e produtivas.

6. Selecione a quantidade de IOPS desejada para o volume de armazenamento (SSD).

7. Selecione um tamanho do armazenamento pré-definido ou personalize conforme necessário, fornecendo um valor inteiro (em GiB) entre 10 e 10.000 (10 TiB).

8. Informe o ID de Login para o usuário administrativo do banco de dados.

9. Defina a Senha de acesso para o usuário administrativo.

   note

   Sempre utilize senhas fortes para seus bancos de dados, a fim de evitar problemas de segurança. Guarde essas informações com segurança, pois elas não serão exibidas novamente.

10. Configure o Snapshot automático, indicando o horário em que ocorrem e a retenção desejada (de 1 a 30 dias).

11. Informe um nome único para a instância de banco de dados.

12. (Opcional) Para definir configurações específicas, acesse o painel Configurações avançadas e selecione um grupo de parâmetros.

13. Clique em Criar Banco de Dados.

note

Pode levar alguns minutos até que a instância de banco de dados esteja criada. Aguarde até que o status exiba Ligado.

Usando a CLI MGC

Single-Instance

Aviso

Atualmente, somente a instância postgres é criada automaticamente. A criação do banco de dados deve ser realizada manualmente após o provisionamento. Para mais informações acesse aqui

Se você deseja criar uma instância PostgreSQL execute o comando abaixo:

mgc dbaas instances create --name="dbaas-name" --user="dbaas-user" --password="dbaas-password" --volume.size=20 --volume.type="CLOUD_NVME15K" --instance-type-id="55e5a3f5-ff08-4b1d-9ac6-d568224f2529" --engine-id="89bd25d5-e29e-4615-a64b-0a006bbc4997"

Ajuste os valores das flags:

• name pelo nome do banco que será criado.
• user pelo nome de usuário que será usado para acessar o banco que está sendo criado.
• password pela senha de acesso que será usada para acessar o banco que está sendo criado.
• instance-type-id pelo ID do tipo de instância que você deseja
• engine-id pelo ID da engine que você deseja

Ajuste o volume.size para o tamanho do volume de armazenamento que você precisa, com um valor inteiro (em GiB) entre 20 e 10000.

Especifique qual o tipo de volume em volume.type com as opções CLOUD_NVME15K (15000 IOPS) e CLOUD_NVME20K (20000 IOPS).

O instance-type-id referenciado neste comando se refere a um tipo de instância BV (Balance Value) e que conta com 2 vCPU e 4 GB de RAM.

O engine-id referenciado neste comando se refere à engine PostgreSQL na sua versão 16.

Outros parâmetros podem ser ajustados conforme sua necessidade.

Veja os comando mgc dbaas engines list e mgc dbaas instance-types list para mais detalhes de como adquirir os IDs necessários para criar uma instância.

Após rodar o comando com sucesso, aguarde alguns instantes até que o novo cluster seja criado.

Como encontrar tipos de instância compatíveis

Para encontrar os instance types compatíveis com a engine que você quer utilizar, você pode listá-los da seguinte forma:

mgc dbaas instance-types list --status=ACTIVE --engine-id="89bd25d5-e29e-4615-a64b-0a006bbc4997"

Substitua o valor de engine-id pelo ID da engine que você deseja utilizar. Você pode encontrar os IDs das engines disponíveis com o comando:

mgc dbaas engines list --status=ACTIVE