首页/数据/NoSQL 速查/remote 与 cluster 跨实例查询
本包目录(322 条)
MongoDB99 条Elasticsearch89 条
ClickHouse56 条
时序与列式28 条选型与架构50 条

remote 与 cluster 跨实例查询

remote 表函数可在一条 SQL 里查询其他 ClickHouse 实例的表,cluster/clusterAllReplicas 按集群拓扑展开:适合临时跨集群对账与迁移校验。

NoSQL 速查数据更新于 2026-10-12
remoteremote('host:9000', db, table[, user, password]),单实例查询
clustercluster('prod', db, table) 对每个分片各查一次
clusterAllReplicasclusterAllReplicas('prod', db, table) 覆盖全部分片的所有副本

示例

示例
SELECT count() FROM remote('10.0.0.8:9000', 'analytics', 'events');

SELECT hostName(), count()
FROM clusterAllReplicas('prod', 'analytics', 'events')
GROUP BY hostName();
跨实例查询会传输结果数据,过滤条件下推能力有限,大范围对账建议在各集群先聚合再比较。

易错点

  • remote 连接信息里硬编码的密码会进入查询日志,敏感场景改用命名集合或分布式表
  • clusterAllReplicas 会遍历所有副本,副本数据相同时按副本聚合会得到重复计数

数据来源与参考

  • ClickHouse Docs: Table functions (remote, cluster)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌