配置config.xml参数

本文介绍了修改云数据库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模式与默认模式支持的配置参数相同。

修改参数

  1. 登录云数据库ClickHouse管理控制台

  2. 在页面左上角,选择目标集群所在的地域。

  3. 集群列表页面,选择社区版实例列表,单击目标集群ID。

  4. 在左侧导航栏,单击参数配置

  5. 参数配置页面,单击配置页签。选择默认模式XML模式,对参数进行修改。

    说明

    prometheus.port 参数在云数据库ClickHouse控制台进行了限制范围,您只能填写2182至3000的端口。

  6. 单击运行参数值列中的修改按钮参数编辑按钮,进入参数编辑状态,您可以根据提示的输入范围,输入参数值,并点击确定,或单击取消退出参数编辑状态。

    参数编辑 单击确定

    说明

    XML模式下,单击编辑按钮,进入到参数的修改状态。

  7. (可选)勾选页面右上方的只显示已修改过的参数,参数列表页面仅展示修改过但未提交的参数。

    只显示修改参数

  8. 修改完所有参数后,点击页面右上角的提交参数

  9. 在弹出保存配置对话框中填写变更原因,单击提交参数

    说明
    • 您可以在保存配置对话框中的配置对比,查看修改前后的参数值。

    • 如果提交的参数中包含需要重启生效的参数,ClickHouse将会在完成参数修改后自动重启集群。请先确认重启目标ClickHouse集群不会对业务产生影响后。

    提交参数后,系统将自动校验参数值。如果参数值设置不合法,将弹出错误提示框。当ErrorCode为102时,说明输入的参数值不合法,请返回修改参数值在输入范围内后重新提交。

撤销修改

说明
  • 撤销修改只支持未提交的已修改参数。

  • XML模式仅支持撤销全部参数值的修改。

修改参数后,如果您需要撤销修改,请在提交参数之前,执行以下操作:

  • 撤销单个参数值的修改:单击参数值后面撤销图标按钮,云数据库ClickHouse将会撤销单条已修改但未提交的参数值,显示为修改前的参数值。

  • 撤销全部参数值的修改:单击参数列表右上角的撤销按钮,云数据库ClickHouse将会撤销全部已修改但未提交的参数值,显示为修改前的参数值。

查看修改历史

  1. 登录云数据库ClickHouse控制台

  2. 在页面左上角,选择目标集群所在的地域。

  3. 集群列表页面,选择社区版实例列表,单击目标集群ID。

  4. 在左侧导航栏,单击参数配置

  5. 参数配置页面,选择修改历史页签,通过以下两种方式查看历史修改记录。

    • 单击近30天近7天,查看近30天或近7天的历史修改记录。

    • 选择开始和结束时间,单击查询,可以查看指定时间范围内的历史修改记录。

    image