// справочник ошибок 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.
  • Две сессии одновременно вставляют один и тот же ключ; вторая ждет, а затем завершается ошибкой, если первая фиксирует изменения.
  • Вот 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 Database. Смотрите весь Список ошибок Oracle или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с Oracle в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для Oracle и других баз данных, которые вы используете.