Safe Schema Migrations

နားလည်ထားရမယ့် အချက်

Migration file ကို version control ထဲထားပြီး environment အားလုံးအတူ run ရပါတယ်။ Column rename/drop လို breaking change ကို deploy တစ်ခါတည်းမလုပ်ဘဲ new column add → app dual-read/write → data backfill → constraints validate → old column remove အဆင့်များခွဲပါတယ်။ DDL အချို့က lock ယူလို့ timeout နဲ့ table size ကိုကြိုစစ်ရပါတယ်။

လက်တွေ့ scenario နဲ့ ချိတ်ကြည့်မယ်

Required `summary` column ထည့်ရာမှာ default+NOT NULL ကို blind run မလုပ်ဘဲ nullable add၊ batches နဲ့ backfill၊ `CHECK ... NOT VALID` + `VALIDATE CONSTRAINT`၊ ပြီးမှ NOT NULL သို့ပြောင်းမယ်။ Rollback က data loss ရှိမရှိအလိုက် forward fix ကိုလည်းပြင်ဆင်ပါ။

• Migration ကို version control
• Expand/contract ဖြင့် backward compatibility
• Lock timeout နှင့် observability ထည့်

အတူတူ စမ်းရေးကြည့်မယ်

SET lock_timeout = '2s';
ALTER TABLE app.tutorials ADD COLUMN summary text;

-- Backfill in controlled batches from the application/job.
UPDATE app.tutorials
SET summary = title
WHERE summary IS NULL AND tutorial_id BETWEEN 1 AND 1000;

ALTER TABLE app.tutorials
  ADD CONSTRAINT tutorials_summary_present
  CHECK (summary IS NOT NULL) NOT VALID;
ALTER TABLE app.tutorials VALIDATE CONSTRAINT tutorials_summary_present;
ALTER TABLE app.tutorials ALTER COLUMN summary SET NOT NULL;

Existing rows ကိုထိန်းထားပြီး required column ကိုအဆင့်လိုက်ထည့်နိုင်မည်။

PostgreSQL — ALTER TABLE — PostgreSQL Global Development Group