Configurações de Banco de Dados

Na Zenifra, as principais configurações de banco de dados estão relacionadas a versão, instâncias, senha, failover e storage.

PostgreSQL vs MariaDB

Versão do banco

Na criação, o usuário pode escolher qualquer versão disponível no console.

Na edição:

• somente upgrade para frente é suportado
• downgrade não é suportado

Atenção: upgrade de versão pode causar alguns minutos de indisponibilidade. Faça isso em horários de baixo uso.

Instâncias e réplicas

PostgreSQL

• mínimo de 1 instância total
• máximo de 3 instâncias totais
• a instância primária atende escrita e leitura
• as demais instâncias funcionam como réplicas de leitura

No pagamento por hora, o número total de instâncias pode aumentar ou diminuir depois, com o banco em execução. Em mensal e anual, essa configuração fica fixa no contrato. No plano db-free, o banco usa sempre 1 instância.

MariaDB

O MariaDB opera sempre com 3 instâncias fixas. Essa quantidade não pode ser alterada.

Senha

O usuário pode renovar a senha do banco depois da criação. A Zenifra gera uma senha completamente nova, que o console exibe uma única vez; guarde-a em local seguro. O banco pode ficar indisponível durante o processo.

As aplicações que usam o banco não são atualizadas automaticamente. O console lista as aplicações vinculadas para que você atualize manualmente a variável de conexão (por exemplo, DATABASE_URL) em cada uma.

Dados de conexão

No console, ficam disponíveis:

• host (postgresql-<id-do-projeto>.managed.zenifra.com ou mariadb-<id-do-projeto>.managed.zenifra.com)
• porta
• username app
• database name app
• URI de conexão pronta para copiar, com TLS obrigatório (sslmode=verify-full no PostgreSQL e ssl=true no MariaDB)

A senha aparece somente na criação ou após uma renovação; depois disso, a URI é exibida com a senha mascarada.

No PostgreSQL com 2 ou 3 instâncias, o console também exibe uma URI somente leitura, que direciona as consultas às réplicas. No MariaDB, a conexão disponibilizada aponta para a instância primária.

Failover

O failover automático é suportado para PostgreSQL com 2 ou 3 instâncias e para MariaDB.

Em caso de falha da instância primária, a plataforma pode promover uma réplica automaticamente. Conexões abertas podem ser encerradas durante a troca; configure a aplicação para reconectar.

Backups

Não há backup automático nem restauração pelo console. Faça exportações próprias com pg_dump ou mariadb-dump/mysqldump e teste a restauração periodicamente.

Storage

• o banco sempre usa storage persistente
• o storage pode aumentar
• o storage nunca pode diminuir
• a alteração só está disponível no pagamento por hora; em mensal e anual, a capacidade fica fixa durante o contrato
• no plano db-free, o storage é fixo em 1 GB
• aumentar storage pode causar indisponibilidade temporária

Boas práticas

1. Planeje upgrades de versão em janela de menor tráfego.
2. Planeje aumento de storage e ajustes de instâncias considerando possível indisponibilidade temporária.
3. Configure manualmente a DATABASE_URL na aplicação HTTP; a Zenifra não injeta essa ENV automaticamente.