v.25.4New Feature

Bind Host In Clusters Configuration

Official CH changelog text
Add bind_host setting in the clusters configuration so that ClickHouse can use a specific network for distributed connections. #74741 (Todd Yocum).
Add the bind_host setting to cluster configurations, enabling ClickHouse to bind distributed connections to a specific network interface or IP address.

Why it matters

This feature allows users to control which network interface ClickHouse uses for distributed queries when connecting to cluster nodes. It helps solve networking issues in multi-homed environments where multiple network interfaces are present, ensuring more reliable and secure distributed communication.

How to use it

In the cluster configuration XML, add the bind_host setting inside the cluster's shard or replica definition to specify the local IP address or network interface ClickHouse should bind for outgoing distributed connections.

Related resources

PreviousNext