Feedback

az stream-analytics function

  • Referenz

Hinweis

Diese Referenz ist Teil der Streamanalyseerweiterung für die Azure CLI (Version 2.15.0 oder höher). Die Erweiterung installiert automatisch beim ersten Ausführen eines Az-Stream-Analytics-Funktionsbefehls . Weitere Informationen zu Erweiterungen

Verwalten der Funktion mit Streamanalyse

Befehle

az stream-analytics function create

Erstellen Sie eine Funktion oder ersetzt eine bereits vorhandene Funktion unter einem vorhandenen Streamingauftrag.
az stream-analytics function delete

Löschen einer Funktion aus dem Streamingauftrag.
az stream-analytics function inspect

Rufen Sie die Standarddefinition einer Funktion basierend auf den angegebenen Parametern ab.
az stream-analytics function list

Listet alle Funktionen unter dem angegebenen Streamingauftrag auf.
az stream-analytics function show

Rufen Sie Details zur angegebenen Funktion ab.
az stream-analytics function test

Testen Sie, ob die für eine Funktion bereitgestellten Informationen gültig sind. Dies kann von dem Testen der Verbindung mit dem zugrunde liegenden Webdienst hinter der Funktion reichen oder sicherstellen, dass der bereitgestellte Funktionscode syntaktisch korrekt ist.
az stream-analytics function update

Aktualisieren sie eine vorhandene Funktion unter einem vorhandenen Streamingauftrag. Dies kann zum teilweisen Aktualisieren (ie. Aktualisieren einer oder zwei Eigenschaften) einer Funktion verwendet werden, ohne den Rest der Auftrags- oder Funktionsdefinition zu beeinträchtigen.
az stream-analytics function wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Streamanalysefunktion erfüllt ist.

az stream-analytics function create

Erstellen Sie eine Funktion oder ersetzt eine bereits vorhandene Funktion unter einem vorhandenen Streamingauftrag.

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

Beispiele

Erstellen einer 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"

Erstellen einer 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"

Erforderliche Parameter

--function-name --name -n

Der Name der Funktion.

--job-name

Der Name des Streamingauftrags.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--if-match

Das ETag der Funktion. Lassen Sie diesen Wert aus, um die aktuelle Funktion immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um versehentlich das Überschreiben gleichzeitiger Änderungen zu verhindern.

--if-none-match

Legen Sie auf '*' fest, damit eine neue Funktion erstellt werden kann, aber um zu verhindern, dass eine vorhandene Funktion aktualisiert wird. Andere Werte führen zu einer 412 Vorbedingung fehlgeschlagenen Antwort.

--properties

Die Eigenschaften, die einer Funktion zugeordnet sind. Erwarteter Wert: json-string/json-file/@json-file.

az stream-analytics function delete

Löschen einer Funktion aus dem Streamingauftrag.

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

Beispiele

Löschen einer Funktion

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

Erforderliche Parameter

--function-name --name -n

Der Name der Funktion.

--job-name

Der Name des Streamingauftrags.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--yes -y

Nicht zur Bestätigung auffordern

az stream-analytics function inspect

Rufen Sie die Standarddefinition einer Funktion basierend auf den angegebenen Parametern ab.

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

Erforderliche Parameter

--function-name --name -n

Der Name der Funktion.

--job-name

Der Name des Streamingauftrags.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--ml-properties

Die Parameter, die zum Abrufen der Standardfunktionsdefinition für eine Azure Machine Learning-Webdienstfunktion erforderlich sind.

az stream-analytics function list

Listet alle Funktionen unter dem angegebenen Streamingauftrag auf.

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

Beispiele

Auflisten aller Funktionen in einem Streamingauftrag

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

Erforderliche Parameter

--job-name

Der Name des Streamingauftrags.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--select

Der $select OData-Abfrageparameter. Dies ist eine durch Trennzeichen getrennte Liste der strukturellen Eigenschaften, die in die Antwort einbezogen werden sollen, oder "*", um alle Eigenschaften einzuschließen. Standardmäßig werden alle Eigenschaften mit Ausnahme der Diagnose zurückgegeben. Derzeit akzeptiert '*' nur als gültiger Wert.

az stream-analytics function show

Rufen Sie Details zur angegebenen Funktion ab.

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

Beispiele

Abrufen einer JavaScript-Funktion

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

Abrufen einer Azure ML-Funktion

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

Erforderliche Parameter

--function-name --name -n

Der Name der Funktion.

--job-name

Der Name des Streamingauftrags.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az stream-analytics function test

Testen Sie, ob die für eine Funktion bereitgestellten Informationen gültig sind. Dies kann von dem Testen der Verbindung mit dem zugrunde liegenden Webdienst hinter der Funktion reichen oder sicherstellen, dass der bereitgestellte Funktionscode syntaktisch korrekt ist.

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

Beispiele

Testen der Verbindung für eine JavaScript-Funktion

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

Testen der Verbindung für eine Azure ML-Funktion

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

Erforderliche Parameter

--function-name --name -n

Der Name der Funktion.

--job-name

Der Name des Streamingauftrags.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--properties

Die Eigenschaften, die einer Funktion zugeordnet sind. Erwarteter Wert: json-string/json-file/@json-file.

az stream-analytics function update

Aktualisieren sie eine vorhandene Funktion unter einem vorhandenen Streamingauftrag. Dies kann zum teilweisen Aktualisieren (ie. Aktualisieren einer oder zwei Eigenschaften) einer Funktion verwendet werden, ohne den Rest der Auftrags- oder Funktionsdefinition zu beeinträchtigen.

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

Beispiele

Aktualisieren einer 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"

Aktualisieren einer 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"

Erforderliche Parameter

--function-name --name -n

Der Name der Funktion.

--job-name

Der Name des Streamingauftrags.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--if-match

Das ETag der Funktion. Lassen Sie diesen Wert aus, um die aktuelle Funktion immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um versehentlich das Überschreiben gleichzeitiger Änderungen zu verhindern.

--properties

Die Eigenschaften, die einer Funktion zugeordnet sind. Erwarteter Wert: json-string/json-file/@json-file.

az stream-analytics function wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Streamanalysefunktion erfüllt ist.

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

Beispiele

Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis die Stream-Analysefunktion erfolgreich erstellt wird.

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

Erforderliche Parameter

--function-name --name -n

Der Name der Funktion.

--job-name

Der Name des Streamingauftrags.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--created

Warten Sie, bis Sie mit "provisioningState" unter "Erfolgreich" erstellt wurden.

--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

--exists

Warten Sie, bis die Ressource vorhanden ist.

--interval

Abfrageintervall in Sekunden.

Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis die Aktualisierung mit provisioningState unter "Erfolgreich" ausgeführt wurde.