本文介紹了修改雲資料庫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的參數,務必閱讀重要參數說明。
企業版
在頁面左上方,選擇目的地組群所在的地區。
在叢集列表頁面,選擇企業版執行個體列表,單擊目的地組群ID。
在左側導覽列,單擊參數管理。
單擊運行參數值列中的修改按鈕
,進入參數編輯狀態,您可以根據提示的輸入範圍,輸入參數值,並點擊確定。修改所有目標參數後,點擊頁面右上方的提交參數。
在彈出儲存配置對話方塊中,仔細審閱參數修改前後的值,確認修改內容,並填寫變更原因後,單擊提交參數。
重要如果提交的參數中包含需要重啟生效的參數,ClickHouse將會在完成參數修改後自動重啟叢集。請先確認重啟目標ClickHouse叢集不會對業務產生影響後。
提交參數後,系統將自動校正參數值。如果參數值設定不合法,將彈出錯誤提示框。當ErrorCode為102時,說明輸入的參數值不合法,請返回修改參數值在輸入範圍內後重新提交。
社區版
在頁面左上方,選擇目的地組群所在的地區。
在叢集列表頁面,選擇社區版執行個體列表,單擊目的地組群ID。
在左側導覽列,單擊參數配置。
在參數配置頁面,單擊配置頁簽。選擇預設模式或XML模式,修改參數。
重要prometheus.port 參數在雲資料庫ClickHouse控制台進行了限制範圍,您只能填寫2182至3000的連接埠。
預設模式:單擊運行參數值列中的修改按鈕
,進入參數編輯狀態,您可以根據提示的輸入範圍,輸入參數值,並點擊確定。XML模式:單擊頁面右上方編輯按鈕,進入檔案修改狀態,修改目標參數。
(可選)勾選頁面右上方的只顯示已修改過的參數,參數列表頁面僅展示修改過但未提交的參數。

修改所有目標參數後,點擊頁面右上方的提交參數。
在彈出儲存配置對話方塊中,仔細審閱參數修改前後的值,確認修改內容,並填寫變更原因後,單擊提交參數。
重要如果提交的參數中包含需要重啟生效的參數,ClickHouse將會在完成參數修改後自動重啟叢集。請先確認重啟目標ClickHouse叢集不會對業務產生影響後。
XML模式下,如果參數值設定不合法,將彈出錯誤提示框。當ErrorCode為102時,說明輸入的參數值不合法,請返回修改參數值在輸入範圍內後重新提交。
撤銷修改
撤銷修改只支援未提交的已修改參數。
社區版叢集的XML模式與企業版叢集,僅支援撤銷全部參數值的修改。
修改參數後,如果您需要撤銷修改,請在提交參數之前,執行以下操作:
撤銷單個參數值的修改:單擊參數值後面
按鈕,雲資料庫ClickHouse將會撤銷單條已修改但未提交的參數值,顯示為修改前的參數值。撤銷全部參數值的修改:單擊參數列表右上方的撤銷按鈕,雲資料庫ClickHouse將會撤銷全部已修改但未提交的參數值,顯示為修改前的參數值。
查看修改歷史
企業版
在頁面左上方,選擇目的地組群所在的地區。
在叢集列表頁面,選擇企業版執行個體列表,單擊目的地組群ID。
在左側導覽列,單擊參數管理。
在參數管理頁面,選擇修改歷史頁簽,通過以下兩種方式查看歷史修改記錄。
單擊近30天或近7天,查看近30天或近7天的歷史修改記錄。
選擇開始和結束時間,查看指定時間範圍內的歷史修改記錄。
社區版
在頁面左上方,選擇目的地組群所在的地區。
在叢集列表頁面,選擇社區版執行個體列表,單擊目的地組群ID。
在左側導覽列,單擊參數配置。
在參數配置頁面,選擇修改歷史頁簽,通過以下兩種方式查看歷史修改記錄。
單擊近30天或近7天,查看近30天或近7天的歷史修改記錄。
選擇開始和結束時間,單擊查詢,查看指定時間範圍內的歷史修改記錄。

重要參數說明
prometheus.port參數在雲資料庫ClickHouse控制台進行了限制範圍,您只能填寫2182至3000的連接埠。
部分版本叢集未開啟text_log或text_log.level太低,如您需查看text_log,請根據自己需求設定text_log.level參數:
參數值
描述
適用情境
trace
最詳細的記錄層級,它會記錄所有的操作和事件。
追蹤程式的執行流程,開發和調試過程。
debug
它包含了在開發過程中可能需要的詳細資料,但相比於 trace 層級,它的冗長程度較低。通常情況下,它會記錄函數的調用、變數的狀態等相關資訊。
偵錯工具。
information
用於記錄系統的正常操作和狀態資訊,例如啟動服務、完成某項任務等。該資訊通常表明系統處於正常運行狀態,且未發生錯誤。
無
warning
表示潛在的問題或非致命性錯誤。儘管系統仍在正常運行,但可能存在值得關注的情況。
監控系統,分析潛在問題,進而最佳化系統。
error
表示系統出現了錯誤,已對系統的某些功能或操作產生影響。儘管系統可能仍在正常運行,但需及時關注並處理這些錯誤。
監控系統,分析已發生的錯誤,便於解決問題。