빠른 시작 설명서: 글로벌 클러스터

Amazon DocumentDB 리전 클러스터를 생성하려면 create-global-cluster AWS CLI를 호출하세요. 다음 AWS CLI 명령은 global-cluster-id이라는 이름의 Amazon DocumentDB 클러스터를 생성합니다. 삭제 방지에 대한 자세한 내용은 Amazon DocumentDB 클러스터 삭제을(를) 참조하십시오.

또한 --engine-version은 기본적으로 최신 주요 엔진 버전으로 설정되는 선택적 파라미터입니다. 현재 메이저 엔진 버전은 5.0.0입니다. 새 주요 엔진 버전이 출시되면 최신 주요 엔진 버전을 반영하도록 --engine-version의 주요 엔진 버전이 업데이트됩니다. 따라서 프로덕션 워크로드, 특히 스크립팅, 자동화 또는 CloudFormation 템플릿에 의존하는 워크로드의 경우 --engine-version을 의도한 메이저 버전으로 명시적으로 지정하는 것이 좋습니다.

db-subnet-group-name 또는 vpc-security-group-id이(가) 지정되지 않은 경우 Amazon DocumentDB는 해당 리전에 대해 기본 서브넷 그룹과 Amazon VPC 보안 그룹을 사용합니다.

다음 예제에서는 자신의 정보로 각각의 사용자 입력 자리 표시자를 바꿉니다.

Linux, macOS 또는 Unix의 경우:

aws docdb create-db-cluster \
      --global-cluster-identifier global-cluster-id \
      --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
         

Windows의 경우:

aws docdb create-db-cluster ^
      --global-cluster-identifier global-cluster-id ^
      --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
         

이 작업의 출력은 다음과 같습니다(JSON 형식).

{
    "DBCluster": {
        "StorageEncrypted": false,
        "DBClusterMembers": [],
        "Engine": "docdb",
        "DeletionProtection" : "enabled",
        "ClusterCreateTime": "2018-11-26T17:15:19.885Z",
        "DBSubnetGroup": "default",
        "EngineVersion": "4.0.0",
        "MasterUsername": "masteruser",
        "BackupRetentionPeriod": 1,
        "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id",
        "DBClusterIdentifier": "cluster-id",
        "MultiAZ": false,
        "DBClusterParameterGroup": "default.docdb4.0",
        "PreferredBackupWindow": "09:12-09:42",
        "DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
        "PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
        "Port": 27017,
        "Status": "creating",
        "ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
        "AssociatedRoles": [],
        "HostedZoneId": "ZNKXTT8WH85VW",
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-77186e0d",
                "Status": "active"
            }
        ],
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1c",
            "us-east-1e"
        ],
        "Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
    }
}
      

다음 예제에서는 새 Amazon DocumentDB 클러스터를 생성하여 글로벌 클러스터에 읽기 전용 보조 클러스터로 연결합니다. 마지막 단계에서 인스턴스가 새 클러스터에 추가됩니다.

다음 예제에서는 자신의 정보로 각각의 사용자 입력 자리 표시자를 바꿉니다.

Linux, macOS 또는 Unix의 경우:

aws docdb --region secondary-region-id \
  create-db-cluster \
    --db-cluster-identifier cluster-id \
    --global-cluster-identifier global-cluster-id \
    --engine-version version \
    --engine docdb

aws docdb --region secondary-region-id \
  create-db-instance \
    --db-cluster-identifier cluster-id \
    --global-cluster-identifier global-cluster-id \
    --engine-version version \
    --engine docdb
      

Windows의 경우:

aws docdb --region secondary-region-id ^
  create-db-cluster ^
    --db-cluster-identifier cluster-id ^
    --global-cluster-identifier global-cluster-id ^
    --engine-version version ^
    --engine docdb

aws docdb --region secondary-region-id ^
  create-db-instance ^
    --db-cluster-identifier cluster-id ^
    --global-cluster-identifier global-cluster-id ^
    --engine-version version ^
    --engine docdb