Amazon DocumentDB 클러스터 수정 - Amazon DocumentDB

Amazon DocumentDB 클러스터 수정

클러스터를 수정하려면 클러스터가 사용 가능 상태에 있어야 합니다. 중지된 클러스터는 수정할 수 없습니다. 클러스터가 중지된 경우, 먼저 클러스터를 시작하고 클러스터가 사용 가능하게 될 때까지 기다린 다음 원하는 대로 수정합니다. 자세한 내용은 Amazon DocumentDB 클러스터 중지 및 시작 섹션을 참조하세요.

Using the AWS Management Console

다음 절차에 따라 콘솔을 사용하여 특정 Amazon DocumentDB 클러스터를 수정합니다.

Amazon DocumentDB 클러스터를 수정하려면
  1. AWS Management Console에 로그인한 후 https://console.aws.amazon.com/docdb에서 Amazon DocumentDB 콘솔을 엽니다.

  2. 탐색 창에서 클러스터를 선택합니다.

    작은 정보

    화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(Hamburger menu icon with three horizontal lines.)을 선택합니다.

  3. 클러스터 이름 왼쪽에 있는 버튼을 선택하여 수정할 클러스터를 지정합니다.

  4. 작업을 선택한 후 수정을 선택합니다.

  5. 클러스터 수정: <cluster-name> 창에서 원하는 항목을 변경합니다. 다음 영역에서 변경할 수 있습니다.

    • 클러스터 사양 - 클러스터의 이름, 보안 그룹 및 암호.

    • 클러스터 스토리지 구성 - 클러스터의 데이터 스토리지 모드입니다. 표준 구성과 I/O 최적화 구성 중에서 선택합니다.

    • 클러스터 옵션 - 클러스터의 포트 및 파라미터 그룹.

    • 백업 - 클러스터의 백업 보존 기간 및 백업 기간.

    • 로그 내보내기 - 감사 또는 프로파일러 로그 내보내기 활성화 또는 비활성화.

    • 유지 관리 - 클러스터의 유지 관리 기간 설정.

    • 삭제 방지 - 클러스터에서 삭제 방지 활성화 또는 비활성화. 삭제 방지 기능은 기본적으로 활성화됩니다.

  6. 작업을 마쳤으면 계속을 선택하여 변경 사항의 요약을 확인합니다.

  7. 변경 사항이 만족스러우면 클러스터 수정을 선택하여 클러스터를 수정할 수 있습니다. 또는 뒤로 또는 취소를 선택하여 각각 변경 사항을 편집하거나 취소할 수 있습니다.

변경 사항을 적용하는 데 몇 분 정도 걸립니다. 사용 가능 상태인 경우에만 클러스터를 사용할 수 있습니다. 콘솔 또는 AWS CLI를 사용하여 클러스터의 상태를 모니터링할 수 있습니다. 자세한 내용은 Amazon DocumentDB 클러스터 상태 모니터링 섹션을 참조하세요.

Using the AWS CLI

modify-db-cluster 작업에 따라 AWS CLI를 사용하여 지정된 클러스터를 수정합니다. 자세한 내용은 Amazon DocumentDB API 참조ModifyDBCluster 섹션을 참조하세요.

파라미터
  • --db-cluster-identifier - 필수입니다. 수정하려는 Amazon DocumentDB 클러스터의 식별자입니다.

  • --backup-retention-period - 선택 사항. 자동 백업이 보관되는 일수입니다. 유효한 값은 1–35입니다.

  • --storage-type - 선택 사항. 클러스터 스토리지 구성입니다. 유효한 값은 standard (표준) 또는 iopt1 (I/O 최적화)입니다.

  • --db-cluster-parameter-group-name - 선택 사항. 클러스터에 사용할 클러스터 파라미터 그룹의 이름입니다.

  • --master-user-password - 선택 사항. 기본 데이터베이스 사용자의 새 암호입니다.

    암호 제약:

    • 길이는 [8-100]자의 인쇄 가능한 ASCII 문자입니다.

    • 다음을 제외한 인쇄 가능한 ASCII 문자를 사용할 수 있습니다.

      • /(슬래시)

      • "(큰 따옴표)

      • @(at 기호)

  • --new-db-cluster-identifier - 선택 사항. 클러스터의 이름을 변경할 때 클러스터의 새 클러스터 식별자입니다. 이 값은 소문자 문자열로 저장됩니다.

    명명 제약 조건:

    • 길이는 [1~63] 글자, 숫자 또는 하이픈입니다.

    • 첫 번째 문자는 글자이어야 합니다.

    • 하이픈으로 끝나거나 하이픈이 2개 연속으로 이어져서는 안 됩니다.

    • AWS 계정, 리전별로 Amazon RDS, Amazon Neptune, Amazon DocumentDB의 모든 클러스터에 대해 고유해야 합니다.

  • --preferred-backup-window - 선택 사항. 자동 백업이 생성되는 일별 시간 범위를 UTC(협정 세계시)로 표시합니다.

    • 형식: hh24:mm-hh24:mm

  • --preferred-maintenance-window - 선택 사항. 시스템 유지 관리를 실행할 수 있는 주 단위 시간 범위(UTC)입니다.

    • 형식: ddd:hh24:mm-ddd:hh24:mm

    • 유효한 요일: Sun, Mon, Tue, Wed, Thu, Fri, Sat

  • --deletion-protection 또는 --no-deletion-protection - 선택 사항. 이 클러스터에서 삭제 방지를 활성화해야 하는지 여부. 삭제 방지는 삭제 방지를 비활성화하도록 클러스터를 수정할 때까지 실수로 클러스터가 삭제되는 것을 방지합니다. 자세한 내용은 Amazon DocumentDB 클러스터 삭제 섹션을 참조하세요.

  • --apply-immediately 또는 --no-apply-immediately - --apply-immediately를 사용하여 즉시 변경합니다. --no-apply-immediately를 사용하여 클러스터의 다음 유지 관리 기간에 변경합니다.

다음 코드는 클러스터 sample-cluster에 대한 백업 보존 기간을 변경합니다.

Linux, macOS, Unix의 경우:

aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --apply-immediately \ --backup-retention-period 7

Windows의 경우:

aws docdb modify-db-cluster ^ --db-cluster-identifier sample-cluster ^ --apply-immediately ^ --backup-retention-period 7

이 작업의 출력은 다음과 같이 표시됩니다.

{ "DBCluster": { "BackupRetentionPeriod": 7, "DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE", "Status": "available", "DBClusterMembers": [ { "PromotionTier": 1, "DBClusterParameterGroupStatus": "in-sync", "DBInstanceIdentifier": "sample-cluster-instance", "IsClusterWriter": true } ], "ReadReplicaIdentifiers": [], "AvailabilityZones": [ "us-east-1b", "us-east-1c", "us-east-1a" ], "ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "PreferredMaintenanceWindow": "sat:09:51-sat:10:21", "EarliestRestorableTime": "2018-06-17T00:06:19.374Z", "StorageEncrypted": false, "MultiAZ": false, "AssociatedRoles": [], "MasterUsername": "<your-master-user-name>", "DBClusterIdentifier": "sample-cluster", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "HostedZoneId": "Z2SUY0A1719RZT", "LatestRestorableTime": "2018-06-18T21:17:05.737Z", "AllocatedStorage": 1, "Port": 27017, "Engine": "docdb", "DBClusterParameterGroup": "default.docdb3.4", "Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com", "DBSubnetGroup": "default", "PreferredBackupWindow": "00:00-00:30", "EngineVersion": "3.4", "ClusterCreateTime": "2018-06-06T19:25:47.991Z", "IAMDatabaseAuthenticationEnabled": false } }

변경 사항을 적용하는 데 몇 분 정도 걸립니다. 사용 가능 상태인 경우에만 클러스터를 사용할 수 있습니다. 콘솔 또는 AWS CLI를 사용하여 클러스터의 상태를 모니터링할 수 있습니다. 자세한 내용은 Amazon DocumentDB 클러스터 상태 모니터링 섹션을 참조하세요.