ابحث عن رسوم وحدة الطلب للعمليات المنفذة في Azure Cosmos DB ل MongoDB

ينطبق على: MongoDB

يدعم Azure Cosmos DB العديد من واجهات برمجة التطبيقات، مثل SQL وMongoDB وCassandra وGremlin وTable. كل واجهة من واجهات برمجة التطبيقات لديها مجموعة خاصة بها من عمليات قاعدة البيانات. تتراوح هذه العمليات من القراءة والكتابة النقطية البسيطة إلى الاستعلامات المعقدة. تستهلك كل عملية قاعدة بيانات موارد النظام استناداً إلى تعقيد العملية.

يتم تسوية تكلفة جميع عمليات قاعدة البيانات عن طريق قاعدة بيانات Azure Cosmos ويتم التعبير عنها عن طريق وحدات الطلب (أو وحدات البحث السريع، باختصار). Request charge هي وحدات الطلب التي تستهلكها جميع عمليات قاعدة البيانات. يمكنك التفكير في وحدات الطلب على أنها عملة أداء تستخلص موارد النظام مثل CPU وIOPS والذاكرة المطلوبة لتنفيذ عمليات قاعدة البيانات التي يدعمها Azure Cosmos DB. بغض النظر عن واجهة برمجة التطبيقات التي تستخدمها للتفاعل مع حاوية Azure Cosmos DB، يتم قياس التكاليف دائما بواسطة وحدات الطلب. سواء أكانت عملية قاعدة البيانات كتابة أم قراءة نقطة أم استعلامًا، يتم قياس التكاليف دائماً في وحدات الطلب. لمعرفة المزيد، راجع مقالة وحدات الطلب واعتباراتها.

تعرض هذه المقالة الطرق المختلفة التي يمكنك من خلالها العثور على استهلاك وحدة الطلب (RU) لأي عملية يتم تنفيذها على حاوية في Azure Cosmos DB ل MongoDB. إذا كنت تستخدم واجهة برمجة تطبيقات مختلفة، فشاهد واجهة برمجة التطبيقات ل NoSQL وواجهة برمجة التطبيقات ل Cassandra وواجهة برمجة التطبيقات ل Gremlin وواجهة برمجة التطبيقات لمقالات الجدول للعثور على رسوم RU/s.

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

استخدام مدخل Microsoft Azure

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

2. إنشاء حساب Azure Cosmos DB جديد وإطعامه بالبيانات، أو تحديد حساب موجود يحتوي بالفعل على بيانات.

3. افتح جزء مستكشف البيانات وحدد الحاوية التي تريد العمل عليها.

4. حدد ... بجوار اسم الحاوية وحدد New Query.

5. أدخل استعلاماً صالحاً، ثم حدد Execute Query.

6. حدد Query Stats لعرض رسوم الطلب الفعلية للطلب الذي نفذته. يتيح لك محرر الاستعلام هذا تشغيل وعرض رسوم وحدة الطلب لمؤشرات الاستعلام فقط. لا يمكنك استخدام هذا المحرر لأوامر معالجة البيانات مثل عبارات الإدراج.

   

7. للحصول على رسوم الطلب لأوامر معالجة البيانات، قم بتشغيل الأمر getLastRequestStatistics من واجهة مستخدم تستند إلى shell مثل Mongo shell أو Robo 3Tأو MongoDB Compassأو امتداد البرمجة النصية VS Code مع shell.

   db.runCommand({getLastRequestStatistics: 1})

برمجيا

Mongo Shell

عند استخدام Mongo shell، يمكنك تنفيذ الأوامر باستخدام runCommand().

db.runCommand('getLastRequestStatistics')

برنامج تشغيل .NET

عند استخدام برنامج تشغيل MongoDB .NET الرسمي، يمكنك تنفيذ الأوامر عن طريق استدعاء الأسلوب RunCommand على كائن IMongoDatabase . تتطلب هذه الطريقة تنفيذ فئة الملخص Command<> :

class GetLastRequestStatisticsCommand : Command<Dictionary<string, object>>
{
    public override RenderedCommand<Dictionary<string, object>> Render(IBsonSerializerRegistry serializerRegistry)
    {
        return new RenderedCommand<Dictionary<string, object>>(new BsonDocument("getLastRequestStatistics", 1), serializerRegistry.GetSerializer<Dictionary<string, object>>());
    }
}

Dictionary<string, object> stats = database.RunCommand(new GetLastRequestStatisticsCommand());
double requestCharge = (double)stats["RequestCharge"];

لمزيد من المعلومات، راجع التشغيل السريع: إنشاء تطبيق ويب .NET باستخدام Azure Cosmos DB ل MongoDB.

برنامج تشغيل Java

عند استخدام برنامج تشغيل MongoDB Java الرسمي، يمكنك تنفيذ الأوامر عن طريق استدعاء الطريقة runCommand على كائن MongoDatabase :

Document stats = database.runCommand(new Document("getLastRequestStatistics", 1));
Double requestCharge = stats.getDouble("RequestCharge");

لمزيد من المعلومات، راجع التشغيل السريع: إنشاء تطبيق ويب باستخدام Azure Cosmos DB ل MongoDB وJava SDK.

برنامج تشغيل Node.js

عند استخدام برنامج التشغيل MongoDB Node.js الرسمي، يمكنك تنفيذ الأوامر عن طريق استدعاء الطريقة command على كائن db :

db.command({ getLastRequestStatistics: 1 }, function(err, result) {
    assert.equal(err, null);
    const requestCharge = result['RequestCharge'];
});

لمزيد من المعلومات، راجع Quickstart: ترحيل تطبيق ويب MongoDB Node.js موجود إلى Azure Cosmos DB.

برنامج تشغيل Python

response = db.command('getLastRequestStatistics')
requestCharge = response['RequestCharge']

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

لمعرفة المزيد حول تحسين استهلاك وحدة الطلب، راجع هذه المقالات:

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