Amazon DocumentDB サーバーレスの管理 - Amazon DocumentDB
クラスターのスケーリング容量範囲設定の表示と変更サーバーレスリーダーの昇格階層の表示と変更

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon DocumentDB サーバーレスの管理

クラスターのスケーリング容量範囲設定の表示と変更

ServerlessV2ScalingConfiguration 引数は、DocumentDB サーバーレスインスタンスのスケーリング容量範囲を指定します。これは、クラスター内のすべての DocumentDB サーバーレスインスタンスに適用される DocumentDB キャパシティーユニット (DCU) の最小値と最大値で構成されます。

  • MinCapacity — クラスター内の DocumentDB サーバーレスインスタンスの最小スケーリング容量。

  • MaxCapacity — クラスター内の DocumentDB サーバーレスインスタンスの最大スケーリング容量。

注記

次のスケーリング設定の変更では、新しい MinCapacityと MaxCapacityの値を反映するためにインスタンスを再起動する必要があります。

  • MaxCapacity 値の変更

  • MinCapacity 値をより高い値から 1.0 以下に変更する

  • MinCapacity 値を低い値から 1.0 より大きい値に変更する

スケーリング設定と適切なスケーリング容量制限の選択方法の詳細については、「」を参照してくださいAmazon DocumentDB サーバーレススケーリング設定。

Using the AWS Management Console

次の AWS Management Console 設定例は、DocumentDB サーバーレスクラスターのスケーリング設定を表示および編集する方法を示しています。

  1. AWS Management Console にサインインし、Amazon DocumentDB コンソールを開きます。

  2. ナビゲーションペインで クラスター を選択します。

    ヒント

    画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン (Hamburger menu icon with three horizontal lines.) を選択します。

    クラスターテーブルが表示されます。

  3. クラスターテーブルで、スケーリング容量を変更するクラスターのチェックボックスをオンにします。

  4. [アクション] を選択してから、[変更] を選択します。

    クラスターの変更ダイアログボックスが表示されます。

  5. Serverless 容量設定セクションを見つけ、ダイアログボックスの容量の説明に基づいてスケーリング設定 (容量範囲) を設定します。

    スケーリングと容量範囲の詳細については、「」を参照してくださいAmazon DocumentDB サーバーレススケーリング設定。

  6. [続行] をクリックしてください。

  7. [変更のスケジューリング] で、[すぐに適用] を選択します。

  8. [クラスタークラスターの変更] を選択します。

  9. 変更が完了したら、各サーバーレスインスタンスを再起動する必要があります。ライターの可用性を最小限に抑えるには、次の一連のオペレーションを実行します。

    1. 各サーバーレスリーダーインスタンスを再起動します。

      1. リーダーインスタンスを選択し、アクションを選択し、再起動します。

      2. インスタンスのステータスが使用可能に戻るまで待ちます。

    2. 再起動されたサーバーレスインスタンスへのフェイルオーバーを実行します。

      1. クラスターを選択し、アクション、フェイルオーバーを選択します。

      2. フェイルオーバーオペレーションが完了するまで待ちます。

    3. 残りのサーバーレスインスタンスを再起動します。

      1. 残りのインスタンスを選択し、アクションを選択し、再起動します。

      2. インスタンスのステータスが Available に戻るまで待ちます。

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

サーバーレスリーダーの昇格階層の表示と変更

複数の 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. ナビゲーションペインで クラスター を選択します。

    ヒント

    画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン (Hamburger menu icon with three horizontal lines.) を選択します。

    クラスターテーブルが表示されます。

  3. クラスターテーブルで、昇格階層を変更するインスタンスのチェックボックスをオンにします。

  4. [アクション] を選択してから、[変更] を選択します。

    インスタンスの変更ダイアログボックスが表示されます。

  5. フェイルオーバーセクションを見つけ、昇格階層を希望のレベルに設定します。

  6. [続行] をクリックしてください。

  7. [変更のスケジューリング] で、[すぐに適用] を選択します。

  8. [インスタンスの変更] を選択します。

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