// Oracle 錯誤參考

ORA-12899:欄位值過大

某個值比該欄位允許的長度還長。該訊息會指出欄位名稱並提供實際長度與最大長度,通常以位元組而非字元計算。

錯誤碼
ORA-12899
類別
資料值和轉換
錯誤訊息
value too large for column string (actual: string, maximum: string)

它的意義

ORA-12899 表示字串不符合欄位大小,例如 ORA-12899: value too large for column "SALES"."CUSTOMERS"."NAME" (actual: 61, maximum: 50)。一個 VARCHAR2(50) 欄位預設為 50 位元組(NLS_LENGTH_SEMANTICS = BYTE),所以帶有重音符號或非拉丁字元的文字,在 AL32UTF8 編碼下每個字元佔 2 到 4 個位元組,可能會溢出看似足夠長的欄位。

常見原因

  • 資料長度超過欄位定義。
  • 以位元組為單位的欄位中的多位元組字元。
  • 遷移到 Unicode 資料庫字元集,會導致某些字串的位元組長度變長。

如何修正

  1. 找出會存入該欄位的最長值,並與欄位定義相比。

    SELECT column_name, data_type, data_length, char_length, char_used
    FROM all_tab_columns WHERE table_name = 'CUSTOMERS' AND column_name = 'NAME';
  2. 加寬欄位;若欄位存放多種語言的文字,就以字元數決定寬度。

    ALTER TABLE customers MODIFY (name VARCHAR2(200 CHAR));
  3. 或者,若可接受截去尾部,也可以在插入前故意截斷。

    INSERT INTO customers (name) VALUES (SUBSTR(:name, 1, 50));

相關錯誤

更多資料值及轉換錯誤

程式碼和訊息文字來自 Oracle 資料庫錯誤說明。瀏覽完整的 Oracle 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 Oracle

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