기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Keyspaces에 대한 다중 리전 복제(Apache Cassandra용)
Amazon Keyspaces 다중 리전 복제를 사용하여 선택한에서 자동화된 완전 관리*형 액티브-액티브* 복제를 통해 데이터를 복제할 수 AWS 리전 있습니다. 액티브-액티브 복제를 사용하면 각 리전이 개별적으로 읽기 및 쓰기를 수행할 수 있습니다. 지역적 성능 저하를 통해 가용성과 복원력을 모두 향상시키는 동시에 글로벌 애플리케이션의 로컬 읽기 및 쓰기 지연 시간이 짧은 이점을 누릴 수 있습니다.
다중 리전 복제를 사용하면 Amazon Keyspaces는 리전 간에 데이터를 비동기식으로 복제하며, 데이터는 일반적으로 1초 이내에 리전 간에 전파됩니다. 또한 다중 리전 복제를 사용하면 충돌을 해결하고 데이터 발산 문제를 수정하는 어려운 작업이 더 이상 없으므로 애플리케이션에 집중할 수 있습니다.
기본적으로 Amazon Keyspaces는 내구성과 고가용성을 AWS 리전 위해 동일한 내의 세 [ 가용 영역에](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/) 데이터를 복제합니다. 다중 리전 복제를 사용하면 원하는 다양한 지리적 위치에 테이블을 복제하는 다중 리전 키스페이스 AWS 리전 를 생성할 수 있습니다.
**Topics**
+ [다중 리전 복제 사용의 이점](#mrr-benefits)
+ [용량 모드 및 요금](#mrr-pricing)
+ [Amazon Keyspaces에서 다중 리전 복제가 작동하는 방식](multiRegion-replication_how-it-works.md)
+ [Amazon Keyspaces 다중 리전 복제 사용 정보](multiRegion-replication_usage-notes.md)
+ [Amazon Keyspaces(Apache Cassandra용)에 대한 다중 리전 복제 구성](multiRegion-replication-configure.md)
## 다중 리전 복제 사용의 이점
다중 리전 복제는 다음과 같은 이점을 제공합니다.
+ **지연 시간이 한 자릿수 밀리초인 전역 읽기 및 쓰기** - Amazon Keyspaces에서 복제는 활성-활성 상태입니다. 규모에 상관없이 한 자릿수 밀리초 지연 시간으로 고객과 가장 가까운 리전에서 로컬로 읽기와 쓰기를 모두 제공할 수 있습니다. 전 세계 어디서나 빠른 응답 시간이 필요한 글로벌 애플리케이션에 Amazon Keyspaces 다중 리전 테이블을 사용할 수 있습니다.
+ **비즈니스 연속성 개선 및 단일 리전 성능 저하 방지** - 다중 리전 복제를 사용하면 애플리케이션을 다중 리전 키스페이스의 다른 리전으로 리디렉션 AWS 리전 하여 단일에서 성능 저하를 복구할 수 있습니다. Amazon Keyspaces는 액티브-액티브 복제를 제공하므로 읽기 및 쓰기에 영향을 주지 않습니다.
Amazon Keyspaces는 다중 리전 키스페이스에서 수행된 쓰기 기록을 유지하지만 모든 복제 리전으로 전파하지는 않습니다. 리전이 다시 온라인 상태가 되면 Amazon Keyspaces는 누락된 변경 사항을 자동으로 동기화하므로 애플리케이션에 영향을 주지 않고 복구할 수 있습니다.
+ **리전 간 고속 복제** - 다중 리전 복제는 일반적으로 1초 미만의 복제 지연 시간으로 리전 간 데이터의 빠른 스토리지 기반 물리적 복제를 사용합니다.
Amazon Keyspaces에서의 복제는 애플리케이션과 컴퓨팅 리소스를 공유하지 않기 때문에 데이터베이스 쿼리에 거의 또는 전혀 영향을 주지 않습니다. 즉 애플리케이션에 영향을 주지 않고도 쓰기 처리량이 높은 사용 사례 또는 처리량이 갑자기 급증하거나 급증하는 사용 사례를 해결할 수 있습니다.
+ **일관성 및 충돌 해결** – 모든 리전의 데이터에 대한 모든 변경 사항은 다중 리전 키스페이스의 다른 리전에 복제됩니다. 애플리케이션이 다른 리전에서 동시에 동일한 데이터를 업데이트하는 경우 충돌이 발생할 수 있습니다.
최종 일관성을 제공하기 위해 Amazon Keyspaces는 셀 수준의 타임스탬프와 동시 업데이트 간에 *최종 쓰기 우선* 조정을 사용합니다. 충돌 해결은 완벽하게 관리되며 애플리케이션에 영향을 주지 않고 백그라운드에서 이루어집니다.
지원되는 구성 및 기능에 대한 자세한 내용은 [Amazon Keyspaces 다중 리전 복제 사용 정보](multiRegion-replication_usage-notes.md) 섹션을 참조하세요.
## 용량 모드 및 요금
다중 리전 키스페이스의 경우 *온디맨드 용량 모드* 또는 *프로비저닝된 용량 모드*를 사용할 수 있습니다. 자세한 내용은 [Amazon Keyspaces의 읽기/쓰기 용량 모드 구성](ReadWriteCapacityMode.md) 단원을 참조하십시오.
온디맨드 모드의 경우 단일 리전 테이블과 동일한 방식으로 행당 최대 1KB의 데이터를 쓸 수 있도록 1개의 쓰기 요청 단위(WRU)가 청구됩니다. 그러나 다중 리전 키스페이스의 각 리전에 대한 쓰기 요금은 청구됩니다. 예를 들어 두 리전이 있는 다중 리전 키스페이스에 3KB의 데이터 행을 쓰려면 3 \$1 2 = 6WRU의 6WRUsWRUs 필요합니다. 또한 정적 데이터와 비정적 데이터를 모두 포함하는 쓰기에는 추가 쓰기 작업이 필요합니다.
프로비저닝된 모드의 경우 단일 리전 테이블과 동일한 방식으로 행당 최대 1KB의 데이터를 쓸 수 있도록 쓰기 용량 단위(WCU) 1개가 청구됩니다. 그러나 다중 리전 키스페이스의 각 리전에 대한 쓰기 요금은 청구됩니다. 예를 들어, 두 리전이 있는 다중 리전 키스페이스에서 초당 3KB의 데이터 행을 작성하려면 3 \$1 2 = 6WCUsWCUs 필요합니다. 또한 정적 데이터와 비정적 데이터를 모두 포함하는 쓰기에는 추가 쓰기 작업이 필요합니다.
요금에 대한 자세한 내용은 [Amazon Keyspaces(Apache Cassandra용) 요금](https://aws.amazon.com/keyspaces/pricing)을 참조하세요.
# Amazon Keyspaces에서 다중 리전 복제가 작동하는 방식
이 섹션에서는 Amazon Keyspaces 다중 리전 복제의 작동 방식에 대한 개요를 제공합니다. 요금에 대한 자세한 내용은 [Amazon Keyspaces(Apache Cassandra용) 요금](https://aws.amazon.com/keyspaces/pricing)을 참조하세요.
**Topics**
+ [Amazon Keyspaces에서 다중 리전 복제가 작동하는 방식](#multiRegion-replication_how-it-works-overview)
+ [다중 리전 복제 충돌 해결](#multiRegion-replication_how-it-works-conflict-resolution)
+ [다중 리전 복제 재해 복구](#howitworks_disaster_recovery)
+ [의 다중 리전 복제는 기본적으로 AWS 리전 비활성화되어 있습니다.](#howitworks_mrr_opt_in)
+ [다중 리전 복제 및 point-in-time 복구(PITR)와의 통합](#howitworks_mrr_pitr)
+ [다중 리전 복제 및 AWS 서비스와의 통합](#howitworks_integration)
## Amazon Keyspaces에서 다중 리전 복제가 작동하는 방식
Amazon Keyspaces 다중 리전 복제는 독립적이고 지리적으로 분산된 간에 데이터를 분산하는 데이터 복원력 아키텍처를 구현합니다 AWS 리전. **액티브-액티브 복제를 사용하므로 각 리전이 개별적으로 읽기 및 쓰기를 수행할 수 있어 로컬 지연 시간이 짧습니다.
Amazon Keyspaces 다중 리전 키스페이스를 생성할 때 데이터를 복제할 추가 리전을 선택할 수 있습니다. 다중 리전 키스페이스에서 생성하는 각 테이블은 Amazon Keyspaces가 이를 단일 단위로 간주하는 여러 개의 복제 테이블(리전당 한 개씩)로 구성됩니다.
모든 복제본은 동일한 테이블 이름과 동일한 프라이머리 키 스키마를 갖습니다. 애플리케이션이 한 리전의 로컬 테이블에 데이터를 쓰면 `LOCAL_QUORUM` 일관성 수준을 사용하여 데이터가 안정적으로 쓰여집니다. Amazon Keyspaces는 데이터를 다른 복제 리전에 비동기적으로 자동 복제합니다. 리전 간 복제 지연은 일반적으로 1초 미만이며 애플리케이션의 성능이나 처리량에 영향을 미치지 않습니다.
데이터를 쓴 후에는 `LOCAL_ONE/LOCAL_QUORUM` 일관성 수준이 있는 다른 복제 리전의 다중 리전 테이블에서 데이터를 읽을 수 있습니다. 지원되는 구성 및 기능에 대한 자세한 내용은 [Amazon Keyspaces 다중 리전 복제 사용 정보](multiRegion-replication_usage-notes.md) 섹션을 참조하세요.
![\[사용자는 Amazon Keyspaces 테이블에서 로컬로 데이터를 읽고 쓰는 AWS 리전 반면 Amazon Keyspaces는 사용 가능한 모든 리전의 테이블 간에 쓰기를 비동기적으로 복제합니다.\]](http://docs.aws.amazon.com/ko_kr/keyspaces/latest/devguide/images/keyspaces_multi_Region_replication.png)
## 다중 리전 복제 충돌 해결
Amazon Keyspaces 다중 리전 복제는 완전 관리형이므로 데이터 동기화 문제를 정리하기 위해 정기적으로 복구 작업을 실행하는 등의 복제 작업을 수행할 필요가 없습니다. Amazon Keyspaces는 충돌을 감지하고 복구 AWS 리전 하여 서로 다른의 테이블 간 데이터 일관성을 모니터링하고 복제본을 자동으로 동기화합니다.
Amazon Keyspaces는 데이터 조정의 *최종 쓰기 우선* 방법을 사용합니다. 이러한 충돌 해결 메커니즘을 사용하여 다중 리전 키스페이스의 모든 리전은 최종 업데이트에 합의하며 모두 동일한 데이터를 갖는 상태가 됩니다. 조정 프로세스는 애플리케이션 성능에 영향을 미치지 않습니다. 충돌 해결을 지원하기 위해 다중 리전 테이블의 경우 클라이언트 측 타임스탬프가 자동으로 설정되며 해제할 수 없습니다. 자세한 내용은 [Amazon Keyspaces의 클라이언트 측 타임스탬프](client-side-timestamps.md) 단원을 참조하십시오.
## 다중 리전 복제 재해 복구
Amazon Keyspaces 다중 리전 복제를 사용하면 쓰기가 각 리전에 비동기적으로 복제됩니다. 드물지만 단일 리전 성능 저하 또는 장애가 발생하는 경우 다중 리전 복제를 사용하면 애플리케이션에 거의 또는 전혀 영향을 주지 않고 재해로부터 복구할 수 있습니다. 재해 복구는 일반적으로 Recovery Time Objective(RTO) 및 Recovery Point Objective(RPO)를 사용하여 측정됩니다.
**복구 시간 목표** – 재해 발생 후 시스템이 정상 작동 상태로 돌아가는 데 걸리는 시간입니다. RTO는 워크로드가 허용할 수 있는 가동 중지를 시간 단위로 측정합니다. 다중 리전 복제를 사용하여 영향을 받지 않는 리전으로 장애 조치하는 재해 복구 계획의 경우 RTO는 거의 0이 될 수 있습니다. RTO는 애플리케이션이 장애 상태를 감지하고 트래픽을 다른 리전으로 리디렉션하는 속도에 따라 제한됩니다.
**복구 시점 목표** – 손실될 수 있는 데이터의 양(시간으로 측정)입니다. 다중 리전 복제를 사용하여 영향을 받지 않는 리전으로 장애 조치하는 재해 복구 계획의 경우 RPO는 일반적으로 한 자릿수 초입니다. RPO는 장애 조치 대상 복제본에 대한 복제 지연 시간으로 제한됩니다.
Amazon Keyspaces에서의 복제는 액티브-액티브 방식이므로 리전 장애 또는 성능 저하가 발생하는 경우 보조 리전을 승격하거나 데이터베이스 장애 조치 절차를 수행할 필요가 없습니다. 대신 Amazon Route 53을 사용하여 가장 가까운 정상 리전으로 애플리케이션을 라우팅할 수 있습니다. Route 53에 대해 자세히 알아보려면 [Amazon Route 53은 무엇인가요?](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/Welcome.html)를 참조하세요.
단일가 격리되거나 성능이 저하 AWS 리전 되면 애플리케이션은 Route 53을 사용하여 트래픽을 다른 리전으로 리디렉션하여 다른 복제본 테이블에 대해 읽기 및 쓰기를 수행할 수 있습니다. 또한 요청을 언제 다른 리전으로 리디랙션할지를 결정하는 사용자 지정 비즈니스 로직을 적용할 수 있습니다. 예를 들어 애플리케이션이 사용 가능한 여러 엔드포인트를 인식하도록 하는 경우를 들 수 있습니다.
리전이 다시 온라인 상태로 되면 Amazon Keyspaces는 해당 리전에서 보류 중인 쓰기 전파를 재개하여 다른 리전의 복제본 테이블로 전파합니다. 다시 온라인 상태로 된 리전에 대한 다른 복제본 테이블의 쓰기 전파도 재개됩니다.
## 의 다중 리전 복제는 기본적으로 AWS 리전 비활성화되어 있습니다.
Amazon Keyspaces 다중 리전 복제는 기본적으로 비활성화 AWS 리전 된 다음에서 지원됩니다.
+ 아프리카(케이프타운) 리전
+ Middle East (UAE) Region
+ 아시아 태평양(홍콩)
+ 중동(바레인)
Amazon Keyspaces 다중 리전 복제에서 기본적으로 비활성화된 리전을 사용하려면 먼저 리전을 활성화해야 합니다. 자세한 내용은 [https://docs.aws.amazon.com/organizations/latest/userguide/](https://docs.aws.amazon.com/organizations/latest/userguide/)의 [ 계정 AWS 리전 에서 활성화 또는 비활성화를 참조하세요](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable).
리전을 활성화한 후 리전에서 새 Amazon Keyspaces 리소스를 생성하고 리전을 다중 리전 키스페이스에 추가할 수 있습니다.
Amazon Keyspaces 다중 리전 복제에 사용되는 리전을 비활성화하면 Amazon Keyspaces가 24시간 유예 기간을 시작합니다. 이 기간 동안 다음 동작을 예상할 수 있습니다.
+ Amazon Keyspaces는 활성화된 리전에서 데이터 조작 언어(DML) 작업을 계속 수행합니다.
+ Amazon Keyspaces는 활성화된 리전에서 비활성화된 리전으로 데이터 업데이트 복제를 일시 중지합니다.
+ Amazon Keyspaces는 비활성화된 리전의 모든 데이터 정의 언어(DDL) 요청을 차단합니다.
리전을 잘못 비활성화한 경우 24시간 이내에 리전을 다시 활성화할 수 있습니다. 24시간 유예 기간 동안 리전을 다시 활성화하면 Amazon Keyspaces는 다음 작업을 수행합니다.
+ 다시 활성화된 리전으로의 모든 복제를 자동으로 재개합니다.
+ 리전이 비활성화된 동안 활성화된 리전에서 발생한 모든 데이터 업데이트를 복제하여 데이터 일관성을 보장합니다.
+ 모든 추가 다중 리전 복제 작업을 자동으로 계속합니다.
24시간 기간이 종료된 후에도 리전이 비활성화된 상태로 유지되는 경우 Amazon Keyspaces는 다음 작업을 수행하여 다중 리전 복제에서 리전을 영구적으로 제거합니다.
+ 모든 다중 리전 복제 키스페이스에서 비활성화된 리전을 제거합니다.
+ 비활성화된 리전의 다중 리전 복제 테이블 복제본을 단일 리전 키스페이스 및 테이블로 변환합니다.
+ Amazon Keyspaces는 비활성화된 리전에서 리소스를 삭제하지 않습니다.
Amazon Keyspaces가 다중 리전 키스페이스에서 비활성화된 리전을 영구적으로 제거한 후에는 비활성화된 리전을 다시 추가할 수 없습니다.
## 다중 리전 복제 및 point-in-time 복구(PITR)와의 통합
다중 리전 테이블에는 Point-in-time으로 복구가 지원됩니다. PITR을 사용하여 다중 리전 테이블을 성공적으로 복원하려면 다음 조건을 충족해야 합니다.
+ 소스 및 대상 테이블을 다중 리전 테이블로 구성해야 합니다.
+ 소스 테이블의 키스페이스와 대상 테이블의 키스페이스에 대한 복제 리전은 동일해야 합니다.
+ 원본 테이블의 모든 복제본에서 PITR을 활성화해야 합니다.
소스 테이블을 사용할 수 있는 모든 리전에서 복원 문을 실행할 수 있습니다. Amazon Keyspaces는 각 리전의 대상 테이블을 자동으로 복원합니다. PITR에 대한 자세한 내용은 [Amazon Keyspaces에서 시점 복구가 작동하는 방식](PointInTimeRecovery_HowItWorks.md) 섹션을 참조하세요.
다중 리전 테이블을 생성하면 생성 프로세스 중에 정의하는 PITR 설정이 모든 리전의 모든 테이블에 자동으로 적용됩니다. 를 사용하여 PITR 설정을 변경하면 `ALTER TABLE`Amazon Keyspaces는 업데이트를 로컬 테이블에만 적용하고 다른 리전의 복제본에는 적용하지 않습니다. 기존 다중 리전 테이블에 대해 PITR을 활성화하려면 모든 복제본에 대해 `ALTER TABLE` 문을 반복해야 합니다.
## 다중 리전 복제 및 AWS 서비스와의 통합
Amazon CloudWatch 지표 AWS 리전 를 사용하여 서로 다른의 테이블 간 복제 성능을 모니터링할 수 있습니다. 다음 지표는 다중 리전 키스페이스에 대한 지속적인 모니터링을 제공합니다.
+ `ReplicationLatency` - 이 지표는 다중 리전 키스페이스의 한 복제 테이블에서 다른 복제 테이블로 `updates`, `inserts` 또는 `deletes`를 복제하는 데 걸린 시간을 측정합니다.
CloudWatch 지표를 모니터링하는 방법에 대한 자세한 내용은 [Amazon CloudWatch를 사용하여 Amazon Keyspaces 모니터링](monitoring-cloudwatch.md) 섹션을 참조하세요.
# Amazon Keyspaces 다중 리전 복제 사용 정보
Amazon Keyspaces에서 다중 리전 복제를 사용할 때는 다음 사항을 고려하세요.
+ [사용 가능한 퍼블릭](programmatic.endpoints.md#global_endpoints) AWS 리전을 선택할 수 있습니다. AWS 리전 [기본적으로 비활성화된 ](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)에 대한 자세한 내용은 섹션을 참조하세요[의 다중 리전 복제는 기본적으로 AWS 리전 비활성화되어 있습니다.](multiRegion-replication_how-it-works.md#howitworks_mrr_opt_in).
+ AWS GovCloud (US) Regions 및 중국 리전은 지원되지 않습니다.
+ 기능을 사용할 수 있을 때까지 다음 해결 방법을 고려하세요.
다중 리전 테이블을 생성할 때 TTL(Time To Live)을 구성합니다. TTL을 활성화 및 비활성화하거나 나중에 TTL 값을 조정할 수 없습니다. 자세한 내용은 [Amazon Keyspaces(Apache Cassandra용)의 TTL(Time to Live)을 사용하여 데이터 만료](TTL.md) 단원을 참조하십시오.
+ 저장 시 암호화의 경우 AWS 소유 키를 사용합니다. 현재 다중 리전 테이블에는 고객 관리형 키가 지원되지 않습니다. 자세한 내용은 단원을 참조하세요.
[저장 시 암호화: Amazon Keyspaces 작동 방식](encryption.howitworks.md).
+ `ALTER KEYSPACE`를 사용하여 단일 리전 또는 다중 리전 키스페이스에 리전을 추가할 수 있습니다. 자세한 내용은 [Amazon AWS 리전 Keyspaces의 키스페이스에 추가](keyspaces-multi-region-add-replica.md) 단원을 참조하십시오.
+ 단일 리전 키스페이스에 리전을 추가하기 전에 키스페이스 아래의 테이블이 고객 관리형 키로 구성되지 않았는지 확인합니다.
+ 키스페이스 또는 테이블에 대해 구성된 기존 태그는 새 리전에 복제되지 않습니다.
+ Amazon Keyspaces 오토 스케일링과 함께 프로비저닝된 용량 관리를 사용하는 경우 Amazon Keyspaces API 작업을 사용하여 다중 리전 테이블을 생성하고 구성해야 합니다. Amazon Keyspaces가 사용자를 대신하여 호출하는 기본 애플리케이션 오토 스케일링 API 작업에는 다중 리전 기능이 없습니다.
자세한 내용은 [Amazon Keyspaces에서 다중 리전 테이블에 대한 프로비저닝된 용량 및 오토 스케일링 설정 업데이트](tables-mrr-autoscaling.md) 단원을 참조하십시오. 프로비저닝된 다중 리전 테이블의 쓰기 용량 처리량을 추정하는 방법에 대한 자세한 내용은 [Amazon Keyspaces에서 다중 리전 테이블의 용량 추정 및 프로비저닝](tables-multi-region-capacity.md) 섹션을 참조하세요.
+ 다중 리전 테이블의 선택된 리전에 데이터가 자동으로 복제되지만 클라이언트가 한 리전의 엔드포인트에 연결하여 `system.peers` 테이블을 쿼리하면 쿼리는 로컬 정보만 반환합니다. 쿼리 결과는 클라이언트에게 단일 데이터 센터 클러스터처럼 나타납니다.
+ Amazon Keyspaces 다중 리전 복제는 비동기식이며 쓰기 `LOCAL_QUORUM` 일관성을 지원합니다. `LOCAL_QUORUM` 일관성을 유지하려면 클라이언트에 성공을 반환하기 전에 로컬 리전의 두 복제본에서 행에 대한 업데이트를 안정적으로 유지해야 합니다. 그러면 복제된 하나 또는 여러 리전에 대한 쓰기 전파가 비동기적으로 수행됩니다.
Amazon Keyspaces 다중 리전 복제는 동기식 복제 또는 `QUORUM` 일관성을 지원하지 않습니다.
+ 다중 리전 키스페이스 또는 테이블을 생성하면 생성 프로세스 중에 정의한 모든 태그가 모든 리전의 모든 키스페이스와 테이블에 자동으로 적용됩니다. `ALTER KEYSPACE` 또는 `ALTER TABLE`을 사용하여 기존 태그를 변경하면 변경하려는 리전의 키스페이스 또는 테이블에만 업데이트가 적용됩니다.
+ Amazon CloudWatch는 복제된 각 리전에 대한 `ReplicationLatency` 지표를 제공합니다. 이 메트릭은 도착하는 행을 추적하고 도착 시간을 최초 쓰기 시간과 비교하여 평균을 내 계산됩니다. 타이밍은 소스 리전의 CloudWatch 내에 저장됩니다. 자세한 내용은 [Amazon CloudWatch를 사용하여 Amazon Keyspaces 모니터링](monitoring-cloudwatch.md) 단원을 참조하십시오.
평균 및 최대 타이밍을 확인하여 평균 및 최악의 복제 지연을 파악하는 데 유용할 수 있습니다. 이 지연 시간에는 SLA가 없습니다.
+ 온디맨드 모드에서 다중 리전 테이블을 사용하는 경우 테이블 복제본에 새 트래픽 피크가 발생하는 경우 쓰기의 비동기 복제에 대한 지연 시간이 증가하는 것을 관찰할 수 있습니다. Amazon Keyspaces가 단일 리전 온디맨드 테이블의 용량을 수신하는 애플리케이션 트래픽에 자동으로 조정하는 방식과 마찬가지로 Amazon Keyspaces는 다중 리전 온디맨드 테이블 복제본의 용량을 수신하는 트래픽에 자동으로 조정합니다. Amazon Keyspaces는 트래픽 볼륨이 증가함에 따라 더 많은 용량을 자동으로 할당하므로 복제 지연 시간이 일시적으로 증가합니다. 모든 복제본이 트래픽 볼륨에 맞게 조정되면 복제 지연 시간이 정상으로 돌아와야 합니다. 자세한 내용은 [피크 트래픽 및 크기 조정 속성](ReadWriteCapacityMode.OnDemand.md#ReadWriteCapacityMode.PeakTraffic) 단원을 참조하십시오.
+ 프로비저닝된 모드에서 다중 리전 테이블을 사용할 때 애플리케이션이 프로비저닝된 처리량 용량을 초과하는 경우 용량 부족 오류와 복제 지연 시간 증가가 관찰될 수 있습니다. 모든 다중 리전 테이블 AWS 리전 의 모든 테이블 복제본에 대한 읽기 및 쓰기 용량이 항상 충분한지 확인하려면 Amazon Keyspaces Auto Scaling을 구성하는 것이 좋습니다. Amazon Keyspaces 오토 스케일링은 실제 애플리케이션 트래픽에 따라 처리량 용량을 자동으로 조정하여 가변 워크로드에 대한 처리량 용량을 효율적으로 프로비저닝할 수 있도록 지원합니다. 자세한 내용은 [다중 리전 테이블에 대한 오토 스케일링 작동 방식](autoscaling.md#autoscaling.multi-region) 단원을 참조하십시오.
# Amazon Keyspaces(Apache Cassandra용)에 대한 다중 리전 복제 구성
콘솔, 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 권한 구성
다중 리전 키스페이스 및 테이블을 성공적으로 생성하려면 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 권한 구성
키스페이스에 리전을 추가하려면 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에서 다중 리전 키스페이스 생성
이 섹션에서는 다중 리전 키스페이스를 만드는 방법에 대한 예제를 제공합니다. 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의 키스페이스에 추가
단일 또는 다중 리전 키스페이스인 키스페이스 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"}'
```
------
# 키스페이스에 새 리전을 추가할 때 복제 진행 상황 확인
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에서 기본 설정을 사용하여 다중 리전 테이블 생성
이 섹션에서는 모든 기본 설정을 사용하여 온디맨드 모드에서 다중 리전 테이블을 생성하는 방법의 예를 제공합니다. 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에서 오토 스케일링을 사용하는 프로비저닝된 모드에서 다중 리전 테이블 생성
이 섹션에서는 오토 스케일링을 사용하여 프로비저닝된 모드에서 다중 리전 테이블을 생성하는 방법의 예를 제공합니다. 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에서 다중 리전 테이블에 대한 프로비저닝된 용량 및 오토 스케일링 설정 업데이트
이 섹션에는 콘솔, 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에서 다중 리전 테이블에 대한 프로비저닝된 용량 및 오토 스케일링 설정 보기
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에서 테이블에 대한 오토 스케일링 끄기
이 섹션에서는 프로비저닝된 용량 모드에서 다중 리전 테이블의 오토 스케일링을 끄는 방법의 예를 제공합니다. 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에서 다중 리전 테이블의 프로비저닝된 용량을 수동으로 설정
다중 리전 테이블에 대한 오토 스케일링을 꺼야 하는 경우 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
```
------