// справочник ошибок PostgreSQL

PostgreSQL 22003: числовое значение вне диапазона

Число не помещается в свой тип: переполнение целого числа, значение слишком велико для numeric(p,s) или столбец id достиг предела int4.

SQLSTATE
22003
Имя
numeric_value_out_of_range
Категория
Исключение данных
Сообщение об ошибке
integer out of range

Что это значит

Каждый числовой тип имеет диапазон: smallint до 32767, integer до 2147483647, bigint до примерно 9,2 × 10^18, и numeric(p, s) до p цифр с s после запятой. Значение или результат вычисления за пределами диапазона вызывает ошибку 22003. Сообщение указывает тип: integer out of range, bigint out of range, smallint out of range, или numeric field overflow для numeric(p, s).

Арифметика двух целых чисел выполняется как целочисленная, поэтому count * price_in_cents может переполниться, даже если итоговый ответ хранится в bigint столбце.

Распространённые причины

  • A serial (целочисленный) первичный ключ достиг 2147483647, поэтому nextval создаёт значение, которое не помещается в столбец.
  • Умножение или суммирование целых чисел, результат которых выходит за пределы целочисленного диапазона до приведения типа.
  • Значение с большим количеством цифр, чем numeric(p, s) позволяет, например 1000.00 в numeric(5,2) столбце.
  • Приведение большого текстового или float-значения к integer или smallint.

Как исправить

  1. Расширьте столбец; для целочисленного идентификатора, у которого заканчивается диапазон значений, перейдите к bigint (это переписывает таблицу, поэтому планируйте соответственно).

    ALTER TABLE events ALTER COLUMN id TYPE bigint;
    ALTER SEQUENCE events_id_seq AS bigint;
  2. Приводите к более широкому типу до выполнения арифметики, а не после.

    SELECT qty::bigint * unit_price_cents FROM order_lines;
  3. Увеличьте точность numeric(p, s) столбце.

    ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
  4. Проверьте, насколько близка последовательность к своему пределу.

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

Безопасное воспроизведение

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

Связанные ошибки

Больше ошибок данных

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.