SQL Server 錯誤 8152:字串或二進位資料被截斷
值比要放入的欄位長,SQL Server 因此中止 INSERT 或 UPDATE,而不是逕行截斷。較新的版本會指出欄位名稱(2628)。
- 錯誤號碼
8152- 嚴重性
- 16
- 類別
- 資料轉換與截斷
它的意義
SQL Server 不會默默縮短資料。如果字串或二進位值比目標欄位長,例如要把 60 個字元放進 varchar(50),語句就會失敗。錯誤 8152 不會說是哪個欄位或哪一列,很難抓問題,所以 SQL Server 2019 改用錯誤 2628,會指出資料表、欄位和被截斷的值。
常見原因
- 資料比欄位宣告的長度還長,通常來自使用者輸入或匯入。
- 對實際資料來說太窄的欄位,例如
nvarchar(50)針對電子郵件位址或名稱。 - 一個
INSERT ... SELECT其欄位順序與目標欄位清單不同,因此長欄位會落入短欄位中。 - 程序裡宣告得太短的變數或資料表變數,會默默截斷,發生在
SET但無法用於INSERT.
如何修正
-
在 SQL Server 2019 及更新版本,會改為收到 2628 錯誤,並附上欄位與值。資料庫相容性層級 150 以上預設開啟;你也可以明確開啟。
ALTER DATABASE SCOPED CONFIGURATION SET VERBOSE_TRUNCATION_WARNINGS = ON;
-
比較來源長度與目標欄位來找出問題。
SELECT MAX(LEN(Email)) AS max_email, MAX(LEN(Name)) AS max_name FROM staging.Customers; SELECT name, max_length, TYPE_NAME(user_type_id) AS type_name FROM sys.columns WHERE object_id = OBJECT_ID(N'dbo.Customers');
-
如果資料合法,請將欄位加寬。
ALTER TABLE dbo.Customers ALTER COLUMN Email nvarchar(320) NOT NULL;
-
或在可接受截斷的情況下刻意縮短。
INSERT INTO dbo.Notes (Summary) SELECT LEFT(Body, 200) FROM staging.Notes;
-
一律在
INSERT ... SELECT以免順序偏移。
安全地重現問題
CREATE TABLE #t (code varchar(3));
INSERT INTO #t VALUES ('ABCD'); -- 8152, or 2628 on SQL Server 2019+
DROP TABLE #t;
問題
如何找出是哪一個欄位被截斷?
在 SQL Server 2019 或更新版本且相容性層級 150 時,錯誤會變成 2628,並指出資料表、欄位與值。在較舊的版本上,請將每個來源欄位的 MAX(LEN(...)) 與目標欄位長度比較。
我可以讓 SQL Server 改為默默截斷嗎?
SET ANSI_WARNINGS OFF 使插入操作在截斷時不報錯,但它也會改變其他行為,並且不允許用於索引檢視或計算資料行索引。若意圖截斷,建議明確使用 LEFT()。
相關錯誤
2628於資料表、欄位發生截斷245轉換值時失敗22001PostgreSQL:值超出類型的長度限制1406MySQL:資料長度超過欄位限制ORA-12899Oracle:值超過欄位可容納的大小
更多資料轉換與截斷錯誤
241日期與/或時間轉換失敗242超出範圍的日期轉換8115轉換時發生算術溢位錯誤8114轉換資料類型時發生錯誤512子查詢傳回超過 1 個值8134發生除以零錯誤220算術溢位錯誤,資料類型248轉換導致整數欄位溢位
程式碼和訊息文字來自 Microsoft 資料庫引擎事件和錯誤參考。瀏覽完整的 SQL Server 錯誤清單 或 搜尋每個資料庫錯誤.
在 SQLly 裡操作 SQL Server
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQL Server 和你使用的其他資料庫。