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.

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

A seção Backup na Nuvem descreve snapshots criptografados fora do local, armazenados nos servidores do HandyCafe e restauráveis a partir de qualquer instalação do HandyCafe.

Este recurso está marcado como Em breve e ainda não está disponível. O interruptor e os campos de configuração são salvos localmente para que as configurações fiquem prontas quando o recurso abrir para a sua conta. Os campos disponíveis são Ativar backup na nuvem, uma opção para também fazer backup de mídias como logotipos, pôsteres e telas inativas, o Endpoint e o Bucket / zona de armazenamento.

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.