全部產品
Search
文件中心

PolarDB:使用參數模板

更新時間:Aug 08, 2025

在配置PolarDB叢集時,如果多個叢集中包含一個或多個參數的配置相同,您可以使用參數模板功能,對參數進行集中管理,並快速應用至叢集,以提升參數管理效率和叢集配置效率。

建立參數模板

  1. 登入PolarDB控制台,選擇叢集所在地區,在左側導覽列中,選擇参数模板

  2. 自定义参数模板頁簽內,單擊创建参数模板,設定以下參數並單擊确认创建

    參數

    說明

    模板名稱

    模板的名稱。名稱需要滿足以下規則:

    • 由英文、數字和底線(_)組成,以字母開頭,不能包含中文。

    • 長度為8~64個字元。

    資料庫引擎

    選擇資料庫引擎,請選擇MySQL

    資料庫版本

    選擇資料庫引擎版本,取值範圍如下:

    • 8.0

    • 5.7

    • 5.6

    描述

    備忘該模板的相關資訊,便於後續管理。不限制語言,長度為0~200個字元。

    添加配置

    單擊添加配置會增加一行參數供您選擇参数名,並通過參考描述可修改参数值設定配置值。您還可以看到是否重啟叢集、參數預設值等資訊。

    說明
    • 需要配置下一個參數,請再次單擊添加配置

    • 需要刪除某個參數,請單擊該參數右側的删除

    匯入

    單擊导入,輸入參數及參數值。輸入格式需要按照key=value格式輸入,多組資料之間請換行,例如:

    wait_timeout=60
    thread_stack=262144

應用參數模板

參數模板建立後,您可以通過以下兩種方法將參數模板應用至叢集。

  • PolarDB叢集頁面應用模板,在目的地組群的配置与管理 > 参数配置中單擊应用模板。詳情請參見應用模板

  • 直接將模板應用至叢集,詳情見以下操作步驟:

說明

如果參數模板中存在需要重啟叢集的參數,建議您在業務低峰期操作,並確保應用程式具有重連機制。

  1. 登入PolarDB控制台,選擇叢集所在地區,在左側導覽列中,選擇参数模板

  2. 自定义参数模板頁簽內,目標模板操作列中單擊应用到集群

  3. 应用到集群頁面中,選擇需要應用參數模板的叢集。單擊移動移動到右側,同時您可以參數對比地區中查看參數模板中參數配置值與叢集中參數配置值的差異。確認無誤後,單擊確定

    說明

    應用參數模板到多個叢集上時,請注意以下問題:

    • 請確認參數是否適用這些叢集,請謹慎操作。

    • 單次操作只能將參數模板應用到10個叢集。如果需要將參數模板應用至10個以上的叢集,您可以分批操作。

    • 參數模板所在地區需與需要應用該模板的叢集所在地區一致。如果不在同一地區,請您在叢集所在地區建立參數模板,然後應用。

    image

複製參數模板

  1. 登入PolarDB控制台,選擇叢集所在地區,在左側導覽列中,選擇参数模板

  2. 自定义参数模板頁簽內,目標模板操作列中單擊克隆。設定以下參數並單擊确认创建

    參數

    說明

    模板名稱

    模板的名稱。名稱需要滿足以下規則:

    • 由英文、數字和底線(_)組成,以字母開頭,不能包含中文。

    • 長度為8~64個字元。

    資料庫引擎

    選擇資料庫引擎,請選擇MySQL

    資料庫版本

    選擇資料庫引擎版本,取值範圍如下:

    • 8.0

    • 5.7

    • 5.6

    描述

    備忘該模板的相關資訊,便於後續管理。不限制語言,長度為0~200個字元。

    添加配置

    單擊添加配置會增加一行參數供您選擇参数名,並通過參考描述可修改参数值設定配置值。您還可以看到是否重啟叢集、參數預設值等資訊。

    說明
    • 需要配置下一個參數,請再次單擊添加配置

    • 需要刪除某個參數,請單擊該參數右側的删除

    匯入

    單擊导入,輸入參數及參數值。輸入格式需要按照key=value格式輸入,多組資料之間請換行,例如:

    wait_timeout=60
    thread_stack=262144

刪除參數模板

  1. 登入PolarDB控制台,選擇叢集所在地區,在左側導覽列中,選擇参数模板

  2. 自定义参数模板頁簽內,目標模板操作列中單擊删除

說明

如果需要同時刪除多個參數模板,請選中目標參數模板,然後單擊大量刪除即可。

查看參數模板差異

  1. 登入PolarDB控制台,選擇叢集所在地區,在左側導覽列中,選擇参数模板

  2. 自定义参数模板頁簽內,選擇您要對比的參數模板,單擊列表下方的比较差异

  3. 比较差异頁面中,您可以查看到各參數模板中的參數差異。image

相關API

API

描述

CreateParameterGroup

建立參數模板。

DescribeParameterGroups

查詢參數模板列表。

DescribeParameterGroup

查詢參數模板詳情。

ModifyDBClusterParameters

修改或應用參數模板。

DeleteParameterGroup

刪除參數模板。