az stream-analytics function

Note

Den här referensen är en del av tillägget stream-analytics för Azure CLI (version 2.75.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az stream-analytics-funktion kommando. Läs mer om tillägg.

Hantera funktion med stream analytics.

Kommandon

Name Description Typ Status
az stream-analytics function create

Skapa en funktion eller ersätt en redan befintlig funktion under ett befintligt direktuppspelningsjobb.

Extension GA
az stream-analytics function delete

Ta bort en funktion från strömningsjobbet.

Extension GA
az stream-analytics function inspect

Hämta standarddefinitionen för en funktion baserat på de angivna parametrarna.

Extension GA
az stream-analytics function list

Visa en lista över alla funktioner under det angivna direktuppspelningsjobbet.

Extension GA
az stream-analytics function show

Hämta information om den angivna funktionen.

Extension GA
az stream-analytics function test

Testa om informationen som tillhandahålls för en funktion är giltig. Det kan vara allt från att testa anslutningen till den underliggande webbtjänsten bakom funktionen eller att se till att den angivna funktionskoden är syntaktiskt korrekt.

Extension GA
az stream-analytics function update

Uppdatera en befintlig funktion under ett befintligt direktuppspelningsjobb. Detta kan användas för att delvis uppdatera (dvs. uppdatera en eller två egenskaper) en funktion utan att påverka resten av jobbet eller funktionsdefinitionen.

Extension GA
az stream-analytics function wait

Placera CLI i vänteläge tills ett villkor för stream-analytics-funktionen har uppfyllts.

Extension GA

az stream-analytics function create

Skapa en funktion eller ersätt en redan befintlig funktion under ett befintligt direktuppspelningsjobb.

az stream-analytics function create --function-name --name
                                    --job-name
                                    --resource-group
                                    [--acquire-policy-token]
                                    [--change-reference]
                                    [--if-match]
                                    [--if-none-match]
                                    [--properties]

Exempel

Skapa en JavaScript-funktion

az stream-analytics function create --properties "{\"type\":\"Scalar\",\"properties\":{\"binding\":{\"type\":\"Microsoft.StreamAnalytics/JavascriptUdf\",\"properties\":{\"script\":\"function (x, y) { return x + y; }\"}},\"inputs\":[{\"dataType\":\"Any\"}],\"output\":{\"dataType\":\"Any\"}}}" --function-name "function8197" --job-name "sj8653" --resource-group "sjrg1637"

Skapa en Azure ML-funktion

az stream-analytics function create --properties "{\"type\":\"Scalar\",\"properties\":{\"binding\":{\"type\":\"Microsoft.MachineLearning/WebService\",\"properties\":{\"apiKey\":\"someApiKey==\",\"batchSize\":1000,\"endpoint\":\"someAzureMLEndpointURL\",\"inputs\":{\"name\":\"input1\",\"columnNames\":[{\"name\":\"tweet\",\"dataType\":\"string\",\"mapTo\":0}]},\"outputs\":[{\"name\":\"Sentiment\",\"dataType\":\"string\"}]}},\"inputs\":[{\"dataType\":\"nvarchar(max)\"}],\"output\":{\"dataType\":\"nvarchar(max)\"}}}" --function-name "function588" --job-name "sj9093" --resource-group "sjrg7"

Obligatoriska parametrar

--function-name --name -n

Namnet på funktionen.

--job-name

Namnet på strömningsjobbet.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--if-match

ETag för funktionen. Utelämna det här värdet för att alltid skriva över den aktuella funktionen. Ange det senast synliga ETag-värdet för att förhindra att samtidiga ändringar skrivs över av misstag.

--if-none-match

Ställ in på *för att tillåta att en ny funktion skapas, men för att förhindra uppdatering av en befintlig funktion. Andra värden resulterar i ett 412-förvillkor misslyckades svar.

--properties

De egenskaper som är associerade med en funktion. Förväntat värde: json-string/json-file/@json-file.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az stream-analytics function delete

Ta bort en funktion från strömningsjobbet.

az stream-analytics function delete --function-name --name
                                    --job-name
                                    --resource-group
                                    [--acquire-policy-token]
                                    [--change-reference]
                                    [--yes]

Exempel

Ta bort en funktion

az stream-analytics function delete --name "function8197" --job-name "sj8653" --resource-group "sjrg1637"

Obligatoriska parametrar

--function-name --name -n

Namnet på funktionen.

--job-name

Namnet på strömningsjobbet.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--yes -y

Fråga inte efter bekräftelse.

Egenskap Värde
Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az stream-analytics function inspect

Hämta standarddefinitionen för en funktion baserat på de angivna parametrarna.

az stream-analytics function inspect --function-name --name
                                     --job-name
                                     --resource-group
                                     [--acquire-policy-token]
                                     [--change-reference]
                                     [--ml-properties]

Obligatoriska parametrar

--function-name --name -n

Namnet på funktionen.

--job-name

Namnet på strömningsjobbet.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--ml-properties

De parametrar som behövs för att hämta standardfunktionsdefinitionen för en Azure Machine Learning webbtjänstfunktion.

Användning: --ml-properties execute-endpoint=XX

execute-endpoint: Request-Response köra slutpunkten för Azure Machine Learning webbtjänsten. Läs mer här: https://docs.microsoft.com/en-us/azure/stream-analytics/machine-learning-udf.

Egenskap Värde
Parametergrupp: FunctionRetrieveDefaultDefinitionParameters Arguments
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az stream-analytics function list

Visa en lista över alla funktioner under det angivna direktuppspelningsjobbet.

az stream-analytics function list --job-name
                                  --resource-group
                                  [--select]

Exempel

Visa en lista över alla funktioner i ett direktuppspelningsjobb

az stream-analytics function list --job-name "sj8653" --resource-group "sjrg1637"

Obligatoriska parametrar

--job-name

Namnet på strömningsjobbet.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--select

Frågeparametern $select OData. Det här är en kommaavgränsad lista över strukturella egenskaper som ska inkluderas i svaret, eller "" för att inkludera alla egenskaper. Som standard returneras alla egenskaper utom diagnostik. För närvarande accepteras endast "" som ett giltigt värde.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az stream-analytics function show

Hämta information om den angivna funktionen.

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

Exempel

Hämta en JavaScript-funktion

az stream-analytics function show --name "function8197" --job-name "sj8653" --resource-group "sjrg1637"

Hämta en Azure ML-funktion

az stream-analytics function show --name "function588" --job-name "sj9093" --resource-group "sjrg7"

Obligatoriska parametrar

--function-name --name -n

Namnet på funktionen.

--job-name

Namnet på strömningsjobbet.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az stream-analytics function test

Testa om informationen som tillhandahålls för en funktion är giltig. Det kan vara allt från att testa anslutningen till den underliggande webbtjänsten bakom funktionen eller att se till att den angivna funktionskoden är syntaktiskt korrekt.

az stream-analytics function test --function-name --name
                                  --job-name
                                  --resource-group
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--no-wait]
                                  [--properties]

Exempel

Testa anslutningen för en JavaScript-funktion

az stream-analytics function test --function-name "function8197" --job-name "sj8653" --resource-group "sjrg1637"

Testa anslutningen för en Azure ML-funktion

az stream-analytics function test --function-name "function588" --job-name "sj9093" --resource-group "sjrg7"

Obligatoriska parametrar

--function-name --name -n

Namnet på funktionen.

--job-name

Namnet på strömningsjobbet.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Egenskap Värde
Standardvärde: False
--properties

De egenskaper som är associerade med en funktion. Förväntat värde: json-string/json-file/@json-file.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az stream-analytics function update

Uppdatera en befintlig funktion under ett befintligt direktuppspelningsjobb. Detta kan användas för att delvis uppdatera (dvs. uppdatera en eller två egenskaper) en funktion utan att påverka resten av jobbet eller funktionsdefinitionen.

az stream-analytics function update --function-name --name
                                    --job-name
                                    --resource-group
                                    [--acquire-policy-token]
                                    [--change-reference]
                                    [--if-match]
                                    [--properties]

Exempel

Uppdatera en JavaScript-funktion

az stream-analytics function update --properties "{\"type\":\"Scalar\",\"properties\":{\"binding\":{\"type\":\"Microsoft.StreamAnalytics/JavascriptUdf\",\"properties\":{\"script\":\"function (a, b) { return a * b; }\"}}}}" --function-name "function8197" --job-name "sj8653" --resource-group "sjrg1637"

Uppdatera en Azure ML-funktion

az stream-analytics function update --properties "{\"type\":\"Scalar\",\"properties\":{\"binding\":{\"type\":\"Microsoft.MachineLearning/WebService\",\"properties\":{\"batchSize\":5000}}}}" --function-name "function588" --job-name "sj9093" --resource-group "sjrg7"

Obligatoriska parametrar

--function-name --name -n

Namnet på funktionen.

--job-name

Namnet på strömningsjobbet.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--if-match

ETag för funktionen. Utelämna det här värdet för att alltid skriva över den aktuella funktionen. Ange det senast synliga ETag-värdet för att förhindra att samtidiga ändringar skrivs över av misstag.

--properties

De egenskaper som är associerade med en funktion. Förväntat värde: json-string/json-file/@json-file.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az stream-analytics function wait

Placera CLI i vänteläge tills ett villkor för stream-analytics-funktionen har uppfyllts.

az stream-analytics function wait --function-name --name
                                  --job-name
                                  --resource-group
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--created]
                                  [--custom]
                                  [--deleted]
                                  [--exists]
                                  [--interval]
                                  [--timeout]
                                  [--updated]

Exempel

Pausa körningen av nästa rad i CLI-skriptet tills stream-analytics-funktionen har skapats.

az stream-analytics function wait --name "function588" --job-name "sj9093" --resource-group "sjrg7" --created

Obligatoriska parametrar

--function-name --name -n

Namnet på funktionen.

--job-name

Namnet på strömningsjobbet.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

Egenskap Värde
Parametergrupp: Wait Condition Arguments
Standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Egenskap Värde
Parametergrupp: Wait Condition Arguments
--deleted

Vänta tills den har tagits bort.

Egenskap Värde
Parametergrupp: Wait Condition Arguments
Standardvärde: False
--exists

Vänta tills resursen finns.

Egenskap Värde
Parametergrupp: Wait Condition Arguments
Standardvärde: False
--interval

Avsökningsintervall i sekunder.

Egenskap Värde
Parametergrupp: Wait Condition Arguments
Standardvärde: 30
--timeout

Maximal väntetid i sekunder.

Egenskap Värde
Parametergrupp: Wait Condition Arguments
Standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

Egenskap Värde
Parametergrupp: Wait Condition Arguments
Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False