// SQL Server 錯誤參考

SQL Server 錯誤 2601:無法插入重複索引鍵的資料列

INSERT 或 UPDATE 會把重複值放進唯一索引。訊息會指出資料表、索引與重複的鍵值。

錯誤號碼
2601
嚴重性
14
類別
條件約束與索引鍵
錯誤訊息
Cannot insert duplicate key row in object '%.*ls' with unique index '%.*ls'. The duplicate key value is %ls.

它的意義

錯誤 2601 由唯一索引引發,該索引建立時使用了 CREATE UNIQUE INDEX,包括篩選的唯一索引。它是 2627 的索引對應錯誤,2627 來自 PRIMARY KEY 和 UNIQUE 條件約束。該陳述式會停止,其變更會被回滾。

常見原因

  • 在受唯一索引涵蓋的欄位中,寫入另一列已有的值。
  • 在可為 NULL 的欄位上建唯一索引:SQL Server 在唯一索引中把 NULL 視為相等,所以除非是篩選索引,否則只能有一列是 NULL。
  • 來源含有重複值的載入作業。

如何修正

  1. 用訊息中的值找出衝突的資料列,然後更新該列或略過新資料。

    SELECT * FROM dbo.Users WHERE UserName = N'ada';
  2. 若要允許多個 NULL 同時保持非 NULL 值的唯一性,請將索引設為篩選索引。

    DROP INDEX UX_Users_TaxId ON dbo.Users;
    CREATE UNIQUE INDEX UX_Users_TaxId ON dbo.Users (TaxId) WHERE TaxId IS NOT NULL;
  3. 檢查索引涵蓋了哪些欄位。

    EXEC sp_helpindex 'dbo.Users';

安全地重現問題

CREATE TABLE #u (v int NULL);
CREATE UNIQUE INDEX ux ON #u (v);
INSERT INTO #u VALUES (NULL);
INSERT INTO #u VALUES (NULL);  -- Msg 2601: The duplicate key value is (<NULL>).
DROP TABLE #u;

問題

為什麼我無法在唯一欄位插入第二個 NULL?

在 SQL Server 中,唯一索引或條件約束會把 NULL 視為一個值,因此只允許一個 NULL。使用 WHERE column IS NOT NULL 的篩選唯一索引則允許任意數量的 NULL。

相關錯誤

更多條件約束與索引鍵錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQL Server

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