Verificação de restauração dos backups
A verificação de restauração do Databasus é o teste que pega o backup mais recente e restaura a cópia num container descartável, com a mesma versão principal do banco. Um agente instalado num servidor seu executa esse teste, compara o resultado com a origem e informa o número de linhas de cada tabela, por isso um backup que termina sem erro e não restaura aparece no painel antes de você precisar dele.
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
Um backup sem erro ainda pode falhar na volta
O comando de backup termina com código zero quando o pg_dump roda até o fim. Esse código diz que o comando executou, mas não diz se o arquivo traz o banco inteiro. A documentação oficial lista falhas que passam por esse filtro, como um papel sem permissão de leitura em alguns objetos, uma extensão ausente na origem ou um tablespace diferente. Em cada um desses casos, objetos podem ficar de fora do arquivo sem nenhum aviso.
O checksum também cobre só uma parte do problema. Ele detecta um arquivo corrompido no disco ou no bucket, mas um dump incompleto passa no checksum, porque o arquivo incompleto continua íntegro do primeiro ao último byte. Para a documentação do projeto, a prova de que um backup volta é restaurá-lo. O Databasus faz essa restauração por você numa agenda e registra o resultado de cada tentativa.
O caminho de uma verificação
Cada verificação percorre cinco etapas, do backup mais recente ao relatório. O container usado na restauração existe só durante o teste e é removido no fim:
Fila
PendingA agenda ou um disparo manual coloca o backup mais recente do banco na fila.
Restauração
RunningO agente sobe um container com a mesma versão principal e restaura a cópia nele.
Comparação
tamanho · tabelasO agente compara o banco restaurado com a origem e registra as linhas de cada tabela.
Descarte
O container temporário é removido com o banco restaurado.
Relatório
Successful | FailedO resultado volta ao painel e segue para os canais de aviso ligados à verificação.
O relatório mostra a linha do tempo da tentativa, o código de saída da restauração, o tamanho do banco restaurado, o número de schemas e de tabelas e as linhas de cada tabela. Uma tentativa com falha traz a mensagem de erro no topo. Os estados possíveis são Pending, Running, Successful, Failed e Canceled.
O agente de verificação
O agente é um binário pequeno escrito em Go, executado num servidor que você controla. Ele se registra no Databasus, busca as verificações numa fila, executa cada uma localmente e devolve o resultado. A máquina do agente precisa de acesso HTTPS de saída até o endereço do Databasus. O HTTP sem cifra só é aceito com a opção --allow-insecure-http, que a documentação reserva para teste local.
O cadastro começa no painel, em Settings, Verification agents, onde o Databasus gera um ID e um token mostrado uma única vez. Um token perdido é trocado pela ação de rotação na linha do agente. O token anterior para de valer no próximo sinal de vida do agente. O mesmo diálogo mostra os comandos de instalação para servidores amd64 e arm64.
O servidor do agente precisa de Docker, porque cada verificação sobe um container do banco na versão principal correspondente. Os limites de CPU, memória, disco e verificações simultâneas são passados na inicialização como orçamento total, que o Databasus divide entre as verificações em andamento. Cada verificação precisa de pelo menos um núcleo e 512 MB de memória:
--max-cpuNúcleos de CPU que o agente pode usar no total.Com dois núcleos e uma verificação por vez, a verificação recebe os dois.--max-ram-mbMemória total em megabytes.Abaixo de 512 MB por verificação, o agente anuncia menos verificações simultâneas.--max-disk-gbEspaço em disco total em gigabytes.Cada verificação ocupa o arquivo, o banco restaurado e uma folga de até 5 GB.--max-concurrent-jobsVerificações ao mesmo tempo.Com duas, cada uma recebe metade da CPU e da memória.O disco é o limite mais fácil de errar. A documentação recomenda um valor de --max-disk-gb com folga acima da soma do arquivo de backup e do banco restaurado do maior banco verificado, mais a margem de até 5 GB.
Agenda da verificação
A verificação é ligada por banco, na tela de configurações de verificação. As opções seguem as do backup, por hora, dia, semana ou mês, mais uma expressão cron em UTC. A documentação chama de garantia mais forte a opção de verificar logo depois de cada backup concluído com sucesso.
A verificação costuma demorar mais que o backup que a gerou. Com backups de hora em hora e verificação depois de cada um, a fila cresceria sem parar. O Databasus evita isso cancelando a verificação pendente de um banco quando um backup mais novo chega, de modo que só a cópia mais recente espera na fila e o agente não gasta horas com uma cópia que já ficou velha.
Como você usa o resultado
A aba Restore verifications de cada banco lista as tentativas. Um disparo manual na mesma aba verifica um backup específico sem mudar a agenda, o que serve para testar um agente novo de ponta a ponta antes de confiar a ele a agenda inteira. Excluir um agente devolve as verificações dele para a fila, onde outro agente ativo, se houver, assume o trabalho.
O sucesso e a falha da verificação podem seguir para qualquer canal de aviso já ligado ao banco, com duas opções independentes. A documentação registra que a maior parte das instalações liga só o aviso de falha, para o canal não encher de mensagens repetidas. Os canais disponíveis e o que cada um recebe são o assunto da página Notificações de backup.