تحويل JSON إلى Sequelize (JavaScript) Schema!

أدخل JSON وحوله إلى Sequelize (JavaScript) Schema! يدعم Sequelize sequelize.define, DataTypes, Node.js, Express.
JSON
النتيجة
 

تحويل JSON إلى Sequelize (JavaScript) Schema!

يحوّل صفوف JSON إلى نموذج Sequelize معرَّف بـ sequelize.define(). يحصل كل عمود على نوع من DataTypes وعلى علامة allowNull، ويتضمن ملف CommonJS المفتاح الأساسي id وtableName وtimestamps: false.

يناسب خادم Express يعمل على MySQL أو PostgreSQL حين تكون لديك صفوف نموذجية لجدول ما (جدول بيانات مُصدَّر إلى JSON، أو استجابة API خارجي) لكن دون تعريف نموذج بعد.

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

  1. الصق صفًا واحدًا ككائن أو عدة صفوف كمصفوفة. إن كانت بعض الأعمدة فارغة في بعض الصفوف، فالصق عدة صفوف ليخرج allowNull صحيحًا.
  2. أدخل اسم النموذج (الافتراضي MyModel)؛ يُستخدم في define وكاسم للمتغير المُصدَّر معًا.
  3. يفترض الناتج أن require('../db') يُرجع نسخة Sequelize الخاصة بك. عدّل ذلك المسار ليشير إلى وحدة الاتصال لديك، ثم احفظ الملف تحت models/.

مثال

المدخلات (JSON)
[
  { "email": "kim@example.com", "nickname": "kim", "age": 31, "marketing_opt_in": true, "joined_at": "2023-11-02" },
  { "email": "ana@example.com", "nickname": "ana", "age": null, "marketing_opt_in": false, "joined_at": "2024-01-15" }
]
المخرجات (Sequelize (JavaScript))
const { Sequelize, DataTypes } = require('sequelize');
const sequelize = require('../db');

const Member = sequelize.define('Member', {
  id: {
    type: DataTypes.INTEGER,
    autoIncrement: true,
    primaryKey: true
  },
  email: {
    type: DataTypes.STRING,
    allowNull: false
  },
  nickname: {
    type: DataTypes.STRING,
    allowNull: false
  },
  age: {
    type: DataTypes.INTEGER,
    allowNull: true
  },
  marketingOptIn: {
    type: DataTypes.BOOLEAN,
    allowNull: false,
    field: 'marketing_opt_in'
  },
  joinedAt: {
    type: DataTypes.DATEONLY,
    allowNull: false,
    field: 'joined_at'
  }
}, {
  tableName: 'MEMBER',
  timestamps: false
});

module.exports = Member;

قيمة age لدى العضو الثاني null، لذا لا يحصل على allowNull: true إلا age. ويحوي joined_at تواريخ دون وقت، فيصبح DataTypes.DATEONLY، وترتبط السمة joinedAt بالعمود الحقيقي عبر field: 'joined_at'.

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

  • أنواع الأعمدة: الأعداد الصحيحة → INTEGER (وBIGINT بعد 2,147,483,647)، والعشرية → DOUBLE، والمنطقية → BOOLEAN، وYYYY-MM-DD → DATEONLY، والتاريخ مع الوقت → DATE، والكائنات والمصفوفات → JSON، والسلاسل الأخرى → STRING.
  • لا تصبح أعمدة رقمية إلا أرقام JSON الحقيقية؛ أما "01234" المقتبس فيبقى STRING.
  • السمات بصيغة camelCase، وكلما اختلفت عن المفتاح يربط field: 'marketing_opt_in' السمة باسم العمود الأصلي.
  • مفتاح id في JSON الخاص بك يصبح المفتاح الأساسي بدلًا من عمود ثانٍ: الأعداد الصحيحة تحصل على autoIncrement، والسلاسل مثل UUID تصبح مفتاح STRING عاديًا. وإن لم يوجد، يُضاف id من نوع INTEGER بزيادة تلقائية.
  • القيم null أو الغائبة في أي صف تضبط allowNull: true؛ ولا تؤثر في نوع العمود.
  • النموذج المسمّى UserProfile يحصل على tableName: 'USER_PROFILE' وtimestamps: false، فلا تُتوقع أعمدة createdAt/updatedAt.

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

ربط نموذج بجدول موجود

صدّر نتيجة SELECT ... LIMIT 5 من عميل قاعدة البيانات بصيغة JSON والصقها لتحصل على كود define وقد انعكس فيه ترتيب الأعمدة وقابليتها لـ null وأسماؤها بصيغة snake_case. مفيد لربط جدول واحد دون تثبيت sequelize-auto.

إنشاء جداول اختبار بـ `sequelize.sync()`

أثناء بناء النموذج الأولي، ابنِ نموذجًا من JSON نموذجي، وشغّل sync() لإنشاء الجدول في SQLite أو MySQL محليًا، ثم حمّل بيانات seed بـ bulkCreate.

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

  • DataTypes.STRING افتراضيًا VARCHAR(255)؛ بدّل النصوص الطويلة إلى DataTypes.TEXT.
  • قيم DATEONLY تعود كسلاسل نصية '2023-11-02' لا ككائنات Date.
  • DataTypes.JSON يعمل على MySQL وMariaDB وPostgreSQL وSQLite لكن ليس على MSSQL؛ وعلى PostgreSQL يكون DataTypes.JSONB عادةً الخيار الأفضل.
  • tableName بأحرف كبيرة (MEMBER). في البيئات الحساسة لحالة الأحرف مثل PostgreSQL أو MySQL على Linux يجب أن يطابق اسم الجدول الحقيقي تمامًا.
  • للمبالغ المالية، استبدل DOUBLE بـ DataTypes.DECIMAL(12, 2) لتجنّب أخطاء تقريب الفاصلة العائمة.

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

هل يمكنني الحصول على أسلوب Model.init() المبني على الأصناف؟

هذه الصفحة تولّد sequelize.define() فقط. كائن السمات متطابق في الأسلوبين، لذا عرّف class Member extends Model {} ومرّر الكائن نفسه إلى Member.init(attributes, { sequelize, tableName: 'MEMBER' }). ولـ TypeScript استخدم صفحة JSON → Sequelize (TS).

العمود allowNull: false، لكن السلاسل الفارغة ما زالت تدخل.

لا يمنع allowNull إلا قيمة NULL في SQL. لرفض السلاسل الفارغة أيضًا، أضف validate: { notEmpty: true } إلى السمة.

لماذا field على كل سمة بدلًا من underscored: true؟

لا يفعل underscored إلا التحويل من camelCase إلى snake_case، فلا يستطيع ربط مفاتيح مثل home-url أو أعمدة مكتوبة بـ camelCase أصلًا. أما field الصريح فيُبقي مفتاح JSON نفسه اسمًا للعمود أيًّا كان أسلوبه.