az managedcleanroom frontend analytics query
備註
此參考文獻是Azure CLImanagedcleanroom擴充功能的一部分(版本為2.75.0或更高版本)。 這個擴充功能會在你第一次執行 az managedcleanroom 前端分析查詢 指令時自動安裝。 深入了解擴充功能。
管理協作查詢。
命令
| 名稱 | Description | 類型 | 狀態 |
|---|---|---|---|
| az managedcleanroom frontend analytics query cancel-run |
取消查詢跑。 |
Extension | GA |
| az managedcleanroom frontend analytics query list |
列出合作的查詢清單。 |
Extension | GA |
| az managedcleanroom frontend analytics query publish |
向合作團隊發表查詢。 |
Extension | GA |
| az managedcleanroom frontend analytics query run |
在協作中執行查詢。 |
Extension | GA |
| az managedcleanroom frontend analytics query runhistory |
查看查詢執行歷史。 |
Extension | GA |
| az managedcleanroom frontend analytics query runhistory list |
清單查詢執行紀錄。 |
Extension | GA |
| az managedcleanroom frontend analytics query runresult |
查看查詢執行結果。 |
Extension | GA |
| az managedcleanroom frontend analytics query runresult show |
顯示查詢執行結果的詳細資訊。 |
Extension | GA |
| az managedcleanroom frontend analytics query show |
顯示查詢詳情。 |
Extension | GA |
| az managedcleanroom frontend analytics query vote |
對查詢投票(接受或拒絕)。 |
Extension | GA |
az managedcleanroom frontend analytics query cancel-run
取消查詢跑。
az managedcleanroom frontend analytics query cancel-run --collaboration-id
--document-id
--run-id
[--acquire-policy-token]
[--api-version {2026-03-01-preview}]
[--change-reference]
範例
取消查詢執行
az managedcleanroom frontend analytics query cancel-run -c <cid> --document-id <document-id> --run-id <run-id>
必要參數
協作識別碼。
文件識別碼(資料集、查詢或同意文件)。
查詢執行識別碼。
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
自動取得 Azure 原則 令牌以進行此資源操作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
API 版本用於此請求。 預設值:2026-03-01-preview。
| 屬性 | 值 |
|---|---|
| 預設值: | 2026-03-01-preview |
| 接受的值: | 2026-03-01-preview |
相關變更的 ID 是為此資源操作所參考的。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
az managedcleanroom frontend analytics query list
列出合作的查詢清單。
az managedcleanroom frontend analytics query list --collaboration-id
[--api-version {2026-03-01-preview}]
範例
清單查詢
az managedcleanroom frontend analytics query list -c <collaboration-id>
必要參數
協作識別碼。
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
API 版本用於此請求。 預設值:2026-03-01-preview。
| 屬性 | 值 |
|---|---|
| 預設值: | 2026-03-01-preview |
| 接受的值: | 2026-03-01-preview |
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
az managedcleanroom frontend analytics query publish
向合作團隊發表查詢。
發布包含 SQL 區段、執行序列及資料集映射的查詢設定。 查詢區段可以作為 @file.json (完整區段物件,包含 executionSequence)或內嵌 SQL 字串(需要 --execution-sequence 參數)提供。 執行序列定義了哪些區段是平行執行(相同編號)還是順序(不同編號)。 無法在同一指令中混合 @file.json 和內嵌 SQL 區段。
az managedcleanroom frontend analytics query publish --collaboration-id
--document-id
[--acquire-policy-token]
[--api-version {2026-03-01-preview}]
[--body]
[--change-reference]
[--execution-sequence]
[--input-datasets]
[--output-dataset]
[--query-segment]
範例
從 JSON 檔案(包含 executionSequence)發佈包含 segments 的查詢
az managedcleanroom frontend analytics query publish \
--collaboration-id my-collab-123 \
--document-id my-query \
--query-segment @segment1.json \
--query-segment @segment2.json \
--query-segment @segment3.json \
--input-datasets "dataset1:view1,dataset2:view2" \
--output-dataset "output-dataset:results"
Note: Each segment JSON file should contain:
data, executionSequence, preConditions, postFilters fields
發佈帶有內嵌 SQL 段的查詢(需要 --execution-sequence)
az managedcleanroom frontend analytics query publish \
--collaboration-id my-collab-123 \
--document-id my-query \
--query-segment "SELECT * FROM table1" \
--query-segment "SELECT * FROM table2" \
--execution-sequence "1,2" \
--input-datasets "dataset1:view1" \
--output-dataset "output-dataset:results"
使用 JSON 主體檔案發佈查詢(舊有模式)
az managedcleanroom frontend analytics query publish --collaboration-id my-collab-123 --document-id my-query --body @query-config.json
必要參數
協作識別碼。
查詢文件識別碼。
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
自動取得 Azure 原則 令牌以進行此資源操作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
API 版本用於此請求。 預設值:2026-03-01-preview。
| 屬性 | 值 |
|---|---|
| 預設值: | 2026-03-01-preview |
| 接受的值: | 2026-03-01-preview |
JSON 設定檔路徑(@file.json)或 JSON 字串(舊有模式)。
相關變更的 ID 是為此資源操作所參考的。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
逗號分隔的執行序列號(例如「1,1,2」)。 必須匹配分段數量。
逗號分隔的輸入資料集,為 datasetId:viewName 對。
輸出資料集為 datasetId:viewName。
查詢區段 SQL(@file.sql 或內嵌)。 可重複。 秩序很重要。
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
az managedcleanroom frontend analytics query run
在協作中執行查詢。
執行已發佈的查詢,並附帶可選的設定參數。 若未提供,則會自動產生 run ID。
az managedcleanroom frontend analytics query run --collaboration-id
--document-id
[--acquire-policy-token]
[--api-version {2026-03-01-preview}]
[--body]
[--change-reference]
[--dry-run]
[--end-date]
[--scale-sku {large, medium, small}]
[--start-date]
[--use-optimizer]
範例
用預設設定執行查詢
az managedcleanroom frontend analytics query run --collaboration-id my-collab-123 --document-id my-query
執行一個包含試演和日期範圍的查詢
az managedcleanroom frontend analytics query run --collaboration-id my-collab-123 --document-id my-query --dry-run --start-date "2024-01-01" --end-date "2024-12-31"
啟用優化器時執行查詢
az managedcleanroom frontend analytics query run --collaboration-id my-collab-123 --document-id my-query --use-optimizer
在較大的運算量上執行查詢
az managedcleanroom frontend analytics query run --collaboration-id my-collab-123 --document-id my-query --scale-sku medium
使用 JSON 主體檔案執行查詢(舊有模式)
az managedcleanroom frontend analytics query run --collaboration-id my-collab-123 --document-id my-query --body @run-config.json
必要參數
協作識別碼。
查詢文件識別碼。
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
自動取得 Azure 原則 令牌以進行此資源操作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
API 版本用於此請求。 預設值:2026-03-01-preview。
| 屬性 | 值 |
|---|---|
| 預設值: | 2026-03-01-preview |
| 接受的值: | 2026-03-01-preview |
JSON 設定檔路徑(@file.json)或 JSON 字串(舊有模式)。
可選欄位:runId(若未提供則自動產生)、dryRun、startDate、endDate、useOptimizer、scaleSku(小型、中型或大型)。
相關變更的 ID 是為此資源操作所參考的。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
在不執行查詢的情況下進行試演。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
查詢執行的結束日期。
執行的運算大小(小、中、大)。
若省略,則使用服務預設值(小型)。
| 屬性 | 值 |
|---|---|
| 接受的值: | large, medium, small |
查詢執行的開始日期。
使用查詢優化器。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
az managedcleanroom frontend analytics query show
顯示查詢詳情。
az managedcleanroom frontend analytics query show --collaboration-id
--document-id
[--api-version {2026-03-01-preview}]
範例
顯示查詢細節
az managedcleanroom frontend analytics query show -c <cid> -d <document-id>
必要參數
協作識別碼。
文件識別碼(資料集、查詢或同意文件)。
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
API 版本用於此請求。 預設值:2026-03-01-preview。
| 屬性 | 值 |
|---|---|
| 預設值: | 2026-03-01-preview |
| 接受的值: | 2026-03-01-preview |
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
az managedcleanroom frontend analytics query vote
對查詢投票(接受或拒絕)。
在合作中提交查詢投票。 這個統一端點讓你只需一個指令就能接受或拒絕查詢。
此指令取代了版本 1.0.0b4 中已棄用的「vote accept」與「vote reject」指令。
az managedcleanroom frontend analytics query vote --collaboration-id
--document-id
--vote-action
[--acquire-policy-token]
[--api-version {2026-03-01-preview}]
[--change-reference]
[--proposal-id]
範例
接受查詢投票
az managedcleanroom frontend analytics query vote --collaboration-id <cid> --document-id <document-id> --vote-action accept
拒絕查詢投票
az managedcleanroom frontend analytics query vote --collaboration-id <cid> --document-id <document-id> --vote-action reject
接受查詢投票(簡短表)
az managedcleanroom frontend analytics query vote -c <cid> -d <doc-id> --vote-action accept
必要參數
協作識別碼。
文件識別碼(資料集、查詢或同意文件)。
投票行動(接受或拒絕)。
投票行動要執行:
- 接受:批准查詢
- 拒絕:拒絕查詢。
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
自動取得 Azure 原則 令牌以進行此資源操作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
API 版本用於此請求。 預設值:2026-03-01-preview。
| 屬性 | 值 |
|---|---|
| 預設值: | 2026-03-01-preview |
| 接受的值: | 2026-03-01-preview |
相關變更的 ID 是為此資源操作所參考的。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
可選的提案識別碼。
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
| 屬性 | 值 |
|---|---|
| 預設值: | False |