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

SQLITE_CONSTRAINT_FOREIGNKEY: нарушено ограничение FOREIGN KEY

Запись оставила бы дочернюю строку, указывающую на несуществующего родителя, или удалила бы родителя, у которого еще есть дочерние строки. Внешние ключи должны быть включены для каждого соединения отдельно.

Код результата
SQLITE_CONSTRAINT_FOREIGNKEY
Имя
787
Категория
Расширенные коды результатов
Сообщение об ошибке
FOREIGN KEY constraint failed

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

SQLITE_CONSTRAINT_FOREIGNKEY (787) означает, что проверка внешнего ключа не прошла. SQLite проверяет внешние ключи только на соединениях, которые выполняют PRAGMA foreign_keys = ON; по умолчанию это отключено для обратной совместимости, поэтому одна и та же вставка может пройти в одном инструменте и не пройти в другом.

Из сообщения не видно, какой ключ вызвал ошибку. PRAGMA foreign_key_check перечисляет каждую нарушающую строку.

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

  • Вставка дочерней строки, родительский идентификатор которой не существует.
  • Удаление или обновление родительской строки, у которой все еще есть дочерние, без ON DELETE CASCADE или SET NULL.
  • Загрузка таблиц в неправильном порядке: сначала дочерние, потом родительские.
  • Отложенные ограничения (DEFERRABLE INITIALLY DEFERRED) сбой при COMMIT.

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

  1. Найдите строки, которые нарушают внешний ключ.

    PRAGMA foreign_key_check;
    PRAGMA foreign_key_list(orders);
  2. Вставляйте родителей перед детьми или удаляйте детей перед родителями.

  3. Для пакетной загрузки отложите проверку до конца транзакции.

    BEGIN;
    PRAGMA defer_foreign_keys = ON;
    -- load tables in any order
    COMMIT;
  4. Если при удалении родителя должны удаляться и его дочерние строки, объявите это действие у внешнего ключа.

    CREATE TABLE orders (
        id          INTEGER PRIMARY KEY,
        customer_id INTEGER NOT NULL REFERENCES customers(id) ON DELETE CASCADE
    );

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

PRAGMA foreign_keys = ON;
CREATE TABLE p (id INTEGER PRIMARY KEY);
CREATE TABLE c (pid INTEGER REFERENCES p(id));
INSERT INTO c VALUES (1);  -- Runtime error: FOREIGN KEY constraint failed (19)

Вопросы

Почему в моей базе данных SQLite не применяются внешние ключи?

Применение осуществляется на уровне подключения и по умолчанию выключено. Каждое подключение должно выполнить PRAGMA foreign_keys = ON, и это нельзя изменить внутри транзакции.

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

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

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

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

Работа с SQLite в SQLly

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