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

PostgreSQL 22012: деление на ноль

Выражение разделило число на ноль. PostgreSQL выдаёт ошибку вместо NULL или бесконечности при делении целых и числовых типов.

SQLSTATE
22012
Имя
division_by_zero
Категория
Исключение данных
Сообщение об ошибке
division by zero

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

Деление целого числа или numeric значения на ноль, как и взятие остатка от деления на ноль, — это ошибка в PostgreSQL. Обычно она встречается в отчётах и соотношениях, где у некоторых групп знаменатель равен нулю. Деление чисел с плавающей запятой на ноль — тоже ошибка.

Поскольку PostgreSQL может вычислять выражения в любом порядке, a WHERE x <> 0 фильтр не всегда защищает выражение в списке SELECT того же запроса; подстрахуйте само выражение.

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

  • Соотношение вроде revenue / orders где у некоторых строк количество заказов равно нулю.
  • Среднее, посчитанное вручную как sum / count по пустой группе.
  • Полагаясь на WHERE или CASE в другом месте запроса, чтобы отфильтровать строки с нулями до выполнения деления.

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

  1. Преобразовать нулевой делитель в NULL с NULLIF; результат затем NULL вместо ошибки.

    SELECT region, revenue / NULLIF(order_count, 0) AS avg_order
    FROM region_totals;
  2. Используйте CASE когда ноль должен давать конкретное значение.

    SELECT CASE WHEN order_count = 0 THEN 0 ELSE revenue / order_count END
    FROM region_totals;
  3. Для средних значений используйте avg(), который игнорирует NULL и возвращает NULL для пустого набора.

    SELECT customer_id, avg(amount) FROM payments GROUP BY customer_id;

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

SELECT 1 / 0;  -- ERROR: division by zero

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

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

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

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

Работа с PostgreSQL в SQLly

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