// SQLite エラーリファレンス

SQLITE_CORRUPT: データベースのディスクイメージが破損しています

SQLite は、データベースファイルの構造が破損しているのを検出しました。書き込みを止めてコピーを取り、.recover コマンドかバックアップから、取り出せるものを取り出してください。

結果コード
SQLITE_CORRUPT
名前
11
カテゴリ
主な結果コード
エラーメッセージ
database disk image is malformed

意味

SQLITE_CORRUPT (11) は、SQLite がファイル内に形式に合わないものを読み取ったことを意味します。壊れたページ、不正なポインター、対応する行のないインデックスエントリなどです。SQLite は通常の使用ではファイルを自ら破損させません。SQLite のドキュメント(「How To Corrupt An SQLite Database File」)には、原因として次が挙げられています。トランザクションが開いている間にコピーされたファイル、壊れたファイルロック(多くはネットワークファイルシステム上)、ホットジャーナルの削除、ハードウェアやストレージの障害、他のコードによるファイルへの書き込みです。

SQLITE_CORRUPT_INDEX インデックスだけが破損している特別な場合で、 REINDEX 修正されることがあります。

よくある原因

  • 書き込み中のデータベースファイルをコピーまたはバックアップした場合、またはファイルのコピー時に -wal ファイル。
  • 次を削除した場合 -journal または -wal クラッシュ後に残されたファイル。
  • ロックが信頼できないネットワークファイルシステムやコンテナボリュームで、2 つのライターが同時に書き込めてしまう。
  • ディスク、メモリ、電源の障害、または fsync を無視するストレージレイヤー。
  • プログラムの別の部分が、開いているファイル記述子を通じてファイルに直接書き込んでいる。

修正方法

  1. データベースへの書き込みを止め、そのファイルと -wal そして -journal 何かを試す前に、まずはファイルのバックアップを。

  2. 被害の範囲を測ります。

    PRAGMA integrity_check;
  3. インデックスのみが影響を受けた場合、再構築してください。

    REINDEX;
  4. それ以外の場合は、新しいファイルへのデータ復旧に使うのは sqlite3 シェルの .recover コマンドを実行し、結果を確認します: sqlite3 broken.db .recover | sqlite3 recovered.db.

  5. 復旧が不完全な場合はバックアップから復元し、今後のバックアップは次で作成してください VACUUM INTO または、使用中のファイルをコピーする代わりにバックアップ API を使用します。

    VACUUM INTO '/backups/app-2026-11-09.db';

関連エラー

その他のプライマリ結果コードのエラー

コードとメッセージのテキストは、 SQLite の結果コードとエラーコードのドキュメント。全容は次で参照 SQLite エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で SQLite を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、SQLite をはじめ、お使いの他のデータベースにも対応します。