// PostgreSQL 錯誤參考

PostgreSQL 22001:值超過類型所允許的長度

字串長度超過欄位的 varchar(n) 或 char(n) 上限。PostgreSQL 會直接拒絕,而不是默默截斷。

SQLSTATE
22001
名稱
string_data_right_truncation
類別
資料異常
錯誤訊息
value too long for type character varying(20)

它的意義

A varchar(n) 或 char(n) 欄位最多只能容納 n 個字元。插入或更新更長的值會失敗並傳回 22001(string_data_right_truncation。PostgreSQL 只有在你明確轉型時才會默默截斷,例如 'abcdef'::varchar(3),這是 SQL 標準所要求的。

訊息只指出類型而沒指出欄位,所以當有多個受長度限制的欄位時,你得檢查是哪一個值太長。

常見原因

  • 使用者輸入或匯入的資料長度超過欄位定義。
  • 多欄位的 INSERT 其中值的順序與欄位清單不同,將長值放入短欄位。
  • 從限制嚴格的其他資料庫遷移過來的結構描述。

如何修正

  1. 比較值長度與上限,找出是哪個欄位溢位。

    SELECT column_name, character_maximum_length
    FROM information_schema.columns
    WHERE table_name = 'customers' AND character_maximum_length IS NOT NULL;
  2. 加寬欄位,或使用 text,它沒有長度限制,效能等同 varchar.

    ALTER TABLE customers ALTER COLUMN name TYPE varchar(200);
    -- or
    ALTER TABLE customers ALTER COLUMN name TYPE text;
  3. 如果截斷可以接受,請明確執行截斷。

    INSERT INTO customers (name) VALUES (left('a very long name ...', 20));

安全地重現問題

SELECT CAST('abc' AS varchar(2)) AS silently_truncated;
CREATE TEMP TABLE t (code varchar(2));
INSERT INTO t VALUES ('abc');  -- ERROR: value too long for type character varying(2)

問題

在 PostgreSQL 中,text 比 varchar 慢嗎?

不會。text 和 varchar 使用相同的儲存方式。長度限制是對資料的約束,而不是效能特性。

相關錯誤

更多資料例外狀況錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

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