本文介绍了修改ClickHouse集群config.xml配置文件中全局参数的方法。

背景信息

ClickHouse集群有若干参数,参数默认值通常配置在config.xml和user.xml文件中,您可以通过修改全局参数帮助进行实例优化,其中:
  • user.xml配置文件您可以通过set global 命令行进行全局修改,无需重启实例,详情请参见user.xml参数修改
  • Config.xml配置文件中的参数,您可以通过控制台进行在线修改并重启实例使修改后的参数生效。基于修改频率和实例稳定性考虑,您可以通过控制台修改的参数如下表所示:
    参数名 默认值 取值范围 是否需要重启 参数说明
    max_concurrent_queries 100 >0 同时处理的最大请求数。
    max_connections 4096个 >0 最大入站连接数。
    keep_alive_timeout 3秒 >0 ClickHouse在关闭连接之前等待传入请求的秒数。
    max_table_size_to_drop 50*1024*1024(byte)53687091200 >0 如果MergeTree表的大小超过max_table_size_to_drop(以字节为单位),则不能使用DROP语句将其删除。
    timezone Europe/Moscow 合法时区信息如:
    • Africa/Abidjan
    • Asia/Shanghai
    • Europe/Moscow
    实例的时区。
    mark_cache_size 5368709120 >=5368709120 MergeTree表引擎使用的标记缓存的近似大小(以字节为单位)。
    uncompressed_cache_size 8589934592 bytes >=0 MergeTree表引擎使用的未压缩数据的缓存大小(以字节为单位)。 ClickHouse实例有一个共享缓存,内存按需分配。如果启用了“使用未压缩的缓存”选项,则使用缓存。

参数修改

  1. 使用阿里云账号登录云数据库ClickHouse控制台
  2. 在页面左上角,选择目标集群所在的地域。
  3. 在左侧导航栏,单击集群列表
  4. 找到目标集群,单击集群ID,进入集群详情页面。
  5. 在左侧导航栏,单击参数配置,查看参数列表。
  6. 单击参数列表中运行参数值列中的修改按钮参数编辑按钮,进入参数编辑状态,您可以根据提示的参考输入范围,输入合法的参数值,并点击确定。或单击取消退出参数编辑状态。参数编辑 单击确定
  7. 您可以通过勾选运行参数值字段后的只显示页面修改过的参数(未提交)筛选框,进行参数筛选,筛选后的参数列表页面仅展示修改过但未提交的参数。只显示已修改未提交参数

撤销修改

注意 仅支持撤销未提交的已修改参数。

修改参数后,如果您需要将修改过的参数全部取消修改,请在提交之前,点击参数列表右上角的撤销按钮。ClickHouse将会撤销全部已修改未提交的参数内容,显示为修改前的参数值。

提交参数

确认修改完所有参数后,点击页面右上角的提交参数按钮,进行参数提交。

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

确认修改参数后,ClickHouse先进行参数校验,如果参数值设置不合法,将会提示错误,请返回修改参数值在参考范围内后重新提交。