SQLITE_CONSTRAINT_UNIQUE: UNIQUE 제약 조건 실패
INSERT 또는 UPDATE가 UNIQUE 열이나 고유 인덱스에서 값을 중복시키려 합니다. 메시지에는 테이블과 열 이름이 나타납니다.
- 결과 코드
SQLITE_CONSTRAINT_UNIQUE- 이름
2067- 카테고리
- 확장 결과 코드
의미
SQLite가 반환하는 값은 SQLITE_CONSTRAINT_UNIQUE (2067) 오류는 쓰기가 같은 값을 가진 두 행을 만들려 할 때 발생하며, 대상은 UNIQUE 제약 조건이나 고유 인덱스. 메시지에는 열들이 나열되며, 다음과 같은 형태입니다 table.column, 여러 열 키일 때는 쉼표로 구분합니다. 중복 기본 키는 다음과 함께 알려 줍니다 SQLITE_CONSTRAINT_PRIMARYKEY 로 보고되지만 같은 메시지 텍스트를 사용합니다.
NULL은 중복으로 간주되지 않습니다: 고유 열에는 아무리 많은 NULL도 포함될 수 있습니다.
일반적인 원인
- 이미 존재하는 행을 삽입하는 경우, 예를 들어 가져오기를 다시 실행할 때.
- 대소문자만 다른 두 값, 다음과 같이 선언된 열에서
COLLATE NOCASE. - 한
UPDATE다른 행이 이미 가진 값으로 열을 설정할 때.
해결 방법
-
기존 행을 찾으세요.
SELECT * FROM users WHERE email = '[email protected]';
-
upsert(SQLite 3.24 이상)로 대신 기존 행을 업데이트합니다.
INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = excluded.name; -
또는 의도적으로 중복을 건너뛸 수 있습니다.
INSERT OR IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');
안전하게 재현하세요
CREATE TABLE users (email TEXT UNIQUE);
INSERT INTO users VALUES ('a@x');
INSERT INTO users VALUES ('a@x'); -- Runtime error: UNIQUE constraint failed: users.email (19)
질문
INSERT OR REPLACE와 upsert의 차이는 무엇입니까?
INSERT OR REPLACE 충돌하는 행을 삭제하고 새 행을 삽입하므로, 제공하지 않은 열은 초기화되며 삭제 트리거와 외래 키 작업이 실행될 수 있습니다. 다음과 같은 Upsert는 ON CONFLICT DO UPDATE 기존 행을 그 자리에서 수정합니다.
관련 오류
SQLITE_CONSTRAINT_PRIMARYKEYPRIMARY KEY 제약 조건 실패SQLITE_CONSTRAINT제약 조건 실패23505PostgreSQL: 중복 키로 인해 고유 제약 조건 위반1062MySQL: 키에 대한 중복 항목2627SQL Server: PRIMARY KEY 또는 UNIQUE KEY 위반2601SQL Server: 중복 키 행을 삽입할 수 없습니다ORA-00001Oracle: 고유 제약 조건이 위반되었습니다
그 밖의 확장 결과 코드 오류
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는 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.