Configuration for Minimal Data Storage in Zookeeper with ReplicatedMergeTree

Published: November 25, 2025

Configuration of the table level for the ReplicatedMergeTree family in order to minimize the amount of data stored in Zookeeper: : use_minimalistic_checksums_in_zookeeper = 1

Introduces a table-level configuration for the ReplicatedMergeTree family to reduce the amount of data stored in ZooKeeper by enabling minimalistic checksums.

Why it matters

This feature aims to optimize resource usage and improve performance by minimizing the metadata size stored in ZooKeeper, which is used for coordination in replicated tables. By using minimalistic checksums, the storage overhead and synchronization cost in ZooKeeper are reduced, benefiting users with large-scale deployments or heavy replication.

How to use it

Set the setting use_minimalistic_checksums_in_zookeeper = 1 at the table level for ReplicatedMergeTree tables to enable minimalistic checksum usage in ZooKeeper.