إصلاح خطأ "a foreign key constraint fails" عند استيراد ملف SQL dump

تُصدِّر قاعدة بيانات وتحاول تحميلها في نسخة جديدة، فيُطلق MySQL هذا الخطأ:

أو على PostgreSQL:

لماذا يحدث هذا

يقول المفتاح الخارجي إن “كل orders.user_id يجب أن يشير إلى users.id موجود.” وعندما يُدرِج الـ dump جدول orders قبل جدول users، لا يكون الصف الأب المُشار إليه موجودًا بعد، فترفض قاعدة البيانات الصف.

تكتب معظم أدوات الـ dump الجداول أبجديًا أو حسب ترتيب الإنشاء — لا حسب ترتيب اعتماد المفاتيح الخارجية. لذا كثيرًا ما يأتي orders (الابن) قبل users (الأب)، فيفشل الاستيراد.

الحل الأول: إعادة ترتيب عبارات INSERT حسب التبعية (الحل الصحيح)

الحل النظيف هو إدراج كل جدول أب قبل أبنائه. وهذا يعني تحليل المفاتيح الخارجية إلى رسم بياني للتبعيات وتحميل الجداول بـالترتيب الطوبولوجي: users → orders → order_items.

القيام بذلك يدويًا في ملف بحجم عدة غيغابايت أمر مؤلم — عليك تتبّع كل FOREIGN KEY عبر عبارات CREATE TABLE وALTER TABLE وقص/لصق كتل INSERT الضخمة بالتسلسل الصحيح.

الحل الثاني: تعطيل فحص المفاتيح الخارجية أثناء الاستيراد

بالنسبة لملف dump كامل ومتّسق مسبقًا يمكنك بأمان تخطّي التحقق أثناء التحميل. على MySQL، أحِط الملف هكذا:

-- MySQL
SET FOREIGN_KEY_CHECKS = 0;
-- ... جميع عبارات INSERT الخاصة بك ...
SET FOREIGN_KEY_CHECKS = 1;

على PostgreSQL، أجّل القيود داخل معاملة (transaction):

-- PostgreSQL
BEGIN;
SET CONSTRAINTS ALL DEFERRED;
-- ... جميع عبارات INSERT الخاصة بك ...
COMMIT;

أعِد تفعيل الفحص بعد ذلك لتبقى عمليات الكتابة المستقبلية خاضعة للتحقق. هذا يعمل، لكنه يخفي مشكلة الترتيب فقط — فإذا كان الـ dump جزئيًا، فقد ينتهي بك الأمر إلى صفوف يتيمة.

الحل الثالث: افعل الأمرين تلقائيًا باستخدام DumpCleaner

يقرأ DumpCleaner الـ dump، ويستخرج كل مفتاح خارجي من عبارات CREATE TABLE وALTER TABLE، ويبني رسم التبعيات، ويُصدِّر ملفًا نظيفًا يُستورَد ببساطة:

1. اسحب ملف .sql إلى DumpCleaner (MySQL أو MariaDB أو PostgreSQL أو SQLite أو MS SQL).
2. اختر ترتيب INSERT ← حسب التبعيات (مع مراعاة المفاتيح الخارجية). تُوضَع الجداول الأب قبل الأبناء تلقائيًا عبر الترتيب الطوبولوجي.
3. اختياريًا فعِّل تعطيل فحص المفاتيح الخارجية — سيُحيط المخرجات بالعبارة الصحيحة لقاعدة بياناتك.
4. صدِّر. استورد الملف الجديد — واختفى خطأ القيد.

كما يكتشف المفاتيح الخارجية الدائرية ويُحذّرك بدلًا من إنتاج ترتيب مستحيل.

الأسئلة الشائعة