// Référence des erreurs Oracle

ORA-12899 : valeur trop grande pour la colonne

Une valeur est plus longue que ce que la colonne permet. Le message indique le nom de la colonne et donne la longueur réelle et maximale, souvent en octets plutôt qu'en caractères.

Code d'erreur
ORA-12899
Catégorie
Valeurs de données et conversion
Message d'erreur
value too large for column string (actual: string, maximum: string)

Ce que cela signifie

ORA-12899 signifie qu'une chaîne est trop longue pour sa colonne, par exemple ORA-12899: value too large for column "SALES"."CUSTOMERS"."NAME" (actual: 61, maximum: 50). Une VARCHAR2(50) colonne est de 50 octets par défaut (NLS_LENGTH_SEMANTICS = BYTE), donc le texte avec des caractères accentués ou non latins, qui prennent chacun de 2 à 4 octets en AL32UTF8, peut déborder d'une colonne qui semble suffisamment longue.

Causes courantes

  • Les données sont plus longues que la définition de la colonne.
  • Caractères multioctets dans une colonne dimensionnée en octets.
  • Migration vers un jeu de caractères de base de données Unicode, ce qui rend certaines chaînes plus longues en octets.

Comment le corriger

  1. Trouvez les valeurs les plus longues qui iraient dans la colonne et comparez-les à sa définition.

    SELECT column_name, data_type, data_length, char_length, char_used
    FROM all_tab_columns WHERE table_name = 'CUSTOMERS' AND column_name = 'NAME';
  2. Élargir la colonne, et la dimensionner en caractères si elle contient du texte en plusieurs langues.

    ALTER TABLE customers MODIFY (name VARCHAR2(200 CHAR));
  3. Ou tronquez délibérément avant l'insertion, si perdre la fin est acceptable.

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

Erreurs liées

Plus de valeurs de données et d'erreurs de conversion

Le code et le texte du message sont issus de Aide sur les erreurs Oracle Database. Parcourir la liste complète Liste des erreurs Oracle ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur Oracle dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour Oracle et les autres bases de données que vous utilisez.