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 している
  2. 順序(シーケンス)が既存データより遅れている
  3. ID を直接指定した行のせいで IDENTITY 列が遅れている
  4. 制約ではなく一意索引に違反している

1同じキー値を2回 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 の1文で変更できます。

事前準備
事前準備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 を直接指定した INSERT もできます。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

関連エラー