// SQLite 錯誤參考
SQLITE_CONSTRAINT_UNIQUE:UNIQUE 約束失敗
INSERT 或 UPDATE 會在 UNIQUE 欄位或唯一索引中產生重複值。訊息會指出資料表與欄位。
- 結果代碼
SQLITE_CONSTRAINT_UNIQUE- 名稱
2067- 類別
- 擴展結果程式碼
它的意義
SQLite 會傳回 SQLITE_CONSTRAINT_UNIQUE (2067),當一次寫入會建立兩筆值相同的資料列,而位置在同一個 UNIQUE 約束或唯一索引。訊息會列出相關欄位,如 table.column,多欄位鍵以逗號分隔。重複的主鍵回報時會附上 SQLITE_CONSTRAINT_PRIMARYKEY 但使用相同的訊息文字。
NULL 不計入重複:唯一欄位可以包含任意數量的 NULL。
常見原因
- 插入已存在的列,例如重新執行匯入。
- 有兩個只差大小寫的值,出現在宣告為
COLLATE NOCASE. - 一個
UPDATE把該欄位設成另一列已有的值。
如何修正
-
找出現有的資料列。
SELECT * FROM users WHERE email = '[email protected]';
-
改用 upsert(SQLite 3.24 之後版本)更新現有的資料列。
INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = excluded.name; -
或者刻意略過重複資料。
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_CONSTRAINT_PRIMARYKEY主鍵條件約束失敗SQLITE_CONSTRAINT約束失敗23505PostgreSQL:重複鍵值違反唯一條件約束1062MySQL:索引鍵值重複2627SQL Server:違反 PRIMARY KEY 或 UNIQUE KEY2601SQL Server:無法插入重複的索引鍵資料列ORA-00001Oracle:違反唯一條件約束
更多延伸結果碼錯誤
SQLITE_ERROR_MISSING_COLLSEQ沒有這樣的排序規則SQLITE_BUSY_RECOVERY另一個處理程序正在復原 WALSQLITE_LOCKED_SHAREDCACHE共用快取中的記錄被鎖定SQLITE_CONSTRAINT_CHECKCHECK 條件約束失敗SQLITE_ABORT_ROLLBACK陳述式被 ROLLBACK 中止SQLITE_BUSY_SNAPSHOT陳舊讀取無法變成寫入SQLITE_IOERR_SHORT_READ讀取傳回的位元組數比預期少SQLITE_CANTOPEN_ISDIR該路徑是目錄
程式碼和訊息文字來自 SQLite 結果代碼與錯誤碼文件。瀏覽完整的 SQLite 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 SQLite
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQLite 和你使用的其他資料庫。