

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

# 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 AWS 리전 Keyspaces의 키스페이스에 추가](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 권한은 *서비스 인증 참조*의 [Amazon Keyspaces(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`

테이블이 Auto Scaling이 활성화된 프로비저닝 모드로 구성된 경우 다음과 같은 추가 권한이 필요합니다.
+ `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>

이 섹션에서는 다중 리전 키스페이스를 만드는 방법에 대한 예제를 제공합니다. CQL 또는 AWS CLI를 사용하여 Amazon Keyspaces 콘솔에서 이 작업을 수행할 수 있습니다. 다중 리전 키스페이스에서 생성된 모든 테이블은 키스페이스의 다중 리전 설정을 자동으로 상속합니다.

**참고**  
다중 리전 키스페이스를 생성할 때 Amazon Keyspaces는 계정의 이름 `AWSServiceRoleForAmazonKeyspacesReplication`을 사용하여 서비스 연결 역할을 생성합니다. 이 역할을 통해 Amazon Keyspaces는 사용자를 대신하여 다중 리전 테이블의 모든 복제본에 쓰기를 복제할 수 있습니다. 자세한 내용은 [Amazon Keyspaces 다중 리전 복제에 역할 사용](using-service-linked-roles-multi-region-replication.md)를 참조하세요.

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

**다중 리전 키스페이스 생성(콘솔)**

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) Amazon Keyspaces 콘솔을 엽니다.

1. 탐색 창에서 **Keyspaces**를 선택한 다음 **키스페이스 생성**을 선택합니다.

1. **키스페이스 이름**에 키스페이스의 이름을 입력합니다.

1. **다중 리전 복제** 섹션에서 목록에서 사용할 수 있는 추가 리전을 추가할 수 있습니다.

1. 완료하려면 **키스페이스 생성**을 선택합니다.

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

**CQL을 사용하여 다중 리전 키스페이스 생성**

1. 다중 리전 키스페이스를 생성하려면 `NetworkTopologyStrategy`를 사용하여 키스페이스 AWS 리전 가 복제될를 지정합니다. 현재 리전과 하나 이상의 추가 리전을 포함해야 합니다.

   키스페이스의 모든 테이블은 키스페이스에서 복제 전략을 상속합니다. 테이블 수준에서는 복제 전략을 변경할 수 없습니다.

   `NetworkTopologyStrategy` - Amazon Keyspaces는 AWS 리전기본적으로 동일한 내의 [세 가용 영역에](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/) 데이터를 복제하기 때문에 각 리전의 복제 인수는 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`에 지정합니다.

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

------

# 키스페이스에 새 리전을 추가할 때 복제 진행 상황 확인
<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>

이 섹션에서는 모든 기본 설정을 사용하여 온디맨드 모드에서 다중 리전 테이블을 생성하는 방법의 예를 제공합니다. CQL 또는 AWS CLI를 사용하여 Amazon Keyspaces 콘솔에서 이 작업을 수행할 수 있습니다. 다중 리전 키스페이스에서 생성된 모든 테이블은 키스페이스의 다중 리전 설정을 자동으로 상속합니다.

다중 리전 키스페이스를 생성하려면 [Amazon Keyspaces에서 다중 리전 키스페이스 생성](keyspaces-mrr-create.md) 섹션을 참조하세요.

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

**기본 설정을 사용하여 다중 리전 테이블 생성(콘솔)**

1. 에 로그인 AWS Management Console하고 [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 소유 키** 옵션만 지원됩니다.
   + **클라이언트 측 타임스탬프** - 이 기능은 다중 리전 테이블에 필요합니다.
   + 테이블 및 모든 복제본에 대해 TTL(Time To Live)을 켜야 하는 경우 **설정 사용자 지정**을 선택합니다.
**참고**  
기존 다중 리전 테이블에서는 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>

이 섹션에서는 오토 스케일링을 사용하여 프로비저닝된 모드에서 다중 리전 테이블을 생성하는 방법의 예를 제공합니다. CQL 또는 AWS CLI를 사용하여 Amazon Keyspaces 콘솔에서 이 작업을 수행할 수 있습니다.

지원되는 구성 및 다중 리전 복제 기능에 대한 자세한 내용은 섹션을 참조하세요[Amazon Keyspaces 다중 리전 복제 사용 정보](multiRegion-replication_usage-notes.md).

다중 리전 키스페이스를 생성하려면 [Amazon Keyspaces에서 다중 리전 키스페이스 생성](keyspaces-mrr-create.md) 섹션을 참조하세요.

프로비저닝된 모드에서 오토 스케일링 설정을 사용하여 새 다중 리전 테이블을 생성할 때 테이블이 복제되는 모든 AWS 리전 에 유효한 테이블의 일반 설정을 지정할 수 있습니다. 그런 다음 읽기 용량 설정을 덮어쓰고 각 복제본에 대한 오토 스케일링 설정을 읽을 수 있습니다. 하지만 쓰기 용량은 모든 복제본 간에 동기화된 상태로 유지되어 모든 리전에서 쓰기를 복제할 수 있는 충분한 용량이 확보됩니다.

**참고**  
Amazon Keyspaces Auto Scaling을 사용하려면 사용자 대신 Auto Scaling 작업을 수행하는 서비스 연결 역할(`AWSServiceRoleForApplicationAutoScaling_CassandraTable`)이 있어야 합니다. 이 역할은 자동으로 생성됩니다. 자세한 내용은 [Amazon Keyspaces에 대해 서비스 연결 역할 사용](using-service-linked-roles.md) 단원을 참조하십시오.

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

**오토 스케일링이 활성화된 새 다중 리전 테이블 만들기**

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) Amazon Keyspaces 콘솔을 엽니다.

1. 다중 리전 키스페이스를 선택합니다.

1. **테이블** 탭에서 **테이블 생성**을 선택합니다.

1. **테이블 세부 정보** 섹션의 **테이블 생성** 페이지에서 키스페이스를 선택하고 새 테이블의 이름을 입력합니다.

1. **열** 섹션에서 테이블의 스키마를 생성합니다.

1. **프라이머리 키** 섹션에서 테이블의 프라이머리 키를 정의하고 선택적 클러스터링 열을 선택합니다.

1. **테이블 설정** 섹션에서 **설정 사용자 지정**을 선택합니다.

1. **읽기/쓰기 용량 설정**을 계속합니다.

1. **용량 모드**에서 **프로비저닝됨**을 선택합니다.

1. **읽기 용량** 섹션에서 **자동 규모 조정**이 선택되어 있는지 확인합니다.

   테이블이 복제되는 모든 AWS 리전 에 대해 동일한 읽기 용량 단위를 구성하도록 선택할 수 있습니다. 또는 확인란을 선택 취소하고 각 리전의 읽기 용량을 다르게 구성할 수 있습니다.

   각 리전을 다르게 구성하도록 선택한 경우 각 테이블 복제본의 최소 및 최대 읽기 용량 단위와 대상 사용률을 선택합니다.
   + **최소 용량 단위** - 테이블이 항상 지원할 준비가 되어 있어야 하는 최소 처리량 수준 값을 입력합니다. 값은 1에서 계정에 대해 초당 최대 처리량 할당량(기본값 40,000) 사이여야 합니다.
   + **최대 용량 단위** - 테이블에 프로비저닝하려는 최대 처리량을 입력합니다. 값은 1에서 계정에 대해 초당 최대 처리량 할당량(기본값 40,000) 사이여야 합니다.
   + **목표 사용률** — 목표 사용률을 20% \$1 90% 사이로 입력합니다. 트래픽이 정의된 목표 사용률을 초과하면 용량이 자동으로 스케일 업됩니다. 트래픽이 정의된 목표 미만으로 떨어지면 자동으로 다시 스케일 다운됩니다.
   + 테이블의 읽기 용량을 수동으로 프로비저닝하려면 **자동 확장** 확인란을 선택 취소합니다. 이 설정은 테이블의 모든 복제본에 적용됩니다.
**참고**  
모든 복제본에 대한 읽기 용량이 충분하도록 하려면 프로비저닝된 다중 리전 테이블의 Amazon Keyspaces 오토 스케일링을 사용하는 것이 좋습니다.
**참고**  
계정의 기본 할당량 및 할당량을 높이는 방법에 대한 자세한 내용은 [Amazon Keyspaces(Apache Cassandra용)에 대한 할당량](quotas.md) 섹션을 참조하세요.

1. **쓰기 용량** 섹션에서 **자동 확장**이 선택되어 있는지 확인합니다. 그런 다음 테이블의 용량 단위를 구성합니다. 쓰기 용량 단위는 리전 전체에 걸쳐 쓰기 이벤트를 복제할 수 있는 충분한 용량을 확보하기 위해 모든 AWS 리전 에서 동기화 상태를 유지합니다.
   + 테이블의 쓰기 용량을 수동으로 프로비저닝하려면 **자동 확장**을 지웁니다. 이 설정은 테이블의 모든 복제본에 적용됩니다.
**참고**  
모든 복제본에 대한 쓰기 용량이 충분하도록 하려면 프로비저닝된 다중 리전 테이블의 Amazon Keyspaces 오토 스케일링을 사용하는 것이 좋습니다.

1. **테이블 생성**을 선택합니다. Auto Scaling 파라미터로 테이블이 생성됩니다.

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

**CQL을 사용하여 프로비저닝된 용량 모드 및 오토 스케일링으로 다중 리전 테이블 생성**
+ 오토 스케일링 기능이 있는 프로비저닝 모드에서 멀티 리전 테이블을 생성하려면 먼저 테이블에 대한 `CUSTOM_PROPERTIES`를 정의하여 용량 모드를 지정해야 합니다. 프로비저닝된 용량 모드를 지정한 후 `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 ]

**를 사용하여 Auto Scaling을 사용하여 프로비저닝된 모드에서 새 다중 리전 테이블 생성 AWS CLI**
+ 오토 스케일링 구성을 사용하는 프로비저닝된 모드에서 다중 리전 테이블을 생성하려면 AWS CLI를 사용할 수 있습니다. Amazon Keyspaces CLI `create-table` 명령을 사용하여 다중 리전 오토 스케일링 설정을 구성해야 합니다. 이는 Amazon Keyspaces가 사용자를 대신하여 오토 스케일링을 수행하는 데 사용하는 서비스인 애플리케이션 오토 스케일링이 여러 리전을 지원하지 않기 때문입니다.

  오토 스케일링 설정, 대상 추적 정책, 대상 값 및 선택적 설정에 대한 자세한 내용은 [오토 스케일링을 사용하여 새 테이블 만들기](autoscaling.createTable.md) 섹션을 참조하세요.

  특정 리전에서 테이블 복제본의 읽기 용량을 정의하려면 다음 파라미터를 테이블 `replicaSpecifications`의 일부로 구성할 수 있습니다.
  + 리전
  + 프로비저닝된 읽기 용량 단위(선택 사항)
  + 읽기 용량에 대한 오토 스케일링 설정(선택 사항)

  복잡한 오토 스케일링 설정과 테이블 복제본에 대한 다양한 구성으로 프로비저닝된 다중 리전 테이블을 생성할 때는 JSON 파일에서 테이블의 오토 스케일링 설정과 복제본 구성을 로드하는 것이 좋습니다.

  다음 코드 예제를 사용하려면 [auto-scaling.zip](samples/auto-scaling.zip)에서 예제 JSON 파일을 다운로드하고 `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 Auto Scaling 설정을 AWS CLI 관리하는 방법에 대한 예제가 포함되어 있습니다. 일반적인 오토 스케일링 구성 옵션과 작동 방식에 대한 자세한 내용은 [Amazon Keyspaces 오토 스케일링으로 처리량 용량 자동 관리](autoscaling.md) 섹션을 참조하세요.

다중 리전 테이블에 프로비저닝된 용량 모드를 사용하는 경우 항상 Amazon Keyspaces API 직접 호출을 사용하여 오토 스케일링을 구성해야 합니다. 이는 기본 애플리케이션 오토 스케일링 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**
+ 기존 테이블의 프로비저닝된 모드 및 Auto Scaling 구성을 업데이트하려면 명령을 사용할 AWS CLI `update-table` 수 있습니다.

  Amazon Keyspaces CLI 명령을 사용하여 다중 리전 오토 스케일링 설정을 생성하거나 수정해야 합니다. 이는 Amazon Keyspaces가 사용자를 대신하여 테이블 용량의 오토 스케일링을 수행하는 데 사용하는 서비스인 애플리케이션 오토 스케일링이 여러 AWS 리전을 지원하지 않기 때문입니다.

   특정 리전에서 테이블 복제본의 읽기 용량을 업데이트하려면 테이블 `replicaSpecifications`의 다음 선택적 파라미터 중 하나를 변경할 수 있습니다.
  + 프로비저닝된 읽기 용량 단위(선택 사항)
  + 읽기 용량에 대한 오토 스케일링 설정(선택 사항)

  복잡한 오토 스케일링 설정과 테이블 복제본에 대한 다양한 구성으로 다중 리전 테이블을 업데이트할 때는 JSON 파일에서 테이블의 오토 스케일링 설정과 복제본 구성을 로드하는 것이 좋습니다.

  다음 코드 예제를 사용하려면 [auto-scaling.zip](samples/auto-scaling.zip)에서 예제 JSON 파일을 다운로드하고 `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>

CQL 또는 AWS CLI를 사용하여 Amazon Keyspaces 콘솔에서 다중 리전 테이블의 프로비저닝된 용량 및 오토 스케일링 설정을 볼 수 있습니다. 이 섹션에서는 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>

이 섹션에서는 프로비저닝된 용량 모드에서 다중 리전 테이블의 오토 스케일링을 끄는 방법의 예를 제공합니다. CQL 또는 AWS CLI를 사용하여 Amazon Keyspaces 콘솔에서 이 작업을 수행할 수 있습니다.

**중요**  
프로비저닝된 용량 모드를 사용하는 다중 리전 테이블에는 오토 스케일링을 사용하는 것이 좋습니다. 자세한 내용은 [Amazon Keyspaces에서 다중 리전 테이블의 용량 추정 및 프로비저닝](tables-multi-region-capacity.md) 단원을 참조하십시오.

**참고**  
애플리케이션 오토 스케일링에서 사용하는 서비스 연결 역할을 삭제하려면 모든 AWS 리전에 걸쳐 계정의 모든 테이블에서 오토 스케일링을 비활성화해야 합니다.

------
#### [ 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. **용량 설정** 섹션에서 **편집**을 선택합니다.

1. Amazon Keyspaces 오토 스케일링을 비활성화하려면 **자동 규모 조정** 확인란의 선택을 취소합니다. 오토 스케일링을 비활성화하면 애플리케이션 오토 스케일링으로 확장 가능한 대상인 테이블의 등록이 취소됩니다. 애플리케이션 오토 스케일링을 사용하여 Amazon Keyspaces 테이블에 액세스하는 서비스 연결 역할을 삭제하려면 [Amazon Keyspaces에 대한 서비스 연결 역할 삭제](using-service-linked-roles-app-auto-scaling.md#delete-service-linked-role-app-auto-scaling)의 단계를 따르세요.

1. Auto Scaling 설정이 정의되면 **저장**을 선택합니다.

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

------