全部產品
Search
文件中心

ApsaraDB for ClickHouse:配置config.xml參數

更新時間:Sep 12, 2025

本文介紹了修改雲資料庫ClickHouse叢集config.xml設定檔中全域參數的方法。

背景資訊

雲資料庫ClickHouse叢集有若干參數,參數預設值通常配置在config.xml和user.xml,您可以修改參數進行執行個體最佳化,其中:

  • user.xml設定檔:您可以通過SET GLOBAL命令修改相關參數值,修改後無需重啟,詳情請參見user.xml參數修改

  • config.xml設定檔:您可以通過控制台修改相關參數值,請參見本文提示進行修改。

注意事項

  • 若叢集為社區版,只有2021年12月01日之後建立才支援XML模式配置參數和修改歷史的功能。

  • 企業版叢集,不支援XML模式配置參數。

  • XML模式不支援刪除參數,XML模式與預設模式支援的配置參數相同。

  • 修改的參數中如果包含需要重啟生效的參數,叢集會在完成參數修改後自動重啟。請先確認重啟目的地組群不會對業務產生影響,再提交參數。

叢集影響

  • 叢集狀態為配置變更中重啟中時,只能查看叢集資訊,無法進行升配、擴容和縮容等操作。

  • 如果修改的參數中包含需要重啟生效的參數,叢集在完成參數修改後會自動重啟。建議您在業務低峰期進行操作,以避免對業務造成影響。

修改參數

不同版本的叢集,修改參數的操作有所不同。

重要

如果您需要修改prometheus.port或text_log的參數,務必閱讀重要參數說明

企業版

  1. 登入雲資料庫ClickHouse管理主控台

  2. 在頁面左上方,選擇目的地組群所在的地區。

  3. 叢集列表頁面,選擇企業版執行個體列表,單擊目的地組群ID。

  4. 在左側導覽列,單擊參數管理

  5. 單擊運行參數值列中的修改按鈕參數編輯按鈕,進入參數編輯狀態,您可以根據提示的輸入範圍,輸入參數值,並點擊確定

  6. 修改所有目標參數後,點擊頁面右上方的提交參數

  7. 在彈出儲存配置對話方塊中,仔細審閱參數修改前後的值,確認修改內容,並填寫變更原因後,單擊提交參數

    重要

    如果提交的參數中包含需要重啟生效的參數,ClickHouse將會在完成參數修改後自動重啟叢集。請先確認重啟目標ClickHouse叢集不會對業務產生影響後。

    提交參數後,系統將自動校正參數值。如果參數值設定不合法,將彈出錯誤提示框。當ErrorCode為102時,說明輸入的參數值不合法,請返回修改參數值在輸入範圍內後重新提交。

社區版

  1. 登入雲資料庫ClickHouse管理主控台

  2. 在頁面左上方,選擇目的地組群所在的地區。

  3. 叢集列表頁面,選擇社區版執行個體列表,單擊目的地組群ID。

  4. 在左側導覽列,單擊參數配置

  5. 參數配置頁面,單擊配置頁簽。選擇預設模式XML模式,修改參數。

    重要

    prometheus.port 參數在雲資料庫ClickHouse控制台進行了限制範圍,您只能填寫2182至3000的連接埠。

    • 預設模式:單擊運行參數值列中的修改按鈕參數編輯按鈕,進入參數編輯狀態,您可以根據提示的輸入範圍,輸入參數值,並點擊確定

    • XML模式:單擊頁面右上方編輯按鈕,進入檔案修改狀態,修改目標參數。

  6. (可選)勾選頁面右上方的只顯示已修改過的參數,參數列表頁面僅展示修改過但未提交的參數。

    只顯示修改參數

  7. 修改所有目標參數後,點擊頁面右上方的提交參數

  8. 在彈出儲存配置對話方塊中,仔細審閱參數修改前後的值,確認修改內容,並填寫變更原因後,單擊提交參數

    重要
    • 如果提交的參數中包含需要重啟生效的參數,ClickHouse將會在完成參數修改後自動重啟叢集。請先確認重啟目標ClickHouse叢集不會對業務產生影響後。

    • XML模式下,如果參數值設定不合法,將彈出錯誤提示框。當ErrorCode為102時,說明輸入的參數值不合法,請返回修改參數值在輸入範圍內後重新提交。

撤銷修改

說明
  • 撤銷修改只支援未提交的已修改參數。

  • 社區版叢集的XML模式與企業版叢集,僅支援撤銷全部參數值的修改。

修改參數後,如果您需要撤銷修改,請在提交參數之前,執行以下操作:

  • 撤銷單個參數值的修改:單擊參數值後面撤銷表徵圖按鈕,雲資料庫ClickHouse將會撤銷單條已修改但未提交的參數值,顯示為修改前的參數值。

  • 撤銷全部參數值的修改:單擊參數列表右上方的撤銷按鈕,雲資料庫ClickHouse將會撤銷全部已修改但未提交的參數值,顯示為修改前的參數值。

查看修改歷史

企業版

  1. 登入雲資料庫ClickHouse控制台

  2. 在頁面左上方,選擇目的地組群所在的地區。

  3. 叢集列表頁面,選擇企業版執行個體列表,單擊目的地組群ID。

  4. 在左側導覽列,單擊參數管理

  5. 參數管理頁面,選擇修改歷史頁簽,通過以下兩種方式查看歷史修改記錄。

    • 單擊近30天近7天,查看近30天或近7天的歷史修改記錄。

    • 選擇開始和結束時間,查看指定時間範圍內的歷史修改記錄。

社區版

  1. 登入雲資料庫ClickHouse控制台

  2. 在頁面左上方,選擇目的地組群所在的地區。

  3. 叢集列表頁面,選擇社區版執行個體列表,單擊目的地組群ID。

  4. 在左側導覽列,單擊參數配置

  5. 參數配置頁面,選擇修改歷史頁簽,通過以下兩種方式查看歷史修改記錄。

    • 單擊近30天近7天,查看近30天或近7天的歷史修改記錄。

    • 選擇開始和結束時間,單擊查詢,查看指定時間範圍內的歷史修改記錄。

    image

重要參數說明

  • prometheus.port參數在雲資料庫ClickHouse控制台進行了限制範圍,您只能填寫2182至3000的連接埠。

  • 部分版本叢集未開啟text_log或text_log.level太低,如您需查看text_log,請根據自己需求設定text_log.level參數:

    參數值

    描述

    適用情境

    trace

    最詳細的記錄層級,它會記錄所有的操作和事件。

    追蹤程式的執行流程,開發和調試過程。

    debug

    它包含了在開發過程中可能需要的詳細資料,但相比於 trace 層級,它的冗長程度較低。通常情況下,它會記錄函數的調用、變數的狀態等相關資訊。

    偵錯工具。

    information

    用於記錄系統的正常操作和狀態資訊,例如啟動服務、完成某項任務等。該資訊通常表明系統處於正常運行狀態,且未發生錯誤。

    warning

    表示潛在的問題或非致命性錯誤。儘管系統仍在正常運行,但可能存在值得關注的情況。

    監控系統,分析潛在問題,進而最佳化系統。

    error

    表示系統出現了錯誤,已對系統的某些功能或操作產生影響。儘管系統可能仍在正常運行,但需及時關注並處理這些錯誤。

    監控系統,分析已發生的錯誤,便於解決問題。