ORA-00001

📖 Описание

ORA-00001: нарушена уникальность ключа или индекса.


🔎 Причина

INSERT, UPDATE или MERGE создаёт повтор значения либо комбинации значений, защищённых PRIMARY KEY, UNIQUE или уникальным индексом. Проверять нужно имя ограничения или индекса из сообщения, а не только идентификатор строки.


🛠️ Действие

Установите, какое правило нарушено. Для новой сущности используйте действительно новый ключ; для уже существующей — обновление по её бизнес-ключу. MERGE может подходить для согласованного обновления или добавления, но не отменяет остальные ограничения и не исключает конфликт параллельных вставок.

💻 Дублирующийся логин

CREATE TABLE demo_unique_members (
  member_id NUMBER(6) CONSTRAINT demo_member_pk PRIMARY KEY,
  username VARCHAR2(40 CHAR) CONSTRAINT demo_member_username_uq UNIQUE,
  display_name VARCHAR2(60 CHAR) NOT NULL
);
INSERT INTO demo_unique_members VALUES (41, 'aziza_clay', 'Aziza');
COMMIT;

Отрицательный пример: идентификатор новый, но username повторяется.

INSERT INTO demo_unique_members VALUES (42, 'aziza_clay', 'Temur');
-- ORA-00001: DEMO_MEMBER_USERNAME_UQ.

Для другого участника нужен собственный логин:

SAVEPOINT before_member_insert;
INSERT INTO demo_unique_members VALUES (42, 'temur_paper', 'Temur');
SELECT member_id, username FROM demo_unique_members ORDER BY member_id;
ROLLBACK TO before_member_insert;
MEMBER_ID USERNAME
41 aziza_clay
42 temur_paper

Обновить существующего участника

SAVEPOINT before_member_merge;
MERGE INTO demo_unique_members m
USING (
  SELECT 43 AS new_id, 'aziza_clay' AS username, 'Aziza Karimova' AS display_name
  FROM dual
) s
ON (m.username = s.username)
WHEN MATCHED THEN UPDATE SET m.display_name = s.display_name
WHEN NOT MATCHED THEN INSERT (member_id, username, display_name)
  VALUES (s.new_id, s.username, s.display_name);
SELECT member_id, username, display_name FROM demo_unique_members;
ROLLBACK TO before_member_merge;
MEMBER_ID USERNAME DISPLAY_NAME
41 aziza_clay Aziza Karimova

Срабатывает UPDATE, потому что логин уже существует; новый идентификатор 43 не используется. После отката имя снова Aziza.

Проверить столбцы ограничения

SELECT constraint_name, column_name, position
FROM user_cons_columns
WHERE constraint_name = 'DEMO_MEMBER_USERNAME_UQ'
ORDER BY position;

Для этого примера вернётся USERNAME. Если в сообщении указан самостоятельный уникальный индекс, проверяйте USER_INDEXES, USER_IND_COLUMNS и при выражениях USER_IND_EXPRESSIONS. Удаление ограничения ради принятия дублей обычно меняет смысл данных; сначала исправьте причину.

Связанные темы: UNIQUE, PRIMARY KEY, MERGE, индексы.

Справка Oracle по ORA-00001.