v.24.3Improvement

Support for merge attribute in config substitutions for subtrees

Official CH changelog text
Now it's possible to specify the attribute merge="true" in config substitutions for subtrees <include from_zk="/path" merge="true">. In case this attribute specified, clickhouse will merge subtree with existing configuration, otherwise default behavior is append new content to configuration. #61299 (alesapin).
ClickHouse now supports a merge="true" attribute for config substitutions in <include> elements, allowing subtree configurations from ZooKeeper to be merged instead of appended.

Why it matters

This feature addresses the limitation where including configuration subtrees from ZooKeeper would only append new content, potentially causing duplication or conflicts. By enabling merging, users can combine configurations more seamlessly, improving configuration management and consistency.

How to use it

To enable this feature, specify merge="true" in the <include> element when loading configuration from ZooKeeper, for example: 

&lt;include from_zk="/path" merge="true"&gt;


This will merge the loaded subtree with the existing configuration instead of simply appending it.

Related resources

PreviousNext