SQLITE_CONSTRAINT: 제약 조건 실패
INSERT나 UPDATE가 제약 조건을 위반했습니다: UNIQUE, PRIMARY KEY, NOT NULL, CHECK 또는 FOREIGN KEY. 메시지와 확장 코드가 어느 것인지 알려 줍니다.
- 결과 코드
SQLITE_CONSTRAINT- 이름
19- 카테고리
- 주요 결과 코드
의미
SQLITE_CONSTRAINT (19)는 어떤 문이 테이블의 규칙 하나를 어기려 해서 SQLite가 막았다는 뜻입니다. 일반적인 메시지는 constraint failed, 하지만 메시지에는 보통 규칙과 열이 이름으로 나옵니다. 예를 들면 UNIQUE constraint failed: users.email, 그리고 확장 코드가 종류를 알려 줍니다: SQLITE_CONSTRAINT_UNIQUE, _PRIMARYKEY, _NOTNULL, _CHECK, _FOREIGNKEY, _DATATYPE (STRICT 테이블) 또는 _TRIGGER (트리거 안의 RAISE() 트리거 안에서).
기본적으로 실패한 문장은 취소됩니다(충돌 모드 ABORT) 하지만 같은 트랜잭션 내의 이전 문장은 유지됩니다.
일반적인 원인
- 기본 키나 고유 열에서 중복 값이 나타날 때.
- NULL이 들어가는 곳은 다음 제약이 붙은
NOT NULL열, 흔히 INSERT에서 해당 열을 생략했고 기본값이 없기 때문입니다. - 다음을 통과하지 못하는 값
CHECK표현식. - 부모가 존재하지 않는 자식 행이며, 다음 설정이 켜져 있을 때
PRAGMA foreign_keys = ON. - 다음에 들어간 잘못된 타입의 값
STRICT테이블입니다.
해결 방법
-
어떤 제약 조건이 실패했는지는 메시지나 확장 오류 코드에 나옵니다. 테이블 정의를 확인하세요.
SELECT sql FROM sqlite_schema WHERE name = 'users';
-
병합하거나 건너뛰고 싶은 중복이라면 업서트나 충돌 처리 절을 사용하세요.
INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = excluded.name; -
나머지 제약 조건의 경우에는 작성 중인 데이터를 수정하세요: 누락된 값을 제공하거나, 부모 행을 먼저 삽입하거나, 체크에 실패한 값을 수정하세요.
관련 오류
SQLITE_CONSTRAINT_UNIQUEUNIQUE 제약 조건 실패SQLITE_CONSTRAINT_PRIMARYKEYPRIMARY KEY 제약 조건 실패SQLITE_CONSTRAINT_NOTNULLNOT NULL 제약 조건 실패SQLITE_CONSTRAINT_CHECKCHECK 제약 조건 실패SQLITE_CONSTRAINT_FOREIGNKEY외래 키 제약 조건 실패SQLITE_CONSTRAINT_DATATYPE값이 STRICT 열에 맞지 않음
그 밖의 기본 결과 코드 오류
SQLITE_ERRORSQL 논리 오류SQLITE_PERM접근 권한 거부SQLITE_ABORT쿼리 중단됨SQLITE_BUSY데이터베이스가 잠김SQLITE_LOCKED데이터베이스 테이블이 잠김SQLITE_NOMEM메모리 부족SQLITE_READONLY읽기 전용 데이터베이스에 쓰기 시도SQLITE_INTERRUPT중단됨
코드와 메시지 텍스트의 출처는 다음과 같습니다 SQLite 결과 및 오류 코드 문서. 전체 목록은 SQLite 오류 목록 또는 모든 데이터베이스 오류 검색.
SQLly에서 SQLite 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. SQLite는 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.