Migrations

مفهوم ~20 دقيقة

Migrations

Migration هي تغيير موثق في schema أو البيانات. بدلاً من تعديل قاعدة البيانات يدوياً ثم نسيان ما حدث، تكتب ملفاً يصف التغيير. هذا يسمح بالمراجعة، التشغيل المتكرر، والرجوع عند الحاجة.

في SQLite، انتبه لقيود ALTER TABLE. ولا تستخدم أنماطاً خطرة مثل إضافة عمود NOT NULL بلا default مناسب على جدول فيه بيانات. في قواعد الإنتاج، كل migration تحتاج خطة: ما التغيير؟ هل هو آمن؟ هل يحتاج backfill؟ هل يوجد rollback؟

مثال بسيط

query.sql

CREATE TABLE customers (
  id INTEGER PRIMARY KEY,
  name TEXT NOT NULL
);

ALTER TABLE customers
ADD COLUMN email TEXT;

SELECT 'migration applied' AS result;

Output:

إضافة عمود nullable أسهل من إضافة قيد صارم. القيود تحتاج تخطيطاً.

قيود ALTER TABLE في SQLite

SQLite محدودة في ما تدعمه من ALTER TABLE مقارنةً بـPostgreSQL أو MySQL:

العملية	دعم SQLite
إضافة عمود nullable	مدعوم دائماً
إعادة تسمية عمود	SQLite 3.25+ (2018) فقط
حذف عمود	SQLite 3.35+ (2021) فقط
تغيير نوع العمود	غير مدعوم — يحتاج إعادة بناء
إضافة قيد NOT NULL بلا DEFAULT	غير مدعوم — يحتاج إعادة بناء
إعادة ترتيب الأعمدة	غير مدعوم — يحتاج إعادة بناء

الإجراء الكنسي 12-step لتغيير الـ Schema

عندما تحتاج تغييراً لا يدعمه ALTER TABLE مباشرةً، اتبع الإجراء الرسمي الموثق في https://www.sqlite.org/lang_altertable.html — يُعرف بـ12-step:

query.sql

-- مثال: إضافة قيد NOT NULL على عمود موجود
-- (ALTER TABLE لا تدعم هذا مباشرةً في SQLite)

PRAGMA foreign_keys = OFF;  -- الخطوة 1: أوقف FK مؤقتاً

BEGIN;                        -- الخطوة 2: بدء معاملة

-- الخطوة 3: أنشئ جدولاً جديداً بالـ schema الصحيح
CREATE TABLE customers_new (
  id INTEGER PRIMARY KEY,
  name TEXT NOT NULL,
  email TEXT NOT NULL  -- القيد الجديد
);

-- الخطوة 4: انسخ البيانات (الصفوف التي تحتوي NULL في email ستفشل — تعاملها أولاً)
INSERT INTO customers_new SELECT id, name, COALESCE(email, 'unknown@example.com') FROM customers;

-- الخطوة 5: احذف الجدول القديم
DROP TABLE customers;

-- الخطوة 6: أعِد التسمية
ALTER TABLE customers_new RENAME TO customers;

-- الخطوة 7: أعِد الفهارس والـ triggers والـ views (إن وُجدت)
CREATE INDEX idx_customers_email ON customers(email);

COMMIT;                       -- الخطوة 8: أكمل المعاملة

PRAGMA foreign_keys = ON;     -- الخطوة 9: أعِد تفعيل FK

-- الخطوة 10: تحقق من سلامة البيانات
PRAGMA integrity_check;

-- الخطوات 11-12: تحقق من FK وأشغّل اختبارات التطبيق
PRAGMA foreign_key_check;
SELECT 'migration applied' AS result;

Output:

هذا الإجراء ذري (داخل معاملة) وآمن. لا تُنفذه خارج معاملة.

تحدي — Challenge

CREATE TABLE customers (id INTEGER PRIMARY KEY);
ALTER TABLE customers ADD COLUMN name TEXT;

-- أرجع migration applied