// Referência de erro do PostgreSQL

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
Mensagem de erro
integer out of range

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 serial chave primária (integer) atingiu 2147483647, então nextval produz 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 um numeric(5,2) coluna.
  • Converter um texto ou valor float grande para integer ou smallint.

Como corrigir

  1. 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;
  2. Converta para um tipo mais amplo antes da aritmética, não depois.

    SELECT qty::bigint * unit_price_cents FROM order_lines;
  3. Aumente a precisão de um numeric(p, s) coluna.

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

Mais erros de exceção de dados

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.

// menos erros, correções mais rápidas

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.