Databases for MongoDB 入门
本教程将指导您通过以下步骤快速开始使用 Databases for MongoDB:配置实例、设置管理员密码、连接到实例以及编写和读取简单文档。
请遵循以下步骤来完成教程:
请遵循以下步骤来完成教程:
请遵循以下步骤来完成教程:
请遵循以下步骤来完成教程:
准备工作
- 您需要 IBM Cloud 帐户。
步骤 1: 选择套餐
Databases for MongoDB 提供两种不同的计划:
-
Databases for MongoDB标准是一个完全托管的NoSQL数据库服务,基于MongoDB Community Edition。
-
Databases for MongoDB 企业版提供高级功能,如 MongoDB Ops Manager、分析插件 和 时间点恢复。
使用 API
使用 Cloud Databases API 来处理 Databases for MongoDB 实例。 资源控制器 API 用于 供应实例。
您需要一个 API 密钥才能通过 API 执行操作。 按照 这些步骤创建 IBM Cloud API 密钥,使您能够使用 API 将基础架构调配到您的帐户。 您最多可以创建 20 个 API 密钥。
出于安全原因,API 密钥仅在创建时才可复制或下载。 如果 API 密钥丢失,必须创建新的 API 密钥。
步骤 2: 通过控制台进行供应
-
登录到 IBM Cloud 控制台。
-
在 目录中单击 Databases for MongoDB 服务。
-
按照 以下步骤 配置 Databases for MongoDB 实例。
-
实例配置完成后,单击实例名称可查看更多信息。
步骤 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 文档来写入和读取数据。
后续步骤
-
如果您是第一次使用 MongoDB,请参阅官方 MongoDB 文档。
-
有关最佳实践的指导,请参阅 IBM Cloud MongoDB的最佳实践。
-
通过添加 基于上下文的限制 来确保部署安全。
-
将部署连接到 IBM® Cloud Logs 和 IBM Cloud® Monitoring 以实现可观察性和警报功能。
-
探索 Ops Manager Databases for MongoDB Enterprise Edition 中提供的功能。
-
要查找有关管理数据库的更多工具吗? 使用以下工具连接到您的实例:
-
如果计划在应用程序中使用 Databases for MongoDB,请参阅以下主题:
-
有关在 API 中配置 TLS/SSL 证书的信息,请参阅以下主题:
-
要确保应用程序和数据库的稳定性,请参阅以下主题: