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在已停止的叢集上) 以便及早偵測到損毀。
相關錯誤
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。