Como impedir que as cópias de segurança do Home Assistant capturem um estado inconsistente da base de dados

Evite cópias de segurança inconsistentes do Home Assistant deixando a aplicação coordenar o estado ativo da base de dados ou interrompendo as escritas antes de fazer uma cópia do sistema de ficheiros em bruto.

O caso arriscado não é simplesmente “fazer uma cópia de segurança enquanto o Home Assistant está ligado”; é utilizar um método de cópia que captura ficheiros relacionados da base de dados e da aplicação em momentos diferentes, sem conhecer o estado das transações. As cópias de segurança integradas podem coordenar os componentes do Home Assistant, mas uma ferramenta genérica como o rsync ou um utilitário de instantâneos pode não o fazer. Defina qual o mecanismo responsável pela consistência, evite tarefas sobrepostas que utilizem intensivamente a base de dados, mantenha a cópia de segurança anterior que sabe estar correta e valide todas as políticas com uma restauração isolada.

Não trate uma base de dados SQLite ativa como um ficheiro estático comum

O Recorder do Home Assistant pode estar a escrever enquanto um processo de cópia genérico copia o diretório de configuração. Com SQLite, o estado confirmado pode envolver a base de dados principal e ficheiros de diário ou WAL, pelo que capturar momentos inconsistentes pode criar uma cópia incompleta ou irrecuperável, mesmo que todos os nomes de ficheiro existam no arquivo.

Um teste de cópia de uma base de dados SQLite ativa mostrou que copiar apenas o ficheiro principal da base de dados podia omitir silenciosamente linhas confirmadas que ainda estavam presentes no WAL, mesmo quando a base de dados copiada passava numa verificação de integridade. Esta falha de cópia suportada por WAL é a razão pela qual uma cópia de ficheiros em bruto deve utilizar um instantâneo compatível com a base de dados ou ocorrer apenas depois de a base de dados ser devidamente colocada em estado inativo.

Isso não significa que o Home Assistant tenha de ser sempre desligado para fazer uma cópia de segurança. Significa que o mecanismo de cópia tem de saber criar um ponto de recuperação coerente. Utilize a cópia de segurança integrada do Home Assistant numa instalação em execução; reserve as cópias do sistema de ficheiros com o serviço parado para migrações, arquivo offline ou ferramentas externas sem integração compatível com a aplicação.

Evite tarefas de cópia de segurança ou manutenção concorrentes durante a mesma janela

Mesmo uma cópia de segurança compatível com a aplicação pode não conseguir preparar a base de dados quando outro processo mantém bloqueios ou quando o caminho de armazenamento está sujeito a uma pressão de manutenção invulgar. Não agende uma segunda cópia de segurança de um suplemento, a manutenção da base de dados, um instantâneo do NAS e a cópia de segurança do Home Assistant para começarem no mesmo minuto apenas porque a casa está tranquila.

Falhas reais de cópia de segurança do Home Assistant comunicam erros de preparação devido ao bloqueio da base de dados, e um utilizador identificou um conflito com outro suplemento de cópia de segurança. Isso é um sinal preventivo: as ferramentas sobrepostas devem ser separadas e o registo da aplicação deve confirmar que a fase de preparação da cópia de segurança foi concluída.

Separe as janelas de manutenção e registe a duração prevista. Se uma cópia de segurança ficar habitualmente à espera do Recorder, identifique primeiro o responsável pelo bloqueio ou o problema de integridade da base de dados. Não aumente os tempos limite às cegas nem execute mais cópias em paralelo; mais tarefas de cópia de segurança podem aumentar precisamente o conflito que está a tentar evitar.

Para cópias do sistema de ficheiros em bruto, coloque o Home Assistant em estado inativo e preserve todo o conjunto de dados

Se a sua política exigir uma cópia direta do diretório de configuração, pare o Home Assistant corretamente antes de o copiar, confirme que o processo já não está a escrever e copie todo o estado necessário, em vez de selecionar apenas o ficheiro principal da base de dados. Mantenha as cópias de segurança de bases de dados externas segundo o respetivo método de consistência.

A comparação existente da ZimaSpace entre a cópia de segurança do Home Assistant em execução e com o serviço parado estabelece o mesmo limite: a cópia de segurança ativa compatível com a aplicação e a cópia direta do sistema de ficheiros são procedimentos diferentes e não devem ser combinados numa única regra.

Depois da cópia, reinicie o serviço e confirme o funcionamento normal do Recorder. Se o destino da cópia de segurança for um armazenamento de rede, confirme também que o conjunto de ficheiros foi concluído antes de o ponto de montagem de rede ser removido. Uma cópia com o serviço parado que seja interrompida a meio só é consistente no sentido restrito de a origem estar inativa; continua a não ser um ponto de recuperação completo.

-15% OFF

ZimaBoard 2 - Mini Servidor Doméstico para a Sua Grande Ideia

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Confie na cópia de segurança apenas depois de uma restauração isolada bem-sucedida

Crie uma instância temporária do Home Assistant ou um destino de recuperação e restaure a cópia candidata sem reutilizar ficheiros mutáveis da produção. Confirme os utilizadores existentes, os dados históricos, os painéis, as integrações, as definições das automatizações e, pelo menos, um reinício. Registe o tempo de restauração e quaisquer correções manuais necessárias para tornar a instância utilizável.

Uma regressão do Home Assistant Core específica da versão 2026.7.2 registou uma falha do Recorder ao efetuar o ponto de verificação do WAL durante a fase de preparação da cópia de segurança, após o que o gestor de cópias de segurança excedeu o tempo limite enquanto aguardava pelo bloqueio da base de dados. Este sinal de falha na preparação da cópia de segurança deve ser tratado apenas como evidência relativa ao percurso afetado e como um ponto de recuperação falhado — não como prova de que todos os tempos limite de bloqueio têm a mesma causa.

A política é cumprida quando apenas um mecanismo de cópia de segurança é responsável pela consistência de cada vez, a fase de preparação da base de dados é concluída, a cópia anterior que se sabe estar correta é mantida e uma restauração reproduz os utilizadores, o histórico, as definições e o comportamento normal após o reinício. Se os testes de restauração falharem, preserve as evidências e crie uma nova cópia de segurança suportada ou uma cópia controlada com o serviço parado antes de eliminar pontos de recuperação mais antigos.