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

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

------