现已推出具有 MongoDB 兼容性的 Firestore 企业版！
了解详情。
מדריך מהיר: יצירת מסד נתונים וחיבור אליו
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
|
רלוונטי רק למהדורת Cloud Firestore Enterprise.
|
כאן מוסבר איך ליצור מסד נתונים של Cloud Firestore עם תאימות ל-MongoDB ולהתחבר אליו באמצעות הכלי mongosh.
לפני שמתחילים
-
אם עדיין לא עשיתם זאת, אתם צריכים ליצור פרויקט ב-Firebase: במסוף Firebase, לוחצים על הוספת פרויקט ופועלים לפי ההוראות שמופיעות במסך כדי ליצור פרויקט ב-Firebase או כדי להוסיף שירותי Firebase לפרויקט Google Cloud קיים.
- התקנת הכלי
mongosh
יצירת מסד נתונים עם תאימות ל-MongoDB ב-Cloud Firestore ואחזור מחרוזת החיבור
במסוף
Firebase, יוצרים מסד נתונים חדש של מהדורת Firestore Enterprise.
Cloud Firestore עם תאימות ל-MongoDB דורש מהדורת Enterprise של Firestore:
-
במסוף Firebase, עוברים לדף Firestore Database.
מעבר אל Firestore Database
- לוחצים על מסד הנתונים שרוצים לאמת.
- בחלונית Explorer, לוחצים על more_vert View more.
- בוחרים באפשרות Connect using MongoDB tools (התחברות באמצעות כלים של MongoDB).
- מעתיקים את מחרוזת החיבור.
מחרוזת החיבור תלויה ב-UID של מסד הנתונים (שנוצר על ידי המערכת) ובמיקום של מסד הנתונים:
UID.LOCATION.firestore.goog
יצירת משתמש לאימות SCRAM
במסוף Google Cloud, יוצרים משתמש חדש במסד הנתונים ומקצים לו הרשאות של ניהול זהויות וגישה.
-
נכנסים לדף Databases במסוף Google Cloud.
כניסה לדף Databases
- בוחרים את מסד הנתונים מתוך רשימת מסדי הנתונים.
- בתפריט הניווט, לוחצים על Auth (אימות).
- לוחצים על הוספת משתמש.
- מזינים שם משתמש.
- בוחרים תפקיד של ניהול זהויות והרשאות גישה (IAM) למשתמש.
- לוחצים על 'יצירה'. מסד הנתונים יוצר משתמש ומציג את הסיסמה שנוצרה עבורו. מעתיקים ושומרים את הסיסמה הזו. לא תהיה לך אפשרות לשחזר את הסיסמה הזו מאוחר יותר.
התחברות באמצעות 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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-29 (שעון UTC)."],[],[],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)"]]
