مشاركة عبر

Connect to Azure DocumentDB using Azure portal

MongoDB Shell (mongosh) هي بيئة JavaScript و Node.js للتفاعل مع عمليات نشر MongoDB. إنها أداة مجتمعية شائعة لاختبار الاستعلامات والتفاعل مع البيانات في مجموعة Azure DocumentDB الخاصة بك. يحتوي مدخل Microsoft Azure على أدوات متعددة للاستعلام عن بيانات MongoDB بما في ذلك Azure Cloud Shell. Azure Cloud Shell عبارة عن محطة طرفية تفاعلية ومصادق عليها ويمكن الوصول إليها بواسطة المستعرض لإدارة موارد Azure. تشرح هذه المقالة كيفية الاتصال بعنقود Azure DocumentDB باستخدام MongoDB Shell داخل Azure Cloud Shell.

Prerequisites

  • اشتراك Azure

  • مجموعة Azure DocumentDB موجودة

  • قواعد جدار الحماية التي تسمح للعملاء داخل شبكاتك بالاتصال بنظام المجموعة. لمزيد من المعلومات، راجع تكوين جدار الحماية.

  • (اختياري) هذه المتطلبات المطلوبة مطلوبة فقط إذا كنت تستخدم Azure Cloud Shell ضمن شبكة افتراضية متطابقة أو مرتبطة ب Azure DocumentDB.

    • واحد أو أكثر من شبكات Azure الافتراضية الموجودة مع subnets ل Azure Cloud Shell وAzure DocumentDB deployment.

    • نقطة نهاية خاصة لمجموعة Azure DocumentDB. لمزيد من المعلومات، راجع تكوين الارتباط الخاص.

    • تم نشر Azure Cloud Shell على نفس الشبكة الافتراضية أو على شبكة مترابطة مع اتصال بنقطة النهاية الخاصة Azure DocumentDB. لمزيد من المعلومات، راجع نشر Cloud Shell على الشبكة الظاهرية.

تمكين الوصول إلى نظام المجموعة الخاص بك من Azure Cloud Shell

أولا، تأكد من أن Azure Cloud Shell يمكنه الوصول إلى مجموعة Azure DocumentDB الخاصة بك من خلال السماح بعناوين IP الخاصة به في جدار الحماية.

  1. سجّل الدخول إلى مدخل Azure (https://portal.azure.com).

  2. انتقل إلى عنقود Azure DocumentDB.

  3. حدد الشبكات من قائمة التنقل.

  4. في صفحة الشبكات داخل قسم الوصول العام ، حدد الخيار + إضافة عناوين IP ل Azure Cloud Shell لإضافة عنوان IP الحالي تلقائيا إلى القائمة المسموح بها.

  5. حدد Save لتطبيق التغييرات.

إشعار

لضمان الاتصال، تأكد من السماح بعناوين IP المحددة لمنطقتك. لمزيد من المعلومات، راجع عناوين IP الخاصة ب Azure DocumentDB.

الاتصال باستخدام Azure Cloud Shell من البدء السريع

للاتصال مباشرة ب Azure DocumentDB باستخدام MongoDB Shell، استخدم تجربة البدء السريع المتاحة في صفحة المورد في بوابة Azure.

  1. في صفحة مورد نظام المجموعة، حدد البدء السريع (معاينة) من قائمة التنقل.

  2. ثم اختر Open MongoDB shell.

  3. انتظر حتى تبدأ بيئة MongoDB Shell.

  4. بمجرد أن تصبح البيئة جاهزة، أدخل Y لقبول الإشعار.

    إشعار

    إذا كنت تواجه مشكلة في الاتصال باستخدام MongoDB Shell بعد قبول الإشعار، فتأكد من أن Azure Cloud Shell لديه حق الوصول إلى نظام المجموعة الخاص بك.

  5. الآن ، أدخل كلمة المرور الخاصة بك لتوصيل نظام المجموعة الخاص بك ب Cloud Shell.

الحصول على بيانات اعتماد نظام المجموعة

احصل على سلسلة الاتصال التي تحتاجها للاتصال بنظام المجموعة هذا.

  1. تسجيل الدخول إلى بوابة Azure (https://portal.azure.com).

  2. انتقل إلى مجموعة Azure DocumentDB الحالية.

احصل على بيانات الاعتماد التي تستخدمها للاتصال بالعنقود.

  1. في صفحة المجموعة، اختر خيار سلاسل الاتصال في قائمة الموارد.

  2. في قسم سلاسل الاتصال ، قم بنسخ أو تسجيل القيمة من حقل سلسلة الاتصال .

لقطة شاشة تظهر خيار سلاسل الاتصال.

Important

لا تتضمن سلسلة الاتصال في البوابة الإلكترونية قيمة كلمة المرور. يجب استبدال العنصر النائب <password> ببيانات الاعتماد التي أدخلتها عند إنشاء نظام المجموعة أو إدخال كلمة المرور بشكل تفاعلي.

تكوين MongoDB Shell في Azure Cloud Shell يدويا

قم بتثبيت عميل MongoDB Shell (mongosh) إلى مثيل Azure Cloud Shell باستخدام Node Package Manager (npm).

  1. افتح Azure Cloud Shell الذي تم تكوينه باستخدام بيئة البرمجة النصية Bash.

  2. قم بتثبيت الإصدار 1 من MongoDB Shell محليا في دليل المستخدم الخاص بك.

    npm install mongosh@1

  3. انتظر حتى يكتمل التثبيت.

  4. تحقق من نجاح التثبيت عن طريق الحصول على إصدار الأداة mongosh .

    npx mongosh --version

الاتصال بنظام المجموعة

اتصل بنظام المجموعة الخاص بك باستخدام MongoDB Shell مع سلسلة اتصال لا تتضمن كلمة مرور. استخدم مطالبة كلمة المرور التفاعلية لإدخال كلمة المرور الخاصة بك كجزء من خطوات الاتصال.

  1. اتصل عن طريق إدخال كلمة المرور في موجه MongoDB Shell. في هذه الخطوة، استخدم سلسلة اتصال بدون كلمة المرور.

    npx mongosh "mongodb+srv://<username>@<cluster-name>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000"

  2. بعد تقديم كلمة المرور والتحقق من المصادقة بنجاح، انتبه للتحذير الذي يظهر.

    ------
   Warning: Non-Genuine MongoDB Detected
   This server or service appears to be an emulation of MongoDB rather than an official MongoDB product.
------

    Tip

    يمكنك تجاهل هذا التحذير بأمان. يتم إنشاء هذا التحذير لأن سلسلة الاتصال تحتوي على cosmos.azure. Azure DocumentDB هو عرض أصلي لمنصة Azure كخدمة (PaaS).

إجراء استعلامات الاختبار

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

  1. تحقق من حالة الاتصال عن طريق تشغيل connectionStatus الأمر.

    db.runCommand({connectionStatus: 1})

    {
  ...
  ok: 1
}

  2. قم بإدراج قواعد البيانات في نظام المجموعة الخاص بك.

    show dbs

  3. قم بالتبديل إلى قاعدة بيانات معينة. استبدل العنصر النائب <database-name> باسم أي قاعدة بيانات في نظام المجموعة الخاص بك.

    use <database-name>

    Tip

    على سبيل المثال ، إذا كان اسم قاعدة البيانات هو inventory، فسيكون use inventoryالأمر .

  4. سرد المجموعات داخل قاعدة البيانات.

    show collections

  5. ابحث عن العناصر الخمسة الأولى ضمن مجموعة معينة. استبدل العنصر النائب <collection-name> باسم أي مجموعة في نظام المجموعة الخاص بك.

    db.<collection-name>.find().limit(5)

    Tip

    على سبيل المثال، إذا كان اسم المجموعة هو equipment، فسيكون db.equipment.find().limit(5)الأمر .

محتوى ذو صلة

  • Last updated on