// SQLite 錯誤參考
SQLITE_CONSTRAINT_FOREIGNKEY:FOREIGN KEY 約束失敗
寫入會讓子資料列指向不存在的父資料列,或刪除仍有子資料列的父資料列。外鍵必須在每個連線個別啟用。
- 結果代碼
SQLITE_CONSTRAINT_FOREIGNKEY- 名稱
787- 類別
- 擴展結果程式碼
它的意義
SQLITE_CONSTRAINT_FOREIGNKEY (787) 表示外鍵檢查失敗。SQLite 只會在執行了 PRAGMA foreign_keys = ON;基於向下相容性,這個選項預設關閉,這就是同一個插入操作在一個工具會成功、在另一個工具卻失敗的原因。
訊息未指出哪個鍵失敗。 PRAGMA foreign_key_check 列出每個違規的資料列。
常見原因
- 插入一個父 ID 不存在的子列。
- 刪除或更新仍有子列的父列,而不
ON DELETE CASCADE或SET NULL. - 以錯誤的順序載入資料表:子資料表排在父資料表之前。
- 延遲條件約束(
DEFERRABLE INITIALLY DEFERRED)失敗於COMMIT.
如何修正
-
找出違反外鍵的資料列。
PRAGMA foreign_key_check; PRAGMA foreign_key_list(orders);
-
在子項目之前插入父項目,或在父項目之前刪除子項目。
-
大量載入時,把檢查延後到交易結束再進行。
BEGIN; PRAGMA defer_foreign_keys = ON; -- load tables in any order COMMIT;
-
如果刪除父項應該同時移除其子項,請在外鍵上宣告此操作。
CREATE TABLE orders ( id INTEGER PRIMARY KEY, customer_id INTEGER NOT NULL REFERENCES customers(id) ON DELETE CASCADE );
安全地重現問題
PRAGMA foreign_keys = ON; CREATE TABLE p (id INTEGER PRIMARY KEY); CREATE TABLE c (pid INTEGER REFERENCES p(id)); INSERT INTO c VALUES (1); -- Runtime error: FOREIGN KEY constraint failed (19)
問題
為什麼我的 SQLite 資料庫沒有強制執行外鍵?
強制執行是針對每個連線的,且預設為關閉。每個連線都必須執行 PRAGMA foreign_keys = ON,而且在交易內無法更改。
相關錯誤
SQLITE_CONSTRAINT約束失敗23503PostgreSQL:違反外鍵條件約束1452MySQL:外鍵失敗:無法新增子資料列1451MySQL:外鍵失敗:無法刪除父列547SQL Server:陳述式與條件約束衝突ORA-02291Oracle:違反完整性條件約束 - 找不到父代鍵ORA-02292Oracle:違反完整性條件約束 - 找到子記錄
更多延伸結果碼錯誤
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 和你使用的其他資料庫。