SQLITE_CONSTRAINT_FOREIGNKEY: нарушено ограничение FOREIGN KEY
Запись оставила бы дочернюю строку, указывающую на несуществующего родителя, или удалила бы родителя, у которого еще есть дочерние строки. Внешние ключи должны быть включены для каждого соединения отдельно.
- Код результата
SQLITE_CONSTRAINT_FOREIGNKEY- Имя
787- Категория
- Расширенные коды результатов
Что это значит
SQLITE_CONSTRAINT_FOREIGNKEY (787) означает, что проверка внешнего ключа не прошла. SQLite проверяет внешние ключи только на соединениях, которые выполняют PRAGMA foreign_keys = ON; по умолчанию это отключено для обратной совместимости, поэтому одна и та же вставка может пройти в одном инструменте и не пройти в другом.
Из сообщения не видно, какой ключ вызвал ошибку. PRAGMA foreign_key_check перечисляет каждую нарушающую строку.
Распространённые причины
- Вставка дочерней строки, родительский идентификатор которой не существует.
- Удаление или обновление родительской строки, у которой все еще есть дочерние, без
ON DELETE CASCADEилиSET NULL. - Загрузка таблиц в неправильном порядке: сначала дочерние, потом родительские.
- Отложенные ограничения (
DEFERRABLE INITIALLY DEFERRED) сбой приCOMMIT.
Как исправить
-
Найдите строки, которые нарушают внешний ключ.
PRAGMA foreign_key_check; PRAGMA foreign_key_list(orders);
-
Вставляйте родителей перед детьми или удаляйте детей перед родителями.
-
Для пакетной загрузки отложите проверку до конца транзакции.
BEGIN; PRAGMA defer_foreign_keys = ON; -- load tables in any order COMMIT;
-
Если при удалении родителя должны удаляться и его дочерние строки, объявите это действие у внешнего ключа.
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_CONSTRAINTнарушение ограничения23503PostgreSQL: нарушение ограничения внешнего ключа1452MySQL: Нарушение внешнего ключа: невозможно добавить дочернюю строку1451MySQL: Нарушение внешнего ключа: невозможно удалить родительскую строку547SQL Server: оператор конфликтует с ограничениемORA-02291Oracle: нарушение целостности данных - нет родительского ключаORA-02292Oracle: нарушение целостности данных - найдена дочерняя запись
Больше ошибок расширенных кодов результатов
SQLITE_ERROR_MISSING_COLLSEQнет такой последовательности сортировкиSQLITE_BUSY_RECOVERYдругой процесс восстанавливает WALSQLITE_LOCKED_SHAREDCACHEзапись заблокирована в общем кэшеSQLITE_CONSTRAINT_CHECKНарушено ограничение CHECKSQLITE_ABORT_ROLLBACKоператор прерван командой ROLLBACKSQLITE_BUSY_SNAPSHOTустаревшее чтение не может стать записьюSQLITE_IOERR_SHORT_READчтение вернуло меньше байтSQLITE_CANTOPEN_ISDIRпуть является каталогом
Код и текст сообщения взяты из Документация по кодам результатов и ошибок SQLite. Смотрите весь Список ошибок SQLite или поиск по всем ошибкам баз данных.
Работа с SQLite в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для SQLite и других баз данных, которые вы используете.