migrations ทำงานอย่างไร?

Question

Accepted Answer

**Migrations** เป็นวิธีของ Django ในการนำการเปลี่ยนแปลงที่คุณทำกับ model (เพิ่ม field, สร้าง model) ไปยัง **database schema** — เป็นไฟล์การเปลี่ยนแปลง database ที่ถูกสร้างขึ้นโดยอัตโนมัติและอยู่ภายใต้ version control คุณเปลี่ยน model ใน Python ส่วน migrations ทำให้ database ซิงค์กัน ## ขั้นตอนการทำงานสองขั้น ```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` นำ migration ที่ค้างอยู่ไปใช้กับ database จริง คุณเขียน Python (เปลี่ยน model) และ Django สร้างและรัน SQL ให้ ## ไฟล์ migration คือโค้ดที่อยู่ภายใต้ version control ```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 ถูก **commit เข้า version control** ดังนั้นประวัติของ database schema จึงถูกติดตามควบคู่ไปกับโค้ด นักพัฒนาและสภาพแวดล้อมทุกตัวนำ migration ชุดเดียวกันไปใช้เพื่อให้ได้ schema เดียวกัน — ทำซ้ำได้และสอดคล้องกัน ## ทำไม 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 ``` ## คำสั่งและแนวคิดที่มีประโยชน์ ```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 จำเป็นต่อการทำงานกับชั้น database ของ Django — มันแก้ปัญหาสำคัญในการทำให้ database schema ซิงค์กับ Python model ของคุณในแบบที่ปลอดภัย ทำซ้ำได้ และเป็นมิตรกับทีม การเข้าใจมันเป็นความรู้พื้นฐานในการใช้งานประจำวัน: ขั้นตอน `makemigrations` → `migrate` คือวิธีที่การเปลี่ยนแปลง schema ทุกครั้งเกิดขึ้น (คุณเปลี่ยน model, Django สร้างและนำ SQL ไปใช้) ดังนั้นคุณไม่สามารถพัฒนาแอป Django ที่ขับเคลื่อนด้วยข้อมูลได้หากปราศจากมัน คุณค่าสำคัญคือ migrations ทำให้การเปลี่ยนแปลง schema อยู่ภายใต้ **version control** (ติดตามควบคู่ไปกับโค้ด ตรวจทานได้ใน pull request), **ทำซ้ำได้** (ทุกสภาพแวดล้อม — เครื่องของนักพัฒนาแต่ละคน, staging, production — ได้ schema เดียวกันโดยรัน migration ชุดเดียวกัน) และ **ปลอดภัย** (Django สร้าง SQL ที่ถูกต้องและมักย้อนกลับได้ แทนคำสั่ง `ALTER TABLE` ด้วยมือที่เสี่ยงผิดพลาด) สิ่งนี้กำจัดปัญหาทั้งหมวดเกี่ยวกับ schema drift, สภาพแวดล้อมที่ไม่สอดคล้องกัน และการเปลี่ยนแปลง database ด้วยมือที่เสี่ยง การรู้ขั้นตอนการทำงาน, การที่ migration ถูก commit เข้า source control, วิธีตรวจสอบและย้อนกลับ และการที่มันสามารถจัดการ **การแปลงข้อมูล** ได้ด้วย (backfill/ย้ายข้อมูล ไม่ใช่แค่ schema) จำเป็นสำหรับโปรเจกต์ Django จริงใด ๆ Migrations คือวิธีที่ทีม Django พัฒนา database schema ร่วมกันอย่างเชื่อถือได้ตลอดอายุของโปรเจกต์ ทำให้มันเป็นเนื้อหาหลักที่ต้องรู้