Entity Framework - تنفيذ الأمر Update-Database

-

Entity Framework Core - تنفيذ الأمر Update-Database

🧠 ما هو الأمر Update-Database؟

الأمر Update-Database هو أمر يستخدم لتطبيق كل التغييرات المسجلة في ملفات Migrations على قاعدة البيانات الفعلية.

بمعنى آخر: يقوم بقراءة ملفات Migration ➔ ثم ينفذ أوامر SQL اللازمة لإنشاء أو تعديل الجداول بناءً على آخر نسخة من الكود.

🛠️ الصيغة الأساسية للأمر


Update-Database

يمكن أيضًا تحديد اسم Migration معين إذا أردت التحديث حتى نقطة محددة: 


Update-Database -Migration MigrationName

🎯 ماذا يحدث عند تنفيذ Update-Database؟

  • EF Core يتصل بقاعدة البيانات المحددة في Connection String.
  • يتحقق من جدول خاص بإدارة Migrations يسمى __EFMigrationsHistory.
  • يحدد أي Migrations لم يتم تنفيذها بعد.
  • ينفذ أوامر SQL الناتجة عن ملفات الـ Migration على قاعدة البيانات.
  • يسجل أسماء Migrations التي تم تنفيذها داخل جدول __EFMigrationsHistory لتفادي تكرار التنفيذ لاحقًا.

👨‍💻 مثال عملي على Update-Database

بعد أن أنشأت Migration باسم InitialCreate (مثلاً لإنشاء جدول Products)، تنفذ الأمر: 


Update-Database

النتيجة:

  • يتم إنشاء قاعدة بيانات جديدة (لو لم تكن موجودة).
  • يتم إنشاء الجداول (مثل Products) حسب الكود داخل ملف Migration.
  • يتم تسجيل Migration باسم InitialCreate داخل جدول __EFMigrationsHistory.

🔍 متى تحتاج إلى تحديد Migration بالاسم؟

  • عندما ترغب بالرجوع لنسخة أقدم من قاعدة البيانات.
  • عندما تريد اختبار تحديث قاعدة البيانات حتى نقطة محددة بدون تنفيذ جميع Migrations.

Update-Database -Migration AddCategoryTable

هذا الأمر يجعل قاعدة البيانات تتوقف عند Migration اسمها AddCategoryTable.

⚡ ملاحظات إضافية

  • تأكد أن Connection String صحيحة قبل تنفيذ Update-Database.
  • لو لم تُنشئ أي Migration بعد ➔ Update-Database لن يقوم بأي شيء.
  • لو قاعدة البيانات غير موجودة ➔ سيتم إنشاؤ

تعليقات

إرسال تعليق

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

HTML - Text Formatting تنسيقات النص

-
تنسيقات النص في HTML (HTML Text Formatting) توفر HTML مجموعة من الوسوم الخاصة بتنسيق النصوص، مثل جعل النص عريض (Bold)، مائل (Italic)، تحته خط، مشطوب، وغيرها. ✅ أشهر وسوم التنسيق: الوسم الوصف <b> لجعل النص عريض بدون أهمية معنوية <strong> لجعل النص عريض مع دلالة على الأهمية <i> لجعل النص مائل بدون أهمية معنوية <em> لجعل النص مائل مع دلالة على التأكيد <mark> لتمييز النص بخلفية صفراء مثل التظليل <small> لجعل النص بحجم أصغر <del> لنص مشطوب <ins> لنص مضاف حديثًا <sub> لنص سفلي (H 2 O) <sup> لنص علوي (x 2 ) 🧪 أمثلة على تنسيق النصوص: <p>هذا نص <b>عريض</b> باستخدام وسم <b>.</p> <p>هذا نص <strong...
قراءة المزيد

1.1 SQL Introduction

-
SQL Introduction – مقدمة في SQL  ما هي SQL؟ SQL هي اختصار لـ Structured Query Language (لغة الاستعلام البنيوية). SQL تُستخدم للوصول إلى قواعد البيانات والتحكم فيها ( access and manipulate databases ). SQL تعتبر معيارًا معتمدًا من ANSI (المعهد القومي الأمريكي للمعايير).  ماذا يمكن أن تفعل SQL؟ SQL يمكنها تنفيذ الاستعلامات على قاعدة البيانات ( execute queries against a database ). SQL يمكنها استرجاع البيانات من قاعدة البيانات ( retrieve data from a database ). SQL يمكنها إدخال سجلات في قاعدة البيانات ( insert records in a database ). SQL يمكنها تحديث السجلات في قاعدة البيانات ( update records in a database ). SQL يمكنها حذف السجلات من قاعدة البيانات ( delete records from a database ). SQL يمكنها إنشاء قواعد بيانات جديدة ( create new databases ). SQL يمكنها إنشاء جداول جديدة داخل قاعدة البيانات ( create new tables in a database ). SQL يمكنها إنشاء إجراءات مخزنة ( stored procedures ) داخل قاعدة البيانات. SQL يمكنها إنشاء عروض...
قراءة المزيد

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، احتاجت مايكروسوفت إلى نسخة خفيفة وعصرية م...
قراءة المزيد