现已推出具有 MongoDB 兼容性的 Firestore 企业版!
了解详情。
快速入門導覽課程:建立並連線至資料庫
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
僅適用於 Cloud Firestore Enterprise 版。
|
瞭解如何建立與 MongoDB 相容的 Cloud Firestore 資料庫,並使用 mongosh
工具連線至該資料庫。
事前準備
-
如果尚未建立 Firebase 專案,請在 Firebase 控制台中按一下「新增專案」,然後按照畫面上的指示建立 Firebase 專案,或將 Firebase 服務新增至現有 Google Cloud 專案。
- 安裝
mongosh
工具
建立與 MongoDB 相容的 Cloud Firestore 資料庫,並擷取連線字串
在
Firebase 控制台中,建立新的 Firestore Enterprise 版資料庫。如要使用與 MongoDB 相容的 Cloud Firestore,必須使用 Firestore Enterprise 版:
-
前往 Firebase 控制台的「Firestore Database」頁面。
前往 Firestore 資料庫
- 按一下要驗證的資料庫。
- 在「Explorer」面板中,按一下 more_vert「View more」。
- 選取「使用 MongoDB 工具連結」。
- 複製連線字串。
連線字串取決於資料庫的 UID (系統產生) 和資料庫位置:
UID.LOCATION.firestore.goog
建立 SCRAM 驗證的使用者
在 Google Cloud 控制台中建立新的資料庫使用者,並指派該使用者的 Identity and Access Management 權限。
-
前往 Google Cloud 控制台的「資料庫」頁面。
前往「資料庫」
- 從資料庫清單中選取資料庫。
- 按一下導覽選單中的「Auth」(驗證)。
- 按一下「新增使用者」。
- 輸入使用者名稱。
- 為使用者選取 Identity and Access Management 角色。
- 按一下「建立」。資料庫會建立使用者,並顯示該使用者產生的密碼。複製並儲存這組密碼。您將無法在日後擷取這組密碼。。
使用 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:資料庫 ID
連線後,您就可以建立及讀取資料,例如:
db.pages.insertOne({ message: "Hello World!"})
db.pages.find({})
exit
後續步驟
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 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)"]]