无服务器管理 Amazon DocumentDB

查看和修改集群的扩展容量范围配置

该ServerlessV2ScalingConfiguration参数指定 DocumentDB 无服务器实例的扩展容量范围。它由适用于集群中所有 DocumentDB 无服务器实例的最小和最大 DocumentDB 容量单位 (DCU) 值组成。

• MinCapacity— 集群中任何 DocumentDB 无服务器实例的最小扩展容量。

• MaxCapacity— 集群中任何 DocumentDB 无服务器实例的最大扩展容量。

注意

以下扩展配置修改需要重启实例以反映新的MinCapacity和MaxCapacity值：

• 对MaxCapacity值的任何更改

• 将该MinCapacity值从较高的值更改为 1.0 或更低

• 将该MinCapacity值从较低的值更改为大于 1.0

有关扩展配置以及如何选择适当的扩展容量限制的更多信息，请参阅亚马逊 DocumentDB 无服务器扩展配置。

Using the AWS Management Console

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

1. 登录 AWS Management Console 并打开 Amazon DocumentDB 控制台。

2. 在导航窗格中，选择集群。

   提示

   如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 ()。

   此时将出现 “聚类” 表。

3. 在集群表中，选中要修改扩展容量的集群的复选框。

4. 选择 Actions (操作)，然后选择 Modify (修改)。

   将出现 “修改集群” 对话框。

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

   有关扩展和容量范围的更多信息，请参阅亚马逊 DocumentDB 无服务器扩展配置。

6. 选择继续。

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

8. 选择修改集群。

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

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

      1. 选择阅读器实例，选择 “操作”，然后选择 “重启”。

      2. 等待实例状态恢复为 “可用”。

   2. 对重启的无服务器实例执行故障转移。

      1. 选择群集，选择操作，然后选择故障转移。

      2. 等待故障转移操作完成。

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

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

      2. 等待实例状态恢复为 “可用”。

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

查看和修改无服务器读者的促销等级

对于包含多个 DocumentDB 无服务器实例或预配置实例和无服务器实例混合的集群，请注意每个无服务器实例的升级等级设置。与预配置实例相比，此设置可以控制更多无服务器实例的行为。

对于预配置实例，第 0—15 层的选择仅决定 Amazon DocumentDB 选择在故障转移操作期间向写入器升级哪个读取器实例的顺序。但是，对于无服务器实例，层号还决定实例是向上扩展以匹配写入器实例的容量，还是根据自己的工作负载独立扩展。第 0 层或第 1 层的无服务器读取器实例的最低容量至少与写入器实例一样高。这样，他们就可以准备好在发生故障转移时接管写入器实例。如果写入器实例是预配置实例，则 Amazon DocumentDB 会估计等效的 DocumentDB 无服务器容量。它使用该估计值作为无服务器读取器实例的最小容量。

第 2-15 层的 DocumentDB 无服务器阅读器实例对其最低容量没有同样的限制。当它们处于空闲状态时，他们可以缩减到集群容量范围内指定的最小 DocumentDB 容量单位 (DCU) 值。

Using the AWS Management Console

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

1. 登录 AWS Management Console并 打开 Amazon DocumentDB 控制台。

   每个实例的促销等级显示在中的促销等级列中 AWS Management Console。

2. 在导航窗格中，选择集群。

   提示

   如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 ()。

   此时将出现 “聚类” 表。

3. 在 Cl ust ers 表中，选中您要修改其促销等级的实例的复选框。

4. 选择 Actions (操作)，然后选择 Modify (修改)。

   将出现 “修改实例” 对话框。

5. 找到 “故障转移” 部分，将 “升级” 层设置为所需的级别。

6. 选择继续。

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

8. 选择修改实例。

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