توصيل تطبيق MongoDB بـ Azure Cosmos DB

  • مقالة
  • قراءة خلال 2 دقائق

ينطبق على: واجهة برمجة تطبيقات Azure Cosmos DB لـ MongoDB

تعرف على كيفية توصيل تطبيق MongoDB ب Azure Cosmos DB باستخدام سلسلة اتصال MongoDB. يمكنك بعد ذلك استخدام قاعدة بيانات Azure Cosmos كمخزن بيانات لتطبيق MongoDB.

يوفر هذا البرنامج التعليمي طريقتين لاسترداد معلومات سلسلة الاتصال:

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

الحصول على سلسلة اتصال MongoDB باستخدام البداية السريعة

  1. سجّل الدخول إلى مدخل Microsoft Azure من المتصفح.

  2. في شفرة Azure Cosmos DB، حدد واجهة برمجة التطبيقات.

  3. في الجزء الأيسر من شفرة الحساب، انقر فوق بدء سريع.

  4. اختر منصتك ( .NET, Node.js, MongoDB Shell, java, Python). إذا لم تشاهد برنامج التشغيل أو الأداة المدرجة، لا تقلق- نحن نوثق باستمرار المزيد من القصاصات البرمجية لرمز الاتصال. يرجى التعليق أدناه على ما تريد عرضه. لمعرفة كيفية صياغة الاتصال الخاص بك، اقرأ الحصول على معلومات سلسلة اتصال الحساب.

  5. نسخ ولصق مقتطف التعليمات البرمجية في تطبيق MongoDB.

    Quick start blade

الحصول على سلسلة اتصال MongoDB لتخصيص

  1. سجّل الدخول إلى مدخل Microsoft Azure من المتصفح.

  2. في شفرة Azure Cosmos DB، حدد واجهة برمجة التطبيقات.

  3. في الجزء الأيسر من شفرة الحساب، انقر فوق سلسلة الاتصال.

  4. تفتح شفرة Connection String. تحتوي على جميع المعلومات الضرورية للاتصال الحساب باستخدام برنامج تشغيل MongoDB بما في ذلك سلسلة اتصال تم بناؤه مسبقاً.

    Connection String blade

متطلبات سلسلة الاتصال

هام

يتمتع Azure Cosmos DB بمتطلبات ومعايير أمنية صارمة. تتطلب حسابات Azure Cosmos DB مصادقة واتصال آمن عبر TLS.

يدعم Azure Cosmos DB تنسيق URI القياسي لسلسلة اتصال MongoDB، مع اثنين من المتطلبات المحددة: تتطلب حسابات Azure Cosmos DB المصادقة والاتصال الآمن عبر TLS. وهكذا يكون تنسيق سلسلة الاتصال:

mongodb://username:password@host:port/[database]?ssl=true

تتوفر قيم هذه السلسلة في شفرة سلسلة الاتصال المعروضة سابقاً:

  • اسم المستخدم (مطلوب): اسم حساب Cosmos.
  • كلمة المرور (مطلوبة): كلمة مرور حساب Cosmos.
  • المضيف (مطلوب): FQDN من حساب Cosmos.
  • المنفذ (مطلوب): 10255.
  • قاعدة البيانات (اختياري): قاعدة البيانات التي يستخدمها الاتصال. إذا لم يتم توفير قاعدة بيانات قاعدة البيانات الافتراضية "اختبار".
  • ssl=true (مطلوب)

على سبيل المثال، خذ بعين الاعتبار الحساب المعروض في شفرة سلسلة الاتصال. سلسلة الاتصال الصالحة هي:

mongodb://contoso123:0Fc3IolnL12312asdfawejunASDF@asdfYXX2t8a97kghVcUzcDv98hawelufhawefafnoQRGwNj2nMPL1Y9qsIr9Srdw==@contoso123.documents.azure.com:10255/mydatabase?ssl=true

متطلبات برنامج تشغيل الجهاز

ستدعم جميع برامج التشغيل التي تدعم الإصدار 3.4 من بروتوكول سلكي أو إصدار أحدث Azure Cosmos DB API لعمليات MongoDB.

وبوجه خاص، يجب أن تعتمد برامج تشغيل العملاء ملحق TLS تعريف اسم الخدمة (SNI) و/أو الخيار سلسلة اتصال appName. إذا appName تم توفير المعلمة، يجب تضمينها كما وجدت في قيمة سلسلة الاتصال في مدخل Azure.

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