기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon AWS 리전 Keyspaces의 키스페이스에 추가
<a name="keyspaces-multi-region-add-replica"></a>

단일 또는 다중 리전 키스페이스인 키스페이스 AWS 리전 에 새를 추가할 수 있습니다. 새 복제본 리전은 키스페이스의 모든 테이블에 적용됩니다.

단일 리전을 다중 리전 키스페이스로 변경하려면 키스페이스의 모든 테이블에 대해 클라이언트 측 타임스탬프를 활성화해야 합니다. 자세한 내용은 [Amazon Keyspaces의 클라이언트 측 타임스탬프](client-side-timestamps.md) 단원을 참조하십시오.

다중 리전 키스페이스에 리전을 추가하는 경우 Amazon Keyspaces는 각 기존 테이블에 대해 일회성 교차 리전 복원을 사용하여 기존 테이블(들)을 새 리전에 복제해야 합니다. 각 테이블의 복원 요금은 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는 테이블을 새 리전에 복제하고 사용자를 대신하여 한 테이블의 쓰기를 다중 리전 테이블의 모든 복제본에 복제할 수 있습니다. 자세한 내용은 [Amazon Keyspaces 다중 리전 복제에 역할 사용](using-service-linked-roles-multi-region-replication.md)를 참조하세요.

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

Amazon Keyspaces 콘솔을 사용하여 키스페이스에 리전을 추가하려면 다음 단계를 따르세요.

**키스페이스에 리전 추가(콘솔)**

1. 에 로그인 AWS Management Console하고 [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"}'
  ```

------