AE 分析-多集群

在多集群部署环境下，按全球/从集群路由查询分析报表与 Ad-hoc 数据，不再因集群选择错误导致数据口径偏差。

数据分析

异常诊断全行业

AE 全球集群查询 Skill 是 ThinkingAI 行业 Skill 库中的一项多集群数据路由能力，帮助运营与分析团队在 AE 多集群（全球/从集群）部署环境下正确选择查询范围和集群路由，避免因集群选择错误导致数据口径偏差或查询无结果，从"不知道该查哪个集群"升级为"先看集群信息再选路由再查数据"的精准查询模式。这正是 ThinkingAI「10 年行业经验沉淀为开箱即用 Skill」的体现。

Agent存为 Agent导出会话

ae-analysis-global

上周的全球收入周报和财务系统对不上，少了一大截。我是直接用默认集群查的报表数据——是不是集群选错了？帮我按正确口径重新拉一遍，顺便分区域拆开看。

+list_query_clusters 列出某出海SLG游戏DEMO 的全部查询集群

当前集群 + 东南亚从集群 + 欧美从集群，GLOBAL 权限已开通

定位原周报的数据来源

报表查询未带 cluster_query_scope 参数，默认只查了当前集群

+query_report_data --cluster_query_scope GLOBAL 重拉上周收入

全球口径 408.3 万元

按 SLAVE 路由逐集群拉取收入与 DAU，交叉校验加总

与原周报口径比对差额，生成口径修正说明

对不齐的原因找到了：你的周报只统计了当前集群。按 GLOBAL 口径重拉后，上周收入是 408.3 万元，缺口 161.1 万元（占全球口径 39.5%）——正好是两个从集群的收入之和。

一、你的项目有三个查询集群

当前集群（默认查询范围）——不带 cluster_query_scope 参数时只查它，这就是缺口的来源

东南亚从集群、欧美从集群——需要显式走 SLAVE 路由才会被查到

项目已开通 GLOBAL 查询权限——全球聚合口径可以直接用，无需逐集群手动加总

二、全球口径收入拆解

集群	上周收入	收入占比	周均 DAU	付费率
当前集群	247.2 万元	60.5%	18.2 万	3.1%
东南亚从集群	121.5 万元	29.8%	15.6 万	2.2%
欧美从集群	39.6 万元	9.7%	3.4 万	4.0%
GLOBAL 汇总	408.3 万元	100%	37.2 万	2.8%

← 左右滑动查看

分集群上周收入对比　单位：万元

东南亚从集群贡献了近三成收入（29.8%），DAU 体量已接近当前集群（15.6 万 vs 18.2 万）——这部分在原周报里完全缺失。欧美集群量小但付费率最高（4.0%），做区域深度分析时值得单独看。

三、口径规则，避免下次再踩

全球总览 → --cluster_query_scope GLOBAL，聚合全部集群一次出数

单区域深度分析 → SLAVE + 指定从集群，只返回该集群数据

不带参数 → 默认只查当前集群——适合单集群项目，多集群项目慎用

提醒

一个必须注意的例外：SQL Ad-hoc 模型只支持当前集群，不支持 GLOBAL / SLAVE 路由。如果周报里混有 SQL 组件，那部分仍然是当前集群口径，需要单独标注——否则修正过的周报会再次出现口径错位。

GLOBAL 口径参数已回写至周报查询模板，下周起自动按全球口径出数。

行业痛点

多集群部署是出海和全球化产品的标配架构，但超过 50% 的分析团队在跨集群查询时踩坑：不知道项目有多少查询集群、不知道从集群名称和 ID、不知道 GLOBAL 和 SLAVE 权限差异。凭直觉选择查询范围后，要么返回空数据，要么权限报错，要么数据口径与单集群不一致。一次跨集群查询平均调试耗时 30 分钟以上，错误往往在数据已经用于决策后才发现。

核心价值

集群清单自动发现：一键列出项目所有查询集群（当前集群 + 从集群），包含名称、描述和权限信息
路由规则精准匹配：根据用户意图自动选择 GLOBAL / SLAVE / 默认范围，不猜测不允许的参数
权限边界清晰：检查 GLOBAL 和 SLAVE 查询权限，不允许的参数直接告知用户而非静默报错
SQL 模型安全隔离：SQL Ad-hoc 模型仅支持当前集群，自动排除跨集群 SQL 查询避免数据错乱

适用场景

出海项目需要查询全球聚合数据（所有集群汇总）

需要单独查询某个从集群（如东南亚、欧美）的数据

不确定项目有多少集群，需要先查看集群信息

查询报权限错误，需要确认允许的查询范围参数

需要区分"查询集群"和"用户分群"概念避免混淆

实战案例

某出海 SLG 游戏 · 全球收入周报修正

项目部署了当前集群、东南亚从集群、欧美从集群，运营原本直接用当前集群数据做全球收入周报，遗漏东南亚集群 30% 收入。Skill 先 +list_query_clusters 列出全部集群并确认 GLOBAL 权限，再用 +query_report_data --cluster_query_scope GLOBAL 获取全球聚合数据，周报口径被修正为全球口径。

常见疑问

GLOBAL 查询和 SLAVE 查询有什么区别？

GLOBAL 查询聚合所有集群数据，适合全球总览；SLAVE 查询只返回指定从集群数据，适合区域深度分析。

这个 Skill 和 ae-analysis 有什么关系？

ae-analysis-global 是 ae-analysis 的多集群叠加层，仅在项目启用多集群模式时叠加本 Skill 的路由规则。

SQL 模型能跨集群查询吗？

不能。SQL Ad-hoc 模型只支持当前集群，不支持 GLOBAL 或 SLAVE 路由。