翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon DocumentDB クラスターパラメータグループについて説明します。
`default` クラスターパラメータグループは、新しいリージョンで最初の Amazon DocumentDB クラスターを作成するとき、または新しいエンジンを使用するときに自動的に作成されます。同じリージョンで作成され、同じエンジンバージョンを使用する後続のクラスターは、`default` クラスターパラメータグループを使用して作成されます。
**Topics**
+ [クラスターパラメータグループの詳細情報の説明](#cluster_parameter_groups-describe_details)
+ [クラスターのパラメータグループの確認](#cluster_parameter_groups-determine)
+ [クラスターパラメータグループに関連付けられたクラスターとインスタンスの決定](#cluster_parameter_groups-count)
## Amazon DocumentDB クラスターパラメータグループの詳細について説明します。
特定のクラスターパラメータグループの詳細を記述するには、 AWS マネジメントコンソール または AWS Command Line Interface () を使用して次の手順を実行しますAWS CLI。
------
#### [ Using the AWS マネジメントコンソール ]
****
1. にサインインし AWS マネジメントコンソール、[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/ja_jp/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 マネジメントコンソール または を使用して次の手順を実行します AWS CLI。
------
#### [ Using the AWS マネジメントコンソール ]
1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) で Amazon DocumentDB コンソールを開きます。
1. 左のナビゲーションペインで **[クラスター]** を選択します。
1. クラスターの一覧で、関心のあるクラスターの名前を選択します。
1. 結果のページには、選択したクラスターの詳細が表示されます。[**クラスターの詳細**] まで下にスクロールします。そのセクションの下部で、[**クラスターパラメータグループ**] の下にパラメータグループの名前を見つけます。
![\[スクリーンショット: クラスターのパラメータグループの表示。\]](http://docs.aws.amazon.com/ja_jp/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
}
```
------