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>`
Ligar ou desligar o acesso público	`database.exposure.update` 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.

Acesso público

Por padrão, o host e a porta da string de conexão aceitam conexões de qualquer lugar, sempre com TLS. Se o banco só atende aplicações da sua organização, você pode desligar o acesso público e usar apenas as conexões privadas entre aplicações.

Como desligar:

Crie as conexões privadas das aplicações que usam o banco e troque a variável de conexão delas pelo endereço interno <projeto>.<id-da-organização>.zenifra.local:5432, com TLS, como descrito em Conexão TLS com bancos de dados
Na edição do projeto, localize o card Acesso público
Desligue o acesso público e confirme a ação
Na página do banco, o card de conexão passa a mostrar o aviso Acesso público desligado

Como religar:

No card Acesso público, ligue o acesso público e confirme
O banco volta a aceitar conexões no mesmo host e na mesma porta; a string de conexão externa continua igual

Atenção: com o acesso público desligado, ferramentas de administração, scripts locais e aplicações fora da Zenifra deixam de conseguir conectar ao PostgreSQL. As conexões privadas entre aplicações continuam funcionando, e a troca de senha continua disponível.

Nota: o banco precisa estar em execução, e a alteração não é aceita enquanto outra operação estiver em andamento no projeto.

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. Somente o owner da organização pode alterar essa opção.

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, na mesma quantidade que o banco tinha ao ser parado
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, enquanto o acesso público estiver ligado, que é o padrão. 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. Se nenhum cliente fora da Zenifra precisa do banco, desligue o acesso público e conecte suas aplicações pelas conexões privadas.

Nessa página