// Referencia de errores de PostgreSQL

PostgreSQL XX001: datos corruptos

PostgreSQL leyó una página de datos que no pasó sus comprobaciones de coherencia o de checksum. Trátalo como corrupción del almacenamiento: protege los datos y después restaura o rescata lo que se pueda.

SQLSTATE
XX001
Nombre
data_corrupted
Categoría
Error interno
Mensaje de error
invalid page in block 1234 of relation base/16384/16397

Qué significa

XX001 (data_corrupted) significa que una página leída del disco no es válida: su encabezado está corrupto, su suma de verificación no coincide (cuando están activadas las sumas de verificación de datos) o un archivo es más corto de lo que la tabla necesita (could not read block ... read only 0 of 8192 bytes). La ruta del archivo en el mensaje (base/<database oid>/<relfilenode>) identifica la tabla o el índice.

PostgreSQL rara vez causa esto por sí mismo. Las causas habituales son discos o controladoras que fallan, almacenamiento que miente al vaciar las escrituras, un fallo del sistema en hardware sin el orden de escritura adecuado, o archivos copiados o restaurados de forma inconsistente.

Causas comunes

  • Fallos de hardware o de almacenamiento: discos, controladores RAID, volúmenes SAN o de la nube.
  • Caché de escritura que no respeta fsync, seguido de una pérdida de energía o un fallo.
  • fsync = off o full_page_writes = off en producción.
  • Una copia de seguridad realizada copiando el directorio de datos sin pg_basebackup o la API de copia de seguridad, o archivos modificados por otro software.

Cómo solucionarlo

  1. Detente y haz una copia a nivel de archivo de todo el directorio de datos antes de intentar cualquier reparación, para que nada de lo que hagas pueda empeorar las cosas.

  2. Encuentra a qué objeto pertenece el archivo.

    SELECT relname, relkind FROM pg_class WHERE relfilenode = 16397;
  3. Si es un índice, reconstrúyelo.

    REINDEX INDEX CONCURRENTLY orders_pkey;
  4. Si es una tabla, restáurala a partir de una copia de seguridad o una réplica. Como último recurso para salvar las filas legibles, zero_damaged_pages = on hace que PostgreSQL omita las páginas dañadas (perdiendo sus filas) mientras copias la tabla.

    SET zero_damaged_pages = on;  -- superuser, salvage only
    CREATE TABLE orders_salvage AS SELECT * FROM orders;
    RESET zero_damaged_pages;
  5. Revisa los registros de hardware y almacenamiento, y habilita sumas de verificación de datos en nuevos clústeres (initdb --data-checksums, o pg_checksums --enable en un clúster detenido) para que la corrupción se detecte a tiempo.

Errores relacionados

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.