// PostgreSQL-Fehlerreferenz

PostgreSQL 22001: Wert zu lang für den Typ

Ein String ist länger als das varchar(n)- oder char(n)-Limit der Spalte. PostgreSQL lehnt ihn ab, anstatt ihn stillschweigend abzuschneiden.

SQLSTATE
22001
Name
string_data_right_truncation
Kategorie
Daten-Ausnahme
Fehlermeldung
value too long for type character varying(20)

Was es bedeutet

A varchar(n) oder char(n) Spalte enthält höchstens n Zeichen. Das Einfügen oder Aktualisieren eines längeren Wertes schlägt mit 22001 fehl (string_data_right_truncation). PostgreSQL kürzt nur stillschweigend ab, wenn du explizit castest, wie in 'abcdef'::varchar(3), was der SQL-Standard verlangt.

Die Meldung nennt den Typ, aber nicht die Spalte, also musst du bei mehreren Spalten mit Längenbegrenzung prüfen, welcher Wert zu lang ist.

Häufige Ursachen

  • Benutzereingaben oder importierte Daten, die länger als die Spaltendefinition sind.
  • Eine Mehrspalten- INSERT Tabelle, bei der die Werte in einer anderen Reihenfolge als die Spaltenliste stehen und ein langer Wert in eine kurze Spalte eingefügt wird.
  • Ein Schema, das aus einer anderen Datenbank mit strengen Limits migriert wurde.

Wie du es behebst

  1. Finde heraus, welche Spalte übergelaufen ist, indem du die Wertelängen mit den Grenzen vergleichst.

    SELECT column_name, character_maximum_length
    FROM information_schema.columns
    WHERE table_name = 'customers' AND character_maximum_length IS NOT NULL;
  2. Verbreitere die Spalte oder verwende text, die keine Längenbegrenzung hat und dieselbe Leistung wie varchar.

    ALTER TABLE customers ALTER COLUMN name TYPE varchar(200);
    -- or
    ALTER TABLE customers ALTER COLUMN name TYPE text;
  3. Wenn eine Kürzung akzeptabel ist, dann mach sie explizit.

    INSERT INTO customers (name) VALUES (left('a very long name ...', 20));

Sicher reproduzieren

SELECT CAST('abc' AS varchar(2)) AS silently_truncated;
CREATE TEMP TABLE t (code varchar(2));
INSERT INTO t VALUES ('abc');  -- ERROR: value too long for type character varying(2)

Fragen

Ist Text in PostgreSQL langsamer als varchar?

Nein. Text und varchar verwenden denselben Speicher. Eine Längenbeschränkung ist eine Einschränkung der Daten, keine Leistungsfunktion.

Zugehörige Fehler

Weitere Fehler bei Daten-Exceptions

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.