Freigeben über

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 wird automatisch installiert, wenn Sie einen Az Stream-Analytics-Funktionsbefehl zum ersten Mal ausführen. Weitere Informationen zu 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 Allgemein verfügbar
az stream-analytics function delete

Löschen sie eine Funktion aus dem Streamingauftrag.

 Erweiterung Allgemein verfügbar
az stream-analytics function inspect

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

 Erweiterung Allgemein verfügbar
az stream-analytics function list

Listet alle Funktionen unter dem angegebenen Streamingauftrag auf.

 Erweiterung Allgemein verfügbar
az stream-analytics function show

Rufen Sie Details zur angegebenen Funktion ab.

 Erweiterung Allgemein verfügbar
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 Allgemein verfügbar
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 Allgemein verfügbar
az stream-analytics function wait

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

 Erweiterung Allgemein verfügbar

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
                                    --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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az stream-analytics function delete

Löschen sie eine 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

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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.

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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 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ültiger Wert.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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
                                  --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

Standardwert: False
--properties

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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
                                    --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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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 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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.