// PostgreSQL-Fehlerreferenz

PostgreSQL 54000: Programmlimit überschritten

Ein hartes Implementierungslimit wurde erreicht, meistens ein Wert, der zu groß für einen B-Baum-Indexeintrag ist, oder zu viele Spalten oder Funktionsargumente.

SQLSTATE
54000
Name
program_limit_exceeded
Kategorie
Programmlimit überschritten
Fehlermeldung
index row size 3200 exceeds btree version 4 maximum 2704 for index "documents_body_idx"
DETAIL:  Index row references tuple (12,3) in relation "documents".
HINT:  Values larger than 1/3 of a buffer page cannot be indexed.
Consider a function index of an MD5 hash of the value, or use full text indexing.

Was es bedeutet

54000 (program_limit_exceeded) wird ausgelöst, wenn eine Anweisung auf eines der festen Limits von PostgreSQL stößt. Am häufigsten betrifft das die Größe eines B-Baum-Eintrags: Ein indizierter Wert muss in rund ein Drittel einer 8-kB-Seite passen (2704 Bytes bei aktuellen B-Baum-Indizes), sodass ein Unique-Index auf einer langen Textspalte fehlschlägt, wenn ein großer Wert ankommt.

Weitere Limits in dieser Klasse beinhalten höchstens 1600 Spalten pro Tabelle, 100 Argumente pro Funktion und 1664 Einträge in einer Auswahlliste.

Häufige Ursachen

  • Ein B-Baum-Index (oft von einer UNIQUE Einschränkung) auf einer Text-, JSON- oder Bytea-Spalte, die große Werte speichern kann.
  • Eine generierte Abfrage mit Tausenden von Spalten oder Ausdrücken.
  • Aufrufen einer Funktion mit mehr als 100 Argumenten, zum Beispiel einer sehr breiten json_build_object.

Wie du es behebst

  1. Indiziere einen Hash des Wertes statt des Wertes selbst; das erzwingt in der Praxis weiterhin Eindeutigkeit.

    DROP INDEX documents_body_idx;
    CREATE UNIQUE INDEX documents_body_md5_key ON documents (md5(body));
  2. Zum Durchsuchen von langem Text verwende die Volltextsuche oder Trigramm-Indizes statt eines B-Baums.

    CREATE INDEX documents_body_fts ON documents USING gin (to_tsvector('english', body));
  3. Bei sehr breiten Daten speichere Attribute in weniger Spalten (jsonb), und Objekte aus Zeilen erstellen (to_jsonb(t)) anstatt Hunderte von Argumenten zu übergeben.

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.