기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon DocumentDB 클러스터 파라미터 그룹 수정
이 단원에서는 *사용자 지정* Amazon DocumentDB 파라미터 그룹을 수정하는 방법에 대해 설명합니다. Amazon DocumentDB에서는 새 리전에 새 엔진 버전으로 클러스터를 처음 생성할 때 생성되는 `default` 클러스터 파라미터 그룹을 수정할 수 없습니다. Amazon DocumentDB 클러스터가 기본 클러스터 파라미터 그룹을 사용하고 있는 경우, 이 그룹의 값을 수정하려면 먼저 [새 파라미터 그룹 생성](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html)을 하거나 [기존 파라미터 그룹 복사](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html)를 하여 수정한 다음 수정된 파라미터 그룹을 클러스터에 적용해야 합니다.
사용자 지정 클러스터 파라미터 그룹을 수정하려면 다음 단계를 완료합니다. 수정 작업이 전파되는 데 시간이 걸릴 수 있습니다. 수정된 클러스터 파라미터 그룹을 클러스터에 연결하기 전에 사용할 수 있을 때까지 기다리십시오. AWS Management Console 또는 AWS CLI `describe-db-cluster-parameters` 작업을 사용하여 클러스터 파라미터 그룹이 수정되었는지 확인할 수 있습니다. 자세한 내용은 [클러스터 파라미터 그룹 설명](cluster_parameter_groups-describe.md) 단원을 참조하십시오.
------
#### [ Using the AWS Management Console ]
사용자 지정 Amazon DocumentDB 파라미터 그룹을 수정하려면 다음 단계를 수행합니다. `default` 파라미터 그룹은 수정할 수 없습니다. `default` 파라미터 그룹의 값을 수정하려면 [기본 클러스터 파라미터 그룹을 복사](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html)하여 수정한 다음 수정된 파라미터 그룹을 클러스터에 적용하면 됩니다. 클러스터에 파라미터 그룹을 적용하는 방법에 대한 자세한 내용은 [Amazon DocumentDB 클러스터 수정](db-cluster-modify.md)(을)를 참조하세요.
**사용자 지정 클러스터 파라미터 그룹을 수정하려면**
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. 수정하려는 파라미터를 찾은 다음, **수정 가능** 열에 `true`로 나열되어 있는지 확인하여 해당 파라미터가 수정 가능한지 확인합니다.
1. 수정할 수 있는 경우 해당 파라미터를 선택하고 콘솔 페이지의 오른쪽 상단에서 **편집**을 선택합니다.
1. **수정 ``** 대화 상자에서 원하는 대로 변경합니다. 그런 다음 **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"
}
]
}
```
------