// PostgreSQL 錯誤參考
PostgreSQL 22003:數值超出範圍
數字放不進它的型別:整數溢位、值大到 numeric(p,s) 表示不了,或 id 欄位到了 int4 上限。
- SQLSTATE
22003- 名稱
numeric_value_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.
如何修正
-
加寬欄位;整數 id 快用完時,改用
bigint(這會重寫整個資料表,請預先規劃)。ALTER TABLE events ALTER COLUMN id TYPE bigint; ALTER SEQUENCE events_id_seq AS bigint;
-
在算術之前先轉換成較寬的類型,而不是之後。
SELECT qty::bigint * unit_price_cents FROM order_lines;
-
提高以下類型的精確度:
numeric(p, s)欄位。ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
-
檢查序列距離上限還有多遠。
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
相關錯誤
22001值對類型而言過長22P02無效的輸入語法,類型為22012除以零8115SQL Server:轉換時發生算術溢位錯誤1264MySQL:欄位的值超出範圍ORA-01438Oracle:值大於指定的精確度
更多資料例外狀況錯誤
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。