az stream-analytics function
Note
Den här referensen är en del av stream-analytics-tillägget 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
| Namn | Beskrivning | 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
[--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"
Nödvändiga parametrar
Namnet på funktionen.
Namnet på strömningsjobbet.
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 utföras framgångsrikt.
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.
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.
De egenskaper som är associerade med en funktion. Förväntat värde: json-string/json-file/@json-file.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Ö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
[--yes]
Exempel
Ta bort en funktion
az stream-analytics function delete --name "function8197" --job-name "sj8653" --resource-group "sjrg1637"
Nödvändiga parametrar
Namnet på funktionen.
Namnet på strömningsjobbet.
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 utföras framgångsrikt.
Fråga inte efter bekräftelse.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Ö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
[--ml-properties]
Nödvändiga parametrar
Namnet på funktionen.
Namnet på strömningsjobbet.
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 utföras framgångsrikt.
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
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Ö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"
Nödvändiga parametrar
Namnet på strömningsjobbet.
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 utföras framgångsrikt.
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
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Ö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"
Nödvändiga parametrar
Namnet på funktionen.
Namnet på strömningsjobbet.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Ö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
[--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"
Nödvändiga parametrar
Namnet på funktionen.
Namnet på strömningsjobbet.
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 utföras framgångsrikt.
Vänta inte tills den långvariga åtgärden har slutförts.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
De egenskaper som är associerade med en funktion. Förväntat värde: json-string/json-file/@json-file.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Ö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
[--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"
Nödvändiga parametrar
Namnet på funktionen.
Namnet på strömningsjobbet.
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 utföras framgångsrikt.
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.
De egenskaper som är associerade med en funktion. Förväntat värde: json-string/json-file/@json-file.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Ö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
[--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
Nödvändiga parametrar
Namnet på funktionen.
Namnet på strömningsjobbet.
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 utföras framgångsrikt.
Vänta tills du har skapat med "provisioningState" på "Lyckades".
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Wait Condition Arguments |
| Standardvärde: | False |
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 |
Vänta tills den har tagits bort.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Wait Condition Arguments |
| Standardvärde: | False |
Vänta tills resursen finns.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Wait Condition Arguments |
| Standardvärde: | False |
Avsökningsintervall i sekunder.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Wait Condition Arguments |
| Standardvärde: | 30 |
Maximal väntetid i sekunder.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Wait Condition Arguments |
| Standardvärde: | 3600 |
Vänta tills det har uppdaterats med provisioningState på Lyckades.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Wait Condition Arguments |
| Standardvärde: | False |
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |