// SQLite 오류 참조

SQLITE_CONSTRAINT: 제약 조건 실패

INSERT나 UPDATE가 제약 조건을 위반했습니다: UNIQUE, PRIMARY KEY, NOT NULL, CHECK 또는 FOREIGN KEY. 메시지와 확장 코드가 어느 것인지 알려 줍니다.

결과 코드
SQLITE_CONSTRAINT
이름
19
카테고리
주요 결과 코드
오류 메시지
constraint failed

의미

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 테이블입니다.

해결 방법

  1. 어떤 제약 조건이 실패했는지는 메시지나 확장 오류 코드에 나옵니다. 테이블 정의를 확인하세요.

    SELECT sql FROM sqlite_schema WHERE name = 'users';
  2. 병합하거나 건너뛰고 싶은 중복이라면 업서트나 충돌 처리 절을 사용하세요.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. 나머지 제약 조건의 경우에는 작성 중인 데이터를 수정하세요: 누락된 값을 제공하거나, 부모 행을 먼저 삽입하거나, 체크에 실패한 값을 수정하세요.

관련 오류

그 밖의 기본 결과 코드 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 SQLite 결과 및 오류 코드 문서. 전체 목록은 SQLite 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 SQLite 작업하기

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