Citus分布式表全量存在所有Worker节点的异常问题咨询

以下是针对你遇到的问题的具体排查方向：

1. 确认表是否被误配置为参考表
   Citus的参考表（Reference Table）会被完整复制到所有Worker节点，且表名与原表一致，这是设计特性。执行以下SQL验证表的分布类型：

   SELECT distributiontype FROM pg_dist_table WHERE logicalrelid = '你的表名'::regclass;
   

   如果返回结果为'r'，说明该表是参考表而非哈希分片的分布式表。这可能是因为你误执行了create_reference_table()，或者在create_distributed_table()中使用了基数极低的分布键（比如常量列），触发了Citus自动将表转为参考表的逻辑。

2. 检查Worker节点的角色配置
   Docker Compose部署时，若Worker节点的CITUS_ROLE环境变量未正确设置为worker，而是设为了coordinator，会导致Worker节点实际启动为Coordinator的副本，从而所有节点都存储全量数据。
   登录每个Worker节点执行以下命令验证角色：

   SELECT current_setting('citus.role');
   

   若返回coordinator，说明配置错误，需修正Docker Compose文件中Worker服务的环境变量。

3. 验证Worker节点的连接正确性
   若Docker端口映射冲突，可能导致你以为连接的是Worker，实际访问的是Coordinator。执行以下命令确认当前连接的节点角色：

   SELECT noderole FROM pg_dist_node WHERE nodename = inet_server_addr();
   

   若返回coordinator，说明你连接的并非Worker节点，需检查Docker Compose的端口映射配置，确保使用正确的主机名/IP和端口连接Worker。

4. 修复元数据与实际存储的不一致
   若Citus的分片元数据（pg_dist_placement、pg_dist_table）与实际存储状态不一致，可能导致显示异常。执行以下命令重新同步元数据：

   SELECT citus_sync_metadata();
   

   同步完成后，再次查询分片位置，并检查Worker节点上的表是否为分片表（名称应为你的表名_shardxxxx格式）。

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