本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用多可用區域資料庫叢集的資料庫叢集參數群組
多可用區域資料庫叢集使用資料庫叢集參數群組。以下各節介紹資料庫叢集參數群組的設定和管理。
**Topics**
+ [在 建立資料庫叢集參數群組](USER_WorkingWithParamGroups.CreatingCluster.md)
+ [在 中修改資料庫叢集參數群組中的參數](USER_WorkingWithParamGroups.ModifyingCluster.md)
+ [在 中重設資料庫叢集參數群組中的參數](USER_WorkingWithParamGroups.ResettingCluster.md)
+ [在 複製資料庫叢集參數群組](USER_WorkingWithParamGroups.CopyingCluster.md)
+ [在 列出資料庫叢集參數群組](USER_WorkingWithParamGroups.ListingCluster.md)
+ [在 檢視資料庫叢集參數群組的參數值](USER_WorkingWithParamGroups.ViewingCluster.md)
+ [在 資料庫叢集參數群組](USER_WorkingWithParamGroups.DeletingCluster.md)
# 在 建立資料庫叢集參數群組
您可以使用 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`。不過，自訂參數群組名稱不能包括句點。
+ 第一個字元必須是字母。
+ 名稱不能以連字號結尾或包含兩個連續連字號。
## 主控台
**建立資料庫叢集參數群組**
1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)：// 開啟 Amazon RDS 主控台。
1. 在導覽窗格中，選擇 **Parameter groups** (參數群組)。
1. 選擇 **Create parameter group (建立參數群組)**。
1. 對於**參數群組名稱**，輸入新資料庫叢集參數群組的名稱。
1. 對於**描述**，輸入新資料庫叢集參數群組的描述。
1. 對於**引擎類型**，選擇您的資料庫引擎。
1. 對於**參數群組系列**，選擇資料庫參數群組系列。
1. 選擇**建立**。
## AWS CLI
若要建立資料庫叢集參數群組，請使用 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*，描述為 *My new cluster parameter group* (我的新叢集參數群組) 的資料庫叢集參數群組。
包含下列必要參數：
+ `--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
若要建立資料庫叢集參數群組，請使用 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`
# 在 中修改資料庫叢集參數群組中的參數
您可以修改客戶建立的資料庫叢集參數群組中參數值。您無法變更預設資料庫叢集參數群組中的參數值。客戶建立的資料庫叢集參數群組中的參數變更會套用到與該資料庫叢集參數群組關聯的所有資料庫叢集。
## 主控台
**修改資料庫叢集參數群組**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) 的 Amazon RDS 主控台。
1. 在導覽窗格中，選擇 **Parameter groups (參數群組)**。
1. 在清單中，選擇您要修改的參數群組。
1. 針對 **Parameter group actions (參數群組動作)**，選擇 **Edit (編輯)**。
1. 變更您想要修改的參數值。您可用對話方塊右上角的箭頭鍵來捲動參數。
您無法變更預設參數群組中的值。
1. 選擇**儲存變更**。
1. 將叢集中的重新開機，以套用變更。
若未將叢集重新開機，容錯移轉操作可能會需要比平常更長的時間。
## AWS CLI
若要修改資料庫叢集參數群組，請使用 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
若要修改資料庫叢集參數群組，請使用 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`
# 在 中重設資料庫叢集參數群組中的參數
您可以將參數重設為客戶建立的資料庫叢集參數群組中的預設值。客戶建立的資料庫叢集參數群組中的參數變更會套用到與該資料庫叢集參數群組關聯的所有資料庫叢集。
**注意**
在預設的資料庫叢集參數群組中，參數永遠設定為其預設值。
## 主控台
**將資料庫叢集參數群組中的參數重設為其預設值**
1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)：// 開啟 Amazon RDS 主控台。
1. 在導覽窗格中，選擇 **Parameter groups (參數群組)**。
1. 在清單中，選擇參數群組。
1. 針對 **Parameter group actions (參數群組動作)**，選擇 **Edit (編輯)**。
1. 選擇您要重設為預設值的參數。您可用對話方塊右上角的箭頭鍵來捲動參數。
您無法重設預設參數群組中的值。
1. 選擇「**Reset (重設) **」，然後選擇「**Reset parameters (重設參數) **」來確認。
1. 重新啟動資料庫叢集中的。
## AWS CLI
若要將資料庫叢集參數群組中的參數重設為其預設值，請使用 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
若要將資料庫叢集參數群組中的參數重設為其預設值，請使用 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` 參數。
# 在 複製資料庫叢集參數群組
您可複製所建立的自訂資料庫叢集參數群組。如果您已建立資料庫叢集參數群組，並且希望在新資料庫叢集參數群組中包含該組中的大多數自訂參數和值，則複製參數群組是一種方便的解決方案。您可以使用 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 區域。
## 主控台
**複製資料庫叢集參數群組**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) 的 Amazon RDS 主控台。
1. 在導覽窗格中，選擇 **Parameter groups (參數群組)**。
1. 在清單中，選擇您要複製的自訂參數群組。
1. 針對 **Parameter group actions (參數群組動作)**，選擇 **Copy (複製)**。
1. 在 **New DB parameter group identifier (新資料庫參數群組識別符)** 中，輸入新參數群組的名稱。
1. 在 **Description (描述)** 中，輸入新參數群組的描述。
1. 請選擇 **Copy (複製)**。
## AWS CLI
若要複製資料庫叢集參數群組，請使用 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
若要複製資料庫叢集參數群組，請使用 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`
# 在 列出資料庫叢集參數群組
您可以列出您為 AWS 帳戶建立的資料庫叢集參數群組。
**注意**
當您為特定資料庫引擎和版本建立資料庫叢集時，會從預設的參數範本自動建立預設的參數群組。這些預設參數群組包含偏好的參數設定，無法修改。當您建立自訂參數群組時，您可以修改參數設定。
## 主控台
**列出 AWS 帳戶的所有資料庫叢集參數群組**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) 的 Amazon RDS 主控台。
1. 在導覽窗格中，選擇 **Parameter groups (參數群組)**。
資料庫叢集參數群組會以 **DB cluster parameter group (資料庫叢集參數群組)** 出現在 **Type (類型)** 清單中。
## AWS CLI
若要列出 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": "mydbclusterparametergroup2",
"DBParameterGroupFamily": "mysql8.0",
"Description": "My new cluster parameter group",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
}
]
}
```
## RDS API
若要列出 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)動作。
# 在 檢視資料庫叢集參數群組的參數值
您可以從資料庫叢集參數群組取得所有參數與其值的清單。
## 主控台
**檢視資料庫叢集參數群組的參數值**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) 的 Amazon RDS 主控台。
1. 在導覽窗格中，選擇 **Parameter groups (參數群組)**。
資料庫叢集參數群組會以 **DB cluster parameter group (資料庫叢集參數群組)** 出現在 **Type (類型)** 清單中。
1. 選擇資料庫叢集參數群組的名稱，以查看參數清單。
## AWS CLI
若要檢視資料庫叢集參數群組的參數值，請使用 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**
以下範例列出資料庫叢集參數群組 *mydbclusterparametergroup* 的參數和參數值，為 JSON 格式。
此命令會傳回類似以下的回應：
```
aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name mydbclusterparametergroup
```
```
{
"Parameters": [
{
"ParameterName": "activate_all_roles_on_login",
"ParameterValue": "0",
"Description": "Automatically set all granted roles as active after the user has authenticated successfully.",
"Source": "engine-default",
"ApplyType": "dynamic",
"DataType": "boolean",
"AllowedValues": "0,1",
"IsModifiable": true,
"ApplyMethod": "pending-reboot",
"SupportedEngineModes": [
"provisioned"
]
},
{
"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"
]
},
...
```
## RDS API
若要檢視資料庫叢集參數群組的參數值，請搭配下列必要參數使用 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;
```
# 在 資料庫叢集參數群組
您可以使用 AWS 管理主控台 AWS CLI或 RDS API 刪除資料庫叢集參數群組。資料庫叢集參數群組參數群組只有在未與資料庫叢集相關聯時，才符合刪除條件。
## 主控台
**刪除參數群組**
1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)：// 開啟 Amazon RDS 主控台。
1. 在導覽窗格中，選擇 **Parameter groups** (參數群組)。
參數群組隨即出現在清單中。
1. 選擇要刪除的資料庫叢集參數群組的名稱。
1. 選擇**動作**，然後選擇**刪除**。
1. 檢閱參數群組名稱，然後選擇**刪除**。
## AWS CLI
若要刪除資料庫叢集參數群組，請使用 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
若要刪除資料庫叢集參數群組，請使用 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`