تكوين Azure Cosmos DB لإمكانيات حساب MongoDB

ينطبق على: MongoDB

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

المتطلبات الأساسية

• حساب Azure مع اشتراك نشط. أنشئ حساباً مجاناً.
• Azure Cosmos DB لحساب MongoDB. إنشاء واجهة برمجة تطبيقات لحساب MongoDB.
• الوصول إلى مدخل Azure CLI أو Azure. تغيير القدرات عبر Azure Resource Manager غير مدعوم.

القدرات المتوفرة

القدرة	‏‏الوصف	ازاله
DisableRateLimitingResponses	يسمح ل Mongo API بإعادة محاولة طلبات تحديد المعدل على جانب الخادم حتى القيمة التي تم تعيينها ل max-request-timeout.	‏‏نعم‬
EnableMongoRoleBasedAccessControl	تمكين الدعم لإنشاء المستخدمين والأدوار للتحكم في الوصول المستند إلى دور MongoDB الأصلي.	لا
EnableMongoRetryableWrites	تمكين الدعم للكتابات القابلة لإعادة المحاولة على الحساب.	‏‏نعم‬
EnableMongo16MBDocumentSupport	تمكين الدعم لإدراج مستندات يصل حجمها إلى 16 ميغابايت. 1	لا
EnableUniqueCompoundNestedDocs	تمكين دعم الفهارس المركبة والفهارس الفريدة في الحقول المتداخلة إذا لم يكن الحقل المتداخل صفيفا.	لا
EnableTtlOnCustomPath	يوفر القدرة على تعيين وقت مخصص للعيش (TTL) على أي حقل واحد في مجموعة. تعيين TTL على خاصية فهرس فريد جزئي غير معتمد. 2	لا
EnablePartialUniqueIndex	تمكين الدعم لفهرس جزئي فريد، بحيث يكون لديك المزيد من المرونة لتحديد الحقول الموجودة في المستندات التي تريد فهرستها بالضبط.	لا
EnableUniqueIndexReIndex	تمكين الدعم لإعادة فهرسة فريدة ل Cosmos DB ل MongoDB RU. 2	لا

إشعار

¹ لا يمكن تمكين هذه الإمكانية على Azure Cosmos DB لحسابات MongoDB باستخدام المفاتيح المدارة بواسطة العميل (CMK).

إشعار

² لا يمكن تمكين هذه الإمكانية على Azure Cosmos DB لحسابات MongoDB مع النسخ الاحتياطي المستمر.

هام

لا يتوفر تغيير القدرات باستخدام Azure Resource Manager لحسابات Azure Cosmos DB لحسابات MongoDB.

تمكين إمكانية

1. استرداد قدرات حسابك الحالية باستخدام az cosmosdb show:

   az cosmosdb show \
       --resource-group <azure_resource_group> \
       --name <azure_cosmos_db_account_name>
   

   يجب أن تشاهد قسم القدرة مشابها لهذا المثال الناتج:

   "capabilities": [
     {
       "name": "EnableMongo"
     }
   ]
   

   راجع الإمكانية الافتراضية. في هذا المثال، القدرة الوحيدة التي تم تعيينها هي EnableMongo.

2. تعيين الإمكانية الجديدة على حساب قاعدة البيانات الخاص بك. يجب أن تتضمن قائمة الإمكانات قائمة القدرات الممكنة مسبقا التي تريد الاحتفاظ بها.

   يتم تعيين القدرات المسماة بشكل صريح فقط على حسابك. على سبيل المثال، إذا كنت تريد إضافة DisableRateLimitingResponses الإمكانية إلى المثال السابق، فاستخدم الأمر az cosmosdb update مع المعلمة --capabilities ، واسرد جميع الإمكانات التي تريدها في حسابك:

   az cosmosdb update \
       --resource-group <azure_resource_group> \
       --name <azure_cosmos_db_account_name> \
       --capabilities EnableMongo DisableRateLimitingResponses
   

   هام

   يجب أن تحدد قائمة القدرات دائما جميع الإمكانات التي تريد تمكينها، بشكل شامل. يتضمن ذلك الإمكانات التي تم تمكينها بالفعل للحساب الذي تريد الاحتفاظ به. في هذا المثال، EnableMongo تم تمكين الإمكانية بالفعل، لذلك يجب تحديد كل من EnableMongo الإمكانية والقدرة DisableRateLimitingResponses .

   تلميح

   إذا كنت تستخدم PowerShell وظهرت رسالة خطأ عند استخدام الأمر السابق، فحاول بدلا من ذلك استخدام صفيف PowerShell لسرد القدرات:

   az cosmosdb update \
       --resource-group <azure_resource_group> \
       --name <azure_cosmos_db_account_name> \
       --capabilities @("EnableMongo","DisableRateLimitingResponses")
   

تعطيل إمكانية

1. استرجع قدرات حسابك الحالية باستخدام az cosmosdb show:

   az cosmosdb show \
       --resource-group <azure_resource_group> \
       --name <azure_cosmos_db_account_name>
   

   يجب أن تشاهد قسم القدرة مشابها لهذا المثال الناتج:

   "capabilities": [
     {
       "name": "EnableMongo"
     },
     {
       "name": "DisableRateLimitingResponses"
     }
   ]
   

   تحقق من كافة الإمكانات التي تم تعيينها حاليا. في هذا المثال، يتم تعيين قدراتين: EnableMongo و DisableRateLimitingResponses.

2. قم بإزالة إحدى الإمكانات من حساب قاعدة البيانات الخاص بك. يجب أن تتضمن قائمة الإمكانات قائمة القدرات الممكنة مسبقا التي تريد الاحتفاظ بها.

   يتم تعيين القدرات المسماة بشكل صريح فقط على حسابك. على سبيل المثال، إذا كنت تريد إزالة DisableRateLimitingResponses القدرة، يمكنك استخدام az cosmosdb update الأمر ، وسرد الإمكانية التي تريد الاحتفاظ بها:

   az cosmosdb update \
       --resource-group <azure_resource_group> \
       --name <azure_cosmos_db_account_name> \
       --capabilities EnableMongo
   

   تلميح

   إذا كنت تستخدم PowerShell وظهرت رسالة خطأ عند استخدام هذا الأمر، فحاول بدلا من ذلك استخدام صفيف PowerShell لسرد القدرات:

   az cosmosdb update \
       --resource-group <azure_resource_group> \
       --name <azure_cosmos_db_account_name> \
       --capabilities @("EnableMongo")
   

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

• تعرف على كيفية استخدام Studio 3T مع Azure Cosmos DB ل MongoDB.
• تعرف على كيفية استخدام Robo 3T مع Azure Cosmos DB ل MongoDB.
• استكشف نماذج MongoDB باستخدام Azure Cosmos DB ل MongoDB.
• هل تحاول القيام بتخطيط السعة للترحيل إلى Azure Cosmos DB؟ يمكنك استخدام معلومات حول نظام مجموعة قاعدة البيانات الموجودة لديك لـ تخطيط السعة.
  • إذا كان كل ما تعرفه هو عدد vCores والخوادم في مجموعة قاعدة البيانات الحالية، فتعرف على كيفية تقدير وحدات الطلب باستخدام vCores أو vCPUs.
  • إذا كنت تعرف معدلات الطلب النموذجية لحمل عمل قاعدة البيانات الحالي، فتعرف على كيفية تقدير وحدات الطلب باستخدام مخطط سعة Azure Cosmos DB.