Acessando as Configurações

  1. No menu lateral, clique em Projetos
  2. Localize e clique no nome do projeto de banco de dados desejado
  3. Na página do projeto, clique no botão "Editar" no canto superior direito

Configurações Disponíveis

Nome do Projeto

O nome do projeto pode ser alterado a qualquer momento.

Regras:

  • Mínimo: 6 caracteres
  • Máximo: 32 caracteres
  • Apenas letras minúsculas, números e hífens

Nota: A alteração do nome não afeta o subdomínio existente.


Descrição do Projeto

A descrição do projeto pode ser alterada a qualquer momento.

Características:

  • Campo opcional para descrever o propósito do projeto
  • Ajuda a identificar e organizar seus projetos
  • Pode incluir informações como ambiente, cliente, ou finalidade

Senha do Banco de Dados

Você pode alterar a senha do usuário administrador do PostgreSQL a qualquer momento.

Como alterar:

  1. Na seção de senha, insira a nova senha
  2. Clique em Salvar

Importante: Após alterar a senha, atualize a senha na sua aplicação que utiliza este banco de dados.


Versão do PostgreSQL

A versão do PostgreSQL pode ser atualizada.

Versões disponíveis:

  • PostgreSQL 15
  • PostgreSQL 16
  • PostgreSQL 17
  • PostgreSQL 18

Como atualizar:

  1. Selecione a nova versão desejada
  2. Clique em Salvar

Atenção: A atualização de versão pode causar breves momentos de indisponibilidade. Recomendamos realizar a alteração em horários de baixo acesso.

Importante: Não é possível fazer downgrade da versão do PostgreSQL.


String de Conexão

A string de conexão é gerada automaticamente e pode ser consultada a qualquer momento.

Formato:

postgres://usuario:senha@host:porta/nome_banco

Para copiar: Clique no botão de copiar ao lado da string de conexão.

Dica: Use esta string na variável DATABASE_URL da sua aplicação HTTP para conectar ao banco de dados.


Escalabilidade (Instâncias)

Você pode aumentar ou diminuir o número total de instâncias do banco de dados.

Limites:

  • Mínimo: 1 instância
  • Máximo: 3 instâncias

Impacto:

  • Mais instâncias = maior disponibilidade
  • Mais instâncias = maior custo
  • Instâncias adicionais oferecem failover automático
  • Instâncias secundárias podem ser usadas como read-only, reduzindo carga na primária

Nota: Para projetos com mais de 1 instância, o failover automático está habilitado. Caso a instância primária falhe, uma instância secundária assume automaticamente.


Armazenamento

O armazenamento do banco de dados pode ser ajustado.

Limites:

  • Mínimo: 1 GB
  • Máximo: 250 GB

Impacto:

  • Para projetos por hora: o armazenamento pode ser aumentado
  • Para contratos mensais/anuais: o armazenamento só pode ser aumentado na contratação do projeto, ou após finalizar o contrato.

Atenção: Não é possível reduzir o armazenamento. Certifique-se de alocar espaço suficiente para seus dados.


Ações do Projeto

Parar o Projeto

Ao parar o projeto:

  • O banco de dados é interrompido com gracefully shutdown de 30s, para as queries atuais pararem de ser rodadas.
  • As instâncias do banco são desligadas
  • O projeto não pode ser acessado
  • Para projetos por hora, a cobrança do plano é interrompida, mas os custos do armazenamento continuam.

Quando usar:

  • Quando não precisa do banco temporariamente
  • Para economia em projetos por hora

Iniciar o Projeto

Para iniciar um projeto que está parado:

  • O banco de dados é iniciado novamente
  • As instâncias do banco são inicializadas
  • O projeto volta a ser acessível
  • Para projetos por hora, a cobrança é retomada

Deletar o Projeto

A deleção é permanente e irreversível.

O que acontece:

  • Todas as instâncias do banco são removidas
  • Todos os dados são apagados

Requisitos:

  • Para projetos por hora, pode ser deletado a instância a qualquer momento.
  • Para contratos, aguarde o vencimento e desative a renovação automática.

Atenção: Faça backup dos dados com pg_dump antes de deletar. Esta ação não pode ser desfeita.


Próximos Passos


FAQ

Posso alterar a senha do banco de dados?

Sim. A qualquer momento através das configurações do projeto. Lembre-se de atualizar a senha na sua aplicação após alterar a senha no banco de dados.

A alteração de configurações causa downtime?

Depende da alteração:

  • Senha: Não causa downtime
  • Versão do PostgreSQL: Pode causar breve indisponibilidade
  • Instâncias: As instâncias são reiniciadas
  • Armazenamento: Não causa downtime (apenas para aumento em contratos)

Posso restaurar um banco de dados deletado?

Não. A deleção é permanente. Os dados não podem ser recuperados. Certifique-se de fazer backup antes de deletar.

O que acontece se a instância primária falhar?

Para projetos com mais de 1 instância, o failover automático ocorre:

  • Uma instância secundária assume como primária
  • Uma nova instância secundária é criada automaticamente
  • Sua aplicação continua funcionando sem intervenção manual

Como fazer backup do meu banco de dados?

Você pode exportar os dados usando ferramentas como pg_dump ou conectando-se diretamente ao banco e exportando os dados necessários.

Posso conectar aplicações externas ao banco?

Sim. Use a string de conexão fornecida nas configurações. Projetos de banco de dados não oferecem whitelist ou blacklist, então restrinja acesso na aplicação, na rede do cliente ou na gestão de credenciais quando necessário.