ORA-00001: 고유 제약 조건 위반
INSERT 또는 UPDATE가 기본 키나 고유 제약 조건·인덱스에서 값을 중복시킵니다. 메시지가 제약 조건을 SCHEMA.NAME으로 알려 줍니다.
- 오류 코드
ORA-00001- 카테고리
- 제약 조건 및 키
의미
ORA-00001은 문이 기본 키, 고유 제약 조건, 고유 인덱스 중 하나에 같은 키를 가진 행을 또 만들려고 했다는 뜻입니다. 메시지에는 제약 조건의 이름이 표시됩니다. 예를 들어 ORA-00001: unique constraint (SALES.ORDERS_PK) violated; 해당 제약 조건을 조회하여 열을 확인할 수 있습니다.
최신 버전에서는 테이블과 열 이름도 표시됩니다: unique constraint (constraint_schema.constraint_name) violated on table table_schema.table_name columns (column_names).
일반적인 원인
- 이미 존재하는 키를 가진 행을 삽입하는 경우, 예를 들어 로드를 다시 실행할 때.
- 데이터보다 뒤처진 시퀀스가 있어서,
NEXTVAL테이블에 이미 있는 ID를 생성하는 것으로, 보통은 명시적 ID로 데이터를 가져온 뒤에 생깁니다. - 두 세션이 동시에 동일한 키를 삽입할 때; 두 번째 세션은 대기한 후 첫 번째 세션이 커밋하면 실패합니다.
- 한
UPDATE고유 열을 다른 행이 가진 값으로 설정하는 경우.
해결 방법
-
메시지에 이름이 나온 제약 조건의 열을 찾으세요.
SELECT table_name, column_name, position FROM all_cons_columns WHERE owner = 'SALES' AND constraint_name = 'ORDERS_PK' ORDER BY position;
-
다음을 사용해 하나의 문으로 삽입과 업데이트를 함께 처리하세요
MERGE.MERGE INTO customers c USING (SELECT '[email protected]' AS email, 'Ada' AS name FROM dual) s ON (c.email = s.email) WHEN MATCHED THEN UPDATE SET c.name = s.name WHEN NOT MATCHED THEN INSERT (email, name) VALUES (s.email, s.name);
-
시퀀스가 뒤처져 있다면 현재 최댓값을 넘도록 조정하세요(18c 이상).
SELECT MAX(id) FROM orders; ALTER SEQUENCE orders_seq RESTART START WITH 100001;
-
대량 삽입에서 중복을 건너뛰려면,
IGNORE_ROW_ON_DUPKEY_INDEX힌트나 DML 오류 로깅(LOG ERRORS INTO)을 사용하여 잘못된 행을 따로 저장할 수 있습니다.
안전하게 재현하세요
CREATE TABLE t (id NUMBER PRIMARY KEY); INSERT INTO t VALUES (1); INSERT INTO t VALUES (1); -- ORA-00001: unique constraint (...) violated DROP TABLE t PURGE;
관련 오류
ORA-02291무결성 제약 조건 위반 - 상위 키 없음ORA-01400열에 NULL을 삽입할 수 없음23505PostgreSQL: 중복 키로 인해 고유 제약 조건 위반2627SQL Server: PRIMARY KEY 또는 UNIQUE KEY 위반1062MySQL: 키에 대한 중복 항목SQLITE_CONSTRAINT_UNIQUESQLite: UNIQUE 제약 조건 실패
그 밖의 제약 조건 및 키 오류
코드와 메시지 텍스트의 출처는 다음과 같습니다 Oracle Database 오류 도움말. 전체 목록은 Oracle 오류 목록 또는 모든 데이터베이스 오류 검색.
SQLly에서 Oracle 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. Oracle은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.