تعرَّف على كيفية إنشاء قاعدة بيانات Cloud Firestore والاتصال بها باستخدام أداة mongosh.
قبل البدء
- إذا لم يسبق لك إنشاء مشروع على Firebase، يمكنك إنشاء مشروع من خلال وحدة تحكُّم Firebase بالنقر على إضافة مشروع، ثم اتّباع التعليمات الظاهرة على الشاشة لإنشاء مشروع على Firebase أو إضافة خدمات Firebase إلى مشروع Google Cloud حالي.
- تثبيت أداة
mongosh
إنشاء قاعدة بيانات Cloud Firestore واسترداد سلسلة الاتصال
في وحدة تحكُّم Firebase، أنشئ قاعدة بيانات جديدة لإصدار Firestore Enterprise. يتطلّب "Cloud Firestore" إصدار Firestore Enterprise:-
في وحدة تحكُّم Firebase، انتقِل إلى صفحة قاعدة بيانات Firestore.
- انقر على قاعدة البيانات التي تريد مصادقتها.
- في لوحة المستكشف، انقر على عرض المزيد.
- اختَر Connect using MongoDB tools (الربط باستخدام أدوات MongoDB).
- انسخ سلسلة الاتصال.
تعتمد سلسلة الاتصال على معرّف UID لقاعدة البيانات (الذي ينشئه النظام) وموقع قاعدة البيانات:
UID.LOCATION.firestore.goog
إنشاء مستخدم لمصادقة SCRAM
في وحدة تحكّم Google Cloud، أنشئ مستخدمًا جديدًا لقاعدة البيانات وامنحه أذونات إدارة الهوية وإمكانية الوصول.
-
في وحدة تحكّم Google Cloud، انتقِل إلى صفحة قواعد البيانات.
- اختَر قاعدة البيانات من قائمة قواعد البيانات.
- في قائمة التنقّل، انقر على الأمان.
- انقر على إضافة مستخدم.
- أدخِل اسم مستخدم.
- اختَر دورًا في "إدارة الهوية وإمكانية الوصول" للمستخدم.
- انقر على "إنشاء". تنشئ قاعدة البيانات مستخدمًا وتعرض لك كلمة المرور التي تم إنشاؤها للمستخدم. انسخ كلمة المرور هذه واحفظها. لن تتمكّن من استعادة كلمة المرور هذه لاحقًا.
الاتصال باستخدام mongosh
استخدِم سلسلة الاتصال واسم المستخدم وكلمة المرور للاتصال بقاعدة بياناتك، ثم شغِّل mongosh محليًا باستخدام خيارات الضبط التالية.
mongosh 'mongodb://USERNAME:PASSWORD@CONNECTION_STRING:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'
غيِّر القيم في السلسلة على الشكل التالي:
- USERNAME: اسم مستخدم قاعدة البيانات الذي أنشأته
- PASSWORD: كلمة المرور التي تم إنشاؤها لمستخدم قاعدة البيانات الذي أنشأته.
- CONNECTION_STRING: سلسلة اتصال قاعدة البيانات
- DATABASE_ID: معرِّف قاعدة البيانات
بعد الربط، يمكنك إنشاء البيانات وقراءتها، على سبيل المثال:
db.pages.insertOne({ message: "Hello World!"})
db.pages.find({})
exitالخطوات التالية
- الاطّلاع على قائمة بالميزات المتوافقة
- التعرّف على الاختلافات في السلوك في Cloud Firestore
- مزيد من المعلومات عن طرق المصادقة الإضافية