// PostgreSQL 錯誤參考
PostgreSQL 22001:值超過類型所允許的長度
字串長度超過欄位的 varchar(n) 或 char(n) 上限。PostgreSQL 會直接拒絕,而不是默默截斷。
- SQLSTATE
22001- 名稱
string_data_right_truncation- 類別
- 資料異常
它的意義
A varchar(n) 或 char(n) 欄位最多只能容納 n 個字元。插入或更新更長的值會失敗並傳回 22001(string_data_right_truncation。PostgreSQL 只有在你明確轉型時才會默默截斷,例如 'abcdef'::varchar(3),這是 SQL 標準所要求的。
訊息只指出類型而沒指出欄位,所以當有多個受長度限制的欄位時,你得檢查是哪一個值太長。
常見原因
- 使用者輸入或匯入的資料長度超過欄位定義。
- 多欄位的
INSERT其中值的順序與欄位清單不同,將長值放入短欄位。 - 從限制嚴格的其他資料庫遷移過來的結構描述。
如何修正
-
比較值長度與上限,找出是哪個欄位溢位。
SELECT column_name, character_maximum_length FROM information_schema.columns WHERE table_name = 'customers' AND character_maximum_length IS NOT NULL;
-
加寬欄位,或使用
text,它沒有長度限制,效能等同varchar.ALTER TABLE customers ALTER COLUMN name TYPE varchar(200); -- or ALTER TABLE customers ALTER COLUMN name TYPE text;
-
如果截斷可以接受,請明確執行截斷。
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 使用相同的儲存方式。長度限制是對資料的約束,而不是效能特性。
相關錯誤
22003數值超出範圍22P02無效的輸入語法,類型為8152SQL Server:字串或二進位資料被截斷2628SQL Server:在資料表、欄位中被截斷1406MySQL:資料長度超過欄位限制ORA-12899Oracle:值超過欄位可容納的大小
更多資料例外狀況錯誤
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。