مشاركة عبر

ترقية إصدار واجهة برمجة التطبيقات من Azure Cosmos DB لحساب MongoDB

  • مقالة

ينطبق على: MongoDB

توضح هذه المقالة كيفية ترقية إصدار واجهة برمجة التطبيقات الخاص بواجهة برمجة تطبيقات Azure Cosmos DB لحساب MongoDB. بعد الترقية، يمكنك استخدام أحدث الوظائف في واجهة برمجة تطبيقات Azure Cosmos DB ل MongoDB. لا تؤدي عملية الترقية إلى مقاطعة توفر حسابك ولا تستهلك وحدة/وحدات الطلب أو تقلل من سعة قاعدة البيانات في أي وقت. لا تؤثر هذه العملية على البيانات أو الفهارس الموجودة.

عند الترقية إلى إصدار API جديد، ابدأ بالتطوير/الاختبار لأحمال العمل قبل ترقية أحمال عمل الإنتاج. من المهم ترقية عملائك إلى إصدار متوافق مع إصدار واجهة برمجة التطبيقات الذي تقوم بالترقية إليه قبل ترقية Azure Cosmos DB لحساب MongoDB.

تحذير

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

ترقية الإصدار الخاص بك

  1. قم بتسجيل الدخول إلى مدخل Azure.

  2. انتقل إلى Azure Cosmos DB لحساب MongoDB الخاص بك. افتح جزء نظرة عامة وتحقق من أن إصدار الخادم الحالي هو إما 3.2 أو 3.6.

    لقطة شاشة لكيفية التحقق من الإصدار الحالي لحساب MongoDB الخاص بك من مدخل Microsoft Azure.

  3. من القائمة اليمنى، افتح الجزء Features. يعرض هذا الجزء ميزات مستوى الحساب المتوفرة لحساب قاعدة البيانات.

  4. حدد الصف Upgrade MongoDB server version. إذا لم تشاهد هذا الخيار، فقد لا يكون حسابك مؤهلاً لهذه الترقية. تقديم تذكرة دعم إذا كان الأمر كذلك.

    لقطة شاشة لصفحة الميزات إلى 0 ترقية حسابك.

  5. راجع المعلومات المعروضة حول الترقية. حدد Set server version to 4.2 (أو 4.0 أو 3.6 حسب إصدارك الحالي).

    لقطة شاشة لإرشادات الترقية وخيار الترقية المحدد.

  6. بعد بدء الترقية، تظهر قائمة الميزة باللون الرمادي، ويتم تعيين الحالة إلى معلق. تستغرق عملية الترقية حوالي 15 دقيقة لإكمالها. لا تؤثر هذه العملية على الوظائف أو العمليات الموجودة لحساب قاعدة البيانات. بعد اكتمالها، ستُظهر حالة تحديث إصدار خادم MongoDB الإصدار الذي تمت ترقيته. اتصل بالدعم إذا كانت هناك مشكلة في معالجة طلبك.

  7. فيما يلي بعض الاعتبارات بعد ترقية حسابك:

    1. إذا قمت بالترقية من 3.2، فعد إلى جزء النظرة العامة، وانسخ سلسلة الاتصال الجديدة لاستخدامها في التطبيق الخاص بك. لا تتم مقاطعة سلسلة الاتصال القديمة التي تعمل 3.2. لضمان تجربة متناسقة، يجب أن تستخدم جميع التطبيقات نقطة النهاية الجديدة.

    2. إذا قمت بالترقية من 3.6، تتم ترقية سلسلة الاتصال الموجودة إلى الإصدار المحدد ويجب أن يستمر استخدامها.

هام

عند الترقية من 3.2، سيتم تحديث لاحقة نقطة نهاية حساب قاعدة البيانات إلى التنسيق التالي: <your_database_account_name>.mongo.cosmos.azure.com. قد يكون لنقطة النهاية هذه اختلافات طفيفة إذا تم إنشاء حسابك في سحابة Azure السيادية أو الحكومية أو المقيدة.

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

الرجوع إلى إصدارك

يمكنك أيضا تخفيض حسابك إلى 4.0 أو 3.6 عبر نفس الخطوات في قسم ترقية الإصدار الخاص بك.

  1. إذا قمت بالترقية من 3.2 إلى وترغب في الرجوع إلى الإصدار 3.2، فارجع إلى استخدام سلسلة الاتصال السابق (3.2) مع المضيف accountname.documents.azure.com، والذي يظل نشطا بعد الترقية الذي يعمل بالإصدار 3.2.

  2. تغيير سلسلة الاتصال في التطبيق الخاص بك.

المحتوى ذو الصلة