// справочник ошибок 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 или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.