PostgreSQL 22003: valor numérico fora do intervalo
Um número não cabe no seu tipo: um estouro de inteiro, um valor grande demais para numeric(p,s), ou uma coluna de id que atingiu o limite do int4.
- SQLSTATE
22003- Nome
numeric_value_out_of_range- Categoria
- Exceção de dados
O que significa
Cada tipo numérico tem um intervalo: smallint até 32767, integer até 2147483647, bigint até cerca de 9,2 × 10^18, e numeric(p, s) até p dígitos, com s depois do ponto decimal. Um valor ou resultado de cálculo fora do intervalo falha com 22003. A mensagem indica o tipo: integer out of range, bigint out of range, smallint out of range, ou numeric field overflow para numeric(p, s).
A aritmética em dois inteiros é feita em inteiro, então count * price_in_cents pode estourar mesmo quando a resposta final é armazenada em um bigint coluna.
Causas comuns
- A
serialchave primária (integer) atingiu 2147483647, entãonextvalproduz um valor que a coluna não pode conter. - Multiplicar ou somar inteiros cujo resultado excede o intervalo de inteiros antes de ser convertido.
- Um valor com mais dígitos do que
numeric(p, s)permite, por exemplo 1000,00 em umnumeric(5,2)coluna. - Converter um texto ou valor float grande para
integerousmallint.
Como corrigir
-
Aumente a largura da coluna; para um id inteiro que está acabando, mude para
bigint(isto reescreve a tabela, então planeje).ALTER TABLE events ALTER COLUMN id TYPE bigint; ALTER SEQUENCE events_id_seq AS bigint;
-
Converta para um tipo mais amplo antes da aritmética, não depois.
SELECT qty::bigint * unit_price_cents FROM order_lines;
-
Aumente a precisão de um
numeric(p, s)coluna.ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
-
Verifique quão próxima uma sequência está do seu limite.
SELECT last_value, max_value FROM pg_sequences WHERE sequencename = 'events_id_seq';
Reproduza com segurança
SELECT 2147483647 + 1; -- ERROR: integer out of range SELECT 1000::numeric(5, 2); -- ERROR: numeric field overflow
Erros relacionados
22001valor muito longo para o tipo22P02sintaxe de entrada inválida para o tipo22012divisão por zero8115SQL Server: Erro de estouro aritmético ao converter1264MySQL: valor fora do intervalo para a colunaORA-01438Oracle: valor maior que a precisão especificada
Mais erros de exceção de dados
22021sequência de bytes inválida para a codificação22008valor do campo data/hora fora do intervalo22007formato de data/hora inválido22023valor de parâmetro inválido
O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.
Trabalhe com PostgreSQL no SQLly
Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.