كيف تعمل الهجرات (Migrations)؟

Question

Accepted Answer

**الهجرات (Migrations)** هي طريقة Django لنشر التغييرات التي تجريها على نماذجك (إضافة حقل، إنشاء نموذج) إلى **schema قاعدة البيانات** — فهي ملفات تغيير قاعدة بيانات يتم التحكم بإصداراتها وتُولَّد تلقائياً. تقوم بتغيير النماذج في Python؛ والهجرات تبقي قاعدة البيانات متزامنة. ## سير العمل المكون من خطوتين ```bash # 1. you change a model in models.py (e.g. add a field)... # 2. generate a migration file describing the change python manage.py makemigrations # → creates migrations/0002_article_views.py (the change, as Python) # 3. apply the migration to the database python manage.py migrate # → runs the SQL to alter the database schema (ADD COLUMN, etc.) ``` `makemigrations` يكتشف التغييرات في النموذج ويُنشئ ملف هجرة؛ `migrate` يطبق الهجرات المعلقة على قاعدة البيانات الفعلية. تكتب Python (تغييرات النموذج)، وDjango يُنشئ ويشغل SQL. ## ملف الهجرة هو code مُتحكم به بالإصدار ```python # migrations/0002_article_views.py (auto-generated) class Migration(migrations.Migration): dependencies = [("blog", "0001_initial")] # ordering — depends on the previous one operations = [ migrations.AddField( # the change model_name="article", name="views", field=models.IntegerField(default=0), ), ] ``` الهجرات يتم **تسليمها إلى نظام التحكم بالإصدارات**، لذا يتم تتبع سجل schema قاعدة البيانات جنباً إلى جنب مع الكود. كل مطور وكل بيئة يطبقون نفس الهجرات للوصول إلى نفس schema — قابل للتكرار ومتسق. ## لماذا تهمك الهجرات (مقابل SQL اليدوي) ```text ✓ Schema changes are version-controlled (tracked with the code, reviewable in PRs) ✓ Reproducible — every dev/staging/production DB gets the same schema by running migrate ✓ No manual, error-prone SQL — Django generates the correct ALTER statements ✓ Reversible — many migrations can be rolled back (migrate ) ✓ Team-friendly — schema changes flow through the normal code-review process ``` ## الأوامر والمفاهيم المفيدة ```bash python manage.py showmigrations # see which migrations are applied/pending python manage.py sqlmigrate blog 0002 # preview the SQL a migration will run python manage.py makemigrations --empty # a blank migration for custom/data changes python manage.py migrate blog 0001 # roll BACK to a previous migration ``` ## الهجرات البيانات (ليست فقط schema) ```text Migrations can also transform DATA (e.g. populate a new field, backfill values) via RunPython operations — useful when a schema change needs accompanying data changes. ``` ## لماذ تهمك الهجرات ضرورية للعمل مع طبقة قاعدة بيانات Django — فهي تحل المشكلة الحرجة المتمثلة في إبقاء schema قاعدة البيانات متزامناً مع نماذج Python الخاصة بك بطريقة آمنة وقابلة للتكرار وودية للفريق. فهمها هو معرفة أساسية يومية: سير عمل `makemigrations` → `migrate` هو كيفية حدوث كل تغيير schema (تقوم بتغيير النماذج، Django يُنشئ ويطبق SQL)، لذا لا يمكنك تطوير تطبيق Django محرك البيانات بدونها. القيمة الأساسية هي أن الهجرات تجعل تغييرات schema **مُتحكماً بها بالإصدار** (مُتتبعة جنباً إلى جنب مع الكود، قابلة للمراجعة في طلبات السحب)، **قابلة للتكرار** (كل بيئة — جهاز كل مطور، التدريج، الإنتاج — تصل إلى نفس schema بتشغيل نفس الهجرات)، و**آمنة** (Django يُنشئ SQL صحيح، غالباً ما يكون قابلاً للعكس، بدلاً من عبارات `ALTER TABLE` اليدوية العرضة للأخطاء). وهذا يزيل فئة كاملة من المشاكل المتعلقة بانجراف schema والبيئات غير المتسقة وتغييرات قاعدة البيانات اليدوية الخطيرة. معرفة سير العمل، وأن الهجرات يتم تسليمها إلى التحكم بالإصدار، وكيفية فحصها والتراجع عنها، وأنها يمكن أيضاً أن تتعامل مع **تحويلات البيانات** (الملء الاستباقي/هجرة البيانات، وليس فقط schema) أمر ضروري لأي مشروع Django حقيقي. الهجرات هي كيفية تطور فرق Django schema قاعدة البيانات الخاصة بهم بشكل تعاوني وموثوق على مدار حياة المشروع، مما يجعل هذا المادة أساسية وضرورية المعرفة.