az stream-analytics job

Remarque

Cette référence fait partie de l’extension Stream-Analytics pour Azure CLI (version 2.15.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande de travail az stream-analytics. En savoir plus sur les extensions.

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

Commandes

Nom	Description	Type	Statut
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
                               --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 de la tâche de streaming.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--arrival-max-delay

Délai maximal acceptable en secondes pendant lequel les événements arrivant en retard peuvent être inclus. La plage prise en charge est comprise entre -1 et 1814399 (20.23:59:59 jours) et -1 est utilisé pour spécifier d’attendre 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 de la tâche de streaming.

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

valeurs acceptées: JobStorageAccount, SystemAccount

--data-locale

Paramètres régionaux des données de la tâche 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 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.

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

valeurs acceptées: Cloud, Edge

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--no-wait

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

valeur par défaut: False

--order-max-delay

Délai maximal acceptable en secondes pendant lequel les événements en désordre peuvent être ajustés pour être restaurés dans l’ordre.

--out-of-order-policy

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

valeurs acceptées: Adjust, Drop

--output-error-policy

Indique la stratégie à appliquer aux événements qui arrivent à la sortie et qui ne peuvent pas être écrits dans le stockage externe en raison d’une constitution inappropriée (valeurs de colonne manquantes ou avec une taille ou un type incorrect).

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.

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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az stream-analytics job delete

Supprimez un travail de diffusion en continu.

az stream-analytics job delete --job-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 de la tâche de streaming.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

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

valeur par défaut: False

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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

--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 en utilisant az configure --defaults group=<name>.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                              --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 de la tâche de streaming.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

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

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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                             --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 de la tâche de streaming.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                              --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 de la tâche de streaming.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

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

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.

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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                             --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 de la tâche de streaming.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

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

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                               --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 de la tâche de streaming.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--arrival-max-delay

Délai maximal acceptable en secondes pendant lequel les événements arrivant en retard peuvent être inclus. La plage prise en charge est comprise entre -1 et 1814399 (20.23:59:59 jours) et -1 est utilisé pour spécifier d’attendre 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 de la tâche de streaming.

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

valeurs acceptées: JobStorageAccount, SystemAccount

--data-locale

Paramètres régionaux des données de la tâche 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 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.

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

valeurs acceptées: Cloud, Edge

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--order-max-delay

Délai maximal acceptable en secondes pendant lequel les événements en désordre peuvent être ajustés pour être restaurés dans l’ordre.

--out-of-order-policy

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

valeurs acceptées: Adjust, Drop

--output-error-policy

Indique la stratégie à appliquer aux événements qui arrivent à la sortie et qui ne peuvent pas être écrits dans le stockage externe en raison d’une constitution inappropriée (valeurs de colonne manquantes ou avec une taille ou un type incorrect).

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.

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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                             --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 de la tâche de streaming.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--created

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

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

--deleted

Attendez la suppression.

valeur par défaut: False

--exists

Attendez que la ressource existe.

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.

valeur par défaut: 30

--timeout

Délai maximal d’attente en secondes.

valeur par défaut: 3600

--updated

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

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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