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
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
''dansNULLou 0. - Entrée mal formée pour
uuid,json/jsonb,boolean,inetou un littéral de tableau. - En vrac
COPYou chargements CSV où une ligne contient du texte dans une colonne numérique.
Comment le corriger
-
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');
-
Sur les versions plus anciennes, filtrez avec un motif avant de caster.
SELECT raw_value::int FROM staging WHERE raw_value ~ '^-?[0-9]+$';
-
Transformez les chaînes vides en
NULLexplicitement.SELECT NULLIF(trim(raw_value), '')::int FROM staging;
-
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
22003valeur numérique hors limites22007format de date/heure invalide42804incompatibilité de type de données22021séquence d'octets invalide pour l'encodage245SQL Server : Échec de la conversion d'une valeur1366MySQL : Valeur incorrecte pour la colonneORA-01722Oracle : nombre invalide
Plus d'erreurs d'exception de données
22008valeur de champ date/heure hors limites22012division par zéro22023valeur de paramètre invalide22001valeur trop longue pour le type
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.
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.