Huny's Dev Blog
huny.dev

SQLite 외래 키가 작동하지 않을 때 PRAGMA와 트랜잭션 확인하기

SQLite 외래 키 검사를 연결별로 켜고 트랜잭션 안의 PRAGMA 무효 동작을 재현한다. 기존 위반 데이터는 foreign_key_check로 찾는다.

Hun Jang
Hun Jang Nov 19, 2026

SQLite 테이블에 REFERENCES를 선언했는데 부모 없는 행이 들어간다면, 현재 연결의 PRAGMA foreign_keys 값을 확인한다. 연결을 초기화할 때 트랜잭션 밖에서 PRAGMA foreign_keys = ON을 실행하고 값이 1인지 검증한다. 이미 들어간 위반 행은 PRAGMA foreign_key_check로 확인한다. Python 예제로 설정 시점에 따라 달라지는 결과를 재현한다.

청록색 데이터 카드 두 묶음이 주황색 사슬과 연결 장치로 이어진 일러스트

테이블 선언과 연결 설정을 함께 확인하기

외래 키 검사는 연결마다 활성화해야 한다. SQLite의 기본값은 컴파일 설정에 따라 달라질 수 있으므로, 기본값에 의존하지 않고 설정한 뒤 읽어 확인한다. 트랜잭션이나 SAVEPOINT가 진행 중일 때 foreign_keys 설정을 바꿔도 효과가 없다. 오류 없이 실행됐다는 사실만으로 활성화됐다고 판단하면 안 된다. SQLite 외래 키 문서 · PRAGMA foreign_keys

커넥션 풀을 쓰면 풀에서 새 물리 연결을 만들 때 같은 초기화를 적용한다. 한 연결에서 설정한 값이 다른 연결까지 바꾸지는 않는다. ORM이나 드라이버가 조회 전에 트랜잭션을 시작하는지도 함께 확인한다. SQLite 외래 키 문서

트랜잭션 안에서 켜면 생기는 일 재현하기

아래 코드를 sqlite_foreign_keys.py로 저장하고 python3 sqlite_foreign_keys.py를 실행한다. Python 3.12의 autocommit=True로 연결하고, 실험용 트랜잭션은 SQL로 명시한다. 재현 조건을 고정하기 위해 먼저 검사를 끈다. 일반 애플리케이션에서는 연결 초기화 시 검사를 켠다. Python sqlite3 트랜잭션 문서

새 쓰기 차단과 기존 데이터 검사

2026년 11월 19일 Python 3.12.14와 SQLite 3.53.1의 메모리 데이터베이스에서 실행했다. 트랜잭션 안의 활성화 요청 뒤에도 설정값이 0인 것을 확인했고, 부모 없는 행이 삽입됐다. 커밋 후 검사를 켜자 새 위반 행은 SQLITE_CONSTRAINT_FOREIGNKEY로 거부됐다.

검사를 켜는 것만으로 기존 위반 행을 정리하지는 않는다. foreign_key_check는 위반이 있는 테이블, 행 식별 정보, 참조 대상과 제약 식별자를 반환한다. 예제에서는 실제로 누락된 부모를 삽입해 위반이 사라지는지 확인했다. 운영 데이터에서는 부모 복원·자식 수정·삭제 중 어떤 처리가 업무 의미에 맞는지 결정한다. PRAGMA foreign_key_check

적용 범위와 초기화 순서

데이터베이스 연결을 열고, 트랜잭션을 시작하기 전에 외래 키 검사를 활성화하고, 설정값을 다시 읽은 다음 업무 트랜잭션을 시작한다. Python에서 autocommit=False를 사용하면 드라이버가 트랜잭션을 유지하므로 초기화 시점을 따로 설계한다. 예제는 autocommit=True에서 SQL로 BEGIN과 COMMIT을 실행하는 흐름을 검증했다. Python sqlite3 트랜잭션 문서 · PRAGMA foreign_keys

이 글은 일반적인 즉시 검사 외래 키를 다룬다. 지연 제약을 사용하면 위반이 보고되는 시점이 커밋까지 미뤄질 수 있다. 복합 키나 참조 대상 인덱스 구성 오류가 있는 스키마는 해당 정의도 확인한다. 실험은 단일 연결의 로컬 메모리 데이터베이스에서 수행했으며 커넥션 풀 통합은 검증하지 않았다. SQLite 외래 키 문서

English version · Fix SQLite Foreign Keys That Appear Not to WorkFix SQLite Foreign Keys That Appear Not to Work

추천 글