现已推出具有 MongoDB 兼容性的 Firestore 企业版！
了解详情。
Quickstart: یک پایگاه داده ایجاد کنید و به آن متصل شوید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
| فقط مربوط به Cloud Firestore Enterprise edition. |
یاد بگیرید که چگونه یک Cloud Firestore با پایگاه داده سازگاری MongoDB ایجاد کنید و با ابزار mongosh به آن متصل شوید.
قبل از شروع
- اگر قبلاً این کار را نکرده‌اید، یک پروژه Firebase ایجاد کنید: در کنسول Firebase ، روی افزودن پروژه کلیک کنید، سپس دستورالعمل‌های روی صفحه را برای ایجاد یک پروژه Firebase یا افزودن خدمات Firebase به پروژه Google Cloud موجود دنبال کنید.
- ابزار
mongosh را نصب کنید
یک Cloud Firestore با پایگاه داده سازگاری MongoDB ایجاد کنید و رشته اتصال را بازیابی کنید
در کنسول
Firebase ، یک پایگاه داده جدید نسخه Firestore Enterprise ایجاد کنید. Cloud Firestore با سازگاری MongoDB به نسخه Firestore Enterprise نیاز دارد:
در کنسول Firebase ، به صفحه Firestore Database بروید.
به پایگاه داده Firestore بروید
- روی پایگاه داده ای که می خواهید احراز هویت کنید کلیک کنید.
- در پانل Explorer ، روی more_vert View more کلیک کنید.
- Connect using MongoDB tools را انتخاب کنید.
- رشته اتصال را کپی کنید.
رشته اتصال به UID پایگاه داده (سامانه تولید شده) و محل پایگاه داده بستگی دارد:
UID.LOCATION.firestore.goog
یک کاربر برای احراز هویت SCRAM ایجاد کنید
در کنسول Google Cloud، یک کاربر پایگاه داده جدید ایجاد کنید و مجوزهای Identity و Access Management را به کاربر اختصاص دهید.
در کنسول 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 بعدش چی
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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)"]]
