استخدام مستكشف Azure Cosmos DB لإدارة بياناتك

ينطبق على: NoSQL MongoDB كاساندرا العفريت الجدول

مستكشف Azure Cosmos DB هو واجهة مستقلة تعمل على الويب تسمح لك بعرض البيانات المخزنة في Azure Cosmos DB وإدارتها. مستكشف Azure Cosmos DB يعادل قسم Data Explorer الموجود المتوفر في مدخل Microsoft Azure لحسابات Azure Cosmos DB.

يتمتع مستكشف Azure Cosmos DB ببعض المزايا الرئيسية عند مقارنتها بمستكشف البيانات، بما في ذلك:

  • العقارات في وضع ملء الشاشة لاستعراض البيانات وتشغيل الاستعلامات ومراقبة نتائج الاستعلام
  • القدرة على تزويد المستخدمين دون الوصول إلى مدخل Microsoft Azure أو اشتراك Azure قدرات القراءة أو القراءة والكتابة عبر البيانات في الحاويات
  • القدرة على مشاركة نتائج الاستعلام مع المستخدمين الذين ليس لديهم اشتراك Azure أو الوصول إلى مدخل Azure

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

الوصول إلى المستكشف مباشرة باستخدام اشتراك Azure الخاص بك

يمكنك استخدام الوصول إلى المستكشف مباشرة واستخدام بيانات الاعتماد الموجودة لبدء استخدام الأداة بسرعة.

  1. الانتقال إلى https://cosmos.azure.com.

  2. حدد"‏‏تسجيل الدخول". سجل الدخول باستخدام بيانات الاعتماد الموجودة التي لديها حق الوصول إلى حساب Azure Cosmos DB.

  3. بعد ذلك، حدد اشتراك Azure وحساب الهدف من قائمة تحديد حساب قاعدة بيانات.

    Screenshot of the 'Select a Database Account' menu in the Explorer.

الوصول إلى Explorer من مدخل Microsoft Azure باستخدام اشتراك Azure

إذا كنت مرتاحا بالفعل مع مدخل Microsoft Azure، يمكنك الانتقال مباشرة من مستكشف البيانات في المدخل إلى المستكشف المستقل.

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

  2. انتقل إلى حساب Azure Cosmos DB الحالي.

  3. في قائمة الموارد، حدد Data Explorer.

  4. بعد ذلك، حدد خيار القائمة فتح ملء الشاشة .

    Screenshot of the Data Explorer page with the 'Open Full Screen' option highlighted.

  5. في مربع الحوار فتح ملء الشاشة ، حدد فتح.

منح شخص آخر حق الوصول إلى المستكشف باستخدام سلسلة الاتصال

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

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

  2. انتقل إلى حساب Azure Cosmos DB الحالي.

  3. في قائمة الموارد، حدد Keys.

  4. في صفحة المفاتيح ، حدد إما خيار مفاتيح القراءة والكتابة أو مفاتيح القراءة فقط. بعد ذلك، انسخ قيمة حقل Primary الاتصال ion String. يمكنك استخدام هذه القيمة في خطوة لاحقة.

    ‏‏الوصف
    مفتاح القراءة والكتابة يوفر الوصول لعرض وتعديل قواعد البيانات والحاويات والاستعلامات والموارد الأخرى المقترنة بهذا الحساب المحدد
    مفتاح للقراءة فقط يوفر الوصول لعرض قواعد البيانات والحاويات والاستعلامات والموارد الأخرى المقترنة بهذا الحساب المحدد

    تلميح

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

  5. الآن، يجب على المستخدم الآخر الانتقال إلى https://cosmos.azure.com.

  6. حدد الاتصال إلى حسابك باستخدام سلسلة الاتصال. بعد ذلك، يجب على المستخدم إدخال سلسلة الاتصال نسخها مسبقا وتحديد الاتصال.

تكوين حد وحدة الطلب

في المستكشف، يمكنك تكوين حد لوحدات الطلب في الثانية (RU/s) التي تستخدمها الاستعلامات. استخدم هذه الوظيفة للتحكم في التكلفة والأداء في وحدات الطلب (RU) لاستعلاماتك. يمكن لهذه الوظيفة أيضا إلغاء الاستعلامات عالية التكلفة تلقائيا.

  1. ابدأ في المستكشف لحساب Azure Cosmos DB الهدف.

  2. حدد خيار القائمة الإعدادات.

    Screenshot of an Data Explorer page with the 'Open Settings' option highlighted.

  3. في مربع الحوار الإعدادات، قم بتكوين ما إذا كنت تريد تمكين حد RU وقيمة حد RU الفعلي.

    Screenshot of the individual settings to configure the request unit threshold

    تلميح

    يتم تمكين حد RU تلقائيا بقيمة افتراضية تبلغ 5000 وحدة طلب.

مشكلات معروفة

فيما يلي بعض المشكلات المعروفة حاليا:

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

  • قد تحدث أخطاء HTTP 401 بسبب عدم كفاية أذونات التحكم في الوصول المستندة إلى الدور لحساب معرف Microsoft Entra الخاص بك. يمكن أن يكون هذا الشرط صحيحا خاصة إذا كان للحساب دور مخصص. يجب أن تتضمن Microsoft.DocumentDB/databaseAccounts/listKeys/* أي أدوار مخصصة الإجراء المضمن لاستخدام المستكشف.

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