// SQLite 錯誤參考

SQLITE_CONSTRAINT_UNIQUE:UNIQUE 約束失敗

INSERT 或 UPDATE 會在 UNIQUE 欄位或唯一索引中產生重複值。訊息會指出資料表與欄位。

結果代碼
SQLITE_CONSTRAINT_UNIQUE
名稱
2067
類別
擴展結果程式碼
錯誤訊息
UNIQUE constraint failed: users.email

它的意義

SQLite 會傳回 SQLITE_CONSTRAINT_UNIQUE (2067),當一次寫入會建立兩筆值相同的資料列,而位置在同一個 UNIQUE 約束或唯一索引。訊息會列出相關欄位,如 table.column,多欄位鍵以逗號分隔。重複的主鍵回報時會附上 SQLITE_CONSTRAINT_PRIMARYKEY 但使用相同的訊息文字。

NULL 不計入重複:唯一欄位可以包含任意數量的 NULL。

常見原因

  • 插入已存在的列,例如重新執行匯入。
  • 有兩個只差大小寫的值,出現在宣告為 COLLATE NOCASE.
  • 一個 UPDATE 把該欄位設成另一列已有的值。

如何修正

  1. 找出現有的資料列。

    SELECT * FROM users WHERE email = '[email protected]';
  2. 改用 upsert(SQLite 3.24 之後版本)更新現有的資料列。

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. 或者刻意略過重複資料。

    INSERT OR IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');

安全地重現問題

CREATE TABLE users (email TEXT UNIQUE);
INSERT INTO users VALUES ('a@x');
INSERT INTO users VALUES ('a@x');  -- Runtime error: UNIQUE constraint failed: users.email (19)

問題

INSERT OR REPLACE 和 upsert 之間有何區別?

INSERT OR REPLACE 會刪除衝突的資料列並插入新的資料列,因此未提供的欄位會被重設,刪除觸發器和外鍵動作也可能觸發。而使用 ON CONFLICT DO UPDATE 的 upsert 會就地更新現有資料列。

相關錯誤

更多延伸結果碼錯誤

程式碼和訊息文字來自 SQLite 結果代碼與錯誤碼文件。瀏覽完整的 SQLite 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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