// SQLite エラーリファレンス

SQLITE_CONSTRAINT_FOREIGNKEY: FOREIGN KEY 制約に違反しました

この書き込みは、存在しない親を指す子行を残してしまうか、子行が残っている親を削除してしまいます。外部キーは接続ごとに有効にする必要があります。

結果コード
SQLITE_CONSTRAINT_FOREIGNKEY
名前
787
カテゴリ
拡張結果コード
エラーメッセージ
FOREIGN KEY constraint failed

意味

SQLITE_CONSTRAINT_FOREIGNKEY (787) は、外部キーチェックが失敗したことを意味します。SQLite は、次を実行する接続でのみ外部キーを強制します PRAGMA foreign_keys = ON; 後方互換性のため既定ではオフになっており、そのため同じ INSERT が、あるツールでは成功し別のツールでは失敗することがあります。

メッセージには、どのキーで失敗したかは示されません。 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 をはじめ、お使いの他のデータベースにも対応します。