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 の結果は「オーディエンスクラスター」または「ユーザーセグメント」と呼んでください。これらの結果をクエリクラスターと呼ばないでください。

クエリクラスターコマンド

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