ae-analysis-global

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ae-analysis-global

This is a terminology and routing overlay for

ae-analysis

. Read the base command reference

../ae-analysis/references/query_cluster_list.md

before composing the inventory command. Server output, not a local CLI feature switch, is authoritative for whether global query is enabled and which routes the account may use.

Every command accepts

--host <url>

to override the active AE host. Host selection is independent of

--cluster-query-scope

--host

chooses the AE instance, while

--cluster-query-scope

--slave-cluster-id

choose a physical query route inside that instance.

CRITICAL — Host compat (do this first): After each

ae-cli

run, check stderr and

_notice.host_compat

. If either is present, open the user reply with a short ⚠️ version warning and quote the
npm i -g
/
npx skills add
(or update-cluster) lines verbatim, then present the business result. Soft tip;

ok: true

can still carry the notice. (Also covered by

ae-analysis

Global Rules when both skills are loaded.)

这是

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

全局规则也会涵盖此内容。）

Routing Rules

路由规则

In this overlay, 查询集群 / 数据集群 / 部署集群 means physical multi-cluster routing for analysis queries. 用户分群 / 人群包 means user-membership assets under
```
analysis user-cluster
```
.
If the user asks for query-cluster inventory or cluster info, call
```
ae-cli analysis query-cluster list --project-id <project_id>
```
. Localized examples include "查询集群信息" and "有哪些数据集群".
Do not answer query-cluster inventory questions with
```
ae-cli analysis user-cluster list
```
unless the user explicitly asks for audience clusters, cohorts, segments, user membership, or cluster definitions.
If the user mentions country, region, server, shard, site, market, or deployment area semantics, call
```
analysis query-cluster list
```
before choosing query scope.

Match slave intent only against returned

slave_clusters[].cluster_id

cluster_name

, and

cluster_desc

Report-data, dashboard-report-data, and ad-hoc run/export expose
```
--cluster-query-scope GLOBAL|SLAVE
```
;
```
SLAVE
```
requires
```
--slave-cluster-id
```
.
Use
```
GLOBAL
```
only when the user clearly asks for all clusters/servers or cross-cluster aggregation and
```
permissions.can_query_global=true
```
.
If the user does not express global or slave-cluster intent, omit the flag. Report/ad-hoc then use current self; dashboard follows its saved configuration.
If a requested route is not allowed, explain
```
permissions.allowed_cluster_query_params
```
instead of silently falling back.
SQL and attribution ad-hoc analysis do not support
```
GLOBAL
```
; SQL report/dashboard data also reject effective
```
GLOBAL
```
. Use an allowed
```
SLAVE
```
or current-self route.

在本覆盖层中，查询集群/数据集群/部署集群指的是分析查询的物理多集群路由。用户分群/人群包指的是
```
analysis user-cluster
```
下的用户会员资产。
如果用户请求查询集群清单或集群信息，调用
```
ae-cli analysis query-cluster list --project-id <project_id>
```
。本地化示例包括“查询集群信息”和“有哪些数据集群”。
除非用户明确要求受众集群、用户群组、用户分群、用户会员或集群定义，否则不要用
```
ae-cli analysis user-cluster list
```
来回答查询集群清单的问题。
如果用户提及国家、地区、服务器、分片、站点、市场或部署区域相关语义，在选择查询范围前先调用
```
analysis query-cluster list
```
。

仅将slave意图与返回的

slave_clusters[].cluster_id

、

cluster_name

和

cluster_desc

进行匹配。

报告数据、仪表板报告数据和临时运行/导出功能支持
```
--cluster-query-scope GLOBAL|SLAVE
```
；使用
```
SLAVE
```
时需要
```
--slave-cluster-id
```
参数。
仅当用户明确要求所有集群/服务器或跨集群聚合，且
```
permissions.can_query_global=true
```
时，才使用
```
GLOBAL
```
。
如果用户未表达全局或slave集群的意图，省略该标志。此时报告/临时查询将使用当前自身集群；仪表板则遵循其保存的配置。
如果请求的路由不被允许，请解释
```
permissions.allowed_cluster_query_params
```
，而非静默回退。
SQL和归因临时分析不支持
```
GLOBAL
```
；SQL报告/仪表板数据同样会拒绝有效的
```
GLOBAL
```
。请使用允许的
```
SLAVE
```
或当前自身路由。

Response Wording

回复措辞

For

analysis query-cluster list

, call the result "查询集群" or "query clusters" and summarize

current_cluster

slave_clusters

, and

permissions.allowed_cluster_query_params

For
```
analysis user-cluster list
```
, call the result "audience clusters" or "user segments"; do not call those results query clusters.

对于

analysis query-cluster list

，将结果称为“查询集群”或“query clusters”，并总结

current_cluster

、

slave_clusters

和

permissions.allowed_cluster_query_params

的内容。

对于
```
analysis user-cluster list
```
，将结果称为“audience clusters”或“用户分群”；请勿将这些结果称为查询集群。

Query-cluster command

查询集群命令

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

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