기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon DocumentDB 클러스터 파라미터 그룹 설명
새 지역에서 첫 번째 Amazon DocumentDB 클러스터를 생성하거나 새 엔진을 사용할 때 `default` 클러스터 파라미터 그룹이 자동으로 생성됩니다. 동일한 지역에 생성되고 엔진 버전이 동일한 후속 클러스터는 `default` 클러스터 파라미터 그룹을 사용하여 생성됩니다.
**Topics**
+ [클러스터 파라미터 그룹의 세부 정보 설명](#cluster_parameter_groups-describe_details)
+ [클러스터의 파라미터 그룹 확인](#cluster_parameter_groups-determine)
+ [클러스터 파라미터 그룹과 연결된 클러스터 및 인스턴스 확인](#cluster_parameter_groups-count)
## Amazon DocumentDB 클러스터 파라미터 그룹의 세부 정보 설명
지정된 클러스터 파라미터 그룹의 세부 정보를 설명하려면 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 클러스터의 파라미터 그룹 확인
특정 클러스터와 연결된 파라미터 그룹을 확인하려면 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 클러스터 파라미터 그룹과 연결된 클러스터 및 인스턴스 확인
각 파라미터 그룹과 연결된 클러스터 및 인스턴스 수를 확인하려면를 사용하여 다음 단계를 완료합니다 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
}
```
------