Ir para o conteúdo
Promovaweb

Agendamento e retenção de backups

O agendamento do Databasus é a agenda de backup de cada banco, por hora, dia, semana, mês ou expressão cron, executada pelo agendador interno do container no horário escolhido. A retenção é a política que apaga as cópias antigas por prazo, por quantidade ou em camadas GFS, por isso o destino guarda o histórico definido por você e o disco da VPS não enche com arquivos esquecidos.

Ficha e sumário da página

Referência técnica
Databasus 3.70.0
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. Uma agenda por banco
  2. O que acontece em cada execução
  3. As três políticas de retenção do backup lógico
  4. Como a política GFS guarda o histórico
  5. Agenda, retenção e PITR juntos

Uma agenda por banco

No Databasus, a agenda pertence ao banco cadastrado. Quando você adiciona uma conexão no painel, o assistente de cadastro inclui a frequência do backup. A partir daí, cada banco segue o próprio horário. O banco de produção do seu app pode rodar de hora em hora enquanto o banco do Metabase roda uma vez por dia. O agendador interno do container dispara cada backup no horário escolhido e registra a execução na lista de backups do banco.

Das cinco opções de frequência, as agendas diária, semanal e mensal aceitam um horário fixo, de modo que o backup diário do seu banco pode rodar às 4h da manhã, fora do pico de acesso, exemplo citado no próprio README do projeto:

FrequênciaQuando o backup rodaUso típico
De hora em horaUma vez por hora.Banco com gravação constante e pouca tolerância a perda.
DiáriaUma vez por dia, no horário escolhido.A maior parte dos bancos de apps self-hosted.
SemanalUm dia da semana, no horário escolhido.Banco de relatório ou de arquivo, com poucas alterações.
MensalUm dia do mês, no horário escolhido.Cópia de longo prazo, ao lado de uma agenda mais curta.
CronQualquer combinação descrita por uma expressão cron.Horários que as opções prontas não cobrem, como a cada seis horas.

Fora da agenda, o botão de backup imediato da tela do banco dispara uma cópia na hora. Você usa esse botão antes de uma migration arriscada ou de uma atualização do app, sem mexer no horário programado. A captura oficial do painel mostra o botão acima da lista de backups, com a data, o status, o tamanho e a duração de cada execução.

O que acontece em cada execução

Cada disparo do agendador gera a cópia e a envia ao destino, com a cifra configurada para aquele banco. A compressão depende do mecanismo: no PostgreSQL lógico, o pg_dump usa nível 5, em zstd no PostgreSQL 16 ou superior e em gzip nas versões anteriores. Nos dumps SQL do MySQL e do MariaDB, o serviço aplica zstd à saída. O MongoDB usa a compressão gzip do próprio mongodump. Essas diferenças alteram o formato armazenado e a ferramenta que consegue restaurá-lo.

Acima da lista de backups, o painel desenha uma grade de healthchecks com a disponibilidade de cada banco ao longo do tempo. Na captura oficial, a grade aparece em quadrados verdes com alguns trechos vermelhos. A documentação oficial descreve esses gráficos de saúde e disponibilidade como parte do painel, ao lado do histórico de cada backup.

As três políticas de retenção do backup lógico

A retenção define quantas cópias continuam no destino. Sem ela, um backup de hora em hora gera 720 arquivos num mês, que ocupam o disco da VPS ou aumentam a fatura do S3 até você apagar os arquivos à mão. O Databasus aplica a política escolhida e remove as cópias que saíram dela. No backup lógico, o README e o código da versão 3.70.0 trazem três políticas:

  • PrazoMantém os backups por um período fixo, de um dia a cinco anos, ou para sempre. O formulário começa com três meses.
  • QuantidadeMantém um número fixo das cópias mais recentes, como as últimas 30.
  • GFSMantém camadas por hora, dia, semana, mês e ano, cada uma com o próprio limite.

O prazo e a quantidade são as políticas mais diretas. Uma agenda diária com retenção de 30 cópias mantém um mês de histórico com um arquivo por dia. O README também cita limites de tamanho por backup e para o espaço total, mas o formulário de retenção da versão 3.70.0 não traz esse campo.

Como a política GFS guarda o histórico

A sigla GFS vem de Grandfather-Father-Son, o esquema de avô, pai e filho. No Databasus, cada camada guarda as cópias de um período com limite próprio. O histórico fica denso nos dias recentes e espaçado no passado:

  • GFSA política em camadas, configurada por banco.
  • por horaAs cópias das horas mais recentes, para voltar ao estado de pouco tempo atrás.
  • por diaUma cópia por dia, para os dias anteriores.
  • por semanaUma cópia por semana, para as semanas anteriores.
  • por mêsUma cópia por mês, para o histórico do ano.
  • por anoUma cópia por ano, para o arquivo de longo prazo.
As camadas da política GFS no Databasus 3.70.0, segundo o README e o código do projeto. Cada camada tem o próprio limite de cópias. Um mesmo backup pode representar mais de uma camada.

Com o GFS, você volta o banco a uma hora de ontem, a um dia da semana passada ou ao fechamento de um mês do ano anterior, com muito menos arquivos guardados que numa retenção por quantidade com o mesmo alcance. O README do projeto apresenta essa política como a exigência comum das empresas que precisam de histórico longo.

Agenda, retenção e PITR juntos

No backup físico, o código da versão 3.70.0 separa a agenda dos backups completos da agenda dos incrementais. O WAL contínuo cobre o tempo entre eles. A retenção física também trabalha com essa cadeia: ela guarda as últimas cadeias, os backups completos pela quantidade ou pelo GFS, ou as duas coisas. Apagar um backup completo antigo remove o ponto de partida dos incrementais e do WAL que dependiam dele, por isso a janela de recuperação a um ponto no tempo vai até o backup completo mais antigo que a política mantém, como explica a página Backup do PostgreSQL e PITR.

A mesma lógica de agenda reaparece na verificação de restauração, que aceita as opções de hora, dia, semana, mês, cron em UTC ou a execução logo depois de cada backup. O lugar físico de cada cópia, do disco da VPS ao bucket S3, é o assunto da página Destinos dos backups.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.