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

PostgreSQL XX001: データの破損

PostgreSQL が、健全性チェックまたはチェックサム検査に失敗するデータページを読み込みました。ストレージの破損として扱います。まずデータを保護し、その後で復元またはサルベージを行ってください。

SQLSTATE
XX001
名前
data_corrupted
カテゴリ
内部エラー
エラーメッセージ
invalid page in block 1234 of relation base/16384/16397

意味

XX001 (data_corrupted)は、ディスクから読み取ったページが無効であることを意味します。ヘッダーが壊れている、チェックサムが一致しない(データチェックサムが有効な場合)、またはファイルがテーブルに必要な長さより短い(could not read block ... read only 0 of 8192 bytes)。メッセージ内のファイルパス(base/<database oid>/<relfilenode>)は、テーブルまたはインデックスを特定します。

PostgreSQL 自体が原因になることはまれです。よくある原因は、故障しかけたディスクやコントローラー、書き込みのフラッシュについて虚偽の報告をするストレージ、適切な書き込み順序が保証されないハードウェアでのクラッシュ、あるいは一貫性のない状態でコピーまたは復元されたファイルです。

よくある原因

  • ハードウェアやストレージの障害:ディスク、RAID コントローラー、SAN、クラウドボリューム。
  • 次を守らない書き込みキャッシュ fsync、その後に電源断またはクラッシュが起きた場合。
  • fsync = off または full_page_writes = off 本番環境で。
  • データディレクトリを、次の手順なしでコピーして取得したバックアップ pg_basebackup またはバックアップ API、または他のソフトウェアによって変更されたファイル。

修正方法

  1. 修復を試みる前に、いったん停止して、データディレクトリ全体のファイルレベルのコピーを取ってください。そうすれば、何をしても悪化させることはありません。

  2. ファイルが属するオブジェクトを検索します。

    SELECT relname, relkind FROM pg_class WHERE relfilenode = 16397;
  3. インデックスの場合は、再構築します。

    REINDEX INDEX CONCURRENTLY orders_pkey;
  4. テーブルの場合は、バックアップまたはレプリカから復元します。読み取れる行を救出する最後の手段として、 zero_damaged_pages = on テーブルの退避中、PostgreSQL は破損ページ(その行は失われます)をスキップします。

    SET zero_damaged_pages = on;  -- superuser, salvage only
    CREATE TABLE orders_salvage AS SELECT * FROM orders;
    RESET zero_damaged_pages;
  5. ハードウェアとストレージのログを確認し、新しいクラスターではデータチェックサムを有効にします (initdb --data-checksums、または pg_checksums --enable 停止中のクラスターで) 破損を早期に検出できるようにします。

関連エラー

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

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

SQLly で PostgreSQL を操作する

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