// Referencia de errores de PostgreSQL

PostgreSQL 22012: división por cero

Una expresión dividió un número entre cero. PostgreSQL genera un error en lugar de devolver NULL o infinito para la división de enteros y números.

SQLSTATE
22012
Nombre
division_by_zero
Categoría
Excepción de datos
Mensaje de error
division by zero

Qué significa

Dividir un entero o numeric valor entre cero, o calcular un módulo con cero, es un error en PostgreSQL. Suele aparecer en informes y proporciones donde algún grupo tiene denominador cero. La división de punto flotante por cero también es un error.

Como PostgreSQL puede evaluar expresiones en cualquier orden, un WHERE x <> 0 el filtro no siempre protege una expresión en la lista de selección de la misma consulta; protege la propia expresión.

Causas comunes

  • Una proporción tal como revenue / orders donde algunas filas tienen cero pedidos.
  • Un promedio calculado manualmente como sum / count sobre un grupo vacío.
  • Confiar en un WHERE o CASE en otro punto de la consulta para descartar las filas con cero antes de que se ejecute la división.

Cómo solucionarlo

  1. Convierte un divisor cero en NULL con NULLIF; el resultado es entonces NULL en lugar de un error.

    SELECT region, revenue / NULLIF(order_count, 0) AS avg_order
    FROM region_totals;
  2. Usar CASE cuando cero debería producir un valor específico.

    SELECT CASE WHEN order_count = 0 THEN 0 ELSE revenue / order_count END
    FROM region_totals;
  3. Para promedios, usa avg(), que ignora NULL y devuelve NULL para un conjunto vacío.

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

Reprodúcelo de forma segura

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

Errores relacionados

Más errores de excepción de datos

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.