// Référence des erreurs PostgreSQL

PostgreSQL 22001 : valeur trop longue pour le type

Une chaîne est plus longue que la limite varchar(n) ou char(n) de la colonne. PostgreSQL la rejette plutôt que de tronquer silencieusement.

SQLSTATE
22001
Nom
string_data_right_truncation
Catégorie
Exception de données
Message d'erreur
value too long for type character varying(20)

Ce que cela signifie

A varchar(n) ou char(n) La colonne contient au maximum n caractères. Insérer ou mettre à jour une valeur plus longue échoue avec 22001 (string_data_right_truncation). PostgreSQL ne tronque silencieusement que lorsque vous effectuez un cast explicite, comme dans 'abcdef'::varchar(3), ce que la norme SQL exige.

Le message indique le type mais pas la colonne, donc avec plusieurs colonnes limitées, vous devez vérifier quelle valeur est trop longue.

Causes courantes

  • Saisie utilisateur ou données importées plus longues que la définition de la colonne.
  • Un INSERT où les valeurs sont dans un ordre différent de la liste des colonnes, plaçant une valeur longue dans une colonne courte.
  • Un schéma migré depuis une autre base de données avec des limites strictes.

Comment le corriger

  1. Trouvez quelle colonne a débordé en comparant la longueur des valeurs avec les limites.

    SELECT column_name, character_maximum_length
    FROM information_schema.columns
    WHERE table_name = 'customers' AND character_maximum_length IS NOT NULL;
  2. Élargissez la colonne, ou utilisez text, qui n’a pas de limite de longueur et fonctionne de la même manière que varchar.

    ALTER TABLE customers ALTER COLUMN name TYPE varchar(200);
    -- or
    ALTER TABLE customers ALTER COLUMN name TYPE text;
  3. Si la troncature est acceptable, faites-le explicitement.

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

Reproduisez-le en toute sécurité

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)

Questions

Le type text est-il plus lent que varchar dans PostgreSQL ?

Non. text et varchar partagent le même stockage. Une limite de longueur est une contrainte sur les données, pas un facteur de performance.

Erreurs liées

Plus d'erreurs d'exception de données

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL 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 PostgreSQL et les autres bases de données que vous utilisez.