ClickHouse从S3恢复Replicated表遇REPLICA_ALREADY_EXISTS错误求助

当前环境为3个由ZooKeeper管理的ClickHouse 23.3副本节点集群，执行备份恢复操作时遇到异常：

表结构 #

CREATE OR REPLACE TABLE test2 on cluster 'x'(
id UInt64,
  updated_at DateTime DEFAULT now(),
  updated_at_date Date DEFAULT toDate(updated_at)
)
ENGINE = ReplicatedReplacingMergeTree('/clickhouse/tables/{shard}/test2', '{replica}')
ORDER BY id;

备份命令 #

BACKUP TABLE db.test2 on cluster 'x' to S3('https://backup/test2-base', '', '')

恢复操作及报错 #

执行恢复命令：

restore TABLE db.test2 AS test2 on cluster 'x' from S3('https://backup/test2-base', '', '')

触发错误：

DB::Exception: Got error from chi%2Dclickhouse%2Dch%2Dcluster%2D0%2D1:9000. DB::Exception: Replica /clickhouse/tables/0/test2/replicas/chi-clickhouse-x-0-1 already exists: While creating table default.test2. (REPLICA_ALREADY_EXISTS)

尝试过分离表、重命名恢复（如下命令），但问题未解决：

restore TABLE db.test2 AS test2_recovered on cluster 'x' from S3('https://backup/test2-base', '', '')

疑问：如何删除该路径？该路径存储在ClickHouse服务器还是ZooKeeper中？

1. 路径存储位置 #

报错中的/clickhouse/tables/0/test2/replicas/chi-clickhouse-x-0-1路径存储在ZooKeeper中，这是ReplicatedMergeTree系列引擎用于记录副本状态、同步元数据的核心节点。

2. 删除ZooKeeper中的目标路径 #

通过ZooKeeper客户端工具（如zkCli.sh）登录集群执行删除操作：

• 登录ZooKeeper集群：

  zkCli.sh -server <zk主机地址>:<zk端口>
  

• 确认目标路径存在：

  ls /clickhouse/tables/0/test2/replicas
  

• 删除单个副本节点：

  delete /clickhouse/tables/0/test2/replicas/chi-clickhouse-x-0-1
  

  若需清理整个表的所有ZooKeeper元数据（包含所有副本节点），则执行：

  rmr /clickhouse/tables/0/test2
  

3. 恢复操作注意事项 #

• 删除ZooKeeper路径后，需确保所有ClickHouse节点上对应表已被DROP或DETACH，避免本地残留元数据干扰。
• 若恢复为新表名，需在恢复命令中指定新的ZooKeeper路径和副本标识，避免复用原表路径引发冲突：

  restore TABLE db.test2 AS test2_recovered on cluster 'x' 
  from S3('https://backup/test2-base', '', '')
  SETTINGS replace_tree_path='/clickhouse/tables/{shard}/test2_recovered', replace_replica_name='{replica}';
  

内容的提问来源于stack exchange，提问作者Atheer Abdullatif