az stream-analytics input

  • 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-Eingabebefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Eingaben mit Datenstromanalysen.

Befehle

Name Beschreibung Typ Status
az stream-analytics input create

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

 Durchwahl Allgemein verfügbar
az stream-analytics input delete

Löschen sie eine Eingabe aus dem Streamingauftrag.

 Durchwahl Allgemein verfügbar
az stream-analytics input list

Listet alle Eingaben unter dem angegebenen Streamingauftrag auf.

 Durchwahl Allgemein verfügbar
az stream-analytics input show

Rufen Sie Details zur angegebenen Eingabe ab.

 Durchwahl Allgemein verfügbar
az stream-analytics input test

Testen Sie, ob die Datenquelle einer Eingabe erreichbar und vom Azure Stream Analytics-Dienst verwendet werden kann.

 Durchwahl Allgemein verfügbar
az stream-analytics input update

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

 Durchwahl Allgemein verfügbar
az stream-analytics input wait

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

 Durchwahl Allgemein verfügbar

az stream-analytics input create

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

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

Beispiele

Erstellen einer Verweis-BLOB-Eingabe mit CSV-Serialisierung

az stream-analytics input create --properties "{\"type\":\"Reference\",\"datasource\":{\"type\":\"Microsoft.Storage/Blob\",\"properties\":{\"container\":\"state\",\"dateFormat\":\"yyyy/MM/dd\",\"pathPattern\":\"{date}/{time}\",\"storageAccounts\":[{\"accountKey\":\"someAccountKey==\",\"accountName\":\"someAccountName\"}],\"timeFormat\":\"HH\"}},\"serialization\":{\"type\":\"Csv\",\"properties\":{\"encoding\":\"UTF8\",\"fieldDelimiter\":\",\"}}}" --input-name "input7225" --job-name "sj9597" --resource-group "sjrg8440"

Erstellen einer Stream Event Hub-Eingabe mit JSON-Serialisierung

az stream-analytics input create --properties "{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.ServiceBus/EventHub\",\"properties\":{\"consumerGroupName\":\"sdkconsumergroup\",\"eventHubName\":\"sdkeventhub\",\"serviceBusNamespace\":\"sdktest\",\"sharedAccessPolicyKey\":\"someSharedAccessPolicyKey==\",\"sharedAccessPolicyName\":\"RootManageSharedAccessKey\"}},\"serialization\":{\"type\":\"Json\",\"properties\":{\"encoding\":\"UTF8\"}}}" --input-name "input7425" --job-name "sj197" --resource-group "sjrg3139"

Erstellen einer IoT Hub-Stream-Eingabe mit Avro-Serialisierung

az stream-analytics input create --properties "{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.Devices/IotHubs\",\"properties\":{\"consumerGroupName\":\"sdkconsumergroup\",\"endpoint\":\"messages/events\",\"iotHubNamespace\":\"iothub\",\"sharedAccessPolicyKey\":\"sharedAccessPolicyKey=\",\"sharedAccessPolicyName\":\"owner\"}},\"serialization\":{\"type\":\"Avro\"}}" --input-name "input7970" --job-name "sj9742" --resource-group "sjrg3467"

Erstellen einer Stream-BLOB-Eingabe mit CSV-Serialisierung

az stream-analytics input create --properties "{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.Storage/Blob\",\"properties\":{\"container\":\"state\",\"dateFormat\":\"yyyy/MM/dd\",\"pathPattern\":\"{date}/{time}\",\"sourcePartitionCount\":16,\"storageAccounts\":[{\"accountKey\":\"someAccountKey==\",\"accountName\":\"someAccountName\"}],\"timeFormat\":\"HH\"}},\"serialization\":{\"type\":\"Csv\",\"properties\":{\"encoding\":\"UTF8\",\"fieldDelimiter\":\",\"}}}" --input-name "input8899" --job-name "sj6695" --resource-group "sjrg8161"

Erforderliche Parameter

--input-name --name -n

Der Name der Eingabe.

--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 Eingabe. Lassen Sie diesen Wert aus, um die aktuelle Eingabe 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, um die Erstellung einer neuen Eingabe zuzulassen, aber um zu verhindern, dass eine vorhandene Eingabe aktualisiert wird. Andere Werte führen zu einer Fehlerantwort von 412 Vorbedingung.

--properties

Die Eigenschaften, die einer Eingabe zugeordnet sind. Erforderlich für PUT-Anforderungen (CreateOrReplace). 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 input delete

Löschen sie eine Eingabe aus dem Streamingauftrag.

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

Beispiele

Löschen einer Eingabe

az stream-analytics input delete --input-name "input7225" --job-name "sj9597" --resource-group "sjrg8440"

Erforderliche Parameter

--input-name --name -n

Der Name der Eingabe.

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

Listet alle Eingaben unter dem angegebenen Streamingauftrag auf.

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

Beispiele

Auflisten aller Eingaben in einem Streamingauftrag

az stream-analytics input list --job-name "sj9597" --resource-group "sjrg8440"

Auflisten aller Eingaben in einem Streamingauftrag und Einschließen von Diagnoseinformationen mithilfe des $select OData-Abfrageparameters

az stream-analytics input list --select "*" --job-name "sj7804" --resource-group "sjrg3276"

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 von 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 input show

Rufen Sie Details zur angegebenen Eingabe ab.

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

Beispiele

Abrufen einer Referenz-BLOB-Eingabe mit CSV-Serialisierung

az stream-analytics input show --input-name "input7225" --job-name "sj9597" --resource-group "sjrg8440"

Abrufen einer Stream Event Hub-Eingabe mit JSON-Serialisierung

az stream-analytics input show --input-name "input7425" --job-name "sj197" --resource-group "sjrg3139"

Abrufen einer IoT Hub-Stream-Eingabe mit Avro-Serialisierung

az stream-analytics input show --input-name "input7970" --job-name "sj9742" --resource-group "sjrg3467"

Abrufen einer Stream-BLOB-Eingabe mit CSV-Serialisierung

az stream-analytics input show --input-name "input8899" --job-name "sj6695" --resource-group "sjrg8161"

Erforderliche Parameter

--input-name --name -n

Der Name der Eingabe.

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

Testen Sie, ob die Datenquelle einer Eingabe erreichbar und vom Azure Stream Analytics-Dienst verwendet werden kann.

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

Beispiele

Testen der Verbindung für eine Eingabe

az stream-analytics input test --input-name "input7225" --job-name "sj9597" --resource-group "sjrg8440"

Erforderliche Parameter

--input-name --name -n

Der Name der Eingabe.

--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 Eingabe zugeordnet sind. Erforderlich für PUT-Anforderungen (CreateOrReplace). 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 input update

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

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

Beispiele

Aktualisieren einer Referenz-BLOB-Eingabe

az stream-analytics input update --properties "{\"type\":\"Reference\",\"datasource\":{\"type\":\"Microsoft.Storage/Blob\",\"properties\":{\"container\":\"differentContainer\"}},\"serialization\":{\"type\":\"Csv\",\"properties\":{\"encoding\":\"UTF8\",\"fieldDelimiter\":\"|\"}}}" --input-name "input7225" --job-name "sj9597" --resource-group "sjrg8440"

Aktualisieren einer Stream Event Hub-Eingabe

az stream-analytics input update --properties "{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.ServiceBus/EventHub\",\"properties\":{\"consumerGroupName\":\"differentConsumerGroupName\"}},\"serialization\":{\"type\":\"Avro\"}}" --input-name "input7425" --job-name "sj197" --resource-group "sjrg3139"

Aktualisieren einer IoT Hub-Datenstromeingabe

az stream-analytics input update --properties "{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.Devices/IotHubs\",\"properties\":{\"endpoint\":\"messages/operationsMonitoringEvents\"}},\"serialization\":{\"type\":\"Csv\",\"properties\":{\"encoding\":\"UTF8\",\"fieldDelimiter\":\"|\"}}}" --input-name "input7970" --job-name "sj9742" --resource-group "sjrg3467"

Aktualisieren einer Stream-BLOB-Eingabe

az stream-analytics input update --properties "{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.Storage/Blob\",\"properties\":{\"sourcePartitionCount\":32}},\"serialization\":{\"type\":\"Csv\",\"properties\":{\"encoding\":\"UTF8\",\"fieldDelimiter\":\"|\"}}}" --input-name "input8899" --job-name "sj6695" --resource-group "sjrg8161"

Erforderliche Parameter

--input-name --name -n

Der Name der Eingabe.

--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 Eingabe. Lassen Sie diesen Wert aus, um die aktuelle Eingabe 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 Eingabe zugeordnet sind. Erforderlich für PUT-Anforderungen (CreateOrReplace). 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 input wait

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

az stream-analytics input wait --input-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 Datenstromanalyseeingabe erfolgreich erstellt wurde.

az stream-analytics input wait --input-name "input8899" --job-name "sj6695" --resource-group "sjrg8161" --created

Erforderliche Parameter

--input-name --name -n

Der Name der Eingabe.

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