// 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 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。