Freigeben über

az stream-analytics function

  • Referenz

Hinweis

Diese Referenz ist Teil der Streamanalyse- Erweiterung für die Azure CLI (Version 2.15.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie eine az stream-analytics-Funktion Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Verwalten Sie die Funktion mit Datenstromanalysen.

Befehle

Name Beschreibung Typ Status
az stream-analytics function create

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

 Erweiterung GA
az stream-analytics function delete

Löschen sie eine Funktion aus dem Streamingauftrag.

 Erweiterung GA
az stream-analytics function inspect

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

 Erweiterung GA
az stream-analytics function list

Listet alle Funktionen unter dem angegebenen Streamingauftrag auf.

 Erweiterung GA
az stream-analytics function show

Rufen Sie Details zur angegebenen Funktion ab.

 Erweiterung GA
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 oder sicherstellen, dass der bereitgestellte Funktionscode syntaktisch korrekt ist.

 Erweiterung GA
az stream-analytics function update

Aktualisieren Einer vorhandenen Funktion unter einem vorhandenen Streamingauftrag. Dies kann verwendet werden, um eine Funktion teilweise zu aktualisieren (dh eine oder zwei Eigenschaften aktualisieren), ohne dass sich dies auf den Rest der Auftrags- oder Funktionsdefinition auswirkt.

 Erweiterung GA
az stream-analytics function wait

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

 Erweiterung GA

az stream-analytics function create

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

az stream-analytics function create --function-name --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 zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.

--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 Fehlerantwort von 412 Vorbedingung.

--properties

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az stream-analytics function delete

Löschen sie eine Funktion aus dem Streamingauftrag.

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

Beispiele

Eine Funktion löschen

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

Zur Bestätigung nicht auffordern.

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az stream-analytics function inspect

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

az stream-analytics function inspect --function-name --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.

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

execute-endpoint: The Request-Response execute endpoint of the Azure Machine Learning web service. Weitere Informationen finden Sie hier: https://docs.microsoft.com/en-us/azure/stream-analytics/machine-learning-udf.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

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 von strukturellen Eigenschaften, die in die Antwort eingeschlossen werden sollen, oder "", um alle Eigenschaften einzuschließen. Standardmäßig werden alle Eigenschaften mit Ausnahme der Diagnose zurückgegeben. Akzeptiert derzeit nur "" als gültigen Wert.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az stream-analytics function show

Rufen Sie Details zur angegebenen Funktion ab.

az stream-analytics function show --function-name --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.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

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 oder sicherstellen, dass der bereitgestellte Funktionscode syntaktisch korrekt ist.

az stream-analytics function test --function-name --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

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Standardwert: False
--properties

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az stream-analytics function update

Aktualisieren Einer vorhandenen Funktion unter einem vorhandenen Streamingauftrag. Dies kann verwendet werden, um eine Funktion teilweise zu aktualisieren (dh eine oder zwei Eigenschaften aktualisieren), ohne dass sich dies auf den Rest der Auftrags- oder Funktionsdefinition auswirkt.

az stream-analytics function update --function-name --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 zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.

--properties

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

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 --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 Streamanalysefunktion erfolgreich erstellt wurde.

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 'Succeeded' erstellt wurde.

Standardwert: False
--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.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--interval

Abrufintervall in Sekunden.

Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.