أنواع البيانات في SQLite: شرح Type Affinity

الـ Affinity مجرد تفضيل وليس قاعدة صارمة

من المعروف أن SQLite يعتمد على الكتابة الديناميكية (dynamic typing). فكل قيمة تحمل معها فئة التخزين الخاصة بها (NULL, INTEGER, REAL, TEXT, BLOB)، والنوع المُعلَن للعمود لا يفرض قيوداً صارمة على ما يمكن تخزينه فيه. كل ما يفعله النوع المُعلَن هو منح العمود ما يُسمى بـ type affinity — أي فئة تخزين مُفضَّلة يحاول SQLite تحويل القيم الواردة إليها.

شاهد ما يحدث عندما لا يكفي الـ affinity لمنع عدم تطابق الأنواع:

CREATE TABLE items (
    id INTEGER,
    name TEXT
);

INSERT INTO items VALUES (1, 'تفاحة');
INSERT INTO items VALUES ('two', 'موزة');

SELECT id, typeof(id), name FROM items;

الصف الثاني يخزّن النص 'two' داخل عمود من نوع INTEGER. حاول SQLite تحويل 'two' إلى رقم، لكنه فشل (لأنه ليس رقمًا أصلًا)، فخزّنه كـ TEXT كما هو. الدالة typeof() تكشف لك فئة التخزين الفعلية لكل قيمة — وهي لا تطابق دائمًا ما أعلنته في تعريف العمود.

هذا السلوك يفاجئ القادمين من Postgres أو MySQL، لكنه مقصود في تصميم SQLite.

أنواع الـ Affinity الخمسة في SQLite

كل عمود في جدول غير STRICT يأخذ واحدًا فقط من هذه الأنواع:

• TEXT — يُفضّل تخزين النصوص.
• NUMERIC — يُفضّل الأرقام، لكنه يقبل النصوص إذا تعذّر التحويل.
• INTEGER — مثل NUMERIC، لكنه يخزّن القيم التي لا تحتوي على جزء عشري كأعداد صحيحة.
• REAL — يُفضّل الأرقام ذات الفاصلة العائمة.
• BLOB — بلا تفضيل، يخزّن ما تعطيه له كما هو.

يُطلق على الـ BLOB affinity أيضًا اسم "بدون affinity" — وهو ما تحصل عليه عندما لا تحدّد نوعًا للعمود إطلاقًا.

CREATE TABLE samples (
    a,                 -- ألفة BLOB (لم يُعلَن أي نوع)
    b TEXT,            -- نص
    c INTEGER,         -- عدد صحيح
    d REAL,            -- عدد حقيقي
    e NUMERIC          -- عددي
);

INSERT INTO samples VALUES ('42', '42', '42', '42', '42');
SELECT typeof(a), typeof(b), typeof(c), typeof(d), typeof(e) FROM samples;

نفس المُدخَل — السلسلة '42' — لكنه يُخزَّن بخمسة أنواع مختلفة. كل عمود حوّل القيمة (أو لم يحوّلها) حسب الـ affinity الخاص به.

كيف يختار SQLite الـ affinity من تعريف العمود

هنا تكمن النقطة التي تُربك الكثيرين: SQLite لا يملك قائمة ثابتة بالأنواع "المعتمدة". تستطيع أن تكتب أي شيء تقريبًا بعد اسم العمود، وسيستنتج SQLite الـ affinity بالبحث عن سلاسل فرعية داخل النص الذي كتبته، وفق هذا الترتيب:

1. يحتوي على INT ← INTEGER
2. يحتوي على CHAR أو CLOB أو TEXT ← TEXT
3. يحتوي على BLOB، أو لا يوجد نوع أصلًا ← BLOB
4. يحتوي على REAL أو FLOA أو DOUB ← REAL
5. أي شيء آخر ← NUMERIC

هذه هي الخوارزمية كاملةً. وهي تفسّر الكثير من السلوك الغريب الذي قد تصادفه:

CREATE TABLE quirks (
    a VARCHAR(255),       -- TEXT (يحتوي على CHAR)
    b BIGINT,             -- INTEGER (يحتوي على INT)
    c DOUBLE PRECISION,   -- REAL (يحتوي على DOUB)
    d DECIMAL(10,2),      -- NUMERIC (لا يطابق أيًا مما سبق)
    e BOOLEAN,            -- NUMERIC (لا يطابق أيًا مما سبق)
    f DATETIME,           -- NUMERIC (لا يطابق أيًا مما سبق)
    g FLOATING_POINTS,    -- INTEGER (يحتوي على INT — مفاجأة!)
    h GIBBERISH           -- NUMERIC (لا يطابق أيًا مما سبق)
);

SELECT name, type FROM pragma_table_info('quirks');

FLOATING_POINTS يتحول إلى INTEGER لأن السلسلة الفرعية INT موجودة داخل كلمة POINTS. القاعدة الأولى المطابِقة هي التي تفوز، بالترتيب من الأعلى إلى الأسفل. ولهذا السبب، فإن نسخ الأنواع من قاعدة بيانات أخرى دون تدقيق قد يعطيك نتيجة مختلفة عمّا تتوقع.

آلية عمل type affinity عند الإدراج

تظهر أهمية الـ type affinity بوضوح عندما يقرر SQLite ما إذا كان سيحوّل القيمة التي أدخلتها أم سيخزّنها كما هي. والقواعد كالتالي:

• الـ affinity من نوع TEXT: الأرقام وقيم BLOB تُحوَّل إلى نص.
• الـ affinities من نوع NUMERIC و**INTEGER** و**REAL**: النص الذي يبدو كرقم يُحوَّل إلى رقم، أما النص الذي لا يمثّل رقمًا فيبقى نصًا كما هو.
• الـ affinity من نوع BLOB: لا يحدث أي تحويل على الإطلاق.

CREATE TABLE conv (
    n NUMERIC,
    t TEXT,
    b BLOB
);

INSERT INTO conv VALUES ('123', 456, 789);
INSERT INTO conv VALUES ('12.5', 7.5, 'hello');
INSERT INTO conv VALUES ('hello', 'world', 'world');

SELECT n, typeof(n), t, typeof(t), b, typeof(b) FROM conv;

صفًّا بصف:

• القيمة '123' في عمود من نوع NUMERIC تتحوّل إلى العدد الصحيح 123، لأن التحويل من نص إلى رقم نجح دون أي فقد.
• القيمة '12.5' تتحوّل إلى العدد العشري 12.5.
• القيمة 'hello' في عمود NUMERIC تبقى نصًّا كما هي، إذ لا يوجد رقم يمكن تحويلها إليه.
• عمود TEXT يُحوّل الأرقام إلى صيغتها النصية.
• أما عمود BLOB فيخزّن كل قيمة تمامًا كما أُدخلت، مع نوعها الأصلي.

الفرق الدقيق بين INTEGER و REAL

تتصرّف خاصية INTEGER affinity بشكل شبه مطابق لـ NUMERIC، مع فارق واحد: أي قيمة مثل 3.0 لا تحتوي على جزء عشري حقيقي يتم تخزينها كعدد صحيح 3 توفيرًا للمساحة.

CREATE TABLE nums (
    i INTEGER,
    n NUMERIC
);

INSERT INTO nums VALUES (3.0, 3.0);
INSERT INTO nums VALUES (3.5, 3.5);

SELECT i, typeof(i), n, typeof(n) FROM nums;

3.0 يُخزَّن كـ INTEGER في العمودين — هذا التحسين يحصل مع NUMERIC أيضاً. أما 3.5 فيحتفظ بجزئه العشري ويبقى REAL. الخلاصة: لا تعتمد على typeof() لتعرف هل العمود مُعرَّف كـ INTEGER أو REAL، فهو يخبرك بما هو مخزَّن فعلياً، وقد يختلف من صفّ لآخر.

متى تسبّب لك الـ type affinity مشاكل؟

هذه المرونة مريحة... إلى أن تنقلب عليك. في الكود الحقيقي تظهر مشكلتان شائعتان:

1. تسرّب بيانات فاسدة. لو كان في تطبيقك خطأ يُرسل 'N/A' إلى عمود من نوع INTEGER، فإن SQLite سيخزّنها دون اعتراض. وبعدها أي استعلام يُجري عمليات حسابية على العمود سيرجع نتائج غريبة أو NULL. بدون أي خطأ ولا تحذير، فقط فساد صامت في البيانات.

2. المقارنات تتصرّف بشكل غير متوقَّع. عمليات الترتيب وفحص المساواة تعامل القيم باختلاف فئة التخزين الخاصة بها معاملةً مختلفة:

CREATE TABLE mixed (val INTEGER);
INSERT INTO mixed VALUES (10), (2), ('100'), ('20'), (3);

SELECT val, typeof(val) FROM mixed ORDER BY val;

الأعداد الصحيحة تُرتَّب رقمياً، ثم تأتي القيم النصية مرتَّبة أبجدياً — وتظهر بعد كل الأرقام. فتحصل على 2, 3, 10 (الأعداد بالترتيب الرقمي)، ثم '20', '100' (النصوص بالترتيب الأبجدي). وهذا غالباً ليس ما تتوقّعه.

إذا كنت تتحكّم في عمليات الإدخال وتتحقّق من القيم جيداً، فالجداول العادية تفي بالغرض. أما إذا لم تكن تتحكّم بها — أو كنت ببساطة تريد من قاعدة البيانات أن تفرض الأنواع نيابةً عنك — فهناك خيار أفضل.

الخطوة التالية: جداول STRICT

أضافت SQLite في الإصدار 3.37 جداول STRICT، التي تُعطّل سلوك type affinity وترفض أي قيمة لا تطابق النوع المُعلَن. هذه الجداول تمنحك سلوك dynamic typing الافتراضي حين تريده، وتفرض الأنواع بأسلوب Postgres حين لا تريده. وهذا موضوع الصفحة التالية.