მიგრაციები როგორ მუშაობს?

Question

Accepted Answer

**მიგრაციები** Django-ს გზაა თქვენი მოდელებში განხორციელებული ცვლილებების (ველის დამატება, მოდელის შექმნა) **ბაზის სქემაში** გამოყენება — ისინი ვერსიის კონტროლის ქვეშ მყოფი, ავტომატურად გენერირებული ბაზის ცვლილების ფайლებია. მოდელებს 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-ს გენერირებს და აწერთ. ## მიგრაციის ფაილი ვერსიის კონტროლის ქვეშ მყოფი კოდია ```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), ), ] ``` მიგრაციები **რეპოზიტორიაში ფიქსირდება**, ასე რომ ბაზის სქემის ისტორია კოდის გვერდით ტრეკირდება. ყველა დეველოპერი და გარემო ერთი და იგივე მიგრაციებს იყენებს ერთი და იგივე სქემამდე მისასვლელად — რეპროდუქტიული და თანმიმდევრული. ## რატომ მნიშვნელოვნებ მიგრაციები (სხვა ხელის 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 ``` ## მონაცემების მიგრაციები (არა მხოლოდ სქემა) ```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-ს ბაზის ფენაზე მუშაობის ზეთელი — ისინი ამოწყვეტენ კრიტიკულ პრობლემას ბაზის სქემის თქვენი Python მოდელებთან სინქრონიზირებული დაკეტებში უსაფრთხო, რეპროდუქტიული, გუნდის მეგობარი გზით. öრათ გაგება ფუნდამენტური ყოველდღიური ცოდნაა: `makemigrations` → `migrate` სამუშაო ნაკადი არის როგორ ხდება ყველა სქემის ცვლილება (თქვენ ცვლით მოდელებს, Django გენერირებს და გამოიყენებს SQL-ს), ასე რომ მონაცემების დაკავშირებული Django აპი დეველოპ არ შეგიძლიათ ის ყოლის გარეშე. კლუჩის ღირებულება იმაში გამოიხატება, რომ მიგრაციები სქემის ცვლილებებს **ვერსიის კონტროლის ქვეშ** აკეთებენ (კოდის გვერდით ტრეკირებული, მიმოხილვადი pull request-ებში), **რეპროდუქტიული** (ყველა გარემო — თითოეული დეველოპერის მანქანა, staging, production — ერთი და იგივე სქემამდე მიდის ერთი და იგივე მიგრაციების აწერით), და **უსაფრთხო** (Django გენერირებს სწორი, ხშირად-რევერსიული SQL-ს ნაცვლად შეცდომებიანი ხელის `ALTER TABLE` გამოთქმებიდან). ეს აღმოფხვრა პრობლემების მთელი კატეგორია სქემის დრეიფის, არათანმიმდევრული გარემოს, და რისკიანი ხელის ბაზის ცვლილებების გარშემოთ. სამუშაო ნაკადის, რომ მიგრაციები საწყის კონტროლში ფიქსირდება, როგორ შესამოწმებელი და დაბრუნება მათ, და რომ ისინი ასევე შეუძლიათ მოემსახუროთ **მონაცემების ტრანსფორმაციები** (backfilling/მიგრაციის მონაცემები, არა მხოლოდ სქემა) საჭიროა ნებისმიერი რეალური Django პროექტისთვის. მიგრაციები არის როგორ Django გუნდები ევოლუციონირებს მათი ბაზის სქემა თანამშრომლობით და საიმედოდ პროექტის სიცოცხლის განმავლობაში, ამ ძირითადი, აუცილებელი-იცოდა მასალის გაკეთება.