本文介绍了修改云数据库ClickHouse集群config.xml配置文件中全局参数的方法。
背景信息
云数据库ClickHouse集群有若干参数,参数默认值通常配置在config.xml和user.xml,您可以修改参数进行实例优化,其中:
user.xml配置文件:您可以通过set global命令修改相关参数值,修改后无需重启,详情请参见user.xml参数修改。
config.xml配置文件:您可以通过控制台修改相关参数值,详情请参见config.xml参数修改。
注意事项
仅2021年12月01日之后创建的云数据库ClickHouse社区兼容版集群支持XML模式和修改历史的功能。
云数据库ClickHouse企业版集群不支持配置参数功能。
如果提交的参数中包含需要重启生效的参数,云数据库ClickHouse将会在完成参数修改后自动重启集群。请先确认重启目标云数据库ClickHouse集群不会对业务产生影响,再提交参数。
当云数据库ClickHouse集群状态为配置变更中时,只能查看集群信息,无法进行升配、扩容和缩容等操作。
XML模式不支持删除参数,XML模式与默认模式支持的配置参数相同。
修改参数
在页面左上角,选择目标集群所在的地域。
在集群列表页面,选择社区版实例列表,单击目标集群ID。
在左侧导航栏,单击参数配置。
在参数配置页面,单击配置页签。选择默认模式或XML模式,对参数进行修改。
说明prometheus.port 参数在云数据库ClickHouse控制台进行了限制范围,您只能填写2182至3000的端口。
单击运行参数值列中的修改按钮,进入参数编辑状态,您可以根据提示的输入范围,输入参数值,并点击确定,或单击取消退出参数编辑状态。
说明在XML模式下,单击编辑按钮,进入到参数的修改状态。
(可选)勾选页面右上方的只显示已修改过的参数,参数列表页面仅展示修改过但未提交的参数。
修改完所有参数后,点击页面右上角的提交参数。
在弹出保存配置对话框中填写变更原因,单击提交参数。
说明您可以在保存配置对话框中的配置对比,查看修改前后的参数值。
如果提交的参数中包含需要重启生效的参数,ClickHouse将会在完成参数修改后自动重启集群。请先确认重启目标ClickHouse集群不会对业务产生影响后。
提交参数后,系统将自动校验参数值。如果参数值设置不合法,将弹出错误提示框。当ErrorCode为102时,说明输入的参数值不合法,请返回修改参数值在输入范围内后重新提交。
撤销修改
撤销修改只支持未提交的已修改参数。
XML模式仅支持撤销全部参数值的修改。
修改参数后,如果您需要撤销修改,请在提交参数之前,执行以下操作:
撤销单个参数值的修改:单击参数值后面按钮,云数据库ClickHouse将会撤销单条已修改但未提交的参数值,显示为修改前的参数值。
撤销全部参数值的修改:单击参数列表右上角的撤销按钮,云数据库ClickHouse将会撤销全部已修改但未提交的参数值,显示为修改前的参数值。
查看修改历史
在页面左上角,选择目标集群所在的地域。
在集群列表页面,选择社区版实例列表,单击目标集群ID。
在左侧导航栏,单击参数配置。
在参数配置页面,选择修改历史页签,通过以下两种方式查看历史修改记录。
单击近30天或近7天,查看近30天或近7天的历史修改记录。
选择开始和结束时间,单击查询,可以查看指定时间范围内的历史修改记录。