مشاركة عبر

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

  • مقالة

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

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

يحتوي مستكشف بيانات Azure Cosmos DB المخصص (https://cosmos.azure.com) على بعض المزايا الرئيسية عند مقارنتها بتجربة Data Explorer لمدخل Azure، بما في ذلك:

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

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

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

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

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

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

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

    لقطة شاشة لقائمة

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

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

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

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

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

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

    لقطة شاشة لصفحة Data Explorer مع تمييز خيار

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

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

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

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

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

    لقطة شاشة لصفحة

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

    لقطة شاشة للإعدادات الفردية لتكوين حد وحدة الطلب.

    تلميح

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

استخدام مع مصادقة Microsoft Entra

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

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

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

  3. في مربع الحوار إعدادات، قم بتكوين ما إذا كنت تريد Enable Entra ID (RBAC) استخدام إحدى القيم الثلاث المحتملة:

    ‏‏الوصف
    تلقائي (افتراضي) يتم استخدام التحكم في الوصول استنادا إلى الدور (RBAC) تلقائيا إذا تم تعطيل المصادقة المستندة إلى المفتاح لحسابك. وإلا، يستخدم Data Explorer المصادقة المستندة إلى المفتاح لطلبات البيانات.
    صواب يتم دائما استخدام التحكم في الوصول المستند إلى الدور لطلبات البيانات. إذا لم يتم تكوين التحكم في الوصول المستند إلى الدور بشكل صحيح للحساب أو الهوية، فستفشل الطلبات.
    خطأ يتم دائما استخدام المصادقة المستندة إلى المفتاح لطلبات البيانات. إذا تم تعطيل المصادقة المستندة إلى المفتاح، فستفشل الطلبات.

    لقطة شاشة لإعداد التحكم في الوصول المستند إلى دور Microsoft Entra ID وثلاث قيم محتملة.

    إشعار

    قد يؤدي تغيير هذا الإعداد إلى خيار يستخدم المصادقة المستندة إلى المفتاح إلى تشغيل طلب لاسترداد المفتاح الأساسي نيابة عن الهوية التي تم تسجيل الدخول إليها.

  4. الآن، حدد خيار Login for Entra ID RBAC في شريط الأوامر للمستكشف.

    تلميح

    هذه الخطوة ليست ضرورية عند استخدام مستكشف بيانات Azure Cosmos DB (https://cosmos.azure.com). يدعم Azure Cosmos DB Data Explorer أيضا خيار تعيين قيمة Enable Entra ID (RBAC) يدويا إلى True باستخدام https://cosmos.azure.com?feature.enableAadDataPlane=true عنوان URL.

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

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

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

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

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

الشروع في استخدام الاستعلامات