Citus中为已存共置表新增分片的无停机扩容方案咨询

Citus 11.0及以上版本原生支持无感知在线调整分片数量，是目前最优的解决方案，低于该版本可通过迁表方案实现近似无停机扩容

操作前前置检查 #

• 确认待调整的共置表所属共置组ID，执行命令查询：
  SELECT colocationid FROM pg_tables WHERE tablename = '你的业务表名';
• 核对该共置组下所有关联表的分布列规则一致，没有未提交的DDL或长事务锁
• 确认集群worker节点剩余磁盘空间不低于该共置组总数据量的1.2倍，预留足够的重分片运算资源

11.0+版本在线无停机调整步骤 #

直接调用Citus内置函数alter_distributed_table修改目标共置组根表的分片数即可，所有同组的共置表会自动同步调整分片配置，整个过程不会阻塞业务读写，仅最终元数据切换时有毫秒级的短暂不可用，业务侧完全无感知。
调整命令示例（将分片数调整为64，可按需替换为你需要的目标值）：

SELECT alter_distributed_table('你的共置组根表名', shard_count => 64);

操作注意事项 #

• 重分片过程会占用集群的CPU、IO和网络资源，建议在业务低峰期执行
• 调整过程中不要对该共置组下的表执行DDL操作，避免触发锁冲突
• 若分片数调整幅度较大（例如从32调整到256），建议分批调整，每次将分片数翻倍，避免单次操作占用过多资源影响业务

11.0以下版本近似无停机调整方案 #

低于11.0的Citus版本没有内置在线重分片能力，可通过双写迁表的方式实现无停机扩容：

1. 新建和原表结构完全一致的目标表，提前设置好需要的分片数和共置组规则
2. 配置原表到新表的增量数据同步，可通过触发器或者CDC工具实现
3. 全量同步原表的历史数据到新表，完成后校验两边数据一致性
4. 业务侧灰度切换读写流量到新表，确认业务无异常后删除旧表即可

调整完成后可执行 SELECT count(*) FROM pg_dist_shard WHERE logicalrelid = '你的业务表名'::regclass; 验证最终分片数是否符合预期。

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