// SQLite 오류 참조

SQLITE_CONSTRAINT_UNIQUE: UNIQUE 제약 조건 실패

INSERT 또는 UPDATE가 UNIQUE 열이나 고유 인덱스에서 값을 중복시키려 합니다. 메시지에는 테이블과 열 이름이 나타납니다.

결과 코드
SQLITE_CONSTRAINT_UNIQUE
이름
2067
카테고리
확장 결과 코드
오류 메시지
UNIQUE constraint failed: users.email

의미

SQLite가 반환하는 값은 SQLITE_CONSTRAINT_UNIQUE (2067) 오류는 쓰기가 같은 값을 가진 두 행을 만들려 할 때 발생하며, 대상은 UNIQUE 제약 조건이나 고유 인덱스. 메시지에는 열들이 나열되며, 다음과 같은 형태입니다 table.column, 여러 열 키일 때는 쉼표로 구분합니다. 중복 기본 키는 다음과 함께 알려 줍니다 SQLITE_CONSTRAINT_PRIMARYKEY 로 보고되지만 같은 메시지 텍스트를 사용합니다.

NULL은 중복으로 간주되지 않습니다: 고유 열에는 아무리 많은 NULL도 포함될 수 있습니다.

일반적인 원인

  • 이미 존재하는 행을 삽입하는 경우, 예를 들어 가져오기를 다시 실행할 때.
  • 대소문자만 다른 두 값, 다음과 같이 선언된 열에서 COLLATE NOCASE.
  • 한 UPDATE 다른 행이 이미 가진 값으로 열을 설정할 때.

해결 방법

  1. 기존 행을 찾으세요.

    SELECT * FROM users WHERE email = '[email protected]';
  2. upsert(SQLite 3.24 이상)로 대신 기존 행을 업데이트합니다.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. 또는 의도적으로 중복을 건너뛸 수 있습니다.

    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 결과 및 오류 코드 문서. 전체 목록은 SQLite 오류 목록 또는 모든 데이터베이스 오류 검색.

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

SQLly에서 SQLite 작업하기

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