// Oracle-Fehlerreferenz

ORA-12899: Wert zu groß für die Spalte

Ein Wert ist länger, als die Spalte erlaubt. Die Meldung benennt die Spalte und gibt die tatsächliche und maximale Länge an, oft in Bytes statt in Zeichen.

Fehlercode
ORA-12899
Kategorie
Datenwerte und Konvertierung
Fehlermeldung
value too large for column string (actual: string, maximum: string)

Was es bedeutet

ORA-12899 bedeutet, dass eine Zeichenfolge nicht in ihre Spalte passt, zum Beispiel ORA-12899: value too large for column "SALES"."CUSTOMERS"."NAME" (actual: 61, maximum: 50). Eine VARCHAR2(50) Spalte ist standardmäßig 50 Bytes groß (NLS_LENGTH_SEMANTICS = BYTE), sodass Text mit Akzenten oder nicht-lateinischen Zeichen, die jeweils 2 bis 4 Bytes in AL32UTF8 benötigen, eine Spalte überlaufen kann, die lang genug aussieht.

Häufige Ursachen

  • Die Daten sind länger als die Spaltendefinition.
  • Mehrbyte-Zeichen in einer Spalte, die in Bytes bemessen ist.
  • Migration auf einen Unicode-Datenbankzeichensatz, wodurch manche Zeichenfolgen in Bytes länger werden.

Wie du es behebst

  1. Finde die längsten Werte, die in die Spalte passen würden, und vergleiche sie mit ihrer Definition.

    SELECT column_name, data_type, data_length, char_length, char_used
    FROM all_tab_columns WHERE table_name = 'CUSTOMERS' AND column_name = 'NAME';
  2. Verbreitere die Spalte, und gib ihre Größe in Zeichen an, wenn sie Text in vielen Sprachen enthält.

    ALTER TABLE customers MODIFY (name VARCHAR2(200 CHAR));
  3. Oder leere die Tabelle gezielt vor dem Einfügen, wenn es akzeptabel ist, den überzähligen Rest zu verlieren.

    INSERT INTO customers (name) VALUES (SUBSTR(:name, 1, 50));

Zugehörige Fehler

Weitere Fehler bei Datenwerten und Konvertierung

Der Code und der Meldungstext stammen aus der Oracle Database Error Help. Durchstöbere die vollständige Oracle-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit Oracle 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 Oracle und die anderen Datenbanken, mit denen du arbeitest.