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

# Amazon Keyspaces でマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定を更新する
<a name="tables-mrr-autoscaling"></a>

このセクションでは、コンソール、CQL、および を使用して、プロビジョニングされたマルチリージョンテーブルの Amazon Keyspaces 自動スケーリング設定 AWS CLI を管理する方法の例を示します。一般的な自動スケーリング設定のオプションの詳細と仕組みについては、「[Amazon Keyspaces 自動スケーリングでスループットキャパシティを自動的に管理する](autoscaling.md)」を参照してください。

マルチリージョンテーブルでプロビジョンドキャパシティモードを使用している場合は、常に Amazon Keyspaces API コールを使用して自動スケーリングを設定する必要があります。その理由は、基盤となる Application Auto Scaling API オペレーションがリージョンに対応していないからです。

プロビジョンドモードのマルチリージョンテーブルの書き込みキャパシティスループットを推定する方法については、「[Amazon Keyspaces でマルチリージョンテーブルのキャパシティを推定およびプロビジョニングする](tables-multi-region-capacity.md)」を参照してください。

Amazon Keyspaces API の詳細については、「[Amazon Keyspaces API リファレンス](https://docs.aws.amazon.com/keyspaces/latest/APIReference/Welcome.html)**」を参照してください。

マルチリージョンテーブルのププロビジョンドモードまたは自動スケーリングの設定を更新する場合、テーブルの各レプリカの読み取りキャパシティ設定と読み取りの自動スケーリング設定を更新できます。

一方、書き込みキャパシティについては、すべてのリージョン間で書き込みをレプリケートするためのキャパシティを十分に確保するため、すべてのレプリカ間で同期されます。

------
#### [ Cassandra Query Language (CQL) ]

**CQL を使用してマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定を更新する**
+  `ALTER TABLE` を使用して、既存のテーブルのキャパシティモードと自動スケーリングの設定を更新できます。現時点でオンデマンドキャパシティモードのテーブルを更新する場合は、`capacity_mode` が必須です。テーブルが既にプロビジョンドキャパシティモードになっている場合、このフィールドは省略できます。

  自動スケーリング設定、ターゲット追跡ポリシー、ターゲット値、オプション設定の詳細については、「[自動スケーリングを有効にして新規テーブルを作成する](autoscaling.createTable.md)」を参照してください。

  同じステートメントでテーブルの `replica_updates` プロパティを更新して、特定のリージョンのテーブルレプリカの読み取りキャパシティと自動スケーリングの設定を更新することもできます。以下のステートメントは、この例です。

  ```
  ALTER TABLE mykeyspace.mytable
  WITH CUSTOM_PROPERTIES = {  
      'capacity_mode': {  
          'throughput_mode': 'PROVISIONED',  
          'read_capacity_units': 1,  
          'write_capacity_units': 1  
      }
  } AND AUTOSCALING_SETTINGS = {
      'provisioned_write_capacity_autoscaling_update': {
          'maximum_units': 10,  
          'minimum_units': 5,  
          'scaling_policy': {
              'target_tracking_scaling_policy_configuration': {
                  'target_value': 50
              }  
          }  
      },
      'provisioned_read_capacity_autoscaling_update': {  
          'maximum_units': 10,  
          'minimum_units': 5,  
          'scaling_policy': {  
              'target_tracking_scaling_policy_configuration': {  
                  'target_value': 50,
                  'scale_in_cooldown': 60,  
                  'scale_out_cooldown': 60
              }  
          }  
      },
      'replica_updates': {
          'us-east-1': {
              'provisioned_read_capacity_autoscaling_update': {
                  'maximum_units': 20,
                  'minimum_units': 5,
                  'scaling_policy': {
                      'target_tracking_scaling_policy_configuration': {
                          'target_value': 70
                      } 
                  }
              }
          }
      }
  };
  ```

------
#### [ CLI ]

**を使用してマルチリージョンテーブルのプロビジョニングされた容量と自動スケーリング設定を更新する AWS CLI**
+ 既存のテーブルのプロビジョニングモードと自動スケーリング設定を更新するには、 コマンドを使用できます AWS CLI `update-table`。

  マルチリージョンの自動スケーリング設定を作成または変更するには、Amazon Keyspaces の CLI コマンドを使用する必要があります。その理由は、Application Auto Scaling (Amazon Keyspaces がテーブルの自動スケーリングを実行するために使用するサービス) が複数の AWS リージョンに対応していないからです。

   特定のリージョンのテーブルレプリカの読み取りキャパシティを更新するには、テーブルの `replicaSpecifications` の次のオプションパラメータのいずれかを変更します。
  + プロビジョニングされた読み取りキャパシティユニット (オプション)
  + 読み取りキャパシティの自動スケーリング設定 (オプション)

  自動スケーリング設定が複雑で、テーブルレプリカごとに設定が異なるマルチリージョンテーブルを更新する場合は、テーブルの自動スケーリング設定とレプリカ設定を JSON ファイルからロードすると便利です。

  次のコード例を使用するには、サンプル JSON ファイルを収録した [auto-scaling.zip](samples/auto-scaling.zip) をダウンロードし、`auto-scaling.json` と `replication.json` を抽出します。ファイルのパスを書き留めておいてください。

  この例では、JSON ファイルは現在のディレクトリにあります。さまざまなファイルパスオプションについては、「[ファイルからパラメーターを読み込む方法](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-file.html#cli-usage-parameters-file-how)」を参照してください。

  ```
  aws keyspaces update-table --keyspace-name mykeyspace --table-name mytable \
  --capacity-specification throughputMode=PROVISIONED,readCapacityUnits=1,writeCapacityUnits=1 \
  --auto-scaling-specification file://auto-scaling.json \
  --replica-specifications file://replication.json
  ```

------