// справочник ошибок SQL Server

Ошибка SQL Server 2601: не удалось вставить строку с повторяющимся ключом

Операция INSERT или UPDATE приведет к дублированию значения в уникальном индексе. В сообщении указываются таблица, индекс и значение повторяющегося ключа.

Номер ошибки
2601
Уровень серьёзности
14
Категория
Ограничения и ключи
Сообщение об ошибке
Cannot insert duplicate key row in object '%.*ls' with unique index '%.*ls'. The duplicate key value is %ls.

Что это значит

Ошибка 2601 вызывается уникальным индексом, созданным с помощью CREATE UNIQUE INDEX, включая фильтрованные уникальные индексы. Это индексный аналог ошибки 2627, которая возникает из-за ограничений PRIMARY KEY и UNIQUE. Выполнение запроса останавливается и изменения отменяются.

Распространённые причины

  • Запись значения, которое уже есть в другой строке в столбце, покрытом уникальным индексом.
  • Уникальный индекс по столбцу, допускающему NULL: SQL Server считает NULL равными в уникальных индексах, поэтому только одна строка может содержать NULL, если индекс не фильтрованный.
  • Загрузка, источник которой содержит дубликаты.

Как исправить

  1. Найдите конфликтующую строку со значением из сообщения, затем обновите её или пропустите новую.

    SELECT * FROM dbo.Users WHERE UserName = N'ada';
  2. Чтобы разрешить множество NULL, но сохранить уникальность ненулевых значений, сделайте индекс отфильтрованным.

    DROP INDEX UX_Users_TaxId ON dbo.Users;
    CREATE UNIQUE INDEX UX_Users_TaxId ON dbo.Users (TaxId) WHERE TaxId IS NOT NULL;
  3. Проверьте, какие столбцы охватывает индекс.

    EXEC sp_helpindex 'dbo.Users';

Безопасное воспроизведение

CREATE TABLE #u (v int NULL);
CREATE UNIQUE INDEX ux ON #u (v);
INSERT INTO #u VALUES (NULL);
INSERT INTO #u VALUES (NULL);  -- Msg 2601: The duplicate key value is (<NULL>).
DROP TABLE #u;

Вопросы

Почему я не могу вставить второй NULL в уникальный столбец?

В SQL Server уникальный индекс или ограничение рассматривает NULL как значение, поэтому разрешён только один NULL. Отфильтрованный уникальный индекс с условием WHERE column IS NOT NULL допускает любое количество NULL.

Связанные ошибки

Больше ошибок ограничений и ключей

Код и текст сообщения взяты из Справочник по событиям и ошибкам Microsoft Database Engine. Смотрите весь Список ошибок SQL Server или поиск по всем ошибкам баз данных.

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

Работа с SQL Server в SQLly

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