// 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 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. SQLite는 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.