SQLITE_CONSTRAINT_FOREIGNKEY: FOREIGN KEY 제약 조건 실패
그대로 두면 존재하지 않는 부모를 가리키는 자식 행이 남거나 아직 자식이 있는 부모가 삭제됩니다. 외래 키는 연결별로 켜야 합니다.
- 결과 코드
SQLITE_CONSTRAINT_FOREIGNKEY- 이름
787- 카테고리
- 확장 결과 코드
의미
SQLITE_CONSTRAINT_FOREIGNKEY (787)은 외래 키 검사가 실패했다는 뜻입니다. SQLite는 다음을 실행한 연결에서만 외래 키를 적용합니다 PRAGMA foreign_keys = ON; 기본값은 하위 호환성 때문에 꺼져 있어서, 같은 INSERT가 어떤 도구에서는 되고 어떤 도구에서는 안 될 수 있습니다.
메시지는 어떤 키가 실패했는지 말하지 않습니다. 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다른 프로세스가 WAL을 복구 중입니다SQLITE_LOCKED_SHAREDCACHE공유 캐시에서 레코드가 잠겨 있습니다SQLITE_CONSTRAINT_CHECKCHECK 제약 조건 실패SQLITE_ABORT_ROLLBACKROLLBACK으로 인해 명령문이 중단되었습니다SQLITE_BUSY_SNAPSHOT오래된 읽기는 쓰기로 변환될 수 없습니다SQLITE_IOERR_SHORT_READ읽기가 더 적은 바이트를 반환했습니다SQLITE_CANTOPEN_ISDIR경로가 디렉토리입니다
코드와 메시지 텍스트의 출처는 다음과 같습니다 SQLite 결과 및 오류 코드 문서. 전체 목록은 SQLite 오류 목록 또는 모든 데이터베이스 오류 검색.
SQLly에서 SQLite 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. SQLite는 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.