قيود NOT NULL و DEFAULT في SQLite بشكل عملي

قيدان يستحقان وجودهما في كل جدول

معظم الأخطاء التي تظهر بسبب تصميم سيء للجداول ترجع في الغالب إلى أحد سببين: عمود تكون قيمته NULL بينما لم يكن أحد يتوقع ذلك، أو عمود تنقصه قيمة افترض التطبيق وجودها. هنا يأتي دور قيدَي NOT NULL وDEFAULT في sqlite لحل المشكلتين معًا، وإضافتهما لا تكلفك شيئًا تقريبًا.

CREATE TABLE users (
    id       INTEGER PRIMARY KEY,
    email    TEXT    NOT NULL,
    name     TEXT    NOT NULL DEFAULT 'مجهول',
    joined   TEXT    NOT NULL DEFAULT (CURRENT_TIMESTAMP)
);

INSERT INTO users (email) VALUES ('rosa@example.com');

SELECT * FROM users;

عمود واحد إلزامي وبدون قيمة احتياطية، واثنان لهما قيم افتراضية. عملية INSERT كانت تحتاج فقط لتمرير email، وSQLite تكفّل بالباقي. هذه هي الفكرة كلها في مثال واحد، وبقية هذه الصفحة تتناول الحالات الطرفية فقط.

قيد NOT NULL في sqlite: ارفض NULL بدون استثناءات

قيد NOT NULL يفعل تماماً ما يوحي به اسمه. أي محاولة لإدخال NULL في العمود — سواء بإغفاله في جملة INSERT دون وجود قيمة افتراضية، أو بكتابة NULL صراحةً — ستفشل:

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

-- يفشل هذا: العنوان مفقود.
INSERT INTO posts (id) VALUES (1);

الرسالة الخطأ تظهر كالتالي:

خطأ في وقت التشغيل: فشل قيد NOT NULL: posts.title

النتيجة نفسها لو مرّرت NULL بشكل صريح:

INSERT INTO posts (id, title) VALUES (1, NULL);
-- خطأ وقت التشغيل: فشل قيد NOT NULL: posts.title

هذا هو العقد ببساطة. إذا كان العمود مطلوباً منطقياً، ضع عليه NOT NULL وستكون قد أغلقت الباب أمام فئة كاملة من الأخطاء — فلن يستطيع أي كود في التطبيق أن يُمرّر NULL إلى قاعدة البيانات خِلسةً.

القيمة الافتراضية DEFAULT في sqlite تُستخدم حين لا يُمرّر المستدعي قيمة

تعمل DEFAULT فقط عندما لا يذكر INSERT العمود إطلاقاً. أما إذا مرّرت NULL صراحةً، فلن تُنقذك أبداً:

CREATE TABLE tasks (
    id     INTEGER PRIMARY KEY,
    title  TEXT NOT NULL,
    status TEXT NOT NULL DEFAULT 'pending'
);

INSERT INTO tasks (title) VALUES ('كتابة التوثيق');
INSERT INTO tasks (title, status) VALUES ('إطلاق المنتج', 'done');

SELECT * FROM tasks;

عملية الإدخال الأولى تعتمد على القيمة الافتراضية، والثانية تتجاوزها. أما لو كتبت INSERT INTO tasks (title, status) VALUES ('x', NULL)، فسيظهر لك خطأ NOT NULL constraint failed — لأنك ذكرت اسم العمود صراحةً، وبالتالي لن تُفعَّل القيمة الافتراضية أصلاً.

هذا هو النموذج الذهني الذي يستحق أن تستوعبه جيداً للتفريق بين NOT NULL و DEFAULT في sqlite: الكلمة DEFAULT تملأ الفراغ في الأعمدة الغائبة فقط، بينما NOT NULL ترفض القيم الفارغة مهما كان مصدرها. هما خاصيتان مستقلتان تتكاملان بشكل جميل معاً.

القيم الافتراضية يمكن أن تكون تعبيرات (DEFAULT expression)

في الغالب تكون القيمة الافتراضية قيمة حرفية بسيطة (DEFAULT 0 أو DEFAULT '' أو DEFAULT 'pending')، لكن SQLite يسمح لك أيضاً بتمرير تعبير داخل أقواس. وهذه الطريقة المعتادة لتسجيل وقت إنشاء الصف تلقائياً، أو لتوليد معرّف عشوائي:

CREATE TABLE events (
    id         INTEGER PRIMARY KEY,
    name       TEXT NOT NULL,
    occurred   TEXT NOT NULL DEFAULT (CURRENT_TIMESTAMP),
    token      TEXT NOT NULL DEFAULT (lower(hex(randomblob(8))))
);

INSERT INTO events (name) VALUES ('تسجيل الدخول');
INSERT INTO events (name) VALUES ('تسجيل الخروج');

SELECT * FROM events;

بعض الأمور المهمة التي ينبغي معرفتها:

• يُحسب التعبير مع كل عملية إدراج، وليس مرة واحدة عند إنشاء الجدول. أي أن كل صف يحصل على طابعه الزمني الخاص ورمزه الخاص.
• CURRENT_TIMESTAMP وCURRENT_DATE وCURRENT_TIME هي الكلمات المفتاحية الثلاث الوحيدة التي لا تحتاج إلى أقواس. أما ما عداها فيلزمه الأقواس.
• لا يمكن للتعبير أن يشير إلى أعمدة أخرى أو استعلامات فرعية، بل يجب أن يكون مكتفياً بذاته.

إذا أردت أن يكون العمود اختيارياً لكن يُختم تلقائياً عند تمريره، احذف NOT NULL واحتفظ بالقيمة الافتراضية. أما إذا أردته إلزامياً ومختوماً تلقائياً في الوقت نفسه، فاستخدم الاثنين معاً.

استخدام DEFAULT NULL مسموح (وأحياناً يكون هو المقصود)

كتابة DEFAULT NULL تعادل عدم وضع قيمة افتراضية أصلاً، فالعمود يأخذ القيمة NULL حين لا تُمرّر له قيمة. لكن استخدامها مفيد حين تريد أن توضّح صراحةً في تعريف الجدول أن "لا قيمة" هي الحالة الابتدائية المقصودة:

CREATE TABLE profiles (
    id        INTEGER PRIMARY KEY,
    user_id   INTEGER NOT NULL,
    bio       TEXT DEFAULT NULL,
    avatar    TEXT
);

INSERT INTO profiles (user_id) VALUES (1);

SELECT * FROM profiles;

يتصرّف العمودان bio و avatar بنفس الطريقة هنا. أمّا DEFAULT NULL المكتوبة على bio فهي تعليق على هيئة كود — تُخبر كل من يقرأ مخطط الجدول أنّ غياب السيرة الذاتية حالة طبيعية متوقّعة، لا سهو من المطوّر.

إضافة NOT NULL إلى جدول موجود مسبقًا

هنا تبدأ الأمور تصبح مزعجة قليلًا. الأمر ALTER TABLE في sqlite محدود عمدًا — فلا يمكنك تنفيذ ALTER COLUMN ... SET NOT NULL كما تفعل في Postgres مثلًا. ما يمكنك فعله فعلًا يعتمد على ما إذا كان العمود موجودًا بالفعل أم لا.

بالنسبة لعمود جديد كليًّا، فإنّ ADD COLUMN ... NOT NULL يعمل بلا مشاكل، لكن يجب عليك توفير قيمة افتراضية — وإلّا فإنّ الصفوف الموجودة ستحتوي فجأةً على NULL داخل عمود NOT NULL، وهذا أمر مستحيل:

CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT NOT NULL);
INSERT INTO products (name) VALUES ('widget'), ('gizmo');

-- يعمل: الصفوف الموجودة تحصل على القيمة الافتراضية.
ALTER TABLE products ADD COLUMN price REAL NOT NULL DEFAULT 0;

SELECT * FROM products;

جرّب نفس الأمر لكن بدون قيمة DEFAULT، وسترى أنك ستحصل على خطأ:

ALTER TABLE products ADD COLUMN sku TEXT NOT NULL;
-- خطأ وقت التشغيل: لا يمكن إضافة عمود NOT NULL بقيمة افتراضية NULL

بالنسبة لعمود موجود مسبقاً، لا يوجد تعديل مباشر في مكانه. الحيلة المتعارف عليها هي ما يُسمى بـ"رقصة إعادة البناء": تُنشئ جدولاً جديداً بالقيد الذي تريده، ثم تنسخ البيانات إليه، تحذف الجدول القديم، وأخيراً تُعيد تسمية الجديد. سنتناول هذه الخطوات بالتفصيل في صفحة drop-and-alter-table — يكفي الآن أن تعرف أن هذا القيد حقيقي، وعليك أن تأخذه بعين الاعتبار عند تصميم مخططك من البداية.

مثال واقعي يجمع بين القيدين

معظم الجداول في بيئات الإنتاج تستخدم القيدين معاً لتُعبّر عن "ما يفترض التطبيق أنه صحيح دائماً":

CREATE TABLE orders (
    id          INTEGER PRIMARY KEY,
    customer    TEXT    NOT NULL,
    total_cents INTEGER NOT NULL DEFAULT 0,
    currency    TEXT    NOT NULL DEFAULT 'USD',
    status      TEXT    NOT NULL DEFAULT 'pending',
    created_at  TEXT    NOT NULL DEFAULT (CURRENT_TIMESTAMP),
    notes       TEXT
);

INSERT INTO orders (customer) VALUES ('Ada');
INSERT INTO orders (customer, total_cents, currency) VALUES ('Boris', 4999, 'EUR');

SELECT id, customer, total_cents, currency, status, created_at FROM orders;

اقرأ هذا السكيما من أوله لآخره، وستعرف ما الذي يفعله التطبيق دون أن تطّلع على سطر واحد من الكود. حقل customer إلزامي ولا يملك قيمة احتياطية — على من يستدعي الإدراج أن يعرف صاحب الطلب. أما المبلغ والعملة والحالة، فلكلٍّ منها قيمة افتراضية منطقية، بحيث ينتج عن أبسط عملية INSERT صفٌّ متكامل ومتسق. حقل notes اختياري. وحقل created_at تملؤه قاعدة البيانات نفسها، وهذا هو المكان الوحيد الذي يجب أن يُملأ فيه.

هذه هي الفائدة الحقيقية من قيود الأعمدة في sqlite — فهي تحوّل الافتراضات الذهنية إلى قواعد تفرضها قاعدة البيانات بنفسها.

أخطاء شائعة احذر منها

إليك قائمة قصيرة بأمور توقع كثيرًا من المطورين:

• تمرير NULL صراحةً يُلغي عمل DEFAULT. الجملة INSERT INTO t (col) VALUES (NULL) لن تستخدم القيمة الافتراضية. لا بدّ أن يكون العمود غائبًا كليًّا عن قائمة الأعمدة.
• القيم الافتراضية المبنية على تعابير تحتاج إلى أقواس. الصيغة DEFAULT CURRENT_TIMESTAMP تعمل (لأنها واحدة من ثلاث كلمات مفتاحية خاصة)، أما DEFAULT lower(hex(randomblob(8))) فلا تعمل — لا بدّ من تغليفها هكذا: DEFAULT (lower(hex(randomblob(8)))).
• NOT NULL لا يساوي رفض السلسلة الفارغة. القيمة '' نص صالح من نوع TEXT ولن تُطلق رسالة NOT NULL constraint failed. إن أردت منع السلاسل الفارغة أيضًا، فهذه مهمة قيد CHECK (في الصفحة التالية).
• ADD COLUMN ... NOT NULL يستلزم وجود DEFAULT بقيمة غير NULL. وبدون ذلك، يرفض SQLite تنفيذ التعديل.

الخطوة التالية: قيود CHECK

يغطّي NOT NULL وDEFAULT حالتَي "يجب أن تكون القيمة موجودة" و"املأها إن غابت". أما الطبقة التالية من التحقق — مثل "يجب أن تكون موجبة" أو "يجب أن تكون ضمن قائمة محددة" أو "تاريخ الانتهاء يجب أن يأتي بعد تاريخ البدء" — فيوفّرها SQLite عبر قيود CHECK، التي تتيح لك كتابة أي تعبير منطقي عشوائي يجب أن يحقّقه كل صف. هذا موضوع الصفحة التالية.