ORA-02291: 무결성 제약조건이 위배되었습니다 - 부모 키가 없습니다
ORA-02291: 무결성 제약조건(LAB_A.ORDERS_CUST_FK)이 위배되었습니다- 부모 키가 없습니다ORA-02291: integrity constraint (LAB_A.ORDERS_CUST_FK) violated - parent key not found넣으려는 외래 키 값이 부모 테이블에 없어요.
실제 DB 검증Oracle AI Database 26ai Free 23.26.3.0.0에서 재현·해결 확인 · 2026-11-14
ORA-02291은 외래 키(FK) 검사에 걸렸다는 뜻이에요. 자식 컬럼 값(예: orders.cust_id = 3)과 같은 행이 부모 테이블에 없어요.
메시지에 제약조건 이름(예: LAB_A.ORDERS_CUST_FK)이 나와요. user_constraints에서 이 이름으로 부모 테이블을 찾고, 그 값이 정말 있는지 확인하세요. 비교는 정확히 같아야 해서 'raw '와 'RAW'는 다른 값이에요.
원인별 해결 방법
1부모 행이 아직 없음
customers에는 1, 2번만 있어요. cust_id = 3으로 주문을 넣으니 ORDERS_CUST_FK로 실패했어요. user_constraints를 자기 자신과 조인해 보니 이 제약조건은 CUSTOMERS 테이블의 CUSTOMERS_PK를 가리키고, 고객 3번의 COUNT(*)는 0이었어요.
고객 3번을 넣고 커밋한 뒤 같은 주문 INSERT가 성공했어요(1 row created).
사전 준비
CREATE TABLE customers (cust_id NUMBER CONSTRAINT customers_pk PRIMARY KEY, name VARCHAR2(30));
CREATE TABLE orders (order_id NUMBER PRIMARY KEY, cust_id NUMBER CONSTRAINT orders_cust_fk REFERENCES customers, amount NUMBER);
INSERT INTO customers VALUES (1, 'Kim');
INSERT INTO customers VALUES (2, 'Lee');
COMMIT;Table created.
Table created.
1 row created.
1 row created.
Commit complete.INSERT INTO orders VALUES (1001, 3, 500);INSERT INTO orders VALUES (1001, 3, 500)
*
ERROR at line 1:
ORA-02291: integrity constraint (LAB_A.ORDERS_CUST_FK) violated - parent key not found
Help: https://docs.oracle.com/error-help/db/ora-02291/COLUMN constraint_name FORMAT A16
COLUMN table_name FORMAT A10
COLUMN r_constraint_name FORMAT A16
COLUMN parent_table FORMAT A12
SELECT c.constraint_name, c.table_name, c.r_constraint_name, p.table_name AS parent_table
FROM user_constraints c JOIN user_constraints p ON p.constraint_name = c.r_constraint_name
WHERE c.constraint_name = 'ORDERS_CUST_FK';
SELECT COUNT(*) AS cust_3 FROM customers WHERE cust_id = 3;CONSTRAINT_NAME TABLE_NAME R_CONSTRAINT_NAM PARENT_TABLE
---------------- ---------- ---------------- ------------
ORDERS_CUST_FK ORDERS CUSTOMERS_PK CUSTOMERS
1 row selected.
CUST_3
----------
0
1 row selected.INSERT INTO customers VALUES (3, 'Park');
COMMIT;1 row created.
Commit complete.한 프로그램 안에서는 부모를 먼저 넣고 자식을 넣으세요. 부모를 다른 프로세스가 만든다면 그쪽이 커밋했는지 먼저 확인하세요.
INSERT INTO orders VALUES (1001, 3, 500);
COMMIT;1 row created.
Commit complete.2데이터 이관 중 부모 없는 자식 행이 섞여 있음
INSERT INTO emp SELECT ... FROM emp_old로 사원 4명을 옮기는데, 그중 한 명이 dept에 없는 30번 부서를 가리켜요. 문장 전체가 실패해서 4명 모두 안 들어갔어요.
NOT EXISTS 조회로 부모 없는 행을 찾았어요: 103 Park 30. 30번 부서를 추가한 뒤 같은 INSERT ... SELECT가 4행을 넣었어요.
사전 준비
CREATE TABLE dept (dept_id NUMBER CONSTRAINT dept_pk PRIMARY KEY, dname VARCHAR2(20));
CREATE TABLE emp (emp_id NUMBER PRIMARY KEY, name VARCHAR2(20), dept_id NUMBER CONSTRAINT emp_dept_fk REFERENCES dept);
INSERT INTO dept VALUES (10, 'Sales');
INSERT INTO dept VALUES (20, 'IT');
CREATE TABLE emp_old (emp_id NUMBER, name VARCHAR2(20), dept_id NUMBER);
INSERT INTO emp_old VALUES (101, 'Kim', 10);
INSERT INTO emp_old VALUES (102, 'Lee', 20);
INSERT INTO emp_old VALUES (103, 'Park', 30);
INSERT INTO emp_old VALUES (104, 'Choi', 10);
COMMIT;Table created.
Table created.
1 row created.
1 row created.
Table created.
1 row created.
1 row created.
1 row created.
1 row created.
Commit complete.INSERT INTO emp SELECT emp_id, name, dept_id FROM emp_old;INSERT INTO emp SELECT emp_id, name, dept_id FROM emp_old
*
ERROR at line 1:
ORA-02291: integrity constraint (LAB_A.EMP_DEPT_FK) violated - parent key not found
Help: https://docs.oracle.com/error-help/db/ora-02291/SELECT o.emp_id, o.name, o.dept_id
FROM emp_old o
WHERE o.dept_id IS NOT NULL
AND NOT EXISTS (SELECT 1 FROM dept d WHERE d.dept_id = o.dept_id); EMP_ID NAME DEPT_ID
---------- ------------------------------ ----------
103 Park 30
1 row selected.INSERT INTO dept VALUES (30, 'Support');
COMMIT;1 row created.
Commit complete.대량 이관 전에 NOT EXISTS 점검을 먼저 돌리세요. 빠진 부모를 추가할지, 그 행을 빼고 옮길지는 데이터 판단이에요. 이 실습에서는 부모를 추가했어요.
INSERT INTO emp SELECT emp_id, name, dept_id FROM emp_old;
COMMIT;
SELECT COUNT(*) AS emp_cnt FROM emp;4 rows created.
Commit complete.
EMP_CNT
----------
4
1 row selected.3코드값의 대소문자·뒤 공백이 다름
item_type에는 [RAW], [FG]가 있어요. INSERT는 'raw '(소문자 + 뒤 공백)로 넣어서 어느 것과도 맞지 않았고, "raw" 유형이 있는데도 ITEM_TYPE_FK로 실패했어요.
입력값을 UPPER(TRIM('raw '))로 정리하면 [RAW]가 되고, INSERT가 성공했어요.
사전 준비
CREATE TABLE item_type (type_code VARCHAR2(10) CONSTRAINT item_type_pk PRIMARY KEY, type_name VARCHAR2(20));
CREATE TABLE item (item_id NUMBER PRIMARY KEY, type_code VARCHAR2(10) CONSTRAINT item_type_fk REFERENCES item_type, item_name VARCHAR2(20));
INSERT INTO item_type VALUES ('RAW', 'Raw material');
INSERT INTO item_type VALUES ('FG', 'Finished goods');
COMMIT;Table created.
Table created.
1 row created.
1 row created.
Commit complete.INSERT INTO item VALUES (1, 'raw ', 'Steel plate');INSERT INTO item VALUES (1, 'raw ', 'Steel plate')
*
ERROR at line 1:
ORA-02291: integrity constraint (LAB_A.ITEM_TYPE_FK) violated - parent key not found
Help: https://docs.oracle.com/error-help/db/ora-02291/SELECT '[' || type_code || ']' AS stored FROM item_type ORDER BY type_code;
SELECT '[' || UPPER(TRIM('raw ')) || ']' AS input_fixed FROM dual;STORED
------------
[FG]
[RAW]
2 rows selected.
INPUT
-----
[RAW]
1 row selected.엑셀 업로드나 화면 입력으로 코드가 들어올 때 자주 나요. 위처럼 [ ]로 감싸 보면 숨은 공백이 보여요.
INSERT INTO item VALUES (1, UPPER(TRIM('raw ')), 'Steel plate');
COMMIT;
SELECT item_id, type_code, item_name FROM item;1 row created.
Commit complete.
ITEM_ID TYPE_CODE ITEM_NAME
---------- ---------- --------------------
1 RAW Steel plate
1 row selected.자주 묻는 질문
외래 키 제약조건의 부모 테이블은 어떻게 찾아요?
메시지의 제약조건 이름으로 user_constraints를 조회하고, r_constraint_name을 다시 user_constraints와 조인하세요. 여기서는 ORDERS_CUST_FK가 CUSTOMERS의 CUSTOMERS_PK를 가리켰어요.
INSERT ... SELECT에서 어떤 행 때문에 ORA-02291이 나는지 찾으려면?
원본 행 중 NOT EXISTS (SELECT 1 FROM 부모 WHERE 부모.키 = 원본.키)인 행을 조회하세요. 그게 부모 없는 행이에요.
부모 테이블에 값이 있는데도 ORA-02291이 나요.
대소문자와 공백을 확인하세요. 'raw '는 'RAW'와 같지 않아요. UPPER(TRIM(...))처럼 입력값을 정리하세요.
ORA-02291이 나면 일부 행은 들어가나요?
아니요. 실패한 문장은 통째로 취소돼요. 이 실습에서도 INSERT ... SELECT가 한 행도 안 넣었고, 다시 실행할 때 4행이 모두 들어갔어요.
검증 방법
시나리오마다 새 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