استخدام 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 مباشرة واستخدام بيانات الاعتماد الموجودة لبدء استخدام الأداة بسرعة.

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. بعد ذلك، حدد خيار القائمة فتح ملء الشاشة .

   

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

تخصيص طرق عرض البيانات باستخدام محدد العمود المخصص

يتيح لك محدد العمود المخصص في Azure Cosmos DB Data Explorer تخصيص طرق عرض البيانات عن طريق تحديد أعمدة معينة أكثر صلة بتحليلك عند استخدام NoSQL API. في السابق، في طريقة عرض عناصر مستكشف البيانات، كان بإمكانك رؤية مفتاح القسم وأعمدة المعرف فقط. الآن، باستخدام هذه الميزة الجديدة، يمكنك تحديد خاصية واحدة أو العديد من الخصائص من المستند وإنشاء أعمدة إضافية لعرض بياناتك بسهولة. 

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

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

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

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

   

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

6. بمجرد الوصول إلى مستكشف البيانات، افتح المجموعة التي تريد الاستعلام فيها، وحدد العناصر.

7. انقر فوق قائمة علامة الحذف في الجزء العلوي الأيسر من أي عمود، وحدد تحرير العمود

8. حدد الأعمدة التي تريد عرضها واحفظ إعداداتك.

9. ستعكس طريقة عرض البيانات الآن الأعمدة المحددة فقط، مما يسهل التركيز على البيانات ذات الصلة.

10. إزالة عمود مخصص

11. بمجرد الوصول إلى مستكشف البيانات، افتح المجموعة التي تريد الاستعلام فيها، وحدد العناصر.

12. انقر فوق قائمة علامة الحذف في الجزء العلوي الأيسر من أي عمود، وحدد إزالة عمود.

13. فرز طريقة عرض العمود تصاعديا أو تنازليا

14. بمجرد الوصول إلى مستكشف البيانات، افتح المجموعة التي تريد الاستعلام فيها، وحدد العناصر.

15. انقر فوق قائمة علامة الحذف في الجزء العلوي الأيسر من أي عمود، وحدد إزالة عمود.

16. إعادة تعيين طريقة عرض العمود

17. بمجرد الوصول إلى مستكشف البيانات، افتح المجموعة التي تريد الاستعلام فيها، وحدد العناصر.

18. انقر فوق قائمة علامة الحذف في الجزء العلوي الأيسر من أي عمود، وحدد تحرير عمود.

19. حدد إعادة تعيين للعودة إلى طريقة العرض الافتراضية. أو يمكنك مسح إعدادات "محفوظات التصفية" و"الأعمدة" و"منفذ العرض" عن طريق تحديد أيقونة الترس في القائمة "Global" في أعلى يمين "مستكشف البيانات" وتحديد "مسح المحفوظات".

استخدام محفوظات التصفية

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

1. تطبيق عامل تصفية محفوظ

2. بمجرد الوصول إلى مستكشف البيانات، افتح المجموعة التي تريد الاستعلام فيها، وحدد العناصر.

3. انقر فوق تحرير عامل التصفية.

4. قم بتطبيق عامل تصفية على بياناتك كما تفعل عادة.

بعد تطبيق عامل التصفية، سيتم حفظ عامل التصفية تلقائيا وإضافته إلى قائمة التصفية الافتراضية في القائمة المنسدلة لنافذة عامل التصفية.

1. لإعادة تطبيق عامل تصفية سابق، انقر فوق الزر تحرير عامل التصفية.

2. قم بإلغاء تحديد أي عامل تصفية من نافذة عامل التصفية. هذه الخطوة مطلوبة لكي تتمكن من عرض عوامل التصفية المحفوظة.

3. انقر فوق القائمة المنسدلة في نافذة عامل التصفية، وحدد عامل التصفية المطلوب من القائمة.

4. حدد تطبيق عامل التصفية

5. مسح محفوظات التصفية

6. في Data Explorer، انقر فوق أيقونة الترس في الزاوية العلوية اليسرى من Data Explorer للوصول إلى الإعدادات

7. حدد الزر مسح المحفوظات

8. تأكد من رغبتك في مسح المحفوظات.  تضمن ذلك مواضع مقسم أعمدة التصفية والأعمدة المخصصة وتخطيط علامة التبويب.

تغيير طريقة عرض نافذة الاستعلام

لقد قدمنا ميزة جديدة في طريقة عرض الاستعلام تسمح لك بالتبديل بين طرق العرض الأفقية والعمودية للاستعلام ولوحة النتائج. يمكنك التبديل بسهولة بين طرق العرض هذه عن طريق تحديد الخيار "طرق العرض" في قائمة شريط الأوامر.

1. حفظ تفضيلات طريقة عرض "نافذة الاستعلام"

2. في Data Explorer، انقر فوق أيقونة الترس في الزاوية العلوية اليسرى من Data Explorer للوصول إلى الإعدادات.

3. حدد "طريقة عرض نتائج الاستعلام الافتراضية" من القائمة المنسدلة.

4. حدد إما أفقيا أو عموديا كعرض افتراضي.

5. انقر فوق حفظ لتطبيق الإعدادات.

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

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

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

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

   

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

   

   > [!TIP]
   

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

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

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

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

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

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

4. سيقوم مستكشف البيانات بتسجيل الدخول تلقائيا باستخدام حسابك. قد يظهر هذا نافذة منبثقة قصيرة دون مطالبتك بإدخال بيانات اعتماد. إذا فشل تسجيل الدخول التلقائي أو إذا تم حظر النوافذ المنبثقة في المستعرض، فيجب عليك استخدام زر تسجيل الدخول ل Entra ID RBAC (الموجود على شريط أوامر مستكشف البيانات) والسماح بالنوافذ المنبثقة لمستكشف البيانات قبل تقديم أي طلبات بيانات.

   تلميح

   يدعم 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/* أي أدوار مخصصة الإجراء لاستخدام مستكشف البيانات.

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