// SQL Server 错误参考

SQL Server 错误 515:无法将 NULL 值插入列

INSERT 或 UPDATE 操作使一个 NOT NULL 列没有值。消息会指明列名、表名以及失败的语句。

错误编号
515
严重性
16
类别
约束与键
错误信息
Cannot insert the value NULL into column '%.*ls', table '%.*ls'; column does not allow nulls. %ls fails.

它的意思

一个声明为 NOT NULL 的列必须始终有值。如果 INSERT 没有列出该列且该列没有默认值,或者一个 UPDATE 将其设置为 NULL,SQL Server 会以 515 停止该语句。

常见原因

  • 这 INSERT 列列表漏掉了一个 NOT NULL 列没有 DEFAULT.
  • 传递给该列的变量或参数为 NULL。
  • 一个 INSERT ... SELECT 其来源有 NULL 值,通常来自外连接。
  • 新的 NOT NULL 列在添加时没有默认值,而旧代码也不提供它。

如何修复它

  1. 为该列提供一个值,或包裹可能为 NULL 的输入。

    INSERT INTO dbo.Orders (CustomerId, Status, CreatedAt)
    VALUES (@CustomerId, COALESCE(@Status, 'new'), SYSUTCDATETIME());
  2. 如果该列应自动获取值,请添加默认约束。

    ALTER TABLE dbo.Orders ADD CONSTRAINT DF_Orders_CreatedAt DEFAULT (SYSUTCDATETIME()) FOR CreatedAt;
  3. 先找出包含 NULL 值的源行,然后再执行 INSERT ... SELECT.

    SELECT * FROM staging.Orders WHERE Status IS NULL;

安全地复现它

CREATE TABLE #n (a int NOT NULL, b int NULL);
INSERT INTO #n (b) VALUES (1);  -- Msg 515: Cannot insert the value NULL into column 'a' ...
DROP TABLE #n;

相关错误

更多约束和键错误

代码和消息文本来自 Microsoft 数据库引擎事件和错误参考。浏览完整的 SQL Server 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQL Server

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQL Server 以及你使用的其他数据库。