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>

必要參數

--collaboration-id -c

協作識別碼。

--document-id -d

文件識別碼(資料集、查詢或同意文件)。

--run-id -r

查詢執行識別碼。

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--api-version

API 版本用於此請求。 預設值:2026-03-01-preview。

屬性 值
預設值: 2026-03-01-preview
接受的值: 2026-03-01-preview
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --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>

必要參數

--collaboration-id -c

協作識別碼。

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--api-version

API 版本用於此請求。 預設值:2026-03-01-preview。

屬性 值
預設值: 2026-03-01-preview
接受的值: 2026-03-01-preview
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --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

必要參數

--collaboration-id -c

協作識別碼。

--document-id -d

查詢文件識別碼。

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--api-version

API 版本用於此請求。 預設值:2026-03-01-preview。

屬性 值
預設值: 2026-03-01-preview
接受的值: 2026-03-01-preview
--body

JSON 設定檔路徑(@file.json)或 JSON 字串(舊有模式)。

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--execution-sequence

逗號分隔的執行序列號(例如「1,1,2」)。 必須匹配分段數量。

--input-datasets

逗號分隔的輸入資料集,為 datasetId:viewName 對。

--output-dataset

輸出資料集為 datasetId:viewName。

--query-segment

查詢區段 SQL(@file.sql 或內嵌)。 可重複。 秩序很重要。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --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

必要參數

--collaboration-id -c

協作識別碼。

--document-id -d

查詢文件識別碼。

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--api-version

API 版本用於此請求。 預設值:2026-03-01-preview。

屬性 值
預設值: 2026-03-01-preview
接受的值: 2026-03-01-preview
--body

JSON 設定檔路徑(@file.json)或 JSON 字串(舊有模式)。

可選欄位:runId(若未提供則自動產生)、dryRun、startDate、endDate、useOptimizer、scaleSku(小型、中型或大型)。

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--dry-run

在不執行查詢的情況下進行試演。

屬性 值
預設值: False
--end-date

查詢執行的結束日期。

--scale-sku

執行的運算大小(小、中、大)。

若省略,則使用服務預設值(小型)。

屬性 值
接受的值: large, medium, small
--start-date

查詢執行的開始日期。

--use-optimizer

使用查詢優化器。

屬性 值
預設值: False
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --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>

必要參數

--collaboration-id -c

協作識別碼。

--document-id -d

文件識別碼(資料集、查詢或同意文件)。

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--api-version

API 版本用於此請求。 預設值:2026-03-01-preview。

屬性 值
預設值: 2026-03-01-preview
接受的值: 2026-03-01-preview
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --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

必要參數

--collaboration-id -c

協作識別碼。

--document-id -d

文件識別碼(資料集、查詢或同意文件)。

--vote-action

投票行動(接受或拒絕)。

投票行動要執行:

  • 接受:批准查詢
  • 拒絕:拒絕查詢。

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--api-version

API 版本用於此請求。 預設值:2026-03-01-preview。

屬性 值
預設值: 2026-03-01-preview
接受的值: 2026-03-01-preview
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--proposal-id

可選的提案識別碼。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False