Bancos PostgreSQL, MariaDB e Chave-Valor na Zenifra

A Zenifra oferece PostgreSQL, MariaDB e Chave-Valor com Valkey gerenciados para quem quer operar aplicações sem administrar manualmente a infraestrutura de banco. Para análise de eventos e consultas agregadas com ClickHouse, comece pela seção Analytics.

Permissões necessárias

Ação	Scope mínimo
Criar PostgreSQL ou MariaDB	`database.create` em `organization:*`
Visualizar um projeto de banco	`project.read` em `project:<project-id>`
Visualizar status	`database.status.read` em `database:<project-id>`
Visualizar conexão	`database.connection.read` em `database:<project-id>`
Alterar senha	`database.password.rotate` em `database:<project-id>`
Alterar versão	`database.version.update` em `database:<project-id>`

owner tem acesso completo na sessão de usuário. assistant, member e API Keys da organização precisam dos grants específicos. A criação exige o scope de organização; as operações posteriores usam o ID do projeto do banco.

Bancos disponíveis

PostgreSQL

versões disponíveis: 15, 16, 17 e 18
topologia de 1 a 3 instâncias totais (db-free: 1 instância)
a instância primária atende escrita e leitura
réplicas extras atendem leitura
failover automático com 2 ou 3 instâncias

MariaDB

versões disponíveis: 10 e 11
topologia fixa de 3 instâncias (uma primária e duas réplicas), a partir do plano db-starter
failover automático
engine InnoDB por padrão

Chave‑Valor com Valkey

É a opção para sessões, estado compartilhado, contadores, locks e operações atômicas. Usa os planos db-*, mantém armazenamento persistente e conecta por VALKEY_URL com TLS e o usuário default. Consulte o guia de Chave‑Valor para exemplos e limites do produto.

O que a plataforma gerencia

failover automático quando há réplicas
replicação conforme a engine
credenciais e URI de conexão no console
TLS obrigatório nas conexões
storage persistente

A plataforma não oferece hoje backup automático nem restauração pelo console. Mantenha exportações próprias com pg_dump ou mariadb-dump/mysqldump.

Dados de conexão

Após a criação, a Console mostra host, porta, usuário, banco e URI de conexão. A senha utilizável é exibida apenas na criação ou após rotação; a URI mostrada posteriormente tem senha mascarada. O ClickHouse apresenta duas portas por projeto e é explicado no guia de conexões de Analytics.

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

Integração com aplicações

A Zenifra não injeta automaticamente DATABASE_URL no projeto HTTP. O fluxo correto é copiar a URI no console e configurar manualmente a ENV da aplicação.

Mudanças posteriores

é possível fazer upgrade de versão para frente
downgrade não é suportado
a senha pode ser trocada, e a plataforma gera uma senha nova; as aplicações vinculadas não são atualizadas automaticamente
instâncias (PostgreSQL), storage e plano só podem ser alterados no pagamento por hora e fora do plano db-free
aumentar storage pode causar indisponibilidade temporária