// 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 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQL Server 和你使用的其他資料庫。