استخدام 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
المتطلبات الأساسية
- حساب Azure Cosmos DB موجود.
- إذا لم يكن لديك اشتراك Azure، فجرب Azure Cosmos DB مجانا.
الوصول إلى Data Explorer مباشرة باستخدام اشتراك Azure
يمكنك استخدام الوصول إلى Data Explorer مباشرة واستخدام بيانات الاعتماد الموجودة لبدء استخدام الأداة بسرعة.
الانتقال إلى https://cosmos.azure.com.
حدد"تسجيل الدخول". سجل الدخول باستخدام بيانات الاعتماد الموجودة التي لديها حق الوصول إلى حساب Azure Cosmos DB.
بعد ذلك، حدد اشتراك Azure وحساب الهدف من قائمة تحديد حساب قاعدة بيانات.
الوصول إلى Data Explorer من مدخل Microsoft Azure باستخدام اشتراك Azure
إذا كنت مرتاحا بالفعل مع مدخل Microsoft Azure، يمكنك الانتقال مباشرة من Data Explorer داخل المدخل إلى Data Explorer المستقل.
تسجيل الدخول إلى مدخل Azure.
انتقل إلى حساب Azure Cosmos DB الحالي.
في قائمة الموارد، حدد Data Explorer.
بعد ذلك، حدد خيار القائمة فتح ملء الشاشة .
في مربع الحوار فتح ملء الشاشة ، حدد فتح.
تكوين حد وحدة الطلب
في Data Explorer، يمكنك تكوين حد لوحدات الطلب في الثانية (RU/s) التي تستخدمها الاستعلامات. استخدم هذه الوظيفة للتحكم في التكلفة والأداء في وحدات الطلب (RU) لاستعلاماتك. يمكن لهذه الوظيفة أيضا إلغاء الاستعلامات عالية التكلفة تلقائيا.
ابدأ في المستكشف لحساب Azure Cosmos DB الهدف.
حدد خيار قائمة الإعدادات.
في مربع الحوار الإعدادات، قم بتكوين ما إذا كنت تريد تمكين حد RU وقيمة حد وحدة الطلب الفعلية.
تلميح
يتم تمكين حد RU تلقائيا بقيمة افتراضية تبلغ 5000 وحدة طلب.
استخدام مع مصادقة Microsoft Entra
يمكنك استخدام المصادقة المستندة إلى Microsoft Entra داخل المستكشف عن طريق تمكينها عبر التكوين. لمزيد من المعلومات حول التحكم في الوصول المستند إلى الدور، راجع دليل الأمان.
ابدأ في المستكشف لحساب Azure Cosmos DB الهدف.
حدد خيار قائمة الإعدادات.
في مربع الحوار إعدادات، قم بتكوين ما إذا كنت تريد
Enable Entra ID (RBAC)
استخدام إحدى القيم الثلاث المحتملة:الوصف تلقائي (افتراضي) يتم استخدام التحكم في الوصول استنادا إلى الدور (RBAC) تلقائيا إذا تم تعطيل المصادقة المستندة إلى المفتاح لحسابك. وإلا، يستخدم Data Explorer المصادقة المستندة إلى المفتاح لطلبات البيانات. صواب يتم دائما استخدام التحكم في الوصول المستند إلى الدور لطلبات البيانات. إذا لم يتم تكوين التحكم في الوصول المستند إلى الدور بشكل صحيح للحساب أو الهوية، فستفشل الطلبات. خطأ يتم دائما استخدام المصادقة المستندة إلى المفتاح لطلبات البيانات. إذا تم تعطيل المصادقة المستندة إلى المفتاح، فستفشل الطلبات. إشعار
قد يؤدي تغيير هذا الإعداد إلى خيار يستخدم المصادقة المستندة إلى المفتاح إلى تشغيل طلب لاسترداد المفتاح الأساسي نيابة عن الهوية التي تم تسجيل الدخول إليها.
الآن، حدد خيار 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/*
أي أدوار مخصصة الإجراء لاستخدام مستكشف البيانات.