// Référence des erreurs PostgreSQL

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
Message d'erreur
integer out of range

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, donc nextval produit 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 un numeric(5,2) colonne.
  • Conversion d’une valeur texte ou flottante de grande taille en integer ou smallint.

Comment le corriger

  1. É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;
  2. Convertir en un type plus large avant l'arithmétique, pas après.

    SELECT qty::bigint * unit_price_cents FROM order_lines;
  3. Augmenter la précision d'un numeric(p, s) colonne.

    ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
  4. 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

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.