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

SQLITE_CONSTRAINT_PRIMARYKEY: нарушено ограничение PRIMARY KEY

INSERT или UPDATE дублировали бы значение первичного ключа. В сообщении SQLite по-прежнему стоит «UNIQUE constraint failed», и он называет ключевой столбец.

Код результата
SQLITE_CONSTRAINT_PRIMARYKEY
Имя
1555
Категория
Расширенные коды результатов
Сообщение об ошибке
UNIQUE constraint failed: orders.id

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

SQLITE_CONSTRAINT_PRIMARYKEY (1555) — это расширенный код для дублирующегося первичного ключа. Текст сообщения такой же, как и при любом нарушении уникального ограничения, UNIQUE constraint failed: table.column, поэтому по расширенному коду программа отличает эти два случая друг от друга.

Для столбца с INTEGER PRIMARY KEY вы можете не указывать значение (или передать NULL), и SQLite присвоит следующий rowid, что предотвращает большинство коллизий.

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

  • Вставка явного идентификатора, который уже существует.
  • Копирование строк между базами данных с их идентификаторами, где диапазоны перекрываются.
  • Генерация идентификаторов в приложении по схеме, которая может давать повторы.

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

  1. Пусть SQLite назначает INTEGER PRIMARY KEY значения, пропуская этот столбец.

    INSERT INTO orders (customer_id, total) VALUES (42, 19.99);
    SELECT last_insert_rowid();
  2. При объединении данных используйте upsert по ключу или пропускайте существующие строки.

    INSERT INTO orders (id, customer_id, total)
    SELECT id, customer_id, total FROM other.orders WHERE true
    ON CONFLICT (id) DO NOTHING;

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

Больше ошибок расширенных кодов результатов

Код и текст сообщения взяты из Документация по кодам результатов и ошибок SQLite. Смотрите весь Список ошибок SQLite или поиск по всем ошибкам баз данных.

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

Работа с SQLite в SQLly

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