مشاركة عبر

قم بترقية أحد التطبيقات لاستخدام أحدث مكتبة لعميل قاعدة البيانات المرنة

  • مقالة

ينطبق على: قاعدة بيانات Azure SQL

تتوفر إصدارات جديدة من مكتبة عميل قاعدة بيانات مرنة من خلال NuGet وواجهة NuGet Package Manager في Visual Studio. تحتوي الترقيات على إصلاحات للأخطاء ودعم للإمكانيات الجديدة لمكتبة العميل.

للحصول على أحدث إصدار: انتقل إلى Microsoft.Azure.SqlDatabase.ElasticScale.Client.

أعد إنشاء تطبيقك باستخدام المكتبة الجديدة، بالإضافة إلى تغيير بيانات التعريف الحالية لـ Shard Map Manager المخزنة في قواعد البيانات الخاصة بك في Azure SQL Database لدعم الميزات الجديدة.

يضمن تنفيذ هذه الخطوات بالترتيب أن الإصدارات القديمة من مكتبة العميل لم تعد موجودة في بيئتك عند تحديث كائنات بيانات التعريف، ما يعني أنه لن يتم إنشاء كائنات بيانات التعريف القديمة بعد الترقية.

خطوات الترقية

1. قم بترقية تطبيقاتك. في Visual Studio، قم بتنزيل أحدث إصدار من مكتبة العميل والرجوع إليه في جميع مشاريع التطوير التي تستخدم المكتبة؛ ثم إعادة البناء والتوزيع.

  • في حل Visual Studio الخاص بك، حدد Tools -->NuGet Package Manager -->Manage NuGet Packages for Solution.
  • (Visual Studio 2013) في اللوحة اليسرى، حدد Updates، ثم حدد الزر Update في الحزمة Azure SQL Database Elastic Scale Client Library التي تظهر في النافذة.
  • (Visual Studio 2015) اضبط مربع التصفية على الترقية المتاحة. حدد الحزمة المراد تحديثها، وانقر فوق الزر Update.
  • (Visual Studio 2017) في الجزء العلوي من مربع الحوار، حدد Updates. حدد الحزمة المراد تحديثها، وانقر فوق الزر Update.
  • البناء والتوزيع.

2. قم بترقية البرامج النصية الخاصة بك. إذا كنت تستخدم البرامج النصية PowerShell لإدارة الأجزاء، فقم بتنزيل إصدار المكتبة الجديد وانسخه في الدليل الذي تنفذ منه البرامج النصية.

3. قم بترقية خدمة الدمج المنقسم. إذا كنت تستخدم أداة دمج تقسيم قاعدة البيانات المرنة لإعادة تنظيم البيانات المُقسمة، فقم بتنزيل أحدث إصدار من الأداة وتوزيعه. يمكن العثور على خطوات الترقية التفصيلية للخدمة هنا.

4. قم بترقية قواعد بيانات Shard Map Manager. قم بترقية بيانات التعريف التي تدعم خرائط Shard في Azure SQL Database. هناك طريقتان يمكنك من خلالهما تحقيق ذلك، باستخدام PowerShell أو #C. يتم عرض كلا الخيارين أدناه.

الخيار 1: ترقية بيانات التعريف باستخدام PowerShell

  1. قم بتنزيل أحدث أداة مساعدة لسطر الأوامر لـ NuGet من هنا واحفظها في مجلد.
  2. افتح موجه الأوامر، وانتقل إلى نفس المجلد، وأصدر الأمر: nuget install Microsoft.Azure.SqlDatabase.ElasticScale.Client
  3. انتقل إلى المجلد الفرعي الذي يحتوي على إصدار DLL للعميل الجديد الذي قمت بتنزيله للتو، على سبيل المثال: cd .\Microsoft.Azure.SqlDatabase.ElasticScale.Client.1.0.0\lib\net45
  4. قم بتنزيل البرنامج النصي لترقية عميل قاعدة البيانات المرنة من مركز البرامج النصية، واحفظه في نفس المجلد الذي يحتوي على مكتبة الارتباط الحيوي (DLL).
  5. من هذا المجلد، قم بتشغيل "PowerShell. \ Upgrade.ps1" من موجه الأوامر واتبع التعليمات.

الخيار 2: ترقية بيانات التعريف باستخدام #C

بدلاً من ذلك، قم بإنشاء تطبيق Visual Studio الذي يفتح ShardMapManager الخاص بك، ويتكرر عبر جميع الأجزاء، وينفذ ترقية بيانات التعريف عن طريق استدعاء الطريقتين UpgradeLocalStore وUpgradeGlobalStore كما في هذا المثال:

    ShardMapManager smm =
       ShardMapManagerFactory.GetSqlShardMapManager
       (connStr, ShardMapManagerLoadPolicy.Lazy);
    smm.UpgradeGlobalStore();

    foreach (ShardLocation loc in
     smm.GetDistinctShardLocations())
    {
       smm.UpgradeLocalStore(loc);
    }

يمكن تطبيق تقنيات ترقيات بيانات التعريف عدة مرات دون ضرر. على سبيل المثال، إذا قام إصدار أقدم للعميل بإنشاء جزء دون قصد بعد التحديث بالفعل، فيمكنك تشغيل الترقية مرة أخرى عبر جميع الأجزاء للتأكد من وجود أحدث إصدار من بيانات التعريف في جميع أنحاء البنية الأساسية الخاصة بك.

ملاحظة: تستمر الإصدارات الجديدة من مكتبة العميل التي تم نشرها حتى الآن في العمل مع الإصدارات السابقة من بيانات التعريف لـShard Map Manager على Azure SQL Database والعكس. ومع ذلك، للاستفادة من بعض الميزات الجديدة في أحدث عميل، يجب ترقية بيانات التعريف. لاحظ أن ترقيات بيانات التعريف لن تؤثر على أي بيانات مستخدم أو بيانات خاصة بالتطبيق، فقط الكائنات التي تم إنشاؤها واستخدامها بواسطة Shard Map Manager. وتستمر التطبيقات في العمل من خلال تسلسل الترقية الموضح أعلاه.

تاريخ إصدار عميل قاعدة البيانات المرنة

للحصول على محفوظات الإصدار، انتقل إلى Microsoft.Azure.SqlDatabase.ElasticScale.Client

الموارد الإضافية

ألم تستخدم أدوات قاعدة بيانات مرنة بعد؟ تحقق من ⁧⁩دليل بدء التشغيل⁩. في حالة وجود أسئلة، تواصل معنا على Microsoft Q&A وهي صفحة الأسئلة حول SQL Database ولطلبات الميزات، أضف أفكاراً جديدة أو صوّت للأفكار الموجودة في منتدى ملاحظات SQL Database.