ہجرت (Migrations) کیسے کام کرتی ہے؟

Question

Accepted Answer

**Migrations** Django کا طریقہ ہے آپ کے models میں کیے گئے تبدیلیوں (field شامل کرنا، model بنانا) کو **database schema** میں منتقل کرنے کا — یہ version-controlled، خودکار طور پر بنائے گئے database تبدیلی والی فائلیں ہیں۔ آپ Python میں models تبدیل کرتے ہیں؛ migrations database کو ہم آہنگ رکھتی ہے۔ ## دو مرحلہ کا workflow ```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` model کی تبدیلیوں کا پتہ لگاتا ہے اور migration فائل بناتا ہے؛ `migrate` زیرِالتوا migrations کو اصل database میں لاگو کرتا ہے۔ آپ Python لکھتے ہیں (model کی تبدیلیاں)، اور Django SQL بناتا اور چلاتا ہے۔ ## ایک migration فائل version-controlled 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), ), ] ``` Migrations **version control میں commit** ہوتی ہیں، اس لیے database schema کی تاریخ code کے ساتھ ٹریک کی جاتی ہے۔ ہر developer اور environment ایک جیسی schema تک پہنچنے کے لیے ایک جیسی migrations لاگو کرتے ہیں — دہرائے جانے کے قابل اور مطابقت پذیر۔ ## Migrations کیوں اہم ہیں (دستی 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 ``` ## مفید commands اور تصورات ```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 ``` ## Data migrations (صرف 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. ``` ## یہ کیوں اہم ہے Migrations Django کے database layer کے ساتھ کام کرنے کے لیے ضروری ہیں — یہ database schema کو آپ کے Python models کے ساتھ محفوظ، دہرائے جانے کے قابل، ٹیم کے لیے دوست انہ طریقے سے ہم آہنگ رکھنے کے اہم مسئلے کو حل کرتے ہیں۔ i کو سمجھنا بنیادی روزمرہ کا علم ہے: `makemigrations` → `migrate` workflow یہی ہے کہ ہر schema تبدیلی کیسے ہوتی ہے (آپ models تبدیل کرتے ہیں، Django SQL بناتا اور لاگو کرتا ہے)، اس لیے آپ بغیر اس کے ڈیٹا سے منسلک Django app develop نہیں کر سکتے۔ اہم قیمت یہ ہے کہ migrations schema کی تبدیلیوں کو **version-controlled** (code کے ساتھ ٹریک کیا جاتا ہے، pull requests میں دیکھا جا سکتا ہے)، **دہرائے جانے کے قابل** (ہر environment — ہر developer کی مشین، staging، production — ایک جیسی schema تک پہنچتا ہے ایک جیسی migrations چلا کر)، اور **محفوظ** (Django درست، اکثر الٹائے جانے والے SQL بناتا ہے بجائے غلطی کا شکار دستی `ALTER TABLE` بیانات)۔ یہ schema drift، inconsistent environments، اور خطرناک دستی database تبدیلیوں کے ارد گرد مسائل کا ایک پوری زمرہ ختم کر دیتا ہے۔ Workflow کو جاننا، کہ migrations source control میں commit ہوتی ہیں، ان کو کیسے دیکھا اور واپس کیا جائے، اور کہ یہ **data transformations** کو بھی سنبھال سکتے ہیں (data backfilling/migrating، نہ کہ صرف schema) کسی بھی حقیقی Django project کے لیے ضروری ہے۔ Migrations وہ طریقہ ہے جس سے Django teams اپنے database schema کو project کی پوری زندگی میں اشتراک سے اور قابلِ اعتماد طریقے سے تیار کرتے ہیں، یہ core، ضرور معلوم ہونے والا مادہ بناتا ہے۔