Виправлення «a foreign key constraint fails» під час імпорту SQL-дампу

Ви експортуєте базу даних, намагаєтеся завантажити її в новий екземпляр, і MySQL видає помилку:

Або, у PostgreSQL:

Чому це стається

Зовнішній ключ вимагає, щоб «кожен orders.user_id вказував на наявний users.id». Коли дамп вставляє orders перед users, батьківський рядок, на який є посилання, ще не існує, і база даних відхиляє рядок.

Більшість інструментів для дампів записують таблиці за алфавітом або в порядку створення — а не в порядку залежностей зовнішніх ключів. Тому orders (нащадок) часто опиняється перед users (батько), і імпорт ламається.

Виправлення 1: переупорядкуйте INSERT за залежностями (правильне виправлення)

Чисте рішення — вставляти кожну батьківську таблицю перед її нащадками. Це означає розв'язати зовнішні ключі в граф залежностей і завантажувати таблиці в топологічному порядку: users → orders → order_items.

Робити це вручну в багатогігабайтному файлі болісно — потрібно відстежити кожен FOREIGN KEY у операторах CREATE TABLE та ALTER TABLE і вирізати/вставити величезні блоки INSERT у правильній послідовності.

Виправлення 2: вимкніть перевірку зовнішніх ключів під час імпорту

Для повного, уже узгодженого дампу можна безпечно пропустити перевірку під час завантаження. У MySQL обгорніть файл:

-- MySQL
SET FOREIGN_KEY_CHECKS = 0;
-- ... усі ваші оператори INSERT ...
SET FOREIGN_KEY_CHECKS = 1;

У PostgreSQL відкладіть обмеження всередині транзакції:

-- PostgreSQL
BEGIN;
SET CONSTRAINTS ALL DEFERRED;
-- ... усі ваші оператори INSERT ...
COMMIT;

Увімкніть перевірки після цього, щоб майбутні записи залишалися перевіреними. Це працює, але лише маскує проблему порядку — якщо дамп частковий, ви все одно можете отримати «осиротілі» рядки.

Виправлення 3: зробіть обидва автоматично за допомогою DumpCleaner

DumpCleaner читає дамп, витягує кожен зовнішній ключ з CREATE TABLE та ALTER TABLE, будує граф залежностей і експортує чистий файл, який просто імпортується:

1. Перетягніть свій дамп .sql у DumpCleaner (MySQL, MariaDB, PostgreSQL, SQLite або MS SQL).
2. Виберіть Порядок INSERT → За залежностями (з урахуванням FK). Батьківські таблиці розміщуються перед нащадками автоматично за допомогою топологічного сортування.
3. За бажанням позначте Вимкнути перевірку зовнішніх ключів — це обгорне вихідний файл правильним оператором для вашої бази даних.
4. Експортуйте. Імпортуйте новий файл — помилки обмеження більше немає.

Він навіть виявляє циклічні зовнішні ключі й попереджає вас замість того, щоб створювати неможливий порядок.

Поширені запитання