PR本ページはアフィリエイト広告(PR)を含みます。広告表記の方針

n8nの実行履歴を消しても容量が減らないとき|SQLiteの削除とVACUUMの確認

このページの目次(7 項目)
  1. 実行件数・DB本体・WAL・空き容量を分ける
  2. pruningの条件と、削除までの待ち時間
  3. 成功した実行を、後から調べる必要があるか
  4. VACUUMに必要な空き容量と起動時間
  5. WALが大きい場合の扱い
  6. 作業を始める条件と、変更後の点検
  7. 別の環境で保守する場合

n8nの実行履歴を削除しても、SQLiteのファイルが同じ大きさのまま残ることがあります。削除で空いた領域を、次のデータ保存に再利用するためです。ファイル自体を縮めるVACUUMには作業用の空き容量が必要なので、ディスクが足りない状態で先に有効化するのは避けます。

対象は、Dockerでセルフホストしたn8nをSQLiteで運用している場合です。2026年10月13日に公式資料を確認し、設定の既定値はn8n 2.42.7のソースとも照合しました。以下は保守の判断を整理したもので、VPSBenchによる縮小率・所要時間の実機測定は行っていません。

実行件数・DB本体・WAL・空き容量を分ける

作業前には、次の四つを同じ時点で記録します。Dockerのマウント設定から、現在のDBが保存されているホスト側の場所を特定してください。

  • 実行一覧の件数と絞り込み条件。消した対象と、残っている対象を区別する
  • DB本体のファイルサイズ。標準名はdatabase.sqlite
  • WALファイルがある場合は、そのサイズ。標準名はdatabase.sqlite-wal
  • DB保存先のファイルシステムの空き容量。バックアップ先が別なら、そちらも記録する

実行件数が減っても、DB本体のサイズだけで削除の失敗とは判断できません。n8n公式も、SQLiteで削除したデータの領域は自動でディスクへ返されず、後の実行データに再利用されると説明しています。実行データの管理

履歴削除後はDB内部に再利用できる領域が残る。VACUUMが成功してDBファイルが縮むと、縮んだ分がファイル外の空き容量になる状態比較の模式図。
DB内部の再利用領域と、ファイルシステムの空き容量は別です。図の比率・縮小率は実測ではなく、WAL・バックアップ・作業用一時領域は省略しています。VACUUMの実施には別途、作業用の空き容量と保守条件の確認が必要です。

DB本体だけでは、保存先全体の使用量を説明できません。WALや外部保存した添付ファイル、ログ、バックアップも含め、どの保存先が増えたかを調べます。VPS全体の契約容量だけでは、DBの置かれた領域に空きがあるかは分かりません。

pruningの条件と、削除までの待ち時間

pruningは、保存済みの実行を定期的に削除する機能です。既定で有効なので、まず現在の設定値を照合します。EXECUTIONS_DATA_PRUNE=trueを追記するだけで、すでに有効な環境の容量問題が解決するとは限りません。

  • EXECUTIONS_DATA_MAX_AGE:終了からの経過時間。既定は336時間(14日)
  • EXECUTIONS_DATA_PRUNE_MAX_COUNT:保存する終了済み実行の件数上限。既定は10,000件

削除対象になるのは、期間または件数の条件に該当した実行です。件数超過では古いものから対象になるため、「既定なら14日分が必ず残る」という意味にはなりません。new・running・waitingの実行と、タグや評価などの注釈を付けた実行は対象外です。定期処理や対象外の実行があるため、総件数が常に10,000件以下になる保証でもありません。公式の削除条件と例外

削除は、対象に印を付ける処理と、実際に削除する処理の二段階です。2.42.7では、削除対象として印を付けた時刻から既定で1時間以上経過した実行が、実削除処理の取得対象になります。実際の削除時刻には定期処理の間隔も影響します。設定名はEXECUTIONS_DATA_HARD_DELETE_BUFFERです。しきい値を変えた直後の表示やファイルサイズだけで成否を決めず、適用値・対象の状態・定期処理のエラーを照合します。2.42.7の削除対象の実装、バッファーの設定定義

成功した実行を、後から調べる必要があるか

今後の増加を抑えるなら、保存期間と一緒に、何を保存するかも見直します。成功した処理でも、送信内容の調査や業務上の照合に実行データが必要なら、成功履歴を一律に止めることはできません。必要な記録と、それを保存する場所・期間を先に決めます。

成功時のデータを残さなくてよい処理では、EXECUTIONS_DATA_SAVE_ON_SUCCESS=noneを検討できます。失敗時の調査に必要なデータを残す設定はEXECUTIONS_DATA_SAVE_ON_ERROR=allです。こうした保存対象の設定はワークフロー側で上書きできるため、環境変数だけで判断せず、対象ワークフローのSettingsも確認します。pruningの期間・件数をワークフローごとに変える設定ではありません。手動実行とノードごとの進捗保存には別の設定があります。ワークフローの保存設定

保存対象を減らす変更と、すでに大きくなったDBファイルを縮める作業は分けて扱います。設定を変えても、削除済みの過去データは戻りません。

VACUUMに必要な空き容量と起動時間

VACUUMはDBを再構築し、内部の未使用領域を取り除く処理です。SQLite公式によると、一時DBを作って元のDBへ書き戻すため、最大で元のDBファイルの2倍に相当する追加の空き容量が必要になります。「ディスク全体がDBの2倍あればよい」という計算ではありません。SQLiteのVACUUMの仕組み

たとえばDB本体が10GBなら、作業用に最大20GBの追加空きを見込む計算です。これは想定例であり、実測値ではありません。既存のWAL、保管するバックアップ、同じ領域で増える他のファイルも別に数えます。空き容量を2倍分用意できても、未完了のトランザクションや他の接続によるロックなど、別の失敗要因がなくなるわけではありません。

n8nには、起動時にこの処理を行うDB_SQLITE_VACUUM_ON_STARTUPがあります。既定はfalseで、有効にすると起動時間が延びるブロッキング処理です。必要な空き容量、バックアップ、停止できる時間を確保した保守で採用する設定です。有効のままにすれば、その後の起動時にも処理する点を保守計画へ含めます。起動時VACUUMの設定

実際に、2024年7月の個別報告では、n8n 1.49・SQLite・Docker Compose・Ubuntu 22.04の利用者が、17GBのDBと起動前6.7GBの空き容量でこの設定を追加し、SQLITE_FULLによって起動できなくなったと述べています。後に別環境での縮小を報告していますが、本番への復元結果は掲載されていません。この一例から、別環境でも同じ原因・結果になるとは判断できません。利用者本人の報告

WALが大きい場合の扱い

WALは、DBの変更を記録するファイルです。DB本体へ変更を反映する処理をチェックポイントと呼びます。SQLiteでは、チェックポイント後もWALの領域を再利用することがあり、ファイルが大きいだけで失敗とは限りません。SQLiteのWAL管理

2025年9月には、Docker上のn8nでDB本体が縮んだ後もWALが5GB超残ったという報告があります。n8nの版は不明で、投稿者は別コンテナからの手動操作後に0バイトになったと述べています。これはDB本体とWALを分けて見る必要がある個別例であり、その操作を各環境へそのまま適用できる根拠にはしません。WALが残った利用者報告

WALには、確定済みでもDB本体へまだ反映されていない変更が含まれることがあります。ファイルを手で削除したり、コピー時にDB本体から切り離したりすると、データを失うおそれがあります。WALだけが増え続ける場合は、接続・チェックポイントの状態をDB担当者と調べ、SQLiteに対応した方法で扱います。WALはDBの一部

作業を始める条件と、変更後の点検

保守を進める前に、n8nの版、実際の保存先、停止対象を確定します。停止中のWebhookや定期処理をどう扱うかを決め、n8nを正常に停止して、整合したバックアップを確保します。動作中のDBファイルを単純にコピーする方法は避けます。n8n公式のバックアップ時の注意

元に戻すデータと構成、復元先、必要な処理を再開できるかの確認まで含めて、保守時間を確保してください。保存対象と復元時の点検は、n8nのバックアップガイドに整理しています。

空き容量が不足している、バックアップを確保できない、DBの不整合・読み書きエラーがある場合は、VACUUMを始めません。四つの容量記録とエラーの発生時刻をそろえ、管理者と容量拡張や別環境での保守を検討します。起動しない状態なら、設定変更を重ねる前に障害時の初動確認へ進みます。

変更後は、同じ保存先・同じ絞り込み条件で四項目を測り直します。容量だけで終わらせず、必要な履歴を開けるか、予定した処理を再開できるか、次の実行後も空き容量を保てるかを記録します。DB内部の領域を再利用でき、運用上の空きも足りているなら、ファイルを小さくするためだけの保守を急ぐ必要はありません。RAMの使用量とディスク容量は別の指標なので、メモリの増設や測定結果でこの確認を代用しないようにします。

別の環境で保守する場合

今のサーバーで作業用の空きを確保できない場合は、DBを別の環境へ移して保守する方法があります。移す先には、DB本体に加えて、最大でその2倍の作業用の空きが必要です。時間課金のVPSなら保守の間だけ借りて、終わったら削除できます。ディスク容量はプランごとに決まっているため、申し込む前に確かめてください。

ConoHa VPSは新規受付を一時停止中です

2026年11月14日から、新しい申し込みを受け付けていません。再開の日は決まっておらず、公式のお知らせで案内されます(2026年11月15日確認)。ConoHa VPS公式のお知らせ

これから新しくVPSを借りる場合は、各社の受付状態を2GB VPSの比較で、時間課金や短い契約で借りたときの費用を契約期間ごとの料金の記事で確かめてください。