مشاركة عبر

Connect to Azure DocumentDB using MongoDB Shell

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

Prerequisites

  • اشتراك Azure

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

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

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

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

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

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

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

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

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

Important

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

الاتصال باستخدام مصادقة كلمة المرور التفاعلية

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

  1. افتح terminal.

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

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

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

    This server or service appears to be an emulation of MongoDB.

    Tip

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

  4. اخرج من سياق shell.

الاتصال بسلسلة الاتصال وكلمة المرور

الآن ، اتصل بنظام المجموعة الخاص بك من MongoDB Shell باستخدام سلسلة اتصال ومعلمات تتضمن كلمة مرور.

  1. الاتصال باستخدام سلسلة اتصال والوسيطات --username و.--password

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

  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