Поправка на „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 → По зависимости (съобразено с външни ключове). Родителите се поставят преди дъщерните автоматично чрез топологично сортиране.
3. По желание отметнете Изключване на проверките за външни ключове — обвива изхода с правилната заявка за вашата база данни.
4. Експортирайте. Импортирайте новия файл — грешката с ограничението изчезна.

Дори засича кръгови външни ключове и ви предупреждава, вместо да произведе невъзможен ред.

Често задавани въпроси