az stream-analytics function

참고 항목

이 참조는 Azure CLI(버전 2.15.0 이상)에 대한 스트림 분석 확장의 일부입니다. az stream-analytics 함수 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

스트림 분석을 사용하여 함수를 관리합니다.

명령

Name	Description	형식	상태
az stream-analytics function create	함수를 만들거나 기존 스트리밍 작업에서 기존 함수를 대체합니다.	내선 번호	GA
az stream-analytics function delete	스트리밍 작업에서 함수를 삭제합니다.	내선 번호	GA
az stream-analytics function inspect	지정된 매개 변수를 기반으로 함수의 기본 정의를 검색합니다.	내선 번호	GA
az stream-analytics function list	지정된 스트리밍 작업 아래에 있는 모든 함수를 나열합니다.	내선 번호	GA
az stream-analytics function show	지정된 함수에 대한 세부 정보를 가져옵니다.	내선 번호	GA
az stream-analytics function test	함수에 제공된 정보가 유효한지 테스트합니다. 이 범위는 함수 뒤에 있는 기본 웹 서비스에 대한 연결을 테스트하거나 제공된 함수 코드가 구문적으로 올바른지 확인하는 것까지 다양합니다.	내선 번호	GA
az stream-analytics function update	기존 스트리밍 작업에서 기존 함수를 업데이트합니다. 나머지 작업 또는 함수 정의에 영향을 주지 않고 함수를 부분적으로 업데이트(예: 하나 또는 두 개의 속성 업데이트)하는 데 사용할 수 있습니다.	내선 번호	GA
az stream-analytics function wait	stream-analytics 함수의 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.	내선 번호	GA

az stream-analytics function create

함수를 만들거나 기존 스트리밍 작업에서 기존 함수를 대체합니다.

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

예제

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"

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"

필수 매개 변수

--function-name --name -n

함수의 이름.

--job-name

스트리밍 작업의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--if-match

함수의 ETag입니다. 현재 함수를 항상 덮어쓰려면 이 값을 생략합니다. 실수로 동시 변경 내용을 덮어쓰지 않도록 마지막으로 본 ETag 값을 지정합니다.

--if-none-match

새 함수를 만들 수 있지만 기존 함수를 업데이트하지 않도록 하려면 '*'로 설정합니다. 다른 값으로 인해 412 사전 조건 실패 응답이 발생합니다.

--properties

함수와 연결된 속성입니다. 예상 값: json-string/json-file/@json-file.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az stream-analytics function delete

스트리밍 작업에서 함수를 삭제합니다.

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

예제

함수 삭제

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

필수 매개 변수

--function-name --name -n

함수의 이름.

--job-name

스트리밍 작업의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

Default value: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az stream-analytics function inspect

지정된 매개 변수를 기반으로 함수의 기본 정의를 검색합니다.

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

필수 매개 변수

--function-name --name -n

함수의 이름.

--job-name

스트리밍 작업의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--ml-properties

Azure Machine Learning 웹 서비스 함수에 대한 기본 함수 정의를 검색하는 데 필요한 매개 변수입니다.

사용: --ml-properties execute-endpoint=XX

execute-endpoint: 요청-응답은 Azure Machine Learning 웹 서비스의 엔드포인트를 실행합니다. 자세한 내용은 다음을 참조하세요 https://docs.microsoft.com/en-us/azure/stream-analytics/machine-learning-udf.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az stream-analytics function list

지정된 스트리밍 작업 아래에 있는 모든 함수를 나열합니다.

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

예제

스트리밍 작업의 모든 함수 나열

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

필수 매개 변수

--job-name

스트리밍 작업의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--select

$select OData 쿼리 매개 변수입니다. 응답에 포함할 구조적 속성의 쉼표로 구분된 목록이거나 모든 속성을 포함하는 ""입니다. 기본적으로 진단을 제외한 모든 속성이 반환됩니다. 현재는 ''만 유효한 값으로 허용합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az stream-analytics function show

지정된 함수에 대한 세부 정보를 가져옵니다.

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

예제

JavaScript 함수 가져오기

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

Azure ML 함수 가져오기

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

필수 매개 변수

--function-name --name -n

함수의 이름.

--job-name

스트리밍 작업의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az stream-analytics function test

함수에 제공된 정보가 유효한지 테스트합니다. 이 범위는 함수 뒤에 있는 기본 웹 서비스에 대한 연결을 테스트하거나 제공된 함수 코드가 구문적으로 올바른지 확인하는 것까지 다양합니다.

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

예제

JavaScript 함수에 대한 연결 테스트

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

Azure ML 함수에 대한 연결 테스트

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

필수 매개 변수

--function-name --name -n

함수의 이름.

--job-name

스트리밍 작업의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False

--properties

함수와 연결된 속성입니다. 예상 값: json-string/json-file/@json-file.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az stream-analytics function update

기존 스트리밍 작업에서 기존 함수를 업데이트합니다. 나머지 작업 또는 함수 정의에 영향을 주지 않고 함수를 부분적으로 업데이트(예: 하나 또는 두 개의 속성 업데이트)하는 데 사용할 수 있습니다.

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

예제

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"

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"

필수 매개 변수

--function-name --name -n

함수의 이름.

--job-name

스트리밍 작업의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--if-match

함수의 ETag입니다. 현재 함수를 항상 덮어쓰려면 이 값을 생략합니다. 실수로 동시 변경 내용을 덮어쓰지 않도록 마지막으로 본 ETag 값을 지정합니다.

--properties

함수와 연결된 속성입니다. 예상 값: json-string/json-file/@json-file.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az stream-analytics function wait

stream-analytics 함수의 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

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

예제

stream-analytics 함수가 성공적으로 생성될 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

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

필수 매개 변수

--function-name --name -n

함수의 이름.

--job-name

스트리밍 작업의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

Default value: False

--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

Default value: False

--exists

리소스가 존재할 때까지 기다립니다.

Default value: False

--interval

폴링 간격(초)입니다.

Default value: 30

--timeout

최대 대기 시간(초)입니다.

Default value: 3600

--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.

Default value: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.