ORA-02291: 整合性制約に違反しました - 親キーがありません

ORA-02291: 整合性制約(LAB_A.ORDERS_CUST_FK)に違反しました - 親キーがありません
ORA-02291: integrity constraint (LAB_A.ORDERS_CUST_FK) violated - parent key not found

登録しようとした外部キーの値が親表に存在しません。

実機検証済みOracle AI Database 26ai Free 23.26.3.0.0 で再現・解決を確認 · 2026-11-14

ORA-02291は外部キーのチェックに失敗したという意味です。子の列の値(例: 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人を移しますが、1人が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.

Excelアップロードや画面入力でコードが入るときによく起きます。上のように[ ]で囲むと隠れた空白が見えます。

対処後の再実行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は1行も登録せず、再実行で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

関連エラー