

# Amazon Aurora 数据库集群的数据库集群参数组
<a name="USER_WorkingWithDBClusterParamGroups"></a>

Amazon Aurora 数据库集群使用数据库集群参数组。以下各节介绍配置和管理数据库集群参数组。

**Topics**
+ [Amazon Aurora 数据库集群和数据库实例参数](#Aurora.Managing.ParameterGroups)
+ [在 Amazon Aurora 中创建数据库集群参数组](USER_WorkingWithParamGroups.CreatingCluster.md)
+ [在 Amazon Aurora 中将数据库集群参数组与数据库集群关联](USER_WorkingWithParamGroups.AssociatingCluster.md)
+ [在 Amazon Aurora 中修改数据库集群参数组中的参数](USER_WorkingWithParamGroups.ModifyingCluster.md)
+ [在 Amazon Aurora 中重置数据库集群参数组中的参数](USER_WorkingWithParamGroups.ResettingCluster.md)
+ [在 Amazon Aurora 中复制数据库集群参数组](USER_WorkingWithParamGroups.CopyingCluster.md)
+ [在 Amazon Aurora 中列出数据库集群参数组](USER_WorkingWithParamGroups.ListingCluster.md)
+ [在 Amazon Aurora 中查看数据库集群参数组的参数值](USER_WorkingWithParamGroups.ViewingCluster.md)
+ [在 Amazon Aurora 中删除数据库集群参数组](USER_WorkingWithParamGroups.DeletingCluster.md)

## Amazon Aurora 数据库集群和数据库实例参数
<a name="Aurora.Managing.ParameterGroups"></a>

 Aurora 使用二级的配置设置系统：
+  *数据库集群参数组*中的参数适用于数据库集群中的每个数据库实例。您的数据存储在 Aurora 共享存储子系统中。因此，与表数据的物理布局相关的所有参数对于 Aurora 集群中的所有数据库实例都必须是相同的。同样，由于 Aurora 数据库实例通过复制连接，复制设置的所有参数在整个 Aurora 集群中也必须是一致的。
+  *数据库参数组*中的参数适用于 Aurora 数据库集群中的单个数据库实例。这些参数与您可以在同一个 Aurora 集群中的各个数据库实例中更改的各个方面（如内存使用率）相关。例如，集群通常包含具有不同 AWS 实例类的数据库实例。

 每个 Aurora 集群与一个数据库集群参数组关联。此参数组为相应数据库引擎的每个配置值分配默认值。集群参数组还包括集群级和实例级参数的原定设置。预置或 Aurora Serverless v2 集群中的每个数据库实例都继承来自该数据库集群参数组的设置。

 每个数据库实例也都与一个数据库参数组关联。数据库参数组中的值可以覆盖集群参数组中的默认值。例如，如果群集中的一个实例遇到问题，则可以为该实例分配一个自定义数据库参数组。对于与调试或性能优化相关的参数，该自定义参数组可能具有特定设置。

 创建集群或新数据库实例时，Aurora 会根据指定的数据库引擎和版本分配默认参数组。您可以改为指定自定义参数组。您可以自行创建这些参数组，并可以编辑参数值。您可以在创建时指定这些自定义参数组。您还可以稍后修改数据库集群或实例以使用自定义参数组。

 对于预置和 Aurora Serverless v2 实例，您在数据库集群参数组中修改的任意配置值将覆盖数据库参数组中的默认值。如果您在数据库参数组中编辑对应的值，则这些值将覆盖数据库集群参数组中的设置。

 您修改的任何数据库参数设置均优先于数据库集群参数组值，即使您将配置参数更改回其默认值。您可以使用 [describe-db-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) AWS CLI 命令或 [DescribeDBParameters](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) RDS API 操作查看哪些参数被覆盖。如果您修改了该参数，`Source` 字段将包含值 `user`。若要重置一个或多个参数，以使数据库集群参数组的值优先，请使用 [reset-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html) AWS CLI 命令或 [ResetDBParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html) RDS API 操作。

Aurora 中可供您使用的数据库集群和数据库实例参数因数据库引擎兼容性而异。


| 数据库引擎 | 参数 | 
| --- | --- | 
|  Aurora MySQL  |  请参阅 [Aurora MySQL 配置参数](AuroraMySQL.Reference.ParameterGroups.md)。  对于 Aurora Serverless 集群，请参阅 [使用 Aurora Serverless v2 的参数组](aurora-serverless-v2.setting-capacity.md#aurora-serverless-v2.parameter-groups)和 [Aurora Serverless v1 的参数组](aurora-serverless-v1.how-it-works.md#aurora-serverless.parameter-groups)中的其他详细信息。  | 
|  Aurora PostgreSQL  |  请参阅[Amazon Aurora PostgreSQL 参数](AuroraPostgreSQL.Reference.ParameterGroups.md)。  对于 Aurora Serverless 集群，请参阅 [使用 Aurora Serverless v2 的参数组](aurora-serverless-v2.setting-capacity.md#aurora-serverless-v2.parameter-groups)和 [Aurora Serverless v1 的参数组](aurora-serverless-v1.how-it-works.md#aurora-serverless.parameter-groups)中的其他详细信息。  | 

**注意**  
 Aurora Serverless v1 集群只有数据库集群参数组，而没有数据库参数组。对于 Aurora Serverless v2 集群，您对数据库集群参数组中的自定义参数进行所有更改。  
 Aurora Serverless v2 使用数据库集群参数组和数据库参数组。使用 Aurora Serverless v2，您几乎可以修改所有配置参数。Aurora Serverless v2 覆盖某些与容量相关的配置参数的设置，以便在 Aurora Serverless v2 实例缩减的情况下不会中断工作负载。  
 要了解有关 Aurora Serverless 配置设置以及您可以修改哪些设置的更多信息，请参阅 [使用 Aurora Serverless v2 的参数组](aurora-serverless-v2.setting-capacity.md#aurora-serverless-v2.parameter-groups)和 [Aurora Serverless v1 的参数组](aurora-serverless-v1.how-it-works.md#aurora-serverless.parameter-groups)。

# 在 Amazon Aurora 中创建数据库集群参数组
<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.aurora-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) 命令。

以下示例为 Aurora MySQL 版本 5.7 创建名为 *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 aurora-mysql5.7 \
    --description "My new cluster parameter group"
```
对于：Windows  

```
aws rds create-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --db-parameter-group-family aurora-mysql5.7 ^
    --description "My new cluster parameter group"
```
此命令生成类似于下述信息的输出：  

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

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

# 在 Amazon Aurora 中将数据库集群参数组与数据库集群关联
<a name="USER_WorkingWithParamGroups.AssociatingCluster"></a>

您可以使用自定义设置创建自己的数据库集群参数组。之后可以使用 AWS 管理控制台、AWS CLI 或 RDS API 关联数据库集群参数组与数据库集群。在创建或修改数据库集群时可以执行此操作。

有关创建数据库集群参数组的信息，请参阅[在 Amazon Aurora 中创建数据库集群参数组](USER_WorkingWithParamGroups.CreatingCluster.md)。有关创建数据库集群的信息，请参阅[创建 Amazon Aurora 数据库集群](Aurora.CreateInstance.md)。有关修改数据库集群的信息，请参阅[修改 Amazon Aurora 数据库集群](Aurora.Modifying.md)。

**注意**  
对于 Aurora PostgreSQL 15.2、14.7、13.10、12.14 和所有 11 版本，当您更改与数据库集群关联的数据库集群参数组时，需重启每个副本实例以应用这些更改。  
要确定是否必须重启数据库集群的主数据库实例才能应用更改，请运行以下 AWS CLI 命令：  
`aws rds describe-db-clusters --db-cluster-identifier db_cluster_identifier`  
检查 `DBClusterParameterGroupStatus` 输出中主数据库实例的值。如果值为 `pending-reboot`，则重启数据库集群的主数据库实例。

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

**关联数据库集群参数组与数据库集群**

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

1. 在导航窗格中，选择 **Databases (数据库)**，然后选择您希望修改的数据库集群。

1. 选择**修改**。此时会显示**修改数据库集群**页面。

1. 更改**数据库集群参数组**设置。

1. 选择**继续**，查看修改摘要。

   无论**修改计划**设置如何，系统都会立即应用更改。

1. 在确认页面上，检查您的更改。如果更改正确无误，请选择**修改集群**以保存更改。

   或者，选择 **Back (返回)** 编辑您的更改，或者选择 **Cancel (取消)** 取消更改。

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

要关联数据库集群参数组与数据库集群，请使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) 命令及以下选项：
+ `--db-cluster-name`
+ `--db-cluster-parameter-group-name`

以下示例关联了 `mydbclpg` 数据库参数组与 `mydbcluster` 数据库集群。

**Example**  
对于 Linux、macOS 或 Unix：  

```
aws rds modify-db-cluster \
    --db-cluster-identifier mydbcluster \
    --db-cluster-parameter-group-name mydbclpg
```
对于 Windows：  

```
aws rds modify-db-cluster ^
    --db-cluster-identifier mydbcluster ^
    --db-cluster-parameter-group-name mydbclpg
```

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

要关联数据库集群参数组与数据库集群，请使用 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) 操作及以下参数：
+ `DBClusterIdentifier`
+ `DBClusterParameterGroupName`

# 在 Amazon Aurora 中修改数据库集群参数组中的参数
<a name="USER_WorkingWithParamGroups.ModifyingCluster"></a>

您可以修改客户创建的数据库集群参数组中的参数值。您无法更改默认数据库集群参数组中的参数值。对客户创建的数据库集群参数组中的参数所做的更改将应用于与此数据库集群参数组关联的所有数据库集群。

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

**修改数据库集群参数组**

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

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

1. 在此列表中，选择要修改的参数组。

1. 对于 **Parameter group actions (参数组操作)**，选择 **Edit (编辑)**。

1. 更改要修改的参数的值。您可使用对话框右上方的箭头键滚动参数。

   您无法更改默认参数组中的值。

1. 选择**保存更改**。

1. 重启集群中的主（写入器）数据库实例以对其应用更改。

1. 然后，重启读取器数据库实例以对其应用更改。

   如果您不重启数据库实例，则失效转移操作需要的时间可能比正常情况下更长。

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

要修改数据库集群参数组，请使用带以下必需参数的 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html) 命令：
+ `--db-cluster-parameter-group-name`
+ `--parameters`

以下示例修改了名为 *mydbclusterparametergroup* 的数据库集群参数组的 `server_audit_logging` 和 `server_audit_logs_upload` 值。

**Example**  
对于 Linux、macOS 或 Unix：  

```
aws rds modify-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" \
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"
```
对于：Windows  

```
aws rds modify-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"
```
该命令产生类似下面的输出：  

```
DBCLUSTERPARAMETERGROUP  mydbclusterparametergroup
```

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

要修改数据库集群参数组，请使用带以下必需参数的 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html) 命令：
+ `DBClusterParameterGroupName`
+ `Parameters`

# 在 Amazon Aurora 中重置数据库集群参数组中的参数
<a name="USER_WorkingWithParamGroups.ResettingCluster"></a>

您可以在客户创建的数据库集群参数组中将参数重置为其默认值。对客户创建的数据库集群参数组中的参数所做的更改将应用于与此数据库集群参数组关联的所有数据库集群。

**注意**  
在默认数据库集群参数组中，参数始终设置为默认值。

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

**将数据库集群参数组中的参数重置为其默认值**

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

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

1. 在列表中，选择参数组。

1. 对于 **Parameter group actions (参数组操作)**，选择 **Edit (编辑)**。

1. 选择要重置为默认值的参数。您可使用对话框右上方的箭头键滚动参数。

   您无法重置默认参数组中的值。

1. 选择**重置**，然后通过选择**重置参数**进行确认。

1. 重启数据库集群中的主数据库实例，以将更改应用于数据库集群中的所有数据库实例。

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

要将数据库集群参数组中的参数重置为其默认值，请使用带以下必要选项的 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-cluster-parameter-group.html) 命令：`--db-cluster-parameter-group-name`。

要重置数据库集群参数组中的所有参数，请指定 `--reset-all-parameters` 选项。要重置特定参数，请指定 `--parameters` 选项。

以下示例将名为 *mydbparametergroup* 的数据库参数组中的所有参数重置为其默认值。

**Example**  
对于 Linux、macOS 或 Unix：  

```
aws rds reset-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbparametergroup \
    --reset-all-parameters
```
对于：Windows  

```
aws rds reset-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbparametergroup ^
    --reset-all-parameters
```

以下示例展示了在名为 *mydbclusterparametergroup* 的数据库集群参数组中将 `server_audit_logging` 和 `server_audit_logs_upload` 重置为其默认值。

**Example**  
对于 Linux、macOS 或 Unix：  

```
aws rds reset-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --parameters "ParameterName=server_audit_logging,ApplyMethod=immediate" \
                 "ParameterName=server_audit_logs_upload,ApplyMethod=immediate"
```
对于：Windows  

```
aws rds reset-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"
```
该命令产生类似下面的输出：  

```
DBClusterParameterGroupName  mydbclusterparametergroup
```

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

要将数据库集群参数组中的参数重置为其默认值，请使用带以下必需参数的 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBClusterParameterGroup.html) 命令：`DBClusterParameterGroupName`。

要重置数据库集群参数组中的所有参数，请将 `ResetAllParameters` 参数设置为 `true`。要重置特定参数，请指定 `Parameters` 参数。

# 在 Amazon Aurora 中复制数据库集群参数组
<a name="USER_WorkingWithParamGroups.CopyingCluster"></a>

您可以复制您创建的自定义数据库集群参数组。当您已创建一个数据库集群参数组并且想在新的数据库集群参数组中包含该组中的大部分自定义参数和值时，复制参数组是一个方便的解决方案。您可通过使用 AWS CLI [copy-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) 命令或 RDS API [CopyDBClusterParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html) 操作来复制数据库集群参数组。

复制数据库集群参数组之后，至少等待 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) 命令，以验证是否创建了数据库集群参数组。

**注意**  
您无法复制默认参数组。不过，您可以创建基于默认参数组的新参数组。  
您无法将数据库集群参数组复制到其他 AWS 账户或 AWS 区域。

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

**复制数据库集群参数组**

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

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

1. 在列表中，选择要复制的自定义参数组。

1. 对于 **Parameter group actions (参数组操作)**，选择 **Copy (复制)**。

1. 在 **New DB parameter group identifier (新数据库参数组标识符)** 中，输入新参数组的名称。

1. 在 **Description (描述)** 中，输入新参数组的描述。

1. 选择 **Copy (复制)**。

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

要复制数据库集群参数组，请使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) 命令及以下必要参数：
+ `--source-db-cluster-parameter-group-identifier`
+ `--target-db-cluster-parameter-group-identifier`
+ `--target-db-cluster-parameter-group-description`

以下示例创建一个名为 `mygroup2` 的新数据库参集群数组，它是数据库集群参数组 `mygroup1` 的副本。

**Example**  
对于 Linux、macOS 或 Unix：  

```
aws rds copy-db-cluster-parameter-group \
    --source-db-cluster-parameter-group-identifier mygroup1 \
    --target-db-cluster-parameter-group-identifier mygroup2 \
    --target-db-cluster-parameter-group-description "DB parameter group 2"
```
对于：Windows  

```
aws rds copy-db-cluster-parameter-group ^
    --source-db-cluster-parameter-group-identifier mygroup1 ^
    --target-db-cluster-parameter-group-identifier mygroup2 ^
    --target-db-cluster-parameter-group-description "DB parameter group 2"
```

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

要复制数据库集群参数组，请将 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterParameterGroup.html) 操作与下列必需参数配合使用：
+ `SourceDBClusterParameterGroupIdentifier`
+ `TargetDBClusterParameterGroupIdentifier`
+ `TargetDBClusterParameterGroupDescription`

# 在 Amazon Aurora 中列出数据库集群参数组
<a name="USER_WorkingWithParamGroups.ListingCluster"></a>

您可以列出为 AWS 账户创建的数据库集群参数组。

**注意**  
当您为特定数据库引擎和版本创建数据库集群时，将自动从默认参数模板创建默认参数组。这些默认参数组包含首选参数设置，并且无法修改。当您创建自定义参数组时，可以修改参数设置。

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

**列出 AWS 账户的所有数据库集群参数组**

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

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

   数据库集群参数组出现在**数据库集群参数组**的**类型**列表中。

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

要列出 AWS 账户的所有数据库集群参数组，请使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusterparameter-groups.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusterparameter-groups.html) 命令。

**Example**  
下例列出了 AWS 账户的所有可用数据库集群参数组。  

```
aws rds describe-db-cluster-parameter-groups
```
以下示例描述了 *mydbclusterparametergroup* 参数组。  
对于 Linux、macOS 或 Unix：  

```
aws rds describe-db-cluster-parameter-groups \
    --db-cluster-parameter-group-name mydbclusterparametergroup
```
对于：Windows  

```
aws rds describe-db-cluster-parameter-groups ^
    --db-cluster-parameter-group-name mydbclusterparametergroup
```
此命令会返回类似以下内容的响应：  

```
{
    "DBClusterParameterGroups": [
        {
            "DBClusterParameterGroupName": "mydbclusterparametergroup",
            "DBParameterGroupFamily": "aurora-mysql5.7",
            "Description": "My new cluster parameter group",
            "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
        }
    ]
}
```

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

要列出 AWS 账户的所有数据库集群参数组，请使用 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterParameterGroups.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterParameterGroups.html) 操作。

# 在 Amazon Aurora 中查看数据库集群参数组的参数值
<a name="USER_WorkingWithParamGroups.ViewingCluster"></a>

您可获得数据库集群参数组内所有参数的列表及它们的值。

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

**查看数据库集群参数组的参数值**

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

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

   数据库集群参数组出现在**数据库集群参数组**的**类型**列表中。

1. 选择数据库集群参数组的名称以查看其参数列表。

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

要查看数据库集群参数组的参数值，请使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) 命令及以下必要参数。
+ `--db-cluster-parameter-group-name`

**Example**  
以下示例以 JSON 格式列出名为 *mydbclusterparametergroup* 的数据库集群参数组的参数和参数值。  
此命令会返回类似以下内容的响应：  

```
aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name mydbclusterparametergroup
```

```
{
    "Parameters": [
        {
            "ParameterName": "allow-suspicious-udfs",
            "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
            "Source": "engine-default",
            "ApplyType": "static",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": false,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },
        {
            "ParameterName": "aurora_binlog_read_buffer_size",
            "ParameterValue": "5242880",
            "Description": "Read buffer size used by master dump thread when the switch aurora_binlog_use_large_read_buffer is ON.",
            "Source": "engine-default",
            "ApplyType": "dynamic",
            "DataType": "integer",
            "AllowedValues": "8192-536870912",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },

...
```

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

要查看数据库集群参数组的参数值，请使用带下列所需参数的 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) 命令。
+ `DBClusterParameterGroupName`

在某些情况下，不显示参数的允许值。这些始终是源为数据库引擎原定设置值的参数。

要查看这些参数的值，可以运行以下 SQL 语句：
+ MySQL：

  ```
  -- Show the value of a particular parameter
  mysql$ SHOW VARIABLES LIKE '%parameter_name%';
  
  -- Show the values of all parameters
  mysql$ SHOW VARIABLES;
  ```
+ PostgreSQL：

  ```
  -- Show the value of a particular parameter
  postgresql=> SHOW parameter_name;
  
  -- Show the values of all parameters
  postgresql=> SHOW ALL;
  ```

# 在 Amazon Aurora 中删除数据库集群参数组
<a name="USER_WorkingWithParamGroups.DeletingCluster"></a>

您可以使用 AWS 管理控制台、AWS CLI 或 RDS API 删除数据库集群参数组。仅当数据库集群参数组未与数据库集群关联时，才能将其删除。

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

**删除参数组**

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

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

   参数组显示在列表中。

1. 选择要删除的数据库集群参数组的名称。

1. 选择**操作**，然后选择**删除**。

1. 查看参数组名称，然后选择**删除**。

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

要删除数据库集群参数组，请使用带以下必需参数的 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-parameter-group.html) 命令。
+ `--db-parameter-group-name`

**Example**  
以下示例删除了名为 *mydbparametergroup* 的数据库集群参数组。  

```
aws rds delete-db-cluster-parameter-group --db-parameter-group-name mydbparametergroup
```

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

要删除数据库集群参数组，请使用带以下必需参数的 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterParameterGroup.html) 命令。
+ `DBParameterGroupName`