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