// SQLite 錯誤參考

SQLITE_CONSTRAINT_PRIMARYKEY:PRIMARY KEY 約束失敗

INSERT 或 UPDATE 會造成主鍵值重複。SQLite 的訊息仍會顯示 UNIQUE constraint failed,並指出鍵欄位名稱。

結果代碼
SQLITE_CONSTRAINT_PRIMARYKEY
名稱
1555
類別
擴展結果程式碼
錯誤訊息
UNIQUE constraint failed: orders.id

它的意義

SQLITE_CONSTRAINT_PRIMARYKEY (1555) 是主鍵重複時對應的延伸錯誤碼。訊息文字與任何唯一性衝突相同, UNIQUE constraint failed: table.column,所以程式是靠延伸碼來區分兩者的。

對於 INTEGER PRIMARY KEY 欄位,你可以省略值(或傳入 NULL),SQLite 會指派下一個 rowid,避開大多數衝突。

常見原因

  • 插入已存在的明確 ID。
  • 在資料庫之間複製帶 id 的資料列,且兩邊範圍重疊。
  • 在應用程式裡用可能重複的方式產生 id。

如何修正

  1. 讓 SQLite 指派 INTEGER PRIMARY KEY 省略該欄位來提供值。

    INSERT INTO orders (customer_id, total) VALUES (42, 19.99);
    SELECT last_insert_rowid();
  2. 合併資料時,以鍵進行 upsert,或跳過已存在的資料列。

    INSERT INTO orders (id, customer_id, total)
    SELECT id, customer_id, total FROM other.orders WHERE true
    ON CONFLICT (id) DO NOTHING;

相關錯誤

更多延伸結果碼錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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