az stream-analytics transformation

注意

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

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

命令

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

az stream-analytics transformation create

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

az stream-analytics transformation create --job-name
                                          --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

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stream-analytics transformation show

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

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

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stream-analytics transformation update

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

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

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。