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
De naam van de functie.
De naam van de streamingtaak.
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.
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.
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.
De eigenschappen die zijn gekoppeld aan een functie. Verwachte waarde: json-string/json-file/@json-file.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
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
De naam van de functie.
De naam van de streamingtaak.
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.
Niet vragen om bevestiging.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
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
De naam van de functie.
De naam van de streamingtaak.
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.
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
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
De naam van de streamingtaak.
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.
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
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
De naam van de functie.
De naam van de streamingtaak.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
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
De naam van de functie.
De naam van de streamingtaak.
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.
Wacht niet totdat de langdurige bewerking is voltooid.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
De eigenschappen die zijn gekoppeld aan een functie. Verwachte waarde: json-string/json-file/@json-file.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
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
De naam van de functie.
De naam van de streamingtaak.
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.
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.
De eigenschappen die zijn gekoppeld aan een functie. Verwachte waarde: json-string/json-file/@json-file.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
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
De naam van de functie.
De naam van de streamingtaak.
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.
Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
| Default value: | False |
Wacht tot de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
Wacht totdat deze is verwijderd.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
| Default value: | False |
Wacht tot de resource bestaat.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
| Default value: | False |
Polling-interval in seconden.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
| Default value: | 30 |
Maximale wachttijd in seconden.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
| Default value: | 3600 |
Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
| Default value: | False |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |