Entity Framework - العمل مع Migration History Table.

-

Entity Framework Core - العمل مع Migration History Table

🧠 ما هو Migration History Table؟

جدول __EFMigrationsHistory هو جدول خاص تقوم Entity Framework Core بإنشائه داخل قاعدة البيانات بشكل تلقائي. مهمة هذا الجدول:

  • تسجيل كل Migration تم تنفيذها بالفعل على قاعدة البيانات.
  • مساعدة EF Core في معرفة أي Migrations تم تنفيذها وأيها لم يتم بعد.
  • تسهيل التراجع أو التقدم في Migrations حسب الحاجة.

📄 شكل جدول __EFMigrationsHistory

الجدول يحتوي عادة على عمودين رئيسيين:

  • MigrationId: اسم الـ Migration المنفذة.
  • ProductVersion: نسخة EF Core التي استخدمت أثناء إنشاء هذه Migration.

مثال على محتويات هذا الجدول: 


+--------------------------------------+-------------------+
| MigrationId                         | ProductVersion     |
+--------------------------------------+-------------------+
| 20240427093000_InitialCreate         | 8.0.4             |
| 20240427101500_AddProductsTable      | 8.0.4             |
| 20240427113000_AddCategoriesTable    | 8.0.4             |
+--------------------------------------+-------------------+

🔗 ماذا يحدث أثناء تنفيذ Update-Database؟

عندما تنفذ Update-Database:

  • EF Core يقارن قائمة Migrations الموجودة في مشروعك مع السجلات داخل جدول __EFMigrationsHistory.
  • يحدد Migrations الجديدة التي لم تنفذ بعد.
  • ينفذ سكربتات SQL الخاصة بها.
  • يضيف سجلات جديدة إلى __EFMigrationsHistory لكل Migration تم تنفيذها.

👨‍💻 متى تحتاج التحقق من جدول __EFMigrationsHistory؟

  • عند مواجهة مشكلة أن بعض الجداول غير موجودة.
  • عند محاولة التراجع أو التقدم إلى Migration معينة ولم تعمل كما هو متوقع.
  • عند استكشاف أخطاء Migrations في بيئات الإنتاج أو الاختبار.

✅ يكفي تنفيذ استعلام SQL بسيط لرؤية حالة الجدول: 


SELECT * FROM __EFMigrationsHistory

⚡ ملاحظات مهمة

  • لا تعدل جدول __EFMigrationsHistory يدويًا إلا إذا كنت تعرف جيدًا ماذا تفعل (ممكن أن تسبب مشاكل تزامن خطيرة).
  • يجب أن يتطابق ما هو موجود في جدول __EFMigrationsHistory مع ملفات Migrations الموجودة في مشروعك.
  • يمكنك استخدام هذا الجدول لتحديد آخر نقطة تم الوصول إليها في تطوير قاعدة البيانات.

تعليقات

إرسال تعليق

المشاركات الشائعة من هذه المدونة

C# - Arrays

-
C# - المصفوفات (Arrays) المصفوفة (Array) هي بنية بيانات تُستخدم لتخزين مجموعة من القيم من نفس النوع في مكان واحد بالذاكرة، ويتم الوصول إلى العناصر باستخدام رقم الفهرس (Index). 🔹 كيفية تعريف مصفوفة: // تعريف مصفوفة وتعيين قيم ابتدائية int[] numbers = { 1, 2, 3, 4, 5 }; // الوصول إلى العنصر الأول Console.WriteLine(numbers[0]); // النتيجة: 1 💡 ملاحظات: الفهرس يبدأ من 0، أي أول عنصر هو numbers[0] . يمكنك استخدام حلقة for أو foreach للتكرار على المصفوفة. يجب تحديد نوع البيانات التي ستحتويها المصفوفة. 🧪 مثال آخر: string[] fruits = new string[3]; fruits[0] = \"تفاح\"; fruits[1] = \"موز\"; fruits[2] = \"عنب\"; foreach (string fruit in fruits) { Console.WriteLine(fruit); } 📌 في هذا المثال، أنشأنا مصفوفة من ثلاث عناصر ومررنا عليها باستخدام foreach .
قراءة المزيد

Entity Framework - ما هو ORM؟ ونبذة عن Dapper وNHibernate

-
Entity Framework - ما هو ORM؟ ونبذة عن Dapper وNHibernate ORM هي اختصار لـ Object-Relational Mapping ، وتعني "الربط الكائني العلاقي". ببساطة، هي تقنية تُستخدم لربط الكائنات (Objects) في الكود مع الجداول (Tables) في قاعدة البيانات. 🔹 لماذا نحتاج إلى ORM؟ بدون ORM، نحتاج إلى كتابة استعلامات SQL يدوية والتعامل مع الكائنات بأنفسنا. بينما ORM توفر لنا طبقة وسيطة تقوم بتحويل الكود الكائني إلى استعلامات SQL تلقائيًا، والعكس أيضًا. 🔹 مزايا ORM تسريع التطوير. تقليل كمية الكود المكتوب. سهولة التعامل مع البيانات بشكل كائني. دعم التحقق من النوع (Type Checking) في وقت البرمجة. 🔹 عيوب ORM أداء أقل من SQL اليدوي في العمليات المعقدة. بعض المرونة تضيع بسبب التجريد العالي. 🔸 مقارنة بين EF Core وDapper وNHibernate التقنية النوع السهولة الأداء الدعم والانتشار Entity Framework Core ORM كامل سهل ومتكامل مع .NET متوسط مرتفع (مدعوم من Microsoft) ...
قراءة المزيد

Entity Framework - مقدمة عن Entity Framework

-
مقدمة عن Entity Framework 📜 لمحة تاريخية عن Entity Framework - أول إصدار من Entity Framework ظهر سنة 2008 كجزء من .NET Framework. - كان اسمه الرسمي ببساطة "Entity Framework"، ويعمل على ربط التطبيقات مع قواعد بيانات SQL بطريقة برمجية. - Entity Framework وفر وقتها أسلوبين رئيسيين للعمل: Database First ➔ إنشاء الكود انطلاقًا من قاعدة بيانات موجودة. Model First ➔ إنشاء قاعدة البيانات انطلاقًا من نموذج (Model) مرسوم. ✅ مع الوقت تطورت EF وتم إضافة أسلوب جديد يسمى Code First الذي أصبح من أكثر الطرق استخدامًا اليوم. 🔗 إصدارات Entity Framework قبل EF Core Entity Framework 1.0 (2008) - الإصدار الأول وكان محدود الإمكانيات. Entity Framework 4.0 (2010) - تحسينات كبيرة ودعم أفضل لـ POCO classes. Entity Framework 5.0 و6.0 (2012-2013) - دعم مميزات متقدمة مثل Migrations وتحسين الأداء. 💡 ملاحظة: لم يكن هناك EF 2.0 أو EF 3.0 رسميًا. 🚀 لماذا تم تطوير Entity Framework Core؟ مع ظهور .NET Core، احتاجت مايكروسوفت إلى نسخة خفيفة وعصرية م...
قراءة المزيد