快速入门:创建数据库并连接到该数据库

仅与 Cloud Firestore 企业版相关。

了解如何创建具有 MongoDB 兼容性的 Cloud Firestore 数据库,以及如何使用 mongosh 工具连接到该数据库。

准备工作

  1. 如果您还没有 Firebase 项目,请创建一个,具体步骤是:在 Firebase 控制台中,点击添加项目,然后按照屏幕上的说明创建 Firebase 项目或将 Firebase 服务添加到现有 Google Cloud 项目。
  2. 安装 mongosh 工具

创建与 MongoDB 兼容的 Cloud Firestore 数据库并检索连接字符串

Firebase 控制台中,创建新的 Firestore 企业版数据库。 与 MongoDB 兼容的 Cloud Firestore 需要 Firestore 企业版:
  1. Firebase 控制台中,前往 Firestore 数据库页面。

    前往 Firestore 数据库

  2. 点击要进行身份验证的数据库。
  3. 探索器面板中,点击 查看更多
  4. 选择使用 MongoDB 工具连接
  5. 复制连接字符串。

连接字符串取决于数据库的 UID(系统生成的)和数据库的位置:

UID.LOCATION.firestore.goog

为 SCRAM 身份验证创建用户

在 Google Cloud 控制台中,创建新的数据库用户并为该用户分配 Identity and Access Management 权限。

  1. 在 Google Cloud 控制台中,转到数据库页面。

    前往“数据库”

  2. 从数据库列表中选择数据库。
  3. 在导航菜单中,点击 Auth
  4. 点击 Add User(添加用户)。
  5. 输入用户名。
  6. 为用户选择 Identity and Access Management 角色。
  7. 点击“创建”。数据库会创建一个用户,并向您显示该用户生成的密码。复制并保存此密码。您日后将无法找回此密码。

使用 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

后续步骤