本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon RDS 的參數群組
*資料庫參數*指定資料庫的配置方式。例如，資料庫參數可以指定要配置給資料庫的資源量 (例如記憶體)。
您可利用參數群組建立資料庫執行個體和多可用區域資料庫叢集的關聯性，以此管理資料庫組態。Amazon RDS 使用預設設定來定義參數群組。您也可以使用自訂設定，定義自己的參數群組。
**注意**
某些資料庫引擎提供附加功能，您可將其作為選項群組中的選項新增至您的資料庫。如需選項群組的詳細資訊，請參閱 [使用選項群組](USER_WorkingWithOptionGroups.md)。
**Topics**
+ [
# 參數群組概觀
](parameter-groups-overview.md)
+ [
# Amazon RDS 資料庫執行個體的資料庫參數群組
](USER_WorkingWithDBInstanceParamGroups.md)
+ [
# 使用多可用區域資料庫叢集的資料庫叢集參數群組
](USER_WorkingWithDBClusterParamGroups.md)
+ [
# 比較資料庫參數群組
](USER_WorkingWithParamGroups.Comparing.md)
+ [
# 指定資料庫參數
](USER_ParamValuesRef.md)
# 參數群組概觀
*資料庫參數群組*扮演引擎組態值的容器，以套用至一或多個資料庫執行個體。
*資料庫叢集參數群組*僅適用於多可用區域資料庫叢集。在多可用區域資料庫叢集中，資料庫叢集參數群組中的設定會套用至叢集中的所有資料庫執行個體。資料庫引擎和資料庫引擎版本的預設資料庫參數群組會用於資料庫叢集中的每個資料庫執行個體。
**Topics**
+ [
## 預設和自訂參數群組
](#parameter-groups-overview.custom)
+ [
## 靜態和動態資料庫執行個體參數
](#parameter-groups-overview.db-instance)
+ [
## 靜態和動態資料庫叢集參數
](#parameter-groups-overview.maz)
+ [
## 字元集參數
](#parameter-groups-overview.char-sets)
+ [
## 支援的參數和參數值
](#parameter-groups-overview.supported)
## 預設和自訂參數群組
如果建立的資料庫執行個體未指定資料庫參數群組，則會使用預設的資料庫參數群組。同樣地，如果您建立多可用區域資料庫叢集，而未指定資料庫叢集參數群組，資料庫叢集將使用預設的資料庫叢集參數群組。每個預設的參數群組將依引擎、運算等級和執行個體分配儲存包含資料庫引擎預設值和 Amazon RDS 系統預設值。
您無法修改預設參數群組的參數設定。相反地，您可以執行下列作業：
1. 建立新的參數群組。
1. 變更所需參數的設定。並非參數群組中的所有資料庫引擎參數都有資格進行修改。
1. 然後修改資料庫執行個體或資料庫叢集，以與新的參數群組建立關聯。
將新的資料庫參數群組與資料庫執行個體建立關聯時，會立即發生關聯。如需修改資料庫執行個體的相關資訊，請參閱 [修改 Amazon RDS 資料庫執行個體](Overview.DBInstance.Modifying.md)。如需修改多可用區域資料庫叢集的詳細資訊，請參閱 [使用 Amazon RDS 修改多可用區域資料庫叢集](modify-multi-az-db-cluster.md)。
**注意**
如果您已將資料庫執行個體修改為使用自訂參數群組，並啟動資料庫執行個體，RDS 會在啟動過程中自動重新啟動資料庫執行個體。對於已啟用 AlwaysOn 或鏡像選項的 RDS for SQL Server 多可用區執行個體，在啟動程序後將執行個體重新開機時，預期會發生容錯移轉。
只有在將資料庫執行個體重新開機之後，RDS 才會在新關聯的參數群組中套用已修改的靜態參數和動態參數。不過，如果您在將資料庫參數群組與資料庫執行個體建立關聯之後修改該群組中的動態參數，則會立即套用這些變更，而不需重新開機。如需變更資料庫叢集參數群組的詳細資訊，請參閱 [修改 Amazon RDS 資料庫執行個體](Overview.DBInstance.Modifying.md)。
如果您在資料庫參數群組內更新參數，變更會應用到所有和參數群組建立連結的資料庫執行個體。同樣地，如果您在多可用區域資料庫叢集參數群組內更新參數，變更會套用到所有與資料庫叢集參數群組相關聯的 Aurora 資料庫叢集。
如果您不想從頭開始建立參數群組，您可以使用 AWS CLI [copy-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html) 命令或 [copy-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) 命令複製現有的參數群組。在某些情況下，您可能會發現複製參數群組很有用。例如，您可能想要將其大部份現有資料庫參數群組的自訂參數及值併入新的資料庫參數群組。
## 靜態和動態資料庫執行個體參數
資料庫執行個體參數可為靜態或動態。它們不同之處如下：
+ 當您變更靜態參數並儲存資料庫參數群組時，參數變更會在您手動重新啟動相關聯的資料庫執行個體後生效。若為靜態參數，主控台一律將 `pending-reboot` 用於 `ApplyMethod`。
+ 變更動態參數時，參數變更預設會立即生效，無需重新啟動。當您使用 AWS 管理主控台 變更資料庫執行個體參數值時，一律會將 `immediate`用於`ApplyMethod`動態參數。若要將參數變更延遲到重新啟動相關聯的資料庫執行個體之後，請使用 AWS CLI 或 RDS API。將 `ApplyMethod` 設定為 `pending-reboot` 以進行參數變更。
**注意**
在 中使用 `pending-reboot`搭配動態參數， AWS CLI 或在 RDS for SQL Server 資料庫執行個體上使用 RDS API 會產生錯誤。在 RDS for SQL Server 上使用 `apply-immediately`。
如需使用 AWS CLI 變更參數值的詳細資訊，請參閱 [modify-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html)。如需使用 RDS API 來變更參數值的更多資訊，請參閱 [ModifyDBParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html)。
如果資料庫執行個體未在其相關聯的資料庫參數群組中使用最新的變更，主控台會將資料庫參數群組的狀態顯示為 **pending-reboot**。此狀態不會在下一個維護時段期間造成自動重新啟動。如欲對該資料庫執行個體套用最新參數變更，請手動重新啟動資料庫執行個體。
## 靜態和動態資料庫叢集參數
資料庫叢集參數可為靜態或動態。它們不同之處如下：
+ 當您變更靜態參數並儲存資料庫叢集參數群組時，參數變更會在您手動重新啟動相關聯的資料庫叢集後生效。若為靜態參數，主控台一律將 `pending-reboot` 用於 `ApplyMethod`。
+ 變更動態參數時，參數變更預設會立即生效，無需重新啟動。當您使用 AWS 管理主控台 變更資料庫叢集參數值時，一律會將 `immediate`用於`ApplyMethod`動態參數。若要將參數變更延遲到重新啟動關聯的資料庫叢集之後，請使用 AWS CLI 或 RDS API。將 `ApplyMethod` 設定為 `pending-reboot` 以進行參數變更。
如需使用 AWS CLI 變更參數值的詳細資訊，請參閱 [modify-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html)。如需使用 RDS API 來變更參數值的更多資訊，請參閱 [ModifyDBClusterParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html)。
## 字元集參數
在建立資料庫執行個體或多可用區域資料庫叢集之前，先在參數群組中設定與字元集或資料庫定序相關的任何參數。也會在其中建立資料庫之前這樣做。透過此方式，您可以確保預設資料庫和新資料庫皆使用您指定的字元集和定序值。如果您變更字元集和定序參數，參數變更將不會套用到現有資料庫。
針對部分資料庫引擎，您可以使用 `ALTER DATABASE` 命令變更現有資料庫的字元集或定序值，例如：
```
ALTER DATABASE database_name CHARACTER SET character_set_name COLLATE collation;
```
如需變更資料庫的字元集或定序值的詳細資訊，請參閱適用於您資料庫引擎的文件。
## 支援的參數和參數值
若要判斷資料庫引擎的支援參數，您可以檢視資料庫執行個體或資料庫叢集所使用的資料庫參數群組和資料庫叢集參數群組中的參數。如需詳細資訊，請參閱[在 Amazon RDS 中檢視資料庫參數群組的參數值](USER_WorkingWithParamGroups.Viewing.md)及[在 檢視資料庫叢集參數群組的參數值](USER_WorkingWithParamGroups.ViewingCluster.md)。
在許多情況下，您可使用運算式、公式和函數來指定整數及布林值參數。函數可包含數學的對數表達式。但是，並非所有參數都支援參數值的表達式、公式和函數。如需詳細資訊，請參閱[指定資料庫參數](USER_ParamValuesRef.md)。
未正確設定參數群組中的參數，可能產生各種意外影響，包括效能降低和系統不穩定。修改資料庫參數時請務必謹慎，在修改參數群組之前，請備份資料。在將這些參數群組變更套用到生產資料庫執行個體或資料庫叢集之前，請在測試資料庫執行個體或資料庫叢集上嘗試參數群組設定變更。
# Amazon RDS 資料庫執行個體的資料庫參數群組
資料庫執行個體會使用資料庫參數群組。以下各節介紹資料庫執行個體參數群組的設定和管理。
**Topics**
+ [
# 在 Amazon RDS 中建立資料庫參數群組
](USER_WorkingWithParamGroups.Creating.md)
+ [
# 將資料庫參數群組與 Amazon RDS 中的資料庫執行個體建立關聯
](USER_WorkingWithParamGroups.Associating.md)
+ [
# 修改 Amazon RDS 中的資料庫參數群組中的參數
](USER_WorkingWithParamGroups.Modifying.md)
+ [
# 在 Amazon RDS 中將資料庫參數群組中的參數重設為預設值
](USER_WorkingWithParamGroups.Resetting.md)
+ [
# 在 Amazon RDS 中複製資料庫參數群組
](USER_WorkingWithParamGroups.Copying.md)
+ [
# 列出 Amazon RDS 中的資料庫參數群組
](USER_WorkingWithParamGroups.Listing.md)
+ [
# 在 Amazon RDS 中檢視資料庫參數群組的參數值
](USER_WorkingWithParamGroups.Viewing.md)
+ [
# 在 Amazon RDS 中刪除資料庫參數群組
](USER_WorkingWithParamGroups.Deleting.md)
# 在 Amazon RDS 中建立資料庫參數群組
您可以使用 AWS 管理主控台、 AWS CLI或 RDS API 建立新的資料庫參數群組。
下列限制適用於資料庫參數群組名稱：
+ 名稱必須為 1 到 255 個字母、數字或連字號。
預設參數群組名稱可以包括句點，例如 `default.mysql8.0`。不過，自訂參數群組名稱不能包括句點。
+ 第一個字元必須是字母。
+ 名稱不能以連字號結尾或包含兩個連續連字號。
## 主控台
**建立資料庫參數群組**
1. 登入 AWS 管理主控台 並開啟位於 https：//[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. 對於**類型** (如果適用)，選擇**資料庫參數群組**。
1. 選擇**建立**。
## AWS CLI
若要建立資料庫參數群組，請使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html) 命令。下列範例將為 MySQL 8.0 版建立一個名為 *mydbparametergroup* 的資料庫參數群組，其說明為「*My new parameter group* (我的新參數群組)」。
包含下列必要參數：
+ `--db-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-parameter-group \
--db-parameter-group-name mydbparametergroup \
--db-parameter-group-family MySQL8.0 \
--description "My new parameter group"
```
在 Windows 中：
```
aws rds create-db-parameter-group ^
--db-parameter-group-name mydbparametergroup ^
--db-parameter-group-family MySQL8.0 ^
--description "My new parameter group"
```
此命令會產生類似下列的輸出：
```
DBPARAMETERGROUP mydbparametergroup mysql8.0 My new parameter group
```
## RDS API
若要建立資料庫參數群組，請使用 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html) 操作。
包含下列必要參數：
+ `DBParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`
# 將資料庫參數群組與 Amazon RDS 中的資料庫執行個體建立關聯
您可以使用自訂設定，建立自己的資料庫參數群組。您可以使用 AWS 管理主控台 AWS CLI、 或 RDS API，將資料庫參數群組與資料庫執行個體建立關聯。您可以在建立或修改資料庫執行個體時執行此動作。
如需建立資料庫參數群組的資訊，請參閱[在 Amazon RDS 中建立資料庫參數群組](USER_WorkingWithParamGroups.Creating.md)。如需建立資料庫執行個體的相關資訊，請參閱 [建立 Amazon RDS 資料庫執行個體](USER_CreateDBInstance.md)。如需修改資料庫執行個體的相關資訊，請參閱 [修改 Amazon RDS 資料庫執行個體](Overview.DBInstance.Modifying.md)。
**注意**
當您建立新資料庫參數群組與資料庫執行個體的關聯時，只有在資料庫執行個體重新開機之後，才會套用修改過的靜態參數和動態參數。不過，如果您在將資料庫參數群組與資料庫執行個體建立關聯之後修改該群組中的動態參數，則會立即套用這些變更，而不需重新開機。
## 主控台
**將資料庫參數群組與資料庫執行個體建立關聯**
1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)：// 開啟 Amazon RDS 主控台。
1. 在導覽窗格中選擇 **Databases** (資料庫)，然後選擇您要修改的資料庫執行個體。
1. 選擇 **Modify (修改)**。**Modify DB instance (修改資料庫執行個體)** 頁面隨即出現。
1. 變更 **DB parameter group** (資料庫參數群組) 設定。
1. 選擇 **Continue (繼續)**，並檢查修改的摘要。
1. (選用) 選擇 **Apply immediately (立即套用)** 以立即套用變更。在某些情況下，選擇此選項會導致停機。如需詳細資訊，請參閱 [使用排程修改設定](USER_ModifyInstance.ApplyImmediately.md)。
1. 在確認頁面上，檢閱您的變更。如果都正確，請選擇 **Modify DB instance** (修改資料庫執行個體) 以儲存您的變更。
或者，選擇 **Back (上一步)** 以編輯變更，或是選擇 **Cancel (取消)** 以取消變更。
## AWS CLI
若要將資料庫參數群組與資料庫執行個體建立關聯，請使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html)命令搭配下列選項：
+ `--db-instance-identifier`
+ `--db-parameter-group-name`
下面的範例將 `mydbpg` 資料庫參數群組與 `database-1` 資料庫執行個體建立關聯。透過 `--apply-immediately`，即可立即套用變更。使用 `--no-apply-immediately` 在下次維護時段套用變更。如需詳細資訊，請參閱 [使用排程修改設定](USER_ModifyInstance.ApplyImmediately.md)。
**Example**
在 Linux、macOS 或 Unix 中：
```
aws rds modify-db-instance \
--db-instance-identifier database-1 \
--db-parameter-group-name mydbpg \
--apply-immediately
```
在 Windows 中：
```
aws rds modify-db-instance ^
--db-instance-identifier database-1 ^
--db-parameter-group-name mydbpg ^
--apply-immediately
```
## RDS API
若要將資料庫參數群組與資料庫執行個體建立關聯，請使用 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) 操作搭配下列參數：
+ `DBInstanceName`
+ `DBParameterGroupName`
# 修改 Amazon RDS 中的資料庫參數群組中的參數
您可修改客戶建立的資料庫參數群組中的參數值；但無法變更預設資料庫參數群組中的參數值。客戶建立的資料庫參數群組中的參數變更會套用到與該資料庫參數群組關聯的所有資料庫執行個體。
有兩種類型的參數：動態參數和靜態參數。動態參數的變更會立即套用至資料庫執行個體，而不會重新啟動。靜態參數的變更只會在資料庫執行個體重新啟動後套用。
RDS 主控台會在 **Configuration (組態)** 標籤上，顯示與資料庫執行個體相關聯的資料庫參數群組的狀態。例如，假如資料庫執行個體未在其關聯的資料庫參數群組中使用最新的變更，RDS 主控台將顯示資料庫參數群組的狀態為 **pending-reboot (等待重新啟動)**。如欲對該資料庫執行個體套用最新參數變更，請手動重新啟動資料庫執行個體。
![\[參數變更擱置中重新啟動的案例\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/UserGuide/images/param-reboot.png)
## 主控台
**修改資料庫參數群組中的參數**
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. 選擇**儲存變更**。
## AWS CLI
若要修改資料庫參數群組，請使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html) 命令搭配下列必要選項：
+ `--db-parameter-group-name`
+ `--parameters`
以下範例將修改名稱為 *mydbparametergroup* 的資料庫參數群組的 ` max_connections` 和 `max_allowed_packet` 值。
**Example**
對於 Linux、macOS 或 Unix：
```
aws rds modify-db-parameter-group \
--db-parameter-group-name mydbparametergroup \
--parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" \
"ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"
```
在 Windows 中：
```
aws rds modify-db-parameter-group ^
--db-parameter-group-name mydbparametergroup ^
--parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" ^
"ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"
```
該命令會產生類似以下的輸出：
```
DBPARAMETERGROUP mydbparametergroup
```
## RDS API
若要修改資料庫參數群組，請使用 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html) 操作，並搭配下列必要參數：
+ `DBParameterGroupName`
+ `Parameters`
# 在 Amazon RDS 中將資料庫參數群組中的參數重設為預設值
您可以將客戶建立的資料庫參數群組中的參數值重設為其預設值。客戶建立的資料庫參數群組中的參數變更會套用到與該資料庫參數群組關聯的所有資料庫執行個體。
使用主控台時，您可以將特定參數重設為其預設值。不過，您無法輕易地一次重設資料庫參數群組中的所有參數。當您使用 AWS CLI 或 RDS API 時，您可以將特定參數重設為其預設值。您也可以一次重設資料庫參數群組中的所有參數。
某些參數的變更會立即套用到資料庫執行個體，而不需要重新啟動。其他參數的變更只有在資料庫執行個體重新啟動之後才會套用。RDS 主控台會在 **Configuration (組態)** 標籤上，顯示與資料庫執行個體相關聯的資料庫參數群組的狀態。例如，假設資料庫執行個體未使用其相關聯之資料庫參數群組的最新變更。若是如此，RDS 主控台會顯示狀態為 **pending-reboot** 的資料庫參數群組。如欲對該資料庫執行個體套用最新參數變更，請手動重新啟動資料庫執行個體。
![\[參數變更擱置中重新啟動的案例\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/UserGuide/images/param-reboot.png)
**注意**
在預設資料庫參數群組中，參數始終設定為其預設值。
## 主控台
**將資料庫參數群組中的參數重設為其預設值**
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 (重設參數) **」來確認。
## AWS CLI
若要重設資料庫參數群組中的部分或全部參數，請使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html)命令搭配下列必要選項：`--db-parameter-group-name`。
若要重設資料庫參數群組中的所有參數，請指定 `--reset-all-parameters` 選項。若要重設特定參數，請指定 `--parameters` 選項。
下列範例會將資料庫參數群組中所有名為 *mydbparametergroup* 的參數重設為其預設值。
**Example**
對於 Linux、macOS 或 Unix：
```
aws rds reset-db-parameter-group \
--db-parameter-group-name mydbparametergroup \
--reset-all-parameters
```
在 Windows 中：
```
aws rds reset-db-parameter-group ^
--db-parameter-group-name mydbparametergroup ^
--reset-all-parameters
```
下列範例會在名為 *mydbparametergroup* 的資料庫參數群組中，將 `max_connections` 與 `max_allowed_packet` 選項重設為其預設值。
**Example**
對於 Linux、macOS 或 Unix：
```
aws rds reset-db-parameter-group \
--db-parameter-group-name mydbparametergroup \
--parameters "ParameterName=max_connections,ApplyMethod=immediate" \
"ParameterName=max_allowed_packet,ApplyMethod=immediate"
```
在 Windows 中：
```
aws rds reset-db-parameter-group ^
--db-parameter-group-name mydbparametergroup ^
--parameters "ParameterName=max_connections,ApplyMethod=immediate" ^
"ParameterName=max_allowed_packet,ApplyMethod=immediate"
```
該命令會產生類似以下的輸出：
```
DBParameterGroupName mydbparametergroup
```
## RDS API
若要將資料庫參數群組中的參數重設為其預設值，請使用 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html) 命令與下列必要參數：`DBParameterGroupName`。
若要重設資料庫參數群組中的所有參數，請將 `ResetAllParameters` 參數設定為 `true`。若要重設特定參數，請指定 `Parameters` 參數。
# 在 Amazon RDS 中複製資料庫參數群組
您可複製所建立的自訂資料庫參數群組。複製參數群組可以是便利的解決方案。範例是在您已建立資料庫參數群組，並希望將其大部份的自訂參數及值併入新的資料庫參數群組時。您可以使用 複製資料庫參數群組 AWS 管理主控台。您也可以使用 AWS CLI [copy-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html) 命令或 RDS API [CopyDBParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html) 操作。
複製資料庫參數群組後，請等待至少 5 分鐘，然後再建立第一個使用該資料庫參數群組做為預設參數群組的資料庫執行個體。執行此動作允許 Amazon RDS 在使用參數群組前，完整完成複製動作。這對建立資料庫執行個體預設資料庫時的關鍵參數尤其重要。例如 `character_set_database` 參數定義的預設資料庫字元集。請使用 [Amazon RDS 主控台](https://console.aws.amazon.com/rds/)的 **Parameter Groups (參數群組)** 選項或 [describe-db-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) 命令確認是否已建立資料庫參數群組。
**注意**
您無法複製預設參數群組。但您可以依照預設參數群組建立新的參數群組。
您無法將資料庫參數群組複製到不同的 AWS 帳戶 或 AWS 區域。
## 主控台
**複製資料庫參數群組**
1. 登入 AWS 管理主控台 ，並在 [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-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html) 命令搭配下列必要選項：
+ `--source-db-parameter-group-identifier`
+ `--target-db-parameter-group-identifier`
+ `--target-db-parameter-group-description`
以下範例會建立名為 `mygroup2` 的新資料庫參數群組，該群組為資料庫參數群組 `mygroup1` 的複本。
**Example**
針對 Linux、macOS 或 Unix：
```
aws rds copy-db-parameter-group \
--source-db-parameter-group-identifier mygroup1 \
--target-db-parameter-group-identifier mygroup2 \
--target-db-parameter-group-description "DB parameter group 2"
```
在 Windows 中：
```
aws rds copy-db-parameter-group ^
--source-db-parameter-group-identifier mygroup1 ^
--target-db-parameter-group-identifier mygroup2 ^
--target-db-parameter-group-description "DB parameter group 2"
```
## RDS API
若要複製資料庫參數群組，請使用 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html) 參數並搭配下列必要參數：
+ `SourceDBParameterGroupIdentifier`
+ `TargetDBParameterGroupIdentifier`
+ `TargetDBParameterGroupDescription`
# 列出 Amazon RDS 中的資料庫參數群組
您可以列出您為 AWS 帳戶建立的資料庫參數群組。
**注意**
當您為特定資料庫引擎和版本建立資料庫執行個體時，會從預設的參數範本自動建立預設的參數群組。這些預設參數群組包含偏好的參數設定，無法修改。當您建立自訂參數群組時，您可以修改參數設定。
## 主控台
**列出 AWS 帳戶的所有資料庫參數群組**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) 的 Amazon RDS 主控台。
1. 在導覽窗格中，選擇 **Parameter groups (參數群組)**。
資料庫參數群組隨即會出現在清單中。
## AWS CLI
若要列出 AWS 帳戶的所有資料庫參數群組，請使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameter-groups.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameter-groups.html) 命令。
**Example**
以下範例列出 AWS 帳戶的所有可用資料庫參數群組。
```
aws rds describe-db-parameter-groups
```
此命令會傳回類似以下的回應：
```
DBPARAMETERGROUP default.mysql8.0 mysql8.0 Default parameter group for MySQL8.0
DBPARAMETERGROUP mydbparametergroup mysql8.0 My new parameter group
```
以下範例說明 *mydbparamgroup1* 參數群組。
針對 Linux、macOS 或 Unix：
```
aws rds describe-db-parameter-groups \
--db-parameter-group-name mydbparamgroup1
```
在 Windows 中：
```
aws rds describe-db-parameter-groups ^
--db-parameter-group-name mydbparamgroup1
```
此命令會傳回類似以下的回應：
```
DBPARAMETERGROUP mydbparametergroup1 mysql8.0 My new parameter group
```
## RDS API
若要列出 AWS 帳戶的所有資料庫參數群組，請使用 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameterGroups.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameterGroups.html)操作。
# 在 Amazon RDS 中檢視資料庫參數群組的參數值
您可以從資料庫參數群組取得所有參數與其值的清單。
## 主控台
**檢視資料庫參數群組的參數值**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) 的 Amazon RDS 主控台。
1. 在導覽窗格中，選擇 **Parameter groups (參數群組)**。
資料庫參數群組隨即會出現在清單中。
1. 選擇參數群組的名稱，以查看其參數清單。
## AWS CLI
若要檢視資料庫參數群組的參數值，請使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) 命令搭配下列必要參數。
+ `--db-parameter-group-name`
**Example**
以下範例列出資料庫參數群組 *mydbparametergroup* 的參數和參數值。
```
aws rds describe-db-parameters --db-parameter-group-name mydbparametergroup
```
此命令會傳回類似以下的回應：
```
DBPARAMETER Parameter Name Parameter Value Source Data Type Apply Type Is Modifiable
DBPARAMETER allow-suspicious-udfs engine-default boolean static false
DBPARAMETER auto_increment_increment engine-default integer dynamic true
DBPARAMETER auto_increment_offset engine-default integer dynamic true
DBPARAMETER binlog_cache_size 32768 system integer dynamic true
DBPARAMETER socket /tmp/mysql.sock system string static false
```
## 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) 命令。
+ `DBParameterGroupName`
# 在 Amazon RDS 中刪除資料庫參數群組
您可以使用 AWS 管理主控台 AWS CLI或 RDS API 刪除資料庫參數群組。參數群組只有在未與資料庫執行個體相關聯時，才符合刪除條件。
## 主控台
**刪除資料庫參數群組**
1. 登入 AWS 管理主控台 並開啟位於 https：//[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-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-parameter-group.html) 命令搭配下列必要參數。
+ `--db-parameter-group-name`
**Example**
下列範例會刪除名為 *mydbparametergroup* 的資料庫參數群組。
```
aws rds delete-db-parameter-group --db-parameter-group-name mydbparametergroup
```
## RDS API
若要刪除資料庫參數群組，請使用 RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBParameterGroup.html) 命令搭配下列必要參數。
+ `DBParameterGroupName`
# 使用多可用區域資料庫叢集的資料庫叢集參數群組
多可用區域資料庫叢集使用資料庫叢集參數群組。以下各節介紹資料庫叢集參數群組的設定和管理。
**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`
# 比較資料庫參數群組
您可以使用 AWS 管理主控台 檢視兩個資料庫參數群組之間的差異。
指定的參數群組必須都是資料庫參數群組，或兩者都必須是資料庫叢集參數群組。當資料庫引擎和版本相同，也是如此。例如，您無法比較 `aurora-mysql8.0` (Aurora MySQL 第 3 版) 資料庫參數群組與 `aurora-mysql8.0` 資料庫叢集參數群組。
您可以比較 Aurora MySQL 與 RDS for MySQL 資料庫參數群組，即使是不同的版本也可以，但無法比較 Aurora PostgreSQL 與 RDS for PostgreSQL 資料庫參數群組。
**比較兩個資料庫參數群組**
1. 登入 AWS 管理主控台，開啟位於 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) 的 Amazon RDS 主控台。
1. 在導覽窗格中，選擇 **Parameter groups (參數群組)**。
1. 在清單中，選擇您要比較的兩個參數群組。
**注意**
若要比較預設參數群組與自訂參數群組，請先在**預設**索引標籤上選擇預設參數群組，然後在**自訂**索引標籤上選擇自訂參數群組。
1. 在**動作**中，選擇**比較**。
# 指定資料庫參數
資料庫參數類型包含下列各項：
+ Integer
+ 布林值
+ 字串
+ Long
+ Double
+ 時間戳記
+ 其他定義資料類型的物件
+ integer、Boolean、string、long、double、timestamp 或 object 參數類型的值陣列
您還可以使用運算式、公式和函數來指定整數及布林值參數。
對於 Oracle 引擎，您可以使用 `DBInstanceClassHugePagesDefault` 公式變數來指定布林值資料庫參數。請參閱[資料庫參數公式變數](#USER_FormulaVariables)。
對於 PostgreSQL 引擎，您可以使用運算式來指定布林值資料庫參數。請參閱[布林值資料庫參數運算式](#USER_ParamBooleanExpressions)。
**Contents**
+ [
## 資料庫參數公式
](#USER_ParamFormulas)
+ [
### 資料庫參數公式變數
](#USER_FormulaVariables)
+ [
### 資料庫參數公式運算子
](#USER_FormulaOperators)
+ [
## 資料庫參數函數
](#USER_ParamFunctions)
+ [
## 布林值資料庫參數運算式
](#USER_ParamBooleanExpressions)
+ [
## 資料庫參數對數運算式
](#USER_ParamLogExpressions)
+ [
## 資料庫參數值範例
](#USER_ParamValueExamples)
## 資料庫參數公式
資料庫參數公式是可以解析成整數值或布林值的運算式。以括號 \$1\$1 括住運算式。您可以針對資料庫參數值使用公式，或將公式指定為資料庫參數函數的引數。
**語法**
```
{FormulaVariable}
{FormulaVariable*Integer}
{FormulaVariable*Integer/Integer}
{FormulaVariable/Integer}
```
### 資料庫參數公式變數
每個公式變數都會傳回整數或布林值。變數的名稱區分大小寫。
*AllocatedStorage*
返回表示資料磁碟區大小的整數 (字元組)。
*DBInstanceClassHugePagesDefault*
傳回布林值。目前僅支援 Oracle 引擎。
如需更多詳細資訊，請參閱 [對 RDS for Oracle 執行個體開啟巨型分頁](Oracle.Concepts.HugePages.md)。
*DBInstanceClassMemory*
傳回一個整數，表示資料庫程序可用的記憶體位元組數。此數字是在內部從資料庫執行個體類別的總記憶體量開始計算得出的。其中，計算會減去為作業系統和管理執行個體的 RDS 程序保留的記憶體。因此，此數字永遠會低於 [ 資料庫執行個體類別](Concepts.DBInstanceClass.md) 上執行個體類別表中顯示的記憶體容量。確切值取決於幾個綜合因素。其中包括執行個體類別、資料庫引擎，以及要套用至 RDS 執行個體還是屬於 Aurora 叢集的執行個體。
*DBInstanceVCPU*
傳回表示 Amazon RDS 管理執行個體所用虛擬中央處理單元 (vCPU) 數目的整數。
*EndPointPort*
返回表示連線至資料庫執行個體時所用連接埠的整數。
*TrueIfReplica*
如果資料庫執行個體為僅供讀取複本，則傳回 `1`，若不是，則傳回 `0`。這是 MySQL 中 `read_only` 參數的預設值。
### 資料庫參數公式運算子
資料庫參數公式支援兩種運算子：除法和乘法。
*除法運算子：/*
用除數除以被除數，並傳回整數之商。商中的小數不進位，直接截斷。
語法
```
dividend / divisor
```
被除數和除數引數必須為整數運算式。
*乘法運算子：\$1*
乘以運算式，並傳回運算式的乘積。運算式中的小數不進位，直接截斷。
語法
```
expression * expression
```
兩個運算式都必須為整數。
## 資料庫參數函數
您可以將資料庫參數函數的引數指定為整數或公式。每個函數至少必須有一個引數。以逗號分隔的清單指定多個引數。清單不能有任何空成員，例如 *argument1*、*argument3*。函數名稱區分大小寫。
*IF*
傳回引數。
目前僅支援 Oracle 引擎，且唯一支援的第一個引數為 `{DBInstanceClassHugePagesDefault}`。如需更多詳細資訊，請參閱 [對 RDS for Oracle 執行個體開啟巨型分頁](Oracle.Concepts.HugePages.md)。
語法
```
IF(argument1, argument2, argument3)
```
若第一個引數計算結果為 true，傳回第二個引數。否則，傳回第三個引數。
*GREATEST*
從整數或參數公式清單中傳回最大值。
語法
```
GREATEST(argument1, argument2,...argumentn)
```
傳回整數。
*LEAST*
從整數或參數公式清單中傳回最小值。
語法
```
LEAST(argument1, argument2,...argumentn)
```
傳回整數。
*SUM*
新增指定整數或參數公式的值。
語法
```
SUM(argument1, argument2,...argumentn)
```
傳回整數。
## 布林值資料庫參數運算式
布林值資料庫參數運算式解析為 1 或 0 的布林值。該運算式包含在引號中。
**注意**
布林值資料庫參數運算式僅支援 PostgreSQL 引擎。
**語法**
```
"expression operator expression"
```
這兩個運算式必須解析為整數。運算式可以是下列項目：
+ 整數常數
+ 資料庫參數公式
+ 資料庫參數函數
+ 資料庫參數變數
布林值資料庫參數運算式支援以下不等式運算子：
*大於運算子：>*
語法
```
"expression > expression"
```
*小於運算子：<*
語法
```
"expression < expression"
```
* 大於或等於運算符：> =、=>*
語法
```
"expression >= expression"
"expression => expression"
```
*小於或等於運算子：<=、=<*
語法
```
"expression <= expression"
"expression =< expression"
```
**Example 使用布林值資料庫參數運算式**
下列布林值資料庫參數運算式範例會將參數公式的結果與整數作比較。這樣做是為了修改 PostgreSQL 資料庫執行個體的布林值資料庫參數 `wal_compression`。參數運算式會將 vCPU 的數目與值 2 作比較。如果 vCPU 的數目大於 2，則 `wal_compression` 資料庫參數設定為 true。
```
aws rds modify-db-parameter-group --db-parameter-group-name group-name \
--parameters "ParameterName=wal_compression,ParameterValue=\"{DBInstanceVCPU} > 2\" "
```
## 資料庫參數對數運算式
您可以將整數資料庫參數值設定為對數運算式。以括號 \$1\$1 括住運算式。例如：
```
{log(DBInstanceClassMemory/8187281418)*1000}
```
`log` 函數表示對數底數 2。此範例還會使用 `DBInstanceClassMemory` 公式變數。請參閱[資料庫參數公式變數](#USER_FormulaVariables)。
**注意**
目前，您不能使用除了整數以外的任何值指定 MySQL `innodb_log_file_size` 參數。
## 資料庫參數值範例
這些範例顯示使用資料庫參數值的公式、函數和運算式。
**警告**
未正確設定資料庫參數群組中的參數，可能產生各種意外影響。這些影響可能包括降低效能和系統不穩定。修改資料庫參數時請謹慎，在修改資料庫參數群組之前，請備份您的資料。請在測試資料庫執行個體上嘗試進行參數群組變更，再將參數群組變更套用至生產資料庫執行個體。
**Example 使用資料庫參數函數 GREATEST**
您可以在 Oracle 進程參數中指定 `GREATEST` 函數。使用該函數將使用者進程的數目設定為 80 或`DBInstanceClassMemory` 除以 9,868,951。
```
GREATEST({DBInstanceClassMemory/9868951},80)
```
**Example 使用資料庫參數函數 LEAST**
您可以在 MySQL `LEAST` 參數值中指定 `max_binlog_cache_size` 函數。使用該函數將交易可在 MySQL 執行個體中使用的快取大小上限設為 1 MB 或 `DBInstanceClass`/256 (取較小者)。
```
LEAST({DBInstanceClassMemory/256},10485760)
```