JSON في SQLite

JSON in SQLite

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

JSON في SQLite

SQLite تدعم دوال JSON مثل json_extract. هذا مفيد للبيانات المرنة أو metadata صغيرة. لكن لا تجعل JSON بديلاً عن schema واضح للبيانات الأساسية. إذا كنت تستعلم عن الحقل كثيراً أو تفرض عليه قيوداً، غالباً يستحق عموداً حقيقياً.

استخدم JSON للملحقات أو الإعدادات التي لا تحتاج علاقات قوية. أما المال، الحالة، المفاتيح، والمخزون فمكانها أعمدة typed وقيود.

مثال عملي

query.sql

CREATE TABLE events (
  id INTEGER PRIMARY KEY,
  payload TEXT NOT NULL
);

INSERT INTO events (payload)
VALUES ('{"kind":"lesson_view","course":"sql"}');

SELECT json_extract(payload, '$.course') AS course
FROM events;

Output:

الاستعلام يستخرج course من JSON.

مشغّلا `->` و`->>` — SQLite 3.38+

SQLite 3.38 (صدرت يناير 2022) أضافت مشغّلَي -> و->> بديلاً أقصر لـjson_extract. PostgreSQL تدعمهما منذ 9.4 (2014).

query.sql

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

INSERT INTO users VALUES (1, '{"name":"Sara","city":"Riyadh"}');

-- الطريقة القديمة — تعمل على كل إصدارات SQLite:
SELECT json_extract(profile, '$.name') AS name_old FROM users;

-- الطريقة الحديثة (SQLite 3.38+ / 2022):
SELECT profile -> 'name'   AS name_json   FROM users;  -- يُرجع نص JSON محاط بعلامات اقتباس
SELECT profile ->> 'name'  AS name_scalar FROM users;  -- يُرجع قيمة نصية مباشرة (scalar)

Output:

الفرق بين -> و->>:

-> يُرجع القيمة كـJSON (نص محاط بـ" للنصوص، أرقام كأرقام JSON).
->> يُرجع القيمة كنوع SQL مناسب (TEXT، INTEGER، REAL، NULL).

للكود الإنتاجي في SQLite التوافقي (تشغيل على إصدارات أقدم من 3.38)، ابقَ مع json_extract. للمشاريع الجديدة على بيئة محكومة، ->> أكثر وضوحاً.

تحدي — Challenge

CREATE TABLE events (payload TEXT);
INSERT INTO events VALUES ('{"course":"sql"}');

-- استخرج course من JSON

JSON في SQLite

JSON في SQLite

مثال عملي

مشغّلا -> و->> — SQLite 3.38+

مشغّلا `->` و`->>` — SQLite 3.38+