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
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-
INSERTTabelle, 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
-
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;
-
Verbreitere die Spalte oder verwende
text, die keine Längenbegrenzung hat und dieselbe Leistung wievarchar.ALTER TABLE customers ALTER COLUMN name TYPE varchar(200); -- or ALTER TABLE customers ALTER COLUMN name TYPE text;
-
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
22003Numerischer Wert außerhalb des zulässigen Bereichs22P02Ungültige Eingabesyntax für den Typ8152SQL Server: Zeichenfolgen- oder Binärdaten abgeschnitten2628SQL Server: In Tabelle, Spalte abgeschnitten1406MySQL: Daten zu lang für SpalteORA-12899Oracle: Wert zu groß für die Spalte
Weitere Fehler bei Daten-Exceptions
22021Ungültige Byte-Sequenz für die Kodierung22008Datum-/Uhrzeitfeldwert außerhalb des zulässigen Bereichs22012Division durch null22007Ungültiges Datums-/Uhrzeitformat22023Ungültiger Parameterwert
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.