// 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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 Oracle 以及你使用的其他数据库。