本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
在資料庫執行個體中使用資料庫參數群組
資料庫執行個體會使用資料庫參數群組。以下各節介紹資料庫執行個體參數群組的設定和管理。
主題
建立資料庫參數群組
您可以使用 AWS Management Console、或 RDS API 建立新的資料庫參數群組。 AWS CLI
下列限制適用於資料庫參數群組名稱:
-
名稱必須為 1 到 255 個字母、數字或連字號。
預設參數群組名稱可以包括句點,例如
default.mysql8.0
。不過,自訂參數群組名稱不能包括句點。 -
第一個字元必須是字母。
-
名稱不能以連字號結尾或包含兩個連續連字號。
建立資料庫參數群組
-
登入 AWS Management Console 並開啟 Amazon RDS 主控台,網址為 https://console.aws.amazon.com/rds/
。 -
在導覽窗格中,選擇 Parameter groups (參數群組)。
-
選擇 Create parameter group (建立參數群組)。
-
在「參數群組名稱」中,輸入新資料庫參數群組的名稱。
-
在說明中,輸入新資料庫參數群組的說明。
-
針對「引擎類型」,選擇您的資料庫引擎。
-
對於「參數群組族群」,請選擇資料庫參數群組族群。
-
對於「類型」,選擇「資料庫參數群組」。
-
選擇建立。
若要建立資料庫參數群組,請使用 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-familyMySQL8.0
\ --description"My new parameter group"
在 Windows 中:
aws rds create-db-parameter-group ^ --db-parameter-group-name
mydbparametergroup
^ --db-parameter-group-familyMySQL8.0
^ --description"My new parameter group"
此命令會產生類似下列的輸出:
DBPARAMETERGROUP mydbparametergroup mysql8.0 My new parameter group
若要建立資料庫參數群組,請使用 RDS API CreateDBParameterGroup
操作。
包含下列必要參數:
-
DBParameterGroupName
-
DBParameterGroupFamily
-
Description
將資料庫參數群組與資料庫執行個體建立關聯
您可以使用自訂設定,建立自己的資料庫參數群組。您可以使用 AWS Management Console、或 RDS API 將資料庫參數群組與資料庫執行個體建立關聯。 AWS CLI您可以在建立或修改資料庫執行個體時執行此動作。
如需建立資料庫參數群組的資訊,請參閱建立資料庫參數群組。如需建立資料庫執行個體的相關資訊,請參閱 建立 Amazon RDS 資料庫執行個體。如需修改資料庫執行個體的相關資訊,請參閱修改 Amazon RDS 資料庫執行個體。
注意
當您建立新資料庫參數群組與資料庫執行個體的關聯時,只有在資料庫執行個體重新開機之後,才會套用修改過的靜態參數和動態參數。不過,如果您在將資料庫參數群組與資料庫執行個體建立關聯之後修改該群組中的動態參數,則會立即套用這些變更,而不需重新開機。
將資料庫參數群組與資料庫執行個體建立關聯
登入 AWS Management Console 並開啟 Amazon RDS 主控台,網址為 https://console.aws.amazon.com/rds/
。 -
在導覽窗格中選擇 Databases (資料庫),然後選擇您要修改的資料庫執行個體。
-
選擇 Modify (修改)。Modify DB instance (修改資料庫執行個體) 頁面隨即出現。
-
變更 DB parameter group (資料庫參數群組) 設定。
-
選擇 Continue (繼續),並檢查修改的摘要。
-
(選用) 選擇 Apply immediately (立即套用) 以立即套用變更。在某些情況下,選擇此選項會導致停機。如需詳細資訊,請參閱 排程修改設定。
-
在確認頁面上,檢閱您的變更。如果都正確,請選擇 Modify DB instance (修改資料庫執行個體) 以儲存您的變更。
或者,選擇 Back (上一步) 以編輯變更,或是選擇 Cancel (取消) 以取消變更。
若要將資料庫參數群組與資料庫執行個體建立關聯,請使用 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-namemydbpg
\--apply-immediately
在 Windows 中:
aws rds modify-db-instance ^ --db-instance-identifier
database-1
^ --db-parameter-group-namemydbpg
^--apply-immediately
若要將資料庫參數群組與資料庫執行個體建立關聯,請使用 RDS API ModifyDBInstance
操作搭配下列參數:
-
DBInstanceName
-
DBParameterGroupName
修改資料庫參數群組中的參數
您可修改客戶建立的資料庫參數群組中的參數值;但無法變更預設資料庫參數群組中的參數值。客戶建立的資料庫參數群組中的參數變更會套用到與該資料庫參數群組關聯的所有資料庫執行個體。
某些參數的變更會立即套用到資料庫執行個體,而不需要重新啟動。其他參數的變更只有在資料庫執行個體重新啟動之後才會套用。RDS 主控台會在 Configuration (組態) 標籤上,顯示與資料庫執行個體相關聯的資料庫參數群組的狀態。例如,假設資料庫執行個體未使用其相關聯之資料庫參數群組的最新變更。若是如此,RDS 主控台會顯示狀態為 pending-reboot 的資料庫參數群組。如欲對該資料庫執行個體套用最新參數變更,請手動重新啟動資料庫執行個體。
![參數變更擱置中重新啟動的案例](images/param-reboot.png)
若要修改資料庫參數群組中的參數
-
登入 AWS Management Console 並開啟 Amazon RDS 主控台,網址為 https://console.aws.amazon.com/rds/
。 -
在導覽窗格中,選擇 Parameter groups (參數群組)。
-
在清單中,選擇要修改的參數群組名稱。
-
針對 Parameter group actions (參數群組動作),選擇 Edit (編輯)。
-
變更您要修改的參數值。您可用對話方塊右上角的箭頭鍵來捲動參數。
您無法變更預設參數群組中的值。
-
選擇儲存變更。
若要修改資料庫參數群組,請搭配下列必要選項使用 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 ModifyDBParameterGroup
操作,並搭配下列必要參數:
-
DBParameterGroupName
-
Parameters
將資料庫參數群組中的參數重設為其預設值
您可以將客戶建立的資料庫參數群組中的參數值重設為其預設值。客戶建立的資料庫參數群組中的參數變更會套用到與該資料庫參數群組關聯的所有資料庫執行個體。
使用主控台時,您可以將特定參數重設為其預設值。不過,您無法輕易地一次重設資料庫參數群組中的所有參數。使用 AWS CLI 或 RDS API 時,您可以將特定參數重設為其預設值。您也可以一次重設資料庫參數群組中的所有參數。
某些參數的變更會立即套用到資料庫執行個體,而不需要重新啟動。其他參數的變更只有在資料庫執行個體重新啟動之後才會套用。RDS 主控台會在 Configuration (組態) 標籤上,顯示與資料庫執行個體相關聯的資料庫參數群組的狀態。例如,假設資料庫執行個體未使用其相關聯之資料庫參數群組的最新變更。若是如此,RDS 主控台會顯示狀態為 pending-reboot 的資料庫參數群組。如欲對該資料庫執行個體套用最新參數變更,請手動重新啟動資料庫執行個體。
![參數變更擱置中重新啟動的案例](images/param-reboot.png)
注意
在預設資料庫參數群組中,參數始終設定為其預設值。
將資料庫參數群組中的參數重設為其預設值
-
登入 AWS Management Console 並開啟 Amazon RDS 主控台,網址為 https://console.aws.amazon.com/rds/
。 -
在導覽窗格中,選擇 Parameter groups (參數群組)。
-
在清單中,選擇參數群組。
-
針對 Parameter group actions (參數群組動作),選擇 Edit (編輯)。
-
選擇您要重設為預設值的參數。您可用對話方塊右上角的箭頭鍵來捲動參數。
您無法重設預設參數群組中的值。
-
選擇「Reset (重設) 」,然後選擇「Reset parameters (重設參數) 」來確認。
若要重設資料庫參數群組中的部分或全部參數,請使用具有下列必要選項的 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 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 主控台
注意
您無法複製預設參數群組。但您可以依照預設參數群組建立新的參數群組。
您無法將資料庫參數群組複製到不同的 AWS 帳戶 或 AWS 區域。
複製資料庫參數群組
-
登入 AWS Management Console 並開啟 Amazon RDS 主控台,網址為 https://console.aws.amazon.com/rds/
。 -
在導覽窗格中,選擇 Parameter groups (參數群組)。
-
在清單中,選擇您要複製的自訂參數群組。
-
針對 Parameter group actions (參數群組動作),選擇 Copy (複製)。
-
在 New DB parameter group identifier (新資料庫參數群組識別符) 中,輸入新參數群組的名稱。
-
在 Description (描述) 中,輸入新參數群組的描述。
-
請選擇 Copy (複製)。
若要複製資料庫參數群組,請搭配下列必要選項使用 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-identifiermygroup2
\ --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-identifiermygroup2
^ --target-db-parameter-group-description"DB parameter group 2"
若要複製資料庫參數群組,請使用 RDS API CopyDBParameterGroup
參數並搭配下列必要參數:
-
SourceDBParameterGroupIdentifier
-
TargetDBParameterGroupIdentifier
-
TargetDBParameterGroupDescription
列出資料庫參數群組
您可以列出為您的 AWS 帳戶建立的資料庫參數群組。
注意
當您為特定資料庫引擎和版本建立資料庫執行個體時,會從預設的參數範本自動建立預設的參數群組。這些預設參數群組包含偏好的參數設定,無法修改。當您建立自訂參數群組時,您可以修改參數設定。
列出 AWS 帳戶的所有資料庫參數群組
-
登入 AWS Management Console 並開啟 Amazon RDS 主控台,網址為 https://console.aws.amazon.com/rds/
。 -
在導覽窗格中,選擇 Parameter groups (參數群組)。
資料庫參數群組隨即會出現在清單中。
若要列出 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
若要列出 AWS 帳戶的所有資料庫參數群組,請使用 RDS API DescribeDBParameterGroups
作業。
檢視資料庫參數群組的參數值
您可以從資料庫參數群組取得所有參數與其值的清單。
檢視資料庫參數群組的參數值
-
登入 AWS Management Console 並開啟 Amazon RDS 主控台,網址為 https://console.aws.amazon.com/rds/
。 -
在導覽窗格中,選擇 Parameter groups (參數群組)。
資料庫參數群組隨即會出現在清單中。
-
選擇參數群組的名稱,以查看其參數清單。
若要檢視資料庫參數群組的參數值,請使用具有下列必要參數的 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 DescribeDBParameters
命令。
DBParameterGroupName
刪除資料庫參數群組
您可以使用 AWS Management Console、 AWS CLI或 RDS API 刪除資料庫參數群組。只有當參數群組與資料庫執行個體沒有關聯時,才有資格刪除參數群組。
刪除資料庫參數群組
登入 AWS Management Console 並開啟 Amazon RDS 主控台,網址為 https://console.aws.amazon.com/rds/
。 -
在導覽窗格中,選擇 Parameter groups (參數群組)。
資料庫參數群組隨即會出現在清單中。
-
選擇要刪除的參數群組名稱。
-
選擇動作,然後選擇刪除。
-
檢閱參數群組名稱,然後選擇「刪除」。
若要刪除資料庫參數群組,請使用具有下列必要參數的 AWS CLI delete-db-parameter-group
命令。
-
--db-parameter-group-name
範例
下列範例會刪除名為 mydb 參數群組/參數群組的資料庫參數群組。
aws rds delete-db-parameter-group --db-parameter-group-name
mydbparametergroup
若要刪除資料庫參數群組,請使用 RDS API DeleteDBParameterGroup
命令搭配下列必要參數。
-
DBParameterGroupName