Home Assistantのバックアップに不整合なデータベース状態が保存されるのを防ぐ方法

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

稼働中のデータベースの状態をアプリケーションに調整させるか、未加工のファイルシステムコピーの前に書き込みを停止して、Home Assistantバックアップの不整合を防ぎましょう。

危険なのは、「Home Assistantの稼働中にバックアップすること」自体ではありません。関連するデータベースファイルやアプリケーションファイルのトランザクション状態を把握せず、異なる時点の状態を取り込むコピー方法が問題です。標準のバックアップではHome Assistantの各コンポーネントを調整できますが、汎用のrsyncやスナップショットツールではできない場合があります。一貫性を担保する仕組みを決め、データベースに負荷をかけるジョブの重複を避け、直近の正常なバックアップを保持し、分離された環境での復元テストですべての方針を検証してください。

稼働中のSQLiteデータベースを通常の静的ファイルのように扱わない

汎用のバックアッププロセスが設定ディレクトリをコピーしている間も、Home Assistant Recorderは書き込みを行うことがあります。SQLiteでは、コミット済みの状態がメインのデータベースとジャーナルファイルまたはWALにまたがる場合があるため、異なる時点の状態を取り込むと、アーカイブ内にすべてのファイル名が存在していても、コピーが不完全になったり復元できなくなったりすることがあります。

稼働中のSQLiteのバックアップテストでは、メインのデータベースファイルだけをコピーすると、コピーしたデータベースが整合性チェックに合格していても、WALに残っているコミット済みの行がひそかに欠落することが確認されました。このWALを伴うコピーの失敗が、未加工のファイルコピーにはデータベースを認識するスナップショットを使うか、データベースを正常に静止させてから実行すべき理由です。

だからといって、バックアップのたびにHome Assistantを必ず停止する必要があるわけではありません。重要なのは、バックアップの仕組みが一貫性のある復元ポイントを作成できることです。稼働中のインストールにはHome Assistant標準のバックアップを使用し、停止中のファイルシステムコピーは、移行、オフラインでのアーカイブ、またはアプリケーションを認識する連携機能のない外部ツールを使う場合に限ってください。

同じ時間帯に競合するバックアップやメンテナンスのジョブを避ける

アプリケーションを認識するバックアップであっても、別のプロセスがロックを保持していたり、ストレージパスに通常とは異なるメンテナンス負荷がかかっていたりすると、データベースの準備に失敗することがあります。家の中が静かだからといって、2つ目のアドオンによるバックアップ、データベースのメンテナンス、NASスナップショット、Home Assistantのバックアップを、同じ時刻に開始するようスケジュールしないでください。

Home Assistantのバックアップ失敗の報告では、データベースロックの準備エラーが実際に発生しており、あるユーザーは別のバックアップアドオンとの競合を突き止めました。これは予防のサインです。複数のツールが重ならないようにし、アプリケーションログでバックアップ前の段階が完了したことを確認してください。

メンテナンス時間を分散させ、想定所要時間を記録してください。バックアップが常にRecorderの処理待ちになる場合は、まずロックの所有者またはデータベースの健全性に関する問題を特定します。タイムアウトをむやみに延長したり、コピーを並行して実行したりしないでください。バックアップジョブを増やすと、解消しようとしている競合が悪化するおそれがあります。

生のファイルシステムをコピーする場合はHome Assistantを静止させ、状態データ一式を保全する

ポリシーで設定ディレクトリの直接コピーが必要な場合は、コピーの前にHome Assistantを正常に停止し、プロセスが書き込みを行っていないことを確認したうえで、メインのデータベースファイルだけを選別せず、必要な状態一式をコピーしてください。外部データベースのバックアップは、独自の整合性確保方法で管理してください。

ZimaSpaceのHome Assistantを稼働中にバックアップする方法と停止してバックアップする方法の既存の比較も、同じ境界を示しています。アプリケーションを認識したライブバックアップと、生のファイルシステムコピーは別の手順であり、一つのルールに混同すべきではありません。

コピー後、サービスを再起動し、Recorderが正常に動作していることを確認します。バックアップ先がネットワークストレージの場合は、ネットワークマウントを解除する前にファイル一式の転送が完了していたことも確認してください。途中で中断された停止状態でのコピーは、コピー元が静止していたという狭い意味では整合性がありますが、完全な復旧ポイントではありません。

隔離環境での復元に成功してからバックアップを信頼する

一時的なHome Assistantインスタンスまたは復旧先を用意し、本番環境の変更可能なファイルを流用せずに、候補のバックアップを復元します。既存のユーザー、履歴データ、ダッシュボード、インテグレーション、自動化の定義、および少なくとも1回の再起動を確認します。復元にかかった時間と、インスタンスを使用可能にするために必要だった手動修正を記録してください。

バージョン固有のHome Assistant Core 2026.7.2のリグレッションでは、バックアップ前の段階でRecorderのWALチェックポイントが失敗し、その後バックアップマネージャーがデータベースロックの解除を待ってタイムアウトしました。このバックアップ前の失敗シグナルは、影響を受けた経路に関する証拠であり、復旧ポイントの失敗としてのみ扱ってください。すべてのロックタイムアウトの原因が同じだという証拠ではありません。

一度に一つのバックアップ方式だけが整合性を管理し、データベースの準備フェーズが完了し、以前の正常なコピーが保持され、復元によってユーザー、履歴、設定、通常の再起動動作が再現される場合に、ポリシーに合格します。復元テストに失敗した場合は、証拠を保全し、古い復旧ポイントを削除する前に、新たにサポート対象のバックアップを作成するか、制御された状態でサービスを停止してコピーしてください。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.