`** 대화 상자에서 원하는 대로 변경합니다. 그런 다음 **Modify cluster parameter(클러스터 파라미터 수정)**를 선택하거나 **취소**를 선택하여 변경 사항을 무시합니다.
------
#### [ Using the AWS CLI ]
AWS CLI를 사용하여 사용자 지정 Amazon DocumentDB 클러스터 파라미터 그룹에서 수정 가능한 파라미터의 `ParameterValue`, `Description` 또는 `ApplyMethod`를 수정할 수 있습니다. 기본 클러스터 파라미터 그룹을 직접 수정할 수는 없습니다.
사용자 지정 클러스터 파라미터 그룹의 파라미터를 수정하려면 다음 파라미터와 함께 `modify-db-cluster-parameter-group` 작업을 사용합니다.
+ **--db-cluster-parameter-group-name** - 필수입니다. 수정하려는 클러스터 파라미터 그룹의 이름입니다.
+ **--parameters** - 필수입니다. 수정 중인 파라미터입니다. Amazon DocumentDB 클러스터의 모든 인스턴스에 적용되는 파라미터 목록은 [Amazon DocumentDB 클러스터 파라미터 참조](cluster_parameter_groups-list_of_parameters.md)(을)를 참조하세요. 각 파라미터 요소는 다음을 포함해야 합니다.
+ **ParameterName** - 수정 중인 파라미터의 이름입니다.
+ **ParameterValue** - 이 파라미터의 새 값입니다.
+ **ApplyMethod** - 파라미터에 대한 변경 사항을 적용할 방법입니다. 허용된 값은 `immediate` 및 `pending-reboot`입니다.
**참고**
`static`의 `ApplyType` 파라미터에는 `pending-reboot`의 `ApplyMethod`이 있어야 합니다.
**Example - 파라미터 값 수정**
이 예에서는 `sample-parameter-group`의 파라미터 값을 나열하고 `tls` 파라미터를 수정합니다. 그런 다음 5분 후에 다시 `sample-parameter-group`의 파라미터 값을 나열하여 변경된 파라미터 값을 확인합니다.
1. `sample-parameter-group`의 파라미터 및 해당 값을 나열합니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Windows의 경우:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"Parameters": [
{
"Source": "system",
"ApplyType": "static",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "tls",
"IsModifiable": true,
"Description": "Config to enable/disable TLS"
},
{
"Source": "user",
"ApplyType": "dynamic",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "ttl_monitor",
"IsModifiable": true,
"Description": "Enables TTL Monitoring"
}
]
}
```
1. 해당 값이 `disabled`가 되도록 `tls` 파라미터를 수정합니다.
`ApplyType`은 `static`이므로 `ApplyMethod`를 수정할 수 없습니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot
```
Windows의 경우:
```
aws docdb modify-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
1. 적어도 5분을 기다립니다.
1. `sample-parameter-group`의 파라미터 값을 나열하여 `tls` 파라미터가 수정되었는지 확인합니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Windows의 경우:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"Parameters": [
{
"ParameterValue": "false",
"ParameterName": "enable_audit_logs",
"ApplyType": "dynamic",
"DataType": "string",
"Description": "Enables auditing on cluster.",
"AllowedValues": "true,false",
"Source": "system",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
},
{
"ParameterValue": "disabled",
"ParameterName": "tls",
"ApplyType": "static",
"DataType": "string",
"Description": "Config to enable/disable TLS",
"AllowedValues": "disabled,enabled",
"Source": "system",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
}
]
}
```
------
# 사용자 지정 클러스터 파라미터 그룹을 사용하도록 Amazon DocumentDB 클러스터 수정
Amazon DocumentDB 클러스터를 생성하면 해당 클러스터에 대해 `default.docdb4.0` 파라미터 그룹이 자동으로 생성됩니다. `default` 클러스터 파라미터 그룹은 수정할 수 없습니다. 대신 Amazon DocumentDB 클러스터를 수정하여 새로 사용자 지정된 파라미터 그룹을 연결할 수 있습니다.
이 섹션에서는 AWS Management Console 및 AWS Command Line Interface ()를 사용하여 사용자 지정 클러스터 파라미터 그룹을 사용하도록 기존 Amazon DocumentDB 클러스터를 수정하는 방법을 설명합니다AWS CLI.
------
#### [ Using the AWS Management Console ]
**기본이 아닌 새로운 클러스터 파라미터 그룹을 사용하도록 Amazon DocumentDB 클러스터를 수정하려면**
1. 시작하기 전에 Amazon DocumentDB 클러스터와 클러스터 파라미터 그룹을 생성했는지 확인합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 생성](db-cluster-create.md) 및 [Amazon DocumentDB 클러스터 파라미터 그룹 생성](cluster_parameter_groups-create.md)(을)를 참조하세요.
1. 클러스터 파라미터 그룹을 생성한 후 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)에서 Amazon DocumentDB 콘솔을 엽니다. 탐색 창에서 **클러스터**를 선택하여 새 파라미터 그룹을 클러스터에 추가합니다.
1. 파라미터 그룹을 연결할 클러스터를 선택합니다. **작업**을 선택한 다음 **수정**을 선택하여 클러스터를 수정합니다.
1. **클러스터 옵션**에서 클러스터를 연결할 새 파라미터 그룹을 선택합니다.
1. 수정 사항의 요약을 보려면 **계속**을 선택합니다.
1. 변경 사항을 확인한 후 즉시 적용하거나 **수정 일정** 아래의 다음 유지 관리 기간 중에 적용할 수 있습니다.
1. 클러스터를 새 파라미터 그룹으로 업데이트하려면 **클러스터 수정**을 선택합니다.
------
#### [ Using the AWS CLI ]
시작하기 전에 Amazon DocumentDB 클러스터와 클러스터 파라미터 그룹을 생성했는지 확인합니다. 작업을 사용하여 [ Amazon DocumentDB 클러스터](https://docs.aws.amazon.com//documentdb/latest/developerguide/db-cluster-create.html)를 AWS CLI `create-db-cluster` 생성할 수 있습니다. `create-db-cluster-parameter-group` 작업을 사용하여 [클러스터 파라미터 그룹을 생성할](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) 수 있습니다 AWS CLI .
새 클러스터 파라미터 그룹을 클러스터에 추가하려면 다음 파라미터와 함께 `modify-db-cluster` 작업을 사용합니다 AWS CLI .
+ **--db-cluster-identifier** - 클러스터의 이름(예: `sample-cluster`)입니다.
+ **--db-cluster-parameter-group-name** - 클러스터를 연결할 파라미터 그룹의 이름(예: `sample-parameter-group`)입니다.
**Example**
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--db-cluster-parameter-group-name sample-parameter-group
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
"DBCluster": {
"AvailabilityZones": [
"us-west-2c",
"us-west-2b",
"us-west-2a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
...
}
```
------
# Amazon DocumentDB 클러스터 파라미터 그룹 복사
AWS Management Console 또는 AWS Command Line Interface ()를 사용하여 Amazon DocumentDB에서 클러스터 파라미터 그룹의 복사본을 만들 수 있습니다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. 탐색 창에서 **파라미터 그룹**을 선택합니다.
1. **클러스터 파라미터 그룹** 창에서 복사하려는 클러스터 파라미터 그룹의 이름을 선택합니다.
1. **작업**을 선택한 후 **복사**를 선택하여 해당 파라미터 그룹을 복사합니다.
1. **복사 옵션**에서 새 클러스터 파라미터 그룹의 이름과 설명을 입력합니다. 그런 다음 **복사**를 선택하여 변경 사항을 저장합니다.
------
#### [ Using the AWS CLI ]
클러스터 파라미터 그룹을 복사하려면 다음 파라미터와 함께 `copy-db-cluster-parameter-group` 작업을 사용합니다.
+ **--source-db-cluster-parameter-group-identifier** - 필수입니다. 복사하려는 클러스터 파라미터 그룹의 의 이름 또는 Amazon 리소스 이름(ARN)입니다.
소스 및 대상 클러스터 파라미터 그룹이 동일한 경우 AWS 리전식별자는 이름 또는 ARN일 수 있습니다.
소스 및 대상 클러스터 파라미터 그룹이 다른 경우 AWS 리전식별자는 ARN이어야 합니다.
+ **--target-db-cluster-parameter-group-identifier** - 필수입니다. 클러스터 파라미터 그룹 복사본의 이름 또는 ARN입니다.
제약 조건:
+ null이거나, 비워 두거나, 공백을 입력할 수 없습니다.
+ 1\$1255자의 문자, 숫자 또는 하이픈을 포함해야 합니다.
+ 첫 번째 문자는 글자이어야 합니다.
+ 하이픈으로 끝나거나 하이픈이 2개 연속으로 이어져서는 안 됩니다.
+ **--target-db-cluster-parameter-group-description** - 필수입니다. 사용자가 제공한 클러스터 파라미터 그룹 복사본에 대한 설명입니다.
**Example**
다음은 `sample-parameter-group`의 복사본을 만들어 이름을 `sample-parameter-group-copy`로 지정하는 코드입니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb copy-db-cluster-parameter-group \
--source-db-cluster-parameter-group-identifier sample-parameter-group \
--target-db-cluster-parameter-group-identifier sample-parameter-group-copy \
--target-db-cluster-parameter-group-description "Copy of sample-parameter-group"
```
Windows의 경우:
```
aws docdb copy-db-cluster-parameter-group ^
--source-db-cluster-parameter-group-identifier sample-parameter-group ^
--target-db-cluster-parameter-group-identifier sample-parameter-group-copy ^
--target-db-cluster-parameter-group-description "Copy of sample-parameter-group"
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group-copy",
"DBClusterParameterGroupName": "sample-parameter-group-copy",
"DBParameterGroupFamily": "docdb4.0",
"Description": "Copy of sample-parameter-group"
}
}
```
------
# Amazon DocumentDB 클러스터 파라미터 그룹 재설정
AWS Management Console 또는 AWS Command Line Interface (AWS CLI)를 사용하여 클러스터 파라미터 그룹을 재설정하여 Amazon DocumentDB 클러스터 파라미터 그룹의 파라미터 값 중 일부 또는 전부를 기본값으로 재설정할 수 있습니다.
------
#### [ Using the AWS Management Console ]
클러스터 파라미터 그룹의 파라미터 값 중 일부 또는 전부를 기본값으로 재설정하려면 다음 단계를 수행하십시오.
**클러스터 파라미터 그룹의 파라미터 값을 재설정하려면**
1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다.
1. 콘솔 왼쪽의 탐색 창에서 **파라미터 그룹**을 선택합니다.
1. **클러스터 파라미터 그룹** 창에서 재설정하려는 클러스터 파라미터 그룹의 이름을 선택합니다.
1. **작업**을 선택한 후 **재설정**을 선택하여 해당 파라미터 그룹을 재설정합니다.
1. 결과 **클러스터 파라미터 그룹 재설정 확인** 페이지에서 해당 파라미터 그룹에 대한 모든 클러스터 파라미터를 기본값으로 재설정할지 확인합니다. 그런 다음 **재설정**을 선택하여 파라미터 그룹을 재설정합니다. **취소**를 선택하여 변경 사항을 취소할 수도 있습니다.
------
#### [ Using the AWS CLI ]
클러스터 파라미터 그룹의 파라미터 값 중 일부 또는 전부를 기본값으로 재설정하려면 다음 파라미터와 함께 `reset-db-cluster-parameter-group` 작업을 사용합니다.
+ **--db-cluster-parameter-group-name** - 필수입니다. 재설정할 클러스터 파라미터 그룹의 이름입니다.
+ **--parameters** - 선택 사항. 기본값으로 재설정하려는 클러스터 파라미터 그룹의 `ParameterName` 및 `ApplyMethod` 목록입니다. 다음 인스턴스 재시작 또는 `reboot-db-instance` 요청 시 적용하려면 정적 파라미터를 `pending-reboot`로 설정해야 합니다. 업데이트된 정적 파라미터를 적용할 클러스터의 모든 인스턴스에 대해 `reboot-db-instance`를 호출해야 합니다.
이 파라미터와 `--reset-all-parameters`는 상호 배타적이므로 둘 중 하나를 선택할 수 있지만 둘 다 선택할 수는 없습니다.
+ **--reset-all-parameters** 또는 **--no-reset-all-parameters** - 선택 사항. 모든 파라미터(`--reset-all-parameters`)를 기본값으로 재설정할지 또는 일부 파라미터(`--no-reset-all-parameters`)를 기본값으로 재설정할지를 지정합니다. `--reset-all-parameters` 파라미터와 `--parameters`는 상호 배타적이므로 둘 중 하나를 선택할 수 있지만 둘 다 선택할 수는 없습니다.
전체 그룹을 재설정하면 동적 파라미터가 즉시 업데이트됩니다. 다음 인스턴스 재시작 시 또는 `reboot-db-instance` 요청 시 적용하려면 정적 파라미터를 `pending-reboot`로 설정합니다. 업데이트된 정적 파라미터를 적용할 클러스터의 모든 인스턴스에 대해 `reboot-db-instance`를 호출해야 합니다.
**Example**
**예제 1: 모든 파라미터를 기본값으로 재설정합니다.**
다음 코드는 클러스터 파라미터 그룹 `sample-parameter-group`의 모든 파라미터를 기본값으로 재설정합니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--reset-all-parameters
```
Windows의 경우:
```
aws docdb reset-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--reset-all-parameters
```
**예제 2: 지정된 파라미터를 기본값으로 재설정합니다.**
다음 코드는 클러스터 파라미터 그룹 `sample-parameter-group`의 `tls` 파라미터를 기본값으로 재설정합니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--no-reset-all-parameters \
--parameters ParameterName=tls,ApplyMethod=pending-reboot
```
Windows의 경우:
```
aws docdb reset-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--no-reset-all-parameters ^
--parameters ParameterName=tls,ApplyMethod=pending-reboot
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
**클러스터 인스턴스 재부팅**
정적 파라미터 값을 변경하기 전에 클러스터 인스턴스를 재부팅해야 합니다. 업데이트된 정적 파라미터를 적용할 클러스터의 각 인스턴스를 재부팅합니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-cluster-instance
```
Windows의 경우:
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-cluster-instance
```
------
# Amazon DocumentDB 클러스터 파라미터 그룹 삭제
AWS Management Console 또는 AWS Command Line Interface ()를 사용하여 사용자 지정 Amazon DocumentDB 클러스터 파라미터 그룹을 삭제할 수 있습니다AWS CLI. `default.docdb4.0` 클러스터 파라미터 그룹은 삭제할 수 없습니다.
------
#### [ 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. **파라미터 그룹** 창에서 삭제하려는 클러스터 파라미터 그룹 왼쪽에 있는 라디오 버튼을 선택합니다.
1. **작업**을 선택한 후 **삭제**를 선택합니다.
1. **삭제** 확인 창에서 **삭제**를 선택하여 클러스터 파라미터 그룹을 삭제합니다. 클러스터 파라미터 그룹을 유지하려면 **취소**를 선택합니다.
------
#### [ Using the AWS CLI ]
클러스터 파라미터 그룹을 삭제하려면 다음 파라미터와 함께 `delete-db-cluster-parameter-group` 작업을 사용합니다.
+ **--db-cluster-parameter-group-name** - 필수입니다. 삭제할 클러스터 파라미터 그룹의 이름입니다. 기존 클러스터 파라미터 그룹이어야 합니다. *`default.docdb4.0` 클러스터 파라미터 그룹은 삭제할 수 없습니다. *
**Example - 클러스터 파라미터 그룹 삭제**
다음 예제에서는 클러스터 파라미터 그룹을 삭제하기 위한 3단계를 안내합니다.
1. 삭제하려는 클러스터 파라미터 그룹의 이름 찾기
1. 지정된 클러스터 파라미터 그룹 삭제
1. 클러스터 파라미터 그룹이 삭제되었는지 확인
**1. 삭제하려는 클러스터 파라미터 그룹의 이름을 찾습니다.**
다음 코드는 모든 클러스터 파라미터 그룹의 이름을 나열합니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Windows의 경우:
```
aws docdb describe-db-cluster-parameter-groups ^
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
이전 작업의 출력에는 다음과 유사한 클러스터 파라미터 그룹의 이름이 나열됩니다(JSON 형식).
```
[
[
"default.docdb4.0"
],
[
"sample-parameter-group"
],
[
"sample-parameter-group-copy"
]
]
```
**2. 클러스터 파라미터 그룹을 삭제합니다.**
다음 코드는 `sample-parameter-group-copy` 클러스터 파라미터 그룹을 삭제합니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb delete-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group-copy
```
Windows의 경우:
```
aws docdb delete-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group-copy
```
이 작업에는 출력이 없습니다.
**3. 지정된 클러스터 파라미터 그룹이 삭제되었는지 확인합니다.**
다음 코드는 이름이 변경된 모든 클러스터 파라미터 그룹의 이름을 나열합니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
Windows의 경우:
```
aws docdb describe-db-cluster-parameter-groups ^
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]'
```
이전 작업의 출력에는 다음과 유사한 클러스터 파라미터 그룹이 나열됩니다(JSON 형식). 방금 삭제한 클러스터 파라미터 그룹이 목록에 없어야 합니다.
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
[
[
"default.docdb4.0"
],
[
"sample-parameter-group"
]
]
```
------
# Amazon DocumentDB 클러스터 파라미터 참조
동적 파라미터를 변경하고 클러스터 파라미터 그룹을 저장하면 *즉시 적용* 설정과 관계없이 변경 사항이 바로 적용됩니다. 고정 파라미터를 변경하고 클러스터 파라미터 그룹을 저장하면 인스턴스를 수동으로 재부팅한 후에 파라미터 변경 사항이 적용됩니다. Amazon DocumentDB 콘솔을 사용하거나 명시적으로 `reboot-db-instance`를 호출하여 인스턴스를 재부팅할 수 있습니다.
다음 표에는 Amazon DocumentDB 클러스터의 모든 인스턴스에 적용되는 파라미터가 나와 있습니다.
**Amazon DocumentDB 클러스터 수준 파라미터**
| 파라미터 | 기본값 | 유효값 | 수정 가능 | 적용 유형 | 데이터 형식 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| audit\$1logs | disabled | enabled, disabled, ddl, dml\$1read, dml\$1write, all, none | 예 | 동적 | 문자열 | Amazon CloudWatch 감사 로그 활성화 여부를 정의합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| change\$1stream\$1log\$1retention\$1duration | 10800 | 3600-604800 | 예 | 동적 | Integer | 변경 스트림 로그가 보관되고 소비될 수 있는 시간(초)을 정의합니다. |
| default\$1collection\$1compression | disabled | 활성화됨, 비활성화됨(Amazon DocumentDB 5.0)/zstd, lz4, 없음(Amazon DocumentDB8.0) | 예 | 동적 | 문자열 | 클러스터의 새 컬렉션에 대한 기본 압축 설정을 정의합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| profiler | disabled | enabled, disabled | 예 | 동적 | 문자열 | 느린 작업에 대해 프로파일링을 활성화합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| profiler\$1sampling\$1rate | 1.0 | 0.0-1.0 | 예 | 동적 | Float | 로깅된 작업의 샘플링 비율을 정의합니다. |
| profiler\$1threshold\$1ms | 100 | 50-2147483646 | 예 | 동적 | Integer | profiler에 대한 임계값을 정의합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| planner\$1version | 3.0 | 1.0, 2.0, 3.0 | 예 | 동적 | Float | 쿼리에 사용할 쿼리 플래너 버전을 정의합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| tls | enabled | enabled, disabled, fips-140-3, tls1.2\$1, tls1.3\$1 | 예 | 정적 | 문자열 | TLS(전송 계층 보안) 연결이 필요한지 여부를 정의합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
| ttl\$1monitor | enabled | enabled, disabled | 예 | 동적 | 문자열 | Time To Live(TTL) 모니터링이 클러스터에 대해 활성화되었는지 여부를 정의합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) |
# Amazon DocumentDB 클러스터 파라미터 수정
Amazon DocumentDB에서 *클러스터 파라미터 그룹*은 클러스터에서 만드는 모든 인스턴스에 적용되는 *파라미터*로 구성됩니다. 사용자 지정 클러스터 파라미터 그룹의 경우 언제든지 파라미터 값을 수정하거나 모든 파라미터 값을 사용자가 생성하는 파라미터 그룹에 대한 기본값으로 재설정할 수 있습니다. 이 단원에서는 Amazon DocumentDB 클러스터 파라미터 그룹을 구성하는 파라미터 및 해당 값을 확인하는 방법과 이러한 값을 변경하거나 업데이트하는 방법에 대해 설명합니다.
파라미터는 *동적*이거나 *정적*일 수 있습니다. 동적 파라미터를 변경하고 클러스터 파라미터 그룹을 저장하면 `Apply Immediately` 설정과 관계없이 변경 사항이 바로 적용됩니다. 고정 파라미터를 변경하고 클러스터 파라미터 그룹을 저장하면 인스턴스를 수동으로 재부팅한 후에만 파라미터 변경 사항이 적용됩니다.
## Amazon DocumentDB 클러스터 파라미터 그룹의 파라미터 보기
AWS Management Console 또는를 사용하여 Amazon DocumentDB 클러스터의 파라미터와 해당 값을 볼 수 있습니다 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. **파라미터 그룹** 창에서 세부 정보를 보려는 클러스터 파라미터 그룹의 이름을 선택합니다.
1. 결과 페이지에는 각 파라미터에 대한 값(파라미터 이름, 현재 값, 허용된 값, 파라미터 수정 가능 여부, 적용 유형, 데이터 형식 및 설명)이 표시됩니다.
![\[스크린샷: 파라미터 이름 및 값.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-determine-parameter-value.png)
------
#### [ Using the AWS CLI ]
클러스터 파라미터 그룹의 파라미터 및 해당 값을 보려면 다음 파라미터와 함께 `describe-db-cluster-parameters` 작업을 사용합니다.
+ **--db-cluster-parameter-group-name** - 필수입니다. 자세한 파라미터 목록을 원하는 클러스터 파라미터 그룹의 이름입니다.
+ **--source** - 선택 사항. 제공된 경우 특정 소스에 대한 파라미터만 반환합니다. 파라미터 소스는 `engine-default`, `system` 또는 `user`가 될 수 있습니다.
**Example**
다음 코드에는 `custom3-6-param-grp` 파라미터 그룹의 모든 파라미터 및 해당 값이 나열되어 있습니다. 파라미터 그룹에 대한 세부 정보를 보려면 `--query` 줄을 생략합니다. 모든 파라미터 그룹에 대한 정보를 보려면 `--db-cluster-parameter-group-name` 줄을 생략합니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name custom3-6-param-grp \
--query 'Parameters[*].[ParameterName,ParameterValue]'
```
Windows의 경우:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name custom3-6-param-grp ^
--query 'Parameters[*].[ParameterName,ParameterValue]'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
[
[
"audit_logs",
"disabled"
],
[
"tls",
"enabled"
],
[
"ttl_monitor",
"enabled"
]
]
```
------
## Amazon DocumentDB 클러스터 파라미터 그룹의 파라미터 수정
AWS Management Console 또는를 사용하여 파라미터 그룹의 파라미터를 수정할 수 있습니다 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. **파라미터 그룹** 창에서 파라미터를 업데이트하려는 클러스터 파라미터 그룹을 선택합니다.
1. 결과 페이지에는 이 클러스터 파라미터 그룹에 대한 파라미터 및 해당 세부 정보가 표시됩니다. 업데이트할 파라미터를 선택합니다.
1. 페이지 오른쪽 상단에서 **편집**을 선택하여 파라미터의 값을 변경합니다. 클러스터 파라미터 유형에 대한 자세한 내용은 [Amazon DocumentDB 클러스터 파라미터 참조](cluster_parameter_groups-list_of_parameters.md)(을)를 참조하세요.
1. 변경한 다음 **Modify cluster parameter(클러스터 파라미터 수정)**를 선택하여 변경 사항을 저장합니다. 변경 사항을 취소하려면 **취소**를 선택합니다.
------
#### [ Using the AWS CLI ]
클러스터 파라미터 그룹의 파라미터를 수정하려면 다음 파라미터와 함께 `modify-db-cluster-parameter-group` 작업을 사용합니다.
+ **--db-cluster-parameter-group-name** - 필수입니다. 수정하려는 클러스터 파라미터 그룹의 이름입니다.
+ **--parameters** - 필수입니다. 수정할 파라미터입니다. 각 파라미터 요소는 다음을 포함해야 합니다.
+ **ParameterName** - 수정 중인 파라미터의 이름입니다.
+ **ParameterValue** - 이 파라미터의 새 값입니다.
+ **ApplyMethod** - 파라미터에 대한 변경 사항을 적용할 방법입니다. 허용된 값은 `immediate` 및 `pending-reboot`입니다.
**참고**
`static`의 `ApplyType` 파라미터에는 `pending-reboot`의 `ApplyMethod`이 있어야 합니다.
**클러스터 파라미터 그룹의 파라미터 값을 변경하려면(AWS CLI)**
다음 예에서는 `tls` 파라미터를 변경합니다.
1. **`sample-parameter-group`의 파라미터 및 해당 값을 나열합니다.**
Linux, macOS 또는 Unix의 경우:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Windows의 경우:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"Parameters": [
{
"Source": "system",
"ApplyType": "static",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "tls",
"IsModifiable": true,
"Description": "Config to enable/disable TLS"
},
{
"Source": "user",
"ApplyType": "dynamic",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "ttl_monitor",
"IsModifiable": true,
"Description": "Enables TTL Monitoring"
}
]
}
```
1. **값이 `disabled`이 되도록 `tls` 파라미터를 수정합니다**. `ApplyType`은 `static`이므로 `ApplyMethod`를 수정할 수 없습니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters "ParameterName"=tls,ParameterValue=disabled,ApplyMethod=pending-reboot"
```
Windows의 경우:
```
aws docdb modify-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--parameters "ParameterName=tls,ParameterValue=disabled,ApplyMethod=pending-reboot"
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
1. **적어도 5분을 기다립니다.**
1. **`sample-parameter-group`의 파라미터 값을 나열합니다.**
Linux, macOS 또는 Unix의 경우:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Windows의 경우:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"Parameters": [
{
"ParameterName": "audit_logs",
"ParameterValue": "disabled",
"Description": "Enables auditing on cluster.",
"Source": "system",
"ApplyType": "dynamic",
"DataType": "string",
"AllowedValues": "enabled,disabled",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
},
{
"ParameterName": "tls",
"ParameterValue": "disabled",
"Description": "Config to enable/disable TLS",
"Source": "user",
"ApplyType": "static",
"DataType": "string",
"AllowedValues": "disabled,enabled",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
}
]
}
```
------
# Amazon DocumentDB 엔드포인트에 대한 이해
Amazon DocumentDB(MongoDB와 호환됨) 엔드포인트를 사용하여 클러스터 또는 인스턴스에 연결할 수 있습니다. Amazon DocumentDB에는 각각 고유한 용도가 있는 세 가지 유형의 엔드포인트가 있습니다.
**Topics**
+ [클러스터 엔드포인트 찾기](db-cluster-endpoints-find.md)
+ [인스턴스의 엔드포인트 찾기](db-instance-endpoint-find.md)
+ [엔드포인트에 연결](endpoints-connecting.md)
**클러스터 엔드포인트**
클러스터 엔드포인트는 클러스터의 현재 기본 인스턴스에 연결되는 Amazon DocumentDB 클러스터의 엔드포인트입니다. 각 Amazon DocumentDB 클러스터 엔드포인트 하나와 기본 인스턴스 하나가 있습니다. 장애 조치의 경우 클러스터 엔드포인트가 새로운 기본 인스턴스에 다시 매핑됩니다.
**리더 엔드포인트**
리더 엔드포인트는 해당 클러스터에서 사용할 수 있는 복제본 중 하나에 연결되는 Amazon DocumentDB 클러스터의 엔드포인트입니다. 각 Amazon DocumentDB 클러스터에는 리더 엔드포인트가 1개씩 있습니다. 복제본이 둘 이상이면 리더 엔드포인트는 각 연결 요청을 Amazon DocumentDB 복제본 중 하나로 전달합니다.
**인스턴스 엔드포인트**
인스턴스 엔드포인트는 특정 인스턴스에 연결되는 엔드포인트입니다. 기본 인스턴스인지 복제본 인스턴스인지 여부에 상관없이 클러스터의 각 인스턴스에는 고유한 인스턴스 엔드포인트가 있습니다. 애플리케이션에서 인스턴스 엔드포인트를 사용하지 않는 것이 좋습니다. 왜냐하면 장애 조치를 실행하는 경우 역할을 변경할 수 있으므로 애플리케이션에서 코드 변경을 요구할 수 있기 때문입니다.
# 클러스터 엔드포인트 찾기
Amazon DocumentDB 콘솔 또는 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. 탐색 창에서 **클러스터**를 선택합니다.
1. 클러스터 목록에서 원하는 클러스터 이름을 선택합니다.
1. 클러스터 세부 정보 페이지에서 **구성** 탭을 선택합니다. **구성 및 상태** 섹션에서 **클러스터 엔드포인트**와 **리더 엔드포인트**를 찾을 수 있습니다.
![\[클러스터 및 리더 엔드포인트를 보여주는 구성 및 상태 섹션.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cluster-endpoints.png)
1. 이 클러스터에 연결하려면 **연결 및 보안** 탭을 선택합니다. `mongo` 쉘에 대한 연결 문자열과 애플리케이션 코드에서 클러스터에 연결하는 데 사용할 수 있는 연결 문자열을 찾습니다.
![\[Mongo 쉘에서 인스턴스에 연결하는 문자열과 애플리케이션에서 클러스터에 연결하는 문자열을 보여주는 연결 섹션.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/cluster-connection-strings.png)
------
#### [ Using the AWS CLI ]
AWS CLI를 사용하여 클러스터 및 클러스터에 대한 리더 엔드포인트를 찾으려면 `describe-db-clusters` 명령을 해당 파라미터와 함께 실행합니다.
**파라미터**
+ **--db-cluster-identifier**—선택 사항. 엔드포인트를 반환하려는 클러스터를 지정합니다. 생략한 경우 최대 100개의 클러스터에 대한 엔드포인트를 반환합니다.
+ **--query**—선택 사항. 표시할 필드를 지정합니다. 엔드포인트를 찾기 위해 볼 데이터의 양을 줄여서 도와줍니다. 생략하면 클러스터에 대한 모든 정보가 반환됩니다.
+ **--region**—선택 사항. `--region` 파라미터를 사용하여 명령을 적용할 리전을 지정합니다. 생략하면 기본 리전이 사용됩니다.
**Example**
다음 예에서는 `DBClusterIdentifier`에 대한 `ReaderEndpoint`, 엔드포인트(클러스터 엔드포인트) 및 `sample-cluster`를 반환합니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-clusters \
--region us-east-1 \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
Windows의 경우:
```
aws docdb describe-db-clusters ^
--region us-east-1 ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
[
[
"sample-cluster",
27017,
"sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com",
"sample-cluster.cluster-ro-corlsfccjozr.us-east-1.docdb.amazonaws.com"
]
]
```
클러스터 엔드포인트가 있으므로 이제 `mongo` 또는 `mongodb`를 사용하여 클러스터에 연결할 수 있습니다. 자세한 내용은 [엔드포인트에 연결](endpoints-connecting.md) 섹션을 참조하세요.
------
# 인스턴스의 엔드포인트 찾기
Amazon DocumentDB 콘솔 또는 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. 관심 있는 인스턴스의 왼쪽에 있는 확인란을 체크합니다.
1. 아래로 스크롤하여 **세부 정보** 섹션으로 이동한 다음 인스턴스 엔드포인트를 찾습니다.
![\[인스턴스 엔드포인트가 강조 표시된 세부 정보 페이지를 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-instance-endpoint.png)
1. 이 인스턴스에 연결하려면 위로 스크롤하여 **연결** 섹션으로 이동합니다. `mongo` 쉘에 대한 연결 문자열과 애플리케이션 코드에서 인스턴스에 연결하는 데 사용할 수 있는 연결 문자열을 찾습니다.
![\[Mongo 쉘 및 애플리케이션 연결 문자열이 강조 표시된 연결 섹션을 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/instance-connection-strings.png)
------
#### [ Using the AWS CLI ]
AWS CLI를 사용하여 인스턴스 엔드포인트를 찾으려면 다음 명령을 해당 인수와 함께 실행합니다.
**인수**
+ **--db-instance-identifier**—선택 사항. 엔드포인트를 반환하려는 인스턴스를 지정합니다. 생략한 경우 최대 100개의 인스턴스에 대한 엔드포인트를 반환합니다.
+ **--query**—선택 사항. 표시할 필드를 지정합니다. 엔드포인트를 찾기 위해 볼 데이터의 양을 줄여서 도와줍니다. 생략하면 인스턴스에 대한 모든 정보가 반환됩니다. `Endpoint` 필드에는 세 개의 멤버가 있습니다. 따라서 다음 예제와 같이 쿼리에 나열하면 세 멤버가 모두 반환됩니다. `Endpoint` 멤버 중 일부에만 관심이 있는 경우 두 번째 예제와 같이 쿼리의 `Endpoint`를 원하는 멤버로 교체하세요.
+ **--region**—선택 사항. `--region` 파라미터를 사용하여 명령을 적용할 리전을 지정합니다. 생략하면 기본 리전이 사용됩니다.
**Example**
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
Windows의 경우:
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
[
[
"sample-cluster-instance",
{
"Port": 27017,
"Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com",
"HostedZoneId": "Z2R2ITUGPM61AM"
}
]
]
```
엔드포인트의 `HostedZoneId`를 제거하기 위해 출력을 줄이고 `Endpoint.Port` 및 `Endpoint.Address`를 지정하여 쿼리를 수정할 수 있습니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
Windows의 경우:
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
[
[
"sample-cluster-instance",
27017,
"sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com"
]
]
```
인스턴스 엔드포인트가 있으므로 이제 `mongo` 또는 `mongodb`를 사용하여 인스턴스에 연결할 수 있습니다. 자세한 내용은 [엔드포인트에 연결](endpoints-connecting.md) 섹션을 참조하세요.
------
# 엔드포인트에 연결
엔드포인트(클러스터 또는 인스턴스)가 있는 경우 `mongo` 쉘 또는 연결 문자열을 사용하여 엔드포인트에 연결할 수 있습니다.
## mongo 쉘을 사용하여 연결
다음 구조를 사용하면 `mongo` 쉘을 사용하여 클러스터 또는 인스턴스에 연결하는 데 필요한 문자열을 작성할 수 있습니다.
```
mongo \
--ssl \
--host Endpoint:Port \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
**`mongo` 쉘 예**
클러스터에 연결:
```
mongo \
--ssl \
--host sample-cluster.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
인스턴스에 연결:
```
mongo \
--ssl \
--host sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
## 연결 문자열을 사용하여 연결
다음 구조를 사용하면 클러스터 또는 인스턴스에 연결하는 데 필요한 연결 문자열을 작성할 수 있습니다.
```
mongodb://UserName:Password@endpoint:port?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
**연결 문자열 예**
클러스터에 연결:
```
mongodb://UserName:Password@sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
인스턴스에 연결:
```
mongodb://UserName:Password@sample-cluster-instance.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
# Amazon DocumentDB Amazon 리소스 이름(ARN) 이해
에서 생성하는 리소스 AWS 는 각각 Amazon 리소스 이름(ARN)으로 고유하게 식별됩니다. 특정 Amazon DocumentDB(MongoDB 호환) 작업의 경우 ARN을 지정하여 Amazon DocumentDB 리소스를 고유하게 식별해야 합니다. 예를 들어, 리소스에 태그를 추가할 경우 리소스의 ARN을 제공해야 합니다.
**Topics**
+ [ARN 생성](#documentdb-arns-constructing)
+ [ARN 찾기](#documentdb-arns-find)
## Amazon DocumentDB 리소스에 대한 ARN 구성
다음 구문을 사용하여 Amazon DocumentDB 리소스에 대한 ARN을 구성할 수 있습니다. Amazon DocumentDB는 Amazon Relational Database Service(Amazon RDS) ARN의 형식을 공유합니다. Amazon DocumentDB ARN에는 `rds`가 포함되지만 `docdb`는 포함되지 않습니다.
`arn:aws:rds:region:account_number:resource_type:resource_id`
| 리전 이름 | 리전 | 가용 영역(컴퓨팅) |
| --- | --- | --- |
| 미국 동부(오하이오) | `us-east-2` | 3 |
| 미국 동부(버지니아 북부) | `us-east-1` | 6 |
| 미국 서부(오리건) | `us-west-2` | 4 |
| 아프리카(케이프타운) | `af-south-1` | 3 |
| 남아메리카(상파울루) | `sa-east-1` | 3 |
| 아시아 태평양(홍콩) | `ap-east-1` | 3 |
| 아시아 태평양(하이데라바드) | `ap-south-2` | 3 |
| 아시아 태평양(말레이시아) | `ap-southeast-5` | 3 |
| 아시아 태평양(뭄바이) | `ap-south-1` | 3 |
| 아시아 태평양(오사카) | `ap-northeast-3` | 3 |
| 아시아 태평양(서울) | `ap-northeast-2` | 4 |
| 아시아 태평양(싱가포르) | `ap-southeast-1` | 3 |
| 아시아 태평양(시드니) | `ap-southeast-2` | 3 |
| 아시아 태평양(자카르타) | `ap-southeast-3` | 3 |
| 아시아 태평양(멜버른) | `ap-southeast-4` | 3 |
| 아시아 태평양(태국) | `ap-southeast-7` | 3 |
| 아시아 태평양(도쿄) | `ap-northeast-1` | 3 |
| 캐나다(중부) | `ca-central-1` | 3 |
| 중국(베이징) 리전 | `cn-north-1` | 3 |
| 중국(닝샤) | `cn-northwest-1` | 3 |
| 유럽(프랑크푸르트) | `eu-central-1` | 3 |
| 유럽(취리히) | `eu-central-2` | 3 |
| 유럽(아일랜드) | `eu-west-1` | 3 |
| 유럽(런던) | `eu-west-2` | 3 |
| 유럽(밀라노) | `eu-south-1` | 3 |
| 유럽(파리) | `eu-west-3` | 3 |
| 유럽(스페인) | `eu-south-2` | 3 |
| 유럽(스톡홀름) | `eu-north-1` | 3 |
| 멕시코(중부) | `mx-central-1` | 3 |
| 중동(UAE) | `me-central-1` | 3 |
| 이스라엘(텔아비브) | `il-central-1` | 3 |
| AWS GovCloud(미국 서부) | `us-gov-west-1` | 3 |
| AWS GovCloud(미국 동부) | `us-gov-east-1` | 3 |
**참고**
Amazon DocumentDB 아키텍처는 스토리지와 컴퓨팅을 분리합니다. 스토리지 계층의 경우 Amazon DocumentDB는 3개의 AWS 가용 영역(AZs. 위의 표에 나열된 AZ는 컴퓨팅 인스턴스 프로비저닝을 위해 특정 리전에서 사용 가능한 AZ의 수입니다. 예를 들어 ap-northeast-1에서 Amazon DocumentDB 클러스터를 시작하는 경우 스토리지는 3개의 AZ에 걸쳐 6가지 방식으로 복제되지만 컴퓨팅 인스턴스는 2개의 AZ에서만 사용할 수 있습니다.
다음 표는 특정 Amazon DocumentDB 리소스에 대한 ARN을 구성할 때 사용해야 하는 형식을 보여줍니다. Amazon DocumentDB는 Amazon RDS ARN의 형식을 공유합니다. Amazon DocumentDB ARN에는 `rds`가 포함되지만 `docdb`는 포함되지 않습니다.
| 리소스 유형 | ARN 형식/예 |
| --- | --- |
| 인스턴스(`db`) | `arn:aws:rds:region:account_number:db:resource_id` arn:aws:rds:us-east-1:1234567890:db:sample-db-instance
|
| 클러스터(`cluster`) | `arn:aws:rds:region:account_number:cluster:resource_id` arn:aws:rds:us-east-1:1234567890:cluster:sample-db-cluster
|
| 클러스터 파라미터 그룹(`cluster-pg`) | `arn:aws:rds:region:account_number:cluster-pg:resource_id` arn:aws:rds:us-east-1:1234567890:cluster-pg:sample-db-cluster-parameter-group
|
| 보안 그룹(`secgrp`) | `arn:aws:rds:region:account_number:secgrp:resource_id` arn:aws:rds:us-east-1:1234567890:secgrp:sample-public-secgrp
|
| 클러스터 스냅샷(`cluster-snapshot`) | `arn:aws:rds:region:account_number:cluster-snapshot:resource_id` arn:aws:rds:us-east-1:1234567890:cluster-snapshot:sample-db-cluster-snapshot
|
| 서브넷 그룹(`subgrp`) | `arn:aws:rds:region:account_number:subgrp:resource_id` arn:aws:rds:us-east-1:1234567890:subgrp:sample-subnet-10
|
## Amazon DocumentDB 리소스 ARN 찾기
AWS Management Console 또는를 사용하여 Amazon DocumentDB 리소스의 ARN을 찾을 수 있습니다 AWS CLI.
------
#### [ Using the AWS Management Console ]
콘솔을 사용해 ARN을 찾으려면 ARN을 보려는 리소스를 탐색하여 해당 리소스의 세부 정보를 확인합니다.
예를 들어, 클러스터 세부 정보 페이지의 **구성** 탭을 선택하여 클러스터의 ARN을 가져올 수 있습니다. 다음 스크린샷과 같이 **구성 및 상태** 섹션에서 ARN을 찾을 수 있습니다.
![\[세부 정보 창의 구성 및 상태 섹션에 있는 ARN을 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/documentdb-arn.png)
------
#### [ Using the AWS CLI ]
특정 Amazon DocumentDB 리소스에 AWS CLI 대해를 사용하여 ARN을 가져오려면 해당 리소스에 대한 `describe` 작업을 사용합니다. 다음 표에는 각 AWS CLI 작업과 작업과 함께 사용하여 ARN을 가져오는 ARN 속성이 나와 있습니다.
| AWS CLI 명령 | ARN 속성 |
| --- | --- |
| `describe-db-instances` | `DBInstanceArn` |
| `describe-db-clusters` | `DBClusterArn` |
| `describe-db-parameter-groups` | `DBParameterGroupArn` |
| `describe-db-cluster-parameter-groups` | `DBClusterParameterGroupArn` |
| `describe-db-security-groups` | `DBSecurityGroupArn` |
| `describe-db-snapshots` | `DBSnapshotArn` |
| `describe-db-cluster-snapshots` | `DBClusterSnapshotArn` |
| `describe-db-subnet-groups` | `DBSubnetGroupArn` |
**Example - 클러스터의 ARN 찾기**
다음 AWS CLI 작업은 클러스터의 ARN을 찾습니다`sample-cluster`.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].DBClusterArn'
```
Windows의 경우:
```
aws docdb describe-db-clusters ^
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].DBClusterArn'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
[
"arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster"
]
```
**Example - 여러 파라미터 그룹의 ARN 찾기**
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn'
```
Windows의 경우:
```
aws docdb describe-db-cluster-parameter-groups ^
--query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
[
"arn:aws:rds:us-east-1:123456789012:cluster-pg:custom3-6-param-grp",
"arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora5.6",
"arn:aws:rds:us-east-1:123456789012:cluster-pg:default.docdb3.6"
]
```
------
# Amazon DocumentDB 리소스 태그 지정
Amazon DocumentDB(MongoDB 호환) 태그를 사용하여 Amazon DocumentDB 리소스에 메타데이터를 추가할 수 있습니다. 이러한 태그는 AWS Identity and Access Management(IAM) 정책과 함께 사용하여 Amazon DocumentDB 리소스에 대한 액세스를 관리하고 리소스에 적용할 수 있는 작업을 제어할 수 있습니다. 또한 비슷하게 태그가 지정된 리소스에 대한 비용을 그룹화하여 이러한 태그로 비용을 추적할 수 있습니다.
다음 Amazon DocumentDB 리소스에 태그를 지정할 수 있습니다.
+ 클러스터
+ 인스턴스
+ 스냅샷
+ 클러스터 스냅샷
+ 파라미터 그룹
+ 클러스터 파라미터 그룹
+ 보안 그룹
+ 서브넷 그룹
## Amazon DocumentDB 리소스 태그 개요
Amazon DocumentDB 태그는 Amazon DocumentDB 리소스를 정의하고 연결하는 이름-값 페어입니다. 이 이름을 *키*라고 합니다. 키 값을 제공하는 것은 선택 사항입니다. 태그를 사용하여 임의의 정보를 Amazon DocumentDB 리소스에 할당할 수 있습니다. 범주 정의 등에 태그 키를 사용할 수 있으며 태그 값은 해당 범주의 항목일 수 있습니다. 예를 들어, 태그 키를 `project`로 정의하고 태그 값을 `Salix`로 정의할 수 있는데, 이는 Amazon DocumentDB 리소스가 Salix 프로젝트에 할당되었음을 나타냅니다. 태그를 사용하여 `environment=test` 또는 `environment=production`와 같은 키를 사용해 Amazon DocumentDB 리소스를 테스트나 생산에 사용되도록 지정할 수도 있습니다. 일관된 태그 키 세트를 사용하여 Amazon DocumentDB 리소스와 연관된 메타데이터를 보다 쉽게 추적하는 것이 좋습니다.
또한 태그를 사용하여 비용 구조를 반영하도록 AWS 청구서를 구성할 수 있습니다. 이렇게 하려면 가입하여 태그 키 값이 포함된 AWS 계정 청구서를 가져옵니다. 그런 다음 같은 태그 키 값을 가진 리소스에 따라 결제 정보를 구성하여 리소스 비용의 합을 볼 수 있습니다. 예를 들어, 특정 애플리케이션 이름으로 여러 리소스에 태그를 지정한 다음 결제 정보를 구성하여 여러 서비스에 걸친 해당 애플리케이션의 총 비용을 볼 수 있습니다. 자세한 내용은 *AWS 청구 및 비용 관리 사용 설명서*의 [비용 할당 태그 사용](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)을 참조하십시오.
각 Amazon DocumentDB 리소스에는 해당 리소스에 할당된 모든 태그가 포함된 태그 세트가 있습니다. 태그 세트는 최대 10개의 태그를 포함하거나 비어 있을 수 있습니다. 리소스의 기존 태그와 동일한 키를 가진 Amazon DocumentDB 리소스에 태그를 추가하면 새 값이 이전 값을 덮어씁니다.
AWS는 태그에 의미론적 의미를 적용하지 않으며 태그는 엄격히 문자열로 해석됩니다. Amazon DocumentDB는 리소스를 생성할 때 사용하는 설정에 따라 인스턴스 또는 다른 Amazon DocumentDB 리소스에 태그를 설정할 수 있습니다. 예를 들어, Amazon DocumentDB는 인스턴스가 생산용 또는 테스트용임을 나타내는 태그를 추가할 수 있습니다.
스냅샷에 태그를 추가할 수 있지만 이 그룹화는 청구서에 반영되지 않습니다.
AWS Management Console 또는 AWS CLI를 사용하여 Amazon DocumentDB 리소스에 태그를 추가, 나열 및 삭제할 수 있습니다. AWS CLI를 사용할 때는 작업하려는 리소스에 대한 Amazon 리소스 이름(ARN)을 제공해야 합니다. Amazon DocumentDB ARN에 대한 자세한 내용은 [Amazon DocumentDB Amazon 리소스 이름(ARN) 이해](documentdb-arns.md) 섹션을 참조하십시오.
## 태그 제약 조건
Amazon DocumentDB 태그에는 다음 제약 조건이 적용됩니다.
+ 리소스당 최대 태그 수 - 10개
+ 최대 **키** 길이 - 유니코드 128자
+ 최대 **값** 길이 - 유니코드 256자
+ **키** 및 **값**에 유효한 문자 - UTF-8 문자 세트의 대문자와 소문자, 숫자, 공백 및 `_ . : / = + -`와 `@` 문자(Java regex: `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`)
+ 태그 키와 값은 대소문자를 구분합니다.
+ 태그 키 또는 값에 `aws:` 접두사는 사용할 수 없습니다. 이 접두사는 AWS 전용입니다.
## Amazon DocumentDB 리소스의 태그 추가 및 업데이트
AWS Management Console 또는 AWS CLI를 사용하여 리소스에 최대 10개의 태그를 추가할 수 있습니다.
------
#### [ Using the AWS Management Console ]
리소스에 태그를 추가하는 프로세스는 태그를 추가하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에 태그를 추가합니다.
**콘솔을 사용하여 클러스터에 태그를 추가하거나 업데이트하려면 다음을 수행합니다.**
1. AWS Management Console에 로그인하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)에서 Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
1. 태그를 추가할 클러스터 이름을 선택합니다.
1. **태그** 섹션으로 스크롤을 내린 다음 **편집**을 선택합니다.
1. 이 리소스에 추가할 각 태그에 대해 다음을 수행합니다.
1. 새 태그를 추가하려면 **키** 상자의 태그 이름에 입력합니다. 태그 값을 변경하려면 **키** 열에서 태그 이름을 찾습니다.
1. 태그에 새 값 또는 업데이트된 값을 제공하려면 **값** 상자에 태그에 대한 값을 입력합니다.
1. 태그를 더 추가하려는 경우 **추가**를 선택합니다. 추가하지 않고 완료하려면 **저장**을 선택합니다.
------
#### [ Using the AWS CLI ]
리소스에 태그를 추가하는 프로세스는 태그를 추가하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에 세 개의 태그를 추가합니다. 두 번째 태그인 `key2`에는 값이 없습니다.
이러한 파라미터와 함께 AWS CLI 작업 `add-tags-to-resource`를 사용합니다.
**파라미터**
+ **--resource-name** - 태그를 추가할 Amazon DocumentDB 리소스의 ARN입니다.
+ **--tags** - 이 리소스에 추가할 태그(키-값 페어)를 `Key=key-name,Value=tag-value` 형식으로 나열합니다.
**Example**
Linux, macOS, Unix의 경우:
```
aws docdb add-tags-to-resource \
--resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
--tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3
```
Windows의 경우:
```
aws docdb add-tags-to-resource ^
--resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
--tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3
```
`add-tags-to-resource` 작업은 출력을 생성하지 않습니다. 작업 결과를 보려면 `list-tags-for-resource` 작업을 사용합니다.
------
## Amazon DocumentDB 리소스에 태그 나열
AWS Management Console 또는 AWS CLI를 사용하여 Amazon DocumentDB 리소스에 대한 태그 목록을 가져올 수 있습니다.
------
#### [ Using the AWS Management Console ]
리소스에서 태그를 나열하는 프로세스는 태그를 추가하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에 태그를 나열합니다.
**콘솔을 사용하여 클러스터에서 태그를 나열하려면**
1. [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)에서 Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
1. 태그를 나열할 클러스터 이름을 선택합니다.
1. 이 리소스의 태그 목록을 보려면 아래로 스크롤하여 **태그** 섹션으로 이동합니다.
------
#### [ Using the AWS CLI ]
리소스에서 태그를 나열하는 프로세스는 태그를 나열하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에 태그를 나열합니다.
이러한 파라미터와 함께 AWS CLI 작업 `list-tags-for-resource`를 사용합니다.
**파라미터**
+ **--resource-name** - 필수입니다. 태그를 나열할 Amazon DocumentDB 리소스의 ARN입니다.
**Example**
Linux, macOS, Unix의 경우:
```
aws docdb list-tags-for-resource \
--resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster
```
Windows의 경우:
```
aws docdb list-tags-for-resource ^
--resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"TagList": [
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": ""
},
{
"Key": "key3",
"Value": "value3"
}
]
}
```
------
## Amazon DocumentDB 리소스에서 태그 제거
AWS Management Console 또는 AWS CLI를 사용하여 Amazon DocumentDB 리소스에서 태그를 제거할 수 있습니다.
------
#### [ Using the AWS Management Console ]
리소스에서 태그를 제거하는 프로세스는 태그를 추가하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에서 태그를 제거합니다.
**콘솔을 사용하여 클러스터에서 태그를 제거하려면**
1. [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)에서 Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
1. 태그를 제거할 클러스터 이름을 선택합니다.
1. **태그** 섹션으로 스크롤을 내린 다음 **편집**을 선택합니다.
1. 이 리소스에서 모든 태그를 제거하려면 **모두 제거**를 선택합니다. 그렇지 않으면, 이 리소스에서 제거할 각 태그에 대해 다음을 수행합니다.
1. **키** 열에서 태그 이름을 찾습니다.
1. 태그 키와 동일한 행에서 **제거**를 선택합니다.
1. 완료하였으면 **저장**을 선택합니다.
------
#### [ Using the AWS CLI ]
리소스에서 태그를 제거하는 프로세스는 태그를 제거하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에서 태그를 제거합니다.
이러한 파라미터와 함께 AWS CLI 작업 `remove-tags-from-resource`를 사용합니다.
+ **--resource-name** - 필수입니다. 태그를 제거할 Amazon DocumentDB 리소스의 ARN입니다.
+ **--tag-keys** - 필수입니다. 이 리소스에서 제거할 태그 키의 목록입니다.
**Example**
Linux, macOS, Unix의 경우:
```
aws docdb remove-tags-from-resource \
--resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
--tag-keys key1 key3
```
Windows의 경우:
```
aws docdb remove-tags-from-resource ^
--resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
--tag-keys key1 key3
```
`removed-tags-from-resource` 작업은 출력을 생성하지 않습니다. 작업 결과를 보려면 `list-tags-for-resource` 작업을 사용합니다.
------
# Amazon DocumentDB 유지 관리
Amazon DocumentDB는 Amazon DocumentDB 리소스를 정기적으로 유지 관리합니다. 이러한 유지 관리에는 대개 데이터베이스 엔진(클러스터 유지 관리) 또는 인스턴스의 기본 운영 체제(OS)(인스턴스 유지 관리)에 대한 업데이트가 포함됩니다. 데이터베이스 엔진 업데이트는 필수 패치이며 데이터베이스 엔진에 대한 보안 수정, 버그 수정 및 개선 사항을 포함합니다. 대부분의 운영 체제 패치는 선택 사항이지만 한동안 패치를 적용하지 않으면 보안 태세를 유지하기 위해 패치가 필요할 수 있고 자동으로 적용될 수 있습니다. 따라서 운영 체제 업데이트는 사용 가능한 즉시 Amazon DocumentDB 인스턴스에 적용하는 것이 좋습니다.
데이터베이스 엔진 패치를 사용하려면 Amazon DocumentDB 클러스터를 잠시 오프라인으로 전환해야 합니다. 사용 가능하게 되면 Amazon DocumentDB 클러스터의 예정된 유지 관리 기간 동안 이러한 패치가 자동으로 적용되도록 예약됩니다.
클러스터 및 인스턴스 유지 관리 모두 해당 유지 관리 기간이 있습니다. 즉시 적용되지 않도록 선택한 클러스터 및 인스턴스 수정 사항은 유지 관리 기간에도 또한 적용됩니다. 기본적으로 클러스터를 생성할 때 Amazon DocumentDB가 클러스터 및 각 개별 인스턴스에 대해 유지 관리 기간을 지정합니다. 클러스터 또는 인스턴스를 생성할 때 유지 관리 기간을 선택할 수 있습니다. 또한 언제라도 비즈니스 일정 또는 절차에 맞춰 유지 관리 기간을 수정할 수 있습니다. 일반적으로 애플리케이션에 대 유지 관리의 영향을 최소화하는 유지 관리 기간을 서택하는 것이 좋습니다(예: 야간 또는 주말).
**Topics**
+ [Amazon DocumentDB 엔진 패치에 대한 알림](#patch-notifications)
+ [보류 중인 Amazon DocumentDB 유지 관리 작업 보기](#view-pending-maintenance)
+ [Amazon DocumentDB 엔진 업데이트](#db-instance-updates-apply)
+ [사용자 시작 업데이트](#user-initiated-updates)
+ [Amazon DocumentDB 유지 관리 기간 관리](#maintenance-window)
+ [Amazon DocumentDB 운영 체제 업데이트](#os-system-updates)
## Amazon DocumentDB 엔진 패치에 대한 알림
AWS 콘솔의 Health Dashboard (AHD)에서 상태 이벤트와 이메일을 통해 필요한 데이터베이스 엔진 패치에 대한 유지 관리 알림을 받게 됩니다. 특정 AWS 리전에서 Amazon DocumentDB 엔진 유지 관리 패치를 사용할 수 있게 되면 해당 리전의 영향을 받는 모든 Amazon DocumentDB 사용자 계정에 패치의 영향을 받는 각 Amazon DocumentDB 버전에 대한 AHD 및 이메일 알림이 전송됩니다. AWS 콘솔에서 AHD의 **예약된 변경** 사항 섹션에서 이러한 알림을 볼 수 있습니다. 알림에는 패치 가용성 타이밍, 자동 적용 일정, 영향을 받는 클러스터 목록 및 릴리스 정보에 대한 세부 정보가 포함됩니다. 이 알림은 이메일을 통해 AWS 계정의 루트 사용자 이메일 주소로도 전송됩니다.
![\[엔진 패치 업그레이드에 대한 예약 변경 탭을 보여주는 Amazon DocumentDB 콘솔입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/scheduled-changes.png)
이 알림을 받으면 예약된 자동 적용 날짜 이전에 이러한 엔진 패치를 Amazon DocumentDB 클러스터에 자체 적용하도록 선택할 수 있습니다. 또는 예정된 유지 관리 기간 동안 엔진 패치가 자동으로 적용될 때까지 기다릴 수 있습니다(기본 옵션).
**참고**
새 엔진 패치 버전이 있는 새 Amazon DocumentDB 엔진 패치가 릴리스될 때까지 AHD의 알림 **상태**가 '진행 중'으로 설정됩니다.
Amazon DocumentDB 클러스터에 엔진 패치가 적용되면 클러스터의 엔진 패치 버전이 업데이트되어 알림의 버전을 반영합니다. `db.runCommand({getEngineVersion: 1})` 명령을 실행하여 이 업데이트를 확인할 수 있습니다.
AWS Health 또한는 이벤트를 사용하여 확장 가능한 이벤트 기반 애플리케이션을 빌드하는 Amazon EventBridge와 통합되며 AWS Lambda Amazon Simple Queue Service(SQS) 등을 포함한 20개 이상의 대상과 통합됩니다. 엔진 패치를 사용할 수 있게 되기 전에 `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED` 이벤트 코드를 사용하여 Amazon EventBridge를 설정할 수 있습니다. 이벤트 정보에 응답하고 이벤트 정보 캡처, 추가 이벤트 시작,에 대한 푸시 알림과 같은 추가 채널을 통한 알림 전송 AWS Console Mobile Application, 리전에서 Amazon DocumentDB 엔진 패치를 사용할 수 있게 될 때 수정 또는 기타 작업 수행과 같은 작업을 자동으로 수행하도록 EventBridge를 설정할 수 있습니다.
Amazon DocumentDB가 엔진 패치를 취소하는 드문 시나리오에서는 AHD 알림과 취소에 대해 알리는 이메일을 받게 됩니다. 따라서 `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED` 이벤트 코드를 사용하여 이 이벤트에 응답하도록 Amazon EventBridge를 설정할 수 있습니다. [Amazon EventBridge 규칙](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) 사용에 대해 자세히 알아보려면 *Amazon EventBridge 사용 설명서*를 참조하세요.
## 보류 중인 Amazon DocumentDB 유지 관리 작업 보기
AWS Management Console 또는를 사용하여 클러스터에서 유지 관리 업데이트를 사용할 수 있는지 확인할 수 있습니다 AWS CLI.
업데이트가 있을 경우에는 다음 중 한 가지를 선택할 수 있습니다.
+ 현재 다음 유지 관리 기간에 예약된 유지 관리 작업을 연기합니다(OS 패치만 해당).
+ 유지 관리 작업을 즉시 적용합니다.
+ 다음 유지 관리 기간 중 시작할 유지 관리 작업을 예약합니다.
**참고**
조치를 취하지 않으면 엔진 패치와 같은 필수 유지 관리 조치가 예정된 유지 관리 기간에 자동으로 적용됩니다.
유지 관리 기간에 따라 대기 중인 작업의 시작 시기가 결정되지만 이러한 작업의 전체 실행 시간이 제한되지는 않습니다.
------
#### [ Using the AWS Management Console ]
1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
1. 업데이트가 있는 경우 다음과 같이 Amazon DocumentDB 콘솔의 클러스터에 대한 **유지 관리** 열에 **사용 가능**, **필수** 또는 **다음 창**의 단어로 표시됩니다.
![\[클러스터에 대한 유지 관리 열을 보여주는 Amazon DocumentDB 콘솔\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cluster-maintenance-updates-status.png)
1. 조치를 취하려면 클러스터를 선택하여 세부 정보를 표시한 후 **유지 관리 및 백업**을 선택하십시오. 그러면 **대기 중인 유지 관리** 항목이 표시됩니다.
![\[클러스터 유지 관리 창을 보여주는 Amazon DocumentDB 콘솔\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/cluster-maint-3.png)
------
#### [ Using the AWS CLI ]
다음 AWS CLI 작업을 사용하여 보류 중인 유지 관리 작업을 확인합니다. 출력에는 대기 중인 유지 관리 작업이 없습니다.
```
aws docdb describe-pending-maintenance-actions
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"PendingMaintenanceActions": []
}
```
------
## Amazon DocumentDB 엔진 업데이트
Amazon DocumentDB를 사용하여 유지 관리 작업을 적용하는 시기를 선택할 수 있습니다. AWS Management Console 또는를 사용하여 Amazon DocumentDB가 업데이트를 적용하는 시기를 결정할 수 있습니다 AWS CLI.
이번 주제에서 설명하는 절차에 따라 클러스터를 즉시 업그레이드하거나, 업드레이드 일정을 예약합니다.
------
#### [ 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. 탐색 창에서 **클러스터**를 선택합니다.
1. 클러스터 목록에서 유지 관리 작업을 적용할 클러스터의 이름 옆에 있는 버튼을 선택합니다.
1. **작업** 메뉴에서 다음 중 하나를 선택합니다.
+ **지금 업그레이드**: 대기 중인 유지 관리 작업을 즉시 수행합니다.
+ **다음에 업그레이드**: 클러스터의 다음 유지 관리 기간 중에 대기 중인 유지 관리 작업을 수행합니다.
또는 클러스터의 **유지 관리 및 백업** 탭의 대기 중인 유지 관리 섹션에서 **지금 적용** 또는 **다음 유지 관리 기간에 적용**을 클릭할 수 있습니다(이전 섹션의 ** AWS Management Console사용** 참조).
**참고**
대기 중인 유지 관리 작업이 없는 경우 위의 두 옵션이 모두 비활성화됩니다.
------
#### [ Using the AWS CLI ]
보류 중인 업데이트를 클러스터에 적용하려면 `apply-pending-maintenance-action` AWS CLI 작업을 사용합니다.
**파라미터**
+ **--resource-identifier** - 대기 중인 유지 관리 작업이 적용되는 Amazon DocumentDB Amazon 리소스 이름(ARN)입니다.
+ **--apply-action** - 이 리소스에 적용할 대기 중인 유지 관리 작업입니다.
유효한 값: `system-update` 및 `db-upgrade`
+ **--opt-in-type** - 옵트인 요청의 유형을 지정하거나 옵트인 요청을 실행 취소하는 값입니다. `immediate` 유형의 옵트인 요청은 실행 취소할 수 없습니다.
유효한 값:
+ `immediate` - 유지 관리 작업을 즉시 적용합니다.
+ `next-maintenance` - 리소스에 대한 다음 유지 관리 기간 중에 유지 관리 작업을 적용합니다.
+ `undo-opt-in` - 기존 `next-maintenance` 옵트인 요청을 취소합니다.
**Example**
Linux, macOS, Unix의 경우:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb \
--apply-action system-update \
--opt-in-type immediate
```
Windows의 경우:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb ^
--apply-action system-update ^
--opt-in-type immediate
```
보류 중인 업데이트가 하나 이상 있는 리소스 목록을 반환하려면 `describe-pending-maintenance-actions` AWS CLI 명령을 사용합니다.
**Example**
Linux, macOS, Unix의 경우:
```
aws docdb describe-pending-maintenance-actions \
--resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb
```
Windows의 경우:
```
aws docdb describe-pending-maintenance-actions ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:sample-cluster",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"CurrentApplyDate": "2019-01-11T03:01:00Z",
"Description": "db-version-upgrade",
"ForcedApplyDate": "2019-01-18T03:01:00Z",
"AutoAppliedAfterDate": "2019-01-11T03:01:00Z"
}
]
}
]
}
```
`describe-pending-maintenance-actions` AWS CLI 작업의 `--filters` 파라미터를 지정하여 클러스터의 리소스 목록을 반환할 수도 있습니다. `--filters` 작업의 형식은 `Name=filter-name,Values=resource-id,...`입니다.
필터의 `Name` 파라미터에 대해 허용되는 값은 `db-cluster-id`입니다. 이 값은 클러스터 식별자 또는 ARN 목록을 허용합니다. 반환되는 목록에는 이러한 식별자 또는 ARN으로 식별된 클러스터에 대해 보류 중인 유지 관리 작업만 포함됩니다.
다음 예에서는 `sample-cluster1` 및 `sample-cluster2` 클러스터에 대해 보류 중인 유지 관리 작업을 반환합니다.
**Example**
Linux, macOS, Unix의 경우:
```
aws docdb describe-pending-maintenance-actions \
--filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2
```
Windows의 경우:
```
aws docdb describe-pending-maintenance-actions ^
--filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2
```
------
### 적용 날짜
각 유지 관리 작업에는 대기 중인 유지 관리 작업을 설명할 때 찾을 수 있는 적용 날짜가 있습니다. 에서 보류 중인 유지 관리 작업의 출력을 읽으면 AWS CLI세 가지 날짜가 나열됩니다. 유지 관리가 선택 사항인 경우 이러한 날짜 값은 `null`입니다. 해당 유지 관리 작업이 예약되거나 적용되면 값이 채워집니다.
+ **CurrentApplyDate** - 유지 관리 작업이 즉시 또는 다음 유지 관리 기간에 적용되는 날짜입니다.
+ **ForcedApplyDate** - 유지 관리가 사용자의 유지 관리 기간과 상관없이 자동으로 적용되는 날짜입니다.
+ **AutoAppliedAfterDate** - 유지 관리가 클러스터의 유지 관리 기간 동안 이 날짜 이후에 적용됩니다.
## 사용자 시작 업데이트
Amazon DocumentDB 사용자가 클러스터 또는 인스턴스에 대한 업데이트를 시작할 수 있습니다. 예를 들어 사용자가 인스턴스의 클래스를 메모리 용량이 다른 클래스로 수정하거나 클러스터의 파라미터 그룹을 수정할 수 있습니다. Amazon DocumentDB는 이러한 변경 사항을 Amazon DocumentDB에서 시작한 업데이트와 다르게 봅니다. 클러스터 또는 인스턴스 수정에 대한 자세한 정보는 다음 단원 중 하나를 참조하십시오.
+ [Amazon DocumentDB 클러스터 수정](db-cluster-modify.md)
+ [Amazon DocumentDB 인스턴스 수정](db-instance-modify.md)
대기 중인 사용자 시작 변경 사항의 목록을 보려면 다음 명령을 실행합니다.
**Example**
**인스턴스에서 대기 중인 사용자 시작 변경 사항을 보려면**
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'
```
Windows의 경우:
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
이 경우, `sample-cluster-instance`는 `db.r5.xlarge` 인스턴스 클래스에 대기 중인 변경 사항이 있고, `sample-cluster-instance-2`는 대기 중인 변경 사항이 없습니다.
```
[
[
"sample-cluster",
"sample-cluster-instance",
{
"DBInstanceClass": "db.r5.xlarge"
}
],
[
"sample-cluster",
"sample-cluster-instance-2",
{}
]
]
```
## Amazon DocumentDB 유지 관리 기간 관리
각 인스턴스 및 클러스터에는 대기 중인 변경 사항이 적용되는 주 단위 유지 관리 기간이 있습니다. 유지 관리 기간은 요청 또는 필요에 따라 수정하거나 소프트웨어 패치를 적용하는 시기를 조정할 수 있는 기간입니다. 유지 관리 이벤트가 특정 주에 예정되어 있는 경우 사용자가 지정하는 30분의 유지 관리 기간 중에 해당 이벤트가 시작됩니다. 또한 대부분의 유지 관리 이벤트가 30분의 유지 관리 기간 중에 완료됩니다. 단, 대규모 유지 관리 이벤트는 완료하는 데 30분이 넘게 걸릴 수 있습니다.
리전별로 8시간 블록 시간 중에서 30분 유지 관리 기간이 임의로 선택됩니다. 인스턴스 또는 클러스터를 생성할 때 기본 유지 관리 기간을 지정하지 않으면 Amazon DocumentDB에서 임의로 선택한 요일에 30분 유지 관리 기간을 배정합니다.
다음 표는 기본 유지 관리 기간을 할당하는 각 리전의 시간 블록 목록입니다.
| 리전 이름 | 리전 | UTC 시간 블록 |
| --- | --- | --- |
| 미국 동부(오하이오) | us-east-2 | 03:00\$111:00 |
| 미국 동부(버지니아 북부) | us-east-1 | 03:00\$111:00 |
| 미국 서부(오리건) | us-west-2 | 06:00\$114:00 |
| Africa (Cape Town) | af-south-1 | 03:00\$111:00 |
| Asia Pacific (Hong Kong) | ap-east-1 | 06:00\$114:00 |
| 아시아 태평양(하이데라바드) | ap-south-2 | 06:30-14:30 |
| 아시아 태평양(말레이시아) | ap-southeast-5 | 13:00\$121:00 |
| 아시아 태평양(뭄바이) | ap-south-1 | 06:00\$114:00 |
| 아시아 태평양(오사카) | ap-northeast-3 | 12:00–20:00 |
| 아시아 태평양(서울) | ap-northeast-2 | 13:00\$121:00 |
| 아시아 태평양(싱가포르) | ap-southeast-1 | 14:00–22:00 |
| 아시아 태평양(시드니) | ap-southeast-2 | 12:00–20:00 |
| 아시아 태평양(자카르타) | ap-southeast-3 | 08:00\$116:00 |
| 아시아 태평양(멜버른) | ap-southeast-4 | 11:00\$119:00 |
| 아시아 태평양(태국) | ap-southeast-7 | 15:00\$123:00 |
| 아시아 태평양(도쿄) | ap-northeast-1 | 13:00\$121:00 |
| 캐나다(중부) | ca-central-1 | 03:00\$111:00 |
| 중국(베이징) | cn-north-1 | 06:00\$114:00 |
| 중국(닝샤) | cn-northwest-1 | 06:00\$114:00 |
| 유럽(프랑크푸르트) | eu-central-1 | 21:00\$105:00 |
| 유럽(취리히) | eu-central-2 | 02:00\$110:00 |
| 유럽(아일랜드) | eu-west-1 | 22:00\$106:00 |
| Europe (London) | eu-west-2 | 22:00\$106:00 |
| Europe (Milan) | eu-south-1 | 02:00\$110:00 |
| 유럽(파리) | eu-west-3 | 23:59\$107:29 |
| 유럽(스페인) | eu-south-2 | 02:00\$110:00 |
| 유럽(스톡홀름) | eu-north-1 | 04:00\$112:00 |
| 멕시코(중부) | mx-central-1 | 03:00\$111:00 |
| 중동(UAE) | me-central-1 | 05:00\$113:00 |
| 남아메리카(상파울루) | sa-east-1 | 00:00\$108:00 |
| 이스라엘(텔아비브) | il-central-1 | 04:00-12:00 |
| AWS GovCloud(미국 동부) | us-gov-east-1 | 17:00–01:00 |
| AWS GovCloud(미국 서부) | us-gov-west-1 | 06:00\$114:00 |
### Amazon DocumentDB 유지 관리 윈도우 변경
유지 관리 기간은 사용률이 가장 낮은 시간에 할당되어야 하므로 수시로 변경되어야 할 수 있습니다. 시스템 변경 사항(스토리지 조정 작업 또는 인스턴스 클래스 변경 등)을 적용 중이고 가동 중단이 필요한 경우에만 인 이 기간 동안 클러스터 또는 인스턴스를 사용할 수 없습니다. 그런 다음 필수 변경 사항을 적용하는 데 필요한 최소 시간 동안만 사용이 불가능합니다.
데이터베이스 엔진 업그레이드를 위해 Amazon DocumentDB는 개별 인스턴스가 아닌 클러스터에 대한 기본 유지 관리 기간을 사용합니다.
**유지 관리 기간 변경하기**
+ 클러스터: [Amazon DocumentDB 클러스터 수정](db-cluster-modify.md) 단원을 참조하십시오.
+ 인스턴스: [Amazon DocumentDB 인스턴스 수정](db-instance-modify.md) 단원을 참조하십시오.
## Amazon DocumentDB 운영 체제 업데이트
Amazon DocumentDB 클러스터의 인스턴스에는 때때로 운영 체제 업데이트가 필요합니다. Amazon DocumentDB는 운영 체제를 최신 버전으로 업그레이드하여 데이터베이스 성능과 고객의 전반적인 보안 태세를 개선합니다. 운영 체제 업데이트는 Amazon DocumentDB 인스턴스의 클러스터 엔진 버전이나 인스턴스 클래스를 변경하지 않습니다.
클러스터의 가용성을 최대화하기 위해서 클러스터의 리더 인스턴스를 먼저 업데이트한 다음 라이터 인스턴스를 업데이트하는 것이 좋습니다. 장애 조치 시 다운타임이 발생할 수 있으므로 리더 인스턴스와 라이터 인스턴스를 동시에 업데이트하지 않는 것이 좋습니다.
Amazon DocumentDB에 대한 대부분의 운영 체제 업데이트는 선택 사항이며 이를 적용할 설정된 날짜가 없습니다. 그러나 한동안 이러한 업데이트를 적용하지 않으면 결국 인스턴스의 유지 관리 기간 동안 업데이트가 필요해지고 자동으로 적용될 수 있습니다. 이는 데이터베이스의 보안 태세를 유지하는 데 도움이 됩니다. 예기치 않은 가동 중지 시간을 방지하려면 Amazon DocumentDB 인스턴스를 사용할 수 있게 되는 즉시 운영 체제 업데이트를 적용하고 비즈니스 요구 사항에 따라 편한 시간에 인스턴스 유지 관리 기간을 설정하는 것이 좋습니다.
새로운 선택적 업데이트가 제공될 때 알림을 받으려면 보안 패치 이벤트 범주에서 RDS-EVENT-0230 구독을 신청하면 됩니다. Amazon DocumentDB 이벤트 구독에 대한 자세한 내용은 [Amazon DocumentDB 이벤트 구독](https://docs.aws.amazon.com/documentdb/latest/developerguide/event-subscriptions.subscribe.html)을 참조하십시오.
클러스터나 인스턴스 유지 관리 수행 시에는 해당 인스턴스가 기본 인스턴스일 경우 장애 조치를 실시합니다. 가용성을 높이려면 Amazon DocumentDB 클러스터에 두 개 이상의 인스턴스를 사용하는 것이 좋습니다. 자세한 내용은 [Amazon DocumentDB 장애 조치](failover.md) 단원을 참조하십시오.
**참고**
일부 관리 기능의 경우 Amazon DocumentDB는 Amazon Relational Database Service(RDS)와 공유되는 운영 기술을 사용합니다.
**중요**
Amazon DocumentDB 인스턴스는 운영 체제 업그레이드 중에 오프라인 상태가 됩니다. 다중 인스턴스 클러스터를 사용하여 클러스터 가동 중지 시간을 최소화할 수 있습니다. 다중 인스턴스 클러스터가 없는 경우 이 유지 관리를 수행하기 위해 보조 인스턴스를 추가한 다음 유지 관리가 완료되면 추가 리더 인스턴스를 삭제하여 임시로 생성하도록 선택할 수 있습니다(보조 인스턴스에 대한 정규 요금이 적용됩니다).
**참고**
여러 규정 준수 의무를 충족하려면 모든 선택 및 필수 업데이트를 적용하여 최신 상태를 유지해야 할 수 있습니다. 유지 관리 기간 동안 Amazon DocumentDB에서 제공하는 모든 업데이트를 정기적으로 적용하는 것이 좋습니다.
AWS Management Console 또는를 사용하여 업데이트를 사용할 수 있는지 AWS CLI 확인할 수 있습니다.
------
#### [ 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. 탐색 창에서 **클러스터**를 선택한 후 해당 인스턴스를 선택합니다.
1. **유지 관리**를 선택합니다.
1. **대기 중인 유지 관리** 섹션에서 운영 체제 업데이트를 찾습니다.
![\[클러스터에 대한 유지 관리 열을 보여주는 Amazon DocumentDB 콘솔\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/maintenance-available-1.png)
운영 체제 업데이트를 선택하고 **대기 중 유지 관리** 섹션에서 **지금 적용** 또는 **다음 유지 관리 창에 적용**을 클릭할 수 있습니다. 유지 관리 값이 **다음 창**인 경우 작업에서 **Defer 업그레이드**를 선택하여 유지 관리 항목을 보류하십시오. 유지 관리 작업이 이미 시작된 경우에는 보류할 수 없습니다.
또는 탐색 창에서 **클러스터**를 클릭하여 클러스터 목록에서 인스턴스를 선택하고 **작업** 메뉴에서 **지금 적용** 또는 **다음 유지 관리 기간에 적용**을 선택할 수 있습니다.
------
#### [ Using the AWS CLI ]
를 사용하여 업데이트를 사용할 수 있는지 확인하려면 `describe-pending-maintenance-actions` 명령을 AWS CLI호출합니다.
```
aws docdb describe-pending-maintenance-actions
```
```
{
"ResourceIdentifier": "arn:aws:docdb:us-east-1:123456789012:db:mydb2",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"Description": "New Operating System update is available"
}
]
}
```
------
운영 체제 업데이트는 Amazon DocumentDB 엔진 버전 및 인스턴스 클래스에 따라 다릅니다. 따라서 Amazon DocumentDB 인스턴스는 서로 다른 시점에 업데이트를 받거나 이를 요구합니다. 엔진 버전 및 인스턴스 클래스에 따라 인스턴스에 운영 체제 업데이트가 지원되는 경우 업데이트가 콘솔에 표시됩니다. 명령을 실행 AWS CLI `describe-pending-maintenance-actions`하거나 `DescribePendingMaintenanceActions` API 작업을 호출하여 볼 수도 있습니다.
Amazon DocumentDB 엔진의 최신 클러스터 패치 릴리스를 실행하지 않는 경우 운영 체제 업데이트가 사용 가능한 유지 관리로 나열되지 않을 수 있습니다. 운영 체제 업데이트를 보고 관리하려면 먼저 최신 엔진 패치 버전으로 업그레이드해야 합니다.
# 서비스 연결 역할 이해
Amazon DocumentDB(MongoDB 호환)는 AWS Identity and Access Management (IAM) 서비스 연결 역할을 사용합니다. [서비스 연결 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)은 Amazon DocumentDB에 직접 연결된 고유한 유형의 IAM 역할입니다. 서비스 연결 역할은 Amazon DocumentDB에서 사전 정의하며 서비스가 사용자를 대신하여 다른 AWS 서비스를 호출하는 데 필요한 모든 권한을 포함합니다.
필요한 권한을 수동으로 추가할 필요가 없으므로 서비스 연결 역할은 Amazon DocumentDB를 더 쉽게 사용할 수 있습니다. Amazon DocumentDB에서 서비스 연결 역할의 권한을 정의하므로 다르게 정의되지 않은 한, Amazon DocumentDB만 해당 역할을 수임할 수 있습니다. 정의된 권한에는 신뢰 정책과 권한 정책이 포함되며 이 권한 정책은 다른 IAM 엔터티에 연결할 수 없습니다.
먼저 역할의 관련 리소스를 삭제해야만 역할을 삭제할 수 있습니다. 이렇게 하면 리소스에 대한 액세스 권한을 실수로 삭제할 수 없기 때문에 Amazon DocumentDB 리소스가 보호됩니다.
서비스 연결 역할을 지원하는 기타 서비스에 대한 자세한 내용은 [IAM으로 작업하는AWS 서비스](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)를 참조해 **서비스 연결 역할** 열이 **예(Yes)**인 서비스를 찾으세요. 해당 서비스에 대한 서비스 연결 역할 설명서를 보려면 **예(Yes)** 링크를 선택합니다.
## Amazon DocumentDB 서비스 연결 역할 권한
Amazon DocumentDB(MongoDB 호환)는 **AWSServiceRoleForRDS**라는 서비스 연결 역할을 사용하여 Amazon DocumentDB가 클러스터를 대신하여 AWS 서비스를 호출하도록 허용합니다.
AWSServiceRoleForRDS 서비스 연결 역할은 역할을 수임하기 위해 다음 서비스를 신뢰합니다.
+ `docdb.amazonaws.com`
역할 권한 정책은 Amazon DocumentDB가 지정된 리소스에서 다음 작업을 완료하도록 허용합니다.
+ `ec2`에 대한 작업:
+ `AssignPrivateIpAddresses`
+ `AuthorizeSecurityGroupIngress`
+ `CreateNetworkInterface`
+ `CreateSecurityGroup`
+ `DeleteNetworkInterface`
+ `DeleteSecurityGroup`
+ `DescribeAvailabilityZones`
+ `DescribeInternetGateways`
+ `DescribeSecurityGroups`
+ `DescribeSubnets`
+ `DescribeVpcAttribute`
+ `DescribeVpcs`
+ `ModifyNetworkInterfaceAttribute`
+ `RevokeSecurityGroupIngress`
+ `UnassignPrivateIpAddresses`
+ `sns`에 대한 작업:
+ `ListTopic`
+ `Publish`
+ `cloudwatch`에 대한 작업:
+ `PutMetricData`
+ `GetMetricData`
+ `CreateLogStream`
+ `PullLogEvents`
+ `DescribeLogStreams`
+ `CreateLogGroup`
**참고**
IAM 엔터티(사용자, 그룹, 역할 등)가 서비스 연결 역할을 생성하고 편집하거나 삭제할 수 있도록 권한을 구성할 수 있습니다. 다음과 같은 오류 메시지가 표시될 수 있습니다.
**리소스를 만들 수 없습니다. 서비스 연결 역할을 생성할 권한이 있는지 확인하십시오. 그렇지 않은 경우 기다렸다가 나중에 다시 시도하십시오.**
이러한 오류가 표시되면 다음 권한이 활성화되어 있는지 확인합니다.
```
{
"Action": "iam:CreateServiceLinkedRole",
"Effect": "Allow",
"Resource": "arn:aws:iam::*:role/aws-service-role/rds.amazonaws.com/AWSServiceRoleForRDS",
"Condition": {
"StringLike": {
"iam:AWSServiceName":"rds.amazonaws.com"
}
}
}
```
자세한 내용은 IAM 사용 설명서**의 [서비스 연결 역할 권한](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) 섹션을 참조하세요.
## Amazon DocumentDB 서비스 연결 역할 생성
서비스 연결 역할은 수동으로 생성할 필요가 없습니다. 클러스터를 생성할 때 Amazon DocumentDB에서는 서비스 연결 역할을 생성합니다.
이 서비스 연결 역할을 삭제한 다음 다시 생성해야 하는 경우 동일한 프로세스를 사용하여 계정에서 역할을 다시 생성할 수 있습니다. 클러스터를 생성할 때 Amazon DocumentDB에서는 서비스 연결 역할을 다시 생성합니다.
## Amazon DocumentDB 서비스 연결 역할 수정
Amazon DocumentDB에서는 AWSServiceRoleForRDS 서비스 연결 역할을 수정할 수 없습니다. 서비스 연결 역할을 생성한 후에는 다양한 개체가 역할을 참조할 수 있기 때문에 역할 이름을 변경할 수 없습니다. 그러나 IAM을 사용하여 역할의 설명을 수정할 수 있습니다. 자세한 내용은 *IAM 사용 설명서*의 [서비스 연결 역할 편집](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)을 참조하세요.
## Amazon DocumentDB 서비스 연결 역할 삭제
서비스 연결 역할이 필요한 기능 또는 서비스가 더 이상 필요 없는 경우에는 해당 역할을 삭제하는 것이 좋습니다. 따라서 적극적으로 모니터링하거나 유지하지 않는 미사용 엔터티가 없도록 합니다. 그러나 서비스 연결 역할을 삭제하려면 먼저 모든 클러스터를 삭제해야 합니다.
### Amazon DocumentDB 서비스 연결 역할 정리
IAM을 사용하여 서비스 연결 역할을 삭제하기 전에 먼저 역할에 활성 세션이 없는지 확인하고 역할에서 사용되는 리소스를 모두 제거해야 합니다.
**콘솔을 사용하여 서비스 연결 역할에 활성 세션이 있는지 확인하려면 다음을 수행합니다.**
1. 에 로그인 AWS Management Console 하고에서 IAM 콘솔을 엽니다[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. IAM 콘솔의 탐색 창에서 **역할**을 선택한 다음 **AWSServiceRoleForRDS** 역할의 이름(확인란 아님)을 선택합니다.
1. 선택한 역할의 **요약** 페이지에서 **Access Advisor** 탭을 선택합니다.
1. **Access Advisor** 탭에서 서비스 연결 역할의 최근 활동을 검토합니다.
**참고**
Amazon DocumentDB에서 AWSServiceRoleForRDS 역할을 사용하는지 잘 모를 경우에는 역할을 삭제할 수 있습니다. 서비스에서 역할을 사용하는 경우에는 삭제가 안 되어 역할이 사용 중인 리전을 볼 수 있습니다. 역할이 사용 중인 경우에는 세션이 종료될 때까지 기다렸다가 역할을 삭제해야 합니다. 서비스 연결 역할에 대한 세션은 취소할 수 없습니다.
AWSServiceRoleForRDS 역할을 제거하려면 먼저 *모든* 인스턴스 및 클러스터를 삭제해야 합니다. 인스턴스 및 클러스터 삭제에 대한 자세한 내용은 다음 주제를 참조하십시오.
+ [Amazon DocumentDB 인스턴스 삭제](db-instance-delete.md)
+ [Amazon DocumentDB 클러스터 삭제](db-cluster-delete.md)
## Amazon DocumentDB 서비스 연결 역할에 대해 지원되는 리전
Amazon DocumentDB는 서비스가 제공되는 모든 리전에서 서비스 연결 역할 사용을 지원합니다. 자세한 내용은 [https://docs.aws.amazon.com/documentdb/latest/developerguide/regions-and-azs.html#regions-and-azs-availability](https://docs.aws.amazon.com/documentdb/latest/developerguide/regions-and-azs.html#regions-and-azs-availability) 단원을 참조하십시오.
# Amazon DocumentDB에서 변경 스트림 사용
Amazon DocumentDB(MongoDB 호환)의 변경 스트림 기능은 클러스터의 컬렉션 내에서 시간순으로 발생하는 변경 이벤트 시퀀스를 제공합니다. 변경 스트림에서 이벤트를 읽어 다음을 비롯한 다양한 사용 사례를 구현할 수 있습니다.
+ 변경 알림
+ Amazon OpenSearch Service(OpenSearch Service)로 전체 텍스트 검색
+ Amazon Redshift로 분석
애플리케이션에서는 변경 스트림을 사용하여 개별 컬렉션의 데이터 변경 사항을 구독할 수 있습니다. 변경 스트림 이벤트는 클러스터에서 발생하는 순서대로 정렬되며 이벤트가 기록된 후 3시간(기본값) 동안 저장됩니다. 파라미터를 사용하여 보존 기간을 최대 7일까지 연장할 수 있습니다. `change_stream_log_retention_duration` 변경 스트림 보존 기간을 수정하려면 [변경 스트림 로그 보존 기간 수정](https://docs.aws.amazon.com/documentdb/latest/developerguide/change_streams.html#change_streams-modifying_log_retention)을 참조하세요.
**Topics**
+ [지원되는 연산자](#change_streams-supported_ops)
+ [결제](#change_streams-billing)
+ [제한 사항](#change_streams-limitations)
+ [변경 스트림 활성화](#change_streams-enabling)
+ [예: Python에서 변경 스트림 사용](#change_streams-using_example)
+ [전체 문서 조회](#change_streams-lookup)
+ [변경 스트림 재개](#change_streams-resuming)
+ [`startAtOperationTime`에서 변경 스트림 재개](#change_streams-startAtOperation)
+ [`postBatchResumeToken`에서 변경 스트림 재개](#change_streams-postBatchResumeToken)
+ [변경 스트림 내 트랜잭션](#change_streams-transactions)
+ [변경 스트림 로그 보존 기간 수정](#change_streams-modifying_log_retention)
+ [보조 인스턴스에서 변경 스트림 사용](#change-streams-secondary-instances)
## 지원되는 연산자
Amazon DocumentDB는 변경 스트림에 대해 다음 작업을 지원합니다.
+ MongoDB `db.collection.watch()`, `db.watch()` 및 `client.watch()`API에서 지원되는 모든 변경 이벤트.
+ 업데이트를 위한 전체 문서 조회.
+ 집계 단계: `$match``$project`,`$redact`, 및 `$addFields`와 `$replaceRoot`.
+ 이력서 토큰에서 변경 스트림 재개
+ `startAtOperation` 항목을 사용하여 타임스탬프에서 변경 스트림 재개(Amazon DocumentDB 4.0\$1에 해당)
## 결제
Amazon DocumentDB 변경 스트림 기능은 기본적으로 비활성화되어 있으며 이 기능이 활성화될 때까지 추가 요금이 발생하지 않습니다. 클러스터에서 변경 스트림을 사용하면 추가 읽기 및 쓰기 IO와 스토리지 비용이 발생합니다. `modifyChangeStreams` API 작업을 사용하여 클러스터에 대해 이 기능을 활성화할 수 있습니다. 요금에 대한 자세한 내용은 [Amazon DocumentDB 요금](https://aws.amazon.com/documentdb/pricing/)을 참조하세요.
## 제한 사항
Amazon DocumentDB에서 변경 스트림에는 다음과 같은 제한 사항이 있습니다.
+ Amazon DocumentDB 3.6. 및 Amazon DocumentDB 4.0에서 변경 스트림은 Amazon DocumentDB 클러스터의 기본 인스턴스에 대한 연결에서만 열 수 있습니다. Amazon DocumentDB 3.6. 및 Amazon DocumentDB 4.0에서는 복제본 인스턴스의 변경 스트림에서 읽기 기능이 지원되지 않습니다. `watch()` API 작업을 호출할 때 모든 읽기가 기본 인스턴스에 대해 수행되도록 `primary` 읽기 기본 설정을 지정해야 합니다([예제](#change_streams-using_example) 섹션 참조).
+ Amazon DocumentDB 5.0에서는 전역 클러스터를 포함하여 기본 인스턴스와 보조 인스턴스 모두에서 변경 스트림을 열 수 있습니다. 보조 읽기 기본 설정을 지정하여 변경 스트림을 보조 인스턴스로 리디렉션할 수 있습니다. 추가 모범 사례 및 제한 사항은 [보조 인스턴스에서 변경 스트림 사용](#change-streams-secondary-instances) 항목을 참조하세요.
+ 모음의 변경 스트림에 작성된 이벤트는 최대 7일 동안 사용할 수 있습니다(기본값은 3시간). 변경 스트림 데이터는 새 변경 사항이 발생하지 않은 경우에도 로그 보존 기간 후에 삭제됩니다.
+ 모음에서 `updateMany` 또는 `deleteMany` 같은 장기 실행 쓰기 작업을 수행하는 경우, 장기 실행 쓰기 작업이 완료될 때까지 변경 스트림 이벤트의 쓰기를 일시적으로 중단할 수 있습니다.
+ Amazon DocumentDB는 MongoDB 작업 로그(`oplog`)를 지원하지 않습니다.
+ Amazon DocumentDB를 사용하면 지정된 컬렉션에서 변경 스트림을 명시적으로 활성화해야 합니다.
+ 변경 스트림 이벤트의 총 크기(변경 데이터 및 요청된 경우 전체 문서 포함)가 `16 MB`보다 크면 클라이언트가 변경 스트림에서 읽기에 실패합니다.
+ Amazon DocumentDB v3.6과 `client.watch()` 및 `db.watch()` 항목을 사용할 때는 현재 Ruby 드라이버가 지원되지 않습니다.
+ 필드의 업데이트된 값이 이전 값과 동일한 경우 변경 스트림의 `updateDescription` 명령 출력은 Amazon DocumentDB와 MongoDB에서 다릅니다.
+ 제공된 필드가 `$set` 명령에 지정되어 있고 대상 값이 이미 소스 값과 동일한 경우 Amazon DocumentDB는 `updateDescription` 출력의 필드를 반환하지 않습니다.
+ MongoDB는 지정된 값이 현재 값과 같더라도 출력의 필드를 반환합니다.
## 변경 스트림 활성화
해당 데이터베이스 내의 모든 모음 또는 선택한 모음에 대해 Amazon DocumentDB 변경 스트림을 활성화할 수 있습니다. 다음은 mongo 쉘을 사용하여 다른 사용 사례에 변경 스트림을 활성화하는 방법의 예입니다. 데이터베이스 및 모음 이름을 지정할 때 빈 문자열은 와일드카드로 취급됩니다.
```
//Enable change streams for the collection "foo" in database "bar"
db.adminCommand({modifyChangeStreams: 1,
database: "bar",
collection: "foo",
enable: true});
```
```
//Disable change streams on collection "foo" in database "bar"
db.adminCommand({modifyChangeStreams: 1,
database: "bar",
collection: "foo",
enable: false});
```
```
//Enable change streams for all collections in database "bar"
db.adminCommand({modifyChangeStreams: 1,
database: "bar",
collection: "",
enable: true});
```
```
//Enable change streams for all collections in all databases in a cluster
db.adminCommand({modifyChangeStreams: 1,
database: "",
collection: "",
enable: true});
```
다음과 같은 경우 컬렉션에 대해 변경 스트림이 활성화됩니다.
+ 데이터베이스와 컬렉션 모두 명시적으로 활성화되어 있습니다.
+ 컬렉션을 포함하는 데이터베이스가 활성화되어 있습니다.
+ 모든 데이터베이스가 활성화되어 있습니다.
상위 데이터베이스에도 변경 스트림이 활성화되어 있거나 클러스터의 모든 데이터베이스가 활성화되어 있는 경우 데이터베이스에서 컬렉션을 삭제해도 해당 컬렉션에 대한 변경 스트림이 비활성화되지 않습니다. 삭제된 컬렉션과 동일한 이름으로 새 컬렉션이 생성되면 해당 컬렉션에 대해 변경 스트림이 활성화됩니다.
`$listChangeStreams` 집계 파이프라인 단계를 사용하여 클러스터의 활성화된 모든 변경 스트림을 나열할 수 있습니다. Amazon DocumentDB에서 지원하는 모든 집계 단계는 추가 처리를 위해 파이프라인에서 사용할 수 있습니다. 이전에 활성화된 컬렉션이 비활성화된 경우 `$listChangeStreams` 출력에 나타나지 않습니다.
```
//List all databases and collections with change streams enabled
cursor = new DBCommandCursor(db,
db.runCommand(
{aggregate: 1,
pipeline: [{$listChangeStreams: 1}],
cursor:{}}));
```
```
//List of all databases and collections with change streams enabled
{ "database" : "test", "collection" : "foo" }
{ "database" : "bar", "collection" : "" }
{ "database" : "", "collection" : "" }
```
```
//Determine if the database “bar” or collection “bar.foo” have change streams enabled
cursor = new DBCommandCursor(db,
db.runCommand(
{aggregate: 1,
pipeline: [{$listChangeStreams: 1},
{$match: {$or: [{database: "bar", collection: "foo"},
{database: "bar", collection: ""},
{database: "", collection: ""}]}}
],
cursor:{}}));
```
## 예: Python에서 변경 스트림 사용
다음은 컬렉션 수준의 Python에서 Amazon DocumentDB 변경 스트림을 사용하는 예입니다.
```
import os
import sys
from pymongo import MongoClient, ReadPreference
username = "DocumentDBusername"
password =
clusterendpoint = "DocumentDBClusterEndpoint”
client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem')
db = client['bar']
#While ‘Primary’ is the default read preference, here we give an example of
#how to specify the required read preference when reading the change streams
coll = db.get_collection('foo', read_preference=ReadPreference.PRIMARY)
#Create a stream object
stream = coll.watch()
#Write a new document to the collection to generate a change event
coll.insert_one({'x': 1})
#Read the next change event from the stream (if any)
print(stream.try_next())
"""
Expected Output:
{'_id': {'_data': '015daf94f600000002010000000200009025'},
'clusterTime': Timestamp(1571788022, 2),
'documentKey': {'_id': ObjectId('5daf94f6ea258751778163d6')},
'fullDocument': {'_id': ObjectId('5daf94f6ea258751778163d6'), 'x': 1},
'ns': {'coll': 'foo', 'db': 'bar'},
'operationType': 'insert'}
"""
#A subsequent attempt to read the next change event returns nothing, as there are no new changes
print(stream.try_next())
"""
Expected Output:
None
"""
#Generate a new change event by updating a document
result = coll.update_one({'x': 1}, {'$set': {'x': 2}})
print(stream.try_next())
"""
Expected Output:
{'_id': {'_data': '015daf99d400000001010000000100009025'},
'clusterTime': Timestamp(1571789268, 1),
'documentKey': {'_id': ObjectId('5daf9502ea258751778163d7')},
'ns': {'coll': 'foo', 'db': 'bar'},
'operationType': 'update',
'updateDescription': {'removedFields': [], 'updatedFields': {'x': 2}}}
"""
```
다음은 데이터베이스 수준의 Python에서 Amazon DocumentDB 변경 스트림을 사용하는 예입니다.
```
import os
import sys
from pymongo import MongoClient
username = "DocumentDBusername"
password =
clusterendpoint = "DocumentDBClusterEndpoint”
client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem')
db = client['bar']
#Create a stream object
stream = db.watch()
coll = db.get_collection('foo')
#Write a new document to the collection foo to generate a change event
coll.insert_one({'x': 1})
#Read the next change event from the stream (if any)
print(stream.try_next())
"""
Expected Output:
{'_id': {'_data': '015daf94f600000002010000000200009025'},
'clusterTime': Timestamp(1571788022, 2),
'documentKey': {'_id': ObjectId('5daf94f6ea258751778163d6')},
'fullDocument': {'_id': ObjectId('5daf94f6ea258751778163d6'), 'x': 1},
'ns': {'coll': 'foo', 'db': 'bar'},
'operationType': 'insert'}
"""
#A subsequent attempt to read the next change event returns nothing, as there are no new changes
print(stream.try_next())
"""
Expected Output:
None
"""
coll = db.get_collection('foo1')
#Write a new document to another collection to generate a change event
coll.insert_one({'x': 1})
print(stream.try_next())
"""
Expected Output: Since the change stream cursor was the database level you can see change events from different collections in the same database
{'_id': {'_data': '015daf94f600000002010000000200009025'},
'clusterTime': Timestamp(1571788022, 2),
'documentKey': {'_id': ObjectId('5daf94f6ea258751778163d6')},
'fullDocument': {'_id': ObjectId('5daf94f6ea258751778163d6'), 'x': 1},
'ns': {'coll': 'foo1', 'db': 'bar'},
'operationType': 'insert'}
"""
```
## 전체 문서 조회
변경 사항 업데이트 이벤트에는 전체 문서가 포함되지 않으며 변경된 내용만 포함됩니다. 사용 사례에 업데이트의 영향을 받는 전체 문서가 필요한 경우, 스트림을 열 때 전체 문서 조회를 활성화할 수 있습니다.
변경 스트림 업데이트 이벤트에 대한 `fullDocument` 문서는 문서 조회 시 업데이트된 문서의 최신 버전을 나타냅니다. 업데이트 작업과 `fullDocument` 조회 사이에 변경 사항이 발생한 경우 `fullDocument` 문서가 업데이트 당시의 문서 상태를 나타내지 않을 수 있습니다.
업데이트 조회가 활성화된 스트림 객체를 생성하려면 다음 예제를 사용하세요.
```
stream = coll.watch(full_document='updateLookup')
#Generate a new change event by updating a document
result = coll.update_one({'x': 2}, {'$set': {'x': 3}})
stream.try_next()
```
스트림 객체의 결과는 다음과 비슷합니다.
```
{'_id': {'_data': '015daf9b7c00000001010000000100009025'},
'clusterTime': Timestamp(1571789692, 1),
'documentKey': {'_id': ObjectId('5daf9502ea258751778163d7')},
'fullDocument': {'_id': ObjectId('5daf9502ea258751778163d7'), 'x': 3},
'ns': {'coll': 'foo', 'db': 'bar'},
'operationType': 'update',
'updateDescription': {'removedFields': [], 'updatedFields': {'x': 3}}}
```
## 변경 스트림 재개
마지막으로 검색된 변경 이벤트 문서의 `_id` 필드와 동일한 다시 시작 토큰을 사용하여 나중에 변경 스트림을 다시 시작할 수 있습니다.
```
import os
import sys
from pymongo import MongoClient
username = "DocumentDBusername"
password =
clusterendpoint = "DocumentDBClusterEndpoint”
client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem', retryWrites='false')
db = client['bar']
coll = db.get_collection('foo')
#Create a stream object
stream = db.watch()
coll.update_one({'x': 1}, {'$set': {'x': 4}})
event = stream.try_next()
token = event['_id']
print(token)
"""
Output: This is the resume token that we will later us to resume the change stream
{'_data': '015daf9c5b00000001010000000100009025'}
"""
#Python provides a nice shortcut for getting a stream’s resume token
print(stream.resume_token)
"""
Output
{'_data': '015daf9c5b00000001010000000100009025'}
"""
#Generate a new change event by updating a document
result = coll.update_one({'x': 4}, {'$set': {'x': 5}})
#Generate another change event by inserting a document
result = coll.insert_one({'y': 5})
#Open a stream starting after the selected resume token
stream = db.watch(full_document='updateLookup', resume_after=token)
#Our first change event is the update with the specified _id
print(stream.try_next())
"""
#Output: Since we are resuming the change stream from the resume token, we will see all events after the first update operation. In our case, the change stream will resume from the update operation {x:5}
{'_id': {'_data': '015f7e8f0c000000060100000006000fe038'},
'operationType': 'update',
'clusterTime': Timestamp(1602129676, 6),
'ns': {'db': 'bar', 'coll': 'foo'},
'documentKey': {'_id': ObjectId('5f7e8f0ac423bafbfd9adba2')},
'fullDocument': {'_id': ObjectId('5f7e8f0ac423bafbfd9adba2'), 'x': 5},
'updateDescription': {'updatedFields': {'x': 5}, 'removedFields': []}}
"""
#Followed by the insert
print(stream.try_next())
"""
#Output:
{'_id': {'_data': '015f7e8f0c000000070100000007000fe038'},
'operationType': 'insert',
'clusterTime': Timestamp(1602129676, 7),
'ns': {'db': 'bar', 'coll': 'foo'},
'documentKey': {'_id': ObjectId('5f7e8f0cbf8c233ed577eb94')},
'fullDocument': {'_id': ObjectId('5f7e8f0cbf8c233ed577eb94'), 'y': 5}}
"""
```
## `startAtOperationTime`에서 변경 스트림 재개
`startAtOperationTime`을 사용하여 특정 타임스탬프에서 나중에 변경 스트림을 재개할 수 있습니다.
**참고**
`startAtOperationTime`을 사용하는 기능은 Amazon DocumentDB 4.0 이상에서 사용할 수 있습니다. `startAtOperationTime`을 사용하는 경우, 변경 스트림 커서는 지정된 타임스탬프 시점 또는 이후에 발생한 변경 사항만 반환합니다. `startAtOperationTime` 및 `resumeAfter` 명령은 상호 배타적이므로 함께 사용할 수 없습니다.
```
import os
import sys
from pymongo import MongoClient
username = "DocumentDBusername"
password =
clusterendpoint = "DocumentDBClusterEndpoint”
client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='rds-root-ca-2020.pem',retryWrites='false')
db = client['bar']
coll = db.get_collection('foo')
#Create a stream object
stream = db.watch()
coll.update_one({'x': 1}, {'$set': {'x': 4}})
event = stream.try_next()
timestamp = event['clusterTime']
print(timestamp)
"""
Output
Timestamp(1602129114, 4)
"""
#Generate a new change event by updating a document
result = coll.update_one({'x': 4}, {'$set': {'x': 5}})
result = coll.insert_one({'y': 5})
#Generate another change event by inserting a document
#Open a stream starting after specified time stamp
stream = db.watch(start_at_operation_time=timestamp)
print(stream.try_next())
"""
#Output: Since we are resuming the change stream at the time stamp of our first update operation (x:4), the change stream cursor will point to that event
{'_id': {'_data': '015f7e941a000000030100000003000fe038'},
'operationType': 'update',
'clusterTime': Timestamp(1602130970, 3),
'ns': {'db': 'bar', 'coll': 'foo'},
'documentKey': {'_id': ObjectId('5f7e9417c423bafbfd9adbb1')},
'updateDescription': {'updatedFields': {'x': 4}, 'removedFields': []}}
"""
print(stream.try_next())
"""
#Output: The second event will be the subsequent update operation (x:5)
{'_id': {'_data': '015f7e9502000000050100000005000fe038'},
'operationType': 'update',
'clusterTime': Timestamp(1602131202, 5),
'ns': {'db': 'bar', 'coll': 'foo'},
'documentKey': {'_id': ObjectId('5f7e94ffc423bafbfd9adbb2')},
'updateDescription': {'updatedFields': {'x': 5}, 'removedFields': []}}
"""
print(stream.try_next())
"""
#Output: And finally the last event will be the insert operation (y:5)
{'_id': {'_data': '015f7e9502000000060100000006000fe038'},
'operationType': 'insert',
'clusterTime': Timestamp(1602131202, 6),
'ns': {'db': 'bar', 'coll': 'foo'},
'documentKey': {'_id': ObjectId('5f7e95025c4a569e0f6dde92')},
'fullDocument': {'_id': ObjectId('5f7e95025c4a569e0f6dde92'), 'y': 5}}
"""
```
## `postBatchResumeToken`에서 변경 스트림 재개
이제 Amazon DocumentDB 변경 스트림은 `postBatchResumeToken`이라는 추가 필드를 반환합니다. 이 필드는 `$changestream` 명령 및 `getMore` 명령에서 반환됩니다.
Python의 `$changestream` 명령 예제:
```
db.command({"aggregate": "sales", "pipeline": [{ "$changeStream": {}}], "cursor": {"batchSize": 1}})
```
예상 결과:
```
cursor" : {
"firstBatch" : [ ],
"postBatchResumeToken" : {"_data" : "0167c8cbe60000000004"},
"id" : NumberLong("9660788144470"),
"ns" : "test.sales"
}
```
Python의 `getMore` 명령 예제:
```
db.command({"getMore": NumberLong(), "collection": "sales", "batchSize": 1 })
```
예상 결과
```
cursor" : {
"nextBatch" : [ ],
"postBatchResumeToken" : {"_data" : "0167c8cbe60000000004"},
"id" : NumberLong("9660788144470"),
"ns" : "test.sales"
}
```
`postBatchResumeToken` 필드는 재개 토큰이 사용되는 방식과 마찬가지로 `resumeAfter` 필드에서 새 변경 스트림 커서를 여는 데 사용할 수 있습니다.
선택한 `postBatchResumeToken` 이후에 시작하는 스트림을 엽니다.
```
post_batch_resume_token = output['cursor']['postBatchResumeToken']
stream = db.watch(full_document='updateLookup', resume_after=post_batch_resume_token)
```
실제 이벤트를 반영하는 작업 로그(oplog) 항목에 항상 해당하는 일반 재개 토큰과 달리, `postBatchResumeToken`은 변경 스트림이 서버에서 스캔한 oplog 항목에 해당하며, 반드시 일치하는 변경 사항은 아닙니다.
이전 일반 재개 토큰으로 다시 시작하려고 시도하는 경우 데이터베이스가 지정된 타임스탬프 및 현재 시간 간의 모든 oplog 항목을 강제로 스캔합니다. 이를 통해 짧은 시간 동안 각 하위 쿼리 스캔을 통해 내부적으로 많은 쿼리가 생성될 수 있습니다. 이로 인해 CPU 사용량이 급증하고 데이터베이스 성능이 저하됩니다. 마지막 `postBatchResumeToken`으로 재개하면 일치하지 않는 oplog 항목의 스캔을 건너뜁니다.
## 변경 스트림 내 트랜잭션
변경 스트림 이벤트에는 커밋되지 않았거나 중단된 트랜잭션의 이벤트는 포함되지 않습니다. 예를 들어 하나의 `INSERT` 작업과 하나의 `UPDATE` 작업으로 트랜잭션을 시작하고 `INSERT` 작업이 성공하지만 `UPDATE` 작업이 실패하면 트랜잭션이 롤백됩니다. 이 트랜잭션이 롤백되었으므로 변경 스트림에는 이 트랜잭션에 대한 이벤트가 포함되지 않습니다.
## 변경 스트림 로그 보존 기간 수정
AWS Management Console 또는를 사용하여 변경 스트림 로그 보존 기간을 1시간에서 7일로 수정할 수 있습니다 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. **파라미터 그룹** 창에서 클러스터와 연결된 클러스터 파라미터 그룹을 선택합니다. 클러스터와 연결된 클러스터 파라미터 그룹을 식별하려면 [Amazon DocumentDB 클러스터의 파라미터 그룹 확인](cluster_parameter_groups-describe.md#cluster_parameter_groups-determine) 단원을 참조하십시오.
1. 결과 페이지에는 이 클러스터 파라미터 그룹에 대한 파라미터 및 해당 세부 정보가 표시됩니다. `change_stream_log_retention_duration` 파라미터를 선택합니다.
1. 페이지 오른쪽 상단에서 **편집**을 선택하여 파라미터의 값을 변경합니다. `change_stream_log_retention_duration` 파라미터는 1시간\$17일 사이로 수정할 수 있습니다.
1. 변경한 다음 **클러스터 파라미터 수정**을 선택하여 변경 사항을 저장합니다. 변경 사항을 취소하려면 **취소**를 선택합니다.
------
#### [ Using the AWS CLI ]
클러스터 파라미터 그룹의 `change_stream_log_retention_duration` 파라미터를 수정하려면 다음 파라미터와 함께 `modify-db-cluster-parameter-group` 작업을 사용합니다.
+ **--db-cluster-parameter-group-name** - 필수입니다. 수정하려는 클러스터 파라미터 그룹의 이름입니다. 클러스터와 연결된 클러스터 파라미터 그룹을 식별하려면 [Amazon DocumentDB 클러스터의 파라미터 그룹 확인](cluster_parameter_groups-describe.md#cluster_parameter_groups-determine) 단원을 참조하십시오.
+ **--parameters** - 필수입니다. 수정 중인 파라미터입니다. 각 파라미터 요소는 다음을 포함해야 합니다.
+ **ParameterName** — 수정 중인 파라미터의 이름입니다. 이 경우에는 `change_stream_log_retention_duration`입니다.
+ **ParameterValue** — 이 파라미터의 새 값입니다.
+ **ApplyMethod** - 파라미터에 대한 변경 사항을 적용할 방법입니다. 허용된 값은 `immediate` 및 `pending-reboot`입니다.
**참고**
`static`의 `ApplyType` 파라미터에는 `pending-reboot`의 `ApplyMethod`이 있어야 합니다.
1. 파라미터 `change_stream_log_retention_duration`의 값을 변경하려면 다음 명령을 실행하고 `parameter-value`를 파라미터를 수정할 값으로 바꿉니다.
Linux, macOS, Unix의 경우:
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters "ParameterName=change_stream_log_retention_duration,ParameterValue=,ApplyMethod=immediate"
```
Windows의 경우:
```
aws docdb modify-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--parameters "ParameterName=change_stream_log_retention_duration,ParameterValue=,ApplyMethod=immediate"
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
1. 적어도 5분을 기다립니다.
1. `sample-parameter-group`의 파라미터 값을 나열하여 변경 사항을 확인합니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Windows의 경우:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"Parameters": [
{
"ParameterName": "audit_logs",
"ParameterValue": "disabled",
"Description": "Enables auditing on cluster.",
"Source": "system",
"ApplyType": "dynamic",
"DataType": "string",
"AllowedValues": "enabled,disabled",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
},
{
"ParameterName": "change_stream_log_retention_duration",
"ParameterValue": "12345",
"Description": "Duration of time in seconds that the change stream log is retained and can be consumed.",
"Source": "user",
"ApplyType": "dynamic",
"DataType": "integer",
"AllowedValues": "3600-86400",
"IsModifiable": true,
"ApplyMethod": "immediate"
}
]
}
```
------
**참고**
변경 스트림 로그 보존은 로그 크기가 (>) 51,200MB보다 커질 때까지 구성된 `change_stream_log_retention_duration` 값보다 오래된 로그를 삭제하지 않습니다.
## 보조 인스턴스에서 변경 스트림 사용
보조 인스턴스에서 변경 스트림 사용을 시작하려면 `readPreference` 항목을 보조 인스턴스로 사용하여 변경 스트림 커서를 엽니다.
변경 스트림 커서를 열어 클러스터 또는 데이터베이스의 특정 컬렉션 또는 모든 컬렉션에 대한 변경 이벤트를 감시할 수 있습니다. Amazon DocumentDB 인스턴스에서 변경 스트림 커서를 열고 라이터 인스턴스와 리더 인스턴스 모두에서 변경 스트림 문서를 가져올 수 있습니다. 라이터 및 리더 인스턴스에서 열린 다양한 변경 스트림 커서에서 변경 스트림 토큰(예: `resumeToken` 또는 `startOperationTime`)을 공유할 수 있습니다.
**예제**
```
import os
import sys
from pymongo import MongoClient, ReadPreference
username = "DocumentDBusername"
password =
clusterendpoint = "DocumentDBClusterEndpoint"
client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem')
db = client['bar']
# Make sure to use SECONDARY to redirect cursor reads from secondary instances
coll = db.get_collection('foo', read_preference=ReadPreference.SECONDARY)
# Create a stream object on RO. The token needs to generated from PRIMARY.
stream = coll.watch(resumeAfter=token)
for event in stream:
print(event)
```
**보조 인스턴스의 변경 스트림에 대한 지침 및 제한 사항**
+ 스트림 변경 이벤트는 기본 인스턴스에서 보조 인스턴스로 복제해야 합니다. Amazon CloudWatch를 사용하여 `DBInstanceReplicaLag` 지표를 모니터링할 수도 있습니다.
+ 보조 인스턴스의 타임스탬프가 항상 기본 인스턴스와 동기화되지는 않을 수 있습니다. 이 경우 보조 인스턴스 타임스탬프가 지연될 수 있어 따라잡을 수 있습니다. 모범 사례로 `startAtOperationTime` 또는 `resumeToken`를 사용하여 보조 인스턴스에서 감시를 시작하는 것이 좋습니다.
+ 문서 크기가 크고, `fullDocumentLookup` 작업을 수행 중이며, 기본 인스턴스에 동시 쓰기 워크로드가 많은 경우 기본 인스턴스에 비해 보조 인스턴스의 처리량이 낮은 상황을 경험할 수도 있습니다. 가장 좋은 방법은 보조 인스턴스에서 버퍼 캐시 적중률을 모니터링하고 버퍼 캐시 적중률이 높은지 확인하는 것입니다.
# Amazon DocumentDB 8.0에서 데이터 정렬 사용
Amazon DocumentDB 8.0은 이제 데이터 정렬을 지원합니다. 데이터 정렬을 사용하면 문자열 비교를 위한 언어별 규칙을 구성할 수 있습니다. 데이터 정렬을 사용하면 대/소문자를 구분하는 비교에 대한 규칙을 지정하거나 언어 로캘을 지정할 수 있습니다. 데이터 정렬은 DocumentDB 8.0의 컬렉션 수준 또는 인덱스 수준에서 구성할 수 있습니다. DocumentDB에서 데이터 정렬을 사용하면 내부적으로 다음 파라미터와 함께 데이터 정렬 문서가 생성됩니다.
```
{
locale: string,
caseLevel: boolean,
caseFirst: string,
strength: int,
numericOrdering: boolean,
alternate: string,
maxVariable: string,
backwards: boolean,
normalization: boolean
}
```
## 제한 사항
데이터 정렬에는 Amazon DocumentDB에서 다음과 같은 제한 사항이 있습니다.
+ 데이터 정렬은 Amazon DocumentDB 8.0에서 사용할 수 있는 플래너 v3와 호환됩니다. plannerv2 또는 plannerv1로 전환하면 “인덱스를 찾을 수 없음” 오류를 포함한 일관되지 않은 동작이 발생할 수 있습니다.
+ 고유한 라이브러리 차이로 인해 데이터 정렬이 포함된 mongodb 컬렉션을 내보내는 경우 마이그레이션 전에 metadata.bson 파일을 업데이트하고 해당 버전을 57.1에서 60.2로 변경해야 합니다.
+ 드문 경우지만 데이터 정렬 설정이 문자 수에 대한 내부 제한을 위반하여 아래 오류가 발생할 수 있습니다. “오류: 데이터 정렬 문서에 기본값이 아닌 속성이 지원되는 속성보다 많습니다. 옵션 수를 줄이세요.” 이 경우 데이터 정렬 문서에 제공하는 옵션을 줄이거나 가능하면 기본값을 사용해 볼 수 있습니다.
# Amazon DocumentDB 8.0에서 보기 사용
+ 이제 Amazon DocumentDB 8.0에서 뷰를 지원합니다. 지정된 집계 작업을 기반으로 데이터를 제공하는 가상 컬렉션으로 함수를 봅니다. 뷰를 생성할 때 하나 이상의 소스 컬렉션에서 데이터를 변환하는 쿼리를 정의합니다. Amazon DocumentDB 8.0은 추가 스토리지 리소스를 소비하지 않고 뷰에 액세스할 때마다이 쿼리를 실행합니다. 표준 컬렉션과 달리 Amazon DocumentDB 8.0의 뷰는 문서를 디스크에 저장하지 않으므로 변환되거나 필터링된 데이터를 애플리케이션에 제공하는 효율적인 솔루션입니다. Amazon DocumentDB에서 뷰를 생성하려면 createView 명령 또는 db.createView() 헬퍼 메서드를 사용할 수 있습니다.
```
db.createView("viewName","sourceCollection",
[
{ $match: { status: "active" } },
{ $project: { _id: 1, name: 1, email: 1 } }
]
)
```
이렇게 하면 활성 문서만 포함하고 \$1id, 이름 및 이메일 필드만 프로젝트하는 "sourceCollection"을 기반으로 "viewName"이라는 뷰가 생성됩니다. Amazon DocumentDB의 보기는 읽기 전용입니다. 뷰에 대한 쓰기 작업은 오류를 반환합니다. 대규모 데이터 세트로 최적의 성능을 위해 뷰 파이프라인을 구성하여 효율성을 극대화할 수 있습니다. 복잡한 집계 파이프라인의 경우 \$1match 단계를 파이프라인의 첫 번째 단계 또는 초기 단계로 사용하여 후속 단계에서 처리해야 하는 문서 수를 줄여 쿼리 성능을 개선하는 것이 좋습니다.
## 모범 사례
보기에서 따라야 할 몇 가지 모범 사례는 다음과 같습니다.
+ 조기 필터링: 뷰 파이프라인 초기에 \$1match 단계를 사용하여 처리되는 데이터의 양을 줄입니다.
+ 복잡한 집계 방지: 복잡한 집계로 자주 액세스하는 뷰의 경우 주기적으로 업데이트되는 사전 계산된 결과로 별도의 컬렉션을 생성하는 것이 좋습니다.
+ 인덱스 계획: 뷰 파이프라인, 특히 \$1match 및 \$1sort 작업에 사용되는 필드가 소스 컬렉션에서 제대로 인덱싱되었는지 확인합니다.
+ 쿼리 최적화: explain 명령을 사용하여 뷰 쿼리가 실행되는 방식을 이해하고 그에 따라 최적화합니다.
+ 뷰에 대한 대안: Amazon DocumentDB 뷰와 MongoDB 뷰의 기능적 차이를 고려할 때 제한 사항이 발생할 때 뷰 대신 예약된 업데이트가 있는 정기 컬렉션을 사용하는 것이 좋습니다.
## 집계자 연산자 호환성
Amazon DocumentDB는 호환성을 계속 확장하면서 뷰 정의에서 많은 집계 연산자를 지원합니다. 뷰를 사용할 때는 다음과 같은 지원되는 연산자에 집중하세요.
+ 문서 필터링을 위한 \$1match
+ 필드 선택 및 변환을 위한 \$1project
+ 계산된 필드를 추가하기 위한 \$1addFields
+ 결과 주문에 대한 \$1sort
+ 페이지 매김에 대한 \$1limit 및 \$1skip
\$1currentOp, \$1replaceRoot 및 \$1geoNear와 같은 일부 특수 연산자는 현재 뷰 정의가 아닌 직접 집계 쿼리에서 작동합니다.
## 인덱스 및 뷰 활용
Amazon DocumentDB 8.0의 뷰는 기본 컬렉션의 인덱스를 사용합니다. 따라서 뷰에서 인덱스를 직접 생성, 삭제 또는 재구축할 수 없습니다. 그러나 소스 컬렉션에서 잘 설계된 인덱스는 보기 쿼리 성능을 크게 개선할 수 있습니다. 다음은 보기에서 쿼리 성능을 최적화하기 위한 몇 가지 단계입니다.
+ 뷰의 파이프라인, 특히 \$1match 및 \$1sort 작업에 사용되는 소스 컬렉션 필드에 적절한 인덱스가 있는지 확인합니다.
+ explain() 메서드를 사용하여 쿼리 실행 계획을 분석하고 인덱스 사용량을 확인합니다. 예: `db.viewName.find({...}).explain() `
# 변경 스트림과 함께 AWS Lambda 사용
Amazon DocumentDB는 AWS Lambda과 통합되므로 Lambda 함수를 사용하여 변경 스트림의 레코드를 처리할 수 있습니다. Lambda 이벤트 소스 매핑은 Lambda를 직접 호출하지 않는 Amazon DocumentDB 이벤트를 처리하기 위해 Lambda 함수를 호출하는 데 사용할 수 있는 리소스입니다. Amazon DocumentDB 변경 스트림을 이벤트 소스로 사용하면 데이터 변경에 응답하는 이벤트 기반 애플리케이션을 구축할 수 있습니다. 예를 들어 Lambda 함수를 사용하여 새 문서를 처리하거나, 기존 문서에 대한 업데이트를 추적하거나, 삭제된 문서를 로그할 수 있습니다.
이벤트 소스 매핑을 구성하여 Amazon DocumentDB 변경 스트림의 레코드를 Lambda 함수로 전송하도록 할 수 있습니다. 이벤트는 효율성 향상을 위해 한 번에 하나씩 보내거나 배치할 수 있으며 순서대로 처리됩니다. 이벤트 소스 매핑의 배치 동작은 특정 시간대(0 - 300초) 또는 배치 레코드 수(최대 10,000개 레코드 제한)를 기준으로 구성할 수 있습니다. 여러 개의 이벤트 소스 매핑을 생성하여 동일한 데이터를 여러 개의 Lambda 함수로 처리하거나 여러 스트림에서 구별되는 항목을 단일 함수로 처리할 수 있습니다.
함수가 오류를 반환하면 Lambda는 처리가 성공할 때까지 배치를 재시도합니다. 변경 스트림의 이벤트가 만료된 경우 Lambda는 이벤트 소스 매핑을 비활성화합니다. 이 경우 새 이벤트 소스 매핑을 생성하고 원하는 시작 위치로 구성할 수 있습니다. Lambda 이벤트 소스 매핑은 폴러의 분산 특성으로 인해 이벤트를 한 번 이상 처리합니다. 결과적으로 Lambda 함수는 드물게 중복 이벤트를 수신할 수 있습니다. 중복 이벤트와 관련된 문제를 피하기 위해 AWS Lambda 함수로 작업하는 모범 사례를 따르고 멱등성 함수를 구축합니다. 자세한 내용은 *AWS Lambda개발자 가이드*의 [Amazon DocumentDB와 함께 AWS Lambda console 사용](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html)을 참조하세요.
성능 모범 사례에 따라 Lambda 함수는 수명이 짧아야 합니다. 불필요한 처리 지연을 방지하기 위해 복잡한 로직도 실행하지 않아야 합니다. 특히 고속 스트림의 경우 장기 실행 중인 동기식 Lambda보다 비동기식 사후 처리 단계 함수 워크플로를 트리거하는 것이 좋습니다. AWS Lambda에 대한 자세한 내용은 [AWS Lambda개발자 가이드](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)를 참조하세요.
## 제한 사항
다음은 Amazon DocumentDB와 AWS Lambda을 사용할 때 고려해야 할 제한 사항입니다.
+ AWS Lambda은 현재 Amazon DocumentDB 4.0 및 5.0에서만 지원됩니다.
+ AWS Lambda은 탄력적 클러스터 또는 글로벌 클러스터에서는 현재 지원되지 않습니다.
+ AWS Lambda 페이로드 크기는 6MB를 초과할 수 없습니다. Lambda 배치 크기에 대한 자세한 내용은 *AWS Lambda 개발자 가이드*의 [Lambda 이벤트 소스 매핑](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-batching) 섹션의 "배치 동작"을 참조하세요.