클러스터의 규모 조정 용량 범위 구성 보기 및 수정 서버리스 리더의 승격 계층 보기 및 수정

Amazon DocumentDB Serverless 관리

클러스터의 규모 조정 용량 범위 구성 보기 및 수정

ServerlessV2ScalingConfiguration 인수는 DocumentDB Serverless 인스턴스의 규모 조정 용량 범위를 지정합니다. 클러스터의 모든 DocumentDB Serverless 인스턴스에 적용되는 최소 및 최대 DocumentDB 용량 단위(DCU) 값으로 구성됩니다.

MinCapacity - 클러스터 내에서 DocumentDB Serverless 인스턴스의 최소 규모 조정 용량입니다.
MaxCapacity - 클러스터 내에서 DocumentDB Serverless 인스턴스의 최대 규모 조정 용량입니다.

참고

다음 규모 조정 구성 수정 사항은 새 MinCapacity 및 MaxCapacity 값을 반영하기 위해 인스턴스를 다시 시작해야 합니다.

MaxCapacity 값에 대한 모든 변경
MinCapacity 값을 더 높은 값에서 1.0 이하로 변경
MinCapacity 값을 더 낮은 값에서 1.0보다 크게 변경

규모 조정 구성 및 적절한 규모 조정 용량 제한을 선택하는 방법에 대한 자세한 내용은 Amazon DocumentDB Serverless 규모 조정 구성 섹션을 참조하세요.

Using the AWS Management 콘솔

다음 AWS Management 콘솔 구성 예제에서는 DocumentDB 서버리스 클러스터의 조정 구성 설정을 보고 편집하는 방법을 보여줍니다.

AWS Management 콘솔에 로그인하고 Amazon DocumentDB 콘솔을 엽니다.
탐색 창에서 클러스터를 선택합니다.

작은 정보
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘()을 선택합니다.

클러스터 테이블이 표시됩니다.
클러스터 테이블에서 규모 조정 용량을 수정하려는 클러스터의 확인란을 선택합니다.
작업을 선택한 후 수정을 선택합니다.

클러스터 수정 대화 상자가 표시 됩니다.
서버리스 용량 설정 섹션을 찾은 다음 대화 상자의 용량 설명에 따라 규모 조정 구성(용량 범위)을 설정합니다.

규모 조정 및 용량 범위에 대한 자세한 내용은 Amazon DocumentDB Serverless 규모 조정 구성 섹션을 참조하세요.
Continue(계속)를 선택합니다.
수정 사항 예약에 대해 즉시 적용을 선택합니다.
클러스터 수정을 선택합니다.
수정이 완료되면 각 서버리스 인스턴스를 재부팅해야 합니다. 라이터 사용 불가를 최소화하려면 다음 일련의 작업을 수행합니다.
1. 각 서버리스 리더 인스턴스를 재부팅합니다.
  1. 리더 인스턴스를 선택하고 작업을 선택한 다음 재부팅을 선택합니다.
  2. 인스턴스 상태가 사용 가능으로 돌아갈 때까지 기다립니다.
2. 재부팅된 서버리스 인스턴스에 장애 조치를 수행합니다.
  1. 클러스터를 선택하고 작업을 선택한 다음 장애 조치를 선택합니다.
  2. 장애 조치 작업이 완료될 때까지 기다립니다.
3. 나머지 서버리스 인스턴스를 재부팅합니다.
  1. 나머지 인스턴스를 선택하고 작업을 선택한 다음 재부팅을 선택합니다.
  2. 인스턴스 상태가 사용 가능으로 돌아갈 때까지 기다립니다.

Using the AWS CLI

다음 AWS CLI 구성 예제는 현재 조정 구성을 보여줍니다.

다음은 각각의 사용자 입력 자리 표시자를 자신의 정보 또는 구성 파라미터로 변경하는 예제입니다.

다음 describe-db-clusters AWS CLI 명령을 사용하여 클러스터의 현재 조정 구성을 볼 수 있습니다.


aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[0].ServerlessV2ScalingConfiguration'

다음은 이 명령의 출력입니다.


{
    "MinCapacity": 0.5,
    "MaxCapacity": 16.0
}

다음과 같이 modify-db-cluster 명령을 사용하여 클러스터의 규모 조정 구성을 수정할 수 있습니다.


aws docdb modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=32

완료되면 각 서버리스 인스턴스를 재부팅해야 합니다. 라이터 사용 불가를 최소화하기 위해 다음 일련의 작업을 수행할 수 있습니다.


aws docdb reboot-db-instance \
    --db-instance-identifier sample-serverless-instance-reader

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-reader

aws docdb failover-db-cluster \
   --db-cluster-identifier sample-cluster \
   --target-db-instance-identifier sample-serverless-instance-reader

aws docdb reboot-db-instance \
    --db-instance-identifier sample-serverless-instance-writer

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-writer

aws docdb failover-db-cluster \
   --db-cluster-identifier sample-cluster \
   --target-db-instance-identifier sample-serverless-instance-writer

여러 개의 DocumentDB Serverless 인스턴스를 포함하는 클러스터 또는 프로비저닝된 인스턴스와 서버리스 인스턴스가 혼합된 클러스터의 경우 각 서버리스 인스턴스의 승격 티어 설정을 유의해야 합니다. 이 설정은 프로비저닝된 인스턴스보다 서버리스 인스턴스에 대해 더 많은 동작을 제어합니다.

프로비저닝된 인스턴스의 경우 티어 0~15를 선택하면 Amazon DocumentDB가 장애 조치 작업 중에 라이터로 승격할 리더 인스턴스를 선택하는 순서만 결정됩니다. 그러나 서버리스 인스턴스의 경우 티어 번호에 따라 인스턴스를 라이터 인스턴스의 용량에 맞춰 스케일 업할지 아니면 자체 워크로드를 기준으로 독립적으로 규모 조정을 할지도 결정됩니다. 티어 0 또는 1의 Serverless 리더 인스턴스는 최소한 라이터 인스턴스만큼 높은 최소 용량으로 유지됩니다. 따라서 장애 조치가 발생할 경우 라이터 인스턴스에서 인계할 준비가 됩니다. 라이터 인스턴스가 프로비저닝된 인스턴스인 경우 Amazon DocumentDB는 동등한 DocumentDB Serverless 용량을 추정합니다. 이 추정치를 서버리스 리더 인스턴스의 최소 용량으로 사용합니다.

티어 2~15의 DocumentDB Serverless 리더 인스턴스는 최소 용량에 대해 이러한 제약 조건을 가지고 있지 않습니다. 유휴 상태일 때 클러스터의 용량 범위에 지정된 최소 DocumentDB 용량 단위(DCU) 값으로 스케일 다운할 수 있습니다.

Using the AWS Management 콘솔

다음 AWS Management 콘솔 구성 예제에서는 DocumentDB 서버리스 인스턴스 리더의 프로모션 계층 설정을 보고 수정하는 방법을 보여줍니다.

AWS Management 콘솔에 로그인하고 Amazon DocumentDB 콘솔을 엽니다.

각 인스턴스의 승격 티어는 AWS Management 콘솔의 승격 티어 열에 표시됩니다.
탐색 창에서 클러스터를 선택합니다.

작은 정보
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘()을 선택합니다.

클러스터 테이블이 표시됩니다.
클러스터 테이블에서 승격 티어를 수정하려는 인스턴스의 확인란을 선택합니다.
작업을 선택한 후 수정을 선택합니다.

인스턴스 수정 대화 상자가 표시됩니다.
장애 조치 섹션을 찾아서 승격 티어를 원하는 수준으로 설정합니다.
Continue(계속)를 선택합니다.
수정 사항 예약에 대해 즉시 적용을 선택합니다.
Modify Instance(인스턴스 수정)를 선택합니다.

Using the AWS CLI

다음 AWS CLI 구성 예제는 현재 조정 구성을 보여줍니다.

다음은 각각의 사용자 입력 자리 표시자를 자신의 정보 또는 구성 파라미터로 변경하는 예제입니다.

다음 describe-db-clusters AWS CLI 명령을 사용하여 클러스터에 있는 모든 인스턴스의 승격 티어를 볼 수 있습니다.


aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[0].DBClusterMembers' \
    --output table

다음은 이 명령의 출력입니다.


--------------------------------------------------------------------------------------------------------
|                                          DescribeDBClusters                                          |
+--------------------------------+---------------------------------+------------------+----------------+
|  DBClusterParameterGroupStatus |      DBInstanceIdentifier       | IsClusterWriter  | PromotionTier  |
+--------------------------------+---------------------------------+------------------+----------------+
|  in-sync                       |  sample-serverless-instance-2   |  False           |  1             |
|  in-sync                       |  sample-serverless-instance-1   |  True            |  1             |
+--------------------------------+---------------------------------+------------------+----------------+

특정 인스턴스의 승격 티어는 다음과 같이 modify-db-instance 명령을 사용하여 수정할 수 있습니다.


aws docdb modify-db-instance \
    --db-instance-identifier sample-serverless-instance-2 \
    --promotion-tier 3

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

서버리스로 마이그레이션

서버리스 인스턴스 제한

Amazon DocumentDB Serverless 관리

클러스터의 규모 조정 용량 범위 구성 보기 및 수정

참고

작은 정보

서버리스 리더의 승격 계층 보기 및 수정

작은 정보