Delen via


az stream-analytics function

Note

Deze verwijzing maakt deel uit van de stream-analytics-extensie voor de Azure CLI (versie 2.75.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az stream-analytics function opdracht uitvoert. Meer informatie over uitbreidingen.

Beheer de functie met Stream Analytics.

Opdracht

Name Description Type Status
az stream-analytics function create

Maak een functie of vervang een al bestaande functie onder een bestaande streamingtaak.

Extension GA
az stream-analytics function delete

Een functie verwijderen uit de streamingtaak.

Extension GA
az stream-analytics function inspect

Haal de standaarddefinitie van een functie op op basis van de opgegeven parameters.

Extension GA
az stream-analytics function list

Vermeld alle functies onder de opgegeven streamingtaak.

Extension GA
az stream-analytics function show

Details over de opgegeven functie ophalen.

Extension GA
az stream-analytics function test

Test of de opgegeven informatie voor een functie geldig is. Dit kan variƫren van het testen van de verbinding met de onderliggende webservice achter de functie of het controleren of de opgegeven functiecode syntactisch juist is.

Extension GA
az stream-analytics function update

Een bestaande functie bijwerken onder een bestaande streamingtaak. Dit kan worden gebruikt om een functie gedeeltelijk bij te werken (bijvoorbeeld om een of twee eigenschappen bij te werken) zonder dat dit van invloed is op de rest van de taak of functiedefinitie.

Extension GA
az stream-analytics function wait

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van de stream-analytics-functie wordt voldaan.

Extension GA

az stream-analytics function create

Maak een functie of vervang een al bestaande functie onder een bestaande streamingtaak.

az stream-analytics function create --function-name --name
                                    --job-name
                                    --resource-group
                                    [--if-match]
                                    [--if-none-match]
                                    [--properties]

Voorbeelden

Een JavaScript-functie maken

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"

Een Azure ML-functie maken

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"

Vereiste parameters

--function-name --name -n

De naam van de functie.

--job-name

De naam van de streamingtaak.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--if-match

De ETag van de functie. Laat deze waarde weg om altijd de huidige functie te overschrijven. Geef de laatst geziene ETag-waarde op om te voorkomen dat gelijktijdige wijzigingen per ongeluk worden overschreven.

--if-none-match

Stel in op *, zodat een nieuwe functie kan worden gemaakt, maar om te voorkomen dat een bestaande functie wordt bijgewerkt. Andere waarden resulteren in een reactie van 412 Pre-condition Failed.

--properties

De eigenschappen die zijn gekoppeld aan een functie. Verwachte waarde: json-string/json-file/@json-file.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az stream-analytics function delete

Een functie verwijderen uit de streamingtaak.

az stream-analytics function delete --function-name --name
                                    --job-name
                                    --resource-group
                                    [--yes]

Voorbeelden

Een functie verwijderen

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

Vereiste parameters

--function-name --name -n

De naam van de functie.

--job-name

De naam van de streamingtaak.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--yes -y

Niet vragen om bevestiging.

Eigenschap Waarde
Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az stream-analytics function inspect

Haal de standaarddefinitie van een functie op op basis van de opgegeven parameters.

az stream-analytics function inspect --function-name --name
                                     --job-name
                                     --resource-group
                                     [--ml-properties]

Vereiste parameters

--function-name --name -n

De naam van de functie.

--job-name

De naam van de streamingtaak.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--ml-properties

De parameters die nodig zijn om de standaardfunctiedefinitie voor een Azure Machine Learning-webservicefunctie op te halen.

Gebruik: --ml-properties execute-endpoint=XX

execute-endpoint: het Request-Response eindpunt van de Azure Machine Learning-webservice uitvoeren. Meer informatie hier: https://docs.microsoft.com/en-us/azure/stream-analytics/machine-learning-udf.

Eigenschap Waarde
Parametergroep: FunctionRetrieveDefaultDefinitionParameters Arguments
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az stream-analytics function list

Vermeld alle functies onder de opgegeven streamingtaak.

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

Voorbeelden

Alle functies in een streamingtaak weergeven

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

Vereiste parameters

--job-name

De naam van de streamingtaak.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--select

De $select OData-queryparameter. Dit is een door komma's gescheiden lijst met structurele eigenschappen die moeten worden opgenomen in het antwoord of '' om alle eigenschappen op te nemen. Standaard worden alle eigenschappen geretourneerd, behalve diagnostische gegevens. Op dit moment accepteert u alleen '' als een geldige waarde.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az stream-analytics function show

Details over de opgegeven functie ophalen.

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

Voorbeelden

Een JavaScript-functie ophalen

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

Een Azure ML-functie ophalen

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

Vereiste parameters

--function-name --name -n

De naam van de functie.

--job-name

De naam van de streamingtaak.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az stream-analytics function test

Test of de opgegeven informatie voor een functie geldig is. Dit kan variƫren van het testen van de verbinding met de onderliggende webservice achter de functie of het controleren of de opgegeven functiecode syntactisch juist is.

az stream-analytics function test --function-name --name
                                  --job-name
                                  --resource-group
                                  [--no-wait]
                                  [--properties]

Voorbeelden

De verbinding testen voor een JavaScript-functie

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

De verbinding testen voor een Azure ML-functie

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

Vereiste parameters

--function-name --name -n

De naam van de functie.

--job-name

De naam van de streamingtaak.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap Waarde
Default value: False
--properties

De eigenschappen die zijn gekoppeld aan een functie. Verwachte waarde: json-string/json-file/@json-file.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az stream-analytics function update

Een bestaande functie bijwerken onder een bestaande streamingtaak. Dit kan worden gebruikt om een functie gedeeltelijk bij te werken (bijvoorbeeld om een of twee eigenschappen bij te werken) zonder dat dit van invloed is op de rest van de taak of functiedefinitie.

az stream-analytics function update --function-name --name
                                    --job-name
                                    --resource-group
                                    [--if-match]
                                    [--properties]

Voorbeelden

Een JavaScript-functie bijwerken

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"

Een Azure ML-functie bijwerken

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"

Vereiste parameters

--function-name --name -n

De naam van de functie.

--job-name

De naam van de streamingtaak.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--if-match

De ETag van de functie. Laat deze waarde weg om altijd de huidige functie te overschrijven. Geef de laatst geziene ETag-waarde op om te voorkomen dat gelijktijdige wijzigingen per ongeluk worden overschreven.

--properties

De eigenschappen die zijn gekoppeld aan een functie. Verwachte waarde: json-string/json-file/@json-file.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az stream-analytics function wait

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van de stream-analytics-functie wordt voldaan.

az stream-analytics function wait --function-name --name
                                  --job-name
                                  --resource-group
                                  [--created]
                                  [--custom]
                                  [--deleted]
                                  [--exists]
                                  [--interval]
                                  [--timeout]
                                  [--updated]

Voorbeelden

Pauzeer het uitvoeren van de volgende regel van het CLI-script totdat de stream-analytics-functie is gemaakt.

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

Vereiste parameters

--function-name --name -n

De naam van de functie.

--job-name

De naam van de streamingtaak.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--created

Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.

Eigenschap Waarde
Parametergroep: Wait Condition Arguments
Default value: False
--custom

Wacht tot de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Eigenschap Waarde
Parametergroep: Wait Condition Arguments
--deleted

Wacht totdat deze is verwijderd.

Eigenschap Waarde
Parametergroep: Wait Condition Arguments
Default value: False
--exists

Wacht tot de resource bestaat.

Eigenschap Waarde
Parametergroep: Wait Condition Arguments
Default value: False
--interval

Polling-interval in seconden.

Eigenschap Waarde
Parametergroep: Wait Condition Arguments
Default value: 30
--timeout

Maximale wachttijd in seconden.

Eigenschap Waarde
Parametergroep: Wait Condition Arguments
Default value: 3600
--updated

Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.

Eigenschap Waarde
Parametergroep: Wait Condition Arguments
Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False