本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Toolkit 中使用 Amazon DocumentDB
<a name="docdb-overview"></a>

Amazon DocumentDB（兼容 MongoDB）是一项快速、可靠的完全托管式数据库服务，可简化在云中设置、操作和扩展与 MongoDB 兼容的数据库的过程。

有关 Amazon DocumentDB 的详细信息、入门信息和教程，请参阅《[Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/what-is.html) 开发人员指南》。

以下各节介绍了如何通过 AWS Toolkit for Visual Studio Code使用 Amazon DocumentDB。

## 通过工具包访问亚马逊 DocumentDB AWS
<a name="docdb-overview-access"></a>

要使用该 AWS 工具包访问 Amazon DocumentDB，请完成以下步骤。

**在工具包中访问亚马逊 DocumentDB AWS**

1. 从 VS Code 中，打开 AWS Toolkit for Visual Studio Code。

1. 在 AWS 工具包中，展开**资源管理器**。

1. 在**浏览器**中，展开 Amazon DocumentDB 以显示您现有的 Amazon DocumentDB 资源。

## 创建基于实例的集群。
<a name="docdb-overview-create-cluster"></a>

要开始使用 Amazon DocumentDB，请完成以下过程来创建一个集群。

**创建基于实例的集群**

1. 从中 AWS Toolkit for Visual Studio Code，打开（右键单击）Amazon DocumentDB 的快捷菜单，然后选择**创建集群**，在 VS Code 中打开 “**创建亚马逊文档数据库**集群” 对话框。

1. 在**集群类型**屏幕上，选择**基于实例的集群**。

1. 在**集群名称**屏幕上，指定新集群的名称。

1. 在**选择引擎版本**屏幕上，选择您的首选 Amazon DocumentDB 引擎版本。

1. 在**管理员用户名和密码**屏幕上，指定管理员用户名和密码以保护集群。

1. 在**指定存储加密**屏幕上，选择是否加密集群。

1. 在**实例数量**屏幕上，配置您的首选实例数量。

1. 在**选择实例类**屏幕上，选择您的首选实例类，然后继续创建新集群。
**注意**  
启动集群可能需要几分钟的时间。

## 复制集群端点
<a name="docdb-overview-create-cluster"></a>

要复制 Amazon DocumentDB 集群端点，请完成以下过程。

**复制集群端点**

1. 从中 AWS Toolkit for Visual Studio Code，展开 **Amazon DocumentDB 以显示您的亚马逊 Docu** mentDB 集群。

1. 右键单击要从中复制连接详细信息的集群，然后选择**复制端点**以将集群端点信息复制到剪贴板。

1. 您的集群端点现在可以粘贴到您的文档中。

## 在浏览器中打开
<a name="docdb-overview-browser-cluster"></a>

在 AWS 控制台中打开您的 Amazon DocumentDB 集群，以获得更多集群管理功能。要在默认网络浏览器中打开您的 Amazon DocumentDB 集群的 AWS 控制台，请完成以下步骤。

**在 AWS 控制台中打开集群**

1. 从中 AWS Toolkit for Visual Studio Code，展开 **Amazon DocumentDB 以显示您的亚马逊 Docu** mentDB 集群。

1. 在 AWS 控制台中右键单击要查看的集群，然后选择**在浏览器中打开**。

1.  AWS 控制台将在您的默认网络浏览器中打开 Amazon DocumentDB 集群。

## 扩展现有集群
<a name="docdb-overview-expand-cluster"></a>

要通过添加实例来扩展 Amazon DocumentDB 集群，请完成以下过程。

**添加实例以扩展集群**

1. 从中 AWS Toolkit for Visual Studio Code，展开 **Amazon DocumentDB 以显示您的亚马逊 Docu** mentDB 集群。

1. 右键单击要扩展的集群，然后选择**添加实例**以在 VS Code 中打开**添加实例**对话框。

1. 出现提示时，在文本字段中输入新实例的名称，然后按 **Enter** 键继续。

1. 出现提示时，从列表中选择实例类以继续。

1. **AWS 各区服务浏览器**会显示创建状态，并在新实例准备就绪后进行更新。

## 停止集群
<a name="docdb-overview-stopping-cluster"></a>

要停止 Amazon DocumentDB 集群，请完成以下过程。

**注意**  
当集群停止时，大多数集群管理功能将不可用。

**停止 Amazon DocumentDB 集群**

1. 从中 AWS Toolkit for Visual Studio Code，展开 **Amazon DocumentDB 以显示您的亚马逊 Docu** mentDB 集群。

1. 选择位于要停止的集群旁边的**停止集群**按钮，或者右键单击集群并选择**停止集群**。

1. 出现提示时，选择**是**以停止集群，或者选择**取消**以取消停止过程并保持集群运行。

1. **AWS 各区服务浏览器**会显示集群状态，并在集群停止后进行更新。

## 重启实例
<a name="docdb-overview-reboot-cluster"></a>

重启实例对于在不影响整个集群的情况下进行故障排除和进行细微更改非常有用。要重启 Amazon DocumentDB 实例，请完成以下过程。

**重启集群实例**

1. 从中 AWS Toolkit for Visual Studio Code，展开 **Amazon DocumentDB 以显示您的亚马逊 Docu** mentDB 集群。

1. 右键单击要重启的集群实例，然后选择**重启实例**。

1. 出现提示时，选择**是**以重启实例，或者选择**取消**以取消重启过程并保持实例停止。

1. **AWS 各区服务浏览器**会显示集群状态，并在实例重启后进行更新。

## 删除实例
<a name="docdb-overview-delete-cluster"></a>

要删除 Amazon DocumentDB 集群实例，请完成以下过程。

**注意**  
删除实例并不会影响集群中的数据。如果您删除主实例，其中一个副本实例将作为可写实例进行接管。

**删除集群实例**

1. 从中 AWS Toolkit for Visual Studio Code，展开 **Amazon DocumentDB 以显示您的亚马逊 Docu** mentDB 集群。

1. 右键单击要删除的集群实例，然后选择**删除**以在 VS Code 中打开 delete-cluster-instance确认对话框。

1. 按照确认提示操作，然后按 **Enter** 键删除集群实例。

1. **AWS 各区服务浏览器**会显示集群实例状态，并在实例被删除后进行更新。

## 查看、添加和删除标签
<a name="docdb-overview-tags"></a>

标签用于组织和跟踪环境中的资源。要查看或编辑与 Amazon DocumentDB 集群关联的标签，请完成下列过程之一。

**查看集群标签**

1. 从中 AWS Toolkit for Visual Studio Code，展开 **Amazon DocumentDB 以显示您的亚马逊 Docu** mentDB 集群。

1. 右键单击要查看其标签的集群，然后选择**标签...** 以打开 ****your cluster name** 的标签**对话框。

1. 标签会显示在对话框窗口中，如果没有标签与集群相关联，则会显示 **[未分配标签]** 这一消息。

**向集群添加标签**

1. 从中 AWS Toolkit for Visual Studio Code，展开 **Amazon DocumentDB 以显示您的亚马逊 Docu** mentDB 集群。

1. 右键单击要为其添加标签的集群，然后选择**标签...** 以打开 ****your cluster name** 的标签**对话框。

1. 选择**添加标签...** 按钮以在 VS Code 中打开**添加标签**对话框。

1. 在文本字段中输入新标签，然后按 **Enter** 键继续。

1. 在文本字段中输入一个值，然后按 E **n** ter 将该 key/value 对添加到您的集群中。

**从集群中删除标签**

1. 从中 AWS Toolkit for Visual Studio Code，展开 **Amazon DocumentDB 以显示您的亚马逊 Docu** mentDB 集群。

1. 右键单击要从中删除标签的集群，然后选择**标签...** 以打开 ****your cluster name** 的标签**对话框。

1. 选择**删除标签...** 按钮以在 VS Code 中打开**从 **your cluster name** 删除标签**对话框。

1. 从提供的列表中选择要删除的标签，将该标签从集群中删除。

## 修改实例类
<a name="docdb-overview-instance-class"></a>

要修改 Amazon DocumentDB 集群实例类，请完成以下过程。

**修改实例类**

1. 从中 AWS Toolkit for Visual Studio Code，展开 **Amazon DocumentDB 以显示您的亚马逊 Docu** mentDB 集群。

1. 右键单击要修改的集群实例，然后选择**修改类...** 以在 VS Code 中打开**选择实例类**对话框。

1. 从列表中为实例选择一个新类来更新该类。

1. **AWS 各区服务浏览器**会显示集群实例状态，并在实例类更新后进行更新。