开始使用 Amazon DocumentDB

登录到 AWS 管理控制台 并打开 Amazon DocumentDB 控制台，网址：https://console.aws.amazon.com/docdb。

在 Amazon DocumentDB 管理控制台上，集群下，选择创建。

在“创建 Amazon DocumentDB 集群”页面上，在集群类型部分中选择基于实例的集群（这是默认选项）。

在集群配置部分中：

1. 在集群标识符中，输入唯一名称，例如 mydocdbcluster。请注意，无论如何输入，控制台都会将所有集群的名称更改为小写。

2. 对于主引擎版本，选择 5.0.0。

在集群存储配置部分，选择 Amazon DocumentDB 标准（此为默认选项）。

在实例配置部分：

1. 对于数据库实例类，选择内存优化类（包括 r 类）（这是默认值）。

   另一个实例选项是 NVMe 支持的类。要了解更多信息，请参阅NVMe 支持的实例。

2. 对于实例类，请选择 db.t3.medium。这符合获得 AWS 免费试用的资格。

3. 对于实例数，选择 1 个实例。选择一个实例有助于成本最小化。如果这是生产系统，我们建议您预配置三个实例以便可用性高。

在连接部分中，保留默认设置：不连接到 EC2 计算资源。

在身份验证部分中，输入主要用户的用户名，然后选择自行管理。输入密码，然后确认密码。

如果您改为选择了在 AWS Secrets Manager 中管理，请参阅 使用 Amazon DocumentDB 进行密码管理以及 AWS Secrets Manager 以了解更多信息。

使其他所有选项保持默认，并选择创建集群。

在 Amazon DocumentDB 管理控制台上的集群下，找到您创建的集群。单击集群旁边的复选框，选择您的集群。

单击连接到集群（位于操作下拉菜单旁边）。只有在您单击集群旁边的复选框并且区域集群和主实例的状态都显示为可用后，才会启用此按钮。将出现 CloudShell 运行命令屏幕。

在新环境名称字段中，输入唯一名称，例如“test”，然后单击创建并运行。将自动为您的 Amazon DocumentDB 数据库配置 VPC 环境详细信息。

出现提示时，输入您在“步骤 1：创建 Amazon DocumentDB 集群”（子步骤 7）中创建的密码。

在您输入密码并且提示符变成 rs0 [direct: primary] <env-name>> 后，表示您已成功连接到您的 Amazon DocumentDB 集群。

要插入单个文档，请输入以下内容：

db.collection.insertOne({"hello":"DocumentDB"})

您会得到以下输出：

{
  acknowledged: true,
  insertedId: ObjectId('673657216bdf6258466b128c')
}

您可以读取您用 findOne() 命令编写过的文档（因为它只返回单个文档）。输入以下：

db.collection.findOne()

您会得到以下输出：

{ "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }

要执行若干更多查询，请考虑游戏个人资料用例。首先，将几个条目插入标题为 profiles 的集合。输入以下：

db.profiles.insertMany([{ _id: 1, name: 'Matt', status: 'active', level: 12, score: 202 }, 
      { _id: 2, name: 'Frank', status: 'inactive', level: 2, score: 9 }, 
      { _id: 3, name: 'Karen', status: 'active', level: 7, score: 87 }, 
      { _id: 4, name: 'Katie', status: 'active', level: 3, score: 27 }
])

您会得到以下输出：

{ acknowledged: true, insertedIds: { '0': 1, '1': 2, '2': 3, '3': 4 } }

使用 find() 命令返回个人资料集合中的所有文档。输入以下：

db.profiles.find()

您将获得将与您在步骤 3 中已键入数据匹配的输出。

利用筛选器对单个文档使用查询。输入以下：

db.profiles.find({name: "Katie"})

您会得到以下输出：

{ "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}

现在，让我们尝试查找个人资料并使用 findAndModify 命令修改它。我们将用以下代码向用户 Matt 给予额外的 10 分：

db.profiles.findAndModify({
        query: { name: "Matt", status: "active"},
        update: { $inc: { score: 10 } }
    })

你得到以下输出（请注意，他的分数尚未增加）：

{
    [{_id : 1, name : 'Matt', status: 'active', level: 12, score: 202}]

你可以借助以下查询验证他的分数是否已变化：

db.profiles.find({name: "Matt"})

您会得到以下输出：

{ "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 }