Share via

az stream-analytics function

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione analisi di flusso per l'interfaccia della riga di comando di Azure (versione 2.15.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az stream-analytics function . Altre informazioni sulle estensioni.

Gestire la funzione con l'analisi di flusso.

Comandi

Nome Descrizione Tipo Stato
az stream-analytics function create

Creare una funzione o sostituire una funzione già esistente in un processo di streaming esistente.

 Estensione Disponibilità generale
az stream-analytics function delete

Eliminare una funzione dal processo di streaming.

 Estensione Disponibilità generale
az stream-analytics function inspect

Recuperare la definizione predefinita di una funzione in base ai parametri specificati.

 Estensione Disponibilità generale
az stream-analytics function list

Elencare tutte le funzioni nel processo di streaming specificato.

 Estensione Disponibilità generale
az stream-analytics function show

Ottenere informazioni dettagliate sulla funzione specificata.

 Estensione Disponibilità generale
az stream-analytics function test

Verificare se le informazioni fornite per una funzione sono valide. Ciò può variare dal test della connessione al servizio Web sottostante alla funzione o dalla verifica che il codice della funzione fornito sia sintatticamente corretto.

 Estensione Disponibilità generale
az stream-analytics function update

Aggiornare una funzione esistente in un processo di streaming esistente. Può essere usato per aggiornare parzialmente (ad esempio, aggiornare una o due proprietà) una funzione senza influire sul resto del processo o della definizione di funzione.

 Estensione Disponibilità generale
az stream-analytics function wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione della funzione di analisi di flusso.

 Estensione Disponibilità generale

az stream-analytics function create

Creare una funzione o sostituire una funzione già esistente in un processo di streaming esistente.

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

Esempio

Creare una funzione 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"

Creare una funzione di 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"

Parametri necessari

--function-name --name -n

Nome della funzione.

--job-name

Nome del processo di streaming.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--if-match

ETag della funzione. Omettere questo valore per sovrascrivere sempre la funzione corrente. Specificare l'ultimo valore ETag visualizzato per impedire la sovrascrittura accidentale delle modifiche simultanee.

--if-none-match

Impostare su '*' per consentire la creazione di una nuova funzione, ma per impedire l'aggiornamento di una funzione esistente. Gli altri valori generano una risposta 412 Pre-condition Failed.

--properties

Proprietà associate a una funzione. Valore previsto: json-string/json-file/@json-file.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az stream-analytics function delete

Eliminare una funzione dal processo di streaming.

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

Esempio

Eliminare una funzione

az stream-analytics function delete --name "function8197" --job-name "sj8653" --resource-group "sjrg1637"

Parametri necessari

--function-name --name -n

Nome della funzione.

--job-name

Nome del processo di streaming.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az stream-analytics function inspect

Recuperare la definizione predefinita di una funzione in base ai parametri specificati.

az stream-analytics function inspect --function-name
                                     --job-name
                                     --resource-group
                                     [--ml-properties]

Parametri necessari

--function-name --name -n

Nome della funzione.

--job-name

Nome del processo di streaming.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--ml-properties

Parametri necessari per recuperare la definizione di funzione predefinita per una funzione del servizio Web di Azure Machine Learning.

Utilizzo: --ml-properties execute-endpoint=XX

execute-endpoint: endpoint di esecuzione Request-Response del servizio Web di Azure Machine Learning. Altre informazioni sono disponibili qui: https://docs.microsoft.com/en-us/azure/stream-analytics/machine-learning-udf.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az stream-analytics function list

Elencare tutte le funzioni nel processo di streaming specificato.

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

Esempio

Elencare tutte le funzioni in un processo di streaming

az stream-analytics function list --job-name "sj8653" --resource-group "sjrg1637"

Parametri necessari

--job-name

Nome del processo di streaming.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--select

Parametro di query OData $select. Si tratta di un elenco delimitato da virgole di proprietà strutturali da includere nella risposta o "" per includere tutte le proprietà. Per impostazione predefinita, vengono restituite tutte le proprietà tranne la diagnostica. Attualmente accetta solo '' come valore valido.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az stream-analytics function show

Ottenere informazioni dettagliate sulla funzione specificata.

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

Esempio

Ottenere una funzione JavaScript

az stream-analytics function show --name "function8197" --job-name "sj8653" --resource-group "sjrg1637"

Ottenere una funzione di Azure ML

az stream-analytics function show --name "function588" --job-name "sj9093" --resource-group "sjrg7"

Parametri necessari

--function-name --name -n

Nome della funzione.

--job-name

Nome del processo di streaming.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az stream-analytics function test

Verificare se le informazioni fornite per una funzione sono valide. Ciò può variare dal test della connessione al servizio Web sottostante alla funzione o dalla verifica che il codice della funzione fornito sia sintatticamente corretto.

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

Esempio

Testare la connessione per una funzione JavaScript

az stream-analytics function test --function-name "function8197" --job-name "sj8653" --resource-group "sjrg1637"

Testare la connessione per una funzione di Azure ML

az stream-analytics function test --function-name "function588" --job-name "sj9093" --resource-group "sjrg7"

Parametri necessari

--function-name --name -n

Nome della funzione.

--job-name

Nome del processo di streaming.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valore predefinito: False
--properties

Proprietà associate a una funzione. Valore previsto: json-string/json-file/@json-file.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az stream-analytics function update

Aggiornare una funzione esistente in un processo di streaming esistente. Può essere usato per aggiornare parzialmente (ad esempio, aggiornare una o due proprietà) una funzione senza influire sul resto del processo o della definizione di funzione.

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

Esempio

Aggiornare una funzione 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"

Aggiornare una funzione di 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"

Parametri necessari

--function-name --name -n

Nome della funzione.

--job-name

Nome del processo di streaming.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--if-match

ETag della funzione. Omettere questo valore per sovrascrivere sempre la funzione corrente. Specificare l'ultimo valore ETag visualizzato per impedire la sovrascrittura accidentale delle modifiche simultanee.

--properties

Proprietà associate a una funzione. Valore previsto: json-string/json-file/@json-file.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az stream-analytics function wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione della funzione di analisi di flusso.

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

Esempio

Sospendere l'esecuzione della riga di comando successiva dello script dell'interfaccia della riga di comando fino a quando non viene creata correttamente la funzione di analisi di flusso.

az stream-analytics function wait --name "function588" --job-name "sj9093" --resource-group "sjrg7" --created

Parametri necessari

--function-name --name -n

Nome della funzione.

--job-name

Nome del processo di streaming.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

valore predefinito: False
--exists

Attendere che la risorsa esista.

valore predefinito: False
--interval

Intervallo di polling in secondi.

valore predefinito: 30
--timeout

Attesa massima in secondi.

valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.