

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 管理 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_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。

   **叢集**資料表隨即出現。

1. 在**叢集**表格中，選取您要修改擴展容量之叢集的核取方塊。

1. 選擇 **Actions (動作)**，然後選擇 **Modify (修改)**。

   **修改叢集**對話方塊隨即出現。

1. 找到**無伺服器容量設定**區段，並根據對話方塊中的容量描述設定擴展組態 (**容量範圍**)。

   如需擴展和容量範圍的詳細資訊，請參閱[Amazon DocumentDB 無伺服器擴展組態](docdb-serverless-scaling-config.md)。

1. 選擇 **Continue** (繼續)。

1. 在 **Scheduling of modifications** (修改排程) 中，選擇 **Apply immediately** (立即套用)。

1. 選擇**修改叢集**。

1. 修改完成後，每個無伺服器執行個體都應重新啟動。若要將寫入器無法使用情況降至最低，請執行下列操作序列：

   1. 重新啟動每個無伺服器讀取器執行個體。

      1. 選取讀取器執行個體，選擇**動作**，然後選擇**重新啟動**。

      1. 等待執行個體狀態回到**可用**。

   1. 執行容錯移轉至重新啟動的無伺服器執行個體。

      1. 選取叢集，選擇**動作**，然後選擇**容錯移轉**。

      1. 等待容錯移轉操作完成。

   1. 重新啟動剩餘的無伺服器執行個體。

      1. 選取剩餘的執行個體，選擇**動作**，然後選擇**重新啟動**。

      1. 等待執行個體狀態回到**可用**。

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

下列 AWS CLI 組態範例顯示目前的擴展組態。

在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊或組態參數。

您可以使用 `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_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。

   **叢集**資料表隨即出現。

1. 在**叢集**表格中，選取您要修改提升層之執行個體的核取方塊。

1. 選擇 **Actions (動作)**，然後選擇 **Modify (修改)**。

   **修改執行個體**對話方塊隨即出現。

1. 找到**容錯移轉**區段，並將**提升層**設定為所需的層級。

1. 選擇 **Continue** (繼續)。

1. 在 **Scheduling of modifications** (修改排程) 中，選擇 **Apply immediately** (立即套用)。

1. 選擇 **Modify instance (修改執行個體)**。

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

下列 AWS CLI 組態範例顯示目前的擴展組態。

在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊或組態參數。

您可以使用 `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
```

------