

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

# 管理 Amazon DocumentDB 无服务器
<a name="docdb-serverless-managing"></a>

## 查看和修改集群的扩缩容量范围配置
<a name="docdb-serverless-range-config"></a>

`ServerlessV2ScalingConfiguration` 参数指定 DocumentDB 无服务器实例的扩缩容量范围。由适用于集群中所有 DocumentDB 无服务器实例的最小和最大 DocumentDB 容量单位（DCU）值组成。
+ **`MinCapacity`**：集群中任何 DocumentDB 无服务器实例的最小扩缩容量。
+ **`MaxCapacity`**：集群中任何 DocumentDB 无服务器实例的最大扩缩容量。

**注意**  
以下扩缩配置修改需要重新启动实例以反映新的 `MinCapacity` 和 `MaxCapacity` 值：  
对 `MaxCapacity` 值的任何更改
将 `MinCapacity` 值从较高的值更改为 1.0 或更低值
将 `MinCapacity` 值从较低的值更改为大于 1.0 的值

有关扩缩配置以及如何选择适当的扩缩容量限制的更多信息，请参阅 [Amazon DocumentDB 无服务器扩缩配置](docdb-serverless-scaling-config.md)。

------
#### [ Using the AWS 管理控制台 ]

以下 AWS 管理控制台 配置示例显示了如何查看和编辑 DocumentDB 无服务器集群的扩展配置设置。

1. 登录 [AWS 管理控制台](https://console.aws.amazon.com/docdb/home?region=us-east-1) 并打开 Amazon DocumentDB 控制台。

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 (操作)**，然后选择 **Modify (修改)**。

   将显示**修改集群**对话框。

1. 找到**无服务器容量设置**部分，根据对话框中的容量描述设置扩缩配置（**容量范围**）。

   有关扩缩和容量范围的更多信息，请参阅 [Amazon DocumentDB 无服务器扩缩配置](docdb-serverless-scaling-config.md)。

1. 选择**继续**。

1. 对于**修改计划**，选择**立即应用**。

1. 选择**修改集群**。

1. 修改完成后，应重启每个无服务器实例。要最大限度地减少写入器不可用情况，请执行以下操作序列：

   1. 重启每个无服务器读取器实例。

      1. 选择读取器实例，选择**操作**，然后选择**重启**。

      1. 等待实例状态恢复为**可用**。

   1. 对重启的无服务器实例执行失效转移。

      1. 选择集群，选择**操作**，然后选择**失效转移**。

      1. 等待失效转移操作完成。

   1. 重启剩余的无服务器实例。

      1. 选择剩余的实例，选择**操作**，然后选择**重启**。

      1. 等待实例状态恢复为**可用**。

------
#### [ Using the AWS CLI ]

以下 AWS CLI 配置示例显示了当前的扩展配置。

在以下示例中，*user input placeholder*使用您自己的信息或配置参数替换每个示例。

可以使用以下`describe-db-clusters` AWS CLI 命令查看集群的当前扩展配置：

```
aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[0].ServerlessV2ScalingConfiguration'
```

此命令的输出如下：

```
{
    "MinCapacity": 0.5,
    "MaxCapacity": 16.0
}
```

可以使用 `modify-db-cluster` 命令修改集群的扩缩配置：

```
aws docdb modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=32
```

完成后，应重启每个无服务器实例。要最大限度地减少写入器不可用情况，可以执行以下操作序列：

```
aws docdb reboot-db-instance \
    --db-instance-identifier sample-serverless-instance-reader

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-reader

aws docdb failover-db-cluster \
   --db-cluster-identifier sample-cluster \
   --target-db-instance-identifier sample-serverless-instance-reader

aws docdb reboot-db-instance \
    --db-instance-identifier sample-serverless-instance-writer

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-writer

aws docdb failover-db-cluster \
   --db-cluster-identifier sample-cluster \
   --target-db-instance-identifier sample-serverless-instance-writer
```

------

## 查看和修改无服务器读取器的提升层
<a name="docdb-serverless-promo-tier"></a>

对于包含多个 DocumentDB 无服务器实例或混用预置实例和无服务器实例的集群，请注意每个无服务器实例的提升层设置。此设置控制的无服务器实例行为比预置实例更多。

对于预置实例，0-15 层的选择仅决定在失效转移操作期间 Amazon DocumentDB 选择将读取器实例提升为写入器的顺序。但是，对于无服务器实例，层编号还决定实例是扩展以匹配写入器实例的容量，还是根据自己的工作负载独立扩展。第 0 层或第 1 层的无服务器读取器实例的最小容量至少与写入器实例一样高。这样，读取器实例就可以准备好在发生失效转移的情况下接管写入器实例。如果写入器实例是预置实例，Amazon DocumentDB 会估算等效的 DocumentDB 无服务器容量。其使用该估计值作为无服务器读取器实例的最小容量。

第 2-15 层中的 DocumentDB 无服务器读取器实例对其最小容量没有这样的限制。当其处于空闲状态时，可以缩减到集群的容量范围中指定的最小 DocumentDB 容量单位（DCU）值。

------
#### [ Using the AWS 管理控制台 ]

以下 AWS 管理控制台 配置示例显示了如何查看和修改 DocumentDB 无服务器实例读取器的促销等级设置。

1. 登录 [AWS 管理控制台](https://console.aws.amazon.com/docdb/home?region=us-east-1)并 打开 Amazon DocumentDB 控制台。

   每个实例的提升层都显示在 AWS 管理控制台的**提升层**列中。

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 (操作)**，然后选择 **Modify (修改)**。

   将显示**修改实例**对话框。

1. 找到**失效转移**部分，将**提升层**设置为所需级别。

1. 选择**继续**。

1. 对于**修改计划**，选择**立即应用**。

1. 选择**修改实例**。

------
#### [ Using the AWS CLI ]

以下 AWS CLI 配置示例显示了当前的扩展配置。

在以下示例中，*user input placeholder*使用您自己的信息或配置参数替换每个示例。

可以使用`describe-db-clusters` AWS CLI 以下命令查看集群中所有实例的升级等级：

```
aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[0].DBClusterMembers' \
    --output table
```

此命令的输出如下：

```
--------------------------------------------------------------------------------------------------------
|                                          DescribeDBClusters                                          |
+--------------------------------+---------------------------------+------------------+----------------+
|  DBClusterParameterGroupStatus |      DBInstanceIdentifier       | IsClusterWriter  | PromotionTier  |
+--------------------------------+---------------------------------+------------------+----------------+
|  in-sync                       |  sample-serverless-instance-2   |  False           |  1             |
|  in-sync                       |  sample-serverless-instance-1   |  True            |  1             |
+--------------------------------+---------------------------------+------------------+----------------+
```

可以使用 `modify-db-instance` 命令修改特定实例的提升层：

```
aws docdb modify-db-instance \
    --db-instance-identifier sample-serverless-instance-2 \
    --promotion-tier 3
```

------