// PostgreSQL 錯誤參考

PostgreSQL 22003:數值超出範圍

數字放不進它的型別:整數溢位、值大到 numeric(p,s) 表示不了,或 id 欄位到了 int4 上限。

SQLSTATE
22003
名稱
numeric_value_out_of_range
類別
資料異常
錯誤訊息
integer out of range

它的意義

每種數值類型都有其範圍: smallint 最大到 32767, integer 最大到 2147483647, bigint 最大到約 9.2 × 10^18,以及 numeric(p, s) 最多 p 位數且小數點後有 s 位。超出範圍的值或計算結果會導致 22003 錯誤。訊息會標明類型: integer out of range, bigint out of range, smallint out of range,或 numeric field overflow 針對 numeric(p, s).

兩個整數間的算術會以整數進行,所以 count * price_in_cents 也可能會溢位,即使最終答案存入的是 bigint 欄位。

常見原因

  • A serial (integer) 主鍵達到了 2147483647,所以 nextval 產生了欄位無法容納的值。
  • 將整數相乘或相加時,結果在轉型前就超出整數範圍。
  • 位數多於 numeric(p, s) 允許 1000.00 這樣的值出現在某個 numeric(5,2) 欄位。
  • 將大型文字或浮點值轉換為 integer 或 smallint.

如何修正

  1. 加寬欄位;整數 id 快用完時,改用 bigint (這會重寫整個資料表,請預先規劃)。

    ALTER TABLE events ALTER COLUMN id TYPE bigint;
    ALTER SEQUENCE events_id_seq AS bigint;
  2. 在算術之前先轉換成較寬的類型,而不是之後。

    SELECT qty::bigint * unit_price_cents FROM order_lines;
  3. 提高以下類型的精確度: numeric(p, s) 欄位。

    ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
  4. 檢查序列距離上限還有多遠。

    SELECT last_value, max_value FROM pg_sequences WHERE sequencename = 'events_id_seq';

安全地重現問題

SELECT 2147483647 + 1;      -- ERROR: integer out of range
SELECT 1000::numeric(5, 2);  -- ERROR: numeric field overflow

相關錯誤

更多資料例外狀況錯誤

程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。