本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 管理 Amazon DocumentDB 实例
以下主题提供可帮助您管理 Amazon DocumentDB 实例的信息。其中包括有关实例类和状态的详细信息，以及如何创建、删除和修改实例。
**Topics**
+ [确定实例的状态](#db-instance-status)
+ [实例生命周期](db-instance-life-cycle.md)
+ [管理实例类](db-instance-classes.md)
+ [NVMe 支持的实例](db-instance-nvme.md)
## 确定实例的状态
要查看有效实例的状态、其含义以及如何确定您的实例的状态，请参阅[监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
# Amazon DocumentDB 实例生命周期
Amazon DocumentDB 实例的生命周期包括创建、修改、维护并升级、执行备份和还原、重启以及删除实例。本节提供有关如何完成这些过程的信息。
**Topics**
+ [添加实例](db-instance-add.md)
+ [描述实例](db-instance-view-details.md)
+ [修改实例](db-instance-modify.md)
+ [重启实例](db-instance-reboot.md)
+ [删除实例](db-instance-delete.md)
您可以使用 AWS 管理控制台 或创建新的 Amazon DocumentDB 实例。 AWS CLI要将实例添加到集群，该集群必须处于*可用* 状态。您无法将实例添加到已停止的集群。如果集群已停止，则首先启动集群，等待集群进入*可用* 状态，然后添加实例。有关更多信息，请参阅 [停止和启动 Amazon DocumentDB 集群](db-cluster-stop-start.md)。
**注意**
如果您使用控制台创建 Amazon DocumentDB 集群，则同时会自动为您创建实例。如果您要创建其他实例，请使用以下过程之一。
# 向集群添加 Amazon DocumentDB 实例
------
#### [ Using the AWS 管理控制台 ]
使用以下过程通过 Amazon DocumentDB 控制台为集群创建实例。
1. [登录 AWS 管理控制台，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. 在导航窗格中，选择**集群**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 要选择希望将实例添加到的集群，请选择该集群名称左侧的按钮。
1. 选择 **Actions (操作)**，然后选择 **Add instance (添加实例)**。
1. 在 **Add instance to: (将实例添加到:)** 页面中，对要添加到集群的每个实例重复以下步骤。您最多可以有 15。
1. **Instance identifier (实例标识符)**：您可以输入此实例的唯一标识符，或允许 Amazon DocumentDB 基于集群标识符提供实例标识符。
实例命名约束：
+ 长度为 [1-63] 个字母、数字或连字符。
+ 第一个字符必须是字母。
+ 不能以连字符结尾或包含两个连续的连字符。
+ 每个区域的 Amazon RDS、Neptune 和 Amazon DocumentDB 中的所有实例都必须是唯一 AWS 账户的。
1. **Instance class (实例类)**：从下拉列表中，为该实例选择所需的实例类型。
1. **Promotion tier (提升层)**：从下拉列表中，选择该实例的提升层，或者选择* No preference (无首选项) *以允许 Amazon DocumentDB 为您的实例设置提升层。数字越小，意味着优先级越高。有关更多信息，请参阅 [控制失效转移目标](failover.md#failover-target_control)。
1. 要添加更多实例，请选择 **Add additional instances (添加额外实例)**，并重复步骤 a、b 和 c。
1. 完成此操作。
+ 要将实例添加到集群，请选择 **Create (创建)**。
+ 要取消操作，请选择**取消**。
创建实例需要几分钟时间。您可以使用控制台或 AWS CLI 查看实例的状态。有关更多信息，请参阅 [监控实例的状态](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
使用带有以下参数的`create-db-instance` AWS CLI 操作为您的集群创建主实例。
+ **--db-instance-class**：必需。实例的计算和内存容量，例如，`db.m4.large`。并非所有实例类在所有 AWS 区域中都可用。
+ **--db-instance-identifier**：必需。标识实例的一个 字符串。
实例命名约束：
+ 长度为 [1-63] 个字母、数字或连字符。
+ 第一个字符必须是字母。
+ 不能以连字符结尾或包含两个连续的连字符。
+ 每个区域的 Amazon RDS、Neptune 和 Amazon DocumentDB 中的所有实例都必须是唯一 AWS 账户的。
+ **--engine**：必需。必须是 `docdb`。
+ **--availability-zone**：可选。要在其中创建此实例的可用区。使用此参数在不同可用区中找到您的实例，以增强容错能力。有关更多信息，请参阅 [Amazon DocumentDB 高可用性和复制](replication.md)。
+ **--promotion-tier**：可选。此实例的失效转移优先级层。必须介于 0 与 15 之间，数字越小，优先级越高。有关更多信息，请参阅 [控制失效转移目标](failover.md#failover-target_control)。
1. **首先，确定您可以在哪些可用区中创建您的实例。**
如果要在创建实例前指定可用区，请运行以下命令以确定哪些可用区可用于您的 Amazon DocumentDB 集群。
对于 Linux、macOS 或 Unix：
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
对于 Windows：
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
此操作的输出将类似于下文。
```
[
[
"sample-cluster",
[
"us-east-1c",
"us-east-1b",
"us-east-1a"
]
]
]
```
1. **其次，确定您可以在您的区域中创建哪些实例类。**
要确定您所在区域中可用的实例类，请运行以下命令。从输出中，为要添加到 Amazon DocumentDB 集群的实例选择实例类。
对于 Linux、macOS 或 Unix：
```
aws docdb describe-orderable-db-instance-options \
--engine docdb \
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
对于 Windows：
```
aws docdb describe-orderable-db-instance-options ^
--engine docdb ^
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
此操作的输出将类似于下文。
```
[
"db.r5.16xlarge",
"db.r5.2xlarge",
"db.r5.4xlarge",
"db.r5.8xlarge",
"db.r5.large",
"db.r5.xlarge"
]
```
1. **最后，将实例添加到您的 Amazon DocumentDB 集群。**
要将实例添加到您的 Amazon DocumentDB 集群，请运行以下命令。
对于 Linux、macOS 或 Unix：
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-instance-2 \
--availability-zone us-east-1b \
--promotion-tier 2 \
--db-instance-class db.r5.xlarge \
--engine docdb
```
对于 Windows：
```
aws docdb create-db-instance ^
--db-cluster-identifier sample-cluster ^
--db-instance-identifier sample-instance-2 ^
--availability-zone us-east-1b ^
--promotion-tier 2 ^
--db-instance-class db.r5.xlarge ^
--engine docdb
```
此操作的输出将类似于下文。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.xlarge",
"Engine": "docdb",
"DBInstanceStatus": "creating",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1b",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2"
}
}
```
创建实例需要几分钟时间。您可以使用控制台或 AWS CLI 查看实例的状态。有关更多信息，请参阅 [监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------
# 描述 Amazon DocumentDB 实例
您可以使用 Amazon DocumentDB 管理控制台或查看与您的 Amazon DocumentDB 实例相关的连接终端节点、安全组 VPCs、证书颁发机构和参数组等详细信息。 AWS CLI
------
#### [ Using the AWS 管理控制台 ]
要使用 AWS 管理控制台查看实例的详细信息，请执行以下步骤。
1. [登录 AWS 管理控制台，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. 在导航窗格中，选择 **Clusters（集群）**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 在集群导航框中，您将看到“**集群标识符**”列。您的实例列于集群下，类似于以下屏幕截图。
![\[“集群”表，显示了“集群标识符”列下的集群列表，其中实例嵌套在集群内。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/choose-clusters.png)
1. 在实例列表中，选择要查看其详细信息的实例的名称。有关实例的信息分为以下几组：
+ **Summary (摘要)**：有关实例的一般信息，包括引擎版本、类、状态和所有待处理维护。
+ **Connectivity & Security (连接性和安全性)**：**Connect (连接) **部分列出要使用 mongo Shell 或应用程序连接到此实例的连接端点。**Security Groups (安全组)** 部分列出与此实例关联的安全组及其 VPC ID 和描述。
+ **配置**：**详情**部分列出了实例的配置和状态，包括实例的 Amazon 资源名称 (ARN)、端点、角色、类和证书颁发机构。其中还列出实例的安全性和网络设置以及备份信息。**Cluster details (集群详细信息)** 部分列出此实例所属集群的详细信息。**Cluster instances (集群实例)** 部分列出属于集群的所有实例，其中包括每个实例的角色和集群参数组状态。
**注意**
您可以通过选择紧邻 **集群详情**标题的**修改**，修改与您的实例关联的集群。有关更多信息，请参阅 [修改 Amazon DocumentDB 集群](db-cluster-modify.md)。
+ **监控**- CloudWatch 记录此实例的指标。有关更多信息，请参阅 [使用以下方式监控亚马逊 DocumentDB CloudWatch](cloud_watch.md)。
+ **事件和标签**：**最近事件**部分列出了这个实例的最近事件。Amazon DocumentDB 记录与集群、实例、快照、安全组和集群参数组相关的事件。此信息包括与每个事件关联的日期、时间和消息。**Tags (标签)** 部分列出附加该集群的标签。有关更多信息，请参阅 [标记 Amazon DocumentDB 资源](tagging.md)。
------
#### [ Using the AWS CLI ]
要使用查看您的 Amazon DocumentDB 实例的详细信息 AWS CLI，请使用如下示例所示的`describe-db-clusters`命令。有关更多信息，请参阅 *Amazon DocumentDB 资源管理 API 参考*中的 [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html)。
**注意**
对于某些管理功能（如集群和实例生命周期管理），Amazon DocumentDB 利用与 Amazon RDS 共享的操作技术。`filterName=engine,Values=docdb` 筛选条件参数仅返回 Amazon DocumentDB 集群。
1. **列出所有 Amazon DocumentDB 实例。**
以下 AWS CLI 代码列出了某个区域中所有 Amazon DocumentDB 实例的详细信息。
对于 Linux、macOS 或 Unix：
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
对于 Windows：
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
1. **列出指定 Amazon DocumentDB 实例的所有详细信息**
以下代码列出了 `sample-cluster-instance` 的详细信息。将 `--db-instance-identifier` 参数包含在实例名称中，会将输出限制为该特定实例的信息。
对于 Linux、macOS 或 Unix：
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
对于 Windows：
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
此操作的输出将类似于以下内容：
```
{
"DBInstances": [
{
"DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
"DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"DBInstanceClass": "db.r5.large",
"DBInstanceStatus": "creating",
"AutoMinorVersionUpgrade": true,
"PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
"BackupRetentionPeriod": 1,
"StorageEncrypted": true,
"DBClusterIdentifier": "sample-cluster",
"EngineVersion": "3.6.0",
"AvailabilityZone": "us-east-1a",
"Engine": "docdb",
"PromotionTier": 2,
"DBInstanceIdentifier": "sample-cluster-instance",
"PreferredBackupWindow": "00:00-00:30",
"PubliclyAccessible": false,
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"Subnets": [
{
"SubnetIdentifier": "subnet-4e26d263",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-afc329f4",
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-53ab3636",
"SubnetAvailabilityZone": {
"Name": "us-east-1d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-991cb8d0",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-29ab1025",
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupDescription": "default",
"SubnetGroupStatus": "Complete"
},
"PendingModifiedValues": {},
"KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
}
]
}
```
------
# 修改 Amazon DocumentDB 实例
您可以使用 AWS 管理控制台 或修改您的 Amazon DocumentDB 实例。 AWS CLI要修改某个实例，该实例必须处于*可用* 状态。您无法修改已停止的实例。如果集群已停止，则首先启动集群，等待实例进入*可用* 状态，然后进行所需修改。有关更多信息，请参阅 [停止和启动 Amazon DocumentDB 集群](db-cluster-stop-start.md)。
------
#### [ Using the AWS 管理控制台 ]
要使用控制台修改特定的 Amazon DocumentDB 实例，请完成以下步骤。
1. [登录 AWS 管理控制台，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. 在导航窗格中，选择 **Clusters（集群）**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 在集群导航框中，您将看到“**集群标识符**”列。您的实例列于集群下，类似于以下屏幕截图。
![\[“集群”表，显示了“集群标识符”列下的集群列表，其中实例嵌套在集群内。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/choose-clusters.png)
1. 勾选您希望修改的实例左侧的复选框。
1. 选择 **Actions (操作)**，然后选择 **Modify (修改)**。
1. 在 **Modify instance: (修改实例: >)** 窗格中，进行所需更改。您可以进行以下更改：
+ **实例规范**：实例标识符和类。实例标识符命名约束：
+ **实例标识符**-输入一个名称，该名称对于您在 AWS 账户 当前地区拥有的所有实例都具有唯一性。实例标识符必须包含 [1-63] 个字母数字字符或连字符，以字母作为首字符，并且不能以连字符结尾或不能包含两个连续连字符。
+ **实例类**：从下拉菜单中，为您的 Amazon DocumentDB 实例选择一个实例类。有关更多信息，请参阅 [管理实例类](db-instance-classes.md)。
+ **证书颁发机构**：此实例的服务器证书。有关更多信息，请参阅 [更新您的 Amazon DocumentDB TLS 证书](ca_cert_rotation.md)。
+ **失效转移**：在失效转移期间，具有最高提升层的实例将被提升为主实例。有关更多信息，请参阅 [Amazon DocumentDB 失效转移](failover.md)。
+ **维护**：在维护窗口中将待处理的修改或修补程序应用于集群中的实例。
1. 完成后，选择 **Continue (继续)** 以查看更改摘要。
1. 在确认您的更改后，您可以立即应用这些更改，也可以在 **Scheduling of modifications (修改计划)** 下的下一个维护时段内应用这些更改。选择 **Modify instance (修改实例)** 以保存更改。或者，您可以选择 **Cancel (取消)** 以放弃更改。
需要几分钟时间才能应用更改。只有在实例状态为 *available (可用)* 时，才能使用实例。您可以使用控制台或 AWS CLI监控实例状态。有关更多信息，请参阅 [监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
要使用修改特定的 Amazon DocumentDB 实例 AWS CLI，请使用`modify-db-instance`带以下参数的。有关更多信息，请参阅[修改DBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html)。以下代码为实例 `sample-instance` 将实例类修改为 `db.r5.large`。
**参数**
+ **--db-instance-identifier**：必需。要修改的实例的标识符。
+ **--db-instance-class**：可选。实例的新计算和内存容量；例如，`db.r5.large`。并非所有实例类型在所有 AWS 区域中都可用。如果您修改实例类，则在更改期间会发生中断。更改在下一个维护时段内应用，除非此请求的 `ApplyImmediately` 指定为真实。
+ **--apply-immediately** 或 **--no-apply-immediately**：可选。指定应立即应用此修改，还是等到下一个维护时段。如果省略此参数，则会在下一个维护时段执行修改。
**Example**
对于 Linux、macOS 或 Unix：
```
aws docdb modify-db-instance \
--db-instance-identifier sample-instance \
--db-instance-class db.r5.large \
--apply-immediately
```
对于 Windows：
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-instance ^
--db-instance-class db.r5.large ^
--apply-immediately
```
此操作的输出将类似于下文。
```
{
"DBInstances": [
{
"DBInstanceIdentifier": "sample-instance-1",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "modifying",
"Endpoint": {
"Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-01-10T22:18:55.921Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1a",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:10:57-sun:11:27",
"PendingModifiedValues": {
"DBInstanceClass": "db.r5.large"
},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
]
}
```
需要几分钟时间才能应用修改。只有在实例状态为 *available (可用)* 时，才能使用实例。您可以使用 AWS 管理控制台 或监控实例的状态 AWS CLI。有关更多信息，请参阅 [监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------
# 重启 Amazon DocumentDB 实例
有时您可能需要重启 Amazon DocumentDB 实例，这通常是出于维护原因。如果您进行了某些更改，例如更改与集群关联的集群参数组，则必须重启集群中的实例才能使更改生效。您可以使用 AWS 管理控制台 或重启指定的实例 AWS CLI。
重启实例会重新启动数据库引擎服务。重启将导致短暂中断，在此期间，实例的状态将设置为 `rebooting`。重新启动完成后，即会创建 Amazon DocumentDB 事件。
重启实例不会导致失效转移。要对 Amazon DocumentDB 集群进行故障转移，请使用 AWS 管理控制台 或操作。 AWS CLI `failover-db-cluster`有关更多信息，请参阅 [Amazon DocumentDB 失效转移](failover.md)。
如果实例未处于 *available (可用)* 状态，则无法重启该实例。数据库可能会由于几个原因而不可用，例如，以前请求的修改或维护时段操作。有关实例状态的更多信息，请参阅[监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS 管理控制台 ]
以下过程将使用控制台重启您指定的实例。
1. [登录 AWS 管理控制台，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. 在导航窗格中，选择 **Clusters（集群）**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 在集群导航框中，您将看到“**集群标识符**”列。您的实例列于集群下，类似于以下屏幕截图。
![\[“集群”表，显示了“集群标识符”列下的集群列表，其中实例嵌套在集群内。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/choose-clusters.png)
1. 勾选您希望重启的实例左侧的复选框。
1. 选择 **Actions (操作)**、**Reboot (重启)**，然后选择 **Reboot (重启)** 以确认重启。
实例重启需要几分钟时间。只有在实例状态为 *available (可用)* 时，才能使用实例。您可以使用控制台或 AWS CLI监控实例状态。有关更多信息，请参阅 [监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
要重启 Amazon DocumentDB 实例，请使用具有 `--db-instance-identifier` 参数的 `reboot-db-instance` 操作。此参数指定要重启的实例的标识符。
以下代码将重启实例 `sample-instance`。
**Example**
对于 Linux、macOS 或 Unix：
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-instance
```
对于 Windows：
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-instance
```
此操作的输出将类似于下文。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "rebooting",
"Endpoint": {
"Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
实例重启需要几分钟时间。只有在实例状态为 *available (可用)* 时，才能使用实例。您可以使用控制台或 AWS CLI监控实例状态。有关更多信息，请参阅 [监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------
# 删除 Amazon DocumentDB 实例
您可以使用 AWS 管理控制台 或删除您的 Amazon DocumentDB 实例。 AWS CLI要删除某个实例，该实例必须处于*可用* 状态。您无法删除已停止的实例。如果包含您的实例的 Amazon DocumentDB 集群已停止，则首先启动集群，等待实例进入*可用*状态，然后删除实例。有关更多信息，请参阅 [停止和启动 Amazon DocumentDB 集群](db-cluster-stop-start.md)。
**注意**
Amazon DocumentDB 将所有数据都存储在集群卷中。即使您从集群中删除所有实例，数据仍会保留在该集群卷中。如果您需要再次访问数据，则可随时向该集群中添加实例，并在停止处恢复操作。
------
#### [ Using the AWS 管理控制台 ]
以下过程使用控制台删除指定的 Amazon DocumentDB 实例。
1. [登录 AWS 管理控制台，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. 在导航窗格中，选择 **Clusters（集群）**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 在集群导航框中，您将看到“**集群标识符**”列。您的实例列于集群下，类似于以下屏幕截图。
![\[“集群”表，显示了“集群标识符”列下的集群列表，其中实例嵌套在集群内。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/choose-clusters.png)
1. 勾选您希望删除的实例左侧的复选框。
1. 选择 ** Actions (操作)**，然后选择 **Delete (删除)**。
1. 如果您要删除集群中的最后一个实例：
+ **Create final cluster snapshot? (是否创建最终集群快照?)** — 如果要在删除集群之前创建最终快照，请选择** Yes (是)**。否则，请选择 **No**。
+ **Final snapshot name (最终快照名称)**：如果您选择创建最终快照，请输入所创建的新集群快照的集群快照标识符。
+ **Delete instance? (是否删除 实例?)** — 在此字段中输入** delete entire cluster (删除整个集群) **短语以确认删除。
1. 如果您不删除集群中的最后一个实例：
+ **Delete instance? (是否删除 实例?)** — 在此字段中输入** delete me (删除我)** 短语以确认删除。
1. 选择 **Delete (删除)** 以删除实例。
删除实例需要几分钟时间。要监控实例的状态，请参阅[监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
以下过程使用 AWS CLI删除 Amazon DocumentDB 实例。
1. **首先，确定您的 Amazon DocumentDB 集群中有多少个实例：**
要确定集群中有多少个实例，请运行 `describe-db-clusters` 命令，如下所示。
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
此操作的输出将类似于下文。
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
1. **如果您的 Amazon DocumentDB 集群中有多个实例：**
要删除指定的 Amazon DocumentDB 实例，请使用带 `--db-instance-identifier` 参数的 `delete-db-instance` 命令，如下所示。删除实例需要几分钟时间。要监控实例的状态，请参阅[监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance-2
```
此操作的输出将类似于下文。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "deleting",
"Endpoint": {
"Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
1. **如果要删除的实例是 Amazon DocumentDB 集群中的最后一个实例：**
如果您删除 Amazon DocumentDB 集群中的最后一个实例，则还会删除该集群以及与该集群关联的自动快照和持续备份。
要删除集群中的最后一个实例，您可以删除此集群并可以选择创建最终快照。有关更多信息，请参阅 [删除 Amazon DocumentDB 集群](db-cluster-delete.md)。
------
## 删除保护
删除 Amazon DocumentDB 集群的最后一个实例也将删除该集群，以及与该集群关联的自动快照和连续备份。无论您使用还是执行删除操作，Amazon DocumentDB 都会对集群强制执行删除保护。 AWS 管理控制台 AWS CLI如果已启用删除保护，则无法删除集群。
要删除启用了删除保护的实例，首先请修改该集群并禁用删除保护。有关更多信息，请参阅 [删除 Amazon DocumentDB 集群](db-cluster-delete.md)。
# 管理实例类
该实例类确定 Amazon DocumentDB（与 MongoDB 兼容）实例的计算和内存容量。您需要的实例类取决于您的处理能力和内存要求。
Amazon DocumentDB 支持 R4、R5、R6G、R8G、T3 和 T4G 系列的实例类。这些是最新一代的实例类，针对内存密集型应用程序进行了优化。有关这些实例类的规格，请参阅 [实例类规格](#db-instance-class-specs)。
**Topics**
+ [确定实例类](#db-instance-class-determining)
+ [更改实例的类](#db-instance-class-changing)
+ [不同区域支持的实例类](#db-instance-classes-by-region)
+ [实例类规格](#db-instance-class-specs)
## 确定实例类
要确定实例的类别，您可以使用 AWS 管理控制台 或`describe-db-instances` AWS CLI 操作。
------
#### [ Using the AWS 管理控制台 ]
要确定您的集群实例的实例类，请在控制台中完成以下步骤。
1. [登录 AWS 管理控制台，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. 在导航窗格中，选择**集群**以找到您感兴趣的实例。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 在集群导航框中，您将看到“**集群标识符**”列。您的实例列于集群下，类似于以下屏幕截图。
![\[“集群”表，显示了如何在集群下嵌套实例。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/choose-clusters.png)
1. 在实例列表中，展开集群以找到您感兴趣的实例。查找您想要的实例。然后查看实例行的 **大小** 列，以看到实例类。
在下图中，实例 `robo3t` 的实例类为 `db.r5.4xlarge`。
![\[“集群”表中的实例列表，其中“大小”列显示了实例类型。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/instance-class.png)
------
#### [ Using the AWS CLI ]
要使用确定实例的类别 AWS CLI，请使用带有以下参数的`describe-db-instances`操作。
+ **--db-instance-identifier**— 可选。指定要查找其实例类的实例。如果省略该参数，`describe-db-instances` 将返回最多 100 个实例的描述。
+ **--query**：可选。指定结果中要包含的实例成员。如果省略该参数，则返回所有实例成员。
**Example**
以下示例为实例 `sample-instance-1` 找到实例名称和类。
对于 Linux、macOS 或 Unix：
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--db-instance-identifier sample-instance-1
```
对于 Windows：
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--db-instance-identifier sample-instance-1
```
此操作的输出将类似于下文。
```
[
[
"sample-instance-1",
"db.r5.large"
]
```
**Example**
以下示例为多达 100 个 Amazon DocumentDB 实例找到实例名称和类。
对于 Linux、macOS 或 Unix：
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--filter Name=engine,Values=docdb
```
对于 Windows：
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--filter Name=engine,Values=docdb
```
此操作的输出将类似于下文。
```
[
[
"sample-instance-1",
"db.r5.large"
],
[
"sample-instance-2",
"db.r5.large"
],
[
"sample-instance-3",
"db.r5.4xlarge"
],
[
"sample-instance-4",
"db.r5.4xlarge"
]
]
```
有关更多信息，请参阅 [描述 Amazon DocumentDB 实例](db-instance-view-details.md)。
------
## 更改实例的类
您可以使用 AWS 管理控制台 或更改实例的实例类别 AWS CLI。有关更多信息，请参阅 [修改 Amazon DocumentDB 实例](db-instance-modify.md)。
## 不同区域支持的实例类
Amazon DocumentDB 支持以下数据库实例类：
+ `R8G`—最新一代内存优化型实例由基于 ARM 的 AWS Graviton4 处理器提供支持，其性能比 R6G 实例提高多达 30%。
+ `R6G`—由基于 ARM 的 AWS Graviton2 处理器提供支持的内存优化型实例，其性能比 R5 实例提高多达 30%，成本降低 5%。
+ `R6GD`—内存优化型 R6G 实例，具有基于本地非易失性存储器 express (NVMe) 的固态硬盘 (SSD) 存储，用于存储临时数据。
+ `R5`：对于相同实例成本提供胜过 R4 实例多达 100% 更好性能的内存优化型实例。
+ `R4`：上一代内存优化型实例。
+ `T4G`—最新一代低成本可突发通用实例类型由基于 ARM 的 AWS Graviton2 处理器提供支持，可提供基准 CPU 性能，性价比比 T3 实例高出 35%，非常适合运行 CPU 使用率中等、使用量暂时激增的应用程序。
+ `T3`：低成本可突增通用实例类型，它提供基准级别的 CPU 性能，有能力根据需要随时突增 CPU 使用率。
有关实例类的详细规格，请参阅 [实例类规格](#db-instance-class-specs)。
**注意**
I/O 优化存储仅在引擎版本 5.0 和 8.0（基于实例的集群）上可用。
特定实例类在给定区域可能受或可能不受支持。下表指定了在每个区域哪些实例类受 Amazon DocumentDB 支持。
**不同区域支持的实例类**
| | 实例类 | Region | R8G | R6GD | R6G | R5 | R4 | T4G | T3 | Serverless |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 美国东部（俄亥俄州） | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
| 美国东部（弗吉尼亚州北部） | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
| 美国西部（俄勒冈州） | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
| 非洲（开普敦） | | | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 南美洲（圣保罗） | | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 亚太地区（香港） | | | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 亚太地区（海得拉巴） | | | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 亚太地区（马来西亚） | | | 支持 | | | 支持 | 支持 | |
| 亚太地区（孟买） | 支持 | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 亚太地区（大阪） | | 支持 | 支持 | 支持 | | 支持 | 支持 | |
| 亚太地区（首尔） | 支持 | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 亚太地区（悉尼） | 支持 | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 亚太地区（雅加达） | 支持 | 支持 | 支持 | 支持 | | 支持 | 支持 | |
| 亚太地区（墨尔本） | | | 支持 | 支持 | | 支持 | 支持 | |
| 亚太地区（新加坡） | 支持 | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 亚太地区（泰国） | | | 支持 | | | 支持 | 支持 | |
| 亚太地区（东京） | 支持 | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 加拿大（中部） | | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 欧洲地区（法兰克福） | 支持 | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 欧洲（苏黎世） | | 支持 | 支持 | 支持 | | 支持 | 支持 | |
| 欧洲地区（爱尔兰） | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
| 欧洲地区（伦敦） | | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 欧洲地区（米兰） | | | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 欧洲地区（巴黎） | | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 欧洲（西班牙） | 支持 | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 欧洲地区（斯德哥尔摩） | 支持 | 支持 | 支持 | 支持 | | 支持 | 支持 | |
| 墨西哥（中部） | | | 支持 | | | 支持 | 支持 | |
| 中东（阿联酋）： | | | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 中国（北京） | | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 中国（宁夏） | | | 支持 | 支持 | | 支持 | 支持 | 支持 |
| 以色列（特拉维夫） | | | 支持 | 支持 | | 支持 | 支持 | 支持 |
| AWS GovCloud （美国西部） | 支持 | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
| AWS GovCloud （美国东部） | | 支持 | 支持 | 支持 | | 支持 | 支持 | 支持 |
## 实例类规格
下表提供 Amazon DocumentDB 实例类的详细信息，包括每个类支持哪些实例类型。可在表下方找到每个表列的说明。
| 实例类 | vCPU1 | 内存 (GiB)2 | NVMe 固态硬盘分层缓存 (GiB) 3 | 最大存储温度 (GiB) 4 | 基准/突增带宽（Gbps）5 | 支持引擎 6 |
| --- | --- | --- | --- | --- | --- | --- |
| R8G：基于 Graviton4 的当前代内存优化型实例类 R8G 是最新的实例系列 (Graviton4)，仅在引擎版本 5.0 和 8.0 上可用。db.r8g.24xlarge 和 db.r8g.48xlarge 的尺寸尚不可用。 |
| db.r8g.large | 2 | 16 | - | 30 | 0.937 / 12.5 | 5.0.0 和 8.0.0 |
| db.r8g.xlarge | 4 | 32 | - | 60 | 1.875 / 12.5 | 5.0.0 和 8.0.0 |
| db.r8g.2xlarge | 8 | 64 | - | 121 | 3.75 / 15.0 | 5.0.0 和 8.0.0 |
| db.r8g.4xlarge | 16 | 128 | - | 243 | 7.5 / 15.0 | 5.0.0 和 8.0.0 |
| db.r8g.8xlarge | 32 | 256 | - | 488 | 15 | 5.0.0 和 8.0.0 |
| db.r8g.12xlarge | 48 | 384 | - | 732 | 22 | 5.0.0 和 8.0.0 |
| db.r8g.16xlarge | 64 | 512 | - | 987 | 30 | 5.0.0 和 8.0.0 |
| R6G：基于 Graviton2 的当前代内存优化型实例类 |
| db.r6g.large | 2 | 16 | - | 32 | 0.75/ 10 | 4.0.0、5.0.0 和 8.0.0 |
| db.r6g.xlarge | 4 | 32 | - | 63 | 1.25/ 10 | 4.0.0、5.0.0 和 8.0.0 |
| db.r6g.2xlarge | 8 | 64 | - | 126 | 2.5/ 10 | 4.0.0、5.0.0 和 8.0.0 |
| db.r6g.4xlarge | 16 | 128 | - | 252 | 5.0/ 10 | 4.0.0、5.0.0 和 8.0.0 |
| db.r6g.8xlarge | 32 | 256 | - | 504 | 12 | 4.0.0、5.0.0 和 8.0.0 |
| db.r6g.12xlarge | 48 | 384 | - | 756 | 20 | 4.0.0、5.0.0 和 8.0.0 |
| db.r6g.16xlarge | 64 | 512 | - | 1008 | 25 | 4.0.0、5.0.0 和 8.0.0 |
| R6GD — 基于 Graviton2 的由最新一代 NVMe支持的实例类 |
| db.r6gd.xlarge | 4 | 32 | 173 | 64 | 1.25/ 10 | 5.0.0 和 8.0.0 |
| db.r6gd.2xlarge | 8 | 64 | 346 | 128 | 2.5/ 10 | 5.0.0 和 8.0.0 |
| db.r6gd.4xlarge | 16 | 128 | 694 | 256 | 5.0/ 10 | 5.0.0 和 8.0.0 |
| db.r6gd.8xlarge | 32 | 256 | 1388 | 512 | 12 | 5.0.0 和 8.0.0 |
| db.r6gd.12xlarge | 48 | 384 | 2082 | 768 | 20 | 5.0.0 和 8.0.0 |
| db.r6gd.16xlarge | 64 | 512 | 2776 | 1024 | 25 | 5.0.0 和 8.0.0 |
| R5：上一代内存优化型实例类 |
| db.r5.large | 2 | 16 | - | 31 | 0.75/ 10 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.xlarge | 4 | 32 | - | 62 | 1.25/ 10 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.2xlarge | 8 | 64 | - | 124 | 2.5/ 10 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.4xlarge | 16 | 128 | - | 249 | 5.0/ 10 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.8xlarge | 32 | 256 | - | 504 | 10 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.12xlarge | 48 | 384 | - | 748 | 12 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.16xlarge | 64 | 512 | - | 1008 | 20 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| db.r5.24xlarge | 96 | 768 | - | 1500 | 25 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| R4：上一代内存优化型实例类 只有引擎版本 3.6 支持 R4 实例。请注意，亚马逊 DocumentDB 3.6 将于 2026 年 3 月 30 日终止标准支持。Extended Support（付费）有效期至 2029 年 3 月。 |
| db.r4.large | 2 | 15.25 | - | 30 | 0.75/ 10 | 仅 3.6.0 |
| db.r4.xlarge | 4 | 30.5 | - | 60 | 1.25/ 10 | 仅 3.6.0 |
| db.r4.2xlarge | 8 | 61 | - | 120 | 2.5/ 10 | 仅 3.6.0 |
| db.r4.4xlarge | 16 | 122 | - | 240 | 5.0 /10 | 仅 3.6.0 |
| db.r4.8xlarge | 32 | 244 | - | 480 | 10 | 仅 3.6.0 |
| db.r4.16xlarge | 64 | 488 | - | 960 | 25 | 仅 3.6.0 |
| T4G：基于 Graviton2 的最新一代可突增性能实例类 T 系列实例在无限 CPU 突发模式下运行。超出基准的突发使用量将额外收费。不支持全局群集。 |
| db.t4g.medium | 2 | 4 | - | 8.13 | 0.256/ 5 | 4.0.0、5.0.0 和 8.0.0 |
| T3：上一代可突增性能实例类 |
| db.t3.medium | 2 | 4 | - | 7.5 | 0.256/ 5 | 3.6.0、4.0.0、5.0.0 和 8.0.0 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/db-instance-classes.html) |
# NVMe 支持的实例
对于所含大型数据集超过常规实例内存的应用程序，NVMe 支持的实例可将查询性能提升高达 7 倍。这些实例利用 r6gd 实例上可用的基于本地非易失性存储器规范（NVMe）的固态硬盘（SSD）存储来存储临时数据，从而减少基于网络的存储访问，改善读取延迟和提高吞吐量。
本地 SSD 空间分为两个部分：
+ **分层缓存** – 将大约 73% 的本地 SSD 分配为数据库缓存，与仅使用主内存相比，使系统能够存储多达五倍的数据库页面。本地 SSD 充当第二层缓存，而现有的内存缓冲区缓存仍作为第一层缓存。仅当缓冲区缓存和 SSD 缓存都未命中时，查询才会访问外部存储。
+ **临时存储** – 剩余的 27% 用于非永久性临时文件存储，用于涉及排序的复杂查询或资源密集型操作（如索引构建）。在常规实例中，临时空间位于 Amazon Elastic Block Store（EBS）卷上。SSD 上本地托管的临时存储可将涉及排序的查询延迟最多减少两倍，并加快索引构建等资源密集型操作的速度。
有关 NVMe 支持的实例类型及其规格的详细信息，请参阅 [实例类规格](db-instance-classes.md#db-instance-class-specs)。
**Topics**
+ [NVMe 支持的实例的推荐使用案例](#nvme-use-cases)
+ [在 Amazon DocumentDB 中使用 NVMe 支持的实例](#using-nvme)
+ [监控 NVMe 支持的实例](#monitoring-nvme)
## NVMe 支持的实例的推荐使用案例
我们建议您在以下场景中使用 NVMe 支持的实例：
+ **读取密集型工作负载** – 如果您的工作负载是读取密集型工作负载，并且您的数据集大于缓冲区缓存（由低 `BufferCacheHitRatio` 和高 `ReadIOPS` 指标指示），则 NVMe 支持的实例可以提供性能优势。
+ **更新密集型工作负载** – 如果您的工作负载是更新密集型工作负载，并且由于网络存储读取延迟而导致垃圾回收无法跟上，则 NVMe 支持的实例可以帮助缓解此问题。
NVMe 支持的实例可以从各种使用案例中受益，包括：
+ **互联网规模的应用程序** – 支付处理、计费和电子商务等具有严格性能服务水平协议（SLA）的应用程序可以利用 NVMe 支持的实例的性能优势。
+ **实时报告控制面板** – 需运行数百次指标/数据收集查询的控制面板可以受益于 NVMe 支持的实例的低延迟和高吞吐量。
+ **生成式人工智能应用程序** – 使用向量搜索在数百万个向量嵌入中查找精确邻居或最近邻居的应用程序可以利用 NVMe 支持的实例的高性能。
## 在 Amazon DocumentDB 中使用 NVMe 支持的实例
要使用 Amazon DocumentDB 的 NVMe 支持的实例：
+ 创建 Amazon DocumentDB 集群，并添加一个 NVMe 支持的实例类。有关更多信息，请参阅 [创建 Amazon DocumentDB 集群](db-cluster-create.md)。
+ 或者，修改现有的 Amazon DocumentDB 集群，以使用一个 NVMe 支持的实例类。有关更多信息，请参阅 [修改 Amazon DocumentDB 集群](db-cluster-modify.md)。
要查看不同 AWS 区域中 NVMe 支持的实例的可用性，请参阅 [不同区域支持的实例类](db-instance-classes.md#db-instance-classes-by-region)。
如果您想要从 NVMe 支持的实例切换回常规实例，请将 Amazon DocumentDB 实例的数据库实例类修改为不含 NVMe 存储的类似实例类。例如，如果当前实例类是“db.r6gd.4xlarge”，请选择“db.r6g.4xlarge”以切换回该实例类。有关更多信息，请参阅 [修改 Amazon DocumentDB 集群](db-cluster-modify.md)。
## 监控 NVMe 支持的实例
除了 Amazon CloudWatch 中提供的常规实例指标外，NVMe 支持的实例还会发出特定于基于 NVMe 的 SSD 存储、IOPS 和吞吐量的额外指标。
```
NVMeStorageCacheHitRatio
FreeNVMeStorage
ReadIOPSNVMeStorage
ReadLatencyNVMeStorage
ReadThroughputNVMeStorage
WriteIOPSNVMeStorage
WriteLatencyNVMeStorage
WriteThroughputNVMeStorage
```
有关这些指标的更多信息，请参阅 [NVMe支持的实例指标](cloud_watch.md#nvme-metrics)。