حوّل JSON إلى استعلامات MySQL!

أدخل JSON لتحويله إلى عبارات CREATE TABLE و INSERT! يدعم MySQL, MariaDB.
JSON
النتيجة

حوّل JSON إلى استعلامات MySQL!

يفحص القيم في مصفوفة JSON، ويستنتج أنواع الأعمدة في MySQL/MariaDB، ويُنتج جملة CREATE TABLE إضافة إلى جملة INSERT واحدة تحوي كل الصفوف. الصق الناتج في عميل MySQL فيُنشأ الجدول ويُملأ دفعة واحدة.

يفيد حين تريد تحميل بيانات من API خارجي في جدول مؤقت وتجميعها بـ SQL، أو ملء قاعدة بيانات التطوير بصفوف اختبار.

طريقة الاستخدام

  1. الصق مصفوفة كائنات في خانة JSON. الكائن المفرد يعطي INSERT بصف واحد.
  2. أدخل اسم الجدول المراد إنشاؤه في اسم الجدول (الافتراضي my_table). يُحفظ الاسم في الرابط على شكل ?table=.
  3. تحقق من أنواع الأعمدة المستنتجة، وعدّل الأطوال أو الفهارس حيث يلزم، ثم شغّل SQL في MySQL Workbench أو DBeaver أو أداة mysql في سطر الأوامر.

مثال

المدخلات (JSON)
[
  { "id": 1, "email": "minji@example.com", "plan": "pro", "verified": true,
    "settings": { "lang": "ko" }, "joinedAt": "2024-03-01T09:30:00Z" },
  { "id": 2, "email": "tom@example.com", "plan": "free", "verified": false,
    "settings": null, "joinedAt": "2024-03-04T23:10:00Z" }
]
المخرجات (MySQL)
CREATE TABLE `members` (
  `id` INT NOT NULL,
  `email` VARCHAR(255) NOT NULL,
  `plan` VARCHAR(255) NOT NULL,
  `verified` TINYINT(1) NOT NULL,
  `settings` JSON NULL,
  `joinedAt` DATETIME NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

INSERT INTO `members` (`id`, `email`, `plan`, `verified`, `settings`, `joinedAt`) VALUES
  (1, 'minji@example.com', 'pro', 1, '{"lang":"ko"}', '2024-03-01 09:30:00'),
  (2, 'tom@example.com', 'free', 0, NULL, '2024-03-04 23:10:00');

أصبح verified من نوع TINYINT(1)، وsettings الذي يحوي كائنًا أصبح عمود JSON يسمح بـ NULL لأن أحد الصفوف كان فيه null. أُعيدت كتابة تواريخ ISO المنتهية بـ Z (UTC) بالصيغة '2024-03-01 09:30:00' التي يقبلها MySQL، وبما أن id عدد صحيح موجود في كل الصفوف فقد أصبح المفتاح الأساسي.

الميزات المدعومة

  • استنتاج الأنواع: القيم المنطقية → TINYINT(1)، والأعداد الصحيحة ضمن 32 بت → INT، والأكبر منها → BIGINT، والأعداد العشرية → DOUBLE، والكائنات والمصفوفات → JSON.
  • أنماط السلاسل النصية: 2024-01-02 09:00:00 أو ISO 8601 → DATETIME، و2024-01-02 → DATE، و09:30 → TIME، وأي شيء آخر → VARCHAR(255)، أو TEXT إن تجاوزت أي قيمة 255 حرفًا.
  • حين تختلف الصفوف، يفوز النوع الأوسع: عدد صحيح + عشري → DOUBLE، وتاريخ + تاريخ ووقت → DATETIME، وأي خليط آخر → VARCHAR(255).
  • يكون العمود NULL إن كان في أي صف null أو كان المفتاح غائبًا، وإلا فهو NOT NULL.
  • يُستخدم مفتاح id بوصفه PRIMARY KEY؛ وإن لم يوجد يُضاف عمود id BIGINT NOT NULL AUTO_INCREMENT.
  • تُحاط المعرّفات بعلامات backtick، وتُهرَّب ' و\ داخل السلاسل. وتُنشأ الجداول بـ ENGINE=InnoDB DEFAULT CHARSET=utf8mb4.

حالات الاستخدام

تجميع بيانات API باستخدام SQL

إذا كانت لديك سجلات دفع أو سجلات أحداث محفوظة كـ JSON من API، فتحميلها في جدول وتشغيل GROUP BY أسرع غالبًا من كتابة سكربت.

بيانات اختبار لقواعد بيانات التطوير والـ staging

JSON من مولّد البيانات الوهمية أو استجابة ملتقطة من بيئة الإنتاج تصبح جمل INSERT لاختبارات الترحيل أو لتطوير الواجهة.

ملاحظات وقيود

  • أسماء الأعمدة هي مفاتيح JSON كما هي؛ وصيغة camelCase مثل joinedAt لا تُحوَّل إلى snake_case.
  • لا تُفصل الكائنات المتداخلة في جداول مستقلة (normalization)؛ بل توضع في عمود JSON واحد.
  • لا يُستنتج طول VARCHAR(255) ولا الفهارس ولا قيود UNIQUE ولا دقة DECIMAL. لأعمدة المبالغ المالية يُنصح بتغيير DOUBLE إلى DECIMAL.
  • إذا احتوى id على null، يُنشأ الجدول دون مفتاح أساسي.
  • التواريخ والأوقات ذات المنطقة الزمنية تُخزَّن بعد تحويلها إلى UTC؛ عدّلها بنفسك إن احتجت إلى قيم بالتوقيت المحلي.
  • كل الصفوف تدخل في جملة INSERT واحدة، لذا قد تصطدم عشرات الآلاف من الصفوف بحد max_allowed_packet في الخادم.

الأسئلة الشائعة

هل يعمل الناتج على PostgreSQL أو SQLite؟

ليس دون تعديل: فهو يستخدم صيغة MySQL مثل المعرّفات بين علامات backtick وENGINE=InnoDB وTINYINT(1) وAUTO_INCREMENT. استبدل علامات backtick بعلامات اقتباس مزدوجة وAUTO_INCREMENT بـ GENERATED ... AS IDENTITY أو ما يعادله.

لماذا TINYINT(1) بدلًا من BOOLEAN؟

في MySQL، BOOLEAN مجرد اسم بديل لـ TINYINT(1). تُدرج القيم على شكل 1/0، ويطابق اسم النوع ما تُظهره ملفات التفريغ (dumps) والـ ORMs.

هل يعمل عمود JSON على الخوادم القديمة؟

النوع JSON متوفر منذ MySQL 5.7.8 وMariaDB 10.2 (حيث هو اسم بديل لـ LONGTEXT). على أي إصدار أقدم، غيّره إلى TEXT.