ORA-00001: 무결성 제약 조건에 위배됩니다 (고유 제약 조건 위반)

ORA-00001: 고유한 제약 조건(LAB_A.PRODUCTS_PK)이 테이블 LAB_A.PRODUCTS 열(PRODUCT_ID)에서 위반되었습니다.
ORA-00001: unique constraint (LAB_A.PRODUCTS_PK) violated on table LAB_A.PRODUCTS columns (PRODUCT_ID)

저장하려는 행의 키 값이 이미 있는 행과 같아요.

실제 DB 검증Oracle AI Database 26ai Free 23.26.3.0.0에서 재현·해결 확인 · 2026-11-11

ORA-00001은 INSERT나 UPDATE 결과로 기본 키, 유니크 제약 조건, 유니크 인덱스에 같은 값이 두 번 들어가게 될 때 나요. 예전 버전 한국어 메시지 "무결성 제약 조건에 위배됩니다"로 많이 알려져 있어요.

최신 버전(23ai / 26ai)은 메시지가 훨씬 자세해요. 제약 조건, 테이블, 컬럼에 더해 다음 줄 ORA-03301에 이미 있는 값이 (PRODUCT_ID:100)처럼 나와요. 그 값이 1처럼 작은 숫자면 시퀀스나 IDENTITY 컬럼이 데이터보다 뒤처진 걸 의심하세요.

원인별 해결 방법

  1. 같은 키 값을 두 번 INSERT함
  2. 시퀀스가 기존 데이터보다 뒤처짐
  3. ID를 직접 넣은 행 때문에 IDENTITY 컬럼이 뒤처짐
  4. 제약 조건이 아닌 유니크 인덱스에 걸림

1같은 키 값을 두 번 INSERT함

100번 상품이 이미 있는데 가격만 바꿔서 다시 INSERT했어요. ORA-03301에 중복 값 PRODUCT_ID:100이 나와요.

먼저 기존 행을 확인하세요. "없으면 넣고 있으면 수정"이 의도였다면 MERGE를 쓰면 돼요. 여기서는 기존 행이 수정됐어요(1 row merged).

사전 준비
사전 준비lab_a 계정으로 실행
CREATE TABLE products (product_id NUMBER CONSTRAINT products_pk PRIMARY KEY, name VARCHAR2(50), price NUMBER);
INSERT INTO products VALUES (100, 'Keyboard', 30);
COMMIT;
OUTPUT
Table created.


1 row created.


Commit complete.
재현lab_a 계정으로 실행
INSERT INTO products VALUES (100, 'Keyboard', 35);
OUTPUT
INSERT INTO products VALUES (100, 'Keyboard', 35)
*
ERROR at line 1:
ORA-00001: unique constraint (LAB_A.PRODUCTS_PK) violated on table LAB_A.PRODUCTS columns (PRODUCT_ID)
ORA-03301: (ORA-00001 details) row with column values (PRODUCT_ID:100) already exists
Help: https://docs.oracle.com/error-help/db/ora-00001/
확인lab_a 계정으로 실행
SELECT * FROM products WHERE product_id = 100;
OUTPUT
PRODUCT_ID NAME                                PRICE
---------- ------------------------------ ----------
       100 Keyboard                               30

1 row selected.

정말 다른 상품이면 아직 안 쓴 키 값을 줘야 해요.

해결 후 재실행lab_a 계정으로 실행
MERGE INTO products p
USING (SELECT 100 AS product_id, 'Keyboard' AS name, 35 AS price FROM dual) s
   ON (p.product_id = s.product_id)
 WHEN MATCHED THEN UPDATE SET p.name = s.name, p.price = s.price
 WHEN NOT MATCHED THEN INSERT (product_id, name, price) VALUES (s.product_id, s.name, s.price);
COMMIT;
OUTPUT
1 row merged.


Commit complete.

2시퀀스가 기존 데이터보다 뒤처짐

데이터 이관이나 다른 시스템에서 복사하면서 1~5번 행을 ID를 직접 넣어 만들었는데, 시퀀스는 아직 1부터 시작해요. 첫 NEXTVAL이 1을 주고, 1은 이미 있어서 ORDER_ID:1 중복이 나요.

MAX(order_id)를 확인하고 시퀀스를 최댓값 다음으로 옮기세요. 이 DB에서는 ALTER SEQUENCE ... RESTART START WITH 한 문장으로 돼요.

사전 준비
사전 준비lab_a 계정으로 실행
CREATE TABLE orders (order_id NUMBER CONSTRAINT orders_pk PRIMARY KEY, amount NUMBER);
INSERT INTO orders SELECT LEVEL, LEVEL * 100 FROM dual CONNECT BY LEVEL <= 5;
COMMIT;
CREATE SEQUENCE orders_seq;
OUTPUT
Table created.


5 rows created.


Commit complete.


Sequence created.
재현lab_a 계정으로 실행
INSERT INTO orders VALUES (orders_seq.NEXTVAL, 700);
OUTPUT
INSERT INTO orders VALUES (orders_seq.NEXTVAL, 700)
*
ERROR at line 1:
ORA-00001: unique constraint (LAB_A.ORDERS_PK) violated on table LAB_A.ORDERS columns (ORDER_ID)
ORA-03301: (ORA-00001 details) row with column values (ORDER_ID:1) already exists
Help: https://docs.oracle.com/error-help/db/ora-00001/
확인lab_a 계정으로 실행
SELECT MAX(order_id) AS max_id FROM orders;
OUTPUT
    MAX_ID
----------
         5

1 row selected.
해결lab_a 계정으로 실행
ALTER SEQUENCE orders_seq RESTART START WITH 6;
OUTPUT
Sequence altered.

실제 데이터의 MAX + 1 값을 쓰세요. 여기서는 최댓값이 5라서 6부터 다시 시작했어요.

해결 후 재실행lab_a 계정으로 실행
INSERT INTO orders VALUES (orders_seq.NEXTVAL, 700);
OUTPUT
1 row created.

3ID를 직접 넣은 행 때문에 IDENTITY 컬럼이 뒤처짐

GENERATED BY DEFAULT AS IDENTITY는 ID를 직접 넣는 것도 허용해요. 1~4번을 그렇게 넣었기 때문에 자동 번호는 아직 1부터 시작하고, 다음 자동 INSERT가 TICKET_ID:1과 부딪혀요.

START WITH LIMIT VALUE를 주면 IDENTITY가 컬럼의 현재 최댓값 다음으로 옮겨져요.

사전 준비
사전 준비lab_a 계정으로 실행
CREATE TABLE tickets (ticket_id NUMBER GENERATED BY DEFAULT AS IDENTITY CONSTRAINT tickets_pk PRIMARY KEY, title VARCHAR2(50));
INSERT INTO tickets (ticket_id, title) VALUES (1, 'migrated 1');
INSERT INTO tickets (ticket_id, title) VALUES (2, 'migrated 2');
INSERT INTO tickets (ticket_id, title) VALUES (3, 'migrated 3');
INSERT INTO tickets (ticket_id, title) VALUES (4, 'migrated 4');
COMMIT;
OUTPUT
Table created.


1 row created.


1 row created.


1 row created.


1 row created.


Commit complete.
재현lab_a 계정으로 실행
INSERT INTO tickets (title) VALUES ('new ticket');
OUTPUT
INSERT INTO tickets (title) VALUES ('new ticket')
*
ERROR at line 1:
ORA-00001: unique constraint (LAB_A.TICKETS_PK) violated on table LAB_A.TICKETS columns (TICKET_ID)
ORA-03301: (ORA-00001 details) row with column values (TICKET_ID:1) already exists
Help: https://docs.oracle.com/error-help/db/ora-00001/
해결lab_a 계정으로 실행
ALTER TABLE tickets MODIFY ticket_id GENERATED BY DEFAULT AS IDENTITY (START WITH LIMIT VALUE);
OUTPUT
Table altered.
해결 후 재실행lab_a 계정으로 실행
INSERT INTO tickets (title) VALUES ('new ticket');
OUTPUT
1 row created.

4제약 조건이 아닌 유니크 인덱스에 걸림

메시지에 나온 USERS_EMAIL_UX를 USER_CONSTRAINTS에서 찾으면 없어요(no rows selected). 제약 조건이 아니라 유니크 인덱스라서 그래요. 컬럼이 SYS_NC00003$로 나오는 건 계산식에 만든 인덱스이기 때문이에요.

USER_IND_EXPRESSIONS를 보면 식이 LOWER("EMAIL")이에요. 이메일을 대소문자 구분 없이 비교하니까 Kim@Example.com이 기존 kim@example.com과 중복이에요. 같은 식으로 검색해서 기존 행을 찾아 새로 넣는 대신 그걸 쓰세요.

사전 준비
사전 준비lab_a 계정으로 실행
CREATE TABLE users (user_id NUMBER PRIMARY KEY, email VARCHAR2(100));
CREATE UNIQUE INDEX users_email_ux ON users (LOWER(email));
INSERT INTO users VALUES (1, 'kim@example.com');
COMMIT;
OUTPUT
Table created.


Index created.


1 row created.


Commit complete.
재현lab_a 계정으로 실행
INSERT INTO users VALUES (2, 'Kim@Example.com');
OUTPUT
INSERT INTO users VALUES (2, 'Kim@Example.com')
*
ERROR at line 1:
ORA-00001: unique constraint (LAB_A.USERS_EMAIL_UX) violated on table LAB_A.USERS columns (SYS_NC00003$)
ORA-03301: (ORA-00001 details) row with column values (SYS_NC00003$:'kim@example.com') already exists
Help: https://docs.oracle.com/error-help/db/ora-00001/
확인lab_a 계정으로 실행
SELECT constraint_name FROM user_constraints WHERE constraint_name = 'USERS_EMAIL_UX';
OUTPUT
no rows selected
확인lab_a 계정으로 실행
SELECT i.index_name, i.uniqueness, e.column_expression
  FROM user_indexes i JOIN user_ind_expressions e ON e.index_name = i.index_name
 WHERE i.index_name = 'USERS_EMAIL_UX';
OUTPUT
INDEX_NAME                     UNIQUENES COLUMN_EXPRESSION
------------------------------ --------- --------------------------------------------------------------------------------
USERS_EMAIL_UX                 UNIQUE    LOWER("EMAIL")

1 row selected.

계산식이 아닌 일반 유니크 인덱스는 USER_IND_COLUMNS에서 컬럼을 볼 수 있어요.

해결 후 재실행lab_a 계정으로 실행
SELECT user_id, email FROM users WHERE LOWER(email) = LOWER('Kim@Example.com');
OUTPUT
   USER_ID EMAIL
---------- ----------------------------------------------------------------------------------------------------
         1 kim@example.com

1 row selected.

자주 묻는 질문

ORA-00001이 어느 컬럼, 어떤 값 때문에 났는지 어떻게 알아요?

23ai / 26ai에서는 메시지 전체를 보세요. 테이블과 컬럼이 나오고 ORA-03301에 중복 값이 나와요. 예전 버전은 제약 조건 이름만 나오니까 USER_CONS_COLUMNS(인덱스라면 USER_IND_COLUMNS)에서 찾아보세요.

시퀀스로 INSERT하는데 ORA-00001이 나요.

시퀀스 값이 테이블에 이미 있는 ID보다 작아서예요. 보통 ID를 직접 넣어 데이터를 옮긴 뒤에 생겨요. MAX(id)를 확인하고 시퀀스를 그 다음으로 옮기세요(ALTER SEQUENCE ... RESTART START WITH 최댓값+1). IDENTITY 컬럼은 START WITH LIMIT VALUE를 쓰세요.

에러에 나온 제약 조건 이름이 USER_CONSTRAINTS에 없어요.

CREATE UNIQUE INDEX로 만든 유니크 인덱스일 가능성이 커요. USER_INDEXES에서 찾고, 함수 기반 인덱스면 USER_IND_EXPRESSIONS에서 식을 확인하세요.

있으면 UPDATE, 없으면 INSERT 하려면 어떻게 해요?

MERGE INTO ... WHEN MATCHED THEN UPDATE ... WHEN NOT MATCHED THEN INSERT를 쓰세요. 기존 행이 있으면 ORA-00001 대신 수정돼요.

검증 방법

시나리오마다 새 DB 사용자를 만들어 시작해요. 스크립트가 사전 준비 → 에러 재현(에러 코드 일치 확인) → 해결 → 원래 문장 재실행 순서로 실행하고, 화면의 출력은 DB가 실제로 낸 결과를 스크립트가 그대로 저장한 거예요.

lab_a, lab_b는 테스트용 일반 사용자, system은 DBA 계정이에요. Oracle AI Database 26ai Free Release 23.26.3.0.0 - Develop, Learn, and Run for Free

관련 에러