// Referência de erro do PostgreSQL

PostgreSQL 22012: divisão por zero

Uma expressão dividiu um número por zero. O PostgreSQL gera um erro em vez de retornar NULL ou infinito para divisão inteira e numérica.

SQLSTATE
22012
Nome
division_by_zero
Categoria
Exceção de dados
Mensagem de erro
division by zero

O que significa

Dividir um inteiro ou numeric valor por zero, ou calcular um módulo por zero, é um erro no PostgreSQL. Costuma aparecer em relatórios e razões em que alguns grupos têm denominador zero. A divisão de ponto flutuante por zero também é um erro.

Como o PostgreSQL pode avaliar expressões em qualquer ordem, um WHERE x <> 0 o filtro nem sempre protege uma expressão na lista SELECT da mesma consulta; proteja a própria expressão.

Causas comuns

  • Uma razão como revenue / orders onde algumas linhas têm zero pedidos.
  • Uma média calculada manualmente como sum / count sobre um grupo vazio.
  • Confiar em WHERE ou CASE em outra parte da consulta para filtrar as linhas com zero antes que a divisão rode.

Como corrigir

  1. Transforme um divisor zero em NULL com NULLIF; o resultado então é NULL em vez de um erro.

    SELECT region, revenue / NULLIF(order_count, 0) AS avg_order
    FROM region_totals;
  2. Use CASE quando zero deve produzir um valor específico.

    SELECT CASE WHEN order_count = 0 THEN 0 ELSE revenue / order_count END
    FROM region_totals;
  3. Para médias, use avg(), que ignora NULL e retorna NULL para um conjunto vazio.

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

Reproduza com segurança

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

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.