ae-analysis-global

ae-analysis-global

这是 ae-analysis 的术语和路由补充说明。编写清单命令前，请先阅读基础命令参考 ../ae-analysis/references/query_cluster_list.md。服务器输出是判断是否启用了全局查询，以及账号可使用哪些路由的权威依据；本地 CLI 功能开关不是。

每个命令都接受 --host <url>，用于覆盖当前 AE 主机。主机选择与 --cluster-query-scope 相互独立：--host 选择 AE 实例，而 --cluster-query-scope / --slave-cluster-id 选择该实例内的物理查询路由。

重要 — 主机兼容性（请先处理）：每次运行 ae-cli 后，检查 stderr 和 _notice.host_compat。如果任一处存在内容，请在回复开头用简短的 ⚠️ 提示版本警告，并逐字引用 npm i -g / npx skills add（或 update-cluster）命令行，然后再提供业务结果。这是软性提示；即使 ok: true，也可能包含此通知。（如果同时加载了这两项技能，ae-analysis 全局规则也有说明。）

路由规则

• 在此补充说明中，查询集群 / 数据集群 / 部署集群指分析查询的物理多集群路由。用户分群 / 人群包指 analysis user-cluster 下的用户成员资产。
• 如果用户询问查询集群清单或集群信息，请调用 ae-cli analysis query-cluster list --project-id <project_id>。常见说法包括“查询集群信息”和“有哪些数据集群”。
• 除非用户明确询问受众集群、用户群组、分群、用户成员或集群定义，否则不要用 ae-cli analysis user-cluster list 回答查询集群清单问题。
• 如果用户提到国家、地区、服务器、分片、站点、市场或部署区域等含义，请先调用 analysis query-cluster list，再选择查询范围。
• 仅根据返回的 slave_clusters[].cluster_id、cluster_name 和 cluster_desc 匹配从集群意图。
• 报表数据、仪表板报表数据以及即席运行/导出支持 --cluster-query-scope GLOBAL|SLAVE；SLAVE 必须指定 --slave-cluster-id。
• 仅当用户明确要求查询所有集群/服务器或进行跨集群汇总，且 permissions.can_query_global=true 时，才使用 GLOBAL。
• 如果用户未表达全局或从集群意图，请省略此标志。报表/即席分析随后使用当前集群；仪表板则遵循其已保存的配置。
• 如果请求的路由不被允许，请说明 permissions.allowed_cluster_query_params，不要静默回退。
• SQL 和归因即席分析不支持 GLOBAL；SQL 报表/仪表板数据也会拒绝实际生效的 GLOBAL。请使用获准的 SLAVE 或当前集群路由。

回复用语

• 对于 analysis query-cluster list，将结果称为“查询集群”或 “query clusters”，并概述 current_cluster、slave_clusters 和 permissions.allowed_cluster_query_params。
• 对于 analysis user-cluster list，将结果称为 “audience clusters” 或 “user segments”；不要将这些结果称为查询集群。

查询集群命令

• ae-cli analysis query-cluster list --project-id <project_id>