

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

# Amazon Keyspaces のマルチリージョンレプリケーションを設定する (Apache Cassandra 用)
<a name="multiRegion-replication-configure"></a>

コンソール、Cassandra クエリ言語 (CQL)、または を使用して AWS Command Line Interface 、Amazon Keyspaces でマルチリージョンのキースペースとテーブルを作成および管理できます。

このセクションでは、マルチリージョンのキースペースとテーブルを作成し、管理する方法の例を紹介します。マルチリージョンキースペース内に作成したテーブルはすべて、そのキースペースのマルチリージョン設定を自動的に継承します。

サポートされる設定の詳細については、「[Amazon Keyspaces マルチリージョンレプリケーションの使用に関する注意事項](multiRegion-replication_usage-notes.md)」をご参照ください。

**Topics**
+ [マルチリージョンのキースペースとテーブルの作成に必要な IAM アクセス許可を設定する](howitworks_replication_permissions.md)
+ [キースペースに を追加するために必要な AWS リージョン IAM アクセス許可を設定する](howitworks_replication_permissions_addReplica.md)
+ [Amazon Keyspaces でマルチリージョンキースペースを作成する](keyspaces-mrr-create.md)
+ [Amazon Keyspaces のキースペース AWS リージョン に を追加する](keyspaces-multi-region-add-replica.md)
+ [キースペースに新しいリージョンを追加するときにレプリケーションの進行状況を確認する](keyspaces-multi-region-replica-status.md)
+ [Amazon Keyspaces でデフォルト設定のマルチリージョンテーブルを作成する](tables-mrr-create-default.md)
+ [Amazon Keyspaces で自動スケーリングが有効なプロビジョンドモードのマルチリージョンテーブルを作成する](tables-mrr-create-provisioned.md)
+ [Amazon Keyspaces でマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定を更新する](tables-mrr-autoscaling.md)
+ [Amazon Keyspaces でマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定を表示する](tables-mrr-view.md)
+ [Amazon Keyspaces でテーブルの自動スケーリングを無効にする](tables-mrr-autoscaling-off.md)
+ [Amazon Keyspaces でマルチリージョンテーブルにプロビジョニングされるキャパシティを手動で設定する](tables-mrr-capacity-manually.md)

# マルチリージョンのキースペースとテーブルの作成に必要な IAM アクセス許可を設定する
<a name="howitworks_replication_permissions"></a>

マルチリージョンのキースペースとテーブルを正常に作成するには、IAM プリンシパルがサービスにリンクされたロールを作成できることが条件になります。このサービスにリンクされたロールは、Amazon Keyspaces によって事前に定義された特殊なタイプの IAM ロールです。このロールには、Amazon Keyspaces がお客様に代わってアクションを実行するために必要なすべての権限が含まれます。サービスにリンクされたロールの詳細については、「[Amazon Keyspaces のマルチリージョンレプリケーションでのロールの使用](using-service-linked-roles-multi-region-replication.md)」を参照してください。

マルチリージョンレプリケーションに必要なサービスにリンクされたロールを作成するには、IAM プリンシパルのポリシーに次の要素が必要です。
+ `iam:CreateServiceLinkedRole` – プリンシパルが実行できる**アクション**。
+ `arn:aws:iam::*:role/aws-service-role/replication.cassandra.amazonaws.com/AWSServiceRoleForKeyspacesReplication` – このアクションを実行できる**リソース**。
+ `iam:AWSServiceName": "replication.cassandra.amazonaws.com` – このロールをアタッチできる唯一の AWS サービスは Amazon Keyspaces です。

マルチリージョンキースペースとテーブルを作成するために必要な最小限の権限をユーザーに与えるポリシーの例を以下に示します。

```
{
            "Effect": "Allow",
            "Action": "iam:CreateServiceLinkedRole",
            "Resource": "arn:aws:iam::*:role/aws-service-role/replication.cassandra.amazonaws.com/AWSServiceRoleForKeyspacesReplication",
            "Condition": {"StringLike": {"iam:AWSServiceName": "replication.cassandra.amazonaws.com"}}
}
```

マルチリージョンのキースペースとテーブル用のその他の IAM アクセス許可については、「サービス認可リファレンス**」の「[Actions, resources, and condition keys for Amazon Keyspaces (for Apache Cassandra)](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkeyspacesforapachecassandra.html)」を参照してください。

# キースペースに を追加するために必要な AWS リージョン IAM アクセス許可を設定する
<a name="howitworks_replication_permissions_addReplica"></a>

リージョンをキースペースに追加するには、IAM プリンシパルに次のアクセス許可が必要です。
+ `cassandra:Alter`
+ `cassandra:AlterMultiRegionResource`
+ `cassandra:Create`
+ `cassandra:CreateMultiRegionResource`
+ `cassandra:Select`
+ `cassandra:SelectMultiRegionResource`
+ `cassandra:Modify`
+ `cassandra:ModifyMultiRegionResource`

テーブルがプロビジョニングモードで自動スケーリングを有効にして設定されている場合は、次の追加のアクセス許可が必要です。
+ `application-autoscaling:RegisterScalableTarget`
+ `application-autoscaling:DeregisterScalableTarget`
+ `application-autoscaling:DescribeScalableTargets`
+ `application-autoscaling:PutScalingPolicy`
+ `application-autoscaling:DescribeScalingPolicies`

リージョンを単一リージョンのキースペースに正常に追加するには、IAM プリンシパルもサービスにリンクされたロールを作成できる必要があります。このサービスにリンクされたロールは、Amazon Keyspaces によって事前に定義された特殊なタイプの IAM ロールです。このロールには、Amazon Keyspaces がお客様に代わってアクションを実行するために必要なすべての権限が含まれます。サービスにリンクされたロールの詳細については、「[Amazon Keyspaces のマルチリージョンレプリケーションでのロールの使用](using-service-linked-roles-multi-region-replication.md)」を参照してください。

マルチリージョンレプリケーションに必要なサービスにリンクされたロールを作成するには、IAM プリンシパルのポリシーに次の要素が必要です。
+ `iam:CreateServiceLinkedRole` – プリンシパルが実行できる**アクション**。
+ `arn:aws:iam::*:role/aws-service-role/replication.cassandra.amazonaws.com/AWSServiceRoleForKeyspacesReplication` – このアクションを実行できる**リソース**。
+ `iam:AWSServiceName": "replication.cassandra.amazonaws.com` – このロールをアタッチできる唯一の AWS サービスは Amazon Keyspaces です。

以下は、キースペースにリージョンを追加するために必要な最小限のアクセス許可をプリンシパルに付与するポリシーの例です。

```
{
            "Effect": "Allow",
            "Action": "iam:CreateServiceLinkedRole",
            "Resource": "arn:aws:iam::*:role/aws-service-role/replication.cassandra.amazonaws.com/AWSServiceRoleForKeyspacesReplication",
            "Condition": {"StringLike": {"iam:AWSServiceName": "replication.cassandra.amazonaws.com"}}
}
```

# Amazon Keyspaces でマルチリージョンキースペースを作成する
<a name="keyspaces-mrr-create"></a>

このセクションでは、マルチリージョンキースペースの作成方法の例を紹介します。この作業は、Amazon Keyspaces コンソール、CQL、または AWS CLIを使用して行うことができます。マルチリージョンキースペース内に作成したテーブルはすべて、そのキースペースのマルチリージョン設定を自動的に継承します。

**注記**  
マルチリージョンキースペースを作成すると、Amazon Keyspaces はアカウント内の名前 `AWSServiceRoleForAmazonKeyspacesReplication` でサービスにリンクされたロールを作成します。このロールにより、Amazon Keyspaces はユーザーに代わってマルチリージョンテーブルのすべてのレプリカへの書き込みを複製できます。詳細については[Amazon Keyspaces のマルチリージョンレプリケーションでのロールの使用](using-service-linked-roles-multi-region-replication.md)を参照してください。

------
#### [ Console ]

**マルチリージョンキースペースを作成する (コンソール)**

1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。

1. ナビゲーションペインで [**Keyspaces (キースペース)**] を選択し、次に [**Create keyspace (キースペースの作成)**] を選択します。

1. [**Keyspace name (キースペース名)**] でキースペースの名前を入力します。

1. **マルチリージョンレプリケーション**セクションでは、リストで使用できるリージョンを追加できます。

1. 終了するには、[**ロールを作成**] を選択します。

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

**CQL を使用してマルチリージョンキースペースを作成する**

1. マルチリージョンキースペースを作成するには、 `NetworkTopologyStrategy`を使用して、キースペースをレプリケート AWS リージョン する を指定します。現在のリージョン以外に、追加リージョンを 1 つ以上、含める必要があります。

   キースペース内のすべてのテーブルは、そのキースペースのレプリケーション戦略を継承します。テーブルレベルでレプリケーション戦略を変更することはできません。

   `NetworkTopologyStrategy` – Amazon Keyspaces はデフォルトで同じ 内の 3 つの[アベイラビリティーゾーン](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/)にデータをレプリケートするため AWS リージョン、各リージョンのレプリケーション係数は 3 です。

   例を、次の CQL ステートメントで示します。

   ```
   CREATE KEYSPACE mykeyspace
   WITH REPLICATION = {'class':'NetworkTopologyStrategy', 'us-east-1':'3', 'ap-southeast-1':'3','eu-west-1':'3' };
   ```

1. CQL ステートメントで `system_multiregion_info` キースペース内の `tables` テーブルをクエリすると、指定したマルチリージョンテーブルのリージョンとステータスをプログラムによって一覧表示できます。次のコードは、この例です。

   ```
   SELECT * from system_multiregion_info.tables WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';
   ```

   このステートメントの出力は、次のようになります。

   ```
    keyspace_name  | table_name     | region         | status
   ----------------+----------------+----------------+--------
    mykeyspace     | mytable        | us-east-1      | ACTIVE
    mykeyspace     | mytable        | ap-southeast-1 | ACTIVE
    mykeyspace     | mytable        | eu-west-1      | ACTIVE
   ```

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

**を使用して新しいマルチリージョンキースペースを作成する AWS CLI**
+ マルチリージョンキースペースは、次の CLI ステートメントで作成できます。現在のリージョンと `regionList` に 1 つ以上の追加リージョンを指定します。

  ```
  aws keyspaces create-keyspace --keyspace-name mykeyspace \
  --replication-specification replicationStrategy=MULTI_REGION,regionList=us-east-1,eu-west-1
  ```

------

マルチリージョンテーブルを作成するには、「[Amazon Keyspaces でデフォルト設定のマルチリージョンテーブルを作成する](tables-mrr-create-default.md)」および「[Amazon Keyspaces で自動スケーリングが有効なプロビジョンドモードのマルチリージョンテーブルを作成する](tables-mrr-create-provisioned.md)」を参照してください。

# Amazon Keyspaces のキースペース AWS リージョン に を追加する
<a name="keyspaces-multi-region-add-replica"></a>

単一のキースペースまたはマルチリージョンのキースペースのいずれかであるキースペース AWS リージョン に新しい を追加できます。新しいレプリカリージョンは、キースペース内のすべてのテーブルに適用されます。

シングルリージョンをマルチリージョンキースペースに変更するには、キースペース内のすべてのテーブルに対してクライアント側のタイムスタンプを有効にする必要があります。詳細については、「[Amazon Keyspaces でのクライアント側のタイムスタンプ](client-side-timestamps.md)」を参照してください。

マルチリージョンキースペースにリージョンを追加する場合、Amazon Keyspaces は、既存のテーブルごとに 1 回限りのクロスリージョン復元を使用して、既存のテーブル (複数可) を新しいリージョンにレプリケートする必要があります。各テーブルの復元料金は GB ごとに請求されます。詳細については、Amazon Keyspaces (Apache Cassandra 向け) の料金ページの[「バックアップと復元](https://aws.amazon.com/keyspaces/pricing/#:~:text=per%20GB-month-,Restoring%20a%20table,-Restoring%20a%20table)」を参照してください。この復元オペレーションでは、リージョン間のデータ転送に料金はかかりません。データに加えて、タグを除くすべてのテーブルプロパティが新しいリージョンにレプリケートされます。

CQL の `ALTER KEYSPACE`ステートメント、 の `update-keyspace` コマンド AWS CLI、または コンソールを使用して、Amazon Keyspaces の単一のキースペースまたはマルチリージョンキースペースに新しいリージョンを追加できます。ステートメントを正常に実行するには、使用しているアカウントが、キースペースが既に利用可能なリージョンのいずれかにある必要があります。レプリカの追加中は、更新およびレプリケートされるリソースに対して他のデータ定義言語 (DDL) オペレーションを実行することはできません。

リージョンの追加に必要なアクセス許可の詳細については、「」を参照してください[キースペースに を追加するために必要な AWS リージョン IAM アクセス許可を設定する](howitworks_replication_permissions_addReplica.md)。

**注記**  
単一リージョンのキースペースにリージョンを追加すると、Amazon Keyspaces は`AWSServiceRoleForAmazonKeyspacesReplication`アカウントに という名前のサービスにリンクされたロールを作成します。このロールにより、Amazon Keyspaces はテーブルを新しいリージョンにレプリケートし、ユーザーに代わって 1 つのテーブルからマルチリージョンテーブルのすべてのレプリカに書き込みをレプリケートできます。詳細については[Amazon Keyspaces のマルチリージョンレプリケーションでのロールの使用](using-service-linked-roles-multi-region-replication.md)を参照してください。

------
#### [ Console ]

Amazon Keyspaces コンソールを使用してキースペースにリージョンを追加するには、次の手順に従います。

**キースペースにリージョンを追加する (コンソール)**

1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。

1. ナビゲーションペインで、**キースペース**を選択し、リストからキースペースを選択します。

1. **[AWS リージョン]** タブを選択します。

1. **AWS リージョン** タブで、**リージョンの追加**を選択します。

1. **リージョンの追加**ダイアログで、キースペースに追加する追加のリージョンを選択します。

1. 終了するには、**追加** を選択します。

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

**CQL を使用してキースペースにリージョンを追加する**
+ キースペースに新しいリージョンを追加するには、次のステートメントを使用できます。この例では、キースペースは米国東部 (バージニア北部) リージョンと米国西部 (オレゴン) リージョンで既に利用可能であり、CQL ステートメントは米国西部 (北カリフォルニア) リージョンを追加しています。

  ```
  ALTER KEYSPACE my_keyspace
  WITH REPLICATION = {
      'class': 'NetworkTopologyStrategy',
      'us-east-1': '3',
      'us-west-2': '3',
      'us-west-1': '3'
  } AND CLIENT_SIDE_TIMESTAMPS = {'status': 'ENABLED'};
  ```

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

**を使用してキースペースにリージョンを追加する AWS CLI**
+ CLI を使用してキースペースに新しいリージョンを追加するには、次の例を使用できます。`client-side-timestamps` のデフォルト値は `DISABLED` です。`update-keyspace` コマンドでは、値を に変更する必要があります`ENABLED`。

  ```
  aws keyspaces update-keyspace \
  --keyspace-name my_keyspace \
  --replication-specification '{"replicationStrategy": "MULTI_REGION", "regionList": ["us-east-1", "eu-west-1", "eu-west-3"] }' \
  --client-side-timestamps '{"status": "ENABLED"}'
  ```

------

# キースペースに新しいリージョンを追加するときにレプリケーションの進行状況を確認する
<a name="keyspaces-multi-region-replica-status"></a>

Amazon Keyspaces キースペースへの新しいリージョンの追加は、長時間実行されるオペレーションです。進行状況を追跡するには、このセクションに示すクエリを使用できます。

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

**CQL を使用してリージョンの追加の進行状況を確認する**
+  特定のキースペースで新しいテーブルレプリカの作成の進行状況を確認するには、`system_multiregion_info.keyspaces`テーブルをクエリできます。例を、次の CQL ステートメントで示します。

  ```
  SELECT keyspace_name, region, status, tables_replication_progress
  FROM system_multiregion_info.keyspaces
  WHERE keyspace_name = 'my_keyspace';
  ```

  レプリケーションオペレーションの進行中、ステータスは新しいリージョンでのテーブル作成の進行状況を示します。これは、10 個のテーブルのうち 5 個が新しいリージョンにレプリケートされた例です。

  ```
   keyspace_name | region    | status    | tables_replication_progress
  ---------------+-----------+-----------+-------------------------
     my_keyspace | us-east-1 | Updating  | 
     my_keyspace | us-west-2 | Updating  | 
     my_keyspace | eu-west-1 | Creating  | 50%
  ```

  レプリケーションプロセスが正常に完了すると、出力は次の例のようになります。

  ```
   keyspace_name | region    | status
  ---------------+-----------+-----------
     my_keyspace | us-east-1 | Active
     my_keyspace | us-west-2 | Active
     my_keyspace | eu-west-1 | Active
  ```

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

**を使用してリージョンの追加の進行状況 AWS CLI を確認する**
+ 特定のキースペースのテーブルレプリカ作成のステータスを確認するには、次の例を使用します。

  ```
  aws keyspaces get-keyspace \
  --keyspace-name my_keyspace
  ```

  この例のような出力が得られます。

  ```
  {
      "keyspaceName": "my_keyspace",
      "resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/",
      "replicationStrategy": "MULTI_REGION",
      "replicationRegions": [
          "us-east-1",
          "eu-west-1"
      ]
      "replicationGroupStatus": [
          {
              "RegionName": "us-east-1",
              "KeyspaceStatus": "Active"
          },
          {
              "RegionName": "eu-west-1",
              "KeyspaceStatus": "Creating",
              "TablesReplicationProgress": "50.0%"
          }
      ]
  }
  ```

------

# Amazon Keyspaces でデフォルト設定のマルチリージョンテーブルを作成する
<a name="tables-mrr-create-default"></a>

このセクションでは、オンデマンドモードのマルチリージョンテーブルをすべてデフォルトの設定で作成する方法の例を紹介します。この作業は、Amazon Keyspaces コンソール、CQL、または AWS CLIを使用して行うことができます。マルチリージョンキースペース内に作成したテーブルはすべて、そのキースペースのマルチリージョン設定を自動的に継承します。

マルチリージョンキースペースを作成するには、「[Amazon Keyspaces でマルチリージョンキースペースを作成する](keyspaces-mrr-create.md)」を参照してください。

------
#### [ Console ]

**マルチリージョンテーブルをデフォルト設定で作成する (コンソール)**

1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。

1. マルチリージョンキー空間を選択します。

1. [**テーブル**] タブで [**テーブルを作成**] を選択します。

1. [**テーブル名**] にテーブルの名前を入力します。このテーブルが複製される AWS リージョン が情報ボックスに表示されます。

1. テーブルスキーマを続行します。

1. [**テーブル設定**] で、[**デフォルト設定**] オプションに進みます。マルチリージョンテーブルの次のデフォルト設定に注意してください。
   + **キャパシティモード** – デフォルトのキャパシティモードは **[オンデマンド]** です。**プロビジョンドモード**の設定の詳細については、「[Amazon Keyspaces で自動スケーリングが有効なプロビジョンドモードのマルチリージョンテーブルを作成する](tables-mrr-create-provisioned.md)」を参照してください。
   + **暗号化キー管理** — **AWS 所有のキー** オプションのみがサポートされます。
   + **クライアント側のタイムスタンプ** — この機能はマルチリージョンテーブルに必要です。
   + テーブルとそのすべてのレプリカの Time to Live (TTL) を有効にする必要がある場合は、[**設定をカスタマイズ**] を選択します。
**注記**  
既存のマルチリージョンテーブルの TTL 設定は変更できません。

1. 終了するには、[**テーブルを作成**] を選択します。

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

**オンデマンドモードのマルチリージョンテーブルをデフォルト設定で作成する**
+ マルチリージョンテーブルをデフォルト設定で作成するには、次の CQL ステートメントを使用します。

  ```
  CREATE TABLE mykeyspace.mytable(pk int, ck int, PRIMARY KEY (pk, ck))
      WITH CUSTOM_PROPERTIES = {
  	'capacity_mode':{
  		'throughput_mode':'PAY_PER_REQUEST'
  	},
  	'point_in_time_recovery':{
  		'status':'enabled'
  	},
  	'encryption_specification':{
  		'encryption_type':'AWS_OWNED_KMS_KEY'
  	},
  	'client_side_timestamps':{
  		'status':'enabled'
  	}
  };
  ```

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

**の使用 AWS CLI**

1. マルチリージョンテーブルをデフォルト設定で作成するには、スキーマのみを指定する必要があります。次の例を使用できます。

   ```
   aws keyspaces create-table --keyspace-name mykeyspace --table-name mytable \
   --schema-definition 'allColumns=[{name=pk,type=int}],partitionKeys={name= pk}'
   ```

   このコマンドの出力は、次のようになります。

   ```
   {
       "resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable"
   }
   ```

1. テーブルの設定を確認するには、次のステートメントを使用します。

   ```
   aws keyspaces get-table --keyspace-name mykeyspace --table-name mytable
   ```

   出力には、マルチリージョンテーブルのデフォルト設定がすべて表示されます。

   ```
   {
       "keyspaceName": "mykeyspace",
       "tableName": "mytable",
       "resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable",
       "creationTimestamp": "2023-12-19T16:50:37.639000+00:00",
       "status": "ACTIVE",
       "schemaDefinition": {
           "allColumns": [
               {
                   "name": "pk",
                   "type": "int"
               }
           ],
           "partitionKeys": [
               {
                   "name": "pk"
               }
           ],
           "clusteringKeys": [],
           "staticColumns": []
       },
       "capacitySpecification": {
           "throughputMode": "PAY_PER_REQUEST",
           "lastUpdateToPayPerRequestTimestamp": "2023-12-19T16:50:37.639000+00:00"
       },
       "encryptionSpecification": {
           "type": "AWS_OWNED_KMS_KEY"
       },
       "pointInTimeRecovery": {
           "status": "DISABLED"
       },
       "defaultTimeToLive": 0,
       "comment": {
           "message": ""
       },
       "clientSideTimestamps": {
           "status": "ENABLED"
       },
       "replicaSpecifications": [
           {
               "region": "us-east-1",
               "status": "ACTIVE",
               "capacitySpecification": {
                   "throughputMode": "PAY_PER_REQUEST",
                   "lastUpdateToPayPerRequestTimestamp": 1702895811.469
               }
           },
           {
               "region": "eu-north-1",
               "status": "ACTIVE",
               "capacitySpecification": {
                   "throughputMode": "PAY_PER_REQUEST",
                   "lastUpdateToPayPerRequestTimestamp": 1702895811.121
               }
           }
       ]
   }
   ```

------

# Amazon Keyspaces で自動スケーリングが有効なプロビジョンドモードのマルチリージョンテーブルを作成する
<a name="tables-mrr-create-provisioned"></a>

このセクションでは、自動スケーリングが有効なプロビジョンドモードのマルチリージョンテーブルを作成する方法の例を紹介します。この作業は、Amazon Keyspaces コンソール、CQL、または AWS CLIを使用して行うことができます。

サポートされている設定とマルチリージョンレプリケーション機能の詳細については、「」を参照してください[Amazon Keyspaces マルチリージョンレプリケーションの使用に関する注意事項](multiRegion-replication_usage-notes.md)。

マルチリージョンキースペースを作成するには、「[Amazon Keyspaces でマルチリージョンキースペースを作成する](keyspaces-mrr-create.md)」を参照してください。

自動スケーリング設定を使用してプロビジョンドモードの新しいマルチリージョンテーブルを作成する場合、そのテーブルのレプリケート先のすべての AWS リージョン に適用される汎用設定を指定できます。その上で、読み取りキャパシティ設定と読み取りの自動スケーリング設定をレプリカごとに上書きできます。一方、書き込みキャパシティについては、すべてのリージョン間で書き込みをレプリケートするためのキャパシティを十分に確保するため、すべてのレプリカ間で同期されます。

**注記**  
Amazon Keyspaces の自動スケーリングでは、ユーザーに代わって自動スケーリングアクションを実行するサービスリンクロール (`AWSServiceRoleForApplicationAutoScaling_CassandraTable`) の存在が必要になります。このロールは自動的に作成されます。詳細については、「[Amazon Keyspaces のサービスリンクロールの使用](using-service-linked-roles.md)」を参照してください。

------
#### [ Console ]

**自動スケーリングが有効な新しいマルチリージョンテーブルを作成する**

1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。

1. マルチリージョンキー空間を選択します。

1. [**テーブル**] タブで [**テーブルを作成**] を選択します。

1. [**Table details (テーブルの詳細)**] セクションの [**Create table (テーブルの作成)**] ページで、キースペースを選択し、新しいテーブルに名前を付けます。

1. **[列]** セクションで、テーブルのスキーマを作成します。

1. **[プライマリキー]** セクションで、テーブルのプライマリキーを定義し、オプションでクラスタリング列を選択します。

1. **[テーブルの設定]** セクションで、**[設定のカスタマイズ]** を選択します。

1. [**Read/write capacity settings (読み取り/書き込みキャパシティの設定)**] に進みます。

1. [**Capacity mode (キャパシティモード)**] で、[**Provisioned (プロビジョン)**] を選択します。

1. [**Read capacity]** (読み取りキャパシティ) セクションで、[**Scale automatically (自動スケーリング)**] が選択されているか確認します。

   テーブルのレプリケート先のすべての AWS リージョン で同じ読み取りキャパシティユニットを設定するチェックボックスを選択できます。または、そのチェックボックスの選択を解除して、リージョンごとに別々の読み取りキャパシティを設定できます。

   リージョンごとに別々に設定する選択肢を選んだ場合は、各テーブルレプリカの最小と最大の読み取りキャパシティユニットとターゲット使用率を併せて選択します。
   + **最小キャパシティユニット** — テーブルをいつでもすぐにサポートできる状態にするために、最小レベルのスループット値を入力します。この値は、1 から、アカウントの秒単位の最大スループットクォータ (デフォルトは 40,000) までの範囲でなければなりません。
   + **最大キャパシティユニット** — テーブルに対してプロビジョニングするスループットの最大量を入力します。この値は、1 から、アカウントの秒単位の最大スループットクォータ (デフォルトは 40,000) までの範囲でなければなりません。
   + **ターゲット使用率**— ターゲット使用率を 20%～90% の範囲で入力します。定義したターゲット使用率をトラフィックが上回ると、キャパシティが自動的に増加されます。定義したターゲットをトラフィックが下回ると、再び容量が自動的に減少されます。
   + テーブルの読み取りキャパシティを手動でプロビジョニングする場合は、**[自動スケーリング]** チェックボックスの選択を解除します。この設定は、テーブルのすべてのレプリカに適用されます。
**注記**  
すべてのレプリカに十分な読み取りキャパシティを確保するために、プロビジョンドモードのマルチリージョンテーブルでは Amazon Keyspaces の自動スケーリングを使用することをお勧めします。
**注記**  
アカウントのデフォルトクォータの詳細およびクォータを引き上げる方法については、「[Amazon Keyspaces (Apache Cassandra 向け) のクォータ](quotas.md)」を参照してください。

1. **[読み込みキャパシティ]** セクションで、**[自動スケーリング]** が選択されていることを確認します。その上で、テーブルのキャパシティユニットを設定します。書き込みキャパシティユニットは、すべてのリージョン間で書き込みイベントをレプリケートするためのキャパシティを十分に確保するため、すべての AWS リージョン 間で同期されます。
   + テーブルの書き込みキャパシティを手動でプロビジョニングする場合は、**[自動スケーリング]** の選択を解除します。この設定は、テーブルのすべてのレプリカに適用されます。
**注記**  
すべてのレプリカに十分な書き込みキャパシティを確保するために、プロビジョンドモードのマルチリージョンテーブルでは Amazon Keyspaces の自動スケーリングを使用することをお勧めします。

1. [**Create table (テーブルの作成)**] を選択します。指定した自動スケーリングパラメータを使用してテーブルが作成されます。

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

**自動スケーリングが有効なプロビジョンドキャパシティモードのマルチリージョンテーブルを CQL を使用して作成する**
+ 自動スケーリングが有効なプロビジョンドモードのマルチリージョンテーブルを作成するには、まず、テーブルの `CUSTOM_PROPERTIES` を定義し、キャパシティモードを指定する必要があります。プロビジョンド (provisioned) キャパシティモードを指定した後で、`AUTOSCALING_SETTINGS` を使用して、テーブルの自動スケーリングを設定できます。

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

  特定のリージョン内のテーブルレプリカの読み取りキャパシティを定義するには、テーブルの `replica_updates` の一部として次のパラメータを設定できます。
  + リージョン
  + プロビジョニングされた読み取りキャパシティユニット (オプション)
  + 読み取りキャパシティの自動スケーリング設定 (オプション)

  次の例は、プロビジョンドモードのマルチリージョンテーブルの `CREATE TABLE` ステートメントです。書き込みキャパシティと読み取りキャパシティの自動スケーリングの汎用設定は同じです。ただし、読み取りの自動スケーリング設定では、テーブルの読み取りキャパシティをスケールアップまたはスケールダウンする前のクールダウン期間として 60 秒が追加で指定されています。さらに、米国東部 (バージニア北部) リージョンの読み取りキャパシティの自動スケーリング設定は、他のレプリカと比べて高めの設定になっています。また、ターゲット値の設定も 50% ではなく 70% です。

  ```
  CREATE TABLE mykeyspace.mytable(pk int, ck int, PRIMARY KEY (pk, ck))
  WITH CUSTOM_PROPERTIES = {  
      'capacity_mode': {  
          'throughput_mode': 'PROVISIONED',  
          'read_capacity_units': 5,  
          'write_capacity_units': 5  
      }
  } 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を使用します。マルチリージョンの自動スケーリングの設定には、Amazon Keyspaces CLI の `create-table` コマンドを使用する必要があります。その理由は、Application Auto Scaling (Amazon Keyspaces が自動スケーリングを実行するために使用するサービス) がマルチリージョンに対応していないからです。

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

  特定のリージョン内のテーブルレプリカの読み取りキャパシティを定義するには、テーブルの `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 create-table --keyspace-name mykeyspace --table-name mytable \
  --schema-definition 'allColumns=[{name=pk,type=int},{name=ck,type=int}],partitionKeys=[{name=pk},{name=ck}]' \
  --capacity-specification throughputMode=PROVISIONED,readCapacityUnits=1,writeCapacityUnits=1 \
  --auto-scaling-specification file://auto-scaling.json \
  --replica-specifications file://replication.json
  ```

------

# 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
  ```

------

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

マルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定は、Amazon Keyspaces コンソール、CQL、または AWS CLIで表示できます。このセクションでは、CQL と を使用してこれを行う方法の例を示します AWS CLI。

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

**CQL を使用してマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定を表示する**
+ マルチリージョンテーブルの自動スケーリング設定を表示するには、次のコマンドを使用します。

  ```
  SELECT * FROM system_multiregion_info.autoscaling WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';
  ```

  このコマンドの出力は、次のようになります。

  ```
   keyspace_name  | table_name | region         | provisioned_read_capacity_autoscaling_update                                                                                                                                                                      | provisioned_write_capacity_autoscaling_update
  ----------------+------------+----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
    mykeyspace    |  mytable   | ap-southeast-1 | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 60, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 60}}} | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 0, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 0}}}
    mykeyspace    |  mytable   | us-east-1      | {'minimum_units': 5, 'maximum_units': 20, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 60, 'disable_scale_in': false, 'target_value': 70, 'scale_in_cooldown': 60}}} | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 0, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 0}}}
    mykeyspace    |  mytable   | eu-west-1      | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 60, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 60}}} | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 0, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 0}}}
  ```

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

**を使用してマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリング設定を表示する AWS CLI**
+ マルチリージョンテーブルの自動スケーリング設定を表示するには、`get-table-auto-scaling-settings` オペレーションを使用します。次の CLI コマンドは一例です。

  ```
  aws keyspaces get-table-auto-scaling-settings --keyspace-name mykeyspace --table-name mytable
  ```

  次のような出力が表示されます。

  ```
  {
      "keyspaceName": "mykeyspace",
      "tableName": "mytable",
      "resourceArn": "arn:aws:cassandra:us-east-1:777788889999:/keyspace/mykeyspace/table/mytable",
      "autoScalingSpecification": {
          "writeCapacityAutoScaling": {
              "autoScalingDisabled": false,
              "minimumUnits": 5,
              "maximumUnits": 10,
              "scalingPolicy": {
                  "targetTrackingScalingPolicyConfiguration": {
                      "disableScaleIn": false,
                      "scaleInCooldown": 0,
                      "scaleOutCooldown": 0,
                      "targetValue": 50.0
                  }
              }
          },
          "readCapacityAutoScaling": {
              "autoScalingDisabled": false,
              "minimumUnits": 5,
              "maximumUnits": 20,
              "scalingPolicy": {
                  "targetTrackingScalingPolicyConfiguration": {
                      "disableScaleIn": false,
                      "scaleInCooldown": 60,
                      "scaleOutCooldown": 60,
                      "targetValue": 70.0
                  }
              }
          }
      },
      "replicaSpecifications": [
          {
              "region": "us-east-1",
              "autoScalingSpecification": {
                  "writeCapacityAutoScaling": {
                      "autoScalingDisabled": false,
                      "minimumUnits": 5,
                      "maximumUnits": 10,
                      "scalingPolicy": {
                          "targetTrackingScalingPolicyConfiguration": {
                              "disableScaleIn": false,
                              "scaleInCooldown": 0,
                              "scaleOutCooldown": 0,
                              "targetValue": 50.0
                          }
                      }
                  },
                  "readCapacityAutoScaling": {
                      "autoScalingDisabled": false,
                      "minimumUnits": 5,
                      "maximumUnits": 20,
                      "scalingPolicy": {
                          "targetTrackingScalingPolicyConfiguration": {
                              "disableScaleIn": false,
                              "scaleInCooldown": 60,
                              "scaleOutCooldown": 60,
                              "targetValue": 70.0
                          }
                      }
                  }
              }
          },
          {
              "region": "eu-north-1",
              "autoScalingSpecification": {
                  "writeCapacityAutoScaling": {
                      "autoScalingDisabled": false,
                      "minimumUnits": 5,
                      "maximumUnits": 10,
                      "scalingPolicy": {
                          "targetTrackingScalingPolicyConfiguration": {
                              "disableScaleIn": false,
                              "scaleInCooldown": 0,
                              "scaleOutCooldown": 0,
                              "targetValue": 50.0
                          }
                      }
                  },
                  "readCapacityAutoScaling": {
                      "autoScalingDisabled": false,
                      "minimumUnits": 5,
                      "maximumUnits": 10,
                      "scalingPolicy": {
                          "targetTrackingScalingPolicyConfiguration": {
                              "disableScaleIn": false,
                              "scaleInCooldown": 60,
                              "scaleOutCooldown": 60,
                              "targetValue": 50.0
                          }
                      }
                  }
              }
          }
      ]
  }
  ```

------

# Amazon Keyspaces でテーブルの自動スケーリングを無効にする
<a name="tables-mrr-autoscaling-off"></a>

このセクションでは、プロビジョンドキャパシティモードのマルチリージョンテーブルの自動スケーリングを無効にする方法の例を紹介します。この作業は、Amazon Keyspaces コンソール、CQL、または AWS CLIを使用して行うことができます。

**重要**  
プロビジョンドキャパシティモードを使用するマルチリージョンテーブルでは、自動スケーリングを使用することをお勧めします。詳細については、「[Amazon Keyspaces でマルチリージョンテーブルのキャパシティを推定およびプロビジョニングする](tables-multi-region-capacity.md)」を参照してください。

**注記**  
Application Auto Scaling で使用されているサービスリンクロールを削除するには、すべての AWS リージョンにおいてアカウント内のすべてのテーブルで自動スケーリングを無効にする必要があります。

------
#### [ Console ]

**コンソールで既存のマルチリージョンテーブルの Amazon Keyspaces 自動スケーリングを無効にする**

1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。

1. 操作対象のテーブルを選択してから、**[キャパシティ]** を選択します。

1. **[キャパシティ設定]** セクションで、**[編集]** を選択します。

1. Amazon Keyspaces の自動スケーリングを無効にするには、**[自動スケーリング]** チェックボックスの選択を解除します。自動スケーリングを無効にすると、Application Auto Scaling のスケーラブルターゲットとしてのテーブルの登録が解除されます。Amazon Keyspaces テーブルにアクセスするために Application Auto Scaling が使用するサービスリンクロールを削除するには、「[Amazon Keyspaces のサービスリンクロールの削除](using-service-linked-roles-app-auto-scaling.md#delete-service-linked-role-app-auto-scaling)」の手順を実行してください。

1. 自動スケーリング設定が定義されたら、[**Save (保存)**] を選択します。

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

**CQL を使用してマルチリージョンテーブルの自動スケーリングを無効にする**
+  `ALTER TABLE` を使用して、既存のテーブルの自動スケーリングを無効にすることができます。テーブルレプリカの自動スケーリングを個別に無効化することはできません。

  次の例では、テーブルの読み取りキャパシティに対する自動スケーリングを無効にしています。

  ```
  ALTER TABLE mykeyspace.mytable
  WITH AUTOSCALING_SETTINGS = {
      'provisioned_read_capacity_autoscaling_update': {
          'autoscaling_disabled': true
      }
  };
  ```

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

**を使用してマルチリージョンテーブルの自動スケーリングをオフにする AWS CLI**
+  コマンドを使用して AWS CLI `update-table`、既存のテーブルの自動スケーリングをオフにできます。テーブルレプリカの自動スケーリングを個別に無効化することはできません。

  次の例では、テーブルの読み取りキャパシティに対する自動スケーリングを無効にしています。

  ```
  aws keyspaces update-table --keyspace-name mykeyspace --table-name mytable 
             \ --auto-scaling-specification readCapacityAutoScaling={autoScalingDisabled=true}
  ```

------

# Amazon Keyspaces でマルチリージョンテーブルにプロビジョニングされるキャパシティを手動で設定する
<a name="tables-mrr-capacity-manually"></a>

マルチリージョンテーブルの自動スケーリングを無効にする必要がある場合は、CQL または AWS CLIを使用して、レプリカテーブル用の読み取りキャパシティを手動でプロビジョニングすることができます。

**注記**  
プロビジョンドキャパシティモードを使用するマルチリージョンテーブルでは、自動スケーリングを使用することをお勧めします。詳細については、「[Amazon Keyspaces でマルチリージョンテーブルのキャパシティを推定およびプロビジョニングする](tables-multi-region-capacity.md)」を参照してください。

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

**CQL を使用してマルチリージョンテーブルにプロビジョニングされるキャパシティを手動で設定する**
+ `ALTER TABLE` を使用して、レプリカテーブルの読み取りキャパシティを手動でプロビジョニングすることができます。

  ```
  ALTER TABLE mykeyspace.mytable
  WITH CUSTOM_PROPERTIES = {  
      'capacity_mode': {  
          'throughput_mode': 'PROVISIONED',  
          'read_capacity_units': 1,  
          'write_capacity_units': 1  
      },
      'replica_updates': {
          'us-east-1': {
              'read_capacity_units': 2
           }
      }
  };
  ```

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

**を使用してマルチリージョンテーブルのプロビジョニングされた容量を手動で設定する AWS CLI**
+ マルチリージョンテーブルの自動スケーリングを無効にする必要がある場合は、`update-table` を使用して、レプリカテーブルの読み取りキャパシティを手動でプロビジョニングすることができます。

  ```
  aws keyspaces update-table --keyspace-name mykeyspace --table-name mytable \
  --capacity-specification throughputMode=PROVISIONED,readCapacityUnits=1,writeCapacityUnits=1 \
  --replica-specifications region="us-east-1",readCapacityUnits=5
  ```

------