// SQL Server 錯誤參考

SQL Server 錯誤 8152:字串或二進位資料被截斷

值比要放入的欄位長,SQL Server 因此中止 INSERT 或 UPDATE,而不是逕行截斷。較新的版本會指出欄位名稱(2628)。

錯誤號碼
8152
嚴重性
16
類別
資料轉換與截斷
錯誤訊息
String or binary data would be truncated.

它的意義

SQL Server 不會默默縮短資料。如果字串或二進位值比目標欄位長,例如要把 60 個字元放進 varchar(50),語句就會失敗。錯誤 8152 不會說是哪個欄位或哪一列,很難抓問題,所以 SQL Server 2019 改用錯誤 2628,會指出資料表、欄位和被截斷的值。

常見原因

  • 資料比欄位宣告的長度還長,通常來自使用者輸入或匯入。
  • 對實際資料來說太窄的欄位,例如 nvarchar(50) 針對電子郵件位址或名稱。
  • 一個 INSERT ... SELECT 其欄位順序與目標欄位清單不同,因此長欄位會落入短欄位中。
  • 程序裡宣告得太短的變數或資料表變數,會默默截斷,發生在 SET 但無法用於 INSERT.

如何修正

  1. 在 SQL Server 2019 及更新版本,會改為收到 2628 錯誤,並附上欄位與值。資料庫相容性層級 150 以上預設開啟;你也可以明確開啟。

    ALTER DATABASE SCOPED CONFIGURATION SET VERBOSE_TRUNCATION_WARNINGS = ON;
  2. 比較來源長度與目標欄位來找出問題。

    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');
  3. 如果資料合法,請將欄位加寬。

    ALTER TABLE dbo.Customers ALTER COLUMN Email nvarchar(320) NOT NULL;
  4. 或在可接受截斷的情況下刻意縮短。

    INSERT INTO dbo.Notes (Summary) SELECT LEFT(Body, 200) FROM staging.Notes;
  5. 一律在 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()。

相關錯誤

更多資料轉換與截斷錯誤

程式碼和訊息文字來自 Microsoft 資料庫引擎事件和錯誤參考。瀏覽完整的 SQL Server 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 SQL Server

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