ClickHouse复制表执行DROP PARTITION时遇只读模式错误求助

问题诊断步骤 #

先登录每个集群节点，执行以下命令确认副本的只读状态及具体错误原因：

SELECT is_readonly, last_error_message, * FROM system.replicas WHERE table = 'rTable' AND database = 'dbName';

通过返回的is_readonly（1代表只读）和last_error_message字段定位问题根源。

常见原因及解决方法 #

1. ZooKeeper连接/同步异常 #

这是ReplicatedMergeTree触发只读模式的最常见原因：

• 检查ZK集群状态，确保所有ZK节点正常运行，且副本服务器能连通ZK默认端口（2181）；
• 对异常节点执行副本重启命令：

  SYSTEM RESTART REPLICA dbName.rTable;
  

  若重启无效，直接重启对应节点的Clickhouse服务；
• 验证表指定的ZK路径/clickhouse/tables/rTable/shard1是否存在，且Clickhouse进程对该路径具备读写权限。

2. 集群internal_replication=false导致DDL未同步 #

你的集群配置中internal_replication=false，意味着Clickhouse不会自动将ALTER操作同步到所有副本：

• 临时处理：在每个节点上单独执行分区删除命令：

  ALTER TABLE dbName.rTable DROP PARTITION 20220107;
  

• 长期优化：修改集群配置文件中的internal_replication为true，重启所有节点的Clickhouse服务后，即可通过分布式DDL一次性完成操作：

  ALTER TABLE dbName.rTable ON CLUSTER ha DROP PARTITION 20220107;
  

3. 磁盘空间耗尽 #

若节点磁盘已满，Clickhouse会自动切换到只读模式保护数据：
先检查磁盘剩余空间：

SELECT name, free_space, total_space FROM system.disks;

清理出足够空间后，执行以下命令解除只读限制：

ALTER TABLE dbName.rTable MODIFY SETTINGS readonly = 0;

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