// SQLite 錯誤參考

SQLITE_CONSTRAINT_FOREIGNKEY:FOREIGN KEY 約束失敗

寫入會讓子資料列指向不存在的父資料列,或刪除仍有子資料列的父資料列。外鍵必須在每個連線個別啟用。

結果代碼
SQLITE_CONSTRAINT_FOREIGNKEY
名稱
787
類別
擴展結果程式碼
錯誤訊息
FOREIGN KEY constraint failed

它的意義

SQLITE_CONSTRAINT_FOREIGNKEY (787) 表示外鍵檢查失敗。SQLite 只會在執行了 PRAGMA foreign_keys = ON;基於向下相容性,這個選項預設關閉,這就是同一個插入操作在一個工具會成功、在另一個工具卻失敗的原因。

訊息未指出哪個鍵失敗。 PRAGMA foreign_key_check 列出每個違規的資料列。

常見原因

  • 插入一個父 ID 不存在的子列。
  • 刪除或更新仍有子列的父列,而不 ON DELETE CASCADE 或 SET NULL.
  • 以錯誤的順序載入資料表:子資料表排在父資料表之前。
  • 延遲條件約束(DEFERRABLE INITIALLY DEFERRED)失敗於 COMMIT.

如何修正

  1. 找出違反外鍵的資料列。

    PRAGMA foreign_key_check;
    PRAGMA foreign_key_list(orders);
  2. 在子項目之前插入父項目,或在父項目之前刪除子項目。

  3. 大量載入時,把檢查延後到交易結束再進行。

    BEGIN;
    PRAGMA defer_foreign_keys = ON;
    -- load tables in any order
    COMMIT;
  4. 如果刪除父項應該同時移除其子項,請在外鍵上宣告此操作。

    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 結果代碼與錯誤碼文件。瀏覽完整的 SQLite 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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