现已推出具有 MongoDB 兼容性的 Firestore 企业版!
了解详情。
快速入门:创建数据库并连接到该数据库
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
仅与 Cloud Firestore 企业版相关。
|
了解如何创建具有 MongoDB 兼容性的 Cloud Firestore 数据库,以及如何使用 mongosh
工具连接到该数据库。
准备工作
-
如果您还没有 Firebase 项目,请创建一个,具体步骤是:在 Firebase 控制台中,点击添加项目,然后按照屏幕上的说明创建 Firebase 项目或将 Firebase 服务添加到现有 Google Cloud 项目。
- 安装
mongosh
工具
创建与 MongoDB 兼容的 Cloud Firestore 数据库并检索连接字符串
在
Firebase 控制台中,创建新的 Firestore 企业版数据库。
与 MongoDB 兼容的 Cloud Firestore 需要 Firestore 企业版:
-
在 Firebase 控制台中,前往 Firestore 数据库页面。
前往 Firestore 数据库
- 点击要进行身份验证的数据库。
- 在探索器面板中,点击 more_vert 查看更多。
- 选择使用 MongoDB 工具连接。
- 复制连接字符串。
连接字符串取决于数据库的 UID(系统生成的)和数据库的位置:
UID.LOCATION.firestore.goog
为 SCRAM 身份验证创建用户
在 Google Cloud 控制台中,创建新的数据库用户并为该用户分配 Identity and Access Management 权限。
-
在 Google Cloud 控制台中,转到数据库页面。
前往“数据库”
- 从数据库列表中选择数据库。
- 在导航菜单中,点击 Auth。
- 点击 Add User(添加用户)。
- 输入用户名。
- 为用户选择 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
后续步骤
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-29。
[null,null,["最后更新时间 (UTC):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)"]]