Udostępnij przez

az stream-analytics function

Note

Ta dokumentacja jest częścią rozszerzenia stream-analytics dla interfejsu wiersza polecenia platformy Azure (wersja 2.75.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az stream-analytics function. Dowiedz się więcej o rozszerzeniach.

Zarządzanie funkcją za pomocą usługi Stream Analytics.

Polecenia

Nazwa Opis Typ Stan
az stream-analytics function create

Utwórz funkcję lub zastępuje już istniejącą funkcję w ramach istniejącego zadania przesyłania strumieniowego.

 Extension ogólna dostępność
az stream-analytics function delete

Usuń funkcję z zadania przesyłania strumieniowego.

 Extension ogólna dostępność
az stream-analytics function inspect

Pobierz domyślną definicję funkcji na podstawie określonych parametrów.

 Extension ogólna dostępność
az stream-analytics function list

Wyświetl listę wszystkich funkcji w ramach określonego zadania przesyłania strumieniowego.

 Extension ogólna dostępność
az stream-analytics function show

Uzyskaj szczegółowe informacje o określonej funkcji.

 Extension ogólna dostępność
az stream-analytics function test

Sprawdź, czy informacje podane dla funkcji są prawidłowe. Może to obejmować testowanie połączenia z podstawową usługą internetową za funkcją lub upewnienie się, że podany kod funkcji jest syntaktycznie poprawny.

 Extension ogólna dostępność
az stream-analytics function update

Zaktualizuj istniejącą funkcję w ramach istniejącego zadania przesyłania strumieniowego. Może to służyć do częściowej aktualizacji (tj. zaktualizowania jednej lub dwóch właściwości) funkcji bez wpływu na pozostałe zadanie lub definicję funkcji.

 Extension ogólna dostępność
az stream-analytics function wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku funkcji stream-analytics.

 Extension ogólna dostępność

az stream-analytics function create

Utwórz funkcję lub zastępuje już istniejącą funkcję w ramach istniejącego zadania przesyłania strumieniowego.

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

Przykłady

Tworzenie funkcji Języka 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"

Tworzenie funkcji usługi 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"

Parametry wymagane

--function-name --name -n

Nazwa funkcji.

--job-name

Nazwa zadania przesyłania strumieniowego.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--if-match

Element ETag funkcji. Pomiń tę wartość, aby zawsze zastąpić bieżącą funkcję. Określ ostatnio widzianą wartość elementu ETag, aby zapobiec przypadkowemu zastępowaniu współbieżnych zmian.

--if-none-match

Ustaw wartość "*", aby zezwolić na utworzenie nowej funkcji, ale aby zapobiec aktualizowaniu istniejącej funkcji. Inne wartości spowodują odpowiedź 412 Warunek wstępny Niepowodzenie.

--properties

Właściwości skojarzone z funkcją. Oczekiwana wartość: json-string/json-file/@json-file.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az stream-analytics function delete

Usuń funkcję z zadania przesyłania strumieniowego.

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

Przykłady

Usuwanie funkcji

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

Parametry wymagane

--function-name --name -n

Nazwa funkcji.

--job-name

Nazwa zadania przesyłania strumieniowego.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--yes -y

Nie monituj o potwierdzenie.

Właściwość Wartość
Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az stream-analytics function inspect

Pobierz domyślną definicję funkcji na podstawie określonych parametrów.

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

Parametry wymagane

--function-name --name -n

Nazwa funkcji.

--job-name

Nazwa zadania przesyłania strumieniowego.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--ml-properties

Parametry potrzebne do pobrania domyślnej definicji funkcji usługi internetowej Azure Machine Learning.

Użycie: --ml-properties execute-endpoint=XX

execute-endpoint: Request-Response wykonać punkt końcowy usługi internetowej Azure Machine Learning. Dowiedz się więcej tutaj: https://docs.microsoft.com/en-us/azure/stream-analytics/machine-learning-udf.

Właściwość Wartość
Grupa parametrów: FunctionRetrieveDefaultDefinitionParameters Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az stream-analytics function list

Wyświetl listę wszystkich funkcji w ramach określonego zadania przesyłania strumieniowego.

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

Przykłady

Wyświetlanie listy wszystkich funkcji w zadaniu przesyłania strumieniowego

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

Parametry wymagane

--job-name

Nazwa zadania przesyłania strumieniowego.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--select

Parametr zapytania OData $select. Jest to rozdzielona przecinkami lista właściwości strukturalnych do uwzględnienia w odpowiedzi lub "" w celu uwzględnienia wszystkich właściwości. Domyślnie wszystkie właściwości są zwracane z wyjątkiem diagnostyki. Obecnie akceptuje tylko wartość "" jako prawidłową wartość.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az stream-analytics function show

Uzyskaj szczegółowe informacje o określonej funkcji.

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

Przykłady

Uzyskiwanie funkcji Języka JavaScript

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

Uzyskiwanie funkcji usługi Azure ML

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

Parametry wymagane

--function-name --name -n

Nazwa funkcji.

--job-name

Nazwa zadania przesyłania strumieniowego.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az stream-analytics function test

Sprawdź, czy informacje podane dla funkcji są prawidłowe. Może to obejmować testowanie połączenia z podstawową usługą internetową za funkcją lub upewnienie się, że podany kod funkcji jest syntaktycznie poprawny.

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

Przykłady

Testowanie połączenia dla funkcji JavaScript

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

Testowanie połączenia dla funkcji usługi Azure ML

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

Parametry wymagane

--function-name --name -n

Nazwa funkcji.

--job-name

Nazwa zadania przesyłania strumieniowego.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Właściwość Wartość
Domyślna wartość: False
--properties

Właściwości skojarzone z funkcją. Oczekiwana wartość: json-string/json-file/@json-file.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az stream-analytics function update

Zaktualizuj istniejącą funkcję w ramach istniejącego zadania przesyłania strumieniowego. Może to służyć do częściowej aktualizacji (tj. zaktualizowania jednej lub dwóch właściwości) funkcji bez wpływu na pozostałe zadanie lub definicję funkcji.

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

Przykłady

Aktualizowanie funkcji Języka 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"

Aktualizowanie funkcji usługi 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"

Parametry wymagane

--function-name --name -n

Nazwa funkcji.

--job-name

Nazwa zadania przesyłania strumieniowego.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--if-match

Element ETag funkcji. Pomiń tę wartość, aby zawsze zastąpić bieżącą funkcję. Określ ostatnio widzianą wartość elementu ETag, aby zapobiec przypadkowemu zastępowaniu współbieżnych zmian.

--properties

Właściwości skojarzone z funkcją. Oczekiwana wartość: json-string/json-file/@json-file.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az stream-analytics function wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku funkcji stream-analytics.

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

Przykłady

Wstrzymaj wykonywanie następnego wiersza polecenia skryptu interfejsu wiersza polecenia do momentu pomyślnego utworzenia funkcji stream-analytics.

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

Parametry wymagane

--function-name --name -n

Nazwa funkcji.

--job-name

Nazwa zadania przesyłania strumieniowego.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--created

Zaczekaj na utworzenie polecenia "provisioningState" o godzinie "Succeeded".

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: False
--custom

Poczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Np. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
--deleted

Poczekaj na usunięcie.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: False
--exists

Zaczekaj, aż zasób istnieje.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: False
--interval

Interwał sondowania w sekundach.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: 30
--timeout

Maksymalny czas oczekiwania w sekundach.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: 3600
--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False