HandyCafe Docs
it-admin owner

Manutenção do Banco de Dados

A página Manutenção do Banco de Dados é o centro de backup e conservação do banco de dados local do HandyCafe. A partir dela, você pode revisar a saúde do banco de dados, executar tarefas de manutenção pontuais, agendar manutenções e backups automáticos e restaurar o servidor a partir de um snapshot anterior.

Disponibilidade por Plano

Backup local, dump do banco de dados, restauração, verificação de integridade, verificação rápida e checkpoint do WAL são ferramentas de segurança dos dados. Elas continuam disponíveis no plano Gratuito e durante o modo de recuperação de licença.

Vacuum, Analyze, Optimize, manutenção agendada do banco de dados e limpeza de logs antigos exigem o Genesis. Os backups locais agendados continuam disponíveis no plano Gratuito. Essa separação mantém a recuperação disponível sem incluir os recursos pagos de otimização do banco de dados.

Saúde do Banco de Dados

A seção Saúde do Banco de Dados mostra o estado atual do banco de dados. Use o botão Atualizar para recarregar esses valores a qualquer momento.

O painel de saúde informa o seguinte:

  • Tamanho do banco de dados: tamanho total do arquivo principal do banco de dados.
  • Write-ahead log: tamanho do arquivo write-ahead log (WAL).
  • Contagem de páginas: número de páginas que o arquivo do banco de dados contém.
  • Páginas livres: número de páginas não utilizadas na lista livre que podem ser recuperadas por um vacuum.
  • Último backup: data e hora do backup mais recente. Mostra Nunca executado se nenhum backup tiver sido feito.
  • Última manutenção: data e hora do vacuum mais recente.
  • Última verificação de integridade: data e hora da verificação de integridade mais recente, com um indicador de status que mostra se o banco de dados estava saudável ou se foram encontrados problemas.
  • Entradas de log: número de linhas atualmente armazenadas no log de auditoria.

Abaixo desses números, a seção também lista o Modo de journal, a configuração de Auto-vacuum, o Tamanho de página e a quantidade de Backups em disco.

Expanda a entrada Tabelas para ver a contagem de linhas por tabela de cada tabela do banco de dados.

Ações Manuais

A seção Ações Manuais executa uma tarefa de manutenção pontual imediatamente. Apenas uma ação pode rodar por vez. Cada ação mostra uma notificação de confirmação ao terminar e várias ações exibem um resumo de resultado acima desta seção.

  • Fazer backup agora: cria um snapshot atômico do banco de dados atual. O novo snapshot aparece na lista do Histórico de Backups.
  • Vacuum: recupera páginas não utilizadas e desfragmenta o arquivo do banco de dados. O resumo do resultado informa o tamanho antes, o tamanho depois, o espaço recuperado e a duração.
  • Verificação de integridade: executa uma verificação completa de corrupção. É mais lenta porém minuciosa. O resultado abre na caixa de diálogo Relatório de Integridade.
  • Verificação rápida: executa uma checagem estrutural rápida. O resultado também abre na caixa de diálogo Relatório de Integridade.
  • Analisar: atualiza as estatísticas do planejador de consultas.
  • Otimizar: executa o otimizador incremental do SQLite.
  • Truncar WAL: descarrega e trunca o arquivo write-ahead log. O resumo do resultado informa a contagem de quadros do WAL, o número de quadros submetidos a checkpoint e a duração.
  • Limpar logs antigos: exclui as entradas de log mais antigas que a janela de retenção configurada. O resumo do resultado informa as linhas excluídas, as linhas restantes e a duração.

Relatório de Integridade

Após uma verificação de integridade ou uma verificação rápida, a caixa de diálogo Relatório de Integridade abre. Quando o banco de dados está saudável, ela confirma que a integridade do banco de dados foi verificada. Quando o SQLite reporta problemas, a caixa de diálogo lista as questões e recomenda restaurar a partir de um backup confiável. A caixa de diálogo também mostra a duração da verificação.

Manutenção Automática

A seção Manutenção Automática agenda o vacuum, a verificação de integridade e a limpeza de logs para rodarem automaticamente.

  • Ativar manutenção agendada: liga ou desliga o ciclo de manutenção agendada.
  • Frequência: escolha Diária, Semanal ou Mensal.
  • Hora do dia: selecione a hora local em que o ciclo é executado.

Backup Automático

As configurações de Backup Automático fazem snapshots regulares para que uma única corrupção nunca apague um dia inteiro de dados.

  • Ativar backups agendados: liga ou desliga os backups agendados.
  • Frequência: escolha Diária, Semanal ou Mensal.
  • Hora do dia: selecione a hora local em que o backup é executado.
  • Manter os mais recentes: o número de snapshots a reter, entre 1 e 365. Snapshots mais antigos que excedem essa contagem são removidos.
  • Pasta de backup: o diretório onde os snapshots são armazenados. Deixe vazio para usar a pasta padrão dentro do diretório de dados da aplicação.

Retenção de Logs

A configuração Retenção de Logs controla por quanto tempo as entradas do log de auditoria são mantidas antes de serem removidas durante a manutenção. Defina o valor de Retenção (dias) com o controle deslizante. O intervalo suportado vai de 7 a 730 dias.

Use o botão Salvar na parte inferior desta seção para armazenar as configurações de Manutenção Automática, Backup Automático e Retenção de Logs.

Histórico de Backups

A seção Histórico de Backups lista os snapshots armazenados localmente. Para cada backup, a tabela mostra:

  • Arquivo: o nome do arquivo de snapshot.
  • Criado: a data e hora em que o snapshot foi feito.
  • Tamanho: o tamanho do arquivo de snapshot.
  • Origem: como o backup foi disparado. Agendado para backups automáticos, Inicialização para backups feitos quando a aplicação inicia e Manual para backups criados com Fazer backup agora.

Cada linha oferece duas ações:

  • Restaurar: substitui o banco de dados em execução pelo snapshot selecionado. Antes da troca, uma cópia de segurança pré-restauração do banco de dados atual é salva automaticamente. A aplicação então fecha e reinicia para que o snapshot entre em vigor. Você é solicitado a confirmar antes de a restauração começar.
  • Excluir: remove o arquivo de snapshot do disco. Você é solicitado a confirmar antes de o arquivo ser excluído. Isso não pode ser desfeito.

Se ainda não houver snapshots, a seção sugere que você execute Fazer backup agora ou aguarde o próximo ciclo agendado.

Backup na Nuvem

Os backups externos na nuvem são gerenciados pela aba Backup e Sincronização da página Nuvem. O Backup na Nuvem guarda snapshots criptografados nos servidores do HandyCafe, restauráveis a partir de qualquer instalação do HandyCafe. Ele está disponível para contas com assinatura de Nuvem. Pela página Nuvem você pode fazer backup sob demanda, agendar envios automáticos com limites de retenção e restaurar a partir de um snapshot na nuvem.

A página Manutenção do Banco de Dados cobre os backups locais guardados no disco do próprio servidor. Para proteção completa, mantenha tanto os snapshots locais daqui quanto os snapshots externos na nuvem.

Observações Importantes

  • Uma restauração fecha e reinicia a aplicação do servidor. Avise as sessões ativas antes de restaurar.
  • A restauração sempre salva primeiro uma cópia de segurança pré-restauração do banco de dados atual, então uma restauração pode ser revertida restaurando essa cópia de segurança.
  • Mantenha a pasta de backup em um armazenamento com espaço livre suficiente para o número de snapshots definido em Manter os mais recentes.
  • Executar uma verificação de integridade ou um vacuum em um banco de dados grande pode demorar. Apenas uma ação manual roda por vez.

Vídeos relacionados

Backup e restauração do banco de dados

Faça o backup, guarde em um lugar seguro e restaure quando precisar trocar de máquina ou recuperar seus dados.