首页/数据/NoSQL 速查/remote_servers 集群拓扑配置
ClickHouse56 条

remote_servers 集群拓扑配置

集群拓扑在 config.xml(或 conf.d 下的独立文件)用 remote_servers 定义:每个 shard 下挂多个 replica,配 internal_replication=true 时写副本表只写其中一个副本。

NoSQL 速查数据更新于 2026-10-12
配置位置config.xml 或 config.d/ 下的片段文件,通常放 remote_servers 与 macros
结构remote_servers → cluster 名 → shard → replica 列表
internal_replicationtrue 表示写一张副本表即可,由副本机制同步;配合 ReplicatedMergeTree 使用

示例

示例
<remote_servers>
  <prod>
    <shard>
      <internal_replication>true</internal_replication>
      <replica>
        <host>ch-1</host>
        <port>9000</port>
      </replica>
      <replica>
        <host>ch-2</host>
        <port>9000</port>
      </replica>
    </shard>
  </prod>
</remote_servers>
配置校验用 SELECT * FROM system.clusters 查看展开后的分片与副本拓扑。

易错点

  • internal_replication=false 时写入所有副本、由 Distributed 负责一致性,与副本表机制混用容易重复计数
  • 改完配置需要 reload/重启,滚动操作期间集群查询会短暂受影响

数据来源与参考

  • ClickHouse Docs: Server configuration (remote_servers)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌