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

背景信息

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

参数修改

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

撤销修改

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

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

提交参数

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

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

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