// Oracle 錯誤參考

ORA-00001:違反唯一條件約束

INSERT 或 UPDATE 會在主鍵、唯一約束或唯一索引中產生重複值。訊息會以 SCHEMA.NAME 的形式指出約束名稱。

錯誤碼
ORA-00001
類別
條件約束與索引鍵
錯誤訊息
unique constraint (string.string) violated

它的意義

ORA-00001 表示這個陳述式想在主鍵、唯一條件約束或唯一索引中,建立第二筆相同索引鍵值的資料列。錯誤訊息會指出條件約束名稱,例如 ORA-00001: unique constraint (SALES.ORDERS_PK) violated;查一下它,就能看到它的欄位。

較新的版本也會指出資料表和欄位: unique constraint (constraint_schema.constraint_name) violated on table table_schema.table_name columns (column_names).

常見原因

  • 插入已存在鍵的列,例如重新執行載入。
  • 序列落後於資料,因此 NEXTVAL 會產生已存在於資料表中的 id,通常發生在使用明確 id 匯入資料後。
  • 兩個工作階段同時插入同一個鍵;第二個會等待,若第一個提交了,第二個就會失敗。
  • 一個 UPDATE 把唯一欄位設成另一列已有的值。

如何修正

  1. 找出訊息中所述條件約束背後的欄位。

    SELECT table_name, column_name, position
    FROM all_cons_columns
    WHERE owner = 'SALES' AND constraint_name = 'ORDERS_PK'
    ORDER BY position;
  2. 以單一陳述式插入或更新,搭配 MERGE.

    MERGE INTO customers c
    USING (SELECT '[email protected]' AS email, 'Ada' AS name FROM dual) s
    ON (c.email = s.email)
    WHEN MATCHED THEN UPDATE SET c.name = s.name
    WHEN NOT MATCHED THEN INSERT (email, name) VALUES (s.email, s.name);
  3. 如果序列落後,將它移到目前最大值之後(18c 及之後版本)。

    SELECT MAX(id) FROM orders;
    ALTER SEQUENCE orders_seq RESTART START WITH 100001;
  4. 若要在大量插入時略過重複資料,請使用 IGNORE_ROW_ON_DUPKEY_INDEX 提示或 DML 錯誤記錄(LOG ERRORS INTO)可以把有問題的資料列另外放到一邊。

安全地重現問題

CREATE TABLE t (id NUMBER PRIMARY KEY);
INSERT INTO t VALUES (1);
INSERT INTO t VALUES (1);  -- ORA-00001: unique constraint (...) violated
DROP TABLE t PURGE;

相關錯誤

更多條件約束與索引鍵錯誤

程式碼和訊息文字來自 Oracle 資料庫錯誤說明。瀏覽完整的 Oracle 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 Oracle

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 Oracle 和你使用的其他資料庫。