기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon DocumentDB 클러스터 파라미터 그룹 관리
<a name="cluster_parameter_groups"></a>

클러스터 파라미터 그룹에서 파라미터를 사용하여 Amazon DocumentDB 엔진 구성을 관리할 수 있습니다. *클러스터 파라미터 그룹*은 Amazon DocumentDB 클러스터의 파라미터를 보다 쉽게 관리할 수 있는 Amazon DocumentDB 구성 값 모음입니다. 클러스터 파라미터 그룹은 클러스터의 모든 인스턴스에 적용되는 엔진 구성 값의 컨테이너 역할을 합니다.

이 단원에서는 클러스터 파라미터 그룹을 생성, 확인 및 수정하는 방법에 대해 설명합니다. 또한 지정된 클러스터와 연결된 클러스터 파라미터 그룹을 확인하는 방법을 보여줍니다.

**Topics**
+ [클러스터 파라미터 그룹 설명](cluster_parameter_groups-describe.md)
+ [클러스터 파라미터 그룹 생성](cluster_parameter_groups-create.md)
+ [클러스터 파라미터 그룹 수정](cluster_parameter_groups-modify.md)
+ [사용자 지정된 클러스터 파라미터 그룹을 사용하도록 클러스터 수정](cluster_parameter_groups-modify_clusters.md)
+ [클러스터 파라미터 그룹 복사](cluster_parameter_groups-copy.md)
+ [클러스터 파라미터 그룹 재설정](cluster_parameter_groups-reset.md)
+ [클러스터 파라미터 그룹 삭제](cluster_parameter_groups-delete.md)
+ [클러스터 파라미터 참조](cluster_parameter_groups-list_of_parameters.md)

# Amazon DocumentDB 클러스터 파라미터 그룹 설명
<a name="cluster_parameter_groups-describe"></a>

새 지역에서 첫 번째 Amazon DocumentDB 클러스터를 생성하거나 새 엔진을 사용할 때 `default` 클러스터 파라미터 그룹이 자동으로 생성됩니다. 동일한 지역에 생성되고 엔진 버전이 동일한 후속 클러스터는 `default` 클러스터 파라미터 그룹을 사용하여 생성됩니다.

**Topics**
+ [클러스터 파라미터 그룹의 세부 정보 설명](#cluster_parameter_groups-describe_details)
+ [클러스터의 파라미터 그룹 확인](#cluster_parameter_groups-determine)
+ [클러스터 파라미터 그룹과 연결된 클러스터 및 인스턴스 확인](#cluster_parameter_groups-count)

## Amazon DocumentDB 클러스터 파라미터 그룹의 세부 정보 설명
<a name="cluster_parameter_groups-describe_details"></a>

지정된 클러스터 파라미터 그룹의 세부 정보를 설명하려면 AWS Management Console 또는 AWS Command Line Interface ()를 사용하여 다음 단계를 완료합니다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. 결과 페이지에는 파라미터 그룹의 파라미터, 최근 활동 및 태그가 표시됩니다.
   + **클러스터 파라미터**에서 파라미터의 이름, 현재 값, 허용되는 값, 파라미터의 수정 가능 여부, 적용 유형, 데이터 유형 및 설명을 볼 수 있습니다. 파라미터를 선택한 다음 **클러스터 파라미터** 섹션에서 **편집**을 선택하여 개별 파라미터를 수정할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 클러스터 파라미터 수정](cluster_parameter_groups-parameters.md)(을)를 참조하세요.
   + **최근 이벤트**에서 이 파라미터 그룹에 대한 가장 최근 이벤트를 볼 수 있습니다. 이 섹션의 검색 창을 사용하여 이러한 이벤트를 필터링할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 이벤트 관리](managing-events.md)(을)를 참조하세요.
   + **태그**에서 이 클러스터 파라미터 그룹에 있는 태그를 볼 수 있습니다. **태그** 섹션에서 **편집**을 선택하여 태그를 추가하거나 제거할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 리소스 태그 지정](tagging.md)(을)를 참조하세요.

------
#### [ Using the AWS CLI ]

`describe-db-cluster-parameter-groups` AWS CLI 명령을 사용하여 단일 클러스터 파라미터 그룹 또는 Amazon DocumentDB에 대해 보유한 모든 클러스터 파라미터 그룹의 Amazon 리소스 이름(ARN), 패밀리, 설명 및 이름을 볼 수 있습니다. `describe-db-cluster-parameters` AWS CLI 명령을 사용하여 단일 클러스터 파라미터 그룹 내에서 파라미터와 해당 세부 정보를 볼 수도 있습니다.
+ **--describe-db-cluster-parameter-groups** - 모든 클러스터 파라미터 그룹 및 세부 정보 목록을 확인합니다.
  + **--db-cluster-parameter-group-name** - 선택 사항. 설명하려는 클러스터 파라미터 그룹의 이름입니다. 이 파라미터를 생략할 경우 모든 클러스터 파라미터 그룹을 설명합니다.
+ **--describe-db-cluster-parameters** - 파라미터 그룹 내의 모든 파라미터와 해당 값을 나열합니다.
  + **--db-cluster-parameter-group name** - 필수입니다. 설명하려는 클러스터 파라미터 그룹의 이름입니다.

**Example**  
다음 코드에는 최대 100개의 클러스터 파라미터 그룹과 해당 ARN, 패밀리, 설명 및 이름이 나열되어 있습니다.  

```
aws docdb describe-db-cluster-parameter-groups
```
이 작업의 출력은 다음과 같습니다(JSON 형식).  

```
{
          "DBClusterParameterGroups": [
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:default.docdb4.0",
                  "DBParameterGroupFamily": "docdb4.0",
                  "Description": "Default cluster parameter group for docdb4.0",
                  "DBClusterParameterGroupName": "default.docdb4.0"
              },
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:sample-parameter-group",
                  "DBParameterGroupFamily": "docdb4.0",
                  "Description": "Custom docdb4.0 parameter group",
                  "DBClusterParameterGroupName": "sample-parameter-group"
              }
          ]
}
```

**Example**  
다음 코드에는 `sample-parameter-group`에 대한 ARN, 패밀리, 설명 및 이름이 나열되어 있습니다.  
Linux, macOS 또는 Unix의 경우:  

```
aws docdb describe-db-cluster-parameter-groups \
          --db-cluster-parameter-group-name sample-parameter-group
```
Windows의 경우:  

```
aws docdb describe-db-cluster-parameter-groups ^
          --db-cluster-parameter-group-name sample-parameter-group
```
이 작업의 출력은 다음과 같습니다(JSON 형식).  

```
{
          "DBClusterParameterGroups": [
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group",
                  "Description": "Custom docdb4.0 parameter group",
                  "DBParameterGroupFamily": "docdb4.0",
                  "DBClusterParameterGroupName": "sample-parameter-group"
              }
          ]
}
```

**Example**  
다음 코드에는 `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": "17777",
            "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": "pending-reboot"
         }
   ]
}
```

------

## Amazon DocumentDB 클러스터의 파라미터 그룹 확인
<a name="cluster_parameter_groups-determine"></a>

특정 클러스터와 연결된 파라미터 그룹을 확인하려면 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. 좌측 탐색 창에서 **클러스터**를 선택합니다.

1. 클러스터 목록에서 원하는 클러스터 이름을 선택합니다.

1. 결과 페이지에는 선택한 클러스터의 세부 정보가 표시됩니다. **클러스터 세부 정보**까지 아래로 스크롤합니다. 해당 섹션의 하단에 있는 **클러스터 파라미터 그룹** 아래에서 파라미터 그룹의 이름을 찾습니다.  
![\[스크린샷: 클러스터의 파라미터 그룹을 표시.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-determine-parameter-group.png)

------
#### [ Using the AWS CLI ]

다음 AWS CLI 코드는 클러스터를 관리하는 파라미터 그룹을 결정합니다`sample-cluster`.

```
aws docdb describe-db-clusters \
      --db-cluster-identifier sample-cluster \
      --query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]'
```

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

```
[
       [
           "sample-cluster",
           "sample-parameter-group"
       ]
]
```

------

## Amazon DocumentDB 클러스터 파라미터 그룹과 연결된 클러스터 및 인스턴스 확인
<a name="cluster_parameter_groups-count"></a>

각 파라미터 그룹과 연결된 클러스터 및 인스턴스 수를 확인하려면를 사용하여 다음 단계를 완료합니다 AWS CLI.

------
#### [ Using the AWS CLI ]

다음 AWS CLI 코드는와 연결된 클러스터 및 인스턴스 수를 결정합니다`sample-parameter-group`.

Linux, macOS, Unix의 경우:

```
aws docdb describe-db-clusters \
      --query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' \
      --output json | \
      jq -r 'group_by(.[0]) | map({
         parameter_group_name: .[0][0],
         total_clusters: length,
         total_instances: map(.[2] | length) | add // 0
      }) | .[]'
```

Windows의 경우:

```
aws docdb describe-db-clusters ^
      --query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ^
      --output json | ^
      jq -r 'group_by(.[0]) | map({
         parameter_group_name: .[0][0],
         total_clusters: length,
         total_instances: map(.[2] | length) | add // 0
      }) | .[]'
```

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

```
{
   "parameter_group_name": "sample-parameter-group",
   "total_clusters": 50,
   "total_instances": 150
}
```

------

# Amazon DocumentDB 클러스터 파라미터 그룹 생성
<a name="cluster_parameter_groups-create"></a>

`default.docdb5.0`, `default.docdb4.0` 또는 `default.docdb3.6` 등의 기본 클러스터 파라미터 그룹은 새 엔진 버전을 사용하여 새 리전에 클러스터를 생성할 때 생성됩니다. 이 리전에 생성되고 엔진 버전이 동일한 후속 클러스터는 `default` 클러스터 파라미터 그룹을 상속합니다. 한 번 생성된 `default` 파라미터 그룹은 삭제하거나 이름을 바꿀 수 없습니다. 선호하는 파라미터 값을 사용하여 사용자 지정 파라미터 그룹을 생성하고 Amazon DocumentDB 클러스터에 연결하여 클러스터 인스턴스의 엔진 동작을 수정할 수 있습니다.

다음 절차에서는 사용자 지정 클러스터 파라미터 그룹을 생성하는 방법을 안내합니다. 그런 다음 [해당 파라미터 그룹 내에서 파라미터를 수정](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-modify.html)할 수 있습니다.

**참고**  
클러스터 파라미터 그룹을 생성한 후 해당 특정 파라미터 그룹을 사용하려면 5분 이상 기다려야 합니다. 그러면 클러스터 파라미터 그룹이 새 클러스터에 사용되기 전에 Amazon DocumentDB에서 `create` 작업을 완전히 마칠 수 있습니다. AWS Management Console 또는 `describe-db-cluster-parameter-groups` AWS CLI 작업을 사용하여 클러스터 파라미터 그룹이 생성되었는지 확인할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 클러스터 파라미터 그룹 설명](cluster_parameter_groups-describe.md) 단원을 참조하십시오.

------
#### [ Using the AWS Management Console ]

**클러스터 파라미터 그룹을 생성하려면**

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다.

1. 탐색 창에서 **파라미터 그룹**을 선택합니다.
**작은 정보**  
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택하십시오.

1. **클러스터 파라미터 그룹** 창에서 **생성**을 선택합니다.

1. **클러스터 파라미터 그룹 만들기** 창에서 다음을 입력합니다.

   1. **새 클러스터 파라미터 그룹 이름** - 클러스터 파라미터 그룹의 이름을 입력합니다. 예를 들어 `sample-parameter-group`입니다. 클러스터 파라미터 그룹에는 다음과 같은 명명 제약 조건이 있습니다.
      + [1-255]자 길이의 영숫자 문자입니다.
      + 첫 번째 문자는 글자이어야 합니다.
      + 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다.

   1. **패밀리** - 클러스터에 사용할 DocumentDB 버전을 선택합니다.

   1. **설명** - 이 클러스터 파라미터 그룹에 대한 설명을 제공합니다.

1. 클러스터 파라미터 그룹을 생성하려면 **생성**을 선택합니다. 작업을 취소하려면 **취소**를 선택합니다.

1. **생성**을 선택하면 클러스터 파라미터 그룹이 성공적으로 생성되었는지 확인하기 위해 페이지 상단에 다음 텍스트가 나타납니다.

   ```
   Successfully created cluster parameter group 'sample-parameter-group'.
   ```

------
#### [ Using the AWS CLI ]

Amazon DocumentDB 4.0 클러스터에 AWS CLI `create-db-cluster-parameter-group` 대한 새 클러스터 파라미터 그룹을 생성하려면 다음 파라미터와 함께 작업을 사용합니다.
+ **--db-cluster-parameter-group-name** - 사용자 지정 클러스터 파라미터 그룹의 이름입니다. 예를 들어 `sample-parameter-group`입니다.
+ **--db-cluster-parameter-group-family** - 사용자 지정 클러스터 파라미터 그룹의 템플릿으로 사용되는 클러스터 파라미터 그룹 패밀리입니다.
+ **--description** - 이 클러스터 파라미터 그룹에 대해 사용자가 제공한 설명입니다. 다음 예에는 “`Custom docdb4.0 parameter group`“이 사용됩니다.

Linux, macOS 또는 Unix의 경우:

**Example**  

```
aws docdb create-db-cluster-parameter-group \
 --db-cluster-parameter-group-name sample-parameter-group \
 --db-parameter-group-family docdb5.0 \
 --description "Custom docdb5.0 parameter group"
```
Windows의 경우:  

```
aws docdb create-db-cluster-parameter-group ^
 --db-cluster-parameter-group-name sample-parameter-group ^
 --db-parameter-group-family docdb5.0 ^
 --description "Custom docdb5.0 parameter group"
```
이 작업의 출력은 다음과 같습니다(JSON 형식).  

```
{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "sample-parameter-group",
        "DBParameterGroupFamily": "docdb5.0",
        "Description": "Custom docdb4.0 parameter group",
        "DBClusterParameterGroupArn": "sample-parameter-group-arn"
    }
}
```

------

# Amazon DocumentDB 클러스터 파라미터 그룹 수정
<a name="cluster_parameter_groups-modify"></a>

이 단원에서는 *사용자 지정* 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. **수정 `<parameter-name>`** 대화 상자에서 원하는 대로 변경합니다. 그런 다음 **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 클러스터 수정
<a name="cluster_parameter_groups-modify_clusters"></a>

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 클러스터 파라미터 그룹 복사
<a name="cluster_parameter_groups-copy"></a>

 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 클러스터 파라미터 그룹 재설정
<a name="cluster_parameter_groups-reset"></a>

 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 클러스터 파라미터 그룹 삭제
<a name="cluster_parameter_groups-delete"></a>

 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 클러스터 파라미터 참조
<a name="cluster_parameter_groups-list_of_parameters"></a>

동적 파라미터를 변경하고 클러스터 파라미터 그룹을 저장하면 *즉시 적용* 설정과 관계없이 변경 사항이 바로 적용됩니다. 고정 파라미터를 변경하고 클러스터 파라미터 그룹을 저장하면 인스턴스를 수동으로 재부팅한 후에 파라미터 변경 사항이 적용됩니다. 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 클러스터 파라미터 수정
<a name="cluster_parameter_groups-parameters"></a>

Amazon DocumentDB에서 *클러스터 파라미터 그룹*은 클러스터에서 만드는 모든 인스턴스에 적용되는 *파라미터*로 구성됩니다. 사용자 지정 클러스터 파라미터 그룹의 경우 언제든지 파라미터 값을 수정하거나 모든 파라미터 값을 사용자가 생성하는 파라미터 그룹에 대한 기본값으로 재설정할 수 있습니다. 이 단원에서는 Amazon DocumentDB 클러스터 파라미터 그룹을 구성하는 파라미터 및 해당 값을 확인하는 방법과 이러한 값을 변경하거나 업데이트하는 방법에 대해 설명합니다.

파라미터는 *동적*이거나 *정적*일 수 있습니다. 동적 파라미터를 변경하고 클러스터 파라미터 그룹을 저장하면 `Apply Immediately` 설정과 관계없이 변경 사항이 바로 적용됩니다. 고정 파라미터를 변경하고 클러스터 파라미터 그룹을 저장하면 인스턴스를 수동으로 재부팅한 후에만 파라미터 변경 사항이 적용됩니다.

## Amazon DocumentDB 클러스터 파라미터 그룹의 파라미터 보기
<a name="cluster_parameter_groups-describe_details_parameters"></a>

 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 클러스터 파라미터 그룹의 파라미터 수정
<a name="cluster_parameter_groups-modify_parameters"></a>

 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"
           }
       ]
   }
   ```

------