SQLite: حذف وتعديل الجداول DROP و ALTER TABLE

المخططات تتغيّر، وSQLite يسمح لك بتعديلها… في الغالب

بعد إنشاء أي جدول، ستحتاج عاجلاً أم آجلاً إلى إعادة تسميته أو إضافة عمود إليه أو حذف عمود منه أو إعادة هيكلته بالكامل. يدعم SQLite الحالات الشائعة مباشرة عبر DROP TABLE وALTER TABLE، ويوفّر حلاً موثّقاً للحالات الأخرى.

لكن هناك ملاحظة مهمة: أمر ALTER TABLE في SQLite محدود أكثر بكثير مقارنةً بـ Postgres أو MySQL. ومعرفة ما يستطيع فعله وما لا يستطيع، إلى جانب نمط إعادة البناء للحالات غير المدعومة، هي جوهر المهارة المطلوبة هنا.

أمر DROP TABLE يحذف الجدول وكل ما يتعلّق به

يقوم DROP TABLE بحذف الجدول وصفوفه وفهارسه وأي مُشغِّلات (triggers) مُعرَّفة عليه. ولا توجد طريقة للتراجع:

CREATE TABLE scratch (
    id INTEGER PRIMARY KEY,
    note TEXT
);

INSERT INTO scratch (note) VALUES ('مؤقت'), ('مؤقت أيضًا');

DROP TABLE scratch;

SELECT name FROM sqlite_master WHERE type = 'table';

اختفى الجدول. ولو حاولت الاستعلام عنه الآن، فستحصل على الخطأ no such table: scratch.

وإن كنت غير متأكد من وجود الجدول أصلًا — وهذا أمر شائع في سكربتات التهيئة — فاستخدم IF EXISTS لتتجاهل العبارة العملية بصمت إن لم يكن الجدول موجودًا:

CREATE TABLE scratch (id INTEGER PRIMARY KEY);

DROP TABLE IF EXISTS scratch;
DROP TABLE IF EXISTS scratch;
SELECT 'نجحت عمليتا الحذف' AS result;

بدون IF EXISTS، ستفشل عملية الحذف الثانية وتُرجع خطأً. أما مع استخدامها، فستعمل العمليتان دون أي مشاكل.

المفاتيح الأجنبية قد تمنع تنفيذ DROP

إذا كان فرض المفاتيح الأجنبية مُفعّلاً (PRAGMA foreign_keys = ON;) وكان هناك جدول آخر يشير إلى الجدول الذي تحاول حذفه، فإن عملية الحذف ستفشل:

sqlite> PRAGMA foreign_keys = ON;
sqlite> DROP TABLE users;
Runtime error: FOREIGN KEY constraint failed

أمامك عدة خيارات: إمّا أن تحذف الجدول المُشير (child table) أولًا، أو تحذف الصفوف المرتبطة، أو تُعرِّف المفتاح الأجنبي مع ON DELETE CASCADE لحظة إنشائه. SQLite لن يتغاضى عن خرق التكامل المرجعي من تلقاء نفسه.

تعديل جدول sqlite بأمر ALTER TABLE: العمليات الأربع المتاحة

يدعم أمر ALTER TABLE في SQLite أربع عمليات لا غير:

CREATE TABLE posts (
    id INTEGER PRIMARY KEY,
    title TEXT NOT NULL,
    body TEXT
);

-- 1. إعادة تسمية الجدول
ALTER TABLE posts RENAME TO articles;

-- 2. إعادة تسمية عمود
ALTER TABLE articles RENAME COLUMN body TO content;

-- 3. إضافة عمود
ALTER TABLE articles ADD COLUMN published_at TEXT;

-- 4. حذف عمود (الإصدار 3.35 من SQLite فما فوق)
ALTER TABLE articles DROP COLUMN published_at;

SELECT sql FROM sqlite_master WHERE name = 'articles';

كل واحدة من هذه التعليمات تُنفَّذ كأمر واحد. الأولى والثانية تكلفتهما شبه معدومة — كل ما تفعلانه هو تحديث المخطط (schema). أمر ADD COLUMN بدوره سريع: SQLite لا يعيد كتابة الجدول، بل يكتفي بتسجيل تعريف العمود الجديد. أما DROP COLUMN فهو الأثقل، لأن SQLite مضطر لإعادة كتابة كل صف من أجل إزالة بيانات العمود فعلياً.

إضافة عمود بقيمة افتراضية باستخدام ADD COLUMN

عند إضافة عمود جديد إلى جدول قائم، تكون قيمته NULL في جميع الصفوف، ما لم تُحدِّد له قيمة افتراضية:

CREATE TABLE users (
    id INTEGER PRIMARY KEY,
    email TEXT NOT NULL
);

INSERT INTO users (email) VALUES ('ada@example.com'), ('boris@example.com');

ALTER TABLE users ADD COLUMN status TEXT NOT NULL DEFAULT 'active';

SELECT * FROM users;

الصفّان الموجودان مسبقًا سيُملآن بالقيمة 'active'. لاحظ أن القيمة الافتراضية يجب أن تكون ثابتة — SQLite ما يسمح لك تستخدم CURRENT_TIMESTAMP أو أي تعبير غير ثابت كقيمة افتراضية مع ADD COLUMN، لأنه يحتاج قيمة يقدر يطبّقها على كل الصفوف الموجودة دون الحاجة لتقييمها صفًّا صفًّا.

إذا كنت تحتاج NOT NULL بدون قيمة افتراضية، فالحل هو إضافة العمود قابلًا لقيم NULL أولًا، ثم تعبئته عبر UPDATE، وبعدها إعادة بناء الجدول لإضافة القيد. وهذا يقودنا مباشرة إلى القيود.

ما الذي لا يستطيع ALTER TABLE فعله في SQLite

أمور شغّالة في Postgres أو MySQL، لكنها لا تعمل في SQLite:

• تغيير نوع العمود (ALTER COLUMN ... TYPE ...).
• تغيير القيمة الافتراضية للعمود مباشرةً.
• إضافة أو إزالة NOT NULL أو CHECK أو UNIQUE أو PRIMARY KEY على عمود موجود.
• إضافة مفتاح أجنبي على عمود موجود.
• إعادة ترتيب الأعمدة.

أي محاولة لأي من هذه العمليات ستعطيك خطأ في الصياغة (syntax error)، فـ SQLite أصلًا ما عنده جملة ALTER COLUMN من الأساس. والحل الرسمي لكل هذه الحالات واحد: إعادة بناء الجدول.

نمط إعادة بناء جدول sqlite

لمّا يعجز ALTER TABLE عن تنفيذ ما تريد، الفكرة هي أن تُنشئ جدولًا جديدًا بالمخطّط (schema) المطلوب، تنسخ البيانات إليه، تحذف الجدول القديم، ثم تعيد تسمية الجديد ليأخذ مكانه. ولفّ كل هذا داخل معاملة (transaction) حتى يكون التنفيذ إما كاملًا أو لا شيء:

CREATE TABLE users (
    id INTEGER PRIMARY KEY,
    email TEXT,
    age TEXT
);

INSERT INTO users (email, age) VALUES ('ada@example.com', '36'), ('boris@example.com', '41');

BEGIN;

CREATE TABLE users_new (
    id INTEGER PRIMARY KEY,
    email TEXT NOT NULL,
    age INTEGER CHECK (age > 0)
);

INSERT INTO users_new (id, email, age)
SELECT id, email, CAST(age AS INTEGER) FROM users;

DROP TABLE users;
ALTER TABLE users_new RENAME TO users;

COMMIT;

SELECT * FROM users;

الآن أصبح العمود users.age من نوع integer مع قيد تحقق (check constraint)، والعمود email صار NOT NULL. والبيانات انتقلت معها دون أن تضيع.

أمور ينبغي الانتباه لها عند تطبيق هذا فعلياً:

• عطّل المفاتيح الأجنبية طوال العملية. إذا كانت هناك جداول أخرى تشير إلى جدولك، فنفّذ PRAGMA foreign_keys = OFF; قبل بدء المعاملة، ثم PRAGMA foreign_keys = ON; بعدها. وإلا ستفشل عملية DROP TABLE. لاحظ أن هذا الـ pragma لا يمكن تغييره داخل المعاملة، لذا اضبطه خارجها.
• أعد إنشاء الفهارس والمشغّلات (triggers). حذف الجدول القديم يحذف معه فهارسه ومشغّلاته أيضاً. لذا أضفها من جديد إلى الجدول بعد إعادة التسمية.
• راجع الـ views. أي view يشير إلى الجدول سيظل محتفظاً بالاسم القديم في الـ SQL المخزّن له. لذا أعد بناء أي view يعتمد على أعمدة تغيّرت.

نمط إعادة البناء هذا طويل لكنه موثوق. وهو نفس ما تفعله أدوات الترحيل (migrations) مثل Alembic و Rails خلف الكواليس عندما تتعامل مع SQLite.

حذف أكثر من جدول في sqlite

لا توجد جملة واحدة لحذف عدة جداول دفعة واحدة — عليك تنفيذ DROP TABLE لكل جدول على حدة. ويمكنك تجميعها داخل معاملة (transaction) إذا أردت:

CREATE TABLE a (id INTEGER);
CREATE TABLE b (id INTEGER);
CREATE TABLE c (id INTEGER);

BEGIN;
DROP TABLE a;
DROP TABLE b;
DROP TABLE c;
COMMIT;

SELECT name FROM sqlite_master WHERE type = 'table';

لفّ هذه العمليات داخل معاملة (transaction) واحدة يضمن أن العمليات الثلاث إمّا تنجح كلها وإمّا لا ينفّذ منها شيء — وهذا مفيد عند هدم جداول مرتبطة قد تتعثّر بسبب المفاتيح الأجنبية في منتصف الطريق.

الخلاصة

• DROP TABLE يحذف الجدول مع فهارسه ومحفّزاته (triggers). استخدم IF EXISTS لتجعل سكربتاتك قابلة للتشغيل المتكرّر دون أخطاء.
• ALTER TABLE في sqlite يقتصر على أربع عمليات فقط: إعادة تسمية الجدول، إعادة تسمية عمود، إضافة عمود، وحذف عمود.
• أي شيء خارج هذه القائمة — كتغيير نوع البيانات، أو إضافة قيود جديدة، أو ربط مفتاح أجنبي بعمود قائم — يستلزم إعادة بناء الجدول داخل معاملة.
• انتبه للمفاتيح الأجنبية والفهارس والمحفّزات والـ views عند إعادة البناء؛ فهي لا تنتقل مع البيانات تلقائيًا.

الخطوة التالية: إدخال البيانات

قضيت فصلاً كاملاً مع الجداول والقيود التي تشكّلها. حان وقت ملئها بالبيانات — الفصل القادم يبدأ بـ INSERT، بما في ذلك صيغة إدراج عدة صفوف دفعة واحدة، والقيم الافتراضية، وكيف يتعامل SQLite مع عمليات الإدراج التي تتعارض مع القيود التي وضعتها.