IBM Cloud Docs
Databases for MongoDB 入门

Databases for MongoDB 入门

本教程将指导您通过以下步骤快速开始使用 Databases for MongoDB:配置实例、设置管理员密码、连接到实例以及编写和读取简单文档。

请遵循以下步骤来完成教程:

请遵循以下步骤来完成教程:

请遵循以下步骤来完成教程:

请遵循以下步骤来完成教程:

准备工作

步骤 1: 选择套餐

Databases for MongoDB 提供两种不同的计划:

使用 API

使用 Cloud Databases API 来处理 Databases for MongoDB 实例。 资源控制器 API 用于 供应实例

您需要一个 API 密钥才能通过 API 执行操作。 按照 这些步骤创建 IBM Cloud API 密钥,使您能够使用 API 将基础架构调配到您的帐户。 您最多可以创建 20 个 API 密钥。

出于安全原因,API 密钥仅在创建时才可复制或下载。 如果 API 密钥丢失,必须创建新的 API 密钥。

步骤 2: 通过控制台进行供应

  1. 登录到 IBM Cloud 控制台。

  2. 目录中单击 Databases for MongoDB 服务

  3. 按照 以下步骤 配置 Databases for MongoDB 实例。

  4. 实例配置完成后,单击实例名称可查看更多信息。

步骤 2: 通过 CLI 进行供应

您可以使用 CLI 供应 Databases for MongoDB 实例。 如果尚未安装,那么需要安装 IBM Cloud CLI

您可以按照 这些步骤 来配置 Databases for MongoDB 实例。

步骤 2: 通过资源控制器 API 进行供应

按照 这些步骤,使用资源控制器 API 配置 Databases for MongoDB 实例。

步骤 2: 通过 Terraform 进行供应

通过 Terraform 执行操作需要 API 密钥。 按照 这些步骤创建 IBM Cloud API 密钥,使 Terraform 能够将基础架构配置到您的帐户中。 您最多可以创建 20 个 API 密钥。

出于安全原因,API 密钥仅在创建时才可复制或下载。 如果 API 密钥丢失,必须创建新的 API 密钥。

获得 API 密钥后,请按照 以下步骤 使用 Terraform 配置 Databases for MongoDB 实例。

步骤 3:设置管理员密码

管理用户

提供 Databases for MongoDB 部署时,会自动创建一个 admin 用户。

请先设置管理密码,然后再使用该密码进行连接。

通过用户界面设置管理员密码

通过用户界面设置管理员密码,方法是从 IBM Cloud 资源列表中选择您的实例。 然后,选择 设置。 接下来,选择 更改数据库管理密码

通过 CLI 设置管理员密码

使用 IBM Cloud CLI Cloud Databases 插件中的 cdb user-password 命令来设置管理密码。

例如,要为部署设置管理员密码,请使用以下命令:

ibmcloud cdb user-password <INSTANCE_NAME_OR_CRN> admin <NEWPASSWORD>

通过 API 设置管理员密码

您可以使用上述步骤 2 响应中获得的 id 参数和 Set specified user's password 端点来设置管理员密码。

curl -X PATCH -H "Authorization: Bearer <TOKEN>" \
     -H 'Content-Type: application/json' \
     -d '{"password":"newrootpasswordsupersecure21"}' \
      "https://api.<REGION>.databases.cloud.ibm.com/v5/ibm/deployments/<DEPLOYMENT_ID>/users/database/admin"

id 参数需要使用 URL 编码,上述 API 调用才能正常工作。

通过 Terraform 设置管理员密码

在 Terraform 脚本中,管理员密码作为数据库资源参数之一传入。 无需采取任何进一步行动。

第 4 步:连接到 Databases for MongoDB 实例

您可以使用 Mongo Shell(命令行界面)或 Mongo Compass(用于查询和分析数据的强大图形用户界面)轻松连接到您的实例。 这两个工具都是我的 MongoDB 提供的。

使用 Mongo Shell

按照 这些说明 下载并连接到 Mongo Shell。

然后,您就可以通过将文档插入到集合中来测试您的部署:

use sample_mflix

db.movies.insertOne(
  {
    title: "The Favourite",
    genres: [ "Drama", "History" ],
    runtime: 121,
    rated: "R",
    year: 2018,
    directors: [ "Yorgos Lanthimos" ],
    cast: [ "Olivia Colman", "Emma Stone", "Rachel Weisz" ],
    type: "movie"
  }
)

上述命令会切换到名为 sample_mflix 的数据库(如果还不存在,则会创建),然后在 movies 集合中插入文档(如果还不存在,则也会创建)。

然后,您可以使用

db.movies.find( { title: "The Favourite" } )

现在,您已连接到数据库,并使用 Mongo Shell 写入和读取数据。

使用 MongoDB Compass

按照 这些说明 下载 MongoDB Compass 并使用它连接到 Databases for MongoDB 实例。 您可以使用 MongoDB Compass 文档来写入和读取数据。

后续步骤