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

ينطبق على: MongoDB

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

يتم تسوية تكلفة جميع عمليات قاعدة البيانات بواسطة Azure Cosmos DB ويتم التعبير عنها بواسطة Request Units (أو وحدات البحث السريع، باختصار). تكلفة الطلب هي وحدات الطلب التي تستهلكها جميع عمليات قاعدة البيانات الخاصة بك. يمكنك التفكير في وحدات الطلب على أنها عملة أداء تستخلص موارد النظام مثل 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. تسجيل الدخول إلى ⁧⁩مدخل Microsoft Azure⁧⁩.

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

3. انتقل إلى جزء Data Explorer ثم حدد الحاوية التي تريد العمل عليها.

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
  • إذا كنت تعرف المعدلات النموذجية للطلب لحمل العمل الحالي في قاعدة بياناتك، فاقرأ عن ⁧⁩تقدير وحدات الطلب باستخدام مخطط السعة من Azure Cosmos DB⁧⁩