Banco de Dados

A Zenifra oferece bancos de dados gerenciados para quem quer operar PostgreSQL, MariaDB ou Chave‑Valor com Valkey sem administrar a infraestrutura manualmente.

Bancos suportados

Chave‑Valor com Valkey

Use este produto para sessões, estado compartilhado, contadores, locks e operações atômicas. Ele é persistente, usa os planos db-* e não é um banco relacional: consultas ad hoc, joins e relatórios devem continuar no sistema apropriado. A conexão usa VALKEY_URL, o usuário default, TLS e uma senha revelada uma única vez durante a criação ou rotação.

Veja o guia completo de Banco de Dados Chave‑Valor com Valkey e o guia compartilhado de conexão.

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

Para Chave‑Valor, o console exibe hostname, porta, usuário default, TLS e a URI valkeys://; a senha completa não é recuperada pela leitura mascarada.

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 é:

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

PostgreSQL com psql

A URI PostgreSQL fornecida pelo console usa sslmode=verify-full&sslrootcert=system. Isso exige TLS, valida a cadeia de certificados pelo armazenamento confiável do sistema e confirma que o hostname corresponde ao certificado.

Em versões modernas do psql, basta copiar a URI completa. Clientes mais antigos que não suportam sslrootcert=system devem configurar sslrootcert apontando para um bundle de CA confiável, por exemplo:

psql "postgresql://app:[REDACTED]@<host>:<port>/app?sslmode=verify-full&sslrootcert=/etc/ssl/certs/ca-certificates.crt"

Não substitua verify-full por require, disable ou qualquer opção que deixe de validar o certificado ou o hostname. Não use o endereço IP no lugar do host fornecido pelo console.

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.

Próximos passos

1. Configurações de Banco de Dados
2. Planos de Banco de Dados
3. Banco de Dados Chave‑Valor com Valkey
4. Criar projeto HTTP e configurar ENVs manualmente