Como Alterar Configurações do PostgreSQL

Permissões necessárias

Use o ID do projeto do banco como project-id e conceda somente o scope da ação:

Ação	Scope mínimo
Visualizar o projeto	`project.read` em `project:<project-id>`
Alterar nome	`project.name.update` em `project:<project-id>`
Alterar descrição	`project.description.update` em `project:<project-id>`
Alterar senha	`database.password.rotate` em `database:<project-id>`
Alterar versão	`database.version.update` em `database:<project-id>`
Visualizar conexão	`database.connection.read` em `database:<project-id>`

owner tem acesso completo na sessão de usuário. assistant, member e API Keys da organização precisam do grant específico. A operação de consultar aplicações vinculadas usa atualmente database.password.rotate no contrato da API.

Acessando as Configurações

No menu lateral, clique em Projetos
Localize e clique no nome do projeto de banco de dados desejado
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 endereço de conexão, que usa o ID do projeto.

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 renovar a senha do usuário app do PostgreSQL a qualquer momento. Você não escolhe a nova senha: a Zenifra gera uma senha aleatória.

Como alterar:

Na seção de senha, solicite a geração de uma nova senha
Confirme a ação
Copie a nova senha exibida e guarde-a em local seguro; ela é mostrada uma única vez

Atenção: O banco de dados pode ficar indisponível durante o processo.

Importante: As aplicações vinculadas não são atualizadas automaticamente. O console lista essas aplicações; atualize manualmente a variável de conexão (por exemplo, DATABASE_URL) em cada uma.

Versão do PostgreSQL

A versão do PostgreSQL pode ser atualizada.

Versões disponíveis:

PostgreSQL 15
PostgreSQL 16
PostgreSQL 17
PostgreSQL 18

O console oferece apenas versões mais novas que a atual.

Como atualizar:

Selecione a nova versão desejada
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. Exporte os dados com pg_dump antes do upgrade e teste a aplicação com a nova versão.

String de Conexão

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

Formato:

postgres://app:<senha>@postgresql-<id-do-projeto>.managed.zenifra.com:<porta>/app?sslmode=verify-full&sslrootcert=system

Com 2 ou 3 instâncias, o console mostra também uma string somente leitura, que direciona as consultas às réplicas.

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)

No pagamento por hora, você pode aumentar ou diminuir o número total de instâncias do banco de dados, com o banco em execução. Em contratos mensais ou anuais e no plano db-free, a quantidade não pode ser alterada.

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 pela string somente leitura, 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 é definido na contratação e não pode ser alterado durante o contrato
No plano db-free: fixo em 1 GB

Atenção: Não é possível reduzir o armazenamento, e o aumento pode causar indisponibilidade temporária. Certifique-se de alocar espaço suficiente para seus dados.

Plano

No pagamento por hora, você pode trocar o plano do banco na edição do projeto. Em contratos mensais ou anuais, o plano não pode ser alterado durante o contrato, e o db-free não pode ser trocado por outro plano. A mudança pode causar indisponibilidade temporária.

Renovação automática

Em contratos mensais e anuais, a edição do projeto permite ativar ou desativar a renovação automática do contrato.

Ações do Projeto

Parar o Projeto

Ao parar o projeto:

O banco de dados é interrompido
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

Atenção: A Zenifra não mantém backup do banco. Exporte os 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; a Zenifra gera a nova senha e a exibe uma única vez. Lembre-se de atualizar a variável de conexão nas aplicações que usam o banco.

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

Depende da alteração:

Senha: Pode causar indisponibilidade durante o processo
Versão do PostgreSQL: Pode causar breve indisponibilidade
Instâncias: Pode causar indisponibilidade temporária
Armazenamento: Pode causar indisponibilidade temporária
Plano: Pode causar indisponibilidade temporária

Posso restaurar um banco de dados deletado?

Não. A deleção é permanente e não há backup pela plataforma. Os dados não podem ser recuperados. Exporte os dados 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 réplica é promovida a instância primária
A conexão continua usando o mesmo host e a mesma porta
Conexões abertas podem ser encerradas durante a troca; configure sua aplicação para reconectar automaticamente

Como fazer backup do meu banco de dados?

A Zenifra não oferece hoje backup automático nem restauração pelo console. Faça exportações periódicas com pg_dump, guarde as cópias fora do projeto e teste a restauração.

Posso conectar aplicações externas ao banco?

Sim. Use a string de conexão fornecida nas configurações; a conexão exige TLS. 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.

Nessa página