// Referencia de errores de PostgreSQL

PostgreSQL 22003: valor numérico fuera de rango

Un número no cabe en su tipo: un desbordamiento de entero, un valor demasiado grande para numeric(p,s) o una columna id que alcanzó el límite de int4.

SQLSTATE
22003
Nombre
numeric_value_out_of_range
Categoría
Excepción de datos
Mensaje de error
integer out of range

Qué significa

Cada tipo numérico tiene un rango: smallint hasta 32767, integer hasta 2147483647, bigint hasta aproximadamente 9,2 × 10^18, y numeric(p, s) hasta p dígitos con s después del punto. Un valor o el resultado de un cálculo fuera del rango falla con 22003. El mensaje nombra el tipo: integer out of range, bigint out of range, smallint out of range, o numeric field overflow para numeric(p, s).

La aritmética con dos enteros se realiza en entero, así que count * price_in_cents puede desbordarse incluso cuando la respuesta final se almacena en un bigint columna.

Causas comunes

  • A serial es una clave primaria (entero) que alcanzó 2147483647, así que nextval produce un valor que la columna no admite.
  • Multiplicar o sumar enteros cuyo resultado excede el rango de enteros antes de convertirlo.
  • Un valor con más dígitos de los que numeric(p, s) permite, por ejemplo 1000.00 en un numeric(5,2) columna.
  • Convertir un valor de texto o float grande a integer o smallint.

Cómo solucionarlo

  1. Amplía la columna; si un id entero se está quedando sin valores, cambia a bigint (esto reescribe la tabla, así que planifícalo).

    ALTER TABLE events ALTER COLUMN id TYPE bigint;
    ALTER SEQUENCE events_id_seq AS bigint;
  2. Convierte a un tipo más amplio antes de la aritmética, no después.

    SELECT qty::bigint * unit_price_cents FROM order_lines;
  3. Aumentar la precisión de un numeric(p, s) columna.

    ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
  4. Comprueba qué tan cerca está una secuencia de su límite.

    SELECT last_value, max_value FROM pg_sequences WHERE sequencename = 'events_id_seq';

Reprodúcelo de forma segura

SELECT 2147483647 + 1;      -- ERROR: integer out of range
SELECT 1000::numeric(5, 2);  -- ERROR: numeric field overflow

Errores relacionados

Más errores de excepción de datos

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.