PostgreSQL 23505: 중복 키가 고유 제약 조건을 위반함
INSERT 또는 UPDATE가 기본 키, 고유 제약 조건 또는 고유 인덱스가 걸린 열에 같은 값의 두 번째 행을 만들려 합니다.
- SQLSTATE
23505- 이름
unique_violation- 카테고리
- 무결성 제약 조건 위반
의미
PostgreSQL은 모든 기본 키와 UNIQUE 제약 조건과 고유 인덱스는 행이 기록되는 순간에 검사합니다. 새로 쓰거나 변경한 행이 이미 존재하는 행(또는 다른 트랜잭션이 썼지만 아직 커밋하지 않은 행)과 같은 키를 가지면 그 문은 23505로 실패하고 변경한 내용은 하나도 남지 않습니다.
그 DETAIL 줄에는 어떤 열과 어떤 값이 중복됐는지 나오고, 메시지는 어느 제약 조건이나 인덱스가 깨졌는지 정확히 알려 줍니다.
일반적인 원인
- 키가 이미 존재하는 행을 삽입하는 경우. 예를 들어 가져오기나 시드 스크립트를 다시 실행할 때.
- A
serial또는 데이터에 뒤처진 identity 시퀀스에서도 일어납니다. 보통은 행을 명시적 id로 넣은 뒤에요. 다음 기본 id가 기존 행과 부딪히는, 바로 그 전형적인Key (id)=(1) already exists. - 같은 키를 동시에 삽입하는 두 세션; 두 번째 세션은 첫 번째 세션을 기다리고, 첫 번째 세션이 커밋되자마자 실패합니다.
- 한
UPDATE다른 행이 이미 가진 값을 고유 열에 넣는 경우입니다.
해결 방법
-
다음에 이름이 나오는 기존 행을 찾으세요
DETAIL줄을 비교해 보고 새 데이터가 중복인지 다른 레코드인지 판단하면 됩니다.SELECT * FROM users WHERE email = '[email protected]';
-
이 쓰기가 기존 행을 갱신하게 하려면 다음을 넣어 upsert로 만드세요
ON CONFLICT.INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name; -
중복 항목을 단순히 건너뛰어야 하는 경우, 다음을 사용하세요
ON CONFLICT DO NOTHING.INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO NOTHING; -
중복이 걸린 대상이
serial또는 identity id라면 시퀀스를 기존 최댓값 다음으로 밀어 주세요.SELECT setval(pg_get_serial_sequence('users', 'id'), (SELECT COALESCE(MAX(id), 0) + 1 FROM users), false);
안전하게 재현하세요
CREATE TEMP TABLE t (id int PRIMARY KEY); INSERT INTO t VALUES (1); INSERT INTO t VALUES (1); -- ERROR: duplicate key value violates unique constraint "t_pkey"
질문
id를 직접 설정한 적이 없는데 id 열에서 중복 키 오류로 INSERT가 실패하는 이유는 무엇인가요?
테이블의 시퀀스가 데이터보다 뒤처져 있는데, 보통은 행을 명시적인 ID로 삽입했거나 시퀀스 값을 반영하지 않고 복원했기 때문입니다. 재설정에는 다음을 씁니다 setval 다음 값 바로 뒤로 MAX(id).
ON CONFLICT가 모든 고유 인덱스에서 작동하나요?
고유 인덱스나 제약 조건의 열에서 작동하거나 ON CONFLICT ON CONSTRAINT name에서 작동합니다. PostgreSQL 9.5 이상이 필요합니다.
관련 오류
23503외래 키 제약 조건 위반23502null 값이 not-null 제약 조건을 위반합니다25P02현재 트랜잭션이 중단됨2627SQL Server: PRIMARY KEY 또는 UNIQUE KEY 위반2601SQL Server: 중복 키 행을 삽입할 수 없습니다1062MySQL: 키에 대한 중복 항목ORA-00001Oracle: 고유 제약 조건이 위반되었습니다SQLITE_CONSTRAINT_UNIQUESQLite: UNIQUE 제약 조건 실패
그 밖의 무결성 제약 조건 위반 오류
코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.
SQLly에서 PostgreSQL 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.