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. 부모 행이 아직 없음
  2. 데이터 이관 중 부모 없는 자식 행이 섞여 있음
  3. 코드값의 대소문자·뒤 공백이 다름

1부모 행이 아직 없음

customers에는 1, 2번만 있어요. cust_id = 3으로 주문을 넣으니 ORDERS_CUST_FK로 실패했어요. user_constraints를 자기 자신과 조인해 보니 이 제약조건은 CUSTOMERS 테이블의 CUSTOMERS_PK를 가리키고, 고객 3번의 COUNT(*)는 0이었어요.

고객 3번을 넣고 커밋한 뒤 같은 주문 INSERT가 성공했어요(1 row created).

사전 준비
사전 준비lab_a 계정으로 실행
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;
OUTPUT
Table created.


Table created.


1 row created.


1 row created.


Commit complete.
재현lab_a 계정으로 실행
INSERT INTO orders VALUES (1001, 3, 500);
OUTPUT
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/
확인lab_a 계정으로 실행
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;
OUTPUT
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.
해결lab_a 계정으로 실행
INSERT INTO customers VALUES (3, 'Park');
COMMIT;
OUTPUT
1 row created.


Commit complete.

한 프로그램 안에서는 부모를 먼저 넣고 자식을 넣으세요. 부모를 다른 프로세스가 만든다면 그쪽이 커밋했는지 먼저 확인하세요.

해결 후 재실행lab_a 계정으로 실행
INSERT INTO orders VALUES (1001, 3, 500);
COMMIT;
OUTPUT
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행을 넣었어요.

사전 준비
사전 준비lab_a 계정으로 실행
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;
OUTPUT
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.
재현lab_a 계정으로 실행
INSERT INTO emp SELECT emp_id, name, dept_id FROM emp_old;
OUTPUT
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/
확인lab_a 계정으로 실행
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);
OUTPUT
    EMP_ID NAME                              DEPT_ID
---------- ------------------------------ ----------
       103 Park                                   30

1 row selected.
해결lab_a 계정으로 실행
INSERT INTO dept VALUES (30, 'Support');
COMMIT;
OUTPUT
1 row created.


Commit complete.

대량 이관 전에 NOT EXISTS 점검을 먼저 돌리세요. 빠진 부모를 추가할지, 그 행을 빼고 옮길지는 데이터 판단이에요. 이 실습에서는 부모를 추가했어요.

해결 후 재실행lab_a 계정으로 실행
INSERT INTO emp SELECT emp_id, name, dept_id FROM emp_old;
COMMIT;
SELECT COUNT(*) AS emp_cnt FROM emp;
OUTPUT
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가 성공했어요.

사전 준비
사전 준비lab_a 계정으로 실행
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;
OUTPUT
Table created.


Table created.


1 row created.


1 row created.


Commit complete.
재현lab_a 계정으로 실행
INSERT INTO item VALUES (1, 'raw ', 'Steel plate');
OUTPUT
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/
확인lab_a 계정으로 실행
SELECT '[' || type_code || ']' AS stored FROM item_type ORDER BY type_code;
SELECT '[' || UPPER(TRIM('raw ')) || ']' AS input_fixed FROM dual;
OUTPUT
STORED
------------
[FG]
[RAW]

2 rows selected.


INPUT
-----
[RAW]

1 row selected.

엑셀 업로드나 화면 입력으로 코드가 들어올 때 자주 나요. 위처럼 [ ]로 감싸 보면 숨은 공백이 보여요.

해결 후 재실행lab_a 계정으로 실행
INSERT INTO item VALUES (1, UPPER(TRIM('raw ')), 'Steel plate');
COMMIT;
SELECT item_id, type_code, item_name FROM item;
OUTPUT
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

관련 에러