全部產品
Search
文件中心

ApsaraDB RDS:使用參數模板

更新時間:Jun 19, 2024

如果需要批量管理RDS PostgreSQL執行個體的參數,您可以使用參數模板功能,快速應用模板到執行個體上。參數模板分為系統參數模板和自訂參數模板兩類。

前提條件

RDS PostgreSQL執行個體需滿足以下要求:

  • 執行個體為雲端硬碟版執行個體。

  • 執行個體大版本為RDS PostgreSQL 10或以上版本。

背景資訊

RDS PostgreSQL執行個體提供兩種參數模板,具體如下:

  • 系統參數模板:建立RDS PostgreSQL執行個體時,使用的預設參數模板。

  • 自訂參數模板:執行個體建立成功後,您可以根據業務需要,自訂參數模板,應用到一個或多個RDS PostgreSQL執行個體,覆蓋系統參數模板。

說明

如果僅需要修改單個執行個體的某個參數,請參見設定執行個體參數

建立自訂參數模板

手動建立參數模板

  1. 登入RDS管理主控台,在左側導覽列單擊參數模板,然後在上方選擇地區。

  2. 在右側頁面中單擊建立參數模板

  3. 設定如下參數。

    參數

    說明

    模板名稱

    模板的名稱。由英文、數字、小數點(.)或底線(_)組成,以字母開頭,不能包含中文,長度為8~64個字元。

    資料庫引擎

    選擇PostgreSQL。

    資料庫版本

    當前支援RDS PostgreSQL 10或以上版本。

    描述

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

    添加參數

    單擊添加參數會增加一行參數供您選擇參數名以及設定取值,您還可以看到取值範圍、預設值等資訊。

    說明
    • 可添加的參數請參見執行個體控制台參數設定頁面的可修改參數

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

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

    匯入

    您可以將匯出的模板修改好之後,單擊匯入,粘貼參數產生模板。匯出模板請參見設定執行個體參數

  4. 單擊確認建立

將現有執行個體參數匯出為模板

  1. 訪問RDS執行個體列表,在上方選擇地區,然後單擊目標執行個體ID。
  2. 在左側導覽列單擊參數設定

  3. 可修改參數頁簽中,單擊匯出為模板匯出為模板

  4. 設定匯出的模板名稱描述

    參數

    說明

    模板名稱

    模板的名稱。由英文、數字、小數點(.)或底線(_)組成,以字母開頭,不能包含中文,長度為8~64個字元。

    描述

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

  5. 單擊確定,完成匯出。

    您可以登入RDS管理主控台,在左側導覽列單擊參數模板,然後在上方選擇地區,查看已匯出的模板。

應用參數模板

建立執行個體時應用參數模板

建立執行個體時,支援為雲端硬碟執行個體設定參數模板。建立執行個體的具體步驟,請參見快速建立RDS PostgreSQL執行個體

  • 選擇系統參數模板:RDS PostgreSQL預設提供參數模板,命名規則為PostgreSQL_大版本號碼_系列_預設參數模板,例如PostgreSQL_14.0_高可用系列_預設參數模板。系統參數模板的各參數設定情況,請參見查看參數模板

  • 選擇自訂參數模板:您可以提前建立自訂參數模板,或單擊參數模板建立自訂參數模板連結,前往建立頁面。建立自訂參數模板的具體操作,請參見建立自訂參數模板

說明

系統參數模板不支援修改。

批量應用參數模板

警告
  • 應用參數模板到多個執行個體上時請確認參數是否適用這些執行個體,請您謹慎操作。

  • 部分參數修改在應用時會立即重啟執行個體,詳情請參見控制台參數模板的是否需要重啟列說明。重啟執行個體會造成串連中斷,重啟前請做好業務安排,謹慎操作。

  1. 登入RDS管理主控台,在左側導覽列單擊參數模板,然後在上方選擇地區。

  2. 自訂參數模板系統參數模板頁簽找到要應用的模板,單擊其右側操作列的應用到執行個體

    說明

    如果一個執行個體被依次應用了多個模板,則最後一模板會覆蓋之前應用的參數模板。

  3. 在左側執行個體列表中選擇需要應用參數模板的執行個體,單擊 />移動到右側,並查看參數對比,檢查參數修改是否符合預期。

  4. 單擊確定

應用參數模板到單個執行個體

警告

部分參數修改在應用時會立即重啟執行個體,詳情請參見控制台應用模板確認框中的是否需要重啟說明。重啟執行個體會造成串連中斷,重啟前請做好業務安排,謹慎操作。

  1. 訪問RDS執行個體列表,在上方選擇地區,然後單擊目標執行個體ID。
  2. 在左側導覽列單擊參數設定

  3. 可修改參數頁簽中,單擊應用模板應用模板

  4. 選擇可應用的模板名稱

    說明

    您可以登入RDS管理主控台,在左側導覽列單擊參數模板,然後在上方選擇地區,查看已建立的模板。

  5. 單擊確定,完成應用。

管理參數模板

複製自訂參數模板

如果您需要將當前地區的自訂參數模板複製到其他地區,或希望保留當前自訂參數模板,並在此基礎上對模板進行修改,則可以使用複製參數模板功能。

說明

自訂參數模板支援複製,系統參數模板不支援複製。

  1. 登入RDS管理主控台,在左側導覽列單擊參數模板,然後在上方選擇地區。

  2. 在自訂參數模板右側,單擊操作列下的表徵圖,選擇複製建立

  3. 設定如下參數。

    參數

    說明

    地區

    需要複製到的目標地區。

    模板名稱

    模板的名稱。由英文、數字、小數點(.)或底線(_)組成,以字母開頭,不能包含中文,長度為8~64個字元。

    描述

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

  4. 單擊確定

查看參數模板

  1. 登入RDS管理主控台,在左側導覽列單擊參數模板,然後在上方選擇地區。

  2. 自訂參數模板系統參數模板頁簽,單擊目標參數模板ID即可查看參數模板內的參數配置情況。

修改參數模板

您可以修改已建立的自訂參數模板。

警告

如果您修改了自訂參數模板,則需要重新應用模板後,修改的參數才會生效。如果修改的參數涉及重啟執行個體,則會重啟執行個體,造成串連中斷,重啟前請做好業務安排,謹慎操作。

  1. 登入RDS管理主控台,在左側導覽列單擊參數模板,然後在上方選擇地區。

  2. 在目標自訂參數模板右側,單擊操作列下的表徵圖,選擇修改

  3. 修改完成後,單擊確定

刪除參數模板

您可以刪除已建立的自訂參數模板。

  1. 登入RDS管理主控台,在左側導覽列單擊參數模板,然後在上方選擇地區。

  2. 在目標自訂參數模板右側,單擊操作列下的表徵圖,選擇刪除

  3. 在刪除確認對話方塊中,單擊確定

    說明

    如果目標自訂參數模板已被應用到1個或多個執行個體,則無法直接刪除。

    例如:自訂參數模板1已被應用到執行個體A執行個體B自訂參數模板1無法直接刪除,如果需要刪除,則需要分別為執行個體A執行個體B應用其他模板後,才可以刪除。

相關API

API

描述

建立參數模板

調用CreateParameterGroup介面建立RDS參數模板。

修改參數模板

調用ModifyParameterGroup介面修改RDS參數模板。

複製參數模板

調用CloneParameterGroup介面複製RDS參數模板到當前地區或其他地區。

查詢參數模板列表

調用DescribeParameterGroups介面查詢目標地區的參數模板列表。

查詢參數模板資訊

調用DescribeParameterGroup介面查詢指定的RDS參數模板資訊。

刪除參數模板

調用DeleteParameterGroup介面刪除RDS參數模板。

常見問題

Q:如何將自訂參數模板中的參數值重設為預設值。

A:

  1. 在自訂參數模板中找到目標參數,將配置值改為預設值,具體操作請參見修改參數模板

  2. 重新應用參數模板到目標執行個體,具體操作請參見應用參數模板