翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon DocumentDB Serverless の管理
## クラスターのスケーリング容量範囲設定の表示と変更
`ServerlessV2ScalingConfiguration` 引数は、DocumentDB サーバーレスインスタンスのスケーリング容量範囲を指定します。これは、クラスター内のすべての DocumentDB サーバーレスインスタンスに適用される DocumentDB キャパシティユニット (DCU) の最小値と最大値で構成されます。
+ **`MinCapacity`** — クラスター内の DocumentDB サーバーレスインスタンスの最小スケーリング容量。
+ **`MaxCapacity`** — クラスター内の DocumentDB サーバーレスインスタンスの最大スケーリング容量。
**注記**
次のスケーリング設定の変更では、新しい `MinCapacity` と `MaxCapacity` の値を反映するためにインスタンスを再起動する必要があります。
`MaxCapacity` 値への変更
`MinCapacity` 値をより高い値から 1.0 以下に変更する
`MinCapacity` 値をより低い値から 1.0 より大きい値に変更する
スケーリング設定と適切なスケーリング容量制限の選択方法の詳細については、「[Amazon DocumentDB Serverless スケーリング設定](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/ja_jp/documentdb/latest/developerguide/images/docdb-menu-icon.png)) を選択します。
**[クラスター]** テーブルが表示されます。
1. **[クラスター]** テーブルで、スケーリング容量を変更するクラスターのチェックボックスを選択します。
1. [**アクション**] を選択してから、[**変更**] を選択します。
**[クラスターの変更]** ダイアログボックスが表示されます。
1. **[サーバーレス容量設定]** セクションを見つけ、ダイアログボックスの容量の説明に基づいてスケーリング設定 (**[容量範囲]**) を設定します。
スケーリングとの容量単位の詳細については、「[Amazon DocumentDB Serverless スケーリング設定](docdb-serverless-scaling-config.md)」を参照してください。
1. [**続行**] をクリックしてください。
1. [**変更のスケジューリング**] で、[**すぐに適用**] を選択します。
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
```
------
## サーバーレスリーダーの昇格階層の表示と変更
複数のサーバーレスインスタンスを含むクラスター、またはプロビジョン済みインスタンスとサーバーレスインスタンスの混在するクラスターでは、各サーバーレスインスタンスのプロモーション層の設定に注意してください。この設定は、プロビジョン済みインスタンスよりも、サーバーレスインスタンスの多くの動作を制御します。
プロビジョン済みインスタンスの場合、層 0～15 の選択肢は、フェイルオーバー操作時に Amazon DocumentDB がどのリーダーインスタンスをライターに昇格させるかを選択する順序のみを決定します。ただし、サーバーレスリーダーインスタンスの場合、層番号によって、インスタンスがライターインスタンスの容量に合わせてスケールアップするのか、それとも独自のワークロードに基づいて個別にスケールアップするのかが決まります。層 0 または 1 のサーバーレスリーダーインスタンスは、少なくともライターインスタンスと同じ大きさの最小容量に保たれます。これにより、フェイルオーバー発生時にライターインスタンスから引き継ぐ準備が整います。ライターインスタンスがプロビジョン済みインスタンスの場合、 Amazon DocumentDB では同等の Amazon 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/ja_jp/documentdb/latest/developerguide/images/docdb-menu-icon.png)) を選択します。
**[クラスター]** テーブルが表示されます。
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].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
```
------