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

# 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"}'
  ```

------