az stream-analytics job
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 einen Az Stream-Analytics-Auftrag Befehl ausführen. Erfahren Sie mehr über Erweiterungen.
Verwalten des Streamingauftrags mit Streamanalyse.
Befehle
Name | Beschreibung | Typ | Status |
---|---|---|---|
az stream-analytics job create |
Erstellen Sie einen Streamingauftrag, oder ersetzen Sie einen bereits vorhandenen Streamingauftrag. |
Erweiterung | GA |
az stream-analytics job delete |
Löschen eines Streamingauftrags. |
Erweiterung | GA |
az stream-analytics job list |
Listet alle Streamingaufträge in der angegebenen Ressourcengruppe auf. Und listet alle Streamingaufträge im angegebenen Abonnement auf. |
Erweiterung | GA |
az stream-analytics job scale |
Skalieren eines Streamingauftrags, wenn der Auftrag ausgeführt wird. |
Erweiterung | GA |
az stream-analytics job show |
Rufen Sie Details zum angegebenen Streamingauftrag ab. |
Erweiterung | GA |
az stream-analytics job start |
Starten Sie einen Streamingauftrag. Nachdem ein Auftrag gestartet wurde, beginnt er mit der Verarbeitung von Eingabeereignissen und erzeugt eine Ausgabe. |
Erweiterung | GA |
az stream-analytics job stop |
Beenden Eines ausgeführten Streamingauftrags. Dies führt dazu, dass ein ausgeführter Streamingauftrag die Verarbeitung von Eingabeereignissen beendet und die Ausgabe erzeugt. |
Erweiterung | GA |
az stream-analytics job update |
Aktualisieren eines vorhandenen Streamingauftrags. Dies kann verwendet werden, um einen Streamingauftrag teilweise zu aktualisieren (z. B. eine oder zwei Eigenschaften aktualisieren), ohne dass sich dies auf die Restdefinition des Auftrags auswirkt. |
Erweiterung | GA |
az stream-analytics job wait |
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung des Datenstromanalyseauftrags erfüllt ist. |
Erweiterung | GA |
az stream-analytics job create
Erstellen Sie einen Streamingauftrag, oder ersetzen Sie einen bereits vorhandenen Streamingauftrag.
az stream-analytics job create --job-name
--resource-group
[--arrival-max-delay]
[--compatibility-level {1.0, 1.2}]
[--content-storage-policy {JobStorageAccount, SystemAccount}]
[--data-locale]
[--functions]
[--id]
[--identity]
[--if-match]
[--if-none-match]
[--inputs]
[--job-storage-account]
[--job-type {Cloud, Edge}]
[--location]
[--no-wait]
[--order-max-delay]
[--out-of-order-policy {Adjust, Drop}]
[--output-error-policy {Drop, Stop}]
[--output-start-mode {CustomTime, JobStartTime, LastOutputEventTime}]
[--output-start-time]
[--outputs]
[--tags]
[--transformation]
Beispiele
Erstellen eines vollständigen Streamingauftrags (ein Streamingauftrag mit transformation, mindestens 1 Eingabe und mindestens 1 Ausgabe)
az stream-analytics job create --job-name "sj7804" --resource-group "sjrg3276" --location "West US" --compatibility-level "1.0" --data-locale "en-US" --arrival-max-delay 5 --order-max-delay 0 --out-of-order-policy "Drop" --functions "[]" --inputs "[{\"name\":\"inputtest\",\"properties\":{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.Storage/Blob\",\"properties\":{\"container\":\"containerName\",\"pathPattern\":\"\",\"storageAccounts\":[{\"accountKey\":\"yourAccountKey==\",\"accountName\":\"yourAccountName\"}]}},\"serialization\":{\"type\":\"Json\",\"properties\":{\"encoding\":\"UTF8\"}}}}]" --output-error-policy "Drop" --outputs "[{\"name\":\"outputtest\",\"datasource\":{\"type\":\"Microsoft.Sql/Server/Database\",\"properties\":{\"database\":\"databaseName\",\"password\":\"userPassword\",\"server\":\"serverName\",\"table\":\"tableName\",\"user\":\"<user>\"}}}]" --transformation name="transformationtest" streaming-units=1 query="Select Id, Name from inputtest" --tags key1="value1" key3="value3" randomKey="randomValue"
Erstellen einer Streamingauftragsshell (ein Streamingauftrag ohne Eingaben, Ausgaben, Transformation oder Funktionen)
az stream-analytics job create --job-name "sj59" --resource-group "sjrg6936" --location "West US" --compatibility-level "1.0" --data-locale "en-US" --arrival-max-delay 16 --order-max-delay 5 --out-of-order-policy "Drop" --functions "[]" --inputs "[]" --output-error-policy "Drop" --outputs "[]" --tags key1="value1" key3="value3" randomKey="randomValue"
Erforderliche Parameter
Der Name des Streamingauftrags.
Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Die maximale tolerierbare Verzögerung in Sekunden, bei der Ereignisse, die verspätet eintreffen, enthalten sein könnten. Der unterstützte Bereich wird auf 1814399 (20.23:59:59:59 Tage) -1, und -1 wird verwendet, um die Wartezeit auf unbestimmte Zeit anzugeben. Wenn die Eigenschaft nicht vorhanden ist, wird sie interpretiert, um einen Wert von -1 zu haben.
Steuert bestimmte Laufzeitverhalten des Streamingauftrags.
Gültige Werte sind JobStorageAccount und SystemAccount. Wenn dieser Wert auf "JobStorageAccount" festgelegt ist, muss der Benutzer auch die Eigenschaft "jobStorageAccount" angeben. .
Das Datengebietsschema des Datenanalyseauftrags. Der Wert sollte der Name einer unterstützten .NET-Kultur aus dem set https://msdn.microsoft.com/en-us/library/system.globalization.culturetypes(v=vs.110).aspxsein. Wird standardmäßig auf 'en-US' festgelegt, wenn keine angegeben ist.
Eine Liste mit einer oder mehreren Funktionen für den Streamingauftrag. Die Name-Eigenschaft für jede Funktion ist erforderlich, wenn Sie diese Eigenschaft in einer PUT-Anforderung angeben. Diese Eigenschaft kann nicht über einen PATCH-Vorgang geändert werden. Sie müssen die PATCH-API verwenden, die für die einzelne Transformation verfügbar ist. Erwarteter Wert: json-string/json-file/@json-file.
Die Ressourcen-ID des Clusters.
Beschreiben Sie die diesem Auftrag zugewiesene verwaltete Identität, die für die Authentifizierung mit Eingaben und Ausgaben verwendet werden kann.
Verwendung: --identity tenant-id=XX principal-id=XX type=XX
Mandanten-ID: Die Identitätsmandanten-Prinzipal-ID: Der Identitätsprinzipal-ID-Typ: Der Identitätstyp.
Das ETag des Streamingauftrags. Lassen Sie diesen Wert aus, um den aktuellen Datensatzsatz immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.
Legen Sie auf '*' fest, damit ein neuer Streamingauftrag erstellt werden kann, aber um zu verhindern, dass ein vorhandener Datensatzsatz aktualisiert wird. Andere Werte führen zu einer Fehlerantwort von 412 Vorbedingung.
Eine Liste mit mindestens einer Eingabe für den Streamingauftrag. Die Name-Eigenschaft für jede Eingabe ist erforderlich, wenn Sie diese Eigenschaft in einer PUT-Anforderung angeben. Diese Eigenschaft kann nicht über einen PATCH-Vorgang geändert werden. Sie müssen die PATCH-API verwenden, die für die einzelnen Eingaben verfügbar ist. Erwarteter Wert: json-string/json-file/@json-file.
Die Eigenschaften, die einem Azure Storage-Konto mit MSI zugeordnet sind.
Verwendung: --job-storage-account authentication-mode=XX account-name=XX account-key=XX
Authentifizierungsmodus: Authentifizierungsmodus. Kontoname: Der Name des Azure Storage-Kontos. Erforderlich für PUT-Anforderungen (CreateOrReplace). Account-Key: Der Kontoschlüssel für das Azure Storage-Konto. Erforderlich für PUT-Anforderungen (CreateOrReplace).
Beschreibt den Typ des Auftrags. Gültige Modi sind Cloud
und "Edge".
Ort. Werte aus: az account list-locations
. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>
konfigurieren.
Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.
Die maximale tolerierbare Verzögerung in Sekunden, bei der Out-of-Order-Ereignisse angepasst werden können, um in der Reihenfolge wieder zu sein.
Gibt die Richtlinie an, die auf Ereignisse angewendet werden soll, die im Eingabeereignisdatenstrom außerhalb der Reihenfolge eingehen.
Gibt die Richtlinie an, die auf Ereignisse angewendet werden soll, die an der Ausgabe eingehen und aufgrund falscher Spaltenwerte, spaltenwerte falscher Typ oder Größe nicht in den externen Speicher geschrieben werden können.
Diese Eigenschaft sollte nur verwendet werden, wenn gewünscht wird, dass der Auftrag sofort beim Erstellen gestartet wird. Der Wert kann JobStartTime, CustomTime oder LastOutputEventTime sein, um anzugeben, ob der Startpunkt des Ausgabeereignisdatenstroms gestartet werden soll, wenn der Auftrag gestartet wird, mit einem benutzerdefinierten Benutzerzeitstempel beginnen, der über die outputStartTime-Eigenschaft angegeben ist, oder von der letzten Ereignisausgabezeit beginnen soll.
Der Wert ist entweder ein formatierter ISO-8601-Zeitstempel, der den Startpunkt des Ausgabeereignisdatenstroms angibt, oder NULL, um anzugeben, dass der Ausgabeereignisdatenstrom bei jedem Start des Streamingauftrags gestartet wird. Diese Eigenschaft muss einen Wert aufweisen, wenn outputStartMode auf CustomTime festgelegt ist.
Eine Liste mit einer oder mehreren Ausgaben für den Streamingauftrag. Die Name-Eigenschaft für jede Ausgabe ist erforderlich, wenn Sie diese Eigenschaft in einer PUT-Anforderung angeben. Diese Eigenschaft kann nicht über einen PATCH-Vorgang geändert werden. Sie müssen die PATCH-API verwenden, die für die einzelne Ausgabe verfügbar ist. Erwarteter Wert: json-string/json-file/@json-file.
Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Geben Sie die Abfrage und die Anzahl der Streamingeinheiten an, die für den Streamingauftrag verwendet werden sollen. Die Namenseigenschaft der Transformation ist erforderlich, wenn Sie diese Eigenschaft in einer PUT-Anforderung angeben. Diese Eigenschaft kann nicht über einen PATCH-Vorgang geändert werden. Sie müssen die PATCH-API verwenden, die für die einzelne Transformation verfügbar ist.
Verwendung: --transformation streaming-units=XX valid-streaming-units=XX query=XX name=XX
Streaming-Einheiten: Gibt die Anzahl der Streamingeinheiten an, die der Streamingauftrag verwendet. valid-streaming-units: Gibt die gültigen Streamingeinheiten an, auf die ein Streamingauftrag skaliert werden kann. abfrage: Gibt die Abfrage an, die im Streamingauftrag ausgeführt wird. Weitere Informationen zur Stream Analytics Query Language (SAQL) finden Sie hier: https://msdn.microsoft.com/library/azure/dn834998 . Erforderlich für PUT-Anforderungen (CreateOrReplace). name: Ressourcenname.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az stream-analytics job delete
Löschen eines Streamingauftrags.
az stream-analytics job delete --job-name
--resource-group
[--no-wait]
[--yes]
Beispiele
Löschen eines Streamingauftrags
az stream-analytics job delete --job-name "sj59" --resource-group "sjrg6936"
Erforderliche Parameter
Der Name des Streamingauftrags.
Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.
Zur Bestätigung nicht auffordern.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az stream-analytics job list
Listet alle Streamingaufträge in der angegebenen Ressourcengruppe auf. Und listet alle Streamingaufträge im angegebenen Abonnement auf.
az stream-analytics job list [--expand]
[--resource-group]
Beispiele
Auflisten aller Streamingaufträge in einer Ressourcengruppe und Verwenden des $expand OData-Abfrageparameters
az stream-analytics job list --resource-group "sjrg6936"
Auflisten aller Streamingaufträge in einer Ressourcengruppe und Verwenden des $expand OData-Abfrageparameters zum Erweitern von Eingaben, Ausgaben, Transformation und Funktionen
az stream-analytics job list --expand "inputs,outputs,transformation,functions" --resource-group "sjrg3276"
Auflisten aller Streamingaufträge in einem Abonnement und Verwenden des OData-Abfrageparameters $expand
az stream-analytics job list
Auflisten aller Streamingaufträge in einem Abonnement und Verwenden des $expand OData-Abfrageparameters zum Erweitern von Eingaben, Ausgaben, Transformation und Funktionen
az stream-analytics job list --expand "inputs,outputs,transformation,functions"
Optionale Parameter
Der $expand OData-Abfrageparameter. Dies ist eine durch Trennzeichen getrennte Liste zusätzlicher Streamingauftragseigenschaften, die in die Antwort eingeschlossen werden sollen, und nicht der Standardsatz, der zurückgegeben wird, wenn dieser Parameter nicht vorhanden ist. Der Standardsatz ist alle Streamingauftragseigenschaften außer "input", "transformation", "outputs" und "functions".
Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az stream-analytics job scale
Skalieren eines Streamingauftrags, wenn der Auftrag ausgeführt wird.
az stream-analytics job scale --job-name
--resource-group
[--no-wait]
[--streaming-units]
Beispiele
Skalieren eines Streamingauftrags
az stream-analytics job scale --job-name "sj59" --resource-group "sjrg6936" --streaming-units 36
Erforderliche Parameter
Der Name des Streamingauftrags.
Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.
Gibt die Anzahl der Streamingeinheiten an, auf die der Streamingauftrag skaliert wird.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az stream-analytics job show
Rufen Sie Details zum angegebenen Streamingauftrag ab.
az stream-analytics job show --job-name
--resource-group
[--expand]
Beispiele
Abrufen eines Streamingauftrags und Verwenden des $expand OData-Abfrageparameters
az stream-analytics job show --job-name "sj59" --resource-group "sjrg6936"
Abrufen eines Streamingauftrags und Verwenden des $expand OData-Abfrageparameters zum Erweitern von Eingaben, Ausgaben, Transformation und Funktionen
az stream-analytics job show --expand "inputs,outputs,transformation,functions" --job-name "sj7804" --resource-group "sjrg3276"
Erforderliche Parameter
Der Name des Streamingauftrags.
Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Der $expand OData-Abfrageparameter. Dies ist eine durch Trennzeichen getrennte Liste zusätzlicher Streamingauftragseigenschaften, die in die Antwort eingeschlossen werden sollen, und nicht der Standardsatz, der zurückgegeben wird, wenn dieser Parameter nicht vorhanden ist. Der Standardsatz ist alle Streamingauftragseigenschaften außer "input", "transformation", "outputs" und "functions".
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az stream-analytics job start
Starten Sie einen Streamingauftrag. Nachdem ein Auftrag gestartet wurde, beginnt er mit der Verarbeitung von Eingabeereignissen und erzeugt eine Ausgabe.
az stream-analytics job start --job-name
--resource-group
[--no-wait]
[--output-start-mode {CustomTime, JobStartTime, LastOutputEventTime}]
[--output-start-time]
Beispiele
Starten eines Streamingauftrags mit Dem CustomTime-Ausgabestartmodus
az stream-analytics job start --job-name "sj59" --resource-group "sjrg6936" --output-start-mode "CustomTime" --output-start-time "2012-12-12T12:12:12Z"
Starten eines Streamingauftrags mit Dem JobStartTime-Ausgabestartmodus
az stream-analytics job start --job-name "sj59" --resource-group "sjrg6936" --output-start-mode "JobStartTime"
Starten eines Streamingauftrags mit dem Startmodus "LastOutputEventTime"
az stream-analytics job start --job-name "sj59" --resource-group "sjrg6936" --output-start-mode "LastOutputEventTime"
Erforderliche Parameter
Der Name des Streamingauftrags.
Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.
Der Wert kann JobStartTime, CustomTime oder LastOutputEventTime sein, um anzugeben, ob der Startpunkt des Ausgabeereignisdatenstroms gestartet werden soll, wenn der Auftrag gestartet wird, mit einem benutzerdefinierten Benutzerzeitstempel beginnen, der über die outputStartTime-Eigenschaft angegeben ist, oder von der letzten Ereignisausgabezeit beginnen soll.
Der Wert ist entweder ein formatierter ISO-8601-Zeitstempel, der den Startpunkt des Ausgabeereignisdatenstroms angibt, oder NULL, um anzugeben, dass der Ausgabeereignisdatenstrom bei jedem Start des Streamingauftrags gestartet wird. Diese Eigenschaft muss einen Wert aufweisen, wenn outputStartMode auf CustomTime festgelegt ist.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az stream-analytics job stop
Beenden Eines ausgeführten Streamingauftrags. Dies führt dazu, dass ein ausgeführter Streamingauftrag die Verarbeitung von Eingabeereignissen beendet und die Ausgabe erzeugt.
az stream-analytics job stop --job-name
--resource-group
[--no-wait]
Beispiele
Beenden eines Streamingauftrags
az stream-analytics job stop --job-name "sj59" --resource-group "sjrg6936"
Erforderliche Parameter
Der Name des Streamingauftrags.
Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az stream-analytics job update
Aktualisieren eines vorhandenen Streamingauftrags. Dies kann verwendet werden, um einen Streamingauftrag teilweise zu aktualisieren (z. B. eine oder zwei Eigenschaften aktualisieren), ohne dass sich dies auf die Restdefinition des Auftrags auswirkt.
az stream-analytics job update --job-name
--resource-group
[--arrival-max-delay]
[--compatibility-level {1.0, 1.2}]
[--content-storage-policy {JobStorageAccount, SystemAccount}]
[--data-locale]
[--functions]
[--id]
[--identity]
[--if-match]
[--inputs]
[--job-storage-account]
[--job-type {Cloud, Edge}]
[--location]
[--order-max-delay]
[--out-of-order-policy {Adjust, Drop}]
[--output-error-policy {Drop, Stop}]
[--output-start-mode {CustomTime, JobStartTime, LastOutputEventTime}]
[--output-start-time]
[--outputs]
[--tags]
[--transformation]
Beispiele
Aktualisieren eines Streamingauftrags
az stream-analytics job update --job-name "sj59" --resource-group "sjrg6936" --arrival-max-delay 13 --order-max-delay 21
Erforderliche Parameter
Der Name des Streamingauftrags.
Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Die maximale tolerierbare Verzögerung in Sekunden, bei der Ereignisse, die verspätet eintreffen, enthalten sein könnten. Der unterstützte Bereich wird auf 1814399 (20.23:59:59:59 Tage) -1, und -1 wird verwendet, um die Wartezeit auf unbestimmte Zeit anzugeben. Wenn die Eigenschaft nicht vorhanden ist, wird sie interpretiert, um einen Wert von -1 zu haben.
Steuert bestimmte Laufzeitverhalten des Streamingauftrags.
Gültige Werte sind JobStorageAccount und SystemAccount. Wenn dieser Wert auf "JobStorageAccount" festgelegt ist, muss der Benutzer auch die Eigenschaft "jobStorageAccount" angeben. .
Das Datengebietsschema des Datenanalyseauftrags. Der Wert sollte der Name einer unterstützten .NET-Kultur aus dem set https://msdn.microsoft.com/en-us/library/system.globalization.culturetypes(v=vs.110).aspxsein. Wird standardmäßig auf 'en-US' festgelegt, wenn keine angegeben ist.
Eine Liste mit einer oder mehreren Funktionen für den Streamingauftrag. Die Name-Eigenschaft für jede Funktion ist erforderlich, wenn Sie diese Eigenschaft in einer PUT-Anforderung angeben. Diese Eigenschaft kann nicht über einen PATCH-Vorgang geändert werden. Sie müssen die PATCH-API verwenden, die für die einzelne Transformation verfügbar ist. Erwarteter Wert: json-string/json-file/@json-file.
Die Ressourcen-ID des Clusters.
Beschreiben Sie die diesem Auftrag zugewiesene verwaltete Identität, die für die Authentifizierung mit Eingaben und Ausgaben verwendet werden kann.
Verwendung: --identity tenant-id=XX principal-id=XX type=XX
Mandanten-ID: Die Identitätsmandanten-Prinzipal-ID: Der Identitätsprinzipal-ID-Typ: Der Identitätstyp.
Das ETag des Streamingauftrags. Lassen Sie diesen Wert aus, um den aktuellen Datensatzsatz immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.
Eine Liste mit mindestens einer Eingabe für den Streamingauftrag. Die Name-Eigenschaft für jede Eingabe ist erforderlich, wenn Sie diese Eigenschaft in einer PUT-Anforderung angeben. Diese Eigenschaft kann nicht über einen PATCH-Vorgang geändert werden. Sie müssen die PATCH-API verwenden, die für die einzelnen Eingaben verfügbar ist. Erwarteter Wert: json-string/json-file/@json-file.
Die Eigenschaften, die einem Azure Storage-Konto mit MSI zugeordnet sind.
Verwendung: --job-storage-account authentication-mode=XX account-name=XX account-key=XX
Authentifizierungsmodus: Authentifizierungsmodus. Kontoname: Der Name des Azure Storage-Kontos. Erforderlich für PUT-Anforderungen (CreateOrReplace). Account-Key: Der Kontoschlüssel für das Azure Storage-Konto. Erforderlich für PUT-Anforderungen (CreateOrReplace).
Beschreibt den Typ des Auftrags. Gültige Modi sind Cloud
und "Edge".
Ort. Werte aus: az account list-locations
. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>
konfigurieren.
Die maximale tolerierbare Verzögerung in Sekunden, bei der Out-of-Order-Ereignisse angepasst werden können, um in der Reihenfolge wieder zu sein.
Gibt die Richtlinie an, die auf Ereignisse angewendet werden soll, die im Eingabeereignisdatenstrom außerhalb der Reihenfolge eingehen.
Gibt die Richtlinie an, die auf Ereignisse angewendet werden soll, die an der Ausgabe eingehen und aufgrund falscher Spaltenwerte, spaltenwerte falscher Typ oder Größe nicht in den externen Speicher geschrieben werden können.
Diese Eigenschaft sollte nur verwendet werden, wenn gewünscht wird, dass der Auftrag sofort beim Erstellen gestartet wird. Der Wert kann JobStartTime, CustomTime oder LastOutputEventTime sein, um anzugeben, ob der Startpunkt des Ausgabeereignisdatenstroms gestartet werden soll, wenn der Auftrag gestartet wird, mit einem benutzerdefinierten Benutzerzeitstempel beginnen, der über die outputStartTime-Eigenschaft angegeben ist, oder von der letzten Ereignisausgabezeit beginnen soll.
Der Wert ist entweder ein formatierter ISO-8601-Zeitstempel, der den Startpunkt des Ausgabeereignisdatenstroms angibt, oder NULL, um anzugeben, dass der Ausgabeereignisdatenstrom bei jedem Start des Streamingauftrags gestartet wird. Diese Eigenschaft muss einen Wert aufweisen, wenn outputStartMode auf CustomTime festgelegt ist.
Eine Liste mit einer oder mehreren Ausgaben für den Streamingauftrag. Die Name-Eigenschaft für jede Ausgabe ist erforderlich, wenn Sie diese Eigenschaft in einer PUT-Anforderung angeben. Diese Eigenschaft kann nicht über einen PATCH-Vorgang geändert werden. Sie müssen die PATCH-API verwenden, die für die einzelne Ausgabe verfügbar ist. Erwarteter Wert: json-string/json-file/@json-file.
Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Geben Sie die Abfrage und die Anzahl der Streamingeinheiten an, die für den Streamingauftrag verwendet werden sollen. Die Namenseigenschaft der Transformation ist erforderlich, wenn Sie diese Eigenschaft in einer PUT-Anforderung angeben. Diese Eigenschaft kann nicht über einen PATCH-Vorgang geändert werden. Sie müssen die PATCH-API verwenden, die für die einzelne Transformation verfügbar ist.
Verwendung: --transformation streaming-units=XX valid-streaming-units=XX query=XX name=XX
Streaming-Einheiten: Gibt die Anzahl der Streamingeinheiten an, die der Streamingauftrag verwendet. valid-streaming-units: Gibt die gültigen Streamingeinheiten an, auf die ein Streamingauftrag skaliert werden kann. abfrage: Gibt die Abfrage an, die im Streamingauftrag ausgeführt wird. Weitere Informationen zur Stream Analytics Query Language (SAQL) finden Sie hier: https://msdn.microsoft.com/library/azure/dn834998 . Erforderlich für PUT-Anforderungen (CreateOrReplace). name: Ressourcenname.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az stream-analytics job wait
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung des Datenstromanalyseauftrags erfüllt ist.
az stream-analytics job wait --job-name
--resource-group
[--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--interval]
[--timeout]
[--updated]
Beispiele
Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis der Streamanalyseauftrag erfolgreich erstellt wurde.
az stream-analytics job wait --expand "inputs,outputs,transformation,functions" --job-name "sj7804" --resource-group "sjrg3276" --created
Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis der Streamanalyseauftrag erfolgreich gelöscht wurde.
az stream-analytics job wait --expand "inputs,outputs,transformation,functions" --job-name "sj7804" --resource-group "sjrg3276" --deleted
Erforderliche Parameter
Der Name des Streamingauftrags.
Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.
Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Warten Sie, bis sie gelöscht wurde.
Warten Sie, bis die Ressource vorhanden ist.
Der $expand OData-Abfrageparameter. Dies ist eine durch Trennzeichen getrennte Liste zusätzlicher Streamingauftragseigenschaften, die in die Antwort eingeschlossen werden sollen, und nicht der Standardsatz, der zurückgegeben wird, wenn dieser Parameter nicht vorhanden ist. Der Standardsatz ist alle Streamingauftragseigenschaften außer "input", "transformation", "outputs" und "functions".
Abrufintervall in Sekunden.
Maximale Wartezeit in Sekunden.
Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.