现已推出具有 MongoDB 兼容性的 Firestore 企业版！
了解详情。
البداية السريعة: إنشاء قاعدة بيانات والاتصال بها
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
|
ينطبق ذلك على إصدار Cloud Firestore Enterprise فقط.
|
تعرَّف على كيفية إنشاء قاعدة بيانات متوافقة مع MongoDB في Cloud Firestore والاتصال بها باستخدام أداة mongosh.
قبل البدء
-
إذا لم يسبق لك إنشاء مشروع على Firebase، يمكنك إنشاء مشروع باتّباع الخطوات التالية: في Firebaseوحدة التحكّم، انقر على إضافة مشروع، ثم اتّبِع التعليمات الظاهرة على الشاشة لإنشاء مشروع على Firebase أو لإضافة خدمات Firebase إلى مشروع Google Cloud حالي.
- تثبيت أداة
mongosh
إنشاء قاعدة بيانات متوافقة مع MongoDB في Cloud Firestore واسترداد سلسلة الاتصال
في وحدة تحكّم
Firebase، أنشئ قاعدة بيانات جديدة من إصدار Firestore Enterprise.
يتطلّب استخدام Cloud Firestore مع توافق MongoDB إصدار Firestore Enterprise:
-
في وحدة تحكّم Firebase، انتقِل إلى صفحة قاعدة بيانات Firestore.
الانتقال إلى قاعدة بيانات Firestore
- انقر على قاعدة البيانات التي تريد إثبات ملكيتها.
- في لوحة المستكشف، انقر على more_vert عرض المزيد.
- انقر على الربط باستخدام أدوات MongoDB.
- انسخ سلسلة الاتصال.
يعتمد سلسلة الاتصال على المعرّف الفريد لقاعدة البيانات (الذي ينشئه النظام) وموقع قاعدة البيانات:
UID.LOCATION.firestore.goog
إنشاء مستخدم للمصادقة باستخدام SCRAM
في Google Cloud Console، أنشئ مستخدمًا جديدًا لقاعدة البيانات وأسنِد إليه أذونات إدارة الهوية وإمكانية الوصول.
-
في Google Cloud Console، انتقِل إلى صفحة قواعد البيانات.
الانتقال إلى "قواعد البيانات"
- اختَر قاعدة البيانات من قائمة قواعد البيانات.
- في قائمة التنقل، انقر على المصادقة.
- انقر على إضافة مستخدم.
- أدخِل اسم مستخدم.
- اختَر دورًا في "إدارة الهوية وإمكانية الوصول" للمستخدم.
- انقر على "إنشاء". تنشئ قاعدة البيانات مستخدمًا وتعرض لك كلمة المرور التي تم إنشاؤها. انسخ كلمة المرور هذه واحفظها. ولن تتمكّن من استردادها لاحقًا.
الاتصال باستخدام 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
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["\u003cbr /\u003e\n\n\n|--------------------------------------------------------|\n| *Relevant to Cloud Firestore Enterprise edition only.* |\n\n\u003cbr /\u003e\n\nLearn how to create a Cloud Firestore with MongoDB compatibility database and connect to it with the\n`mongosh` tool.\n\nBefore you begin\n\n1. If you haven't already, create a Firebase project: In the [Firebase console](//console.firebase.google.com/), click **Add project** , then follow the on-screen instructions to create a Firebase project or to add Firebase services to an existing Google Cloud project.\n2. [Install the `mongosh` tool](https://www.mongodb.com/docs/mongodb-shell/install/)\n\n\u003cbr /\u003e\n\nCreate a Cloud Firestore with MongoDB compatibility database and retrieve the connection string In the Firebase console, create a new Firestore Enterprise edition database. Cloud Firestore with MongoDB compatibility requires Firestore Enterprise edition:\n1. In the Firebase console, go to the **Firestore Database** page.\n\n [Go to Firestore Database](//console.firebase.google.com/project/_/firestore/databases/-default-/data/)\n2. Click the database that you want to authenticate.\n3. In the **Explorer** panel, click more_vert **View more**.\n4. Select **Connect using MongoDB tools**.\n5. Copy the connection string.\n\n\u003cbr /\u003e\n\nThe connection string depends on the UID of the database (system-generated)\nand the location of database: \n\n```text\nUID.LOCATION.firestore.goog\n```\n\nCreate a user for SCRAM authentication\n\nIn the Google Cloud console, create a new database user and assign\nthe user Identity and Access Management permissions.\n\n1. In the Google Cloud console, go to the **Databases** page.\n\n [Go to Databases](https://console.cloud.google.com/firestore/databases)\n2. Select the database from the list of databases.\n3. In the navigation menu, click **Auth**.\n4. Click **Add User**.\n5. Enter a username.\n6. Select an Identity and Access Management role for the user.\n7. Click create. The database creates a user and shows you the user's generated password. **Copy and save this password. You will not be able to retrieve\n this password later.**.\n\nConnect using `mongosh`\n\nUse the connection string, username, and password to connect to your\ndatabase, run `mongosh` locally with the following configuration options. \n\n```gdscript\nmongosh 'mongodb://\u003cvar translate=\"no\"\u003eUSERNAME\u003c/var\u003e:\u003cvar translate=\"no\"\u003ePASSWORD\u003c/var\u003e@\u003cvar translate=\"no\"\u003eCONNECTION_STRING\u003c/var\u003e:443/\u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eUSERNAME\u003c/var\u003e: the name of the database user you created.\n- \u003cvar translate=\"no\"\u003ePASSWORD\u003c/var\u003e: the generated password for the database user you created.\n- \u003cvar translate=\"no\"\u003eCONNECTION_STRING\u003c/var\u003e: the database connection string.\n- \u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e: a database ID\n\nOnce connected, you can create and read data, for example: \n\n```text\ndb.pages.insertOne({ message: \"Hello World!\"})\ndb.pages.find({})\nexit\n```\n\nWhat's next\n\n- [See a list of supported features](/docs/firestore/enterprise/supported-data-types-drivers)\n- [Learn about behavior differences in Cloud Firestore with MongoDB compatibility](/docs/firestore/enterprise/behavior-differences)\n- [Learn about additional authentication methods](/docs/firestore/enterprise/connect)"]]
