// Référence des erreurs PostgreSQL

PostgreSQL 22P02 : syntaxe d'entrée invalide pour le type

Une valeur de type text n'a pas pu être convertie vers le type cible: des lettres dans un entier, un UUID mal formé, un JSON invalide, une chaîne vide vers un nombre.

SQLSTATE
22P02
Nom
invalid_text_representation
Catégorie
Exception de données
Message d'erreur
invalid input syntax for type integer: "abc"

Ce que cela signifie

PostgreSQL convertit les littéraux et le texte en valeurs typées avec la fonction d’entrée de chaque type. Quand le texte n’est pas une représentation valide du type, la conversion échoue avec 22P02 et le message cite la valeur fautive.

La valeur peut provenir d'un littéral dans la requête, d'un paramètre lié, d'un CAST, ou d'une colonne de texte comparée avec ou insérée dans une colonne typée.

Causes courantes

  • Comparer une colonne numérique ou UUID avec une chaîne qui n'est ni un nombre ni un UUID, par exemple WHERE id = 'abc' ou une chaîne vide ''.
  • Passer une chaîne vide là où un nombre est attendu. PostgreSQL ne transforme pas '' dans NULL ou 0.
  • Entrée mal formée pour uuid, json/jsonb, boolean, inet ou un littéral de tableau.
  • En vrac COPY ou chargements CSV où une ligne contient du texte dans une colonne numérique.

Comment le corriger

  1. Trouvez les lignes qui ne seraient pas converties avant de les caster (PostgreSQL 16 et versions ultérieures ont pg_input_is_valid).

    SELECT raw_value
    FROM staging
    WHERE NOT pg_input_is_valid(raw_value, 'integer');
  2. Sur les versions plus anciennes, filtrez avec un motif avant de caster.

    SELECT raw_value::int
    FROM staging
    WHERE raw_value ~ '^-?[0-9]+$';
  3. Transformez les chaînes vides en NULL explicitement.

    SELECT NULLIF(trim(raw_value), '')::int FROM staging;
  4. Dans le code applicatif, liez les paramètres avec le bon type au lieu de construire des chaînes SQL, et validez l'entrée avant qu'elle n'atteigne la base de données.

Reproduisez-le en toute sécurité

SELECT 'abc'::int;  -- ERROR: invalid input syntax for type integer: "abc"

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.