az stream-analytics function

Note

Questo riferimento fa parte dell'estensione analisi di flusso per l'interfaccia della riga di comando di Azure (versione 2.75.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	Status
az stream-analytics function create	Creare una funzione o sostituire una funzione già esistente in un processo di streaming esistente.	Extension	GA
az stream-analytics function delete	Eliminare una funzione dal processo di streaming.	Extension	GA
az stream-analytics function inspect	Recuperare la definizione predefinita di una funzione in base ai parametri specificati.	Extension	GA
az stream-analytics function list	Elencare tutte le funzioni nel processo di streaming specificato.	Extension	GA
az stream-analytics function show	Ottenere informazioni dettagliate sulla funzione specificata.	Extension	GA
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.	Extension	GA
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.	Extension	GA
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.	Extension	GA

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

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

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az stream-analytics function delete

Eliminare una funzione dal processo di streaming.

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

Esempio

Elimina 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 usando az configure --defaults group=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--yes -y

Non richiedere conferma.

Proprietà	Valore
Valore predefinito:	False

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az stream-analytics function inspect

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

az stream-analytics function inspect --function-name --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 usando az configure --defaults group=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--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: l'endpoint Request-Response eseguire il servizio Web di Azure Machine Learning. Altre informazioni sono disponibili qui: https://docs.microsoft.com/en-us/azure/stream-analytics/machine-learning-udf.

Proprietà	Valore
Gruppo di parametri:	FunctionRetrieveDefaultDefinitionParameters Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

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

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az stream-analytics function show

Ottenere informazioni dettagliate sulla funzione specificata.

az stream-analytics function show --function-name --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 usando az configure --defaults group=<name>.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà	Valore
Valore predefinito:	False

--properties

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

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

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

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--created

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

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments
Valore predefinito:	False

--custom

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

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments

--deleted

Attendere l'eliminazione.

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments
Valore predefinito:	False

--exists

Attendere che la risorsa esista.

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments
Valore predefinito:	False

--interval

Intervallo di polling in secondi.

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments
Valore predefinito:	30

--timeout

Attesa massima in secondi.

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments
Valore predefinito:	3600

--updated

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

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments
Valore predefinito:	False

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False