التشغيل السريع: إنشاء تطبيق وحدة تحكم باستخدام Java وAzure Cosmos DB ل MongoDB

ينطبق على: MongoDB

• NET.
• Python
• Java
• Node.js
• الذهاب

في هذا التشغيل السريع، يمكنك إنشاء وإدارة حساب Azure Cosmos DB ل MongoDB من مدخل Microsoft Azure، وإضافة البيانات باستخدام تطبيق Java SDK المستنسخ من GitHub. Azure Cosmos DB عبارة عن خدمة قاعدة بيانات متعددة النماذج تتيح لك إنشاء قواعد بيانات المستندات والجدول والقيمة الرئيسية والرسم البياني والاستعلام عنها بسرعة مع إمكانات التوزيع العام والقياس الأفقي.

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

• حساب Azure مع اشتراك نشط. أنشئ حسابًا مجانًا. أو جرب Azure Cosmos DB مجاناً بدون اشتراك Azure. يُمكنك أيضاً استخدام Azure Cosmos DB Emulator مع سلسلة الاتصال.mongodb://localhost:C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==@localhost:10255/admin?ssl=true.
• مجموعة التطوير المساعدة للغة Java للبرمجة (JDK)الإصدار 8.
• Maven. أو شغل apt-get install maven لتثبيت Maven.
• Git.

أنشئ «حساب قاعدة البيانات».

1. في نافذة مستعرض جديدة، سجل الدخول إلى مدخل Azure.

2. في القائمة اليمنى، حدد "Create a resource".

   

3. في الصفحة الجديدة حدد "Database>Azure Cosmos DB".

   

4. في صفحة تحديد خيار واجهة برمجة التطبيقات، حدد Azure Cosmos DB لإنشاء MongoDB>.

   تحدد واجهة API نوع الحساب المقرر إنشاؤه. حدد Azure Cosmos DB ل MongoDB لأنك ستنشئ مجموعة تعمل مع MongoDB في هذا التشغيل السريع. لمعرفة المزيد، راجع نظرة عامة على Azure Cosmos DB ل MongoDB.

   

5. في الصفحة إنشاء حساب Azure Cosmos DB، أدخل إعدادات حساب جديد Azure Cosmos DB.

   الإعداد	قيمة	‏‏الوصف
   الاشتراك	اسم الاشتراك	حدد اشتراك Azure الذي تريد استخدامه لحساب Azure Cosmos DB هذا.
   مجموعة الموارد	اسم مجموعة الموارد	حدد مجموعة موارد، أو حدد إنشاء جديد، ثم أدخل اسمًا فريدًا لمجموعة الموارد الجديدة.
   اسم الحساب	أدخل اسماً فريداً	أدخل اسماً فريداً لتعريف حساب Azure Cosmos DB الخاص بك. سيكون حساب URI الخاص بك mongo.cosmos.azure.com وسيُلحق باسم حسابك الفريد. لا يمكن أن يستخدم اسم الحساب سوى الأحرف الصغيرة والأرقام والواصلات (-)، ويجب أن يتراوح طولها بين 3 إلى 44 حرفًا.
   الموقع	المنطقة الأقرب إلى مستخدميك	حدد موقعًا جغرافيًّا لاستضافة حساب Azure Cosmos DB. استخدم الموقع الأقرب إلى المستخدمين لمنحهم أسرع وصول إلى البيانات.
   وضع السعة	معدل النقل المقدم أو بلا خادم	حدد "Provisioned throughput" لإنشاء حساب في وضع معدل النقل المتوفر. حدد Serverless لإنشاء حساب في وضع دون خادم. ملاحظة: يتم دعم واجهة برمجة التطبيقات فقط لإصدارات MongoDB 4.2 و4.0 و3.6 بواسطة حسابات بلا خادم. سيؤدي اختيار 3.2 كإصدار إلى فرض الحساب في وضع النقل المتوفر.
   تطبيق خصم طبقة Azure Cosmos DB المجاني	تطبيق أو عدم تطبيق	مع Azure Cosmos DB الطبقة الحرة، سوف تحصل على أول 1000 RU / ثانية و25 غيغابايت من التخزين مجانًا في حساب. تعرف على المزيد حول الطبقة المجانية.
   إصدار	اختر إصدار الخادم المطلوب	يتوافق Azure Cosmos DB ل MongoDB مع إصدار الخادم 4.2 و4.0 و3.6 و3.2. يمكنك ترقية الحساب أو تخفيضه بعد إنشائه.

   إشعار

   يمكنك الحصول على حساب طبقةAzure Cosmos DB مجانية واحدة لكل اشتراك Azure ويجب عليك الاشتراك عند إنشاء الحساب. إذا لم تشاهد خيار تطبيق خصم الطبقة المجانية، فهذا يعني أنه تم تمكين حساب آخر في الاشتراك بالفعل مع طبقة مجانية.

   

6. في علامة تبويب Global Distributionكوّن التفاصيل التالية. يمكنك ترك القيم الافتراضية لغرض هذه البداية السريعة:

   الإعداد	قيمة	‏‏الوصف
   التكرار الجغرافي	تعطيل	تمكين التوزيع العمومي على حسابك أو تعطيله عن طريق إقران منطقتك بمنطقة زوج. يمكنك إضافة المزيد من المناطق إلى حسابك لاحقًا.
   كتابات متعددة المناطق	تعطيل	تتيح لك إمكانية الكتابة متعددة المناطق الاستفادة من الإنتاجية المقدمة لقواعد البيانات والحاويات الخاصة بك في جميع أنحاء العالم.

   إشعار

   الخيارات التالية غير متوفرة إذا قمت بتحديد دون خادمباعتبارهاوضع السعة:

   • تطبيق خصم من الدرجة المجانية
   • Geo-redundancy
   • كتابات متعددة المناطق

7. اختياريًا يمكنك تكوين تفاصيل إضافية في علامات التبويب التالية:

   • شبكة الاتصال - تكوين الوصول من شبكة اتصال ظاهرية.
   • نهج النسخ الاحتياطي - تكوين نهج النسخ الاحتياطي الدوري أو المستمر.
   • التشفير - استخدم إما مفتاحًا مُدارًا بواسطة الخدمة أو مفتاحًا مُدارًا من قِبل العميل.
   • العلامات - العلامات هي أزواج الاسم/القيم التي تمكنك من تصنيف الموارد وعرض الفوترة الموحدة من خلال تطبيق نفس العلامة على موارد متعددة ومجموعات موارد متعددة.

8. حدد "Review + create".

9. يستغرق إنشاء الحساب بضع دقائق. انتظر حتى يعرض المدخل تهانينا! صفحة Azure Cosmos DB لحساب MongoDB جاهزة .

   

أنشئ مجموعة

ضع اسم لقاعدة البيانات الجديدة db، ومجموعتك جديدة coll.

يمكنك الآن استخدام أداة مستكشف البيانات في المدخل Azure لإنشاء واجهة برمجة التطبيقات لـ Azure Cosmos DB لقاعدة بيانات MongoDB والحاوية.

1. حدد "Data Explorer">"New Container".

   يتم عرض منطقة إضافة حاوية على أقصى اليمين، قد تحتاج إلى التمرير إلى اليمين لرؤيتها.

   

2. في صفحة إضافة حاوية، أدخل إعدادات الحاوية الجديدة.

   الإعدادات	القيمة المقترحة	‏‏الوصف
   معرف قاعدة البيانات	قاعدة البيانات	أدخل قاعدة البيانات كاسم لقاعدة البيانات الجديدة. يجب أن تحتوي أسماء قواعد البيانات من 1 إلى 255 حرفًا، ولا يمكن أن تحتوي على /, \\, #, ?، أو مسافة زائدة. تحقق من خيار توفير سرعة نقل قاعدة البيانات، فإنه يسمح لك بمشاركة الإنتاجية المقدمة على قاعدة البيانات عبر جميع الحاويات داخل قاعدة البيانات. يساعد هذا الخيار أيضًا في توفير التكاليف.
   الإنتاجية	400	اترك معدل النقل عند 400 وحدة طلب في الثانية (RU/s). إذا كنت تريد تقليل زمن الانتقال، يمكنك زيادة الانتاجية لاحقاً. كما يمكنك اختيار وضع المقياس التلقائي، والذي سيعطيك مجموعة من RU/s التي ستزيد وتنخفض بشكل ديناميكي حسب الحاجة.
   معرف المجموعة	coll	أدخل coll كاسم للحاوية الجديدة. معرفات الحاويات تستلزم متطلبات الحروف نفسها كأسماء قواعد البيانات.
   سعة التخزين	ثابت (10 غيغابايت)	أدخل ثابت (10 غيغابايت) لهذا التطبيق. إذا قمت بتحديد غير محدود، سيكون عليك إنشاء Shard Key ، والتي تتطلب جميع العناصر المدرجة.
   مفتاح شارد	/_id	لا تستخدم العينة الموضحة في هذه المقالة مفتاح شارد لذا فإن تعيينه إلى /_id سوف يستخدم حقلًا معرّفًا تم إنشاؤه تلقائيًّا كمفتاح شارد. تعرف على المزيد حول القطع، المعروف أيضًا باسم التقسيم، في التقسيم في Azure Cosmos DB

   حدد موافق. يعرض مستكشف البيانات قاعدة البيانات والحاويات الجديدة.

استنساخ نموذج التطبيق

الآن دعونا نستنسخ تطبيق من GitHub، ونعيّن سلسلة الاتصال ونشغّلها. سترى مدى سهولة العمل مع البيانات برمجيًا.

1. افتح موجه الأوامر، وأنشئ مجلدًا جديدًا باسم git-sample، ثم أغلق موجه الأوامر.

   md "C:\git-samples"
   

2. افتح نافذة git طرفية، مثل git bash، واستخدم الأمر cd للتغيير إلى المجلد الجديد لتثبيت عينة التطبيق.

   cd "C:\git-samples"
   

3. قم بتشغيل الأمر التالي لاستنساخ مستودع النموذج. يقوم هذا الأمر بإنشاء نسخة من نموذج التطبيق على جهاز الكمبيوتر الخاص بك.

   git clone https://github.com/Azure-Samples/azure-cosmos-db-mongodb-java-getting-started.git
   

4. ثم افتح الكود في المحرر الذي تفضله.

مراجعة الرمز

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

جميع القصاصات البرمجية التالية مأخوذة من ملف Program.java.

يستخدم تطبيق وحدة التحكم برنامج تشغيل MongoDB Java.

• يتم تشغيل DocumentClient.

  MongoClientURI uri = new MongoClientURI("FILLME");`
  
  MongoClient mongoClient = new MongoClient(uri);            
  

• يتم إنشاء قاعدة بيانات ومجموعة جديدة.

  MongoDatabase database = mongoClient.getDatabase("db");
  
  MongoCollection<Document> collection = database.getCollection("coll");
  

• يتم إدراج بعض المستندات باستخدام MongoCollection.insertOne

  Document document = new Document("fruit", "apple")
  collection.insertOne(document);
  

• يتم تنفيذ بعض الاستعلامات باستخدام MongoCollection.find

  Document queryResult = collection.find(Filters.eq("fruit", "apple")).first();
  System.out.println(queryResult.toJson());    	
  

تحديث سلسلة الاتصال

عد الآن إلى مدخل Microsoft Azure للحصول على معلومات سلسلة الاتصال الخاصة بك ونسخها في التطبيق.

1. من حساب Azure Cosmos DB، حدد تشغيل سريع، ثم حدد Java وانسخ سلسلة الاتصال إلى حافظتك.

2. افتح ملف Program.java استبدل الوسيطة إلى منشئ MongoClientURI مع سلسلة الاتصال. لقد قمت بتحديث تطبيقك الآن بجميع المعلومات التي يحتاجها للتواصل مع Azure Cosmos DB.

قم بتشغيل تطبيق وحدة التحكم

1. تشغيل mvn package في محطة طرفية لتثبيت الحزم المطلوبة

2. شغلmvn exec:java -D exec.mainClass=GetStarted.Program في وحدة طرفية لتبدأ تشغيل تطبيق Java.

يمكنك الآن استخدام Robomongo / Studio 3T للاستعلام عن هذه البيانات الجديدة وتعديلها والعمل عليها.

مراجعة اتفاقيات مستوى الخدمة في مدخل Azure

يراقب مدخل Azure معدل نقل حساب Azure Cosmos DB والتخزين والتوافر وزمن الانتقال والاتساق. المخططات الخاصة بالمقاييس المقترنة بـ اتفاقية مستوى خدمة Azure Cosmos DB (SLA) تعرض قيمة اتفاقية مستوى الخدمة مقارنة بالأداء الفعلي. هذه المجموعة من المقاييس تجعل مراقبة اتفاقيات مستوى الخدمة الخاصة بك شفافة.

لمراجعة المقاييس واتفاقيات مستوى الخدمة:

1. حدد Metrics في قائمة التنقل لحساب Azure Cosmos DB.

2. حدد علامة تبويب مثل زمن الانتقال، وحدد إطارًا زمنيًا على اليسار. قارن الأسطر الفعلية واتفاقية مستوى الخدمة على المخططات.

   

3. راجع المقاييس في علامات التبويب الأخرى.

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

عند الانتهاء من تطبيقك وحساب Azure Cosmos DB، يمكنك حذف موارد Azure التي أنشأتها حتى لا تتحمل المزيد من الرسوم. لحذف الموارد:

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

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

   

3. في صفحة نظرة عامة على مجموعة الموارد، حدد حذف مجموعة الموارد.

   

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

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

في هذا التشغيل السريع، تعلمت كيفية إنشاء Azure Cosmos DB لحساب MongoDB، وإضافة قاعدة بيانات وحاوية باستخدام Data Explorer، وإضافة بيانات باستخدام تطبيق وحدة تحكم Java. يمكنك الآن استيراد بيانات إضافية إلى قاعدة بيانات Azure Cosmos DB.

هل تحاول القيام بتخطيط السعة للترحيل إلى Azure Cosmos DB؟ يمكنك استخدام معلومات حول نظام مجموعة قاعدة البيانات الموجودة لديك لـ تخطيط السعة.

• في حال كان كل ما تعرفه هو عدد vcores والخوادم في مجموعة قاعدة البيانات الحالية، فاقرأ عن تقدير وحدات الطلب باستخدام vCores أو vCPUs
• إذا كان كل ما تعرفه هو عدد vcores والخوادم الموجودة في مجموعة قاعدة البيانات، اقرأ عن تقدير وحدات الطلب باستخدام vCores أو vCPUs

استورد بيانات MongoDB إلى قاعدة بيانات Azure Cosmos