كيف تعمل مكتبة Sequelize ؟

عند استخدام Sequelize، هناك طريقتان أساسيتان لإنشاء وإدارة قاعدة البيانات والجداول: استخدام عمليات الترحيل (Migrations) والنماذج (Models) مع المزامنة (Sync).

1. عمليات الترحيل (Migrations):

توفر عمليات الترحيل طريقة لإدارة تغييرات بنية قاعدة البيانات بمرور الوقت بطريقة يمكن تتبعها.

يمكنك استخدام عمليات الترحيل لإنشاء الجداول وتعديلها وحذفها، بالإضافة إلى إضافة الفهارس والقيود.

2. النماذج (Models) مع المزامنة (Sync):

النماذج تعبر عن الجداول في قاعدة البيانات. يمكن استخدام المزامنة (Sync) لإنشاء الجداول بناءً على تعريف النماذج.

يمكن استخدام sequelize.sync() لإنشاء الجداول إذا لم تكن موجودة، أو تعديلها بناءً على تغييرات النماذج.

مثال على استخدام Sequelize مع Migrations و Models

1. نموذج المستخدم (User model):

'use strict';
module.exports = (sequelize, DataTypes) => {
  const User = sequelize.define('User', {
    username: {
      type: DataTypes.STRING,
      allowNull: false,
      unique: true
    },
    password: {
      type: DataTypes.STRING,
      allowNull: false
    },
    email: {
      type: DataTypes.STRING,
      allowNull: false,
      unique: true
    }
  }, {});
  
  User.associate = function(models) {
    User.hasMany(models.Post);
  };
  
  return User;
};

2. نموذج المنشور (Post model): 

'use strict';
module.exports = (sequelize, DataTypes) => {
  const Post = sequelize.define('Post', {
    title: {
      type: DataTypes.STRING,
      allowNull: false
    },
    content: {
      type: DataTypes.TEXT,
      allowNull: false
    },
    userId: {
      type: DataTypes.INTEGER,
      allowNull: false,
      references: {
        model: 'Users',
        key: 'id'
      }
    }
  }, {});
  
  Post.associate = function(models) {
    Post.belongsTo(models.User);
  };
  
  return Post;
};

3. عملية الترحيل لإنشاء جدول المستخدمين (User Migration): 

'use strict';
module.exports = {
  up: (queryInterface, Sequelize) => {
    return queryInterface.createTable('Users', {
      id: {
        allowNull: false,
        autoIncrement: true,
        primaryKey: true,
        type: Sequelize.INTEGER
      },
      username: {
        allowNull: false,
        type: Sequelize.STRING,
        unique: true
      },
      password: {
        allowNull: false,
        type: Sequelize.STRING
      },
      email: {
        allowNull: false,
        type: Sequelize.STRING,
        unique: true
      },
      createdAt: {
        allowNull: false,
        type: Sequelize.DATE
      },
      updatedAt: {
        allowNull: false,
        type: Sequelize.DATE
      }
    });
  },
  down: (queryInterface, Sequelize) => {
    return queryInterface.dropTable('Users');
  }
};

4. عملية الترحيل لإنشاء جدول المنشورات (Post Migration): 

'use strict';
module.exports = {
  up: (queryInterface, Sequelize) => {
    return queryInterface.createTable('Posts', {
      id: {
        allowNull: false,
        autoIncrement: true,
        primaryKey: true,
        type: Sequelize.INTEGER
      },
      title: {
        allowNull: false,
        type: Sequelize.STRING
      },
      content: {
        allowNull: false,
        type: Sequelize.TEXT
      },
      userId: {
        allowNull: false,
        type: Sequelize.INTEGER,
        references: {
          model: 'Users',
          key: 'id'
        },
        onUpdate: 'CASCADE',
        onDelete: 'SET NULL'
      },
      createdAt: {
        allowNull: false,
        type: Sequelize.DATE
      },
      updatedAt: {
        allowNull: false,
        type: Sequelize.DATE
      }
    });
  },
  down: (queryInterface, Sequelize) => {
    return queryInterface.dropTable('Posts');
  }
};

من الجيد تحديد القيود مثل عدم السماح بالقيم الفارغة (not null) والفريدة (unique) في النماذج (Models) بالإضافة إلى عمليات الترحيل (Migrations) لضمان التكامل بين قاعدة البيانات والنموذج. سأوضح كيفية القيام بذلك وكيفية إضافة المفتاح الخارجي يدويًا في الترحيلات.

تحديد القيود في النموذج (Model)

لتحديد أن اسم المستخدم والبريد الإلكتروني لا يمكن أن يكونا فارغين ويجب أن يكونا فريدين، يمكنك القيام بذلك في تعريف النموذج كما يلي: 

'use strict';
module.exports = (sequelize, DataTypes) => {
  const User = sequelize.define('User', {
    username: {
      type: DataTypes.STRING,
      allowNull: false,
      unique: true
    },
    password: {
      type: DataTypes.STRING,
      allowNull: false
    },
    email: {
      type: DataTypes.STRING,
      allowNull: false,
      unique: true
    }
  }, {});
  
  User.associate = function(models) {
    User.hasMany(models.Post);
  };
  
  return User;
};

إضافة المفتاح الخارجي يدويًا في الترحيل (Migration)

يمكنك إضافة المفتاح الخارجي يدويًا عند إنشاء جدول المنشورات كما يلي: 

'use strict';
module.exports = {
  up: (queryInterface, Sequelize) => {
    return queryInterface.createTable('Posts', {
      id: {
        allowNull: false,
        autoIncrement: true,
        primaryKey: true,
        type: Sequelize.INTEGER
      },
      title: {
        allowNull: false,
        type: Sequelize.STRING
      },
      content: {
        allowNull: false,
        type: Sequelize.TEXT
      },
      userId: {
        allowNull: false,
        type: Sequelize.INTEGER,
        references: {
          model: 'Users',
          key: 'id'
        },
        onUpdate: 'CASCADE',
        onDelete: 'SET NULL'
      },
      createdAt: {
        allowNull: false,
        type: Sequelize.DATE
      },
      updatedAt: {
        allowNull: false,
        type: Sequelize.DATE
      }
    });
  },
  down: (queryInterface, Sequelize) => {
    return queryInterface.dropTable('Posts');
  }
};

نموذج المنشور (Post Model)

يمكنك أيضاً تحديد المفتاح الخارجي في نموذج المنشور:

'use strict';
module.exports = (sequelize, DataTypes) => {
  const Post = sequelize.define('Post', {
    title: {
      type: DataTypes.STRING,
      allowNull: false
    },
    content: {
      type: DataTypes.TEXT,
      allowNull: false
    },
    userId: {
      type: DataTypes.INTEGER,
      allowNull: false
    }
  }, {});
  
  Post.associate = function(models) {
    Post.belongsTo(models.User);
  };
  
  return Post;
};

تشغيل الترحيلات

لتنفيذ الترحيلات وإنشاء الجداول مع القيود والمفاتيح الخارجية، يمكنك استخدام الأوامر التالية:

npx sequelize-cli db:migrate