# DB クラスターパラメータグループの作成
<a name="USER_WorkingWithParamGroups.CreatingCluster"></a>

新しい DB クラスターパラメータグループは、AWS マネジメントコンソール、AWS CLI、または RDS API を使って作成できます。

DB クラスターパラメータグループの作成後、その DB クラスターパラメータグループを使用する最初の DB クラスターが作成されるまで、5 分以上かかります。これにより、Amazon RDS は新しい DB クラスターによって使用される前に、パラメータグループを完全に作成することができます。DB クラスターパラメータグループが作成されたことを確認するには、[Amazon RDS コンソール](https://console.aws.amazon.com/rds/)の **[パラメータグループ]** ページまたは [describe-db-cluster-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) コマンドを使用できます。

DB クラスターパラメータグループ名には、次の制限事項が適用されます。
+ 名前は、1～255 の英字、数字、ハイフンである必要があります。

  デフォルトのパラメータグループ名には、`default.mysql5.7` のようなピリオドを含めることができます。ただし、カスタムパラメータグループ名にはピリオドを含めることはできません。
+ 1 字目は文字である必要があります。
+ 名前の最後にハイフンを使用したり、ハイフンを 2 つ続けて使用したりすることはできません。

## コンソール
<a name="USER_WorkingWithParamGroups.CreatingCluster.CON"></a>

**DB クラスターパラメータグループを作成するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. ナビゲーションペインで、**[パラメータグループ]** を選択します。

1. **[パラメータグループの作成]** を選択します。

1. **[パラメータグループ名]** に、新しい DB クラスターパラメータグループの名前を入力します。

1. **[説明]** に、新しい DB クラスターパラメータグループの説明を入力します。

1. **[エンジンタイプ]** でデータベースエンジンを選択します。

1. **[パラメータグループファミリー]** で、DB パラメータグループファミリーを選択します。

1. **[作成]** を選択します。

## AWS CLI
<a name="USER_WorkingWithParamGroups.CreatingCluster.CLI"></a>

DB クラスターのパラメータグループを作成するには、AWS CLI​ の [​`create-db-cluster-parameter-group`](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-parameter-group.html)​ コマンドを使用します。

次の例では、RDS for MySQL バージョン 8.0 用に、*mydbclusterparametergroup* という名前で、「*My new cluster parameter group*」(新しいクラスターパラメータグループ) という説明の DB クラスターパラメータグループを作成しています。

以下の必須パラメータを含めます。
+ `--db-cluster-parameter-group-name`
+ `--db-parameter-group-family`
+ `--description`

使用可能なすべてのパラメータグループファミリーを一覧表示するには、次のコマンドを使用します。

```
aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"
```

**注記**  
出力は重複が含まれます。

**Example**  
Linux、macOS、Unix の場合:  

```
aws rds create-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --db-parameter-group-family mysql8.0 \
    --description "My new cluster parameter group"
```
Windows の場合:  

```
aws rds create-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --db-parameter-group-family mysql8.0 ^
    --description "My new cluster parameter group"
```
このコマンドでは、以下のような出力が生成されます。  

```
{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "mydbclusterparametergroup",
        "DBParameterGroupFamily": "mysql8.0",
        "Description": "My new cluster parameter group",
        "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup2"
    }
}
```

## RDS API
<a name="USER_WorkingWithParamGroups.CreatingCluster.API"></a>

DB クラスターのパラメータグループを作成するには、​RDS API の ​[https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterParameterGroup.html) アクションを使用します。

以下の必須パラメータを含めます。
+ `DBClusterParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`