PostgreSQL XX001: データの破損
PostgreSQL が、健全性チェックまたはチェックサム検査に失敗するデータページを読み込みました。ストレージの破損として扱います。まずデータを保護し、その後で復元またはサルベージを行ってください。
- SQLSTATE
XX001- 名前
data_corrupted- カテゴリ
- 内部エラー
意味
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、または他のソフトウェアによって変更されたファイル。
修正方法
-
修復を試みる前に、いったん停止して、データディレクトリ全体のファイルレベルのコピーを取ってください。そうすれば、何をしても悪化させることはありません。
-
ファイルが属するオブジェクトを検索します。
SELECT relname, relkind FROM pg_class WHERE relfilenode = 16397;
-
インデックスの場合は、再構築します。
REINDEX INDEX CONCURRENTLY orders_pkey;
-
テーブルの場合は、バックアップまたはレプリカから復元します。読み取れる行を救出する最後の手段として、
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;
-
ハードウェアとストレージのログを確認し、新しいクラスターではデータチェックサムを有効にします (
initdb --data-checksums、またはpg_checksums --enable停止中のクラスターで) 破損を早期に検出できるようにします。
関連エラー
XX000内部エラー58P01未定義のファイル53100ディスクフル824SQL Server: 論理的な整合性に基づく I/O エラーSQLITE_CORRUPTSQLite: データベースのディスクイメージが破損しています
コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.
SQLly で PostgreSQL を操作する
macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。