// SQLite 錯誤參考
SQLITE_CONSTRAINT_PRIMARYKEY:PRIMARY KEY 約束失敗
INSERT 或 UPDATE 會造成主鍵值重複。SQLite 的訊息仍會顯示 UNIQUE constraint failed,並指出鍵欄位名稱。
- 結果代碼
SQLITE_CONSTRAINT_PRIMARYKEY- 名稱
1555- 類別
- 擴展結果程式碼
它的意義
SQLITE_CONSTRAINT_PRIMARYKEY (1555) 是主鍵重複時對應的延伸錯誤碼。訊息文字與任何唯一性衝突相同, UNIQUE constraint failed: table.column,所以程式是靠延伸碼來區分兩者的。
對於 INTEGER PRIMARY KEY 欄位,你可以省略值(或傳入 NULL),SQLite 會指派下一個 rowid,避開大多數衝突。
常見原因
- 插入已存在的明確 ID。
- 在資料庫之間複製帶 id 的資料列,且兩邊範圍重疊。
- 在應用程式裡用可能重複的方式產生 id。
如何修正
-
讓 SQLite 指派
INTEGER PRIMARY KEY省略該欄位來提供值。INSERT INTO orders (customer_id, total) VALUES (42, 19.99); SELECT last_insert_rowid();
-
合併資料時,以鍵進行 upsert,或跳過已存在的資料列。
INSERT INTO orders (id, customer_id, total) SELECT id, customer_id, total FROM other.orders WHERE true ON CONFLICT (id) DO NOTHING;
相關錯誤
SQLITE_CONSTRAINT_UNIQUE唯一約束失敗SQLITE_MISMATCH資料類型不符SQLITE_CONSTRAINT約束失敗23505PostgreSQL:重複鍵值違反唯一條件約束1062MySQL:索引鍵值重複
更多延伸結果碼錯誤
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 和你使用的其他資料庫。