// PostgreSQL 错误参考

PostgreSQL 22012:除以零

一个表达式让数字除以零。对整数和 numeric 除法,PostgreSQL 会报错,而不是返回 NULL 或无穷大。

SQLSTATE
22012
名称
division_by_zero
类别
数据异常
错误信息
division by zero

它的意思

将整数或 numeric 值除以零,或对零取模,在 PostgreSQL 中都是错误。它通常出现在某些分组的分母为零的报表和比率中。浮点数除以零同样会报错。

因为 PostgreSQL 可能以任意顺序计算表达式, WHERE x <> 0 筛选器并不总能保护同一查询选择列表中的表达式;请对表达式本身另行设防。

常见原因

  • 一个比率,例如 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 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。