// PostgreSQL-Fehlerreferenz

PostgreSQL XX001: Daten beschädigt

PostgreSQL hat eine Datenseite gelesen, die die Plausibilitäts- oder Prüfsummenprüfung nicht besteht. Behandle das als Speicherbeschädigung: Schütze die Daten und stelle sie dann wieder her oder rette sie.

SQLSTATE
XX001
Name
data_corrupted
Kategorie
Interner Fehler
Fehlermeldung
invalid page in block 1234 of relation base/16384/16397

Was es bedeutet

XX001 (data_corrupted) bedeutet, dass eine von der Festplatte gelesene Seite ungültig ist: Der Header ist Müll, die Prüfsumme stimmt nicht überein (wenn Datenprüfsummen aktiviert sind) oder eine Datei ist kürzer als die Tabelle benötigt (could not read block ... read only 0 of 8192 bytes). Der Datei-Pfad in der Meldung (base/<database oid>/<relfilenode>) identifiziert die Tabelle oder den Index.

PostgreSQL selbst verursacht das sehr selten. Übliche Ursachen sind defekte Festplatten oder Controller, Speicher, der beim Zurückschreiben lügt, ein Absturz auf Hardware ohne korrekte Schreibreihenfolge oder inkonsistent kopierte oder wiederhergestellte Dateien.

Häufige Ursachen

  • Hardware- oder Speicherfehler: Festplatten, RAID-Controller, SAN- oder Cloud-Volumes.
  • Schreib-Caching ohne Rücksicht auf fsync, gefolgt von einem Stromausfall oder Absturz.
  • fsync = off oder full_page_writes = off in Produktion.
  • Ein Backup, das durch Kopieren des Datenverzeichnisses ohne pg_basebackup oder die Backup-API oder Dateien, die von anderer Software geändert wurden, erstellt wurde.

Wie du es behebst

  1. Halte an und sichere das gesamte Datenverzeichnis auf Dateiebene, bevor du irgendeine Reparatur versuchst, damit nichts, was du tust, es verschlimmern kann.

  2. Finde heraus, zu welchem Objekt die Datei gehört.

    SELECT relname, relkind FROM pg_class WHERE relfilenode = 16397;
  3. Wenn es ein Index ist, baue ihn neu auf.

    REINDEX INDEX CONCURRENTLY orders_pkey;
  4. Wenn es eine Tabelle ist, stelle sie aus einem Backup oder einem Replikat wieder her. Als letzten Ausweg, um die lesbaren Zeilen zu retten, zero_damaged_pages = on lässt PostgreSQL fehlerhafte Seiten überspringen (deren Zeilen dabei verloren gehen), während du die Tabelle herauskopierst.

    SET zero_damaged_pages = on;  -- superuser, salvage only
    CREATE TABLE orders_salvage AS SELECT * FROM orders;
    RESET zero_damaged_pages;
  5. Prüfe die Hardware- und Speicherprotokolle und aktiviere in neuen Clustern Datenprüfsummen (initdb --data-checksums, oder pg_checksums --enable auf einem angehaltenen Cluster) damit Korruption früh erkannt wird.

Zugehörige Fehler

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.