// SQL Server 오류 참조

SQL Server 오류 2627: PRIMARY KEY 또는 UNIQUE KEY 위반

INSERT 또는 UPDATE가 PRIMARY KEY 또는 UNIQUE 제약 조건에서 값을 중복시키려 합니다. 메시지에는 제약 조건, 테이블, 중복된 키 값이 나타납니다.

오류 번호
2627
심각도
14
카테고리
제약 조건 및 키
오류 메시지
Violation of %ls constraint '%.*ls'. Cannot insert duplicate key in object '%.*ls'. The duplicate key value is %ls.

의미

기본 키와 고유 제약 조건은 두 행이 동일한 키를 공유하지 않도록 보장합니다. 쓰기로 인해 중복이 생성되면, SQL Server는 2627 오류와 3621 오류("문장이 종료되었습니다")를 반환하며 문장 실행을 중단합니다. 메시지에는 어떤 종류의 제약 조건(PRIMARY KEY 또는 UNIQUE KEY), 제약 조건 이름, 테이블, 그리고 SQL Server 2017 이후에는 중복값 자체가 표시됩니다.

오류 2601은 제약 조건이 아닌 고유 인덱스에서 발생하는 동일한 실패입니다.

일반적인 원인

  • 이미 존재하는 키를 가진 행을 삽입하는 경우, 예를 들어 로드를 다시 실행할 때.
  • IDENTITY 열에 명시적인 값을 넣거나 IDENTITY_INSERT 가 켜진 상태로 명시적인 값을 넣거나, 기존 값보다 낮게 IDENTITY 시드를 재설정한 경우.
  • 중복 키를 포함하는 소스에서 배치 삽입을 하는 경우.
  • 두 세션이 동시에 동일한 키를 삽입하는 경우: 체크 후 삽입 패턴(IF NOT EXISTS ... INSERT)은 잠금 힌트 없이 안전하지 않습니다.

해결 방법

  1. 메시지에 표시된 값으로 기존 행을 찾으세요.

    SELECT * FROM dbo.Customers WHERE Email = N'[email protected]';
  2. 로드 시 이미 존재하는 행은 건너뜁니다.

    INSERT INTO dbo.Customers (Email, Name)
    SELECT s.Email, s.Name
    FROM staging.Customers AS s
    WHERE NOT EXISTS (SELECT 1 FROM dbo.Customers AS c WHERE c.Email = s.Email);
  3. 삽입하기 전에 소스 안의 중복을 확인하세요.

    SELECT Email, COUNT(*) FROM staging.Customers GROUP BY Email HAVING COUNT(*) > 1;
  4. 동시성에 안전한 업서트라면 먼저 업데이트하고, 바뀐 행이 없으면 삽입하되, 범위 잠금을 유지하세요.

    BEGIN TRANSACTION;
    UPDATE dbo.Customers WITH (UPDLOCK, SERIALIZABLE) SET Name = @Name WHERE Email = @Email;
    IF @@ROWCOUNT = 0
        INSERT INTO dbo.Customers (Email, Name) VALUES (@Email, @Name);
    COMMIT;
  5. IDENTITY 열이 충돌하면 확인하고 다시 시드하세요.

    DBCC CHECKIDENT ('dbo.Customers', NORESEED);  -- shows current and max values
    DBCC CHECKIDENT ('dbo.Customers', RESEED);

안전하게 재현하세요

CREATE TABLE #k (id int PRIMARY KEY);
INSERT INTO #k VALUES (1);
INSERT INTO #k VALUES (1);  -- Msg 2627 ... The duplicate key value is (1).
DROP TABLE #k;

질문

오류 2627과 2601의 차이는 무엇인가요?

2627은 PRIMARY KEY 또는 UNIQUE 제약 조건에 의해 발생하고, 2601은 CREATE UNIQUE INDEX로 생성된 고유 인덱스에 의해 발생합니다. 원인과 해결 방법은 동일합니다.

SQL Server가 중복 키를 무시하게 만들 수 있나요?

WITH (IGNORE_DUP_KEY = ON)으로 만든 고유 인덱스는 INSERT에서 중복 행을 경고만 하고 버리며, 명령문 전체를 실패로 만들지 않습니다. 데이터가 조용히 사라지므로 의도해서 쓰세요.

관련 오류

그 밖의 제약 조건 및 키 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 Microsoft 데이터베이스 엔진 이벤트 및 오류 참조. 전체 목록은 SQL Server 오류 목록 또는 모든 데이터베이스 오류 검색.

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

SQLly에서 SQL Server 작업하기

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