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)保存しようとした行のキー値が、既存の行と同じです。
実機検証済みOracle AI Database 26ai Free 23.26.3.0.0 で再現・解決を確認 · 2026-11-11
ORA-00001 は、INSERT や UPDATE によって主キー、一意制約、一意索引に同じ値が2回入ることになる場合に発生します。従来のメッセージ「一意制約に反しています」で知られています。
最近のバージョン(23ai / 26ai)ではメッセージが詳しくなり、制約、表、列に加えて、次の行の ORA-03301 に既に存在する値が (PRODUCT_ID:100) のように表示されます。その値が 1 のような小さい数なら、順序や IDENTITY 列がデータより遅れていることを疑ってください。
原因と対処法
1同じキー値を2回 INSERT している
商品100は既に存在するのに、価格だけ変えて再度 INSERT しています。ORA-03301 に重複値 PRODUCT_ID:100 が表示されています。
まず既存の行を確認します。「なければ挿入、あれば更新」が目的なら MERGE を使います。ここでは既存の行が更新されました(1 row merged)。
事前準備
CREATE TABLE products (product_id NUMBER CONSTRAINT products_pk PRIMARY KEY, name VARCHAR2(50), price NUMBER);
INSERT INTO products VALUES (100, 'Keyboard', 30);
COMMIT;Table created.
1 row created.
Commit complete.INSERT INTO products VALUES (100, 'Keyboard', 35);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/SELECT * FROM products WHERE product_id = 100;PRODUCT_ID NAME PRICE
---------- ------------------------------ ----------
100 Keyboard 30
1 row selected.本当に別の商品なら、まだ使われていないキー値を指定します。
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;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 の1文で変更できます。
事前準備
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;Table created.
5 rows created.
Commit complete.
Sequence created.INSERT INTO orders VALUES (orders_seq.NEXTVAL, 700);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/SELECT MAX(order_id) AS max_id FROM orders; MAX_ID
----------
5
1 row selected.ALTER SEQUENCE orders_seq RESTART START WITH 6;Sequence altered.実データの MAX + 1 を使います。ここでは最大値が5なので、6から再開しています。
INSERT INTO orders VALUES (orders_seq.NEXTVAL, 700);1 row created.3ID を直接指定した行のせいで IDENTITY 列が遅れている
GENERATED BY DEFAULT AS IDENTITY では ID を直接指定した INSERT もできます。1〜4をそのように挿入したため自動採番はまだ1から始まり、次の自動 INSERT が TICKET_ID:1 と衝突します。
START WITH LIMIT VALUE を指定すると、IDENTITY が列の現在の最大値の次に移動します。
事前準備
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;Table created.
1 row created.
1 row created.
1 row created.
1 row created.
Commit complete.INSERT INTO tickets (title) VALUES ('new ticket');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/ALTER TABLE tickets MODIFY ticket_id GENERATED BY DEFAULT AS IDENTITY (START WITH LIMIT VALUE);Table altered.INSERT INTO tickets (title) VALUES ('new ticket');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 と重複します。同じ式で検索して既存の行を見つけ、新規挿入の代わりにそれを使います。
事前準備
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;Table created.
Index created.
1 row created.
Commit complete.INSERT INTO users VALUES (2, 'Kim@Example.com');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/SELECT constraint_name FROM user_constraints WHERE constraint_name = 'USERS_EMAIL_UX';no rows selectedSELECT 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';INDEX_NAME UNIQUENES COLUMN_EXPRESSION
------------------------------ --------- --------------------------------------------------------------------------------
USERS_EMAIL_UX UNIQUE LOWER("EMAIL")
1 row selected.式ではない通常の一意索引なら、USER_IND_COLUMNS で列を確認できます。
SELECT user_id, email FROM users WHERE LOWER(email) = LOWER('Kim@Example.com'); 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