# 创建数据库集群参数组
<a name="USER_WorkingWithParamGroups.CreatingCluster"></a>

您可以使用 AWS 管理控制台、AWS CLI 或 RDS API 创建新数据库集群参数组。

创建数据库集群参数组之后，至少等待 5 分钟，然后创建使用该数据库集群参数组的数据库集群。这样，Amazon RDS 就可以在新数据库集群使用参数组之前完全创建此参数组。您可以使用 [Amazon RDS 控制台](https://console.aws.amazon.com/rds/)的 **Parameter groups**（参数组）页面，或者使用 [describe-db-cluster-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) 命令，以验证是否创建了数据库集群参数组。

以下限制适用于数据库集群参数组名称：
+ 名称必须为 1 到 255 个字母、数字或连字符。

  原定设置参数组名称可以包含句点，例如 `default.mysql5.7`。但是，自定义参数组名称不能包含句点。
+ 第一个字符必须是字母。
+ 名称不能以连字符结束，也不能包含两个连续的连字符。

## 控制台
<a name="USER_WorkingWithParamGroups.CreatingCluster.CON"></a>

**若要创建数据库集群参数组**

1. 登录 AWS 管理控制台 并通过以下网址打开 Amazon RDS 控制台：[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)。

1. 在导航窗格中，选择**参数组**。

1. 选择**创建参数组**。

1. 对于**参数组名称**，输入新数据库集群参数组的名称。

1. 对于**描述**，输入新数据库集群参数组的描述。

1. 对于**引擎类型**，请选择数据库引擎。

1. 对于**参数组系列**，请选择一个数据库参数组系列。

1. 选择**创建**。

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

要创建数据库集群参数组，请使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-parameter-group.html) 命令。

以下示例为 RDS for MySQL 版本 8.0 创建名为 *mydbclusterparametergroup* 的数据库集群参数组，其说明为“*我的新集群参数组*”。

包括以下必需参数：
+ `--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>

要创建数据库集群参数组，请使用 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`