az stream-analytics transformation

Note

此參考是 Azure CLI （2.75.0 版或更新版本） 串流 分析 延伸模組的一部分。 擴充功能會在您第一次執行 az stream-analytics 轉換 命令時自動安裝。 深入了解擴充功能。

使用串流分析來管理轉換。

命令

名稱	Description	類型	狀態
az stream-analytics transformation create	建立轉換，或取代現有串流作業下已經存在的轉換。	Extension	GA
az stream-analytics transformation show	取得指定轉換的詳細數據。	Extension	GA
az stream-analytics transformation update	在現有的串流作業下更新現有的轉換。 這可以用來部分更新轉換（即更新一或兩個屬性）轉換，而不會影響其餘的工作或轉換定義。	Extension	GA

az stream-analytics transformation create

建立轉換，或取代現有串流作業下已經存在的轉換。

az stream-analytics transformation create --job-name
                                          --name --transformation-name
                                          --resource-group
                                          [--if-match]
                                          [--if-none-match]
                                          [--saql]
                                          [--streaming-units]
                                          [--valid-streaming-units]

範例

建立轉換

az stream-analytics transformation create --job-name "sj8374" --resource-group "sjrg4423" --saql "Select Id, Name from inputtest" --streaming-units 6 --transformation-name "transformation952"

必要參數

--job-name

串流作業的名稱。

--name --transformation-name -n

轉換的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

選擇性參數

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

--if-match

轉換的ETag。 請省略此值以一律覆寫目前的轉換。 指定最後看到的 ETag 值，以防止意外覆寫並行變更。

--if-none-match

設定為 『*』 以允許建立新的轉換，但為了避免更新現有的轉換。 其他值會導致 412 前置條件失敗的回應。

--saql

指定將在串流作業中執行的查詢。 您可以在這裡深入瞭解串流分析查詢語言（SAQL：https://msdn.microsoft.com/library/azure/dn834998。 PUT （CreateOrReplace） 要求的必要專案。

--streaming-units

指定串流作業所使用的串流單位數目。

--valid-streaming-units

指定串流作業可調整為的有效串流單位。

全域參數

--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 stream-analytics transformation show

取得指定轉換的詳細數據。

az stream-analytics transformation show --job-name
                                        --name --transformation-name
                                        --resource-group

範例

取得轉換

az stream-analytics transformation show --job-name "sj8374" --resource-group "sjrg4423" --name "transformation952"

必要參數

--job-name

串流作業的名稱。

--name --transformation-name -n

轉換的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

全域參數

--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 stream-analytics transformation update

在現有的串流作業下更新現有的轉換。 這可以用來部分更新轉換（即更新一或兩個屬性）轉換，而不會影響其餘的工作或轉換定義。

az stream-analytics transformation update --job-name
                                          --name --transformation-name
                                          --resource-group
                                          [--if-match]
                                          [--saql]
                                          [--streaming-units]
                                          [--valid-streaming-units]

範例

更新轉換

az stream-analytics transformation update --job-name "sj8374" --resource-group "sjrg4423" --saql "New query" --transformation-name "transformation952"

必要參數

--job-name

串流作業的名稱。

--name --transformation-name -n

轉換的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

選擇性參數

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

--if-match

轉換的ETag。 請省略此值以一律覆寫目前的轉換。 指定最後看到的 ETag 值，以防止意外覆寫並行變更。

--saql

指定將在串流作業中執行的查詢。 您可以在這裡深入瞭解串流分析查詢語言（SAQL：https://msdn.microsoft.com/library/azure/dn834998。 PUT （CreateOrReplace） 要求的必要專案。

--streaming-units

指定串流作業所使用的串流單位數目。

--valid-streaming-units

指定串流作業可調整為的有效串流單位。

全域參數

--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