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
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
seriales una clave primaria (entero) que alcanzó 2147483647, así quenextvalproduce 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 unnumeric(5,2)columna. - Convertir un valor de texto o float grande a
integerosmallint.
Cómo solucionarlo
-
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;
-
Convierte a un tipo más amplio antes de la aritmética, no después.
SELECT qty::bigint * unit_price_cents FROM order_lines;
-
Aumentar la precisión de un
numeric(p, s)columna.ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
-
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
22001valor demasiado largo para el tipo22P02sintaxis de entrada no válida para el tipo22012división por cero8115SQL Server: Error de desbordamiento aritmético al convertir1264MySQL: valor fuera de rango para la columnaORA-01438Oracle: valor mayor que la precisión especificada
Más errores de excepción de datos
22021secuencia de bytes no válida para la codificación22008valor del campo fecha/hora fuera de rango22007formato de fecha/hora no válido22023valor de parámetro no válido
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.
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.