// Référence des erreurs PostgreSQL

PostgreSQL XX001 : données corrompues

PostgreSQL a lu une page de données qui ne passe pas ses contrôles d'intégrité ou de somme de contrôle. Considérez-la comme une corruption du stockage : protégez les données, puis restaurez ou récupérez.

SQLSTATE
XX001
Nom
data_corrupted
Catégorie
Erreur interne
Message d'erreur
invalid page in block 1234 of relation base/16384/16397

Ce que cela signifie

XX001 (data_corrupted) signifie qu'une page lue depuis le disque n'est pas valide : son en-tête est corrompu, sa somme de contrôle ne correspond pas (lorsque les sommes de contrôle des données sont activées), ou un fichier est plus court que ce que la table nécessite (could not read block ... read only 0 of 8192 bytes). Le chemin du fichier dans le message (base/<database oid>/<relfilenode>) identifie la table ou l'index.

PostgreSQL lui-même en est très rarement la cause. Les sources habituelles sont des disques ou contrôleurs défaillants, un stockage qui ment sur l’écriture effective des données, un plantage sur du matériel sans ordre d’écriture correct, ou des fichiers copiés ou restaurés de manière incohérente.

Causes courantes

  • Défaillances du matériel ou du stockage : disques, contrôleurs RAID, volumes SAN ou cloud.
  • Mise en cache d'écriture qui n'honore pas fsync, suivie d'une coupure de courant ou d’un plantage.
  • fsync = off ou full_page_writes = off en production.
  • Une sauvegarde effectuée en copiant le répertoire de données sans pg_basebackup ou l'API de sauvegarde, ou des fichiers modifiés par d'autres logiciels.

Comment le corriger

  1. Arrêtez et prenez une copie au niveau des fichiers de tout le répertoire de données avant d'essayer toute réparation, afin que rien de ce que vous faites ne puisse aggraver la situation.

  2. Trouvez à quel objet appartient le fichier.

    SELECT relname, relkind FROM pg_class WHERE relfilenode = 16397;
  3. S'il s'agit d'un index, reconstruisez-le.

    REINDEX INDEX CONCURRENTLY orders_pkey;
  4. S'il s'agit d'une table, restaurez-la à partir d'une sauvegarde ou d'une réplique. En dernier recours pour récupérer les lignes lisibles, zero_damaged_pages = on fait que PostgreSQL saute les pages défectueuses (en perdant leurs lignes) pendant que vous copiez la table.

    SET zero_damaged_pages = on;  -- superuser, salvage only
    CREATE TABLE orders_salvage AS SELECT * FROM orders;
    RESET zero_damaged_pages;
  5. Vérifiez le matériel et les journaux de stockage, et activez les sommes de contrôle des données sur les nouveaux clusters (initdb --data-checksums, ou pg_checksums --enable sur un cluster arrêté) afin que la corruption soit détectée tôt.

Erreurs liées

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.