PostgreSQL 22003 : valeur numérique hors plage
Un nombre ne tient pas dans son type : dépassement d’entier, valeur trop grande pour numeric(p,s), ou colonne id arrivée à la limite int4.
- SQLSTATE
22003- Nom
numeric_value_out_of_range- Catégorie
- Exception de données
Ce que cela signifie
Chaque type numérique a une plage : smallint jusqu'à 32767, integer jusqu'à 2147483647, bigint jusqu'à environ 9,2 × 10^18, et numeric(p, s) jusqu'à p chiffres dont s après la virgule. Une valeur ou un résultat de calcul hors de la plage provoque l'erreur 22003. Le message nomme le type : integer out of range, bigint out of range, smallint out of range, ou numeric field overflow pour numeric(p, s).
L'arithmétique sur deux entiers se fait en calcul entier, donc count * price_in_cents peut déborder même lorsque la réponse finale est stockée dans un bigint colonne.
Causes courantes
- A
serial(entier) clé primaire a atteint 2147483647, doncnextvalproduit une valeur que la colonne ne peut pas contenir. - Multiplier ou additionner des entiers dont le résultat dépasse la plage des entiers avant qu'il ne soit converti.
- Une valeur avec plus de chiffres que
numeric(p, s)le permet, par exemple 1000,00 dans unnumeric(5,2)colonne. - Conversion d’une valeur texte ou flottante de grande taille en
integerousmallint.
Comment le corriger
-
Élargir la colonne ; pour un identifiant entier qui arrive à épuisement, passer à
bigint(cela réécrit la table, donc prévoyez-le).ALTER TABLE events ALTER COLUMN id TYPE bigint; ALTER SEQUENCE events_id_seq AS bigint;
-
Convertir en un type plus large avant l'arithmétique, pas après.
SELECT qty::bigint * unit_price_cents FROM order_lines;
-
Augmenter la précision d'un
numeric(p, s)colonne.ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
-
Vérifiez à quel point une séquence est proche de sa limite.
SELECT last_value, max_value FROM pg_sequences WHERE sequencename = 'events_id_seq';
Reproduisez-le en toute sécurité
SELECT 2147483647 + 1; -- ERROR: integer out of range SELECT 1000::numeric(5, 2); -- ERROR: numeric field overflow
Erreurs liées
22001valeur trop longue pour le type22P02syntaxe en entrée invalide pour le type22012division par zéro8115SQL Server : Erreur de dépassement arithmétique lors de la conversion1264MySQL : Valeur hors plage pour la colonneORA-01438Oracle : valeur supérieure à la précision spécifiée
Plus d'erreurs d'exception de données
22021séquence d'octets invalide pour l'encodage22008valeur de champ date/heure hors limites22007format de date/heure invalide22023valeur de paramètre invalide
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.