Partager via


az stream-analytics job

Note

Cette référence fait partie de l’extension stream-analytics pour Azure CLI (version 2.75.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez un travail az stream-analytics commande. Apprenez-en davantage sur les extensions.

Gérer la tâche de diffusion en continu avec Stream Analytics.

Commandes

Nom Description Type État
az stream-analytics job create

Créez un travail de streaming ou remplacez un travail de streaming déjà existant.

Extension GA
az stream-analytics job delete

Supprimez un travail de diffusion en continu.

Extension GA
az stream-analytics job list

Répertorier tous les travaux de diffusion en continu dans le groupe de ressources spécifié. Et répertorie tous les travaux de diffusion en continu dans l’abonnement donné.

Extension GA
az stream-analytics job scale

Mettez à l’échelle un travail de diffusion en continu lorsque le travail est en cours d’exécution.

Extension GA
az stream-analytics job show

Obtenez des détails sur la tâche de diffusion en continu spécifiée.

Extension GA
az stream-analytics job start

Démarrez un travail de diffusion en continu. Une fois qu’un travail est démarré, il démarre le traitement des événements d’entrée et produit la sortie.

Extension GA
az stream-analytics job stop

Arrêtez une tâche de streaming en cours d’exécution. Cela entraîne l’arrêt d’un travail de streaming en cours d’exécution pour arrêter le traitement des événements d’entrée et produire une sortie.

Extension GA
az stream-analytics job update

Mettez à jour un travail de streaming existant. Cela peut être utilisé pour mettre à jour partiellement (par exemple, mettre à jour une ou deux propriétés) un travail de streaming sans affecter le reste de la définition du travail.

Extension GA
az stream-analytics job wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition du travail stream-analytics soit remplie.

Extension GA

az stream-analytics job create

Créez un travail de streaming ou remplacez un travail de streaming déjà existant.

az stream-analytics job create --job-name --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]

Exemples

Créer un travail de streaming complet (tâche de diffusion en continu avec une transformation, au moins 1 entrée et au moins 1 sortie)

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"

Créer un interpréteur de commandes de travail de streaming (tâche de streaming sans entrées, sorties, transformation ou fonctions)

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"

Paramètres obligatoires

--job-name --name -n

Nom du travail de diffusion en continu.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--arrival-max-delay

Délai maximal tolérable en secondes où les événements arrivant en retard peuvent être inclus. La plage prise en charge est -1 à 1814399 (20.23:59:59:59 jours) et -1 est utilisée pour spécifier l’attente indéfiniment. Si la propriété est absente, elle est interprétée comme ayant la valeur -1.

--compatibility-level

Contrôle certains comportements d’exécution du travail de streaming.

Propriété Valeur
Valeurs acceptées: 1.0, 1.2
--content-storage-policy

Les valeurs valides sont JobStorageAccount et SystemAccount. Si la valeur est JobStorageAccount, l’utilisateur doit également spécifier la propriété jobStorageAccount. .

Propriété Valeur
Valeurs acceptées: JobStorageAccount, SystemAccount
--data-locale

Paramètres régionaux de données du travail Stream Analytics. La valeur doit être le nom d’une culture .NET prise en charge à partir de l’ensemble https://msdn.microsoft.com/en-us/library/system.globalization.culturetypes(v=vs.110).aspx. La valeur par défaut est 'en-US' si aucune valeur n’est spécifiée.

--functions

Liste d’une ou de plusieurs fonctions pour la tâche de diffusion en continu. La propriété name de chaque fonction est requise lors de la spécification de cette propriété dans une requête PUT. Cette propriété ne peut pas être modifiable via une opération PATCH. Vous devez utiliser l’API PATCH disponible pour la transformation individuelle. Valeur attendue : json-string/json-file/@json-file.

--id

ID de ressource du cluster.

Propriété Valeur
Groupe de paramètres: Cluster Arguments
--identity

Décrire l’identité managée affectée par le système affectée à ce travail qui peut être utilisée pour s’authentifier avec des entrées et des sorties.

Utilisation : --identity tenant-id=XX principal-id=XX type=XX

tenant-id : id du principal tenantId d’identité : type d’ID du principal d’identité : type d’identité.

--if-match

ETag de la tâche de diffusion en continu. Omettez cette valeur pour toujours remplacer le jeu d’enregistrements actif. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

--if-none-match

Définissez la valeur « * » pour autoriser la création d’un nouveau travail de streaming, mais pour empêcher la mise à jour d’un jeu d’enregistrements existant. D’autres valeurs entraînent une réponse 412 en cas d’échec de la condition.

--inputs

Liste d’une ou de plusieurs entrées dans la tâche de diffusion en continu. La propriété name pour chaque entrée est requise lors de la spécification de cette propriété dans une requête PUT. Cette propriété ne peut pas être modifiable via une opération PATCH. Vous devez utiliser l’API PATCH disponible pour l’entrée individuelle. Valeur attendue : json-string/json-file/@json-file.

--job-storage-account

Propriétés associées à un compte de stockage Azure avec MSI.

Utilisation : --job-storage-account authentication-mode=XX account-name=XX account-key=XX

mode d’authentification : mode d’authentification. nom du compte : nom du compte de stockage Azure. Obligatoire sur les requêtes PUT (CreateOrReplace). clé de compte : clé de compte pour le compte stockage Azure. Obligatoire sur les requêtes PUT (CreateOrReplace).

--job-type

Décrit le type du travail. Les modes valides sont Cloud et « Edge ».

Propriété Valeur
Valeurs acceptées: Cloud, Edge
--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--order-max-delay

Délai maximal tolérable en secondes où les événements hors ordre peuvent être ajustés pour être de retour dans l’ordre.

--out-of-order-policy

Indique la stratégie à appliquer aux événements qui arrivent dans le flux d’événements d’entrée.

Propriété Valeur
Valeurs acceptées: Adjust, Drop
--output-error-policy

Indique la stratégie à appliquer aux événements qui arrivent à la sortie et ne peuvent pas être écrits dans le stockage externe en raison d’une mauvaise forme (valeurs de colonne manquantes, valeurs de colonne de type ou de taille incorrectes).

Propriété Valeur
Valeurs acceptées: Drop, Stop
--output-start-mode

Cette propriété ne doit être utilisée que lorsque vous souhaitez que le travail soit démarré immédiatement lors de la création. La valeur peut être JobStartTime, CustomTime ou LastOutputEventTime pour indiquer si le point de départ du flux d’événements de sortie doit démarrer chaque fois que le travail est démarré, démarrer à un horodatage utilisateur personnalisé spécifié via la propriété outputStartTime ou démarrer à partir de la dernière heure de sortie de l’événement.

Propriété Valeur
Valeurs acceptées: CustomTime, JobStartTime, LastOutputEventTime
--output-start-time

La valeur est soit un horodatage au format ISO-8601 qui indique le point de départ du flux d’événements de sortie, soit null pour indiquer que le flux d’événements de sortie démarre chaque fois que la tâche de diffusion en continu est démarrée. Cette propriété doit avoir une valeur si outputStartMode est défini sur CustomTime.

--outputs

Liste d’une ou de plusieurs sorties pour la tâche de diffusion en continu. La propriété name pour chaque sortie est requise lors de la spécification de cette propriété dans une requête PUT. Cette propriété ne peut pas être modifiable via une opération PATCH. Vous devez utiliser l’API PATCH disponible pour la sortie individuelle. Valeur attendue : json-string/json-file/@json-file.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--transformation

Indiquez la requête et le nombre d’unités de diffusion en continu à utiliser pour la tâche de diffusion en continu. La propriété name de la transformation est requise lors de la spécification de cette propriété dans une requête PUT. Cette propriété ne peut pas être modifiable via une opération PATCH. Vous devez utiliser l’API PATCH disponible pour la transformation individuelle.

Utilisation : --transformation streaming-units=XX valid-streaming-units=XX query=XX name=XX

streaming-units : spécifie le nombre d’unités de diffusion en continu que la tâche de diffusion en continu utilise. valid-streaming-units : spécifie les unités de diffusion en continu valides vers laquelle un travail de diffusion en continu peut être mis à l’échelle. requête : spécifie la requête qui sera exécutée dans la tâche de diffusion en continu. Vous pouvez en savoir plus sur le langage de requête Stream Analytics (SAQL) ici : https://msdn.microsoft.com/library/azure/dn834998 . Obligatoire sur les requêtes PUT (CreateOrReplace). nom : nom de la ressource.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az stream-analytics job delete

Supprimez un travail de diffusion en continu.

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

Exemples

Supprimer un travail de diffusion en continu

az stream-analytics job delete --job-name "sj59" --resource-group "sjrg6936"

Paramètres obligatoires

--job-name --name -n

Nom du travail de diffusion en continu.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--yes -y

N’invitez pas à confirmer.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az stream-analytics job list

Répertorier tous les travaux de diffusion en continu dans le groupe de ressources spécifié. Et répertorie tous les travaux de diffusion en continu dans l’abonnement donné.

az stream-analytics job list [--expand]
                             [--resource-group]

Exemples

Répertorier tous les travaux de streaming dans un groupe de ressources et n’utiliser pas le paramètre de requête OData $expand

az stream-analytics job list --resource-group "sjrg6936"

Répertorier tous les travaux de streaming dans un groupe de ressources et utiliser le paramètre de requête OData $expand pour développer les entrées, les sorties, la transformation et les fonctions

az stream-analytics job list --expand "inputs,outputs,transformation,functions" --resource-group "sjrg3276"

Répertorier tous les travaux de diffusion en continu dans un abonnement et n’utiliser pas le paramètre de requête OData $expand

az stream-analytics job list

Répertorier tous les travaux de streaming dans un abonnement et utiliser le paramètre de requête OData $expand pour développer les entrées, les sorties, la transformation et les fonctions

az stream-analytics job list --expand "inputs,outputs,transformation,functions"

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--expand

Paramètre de requête OData $expand. Il s’agit d’une liste séparée par des virgules de propriétés de travail de streaming supplémentaires à inclure dans la réponse, au-delà du jeu par défaut retourné lorsque ce paramètre est absent. L’ensemble par défaut est toutes les propriétés de travail de diffusion en continu autres que « entrées », « transformation », « sorties » et « functions ».

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az stream-analytics job scale

Mettez à l’échelle un travail de diffusion en continu lorsque le travail est en cours d’exécution.

az stream-analytics job scale --job-name --name
                              --resource-group
                              [--no-wait]
                              [--streaming-units]

Exemples

Mettre à l’échelle un travail de diffusion en continu

az stream-analytics job scale --job-name "sj59" --resource-group "sjrg6936" --streaming-units 36

Paramètres obligatoires

--job-name --name -n

Nom du travail de diffusion en continu.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--streaming-units

Spécifie le nombre d’unités de diffusion en continu auxquelles la tâche de diffusion en continu sera mise à l’échelle.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az stream-analytics job show

Obtenez des détails sur la tâche de diffusion en continu spécifiée.

az stream-analytics job show --job-name --name
                             --resource-group
                             [--expand]

Exemples

Obtenir un travail de diffusion en continu et n’utiliser pas le paramètre de requête OData $expand

az stream-analytics job show --job-name "sj59" --resource-group "sjrg6936"

Obtenir un travail de streaming et utiliser le paramètre de requête OData $expand pour développer les entrées, les sorties, la transformation et les fonctions

az stream-analytics job show --expand "inputs,outputs,transformation,functions" --job-name "sj7804" --resource-group "sjrg3276"

Paramètres obligatoires

--job-name --name -n

Nom du travail de diffusion en continu.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--expand

Paramètre de requête OData $expand. Il s’agit d’une liste séparée par des virgules de propriétés de travail de streaming supplémentaires à inclure dans la réponse, au-delà du jeu par défaut retourné lorsque ce paramètre est absent. L’ensemble par défaut est toutes les propriétés de travail de diffusion en continu autres que « entrées », « transformation », « sorties » et « functions ».

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az stream-analytics job start

Démarrez un travail de diffusion en continu. Une fois qu’un travail est démarré, il démarre le traitement des événements d’entrée et produit la sortie.

az stream-analytics job start --job-name --name
                              --resource-group
                              [--no-wait]
                              [--output-start-mode {CustomTime, JobStartTime, LastOutputEventTime}]
                              [--output-start-time]

Exemples

Démarrer un travail de streaming avec le mode de démarrage de sortie CustomTime

az stream-analytics job start --job-name "sj59" --resource-group "sjrg6936" --output-start-mode "CustomTime" --output-start-time "2012-12-12T12:12:12Z"

Démarrer un travail de streaming avec le mode de démarrage de sortie JobStartTime

az stream-analytics job start --job-name "sj59" --resource-group "sjrg6936" --output-start-mode "JobStartTime"

Démarrer un travail de streaming avec le mode de démarrage de sortie LastOutputEventTime

az stream-analytics job start --job-name "sj59" --resource-group "sjrg6936" --output-start-mode "LastOutputEventTime"

Paramètres obligatoires

--job-name --name -n

Nom du travail de diffusion en continu.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--output-start-mode

La valeur peut être JobStartTime, CustomTime ou LastOutputEventTime pour indiquer si le point de départ du flux d’événements de sortie doit démarrer chaque fois que le travail est démarré, démarrer à un horodatage utilisateur personnalisé spécifié via la propriété outputStartTime ou démarrer à partir de la dernière heure de sortie de l’événement.

Propriété Valeur
Valeurs acceptées: CustomTime, JobStartTime, LastOutputEventTime
--output-start-time

La valeur est soit un horodatage au format ISO-8601 qui indique le point de départ du flux d’événements de sortie, soit null pour indiquer que le flux d’événements de sortie démarre chaque fois que la tâche de diffusion en continu est démarrée. Cette propriété doit avoir une valeur si outputStartMode est défini sur CustomTime.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az stream-analytics job stop

Arrêtez une tâche de streaming en cours d’exécution. Cela entraîne l’arrêt d’un travail de streaming en cours d’exécution pour arrêter le traitement des événements d’entrée et produire une sortie.

az stream-analytics job stop --job-name --name
                             --resource-group
                             [--no-wait]

Exemples

Arrêter un travail de diffusion en continu

az stream-analytics job stop --job-name "sj59" --resource-group "sjrg6936"

Paramètres obligatoires

--job-name --name -n

Nom du travail de diffusion en continu.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az stream-analytics job update

Mettez à jour un travail de streaming existant. Cela peut être utilisé pour mettre à jour partiellement (par exemple, mettre à jour une ou deux propriétés) un travail de streaming sans affecter le reste de la définition du travail.

az stream-analytics job update --job-name --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]

Exemples

Mettre à jour un travail de diffusion en continu

az stream-analytics job update --job-name "sj59" --resource-group "sjrg6936" --arrival-max-delay 13 --order-max-delay 21

Paramètres obligatoires

--job-name --name -n

Nom du travail de diffusion en continu.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--arrival-max-delay

Délai maximal tolérable en secondes où les événements arrivant en retard peuvent être inclus. La plage prise en charge est -1 à 1814399 (20.23:59:59:59 jours) et -1 est utilisée pour spécifier l’attente indéfiniment. Si la propriété est absente, elle est interprétée comme ayant la valeur -1.

--compatibility-level

Contrôle certains comportements d’exécution du travail de streaming.

Propriété Valeur
Valeurs acceptées: 1.0, 1.2
--content-storage-policy

Les valeurs valides sont JobStorageAccount et SystemAccount. Si la valeur est JobStorageAccount, l’utilisateur doit également spécifier la propriété jobStorageAccount. .

Propriété Valeur
Valeurs acceptées: JobStorageAccount, SystemAccount
--data-locale

Paramètres régionaux de données du travail Stream Analytics. La valeur doit être le nom d’une culture .NET prise en charge à partir de l’ensemble https://msdn.microsoft.com/en-us/library/system.globalization.culturetypes(v=vs.110).aspx. La valeur par défaut est 'en-US' si aucune valeur n’est spécifiée.

--functions

Liste d’une ou de plusieurs fonctions pour la tâche de diffusion en continu. La propriété name de chaque fonction est requise lors de la spécification de cette propriété dans une requête PUT. Cette propriété ne peut pas être modifiable via une opération PATCH. Vous devez utiliser l’API PATCH disponible pour la transformation individuelle. Valeur attendue : json-string/json-file/@json-file.

--id

ID de ressource du cluster.

Propriété Valeur
Groupe de paramètres: Cluster Arguments
--identity

Décrire l’identité managée affectée par le système affectée à ce travail qui peut être utilisée pour s’authentifier avec des entrées et des sorties.

Utilisation : --identity tenant-id=XX principal-id=XX type=XX

tenant-id : id du principal tenantId d’identité : type d’ID du principal d’identité : type d’identité.

--if-match

ETag de la tâche de diffusion en continu. Omettez cette valeur pour toujours remplacer le jeu d’enregistrements actif. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

--inputs

Liste d’une ou de plusieurs entrées dans la tâche de diffusion en continu. La propriété name pour chaque entrée est requise lors de la spécification de cette propriété dans une requête PUT. Cette propriété ne peut pas être modifiable via une opération PATCH. Vous devez utiliser l’API PATCH disponible pour l’entrée individuelle. Valeur attendue : json-string/json-file/@json-file.

--job-storage-account

Propriétés associées à un compte de stockage Azure avec MSI.

Utilisation : --job-storage-account authentication-mode=XX account-name=XX account-key=XX

mode d’authentification : mode d’authentification. nom du compte : nom du compte de stockage Azure. Obligatoire sur les requêtes PUT (CreateOrReplace). clé de compte : clé de compte pour le compte stockage Azure. Obligatoire sur les requêtes PUT (CreateOrReplace).

--job-type

Décrit le type du travail. Les modes valides sont Cloud et « Edge ».

Propriété Valeur
Valeurs acceptées: Cloud, Edge
--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--order-max-delay

Délai maximal tolérable en secondes où les événements hors ordre peuvent être ajustés pour être de retour dans l’ordre.

--out-of-order-policy

Indique la stratégie à appliquer aux événements qui arrivent dans le flux d’événements d’entrée.

Propriété Valeur
Valeurs acceptées: Adjust, Drop
--output-error-policy

Indique la stratégie à appliquer aux événements qui arrivent à la sortie et ne peuvent pas être écrits dans le stockage externe en raison d’une mauvaise forme (valeurs de colonne manquantes, valeurs de colonne de type ou de taille incorrectes).

Propriété Valeur
Valeurs acceptées: Drop, Stop
--output-start-mode

Cette propriété ne doit être utilisée que lorsque vous souhaitez que le travail soit démarré immédiatement lors de la création. La valeur peut être JobStartTime, CustomTime ou LastOutputEventTime pour indiquer si le point de départ du flux d’événements de sortie doit démarrer chaque fois que le travail est démarré, démarrer à un horodatage utilisateur personnalisé spécifié via la propriété outputStartTime ou démarrer à partir de la dernière heure de sortie de l’événement.

Propriété Valeur
Valeurs acceptées: CustomTime, JobStartTime, LastOutputEventTime
--output-start-time

La valeur est soit un horodatage au format ISO-8601 qui indique le point de départ du flux d’événements de sortie, soit null pour indiquer que le flux d’événements de sortie démarre chaque fois que la tâche de diffusion en continu est démarrée. Cette propriété doit avoir une valeur si outputStartMode est défini sur CustomTime.

--outputs

Liste d’une ou de plusieurs sorties pour la tâche de diffusion en continu. La propriété name pour chaque sortie est requise lors de la spécification de cette propriété dans une requête PUT. Cette propriété ne peut pas être modifiable via une opération PATCH. Vous devez utiliser l’API PATCH disponible pour la sortie individuelle. Valeur attendue : json-string/json-file/@json-file.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--transformation

Indiquez la requête et le nombre d’unités de diffusion en continu à utiliser pour la tâche de diffusion en continu. La propriété name de la transformation est requise lors de la spécification de cette propriété dans une requête PUT. Cette propriété ne peut pas être modifiable via une opération PATCH. Vous devez utiliser l’API PATCH disponible pour la transformation individuelle.

Utilisation : --transformation streaming-units=XX valid-streaming-units=XX query=XX name=XX

streaming-units : spécifie le nombre d’unités de diffusion en continu que la tâche de diffusion en continu utilise. valid-streaming-units : spécifie les unités de diffusion en continu valides vers laquelle un travail de diffusion en continu peut être mis à l’échelle. requête : spécifie la requête qui sera exécutée dans la tâche de diffusion en continu. Vous pouvez en savoir plus sur le langage de requête Stream Analytics (SAQL) ici : https://msdn.microsoft.com/library/azure/dn834998 . Obligatoire sur les requêtes PUT (CreateOrReplace). nom : nom de la ressource.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az stream-analytics job wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition du travail stream-analytics soit remplie.

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

Exemples

Suspendre l’exécution de la ligne de script CLI suivante jusqu’à ce que le travail stream-analytics soit correctement créé.

az stream-analytics job wait --expand "inputs,outputs,transformation,functions" --job-name "sj7804" --resource-group "sjrg3276" --created

Suspendez l’exécution de la ligne de commande suivante du script CLI jusqu’à ce que le travail stream-analytics soit correctement supprimé.

az stream-analytics job wait --expand "inputs,outputs,transformation,functions" --job-name "sj7804" --resource-group "sjrg3276" --deleted

Paramètres obligatoires

--job-name --name -n

Nom du travail de diffusion en continu.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
--deleted

Attendez la suppression.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--exists

Attendez que la ressource existe.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--expand

Paramètre de requête OData $expand. Il s’agit d’une liste séparée par des virgules de propriétés de travail de streaming supplémentaires à inclure dans la réponse, au-delà du jeu par défaut retourné lorsque ce paramètre est absent. L’ensemble par défaut est toutes les propriétés de travail de diffusion en continu autres que « entrées », « transformation », « sorties » et « functions ».

--interval

Intervalle d’interrogation en secondes.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: 30
--timeout

Délai maximal d’attente en secondes.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False