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
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
UNIQUEEinschrä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
-
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));
-
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)); -
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
22001Wert zu lang für den Typ53200kein Speicher mehr1071MySQL: Angegebener Schlüssel war zu lang
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.
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.