기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon DocumentDB 인스턴스 관리
다음 항목에서는 Amazon DocumentDB 인스턴스를 관리하는 데 도움이 되는 정보를 제공합니다. 인스턴스 클래스 및 상태, 인스턴스를 생성, 삭제, 수정하는 방법에 대한 세부 정보가 포함됩니다.
**Topics**
+ [인스턴스 상태 확인](#db-instance-status)
+ [인스턴스 수명 주기](db-instance-life-cycle.md)
+ [인스턴스 클래스 관리](db-instance-classes.md)
+ [NVMe 지원 인스턴스](db-instance-nvme.md)
## 인스턴스 상태 확인
유효한 인스턴스 상태, 해당 의미, 인스턴스 상태 확인 방법을 알아보려면 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 섹션을 참조하세요.
# Amazon DocumentDB 인스턴스 수명 주기
Amazon DocumentDB 인스턴스의 수명 주기에는 인스턴스 생성, 수정, 유지 및 업그레이드, 백업 및 복원 수행, 재부팅 및 삭제가 포함됩니다. 이 섹션에서는 이러한 프로세스를 완료하는 방법에 관해 설명합니다.
**Topics**
+ [인스턴스 추가](db-instance-add.md)
+ [인스턴스 설명](db-instance-view-details.md)
+ [인스턴스 수정](db-instance-modify.md)
+ [인스턴스 재부팅](db-instance-reboot.md)
+ [인스턴스 삭제](db-instance-delete.md)
AWS Management Console 또는를 사용하여 새 Amazon DocumentDB 인스턴스를 생성할 수 있습니다 AWS CLI. 인스턴스를 클러스터에 추가하려면 클러스터가 *사용 가능* 상태에 있어야 합니다. 중지된 클러스터에는 인스턴스를 추가할 수 없습니다. 클러스터가 중지된 경우, 먼저 클러스터를 시작하고 클러스터가 *사용 가능*하게 될 때까지 기다린 다음 인스턴스를 추가합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 중지 및 시작](db-cluster-stop-start.md) 섹션을 참조하십시오.
**참고**
콘솔을 사용하여 Amazon DocumentDB 클러스터를 작성하면 인스턴스가 동시에 자동으로 생성됩니다. 추가 인스턴스를 생성하려면 다음 절차 중 하나를 사용하세요.
# 클러스터에 Amazon DocumentDB 인스턴스 추가
------
#### [ Using the AWS Management Console ]
다음 절차에 따라 콘솔을 사용하여 클러스터에 대한 Amazon DocumentDB 인스턴스를 생성할 수 있습니다.
1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
**작은 정보**
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다.
1. 인스턴스를 추가할 클러스터를 선택하려면 클러스터의 이름 왼쪽에 있는 버튼을 선택합니다.
1. **작업**을 선택한 다음 **인스턴스 추가**를 선택합니다.
1. **다음 항목에 인스턴스 추가: ** 페이지에서 클러스터에 추가하려는 각 인스턴스에 대해 다음 단계를 반복 실행합니다. 최대 15개까지 가능합니다.
1. **인스턴스 식별자** - 이 인스턴스의 고유 식별자를 입력하거나 Amazon DocumentDB가 클러스터 식별자를 기반으로 인스턴스 식별자를 제공하도록 허용할 수 있습니다.
인스턴스 명명 제약 조건:
+ 길이는 [1-63] 문자, 숫자 또는 하이픈입니다.
+ 첫 번째 문자는 글자이어야 합니다.
+ 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다.
+ 리전별로 Amazon RDS, Neptune 및 Amazon DocumentDB의 모든 인스턴스 AWS 계정에 대해 고유해야 합니다.
1. **인스턴스 클래스** - 드롭다운 목록에서 이 인스턴스에 대해 원하는 인스턴스 유형을 선택합니다.
1. **승격 계층** - 드롭다운 목록에서 인스턴스의 승격 계층을 선택하거나 *선호 없음*을 선택하여 Amazon DocumentDB가 인스턴스의 승격 계층을 설정할 수 있도록 합니다. 번호가 낮을수록 우선 순위가 높습니다. 자세한 내용은 [장애 조치 대상 제어](failover.md#failover-target_control) 섹션을 참조하십시오.
1. 더 많은 인스턴스를 추가하려면 **추가 인스턴스 추가**를 선택하고 a, b, c 단계를 반복합니다.
1. 작업을 완료합니다.
+ 클러스터에 인스턴스를 추가하려면 **생성**을 선택합니다.
+ 작업을 취소하려면 **취소**를 선택합니다.
인스턴스를 생성하는 데 몇 분 정도 걸립니다. 콘솔 또는 AWS CLI 를 사용하여 인스턴스의 상태를 볼 수 있습니다. 자세한 내용은 [인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------
#### [ Using the AWS CLI ]
다음 파라미터와 함께 `create-db-instance` AWS CLI 작업을 사용하여 클러스터의 기본 인스턴스를 생성합니다.
+ **--db-instance-class** - 필수입니다. 인스턴스의 컴퓨팅 및 메모리 용량(예: `db.m4.large`)입니다. 모든 AWS 리전에서 모든 인스턴스 클래스를 사용할 수 있는 것은 아닙니다.
+ **--db-instance-identifier** - 필수입니다. 인스턴스를 식별하는 문자열입니다.
인스턴스 명명 제약:
+ 길이는 [1-63] 문자, 숫자 또는 하이픈입니다.
+ 첫 번째 문자는 글자이어야 합니다.
+ 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다.
+ 리전별로 Amazon RDS, Neptune 및 Amazon DocumentDB의 모든 인스턴스 AWS 계정에 대해 고유해야 합니다.
+ **--engine** — 필수입니다. `docdb`여야 합니다.
+ **--availability-zone** - 선택 사항. 이 인스턴스를 생성할 가용 영역입니다. 다른 가용 영역에서 인스턴스를 찾아서 내결함성을 높이려면 이 파라미터를 사용합니다. 자세한 내용은 [Amazon DocumentDB 고가용성 및 복제](replication.md) 섹션을 참조하십시오.
+ **--promotion-tier** - 선택 사항. 이 인스턴스의 장애 조치 우선 순위 계층입니다. 0\$115 사이여야 하며, 숫자가 작을수록 우선 순위가 높습니다. 자세한 내용은 [장애 조치 대상 제어](failover.md#failover-target_control) 섹션을 참조하십시오.
1. **먼저 인스턴스를 생성할 수 있는 가용 영역을 결정합니다.**
인스턴스를 생성하기 전에 사용 가능 영역을 지정하려면 다음 명령을 실행하여 Amazon DocumentDB 클러스터에 사용할 수 있는 가능 영역을 결정합니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
Windows의 경우:
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
[
[
"sample-cluster",
[
"us-east-1c",
"us-east-1b",
"us-east-1a"
]
]
]
```
1. **둘째, 리전에서 생성할 수 있는 인스턴스 클래스를 확인합니다.**
리전에서 사용 가능한 인스턴스 클래스를 확인하려면 다음 명령을 실행합니다. 출력에서 Amazon DocumentDB 클러스터에 추가할 인스턴스의 인스턴스 클래스를 선택합니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-orderable-db-instance-options \
--engine docdb \
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
Windows의 경우:
```
aws docdb describe-orderable-db-instance-options ^
--engine docdb ^
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
[
"db.r5.16xlarge",
"db.r5.2xlarge",
"db.r5.4xlarge",
"db.r5.8xlarge",
"db.r5.large",
"db.r5.xlarge"
]
```
1. **마지막으로, Amazon DocumentDB 클러스터에 인스턴스를 추가합니다.**
인스턴스를 Amazon DocumentDB 클러스터에 추가하려면 다음 명령을 실행합니다..
Linux, macOS, Unix의 경우:
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-instance-2 \
--availability-zone us-east-1b \
--promotion-tier 2 \
--db-instance-class db.r5.xlarge \
--engine docdb
```
Windows의 경우:
```
aws docdb create-db-instance ^
--db-cluster-identifier sample-cluster ^
--db-instance-identifier sample-instance-2 ^
--availability-zone us-east-1b ^
--promotion-tier 2 ^
--db-instance-class db.r5.xlarge ^
--engine docdb
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.xlarge",
"Engine": "docdb",
"DBInstanceStatus": "creating",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1b",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2"
}
}
```
인스턴스를 생성하는 데 몇 분 정도 걸립니다. 콘솔 또는 AWS CLI 를 사용하여 인스턴스의 상태를 볼 수 있습니다. 자세한 내용은 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------
# Amazon DocumentDB 인스턴스 설명
Amazon DocumentDB Management Console 또는 AWS CLI 을 사용하여 연결 엔드포인트, 보안 그룹 VPC, 인증 기관 및 Amazon DocumentDB 인스턴스와 관련된 매개 변수 그룹과 같은 세부 정보를 볼 수 있습니다.
------
#### [ Using the AWS Management Console ]
AWS Management Console를 사용하여 인스턴스의 세부 정보를 보려면 아래 단계를 따르세요.
1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
**작은 정보**
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다.
1. 클러스터 탐색 상자에 **클러스터 식별자** 열이 표시됩니다. 인스턴스는 아래 스크린샷과 마찬가지로 클러스터 아래에 나열됩니다.
![\[클러스터 식별자 열 아래에 인스턴스가 클러스터 내에 중첩된 클러스터 목록을 보여주는 클러스터 테이블입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/choose-clusters.png)
1. 인스턴스 목록에서 세부 정보를 볼 인스턴스의 이름을 선택합니다. 인스턴스에 대한 정보는 다음과 같은 그룹으로 구성됩니다.
+ **요약** - 엔진 버전, 클래스, 상태 및 보류 중인 유지 보수를 포함한 인스턴스에 대한 일반 정보입니다.
+ **연결 및 보안** - **연결** 섹션에는 mongo 쉘 또는 애플리케이션을 사용하여 이 인스턴스에 연결할 연결 엔드포인트가 나열됩니다. **보안 그룹** 섹션에는 이 인스턴스와 연결된 보안 그룹과 해당 VPC ID 및 설명이 나열됩니다.
+ **구성** - **세부 정보** 섹션에는 인스턴스의 Amazon 리소스 이름(ARN), 엔드포인트, 역할, 클래스 및 인증 기관을 포함하여 인스턴스의 구성 및 상태가 나열됩니다. 또한 인스턴스의 보안 및 네트워크 설정과 백업 정보가 나열됩니다. **클러스터 세부 정보** 섹션에는 이 인스턴스가 속한 클러스터의 세부 정보가 나열됩니다. **클러스터 인스턴스** 섹션에는 클러스터에 속한 모든 인스턴스가 각 인스턴스의 역할 및 클러스터 파라미터 그룹 상태와 함께 나열됩니다.
**참고**
**클러스터 디테일** 헤더 옆에 있는 **수정**을 선택하여 인스턴스와 연결된 클러스터를 수정할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 클러스터 수정](db-cluster-modify.md) 섹션을 참조하십시오.
+ **모니터링** - 이 인스턴스에 대한 CloudWatch Logs 지표. 자세한 내용은 [CloudWatch를 사용하여 Amazon DocumentDB 모니터링](cloud_watch.md) 섹션을 참조하십시오.
+ **이벤트 및 태그** — **최근 이벤트** 섹션에는 이 인스턴스의 최근 이벤트가 나열됩니다. Amazon DocumentDB는 클러스터, 인스턴스, 스냅샷, 보안 그룹 및 클러스터 매개 변수 그룹과 관련된 이벤트를 기록합니다. 이 정보에는 각 이벤트와 연결된 날짜, 시간 및 메시지가 포함됩니다. **태그** 섹션에는 이 클러스터에 연결된 태그가 나열됩니다. 자세한 내용은 [Amazon DocumentDB 리소스 태그 지정](tagging.md) 단원을 참조하십시오.
------
#### [ Using the AWS CLI ]
를 사용하여 Amazon DocumentDB 인스턴스의 세부 정보를 보려면 아래 예제와 같이 `describe-db-clusters` 명령을 AWS CLI사용합니다. 자세한 내용은 *Amazon DocumentDB 리소스 관리 API 참조*에서 [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html) 섹션을 참조하세요.
**참고**
클러스터 및 인스턴스 수명주기 관리와 같은 특정 관리 기능의 경우 Amazon DocumentDB는 Amazon RDS와 공유하는 운영 기술을 활용합니다. `filterName=engine,Values=docdb` 필터 파라미터는 Amazon DocumentDB 클러스터만 반환합니다.
1. **모든 Amazon DocumentDB 인스턴스를 나열합니다.**
다음 AWS CLI 코드는 리전의 모든 Amazon DocumentDB 인스턴스에 대한 세부 정보를 나열합니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
Windows의 경우:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
1. **지정된 Amazon DocumentDB 인스턴스에 대한 모든 세부 정보 나열**
다음 코드는 `sample-cluster-instance`의 세부 정보를 나열합니다. 인스턴스 이름과 함께 `--db-instance-identifier` 파라미터를 포함하면 해당 특정 인스턴스에 대한 정보로 출력이 제한됩니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
Windows의 경우:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
이 작업의 출력은 다음과 같습니다.
```
{
"DBInstances": [
{
"DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
"DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"DBInstanceClass": "db.r5.large",
"DBInstanceStatus": "creating",
"AutoMinorVersionUpgrade": true,
"PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
"BackupRetentionPeriod": 1,
"StorageEncrypted": true,
"DBClusterIdentifier": "sample-cluster",
"EngineVersion": "3.6.0",
"AvailabilityZone": "us-east-1a",
"Engine": "docdb",
"PromotionTier": 2,
"DBInstanceIdentifier": "sample-cluster-instance",
"PreferredBackupWindow": "00:00-00:30",
"PubliclyAccessible": false,
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"Subnets": [
{
"SubnetIdentifier": "subnet-4e26d263",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-afc329f4",
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-53ab3636",
"SubnetAvailabilityZone": {
"Name": "us-east-1d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-991cb8d0",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-29ab1025",
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupDescription": "default",
"SubnetGroupStatus": "Complete"
},
"PendingModifiedValues": {},
"KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
}
]
}
```
------
# Amazon DocumentDB 인스턴스 수정
AWS Management Console 또는를 사용하여 Amazon DocumentDB 인스턴스를 수정할 수 있습니다 AWS CLI. 인스턴스를 수정하려면 인스턴스가 *사용 가능* 상태에 있어야 합니다. 중지된 인스턴스는 수정할 수 없습니다. 클러스터가 중지된 경우, 먼저 클러스터를 시작하고 인스턴스가 *사용 가능*하게 될 때까지 기다린 다음 원하는 대로 수정합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 중지 및 시작](db-cluster-stop-start.md) 섹션을 참조하십시오.
------
#### [ Using the AWS Management Console ]
콘솔을 사용하여 특정 Amazon DocumentDB 인스턴스를 수정하려면 다음 단계를 완료합니다.
1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
**작은 정보**
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다.
1. 클러스터 탐색 상자에 **클러스터 식별자** 열이 표시됩니다. 인스턴스는 아래 스크린샷과 마찬가지로 클러스터 아래에 나열됩니다.
![\[클러스터 식별자 열 아래에 인스턴스가 클러스터 내에 중첩된 클러스터 목록을 보여주는 클러스터 테이블입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/choose-clusters.png)
1. 수정할 인스턴스의 왼쪽에 있는 상자를 선택합니다.
1. **작업**을 선택한 후 **수정**을 선택합니다.
1. **인스턴스 수정: ** 창에서 원하는 항목을 변경합니다. 다음과 같이 변경할 수 있습니다:
+ **인스턴스 규격** - 인스턴스 식별자 및 클래스. 인스턴스 식별자 명명 제약 조건:
+ **인스턴스 식별자** - 현재 리전 AWS 계정 에서가 소유한 모든 인스턴스에 대해 고유한 이름을 입력합니다. 인스턴스 식별자는 [1-63]개의 영숫자 또는 하이픈을 포함해야 하며 첫 번째 문자로 문자가 있어야 하며 하이픈으로 끝나거나 연속적으로 두 개의 하이픈을 포함할 수 없습니다.
+ **인스턴스 클래스** — 드롭다운 메뉴에서 Amazon DocumentDB 인스턴스의 인스턴스 클래스를 선택합니다. 자세한 내용은 [인스턴스 클래스 관리](db-instance-classes.md) 섹션을 참조하십시오.
+ **인증서 권한** - 인스턴스의 서버 인증서입니다. 자세한 내용은 [Amazon DocumentDB TLS 인증서 업데이트](ca_cert_rotation.md) 섹션을 참조하십시오.
+ **장애 조치** - 장애 조치 중에 가장 높은 승격 계층을 가진 인스턴스가 기본으로 승격됩니다. 자세한 내용은 [Amazon DocumentDB 장애 조치](failover.md) 섹션을 참조하십시오.
+ **관리** - 보류 중인 수정 또는 패치가 클러스터의 인스턴스에 적용되는 유지 관리 창입니다.
1. 작업을 마쳤으면 **계속**을 선택하여 변경 사항의 요약을 확인합니다.
1. 변경 사항을 확인한 후 즉시 적용하거나 **수정 일정** 아래의 다음 유지 관리 기간 중에 적용할 수 있습니다. **인스턴스 수정**를 선택하여 변경 사항을 저장합니다. 또는 **취소**를 선택하여 변경 사항을 취소할 수 있습니다.
변경 사항을 적용하는 데 몇 분 정도 걸립니다. *사용 가능* 상태인 경우에만 인스턴스를 사용할 수 있습니다. 콘솔 또는 AWS CLI를 사용하여 인스턴스의 상태를 모니터링할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------
#### [ Using the AWS CLI ]
를 사용하여 특정 Amazon DocumentDB 인스턴스를 수정하려면 다음 파라미터`modify-db-instance`와 함께를 AWS CLI사용합니다. 자세한 내용은 [ModifyDBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html)을 참조하세요. 다음 코드는 `sample-instance` 인스턴스에 대한 인스턴스 클래스를 `db.r5.large`로 수정합니다.
**파라미터**
+ **--db-instance-identifier** - 필수입니다. 수정할 인스턴스의 식별자입니다.
+ **--db-instance-class** - 선택 사항. 인스턴스의 새 컴퓨팅 및 메모리 용량입니다(예: `db.r5.large`). 모든 AWS 리전에서 모든 인스턴스 클래스를 사용할 수 있는 것은 아닙니다. 인스턴스 클래스를 수정하면 변경 중에 중단이 발생합니다. 이 요청에 대해 `ApplyImmediately`이 true로 지정되지 않은 경우 다음 유지 관리 기간 동안 변경 사항이 적용됩니다.
+ **--apply-immediately** 또는 **--no-apply-immediately** - 선택 사항. 이 수정을 즉시 적용할지 다음 유지 관리 기간까지 대기할지 여부를 지정합니다. 이 파라미터를 생략하면 다음 유지 관리 기간 중에 수정이 수행됩니다.
**Example**
Linux, macOS, Unix의 경우:
```
aws docdb modify-db-instance \
--db-instance-identifier sample-instance \
--db-instance-class db.r5.large \
--apply-immediately
```
Windows의 경우:
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-instance ^
--db-instance-class db.r5.large ^
--apply-immediately
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
{
"DBInstances": [
{
"DBInstanceIdentifier": "sample-instance-1",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "modifying",
"Endpoint": {
"Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-01-10T22:18:55.921Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1a",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:10:57-sun:11:27",
"PendingModifiedValues": {
"DBInstanceClass": "db.r5.large"
},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
]
}
```
수정 사항을 적용하는 데 몇 분 정도 걸립니다. *사용 가능* 상태인 경우에만 인스턴스를 사용할 수 있습니다. AWS Management Console 또는를 사용하여 인스턴스의 상태를 모니터링할 수 있습니다 AWS CLI. 자세한 내용은 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------
# Amazon DocumentDB 인스턴스 재부팅
보통 유지보수의 이유로 Amazon DocumentDB 인스턴스를 재부팅해야 하는 경우가 있습니다. 특정 항목을 변경한 경우(예: 클러스터와 연결된 클러스터 파라미터 그룹 변경) 클러스터의 인스턴스를 재부팅해야 변경 내용이 적용됩니다. AWS Management Console 또는를 사용하여 지정된 인스턴스를 재부팅할 수 있습니다 AWS CLI.
인스턴스를 재부팅하면 데이터베이스 엔진 서비스가 재시작됩니다. 재부팅하면 DB 인스턴스 상태가 `rebooting`으로 설정되면서 잠시 중단됩니다. 재부팅이 완료되면 Amazon DocumentDB 이벤트가 생성됩니다.
인스턴스를 재부팅해도 장애 조치가 발생하지 않습니다. Amazon DocumentDB 클러스터를 장애 조치하려면 AWS Management Console 또는 AWS CLI 작업을 사용합니다`failover-db-cluster`. 자세한 내용은 [Amazon DocumentDB 장애 조치](failover.md) 단원을 참조하십시오.
*사용 가능* 상태가 아닌 경우 인스턴스를 재부팅할 수 없습니다. 이전에 수정을 요청했거나 유지 관리 기간 작업 등 여러 가지 이유로 데이터베이스를 사용할 수 없는 경우가 있습니다. 인스턴스 상태에 대한 자세한 내용은 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 섹션을 참조하세요.
------
#### [ Using the AWS Management Console ]
다음 절차는 콘솔을 사용하여 지정한 인스턴스를 재부팅합니다.
1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
**작은 정보**
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다.
1. 클러스터 탐색 상자에 **클러스터 식별자** 열이 표시됩니다. 인스턴스는 아래 스크린샷과 마찬가지로 클러스터 아래에 나열됩니다.
![\[클러스터 식별자 열 아래에 인스턴스가 클러스터 내에 중첩된 클러스터 목록을 보여주는 클러스터 테이블입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/choose-clusters.png)
1. 재부팅할 인스턴스의 왼쪽에 있는 확인란을 선택합니다.
1. **작업**을 선택하고 **재부팅**을 선택한 다음 **재부팅**을 선택하여 재부팅을 확인합니다.
인스턴스가 재부팅되는 데 몇 분 정도 걸릴 수 있습니다. *사용 가능* 상태인 경우에만 인스턴스를 사용할 수 있습니다. 콘솔 또는 AWS CLI를 사용하여 인스턴스의 상태를 모니터링할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------
#### [ Using the AWS CLI ]
Amazon DocumentDB 인스턴스를 재부팅하려면 `--db-instance-identifier` 파라미터와 함께 `reboot-db-instance` 작업을 사용합니다. 이 파라미터는 재부팅할 인스턴스의 식별자를 지정합니다.
다음 코드는 `sample-instance` 인스턴스를 재부팅합니다.
**Example**
Linux, macOS, Unix의 경우:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-instance
```
Windows의 경우:
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-instance
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "rebooting",
"Endpoint": {
"Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
인스턴스가 재부팅되는 데 몇 분 정도 걸릴 수 있습니다. *사용 가능* 상태인 경우에만 인스턴스를 사용할 수 있습니다. 콘솔 또는 AWS CLI를 사용하여 인스턴스의 상태를 모니터링할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------
# Amazon DocumentDB 인스턴스 삭제
AWS Management Console 또는를 사용하여 Amazon DocumentDB 인스턴스를 삭제할 수 있습니다 AWS CLI. 인스턴스를 삭제하려면 인스턴스가 *사용 가능* 상태에 있어야 합니다. 중지된 인스턴스는 삭제할 수 없습니다. 인스턴스가 포함된 Amazon DocumentDB 클러스터가 중지된 경우 먼저 클러스터를 시작하고 인스턴스가 *사용 가능*해질 때까지 기다렸다가 인스턴스를 삭제합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 중지 및 시작](db-cluster-stop-start.md) 섹션을 참조하십시오.
**참고**
Amazon DocumentDB에서는 모든 데이터를 클러스터 볼륨에 저장합니다. 모든 인스턴스를 클러스터에서 제거하는 경우에도 데이터가 클러스터 볼륨에 유지됩니다. 데이터에 다시 액세스해야 하는 경우 언제든지 클러스터에 인스턴스를 추가하고 중단한 지점을 선택할 수 있습니다.
------
#### [ Using the AWS Management Console ]
다음 절차에서는 콘솔을 사용하여 지정된 Amazon DocumentDB 인스턴스를 삭제합니다.
1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
**작은 정보**
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다.
1. 클러스터 탐색 상자에 **클러스터 식별자** 열이 표시됩니다. 인스턴스는 아래 스크린샷과 마찬가지로 클러스터 아래에 나열됩니다.
![\[클러스터 식별자 열 아래에 인스턴스가 클러스터 내에 중첩된 클러스터 목록을 보여주는 클러스터 테이블입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/choose-clusters.png)
1. 삭제할 인스턴스의 왼쪽에 있는 확인란을 선택합니다.
1. **작업**을 선택한 후 **삭제**를 선택합니다.
1. 클러스터의 마지막 인스턴스를 삭제하는 경우:
+ **최종 클러스터 스냅샷을 생성하시겠습니까?** — 클러스터를 삭제하기 전에 최종 스냅샷을 생성하려면 **예**를 선택합니다. 그렇지 않은 경우 **아니요**를 선택합니다.
+ **최종 스냅샷 이름** - 최종 스냅샷을 생성하도록 선택한 경우 생성된 새 클러스터 스냅샷의 클러스터 스냅샷 식별자를 입력합니다.
+ ** 인스턴스를 삭제하시겠습니까?** — 삭제 확인을 위해 **전체 클러스터 삭제**라는 문구를 필드에 입력합니다.
1. 클러스터의 마지막 인스턴스를 삭제하지 않는 경우:
+ ** 인스턴스를 삭제하시겠습니까?** — **삭제** 라는 문구를 필드에 입력하여 삭제를 확인합니다.
1. **삭제**를 선택하여 인스턴스를 삭제합니다.
인스턴스를 삭제하는 데 몇 분 정도 걸립니다. 인스턴스 상태를 모니터링하려면 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 섹션을 참조하십시오.
------
#### [ Using the AWS CLI ]
다음 절차는 AWS CLI을 사용하여 Amazon DocumentDB 인스턴스를 삭제합니다.
1. **먼저 Amazon DocumentDB 클러스터에 몇 개의 인스턴스가 있는지 확인합니다:**
클러스터에 있는 인스턴스 수를 확인하려면 다음과 같이 `describe-db-clusters` 명령을 실행합니다.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
1. **Amazon DocumentDB 클러스터에 인스턴스가 두 개 이상 있는 경우:**
지정된 Amazon DocumentDB 인스턴스를 삭제하려면 아래와 같이 `delete-db-instance` 명령을 `--db-instance-identifier` 파라미터와 함께 사용합니다. 인스턴스를 삭제하는 데 몇 분 정도 걸립니다. 인스턴스 상태를 모니터링하려면 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 섹션을 참조하십시오.
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance-2
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "deleting",
"Endpoint": {
"Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
1. **삭제할 인스턴스가 Amazon DocumentDB 클러스터의 마지막 인스턴스인 경우:**
Amazon DocumentDB 클러스터의 마지막 인스턴스를 삭제하는 경우 해당 클러스터와 해당 클러스터에 연결된 자동 스냅샷 및 연속 백업도 삭제합니다.
클러스터의 마지막 인스턴스를 삭제하려면 클러스터를 삭제하고 선택적으로 최종 스냅샷을 생성할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 클러스터 삭제](db-cluster-delete.md) 섹션을 참조하십시오.
------
## 삭제 방지
또한 Amazon DocumentDB 클러스터의 마지막 인스턴스를 삭제하면 해당 클러스터와 관련된 자동 스냅샷 및 연속 백업뿐만 아니라 클러스터도 삭제됩니다. Amazon DocumentDB는 AWS Management Console 또는를 사용하여 삭제 작업을 수행하든 관계없이 클러스터에 대한 삭제 보호를 적용합니다 AWS CLI. 삭제 방지가 활성화되어 있으면 클러스터를 삭제할 수 없습니다.
삭제 방지가 활성화된 클러스터를 삭제하려면 먼저 클러스터를 수정하고 삭제 방지를 비활성화해야 합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 삭제](db-cluster-delete.md) 섹션을 참조하십시오.
# 인스턴스 클래스 관리
인스턴스 클래스는 Amazon DocumentDB(MongoDB 호환) 인스턴스의 컴퓨팅 및 메모리 용량을 결정합니다. 필요한 인스턴스 클래스는 DB 인스턴스의 처리력 및 메모리 요구 사항에 따라 다릅니다.
Amazon DocumentDB는 R4, R5, R6G, R8G, T3 및 T4G 인스턴스 클래스 제품군을 지원합니다. 이들 클래스는 메모리 집약적 애플리케이션에 최적화된 최신 세대 인스턴스 클래스입니다. 이들 클래스의 사양은 [인스턴스 클래스 사양](#db-instance-class-specs) 섹션을 참조하세요.
**Topics**
+ [인스턴스 클래스 결정](#db-instance-class-determining)
+ [인스턴스의 클래스 변경](#db-instance-class-changing)
+ [리전별 지원되는 인스턴스 클래스](#db-instance-classes-by-region)
+ [인스턴스 클래스 사양](#db-instance-class-specs)
## 인스턴스 클래스 결정
인스턴스의 클래스를 확인하려면 AWS Management Console 또는 `describe-db-instances` AWS CLI 작업을 사용할 수 있습니다.
------
#### [ Using the AWS Management Console ]
클러스터 인스턴스의 인스턴스 클래스를 결정하려면 콘솔에서 다음 단계를 완료하세요.
1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택하여 관심 있는 인스턴스를 찾습니다.
**작은 정보**
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다.
1. 클러스터 탐색 상자에 **클러스터 식별자** 열이 표시됩니다. 인스턴스는 아래 스크린샷과 마찬가지로 클러스터 아래에 나열됩니다.
![\[인스턴스가 클러스터 아래에 중첩되는 방법을 보여주는 클러스터 테이블입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/choose-clusters.png)
1. 인스턴스 목록에서 클러스터를 확장하여 원하는 인스턴스를 찾으세요. 원하는 인스턴스를 찾습니다. 그런 다음 인스턴스 행의 **크기** 열을 확인하여 인스턴스 클래스를 확인합니다.
다음 이미지에서는 인스턴스 `robo3t`의 인스턴스 클래스가 `db.r5.4xlarge`입니다.
![\[인스턴스 유형을 보여주는 크기 열이 있는 클러스터 테이블의 인스턴스 목록입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/instance-class.png)
------
#### [ Using the AWS CLI ]
를 사용하여 인스턴스의 클래스를 확인하려면 다음 파라미터와 함께 `describe-db-instances` 작업을 AWS CLI사용합니다.
+ **--db-instance-identifier** - 선택 사항입니다. 인스턴스 클래스를 찾을 인스턴스를 지정합니다. 이 매개 변수를 생략한 경우 `describe-db-instances`는 최대 100개의 인스턴스에 대한 설명을 반환합니다.
+ **--query** – 선택 사항. 결과에 포함할 인스턴스 멤버를 지정합니다. 이 매개 변수를 생략하면 모든 인스턴스 멤버가 반환됩니다.
**Example**
다음 예에서는 모든 인스턴스에 대한 인스턴스 `sample-instance-1` 이름과 클래스를 찾습니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--db-instance-identifier sample-instance-1
```
Windows의 경우:
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--db-instance-identifier sample-instance-1
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
[
[
"sample-instance-1",
"db.r5.large"
]
```
**Example**
다음 예에서는 최대 100개의 Amazon DocumentDB 인스턴스에 대한 인스턴스 이름과 클래스를 찾습니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--filter Name=engine,Values=docdb
```
Windows의 경우:
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--filter Name=engine,Values=docdb
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
[
[
"sample-instance-1",
"db.r5.large"
],
[
"sample-instance-2",
"db.r5.large"
],
[
"sample-instance-3",
"db.r5.4xlarge"
],
[
"sample-instance-4",
"db.r5.4xlarge"
]
]
```
자세한 내용은 [Amazon DocumentDB 인스턴스 설명](db-instance-view-details.md) 단원을 참조하십시오.
------
## 인스턴스의 클래스 변경
AWS Management Console 또는를 사용하여 인스턴스의 인스턴스 클래스를 변경할 수 있습니다 AWS CLI. 자세한 내용은 [Amazon DocumentDB 인스턴스 수정](db-instance-modify.md) 단원을 참조하십시오.
## 리전별 지원되는 인스턴스 클래스
Amazon DocumentDB는 다음 인스턴스 클래스를 지원합니다.
+ `R8G`- R6G 인스턴스에 비해 최대 30% 더 나은 성능을 제공하는 Arm-based AWS Graviton4 프로세서로 구동되는 메모리 최적화 인스턴스의 최신 세대입니다.
+ `R6G`- Arm-based AWS Graviton2 프로세서로 구동되는 메모리 최적화 인스턴스는 5% 더 저렴한 비용으로 R5 인스턴스보다 최대 30% 더 나은 성능을 제공합니다.
+ `R6GD` - 임시 데이터를 위한 로컬 비휘발성 메모리 익스프레스(NVMe) 기반 솔리드 스테이트 드라이브(SSD) 스토리지가 있는 메모리 최적화 R6G 인스턴스입니다.
+ `R5` - 동일한 인스턴스 비용으로 R4 인스턴스보다 최대 100% 더 나은 성능을 제공하는 메모리 최적화 인스턴스입니다.
+ `R4` - 이전 세대의 메모리 최적화 인스턴스입니다.
+ `T4G`- 기준 수준의 CPU 성능을 제공하는 Arm-based AWS Graviton2 프로세서로 구동되는 최신 세대 저비용 버스트 가능 범용 인스턴스 유형으로, T3 인스턴스보다 최대 35% 더 나은 가격 성능을 제공하며 일시적인 사용량 급증이 발생하는 중간 정도의 CPU 사용량이 있는 애플리케이션을 실행하는 데 적합합니다.
+ `T3` - 필요한 기간 동안 언제든지 CPU 사용량을 버스트할 수 있는 기능과 함께 기본 수준의 CPU 성능을 제공하는 저비용 버스터블 범용 인스턴스 유형입니다.
각 인스턴스 클래스의 세부 사양은 [인스턴스 클래스 사양](#db-instance-class-specs) 섹션을 참조하세요.
**참고**
I/O 최적화 스토리지는 엔진 버전 5.0 및 8.0(인스턴스 기반 클러스터)에서만 사용할 수 있습니다.
특정 인스턴스 클래스가 특정 리전에서 지원되거나 지원되지 않을 수 있습니다. 다음 표에는 각 리전에서 Amazon DocumentDB가 지원하는 인스턴스 클래스가 나와 있습니다.
**리전별 지원되는 인스턴스 클래스**
| | 인스턴스 클래스 | 리전 | R8G | R6GD | R6G | R5 | R4 | T4G | T3 | 서버리스 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 미국 동부(오하이오) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 |
| 미국 동부(버지니아 북부) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 |
| 미국 서부(오리건) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 |
| 아프리카(케이프타운) | | | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 남아메리카(상파울루) | | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 아시아 태평양(홍콩) | | | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 아시아 태평양(하이데라바드) | | | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 아시아 태평양(말레이시아) | | | 지원됨 | | | 지원됨 | 지원됨 | |
| 아시아 태평양(뭄바이) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 아시아 태평양(오사카) | | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | |
| 아시아 태평양(서울) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 아시아 태평양(시드니) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 아시아 태평양(자카르타) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | |
| 아시아 태평양(멜버른) | | | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | |
| 아시아 태평양(싱가포르) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 아시아 태평양(태국) | | | 지원됨 | | | 지원됨 | 지원됨 | |
| 아시아 태평양(도쿄) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 캐나다(중부) | | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 유럽(프랑크푸르트) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 유럽(취리히) | | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | |
| 유럽(아일랜드) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 | 지원됨 |
| 유럽(런던) | | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 유럽(밀라노) | | | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 유럽(파리) | | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 유럽(스페인) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 유럽(스톡홀름) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | |
| 멕시코(중부) | | | 지원됨 | | | 지원됨 | 지원됨 | |
| 중동(UAE) | | | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 중국(베이징) | | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 중국(닝샤) | | | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| 이스라엘(텔아비브) | | | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| AWS GovCloud(미국 서부) | 지원됨 | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
| AWS GovCloud(미국 동부) | | 지원됨 | 지원됨 | 지원됨 | | 지원됨 | 지원됨 | 지원됨 |
## 인스턴스 클래스 사양
다음 표에는 각 클래스에서 지원되는 인스턴스 유형을 포함하여 Amazon DocumentDB 인스턴스 클래스에 대한 세부 정보가 나와 있습니다. 테이블 아래에서 각 테이블 열에 대한 설명을 찾아볼 수 있습니다.
| 인스턴스 클래스 | vCPU1 | 메모리(GiB)2 | NVMe SSD 계층형 캐시(GiB)3 | 최대 온도 스토리지(GiB)4 | 기준/버스트 대역폭(Gbps)5 | 지원 엔진6 |
| --- | --- | --- | --- | --- | --- | --- |
| R8G - Graviton4 기반 현재 세대 메모리 최적화 인스턴스 클래스 R8G는 엔진 버전 5.0 및 8.0에서만 사용할 수 있는 최신 인스턴스 패밀리(Graviton4)입니다. db.r8g.24xlarge 및 db.r8g.48xlarge 크기는 아직 사용할 수 없습니다. |
| db.r8g.large | 2 | 16 | - | 30 | 0.937/12.5 | 5.0.0 및 8.0.0 |
| db.r8g.xlarge | 4 | 32 | - | 60 | 1.875/12.5 | 5.0.0 및 8.0.0 |
| db.r8g.2xlarge | 8 | 64 | - | 121 | 3.75/15.0 | 5.0.0 및 8.0.0 |
| db.r8g.4xlarge | 16 | 128 | - | 243 | 7.5/15.0 | 5.0.0 및 8.0.0 |
| db.r8g.8xlarge | 32 | 256 | - | 488 | 15 | 5.0.0 및 8.0.0 |
| db.r8g.12xlarge | 48 | 384 | - | 732 | 22 | 5.0.0 및 8.0.0 |
| db.r8g.16xlarge | 64 | 512 | - | 987 | 30 | 5.0.0 및 8.0.0 |
| R6G — Graviton2 기반의 현재 세대 메모리 최적화 인스턴스 클래스 |
| db.r6g.large | 2 | 16 | - | 32 | 0.75/10 | 4.0.0, 5.0.0 및 8.0.0 |
| db.r6g.xlarge | 4 | 32 | - | 63 | 1.25/10 | 4.0.0, 5.0.0 및 8.0.0 |
| db.r6g.2xlarge | 8 | 64 | - | 126 | 2.5/10 | 4.0.0, 5.0.0 및 8.0.0 |
| db.r6g.4xlarge | 16 | 128 | - | 252 | 5.0/10 | 4.0.0, 5.0.0 및 8.0.0 |
| db.r6g.8xlarge | 32 | 256 | - | 504 | 12 | 4.0.0, 5.0.0 및 8.0.0 |
| db.r6g.12xlarge | 48 | 384 | - | 756 | 20 | 4.0.0, 5.0.0 및 8.0.0 |
| db.r6g.16xlarge | 64 | 512 | - | 1008 | 25 | 4.0.0, 5.0.0 및 8.0.0 |
| R6G - Graviton2 기반의 현재 세대 NVMe 지원 인스턴스 클래스 |
| db.r6gd.xlarge | 4 | 32 | 173 | 64 | 1.25/10 | 5.0.0 및 8.0.0 |
| db.r6gd.2xlarge | 8 | 64 | 346 | 128 | 2.5/10 | 5.0.0 및 8.0.0 |
| db.r6gd.4xlarge | 16 | 128 | 694 | 256 | 5.0/10 | 5.0.0 및 8.0.0 |
| db.r6gd.8xlarge | 32 | 256 | 1388 | 512 | 12 | 5.0.0 및 8.0.0 |
| db.r6gd.12xlarge | 48 | 384 | 2082 | 768 | 20 | 5.0.0 및 8.0.0 |
| db.r6gd.16xlarge | 64 | 512 | 2776 | 1024 | 25 | 5.0.0 및 8.0.0 |
| R5 – 이전 세대 메모리 최적화 인스턴스 클래스 |
| db.r5.large | 2 | 16 | - | 31 | 0.75/10 | 3.6.0, 4.0.0, 5.0.0 및 8.0.0 |
| db.r5.xlarge | 4 | 32 | - | 62 | 1.25/10 | 3.6.0, 4.0.0, 5.0.0 및 8.0.0 |
| db.r5.2xlarge | 8 | 64 | - | 124 | 2.5/10 | 3.6.0, 4.0.0, 5.0.0 및 8.0.0 |
| db.r5.4xlarge | 16 | 128 | - | 249 | 5.0/10 | 3.6.0, 4.0.0, 5.0.0 및 8.0.0 |
| db.r5.8xlarge | 32 | 256 | - | 504 | 10 | 3.6.0, 4.0.0, 5.0.0 및 8.0.0 |
| db.r5.12xlarge | 48 | 384 | - | 748 | 12 | 3.6.0, 4.0.0, 5.0.0 및 8.0.0 |
| db.r5.16xlarge | 64 | 512 | - | 1008 | 20 | 3.6.0, 4.0.0, 5.0.0 및 8.0.0 |
| db.r5.24xlarge | 96 | 768 | - | 1500 | 25 | 3.6.0, 4.0.0, 5.0.0 및 8.0.0 |
| R4 – 이전 세대 메모리 최적화 인스턴스 클래스 R4 인스턴스는 엔진 버전 3.6에서만 지원됩니다. Amazon DocumentDB 3.6은 2026년 3월 30일에 표준 지원이 종료됩니다. 추가 지원(유료)은 2029년 3월까지 사용할 수 있습니다. |
| db.r4.large | 2 | 15.25 | - | 30 | 0.75/10 | 3.6.0만 |
| db.r4.xlarge | 4 | 30.5 | - | 60 | 1.25/10 | 3.6.0만 |
| db.r4.2xlarge | 8 | 61 | - | 120 | 2.5/10 | 3.6.0만 |
| db.r4.4xlarge | 16 | 122 | - | 240 | 5.0/10 | 3.6.0만 |
| db.r4.8xlarge | 32 | 244 | - | 480 | 10 | 3.6.0만 |
| db.r4.16xlarge | 64 | 488 | - | 960 | 25 | 3.6.0만 |
| T4G – Graviton2 기반 최신 세대 성능 버스트 기능이 있는 인스턴스 클래스 T 시리즈 인스턴스는 무제한 CPU 버스트 모드에서 실행됩니다. 기준 이후의 버스트 사용량은 추가 요금이 청구됩니다. 글로벌 클러스터에는 지원되지 않습니다. |
| db.t4g.medium | 2 | 4 | - | 8.13 | 0.256/5 | 4.0.0, 5.0.0 및 8.0.0 |
| T3 – 이전 세대 성능 버스트 기능이 있는 인스턴스 클래스 |
| db.t3.medium | 2 | 4 | - | 7.5 | 0.256/5 | 3.6.0, 4.0.0, 5.0.0 및 8.0.0 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/db-instance-classes.html) |
# NVMe 지원 인스턴스
NVMe 지원 인스턴스는 일반 인스턴스의 메모리를 초과하는 대규모 데이터세트가 있는 애플리케이션에 대해 최대 7배 더 빠른 쿼리 성능을 제공합니다. 이러한 인스턴스는 r6gd 인스턴스에서 사용할 수 있는 로컬 비휘발성 메모리 익스프레스(NVMe) 기반 솔리드 스테이트 드라이브(SSD) 스토리지를 활용하여 임시 데이터를 저장하고, 네트워크 기반 스토리지 액세스를 줄이며, 읽기 지연 시간과 처리량을 개선합니다.
로컬 SSD 공간은 다음 두 섹션으로 나뉩니다.
+ **계층형 캐시** - 로컬 SSD의 약 73%가 데이터베이스 캐시로 할당되므로 시스템이 기본 메모리만 저장할 때보다 최대 5배 더 많은 데이터베이스 페이지를 저장할 수 있습니다. 로컬 SSD는 2계층 캐시 역할을 하는 반면 기존의 인 메모리 버퍼 캐시는 1계층 캐시로 유지됩니다. 쿼리는 버퍼 캐시와 SSD 캐시 모두에 누락이 발생한 경우에만 외부 스토리지에 액세스합니다.
+ **임시 스토리지** - 나머지 27%는 비영구 임시 파일 스토리지용으로 예약되어 있으며, 정렬 또는 인덱스 빌드와 같은 리소스 집약적인 작업과 관련된 복잡한 쿼리에 사용됩니다. 일반 인스턴스에서는 임시 공간이 Amazon Elastic Block Store(EBS) 볼륨에 상주합니다. SSD의 로컬 호스팅 임시 스토리지는 정렬과 관련된 쿼리 지연 시간을 최대 2배 줄이고 인덱스 빌드와 같은 리소스 집약적인 작업을 가속화합니다.
지원되는 NVMe 지원 인스턴스 유형 및 사양에 대한 세부 정보는 [인스턴스 클래스 사양](db-instance-classes.md#db-instance-class-specs) 섹션에서 확인할 수 있습니다.
**Topics**
+ [NVMe 지원 인스턴스의 권장 사용 사례](#nvme-use-cases)
+ [Amazon DocumentDB에서 NVMe 지원 인스턴스 사용](#using-nvme)
+ [NVMe 지원 인스턴스 모니터링](#monitoring-nvme)
## NVMe 지원 인스턴스의 권장 사용 사례
다음 시나리오에서는 NVMe 지원 인스턴스를 사용하는 것이 좋습니다.
+ **읽기 중심 워크로드** - 워크로드가 읽기 집약적이고 데이터세트가 버퍼 캐시보다 크며 낮은 `BufferCacheHitRatio` 및 높은 `ReadIOPS` 지표로 표시되는 경우 NVMe 지원 인스턴스는 성능 이점을 제공할 수 있습니다.
+ **업데이트가 많은 워크로드** - 워크로드가 업데이트 집약적이고 네트워크 스토리지의 읽기 지연 시간으로 인해 폐영역 회수를 따라잡을 수 없는 경우 NVMe 지원 인스턴스가 문제를 완화하는 데 도움이 될 수 있습니다.
NVMe 지원 인스턴스는 다음과 같은 다양한 사용 사례에 도움이 될 수 있습니다.
+ **인터넷 규모의 애플리케이션** - 엄격한 성능의 서비스 수준 계약(SLA)을 사용하는 결제 처리, 결제 및 전자 상거래와 같은 애플리케이션은 NVMe 지원 인스턴스의 성능 이점을 활용할 수 있습니다.
+ **실시간 보고 대시보드** - 지표/데이터 수집을 위해 수백 개의 쿼리를 실행하는 대시보드는 NVMe 지원 인스턴스의 짧은 지연 시간과 높은 처리량을 활용할 수 있습니다.
+ **생성형 AI 애플리케이션** - 벡터 검색을 사용하여 수백만 개의 벡터 임베딩에서 정확하거나 가장 가까운 인접 항목을 찾는 애플리케이션은 NVMe 지원 인스턴스의 고성능을 활용할 수 있습니다.
## Amazon DocumentDB에서 NVMe 지원 인스턴스 사용
Amazon DocumentDB의 NVMe 지원 인스턴스를 사용하려면 다음을 수행합니다.
+ Amazon DocumentDB 클러스터를 생성하고 NVMe 지원 인스턴스 클래스 중 하나를 추가합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 생성](db-cluster-create.md) 섹션을 참조하세요.
+ 또는 NVMe 지원 인스턴스 클래스 중 하나를 사용하도록 기존 Amazon DocumentDB 클러스터를 수정합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 수정](db-cluster-modify.md) 섹션을 참조하세요.
여러 AWS 리전에서 NVMe 지원 인스턴스의 가용성을 확인하려면 [리전별 지원되는 인스턴스 클래스](db-instance-classes.md#db-instance-classes-by-region) 섹션을 참조하세요.
NVMe 지원 인스턴스에서 일반 인스턴스로 다시 전환하려면 Amazon DocumentDB 인스턴스의 데이터베이스 인스턴스 클래스를 NVMe 스토리지가 없는 유사한 인스턴스 클래스로 수정합니다. 예를 들어, 현재 인스턴스 클래스가 'db.r6gd.4xlarge’인 경우 'db.r6g.4xlarge'를 선택하여 다시 전환합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 수정](db-cluster-modify.md) 섹션을 참조하세요.
## NVMe 지원 인스턴스 모니터링
Amazon CloudWatch에서 사용할 수 있는 일반 인스턴스 지표 외에도 NVMe 기반 인스턴스는 NVMe 기반 SSD 스토리지, IOPS 및 처리량과 관련된 추가 지표를 내보냅니다.
```
NVMeStorageCacheHitRatio
FreeNVMeStorage
ReadIOPSNVMeStorage
ReadLatencyNVMeStorage
ReadThroughputNVMeStorage
WriteIOPSNVMeStorage
WriteLatencyNVMeStorage
WriteThroughputNVMeStorage
```
이러한 지표에 대한 자세한 내용은 [NVMe 지원 인스턴스 지표](cloud_watch.md#nvme-metrics) 섹션을 참조하세요.