// 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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQL Server 以及你使用的其他数据库。