在資料庫執行個體中使用資料庫參數群組

資料庫執行個體會使用資料庫參數群組。以下各節介紹資料庫執行個體參數群組的設定和管理。

建立資料庫參數群組

您可以使用 AWS Management Console、或 RDS API 建立新的資料庫參數群組。 AWS CLI

下列限制適用於資料庫參數群組名稱：

• 名稱必須為 1 到 255 個字母、數字或連字號。

  預設參數群組名稱可以包括句點，例如 default.mysql8.0。不過，自訂參數群組名稱不能包括句點。

• 第一個字元必須是字母。

• 名稱不能以連字號結尾或包含兩個連續連字號。

主控台

建立資料庫參數群組

1. 登入 AWS Management Console 並開啟 Amazon RDS 主控台，網址為 https://console.aws.amazon.com/rds/。

2. 在導覽窗格中，選擇 Parameter groups (參數群組)。

3. 選擇 Create parameter group (建立參數群組)。

4. 在「參數群組名稱」中，輸入新資料庫參數群組的名稱。

5. 在說明中，輸入新資料庫參數群組的說明。

6. 針對「引擎類型」，選擇您的資料庫引擎。

7. 對於「參數群組族群」，請選擇資料庫參數群組族群。

8. 對於「類型」，選擇「資料庫參數群組」。

9. 選擇建立。

AWS CLI

若要建立資料庫參數群組，請使用 AWS CLI create-db-parameter-group指令。下列範例將為 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"

注意

輸出包含重覆項目。

範例

對於LinuxmacOS、或Unix：

aws rds create-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --db-parameter-group-family aurora-mysql5.7 \
    --description "My new parameter group"

在 Windows 中：

aws rds create-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --db-parameter-group-family aurora-mysql5.7 ^
    --description "My new parameter group"

此命令會產生類似下列的輸出：

DBPARAMETERGROUP  mydbparametergroup  aurora-mysql5.7  My new parameter group					

RDS API

若要建立資料庫參數群組，請使用 RDS API CreateDBParameterGroup 操作。

包含下列必要參數：

• DBParameterGroupName

• DBParameterGroupFamily

• Description

將資料庫參數群組與資料庫執行個體建立關聯

您可以使用自訂設定，建立自己的資料庫參數群組。您可以使用 AWS Management Console、或 RDS API 將資料庫參數群組與資料庫執行個體建立關聯。 AWS CLI您可以在建立或修改資料庫執行個體時執行此動作。

如需建立資料庫參數群組的資訊，請參閱建立資料庫參數群組。如需修改資料庫執行個體的相關資訊，請參閱修改資料庫叢集中的資料庫執行個體。

注意

當您建立新資料庫參數群組與資料庫執行個體的關聯時，只有在資料庫執行個體重新開機之後，才會套用修改過的靜態參數和動態參數。不過，如果您在將資料庫參數群組與資料庫執行個體建立關聯之後修改該群組中的動態參數，則會立即套用這些變更，而不需重新開機。

主控台

將資料庫參數群組與資料庫執行個體建立關聯

1. 登入 AWS Management Console 並開啟 Amazon RDS 主控台，網址為 https://console.aws.amazon.com/rds/。

2. 在導覽窗格中選擇 Databases (資料庫)，然後選擇您要修改的資料庫執行個體。

3. 選擇 Modify (修改)。Modify DB instance (修改資料庫執行個體) 頁面隨即出現。

4. 變更 DB parameter group (資料庫參數群組) 設定。

5. 選擇 Continue (繼續)，並檢查修改的摘要。

6. (選用) 選擇 Apply immediately (立即套用) 以立即套用變更。在某些情況下，選擇此選項會導致停機。

7. 在確認頁面上，檢閱您的變更。如果都正確，請選擇 Modify DB instance (修改資料庫執行個體) 以儲存您的變更。

   或者，選擇 Back (上一步) 以編輯變更，或是選擇 Cancel (取消) 以取消變更。

AWS CLI

若要將資料庫參數群組與資料庫執行個體建立關聯，請使用 AWS CLI modify-db-instance指令搭配下列選項：

• --db-instance-identifier

• --db-parameter-group-name

下面的範例將 mydbpg 資料庫參數群組與 database-1 資料庫執行個體建立關聯。透過 --apply-immediately，即可立即套用變更。使用 --no-apply-immediately 在下次維護時段套用變更。

範例

對於LinuxmacOS、或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 ModifyDBInstance 操作搭配下列參數：

• DBInstanceName

• DBParameterGroupName

修改資料庫參數群組中的參數

您可修改客戶建立的資料庫參數群組中的參數值；但無法變更預設資料庫參數群組中的參數值。客戶建立的資料庫參數群組中的參數變更會套用到與該資料庫參數群組關聯的所有資料庫執行個體。

某些參數的變更會立即套用到資料庫執行個體，而不需要重新啟動。其他參數的變更只有在資料庫執行個體重新啟動之後才會套用。RDS 主控台會在 Configuration (組態) 標籤上，顯示與資料庫執行個體相關聯的資料庫參數群組的狀態。例如，假設資料庫執行個體未使用其相關聯之資料庫參數群組的最新變更。若是如此，RDS 主控台會顯示狀態為 pending-reboot 的資料庫參數群組。如欲對該資料庫執行個體套用最新參數變更，請手動重新啟動資料庫執行個體。

主控台

若要修改資料庫參數群組中的參數

1. 登入 AWS Management Console 並開啟 Amazon RDS 主控台，網址為 https://console.aws.amazon.com/rds/。

2. 在導覽窗格中，選擇 Parameter groups (參數群組)。

3. 在清單中，選擇要修改的參數群組名稱。

4. 針對 Parameter group actions (參數群組動作)，選擇 Edit (編輯)。

5. 變更您要修改的參數值。您可用對話方塊右上角的箭頭鍵來捲動參數。

   您無法變更預設參數群組中的值。

6. 選擇儲存變更。

AWS CLI

若要修改資料庫參數群組，請搭配下列必要選項使用 AWS CLI modify-db-parameter-group指令：

• --db-parameter-group-name

• --parameters

以下範例將修改名稱為 mydbparametergroup​ 的資料庫參數群組的 max_connections 和 max_allowed_packet 值。

範例

對於LinuxmacOS、或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 ModifyDBParameterGroup 操作，並搭配下列必要參數：

• DBParameterGroupName

• Parameters

將資料庫參數群組中的參數重設為其預設值

您可以將客戶建立的資料庫參數群組中的參數值重設為其預設值。客戶建立的資料庫參數群組中的參數變更會套用到與該資料庫參數群組關聯的所有資料庫執行個體。

使用主控台時，您可以將特定參數重設為其預設值。不過，您無法輕易地一次重設資料庫參數群組中的所有參數。使用 AWS CLI 或 RDS API 時，您可以將特定參數重設為其預設值。您也可以一次重設資料庫參數群組中的所有參數。

某些參數的變更會立即套用到資料庫執行個體，而不需要重新啟動。其他參數的變更只有在資料庫執行個體重新啟動之後才會套用。RDS 主控台會在 Configuration (組態) 標籤上，顯示與資料庫執行個體相關聯的資料庫參數群組的狀態。例如，假設資料庫執行個體未使用其相關聯之資料庫參數群組的最新變更。若是如此，RDS 主控台會顯示狀態為 pending-reboot 的資料庫參數群組。如欲對該資料庫執行個體套用最新參數變更，請手動重新啟動資料庫執行個體。

注意

在預設資料庫參數群組中，參數始終設定為其預設值。

主控台

將資料庫參數群組中的參數重設為其預設值

1. 登入 AWS Management Console 並開啟 Amazon RDS 主控台，網址為 https://console.aws.amazon.com/rds/。

2. 在導覽窗格中，選擇 Parameter groups (參數群組)。

3. 在清單中，選擇參數群組。

4. 針對 Parameter group actions (參數群組動作)，選擇 Edit (編輯)。

5. 選擇您要重設為預設值的參數。您可用對話方塊右上角的箭頭鍵來捲動參數。

   您無法重設預設參數群組中的值。

6. 選擇「Reset (重設) 」，然後選擇「Reset parameters (重設參數) 」來確認。

AWS CLI

若要重設資料庫參數群組中的部分或全部參數，請使用具有下列必要選項的 AWS CLI reset-db-parameter-group命令：--db-parameter-group-name

若要重設資料庫參數群組中的所有參數，請指定 --reset-all-parameters 選項。若要重設特定參數，請指定 --parameters 選項。

下列範例會將資料庫參數群組中所有名為 mydbparametergroup 的參數重設為其預設值。

範例

對於LinuxmacOS、或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 選項重設為其預設值。

範例

對於LinuxmacOS、或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 ResetDBParameterGroup 命令與下列必要參數：DBParameterGroupName。

若要重設資料庫參數群組中的所有參數，請將 ResetAllParameters 參數設定為 true。若要重設特定參數，請指定 Parameters 參數。

複製資料庫參數群組

您可複製所建立的自訂資料庫參數群組。複製參數群組可以是便利的解決方案。範例是在您已建立資料庫參數群組，並希望將其大部份的自訂參數及值併入新的資料庫參數群組時。您可以使用複製資料庫參數群組 AWS Management Console。您也可以使用命 AWS CLI copy-db-parameter-group令或 RDS API 複製資料庫ParameterGroup作業。

複製資料庫參數群組後，請等待至少 5 分鐘，然後再建立第一個使用該資料庫參數群組做為預設參數群組的資料庫執行個體。執行此動作允許 Amazon RDS 在使用參數群組前，完整完成複製動作。這對建立資料庫執行個體預設資料庫時的關鍵參數尤其重要。例如 character_set_database 參數定義的預設資料庫字元集。使用 Amazon RDS 主控台的「參數群組」選項或命describe-db-parameters令來確認資料庫參數群組已建立。

注意

您無法複製預設參數群組。但您可以依照預設參數群組建立新的參數群組。

您無法將資料庫參數群組複製到不同的 AWS 帳戶 或 AWS 區域。

主控台

複製資料庫參數群組

1. 登入 AWS Management Console 並開啟 Amazon RDS 主控台，網址為 https://console.aws.amazon.com/rds/。

2. 在導覽窗格中，選擇 Parameter groups (參數群組)。

3. 在清單中，選擇您要複製的自訂參數群組。

4. 針對 Parameter group actions (參數群組動作)，選擇 Copy (複製)。

5. 在 New DB parameter group identifier (新資料庫參數群組識別符) 中，輸入新參數群組的名稱。

6. 在 Description (描述) 中，輸入新參數群組的描述。

7. 請選擇 Copy (複製)。

AWS CLI

若要複製資料庫參數群組，請搭配下列必要選項使用 AWS CLI copy-db-parameter-group指令：

• --source-db-parameter-group-identifier

• --target-db-parameter-group-identifier

• --target-db-parameter-group-description

以下範例會建立名為 mygroup2 的新資料庫參數群組，該群組為資料庫參數群組 mygroup1 的複本。

範例

對於LinuxmacOS、或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 CopyDBParameterGroup 參數並搭配下列必要參數：

• SourceDBParameterGroupIdentifier

• TargetDBParameterGroupIdentifier

• TargetDBParameterGroupDescription

列出資料庫參數群組

您可以列出為您的 AWS 帳戶建立的資料庫參數群組。

注意

當您為特定資料庫引擎和版本建立資料庫執行個體時，會從預設的參數範本自動建立預設的參數群組。這些預設參數群組包含偏好的參數設定，無法修改。當您建立自訂參數群組時，您可以修改參數設定。

主控台

列出 AWS 帳戶的所有資料庫參數群組

1. 登入 AWS Management Console 並開啟 Amazon RDS 主控台，網址為 https://console.aws.amazon.com/rds/。

2. 在導覽窗格中，選擇 Parameter groups (參數群組)。

   資料庫參數群組隨即會出現在清單中。

AWS CLI

若要列出 AWS 帳戶的所有資料庫參數群組，請使用 AWS CLI describe-db-parameter-groups指令。

範例

以下範例列出 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 參數群組。

對於LinuxmacOS、或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 DescribeDBParameterGroups作業。

檢視資料庫參數群組的參數值

您可以從資料庫參數群組取得所有參數與其值的清單。

主控台

檢視資料庫參數群組的參數值

1. 登入 AWS Management Console 並開啟 Amazon RDS 主控台，網址為 https://console.aws.amazon.com/rds/。

2. 在導覽窗格中，選擇 Parameter groups (參數群組)。

   資料庫參數群組隨即會出現在清單中。

3. 選擇參數群組的名稱，以查看其參數清單。

AWS CLI

若要檢視資料庫參數群組的參數值，請使用具有下列必要參數的 AWS CLI describe-db-parameters命令。

• --db-parameter-group-name

範例

以下範例列出資料庫參數群組 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 DescribeDBParameters 命令。

• DBParameterGroupName

刪除資料庫參數群組

您可以使用 AWS Management Console、 AWS CLI或 RDS API 刪除資料庫參數群組。只有當參數群組與資料庫執行個體沒有關聯時，才有資格刪除參數群組。

主控台

刪除資料庫參數群組

1. 登入 AWS Management Console 並開啟 Amazon RDS 主控台，網址為 https://console.aws.amazon.com/rds/。

2. 在導覽窗格中，選擇 Parameter groups (參數群組)。

   資料庫參數群組隨即會出現在清單中。

3. 選擇要刪除的參數群組名稱。

4. 選擇動作，然後選擇刪除。

5. 檢閱參數群組名稱，然後選擇「刪除」。

AWS CLI

若要刪除資料庫參數群組，請使用具有下列必要參數的 AWS CLI delete-db-parameter-group命令。

• --db-parameter-group-name

範例

下列範例會刪除名為 mydb 參數群組/參數群組的資料庫參數群組。

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

RDS API

若要刪除資料庫參數群組，請使用 RDS API DeleteDBParameterGroup命令搭配下列必要參數。

• DBParameterGroupName