مشاركة عبر


Quickstart: إنشاء مجموعة Azure DocumentDB باستخدام بوابة Azure

في هذا البدء السريع، تنشئ عنقود Azure DocumentDB جديد. تحتوي هذه المجموعة على جميع موارد MongoDB النموذجية: قواعد البيانات، المجموعات، والوثائق. يوفر العنقود نقطة نهاية فريدة لأدوات وتعريفات مختلفة للاتصال ب Azure DocumentDB وأداء العمليات اليومية.

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

  • اشتراك Azure

إنشاء نظام مجموعة

للبدء، تحتاج أولا إلى إنشاء مجموعة Azure DocumentDB، والتي تعد الأساس لتخزين وإدارة بيانات NoSQL الخاصة بك.

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

  2. من قائمة مدخل Azure أو الصفحة الرئيسية، حدد Create a resource.

  3. في الصفحة الجديدة ، ابحث عن Azure DocumentDB واختر ذلك.

    لقطة شاشة تظهر البحث عن Azure DocumentDB.

  4. في صفحة مجموعة إنشاء Azure DocumentDB وداخل قسم الأساسيات ، اختر خيار التكوين داخل قسم مستوى العنقود .

    لقطة شاشة تظهر خيار تكوين العنقود.

  5. في صفحة المقياس ، قم بتكوين هذه الخيارات ثم اختر الحفظ لاستمرار تغييراتك في مستوى العنقود.

    قيمة
    طبقة نظام المجموعة M30 tier, 2 vCore, 8-GiB RAM
    التخزين لكل جزء 128 GiB

    لقطة شاشة لخيارات التكوين للحوسبة والتخزين لمجموعة جديدة من Azure DocumentDB.

  6. في قسم الأساسيات، قم بتكوين الخيارات التالية:

    قيمة
    اشتراك حدد اشتراكك في Azure.
    مجموعة الموارد إنشاء مجموعة موارد جديدة أو تحديد مجموعة موارد موجودة
    اسم شبكة نظام المجموعة توفير اسم فريد عالميا
    Location تحديد منطقة Azure مدعومة لاشتراكك
    نسخة MongoDB تحديد 8.0
    "Admin username" إنشاء اسم مستخدم للوصول إلى المجموعة كمسؤول مستخدم
    كلمة المرور استخدم كلمة مرور فريدة مرتبطة باسم المستخدم

    لقطة شاشة تظهر معلمات العنقود.

    تلميح

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

  7. حدد Next: Networking.

  8. في قسم قواعد جدار الحماية في تبويب الشبكات ، قم بتكوين هذه الخيارات:

    قيمة
    أسلوب الاتصال Public access
    السماح بالوصول العام من خدمات وموارد Azure داخل Azure إلى هذا العنقود ممكن
  9. أضف قاعدة جدار حماية لجهاز العميل الحالي الخاص بك لمنح الوصول إلى العنقود عن طريق اختيار + إضافة عنوان IP الحالي للعميل.

    لقطة شاشة تظهر إعدادات الشبكة.

    تلميح

    في العديد من بيئات الشركة، يتم إخفاء عناوين IP لجهاز المطور بسبب VPN أو إعدادات شبكة الشركة الأخرى. في هذه الحالات، يمكنك السماح مؤقتا بالوصول إلى جميع عناوين IP بإضافة 0.0.0.0 - 255.255.255.255 نطاق عناوين IP كقاعدة جدار حماية. استخدم قاعدة جدار الحماية هذه مؤقتا فقط كجزء من اختبار وتطوير الاتصال.

  10. حدد "Review + create".

  11. راجع الإعدادات التي تقدمها، ثم حدد إنشاء. يستغرق بضع دقائق لإنشاء المجموعة. انتظر حتى يكتمل نشر الموارد.

  12. وأخيرا، اختر Go to resource للانتقال إلى عنقود Azure DocumentDB في البوابة.

لقطة شاشة تظهر خيارات الموارد الجاهزة.

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

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

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

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

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

هام

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

الاتصال باستخدام MongoDB Shell من Quick Start

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

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

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

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

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

    ملاحظة

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

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

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

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

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

    db.runCommand({connectionStatus: 1})
    
    {
      ...
      ok: 1
    }
    
  2. قم بإدراج قواعد البيانات في نظام المجموعة الخاص بك.

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

    use <database-name>
    

    تلميح

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

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

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

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

    تلميح

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

تنظيف الموارد

عندما تنتهي من مجموعة Azure DocumentDB، يمكنك حذف الموارد التي أنشأتها في Azure حتى لا تتحمل المزيد من الرسوم.

  1. في شريط البحث في مدخل Microsoft Azure، ابحث عن Resource groups وحددها.

    لقطة شاشة تظهر خيار البحث في مجموعات الموارد.

  2. في القائمة، حدد مجموعة الموارد التي استخدمتها لهذا التشغيل السريع.

    لقطة شاشة تظهر مجموعة الموارد.

  3. في صفحة مجموعة الموارد، حدد "Delete resource group".

  4. في مربع حوار تأكيد الحذف، أدخل اسم مجموعة الموارد لتأكيد أنك تنوي حذفها. وأخيرا، حدد حذف لحذف مجموعة الموارد نهائيا.

    لقطة شاشة تظهر زر تأكيد حذف مجموعة الموارد.