az stream-analytics function
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 une az stream-analytics function commande. Apprenez-en davantage sur les extensions.
Gérer la fonction avec Stream Analytics.
Commandes
| Nom | Description | Type | État |
|---|---|---|---|
| az stream-analytics function create |
Créez une fonction ou remplace une fonction déjà existante sous un travail de streaming existant. |
Extension | GA |
| az stream-analytics function delete |
Supprimez une fonction du travail de streaming. |
Extension | GA |
| az stream-analytics function inspect |
Récupérez la définition par défaut d’une fonction en fonction des paramètres spécifiés. |
Extension | GA |
| az stream-analytics function list |
Répertorier toutes les fonctions sous le travail de diffusion en continu spécifié. |
Extension | GA |
| az stream-analytics function show |
Obtenez des détails sur la fonction spécifiée. |
Extension | GA |
| az stream-analytics function test |
Testez si les informations fournies pour une fonction sont valides. Cela peut aller du test de la connexion au service web sous-jacent derrière la fonction ou de s’assurer que le code de fonction fourni est correctement synchronisé. |
Extension | GA |
| az stream-analytics function update |
Mettez à jour une fonction existante sous un travail de streaming existant. Cela peut être utilisé pour mettre à jour partiellement (par exemple, mettre à jour une ou deux propriétés) une fonction sans affecter le reste de la définition du travail ou de la fonction. |
Extension | GA |
| az stream-analytics function wait |
Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de la fonction stream-analytics soit remplie. |
Extension | GA |
az stream-analytics function create
Créez une fonction ou remplace une fonction déjà existante sous un travail de streaming existant.
az stream-analytics function create --function-name --name
--job-name
--resource-group
[--if-match]
[--if-none-match]
[--properties]
Exemples
Créer une fonction JavaScript
az stream-analytics function create --properties "{\"type\":\"Scalar\",\"properties\":{\"binding\":{\"type\":\"Microsoft.StreamAnalytics/JavascriptUdf\",\"properties\":{\"script\":\"function (x, y) { return x + y; }\"}},\"inputs\":[{\"dataType\":\"Any\"}],\"output\":{\"dataType\":\"Any\"}}}" --function-name "function8197" --job-name "sj8653" --resource-group "sjrg1637"
Créer une fonction Azure ML
az stream-analytics function create --properties "{\"type\":\"Scalar\",\"properties\":{\"binding\":{\"type\":\"Microsoft.MachineLearning/WebService\",\"properties\":{\"apiKey\":\"someApiKey==\",\"batchSize\":1000,\"endpoint\":\"someAzureMLEndpointURL\",\"inputs\":{\"name\":\"input1\",\"columnNames\":[{\"name\":\"tweet\",\"dataType\":\"string\",\"mapTo\":0}]},\"outputs\":[{\"name\":\"Sentiment\",\"dataType\":\"string\"}]}},\"inputs\":[{\"dataType\":\"nvarchar(max)\"}],\"output\":{\"dataType\":\"nvarchar(max)\"}}}" --function-name "function588" --job-name "sj9093" --resource-group "sjrg7"
Paramètres obligatoires
Nom de la fonction.
Nom du travail de diffusion en continu.
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.
ETag de la fonction. Omettez cette valeur pour toujours remplacer la fonction actuelle. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.
Définissez la valeur « * » pour permettre la création d’une nouvelle fonction, mais pour empêcher la mise à jour d’une fonction existante. D’autres valeurs entraînent une réponse 412 en cas d’échec de la condition.
Propriétés associées à une fonction. Valeur attendue : json-string/json-file/@json-file.
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 function delete
Supprimez une fonction du travail de streaming.
az stream-analytics function delete --function-name --name
--job-name
--resource-group
[--yes]
Exemples
Supprimer une fonction
az stream-analytics function delete --name "function8197" --job-name "sj8653" --resource-group "sjrg1637"
Paramètres obligatoires
Nom de la fonction.
Nom du travail de diffusion en continu.
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.
N’invitez pas à confirmer.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 function inspect
Récupérez la définition par défaut d’une fonction en fonction des paramètres spécifiés.
az stream-analytics function inspect --function-name --name
--job-name
--resource-group
[--ml-properties]
Paramètres obligatoires
Nom de la fonction.
Nom du travail de diffusion en continu.
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.
Paramètres nécessaires pour récupérer la définition de fonction par défaut pour une fonction de service web Azure Machine Learning.
Utilisation : --ml-properties execute-endpoint=XX
execute-endpoint : Request-Response exécuter le point de terminaison du service web Azure Machine Learning. En savoir plus ici : https://docs.microsoft.com/en-us/azure/stream-analytics/machine-learning-udf.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | FunctionRetrieveDefaultDefinitionParameters Arguments |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 function list
Répertorier toutes les fonctions sous le travail de diffusion en continu spécifié.
az stream-analytics function list --job-name
--resource-group
[--select]
Exemples
Répertorier toutes les fonctions d’un travail de streaming
az stream-analytics function list --job-name "sj8653" --resource-group "sjrg1637"
Paramètres obligatoires
Nom du travail de diffusion en continu.
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.
Paramètre de requête OData $select. Il s’agit d’une liste séparée par des virgules des propriétés structurelles à inclure dans la réponse, ou «» pour inclure toutes les propriétés. Par défaut, toutes les propriétés sont retournées à l’exception des diagnostics. Actuellement, n’accepte '' comme valeur valide.
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 function show
Obtenez des détails sur la fonction spécifiée.
az stream-analytics function show --function-name --name
--job-name
--resource-group
Exemples
Obtenir une fonction JavaScript
az stream-analytics function show --name "function8197" --job-name "sj8653" --resource-group "sjrg1637"
Obtenir une fonction Azure ML
az stream-analytics function show --name "function588" --job-name "sj9093" --resource-group "sjrg7"
Paramètres obligatoires
Nom de la fonction.
Nom du travail de diffusion en continu.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 function test
Testez si les informations fournies pour une fonction sont valides. Cela peut aller du test de la connexion au service web sous-jacent derrière la fonction ou de s’assurer que le code de fonction fourni est correctement synchronisé.
az stream-analytics function test --function-name --name
--job-name
--resource-group
[--no-wait]
[--properties]
Exemples
Tester la connexion pour une fonction JavaScript
az stream-analytics function test --function-name "function8197" --job-name "sj8653" --resource-group "sjrg1637"
Tester la connexion pour une fonction Azure ML
az stream-analytics function test --function-name "function588" --job-name "sj9093" --resource-group "sjrg7"
Paramètres obligatoires
Nom de la fonction.
Nom du travail de diffusion en continu.
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.
Ne pas attendre la fin de l’opération de longue durée.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Propriétés associées à une fonction. Valeur attendue : json-string/json-file/@json-file.
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 function update
Mettez à jour une fonction existante sous un travail de streaming existant. Cela peut être utilisé pour mettre à jour partiellement (par exemple, mettre à jour une ou deux propriétés) une fonction sans affecter le reste de la définition du travail ou de la fonction.
az stream-analytics function update --function-name --name
--job-name
--resource-group
[--if-match]
[--properties]
Exemples
Mettre à jour une fonction JavaScript
az stream-analytics function update --properties "{\"type\":\"Scalar\",\"properties\":{\"binding\":{\"type\":\"Microsoft.StreamAnalytics/JavascriptUdf\",\"properties\":{\"script\":\"function (a, b) { return a * b; }\"}}}}" --function-name "function8197" --job-name "sj8653" --resource-group "sjrg1637"
Mettre à jour une fonction Azure ML
az stream-analytics function update --properties "{\"type\":\"Scalar\",\"properties\":{\"binding\":{\"type\":\"Microsoft.MachineLearning/WebService\",\"properties\":{\"batchSize\":5000}}}}" --function-name "function588" --job-name "sj9093" --resource-group "sjrg7"
Paramètres obligatoires
Nom de la fonction.
Nom du travail de diffusion en continu.
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.
ETag de la fonction. Omettez cette valeur pour toujours remplacer la fonction actuelle. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.
Propriétés associées à une fonction. Valeur attendue : json-string/json-file/@json-file.
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 function wait
Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de la fonction stream-analytics soit remplie.
az stream-analytics function wait --function-name --name
--job-name
--resource-group
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
Exemples
Suspendre l’exécution de la ligne de script CLI suivante jusqu’à ce que la fonction stream-analytics soit créée.
az stream-analytics function wait --name "function588" --job-name "sj9093" --resource-group "sjrg7" --created
Paramètres obligatoires
Nom de la fonction.
Nom du travail de diffusion en continu.
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.
Attendez la création avec « provisioningState » sur « Succeeded ».
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Wait Condition Arguments |
| Valeur par défaut: | False |
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 |
Attendez la suppression.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Wait Condition Arguments |
| Valeur par défaut: | False |
Attendez que la ressource existe.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Wait Condition Arguments |
| Valeur par défaut: | False |
Intervalle d’interrogation en secondes.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Wait Condition Arguments |
| Valeur par défaut: | 30 |
Délai maximal d’attente en secondes.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Wait Condition Arguments |
| Valeur par défaut: | 3600 |
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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 |