Banco de Dados

A Zenifra oferece bancos de dados gerenciados para quem quer operar PostgreSQL ou MariaDB sem administrar a infraestrutura manualmente.

Bancos suportados

Banco	Versões suportadas
PostgreSQL	15, 16, 17, 18
MariaDB	11, 12

O que a plataforma oferece

replicação conforme a topologia suportada por cada engine
failover automático
senha gerada pela plataforma
host, porta, usuário, senha e URI completa no console
storage persistente

Dados de conexão

No console, você pode consultar:

host
porta
username: app
password
database name: app
URI completa pronta para copiar

Nota: host e porta são gerados dinamicamente. Não trate esses valores como fixos.

Quando houver réplicas, o console também pode mostrar os dados de conexão do master, das réplicas e uma URI pronta para cada uma delas.

Como conectar sua aplicação

A Zenifra não injeta automaticamente DATABASE_URL em projetos HTTP.

O fluxo correto é:

copiar a URI ou os dados de conexão no console
configurar manualmente a ENV DATABASE_URL no projeto HTTP

PostgreSQL

pode operar de 1 a 3 instâncias totais
com 1 instância, existe apenas o master
com múltiplas instâncias, o master atende escrita e leitura
as demais instâncias são usadas como réplicas de leitura
no plano por hora, a quantidade de réplicas pode ser aumentada ou reduzida depois
em mensal e anual, a quantidade de réplicas fica fixa no contrato

MariaDB

sempre opera com 3 instâncias
não permite aumentar ou diminuir a quantidade de instâncias

Versão do banco

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

Na edição:

é possível fazer upgrade para frente
downgrade não é suportado

Atenção: upgrade de versão pode causar alguns minutos de indisponibilidade. Faça essa alteração em janela de baixo uso.

Storage

Todo banco de dados na Zenifra usa armazenamento persistente.

Regras de storage

o storage pode aumentar
o storage nunca pode diminuir
em mensal e anual, a mudança só deve ocorrer após o contrato encerrar
aumentar storage pode causar indisponibilidade temporária

Failover e replicação

PostgreSQL e MariaDB contam com suporte a failover automático.

Além disso, a replicação de dados pode ocorrer em até 3 instâncias para as duas engines, conforme a topologia suportada de cada uma.

Acesso do usuário

O usuário não tem acesso root ou superuser, mas possui acesso elevado o suficiente para operar o banco normalmente, criar tabelas, ler tabelas e executar o fluxo comum de uso da aplicação.

Métricas

As métricas confirmadas de banco de dados hoje são:

uso de CPU
uso de RAM
uso de armazenamento

Essas métricas estão disponíveis em planos Premium+ e podem aparecer por projeto de banco e também por instância/réplica.