Citus多租户数据库citus_stat_tenants视图无统计数据问题求助

1. 确认租户统计功能已启用 #

citus_stat_tenants视图依赖租户统计功能，默认可能未开启：

• 在主节点执行以下命令检查状态：

SHOW citus.enable_tenant_statistics;

• 若结果为off，需在所有节点的postgresql.conf中添加/修改配置：

citus.enable_tenant_statistics = on

• 重启所有节点的PostgreSQL服务生效。

2. 验证查询与分布表的租户匹配规则 #

该视图仅统计带租户过滤条件且分布列为单个租户ID列的查询：

• 确认你的查询明确指定了租户ID过滤（如WHERE company_id = 1），无租户过滤的全表扫描不会被统计。
• 检查分布表的分布列配置：

SELECT tablename, distribution_column FROM pg_dist_partition;

确保companies的分布列是id，campaigns是company_id，且均为单个列（复合分布列不支持租户统计）。

3. 手动触发统计数据刷新 #

租户统计默认每5分钟刷新一次（由citus.stat_tenants_refresh_interval控制），刚执行查询后可能未同步：

• 在主节点执行手动刷新命令：

SELECT citus_refresh_tenant_statistics();

刷新后重新查询citus_stat_tenants视图。

4. 检查节点间的统计同步状态 #

统计数据由工作节点上报至主节点，需确保节点连接正常：

• 查看节点活跃状态：

SELECT nodeid, nodename, nodeport, isactive FROM pg_dist_node;

确保所有工作节点的isactive为t。

• 登录每个工作节点，检查本地统计数据：

SELECT * FROM citus_stat_tenants_local;

若工作节点有数据但主节点无，需检查Citus元数据同步，或重启主节点的PostgreSQL服务。

5. 确认操作类型属于统计范畴 #

citus_stat_tenants仅统计针对单个租户的DML操作（SELECT/UPDATE/DELETE等），COPY、DDL或跨租户批量操作不会被纳入统计。

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