az stream-analytics input

  • 참조

참고 항목

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

스트림 분석을 사용하여 입력을 관리합니다.

명령

Name Description 형식 상태
az stream-analytics input create

기존 스트리밍 작업에서 입력을 만들거나 기존 입력을 대체합니다.

 내선 번호 GA
az stream-analytics input delete

스트리밍 작업에서 입력을 삭제합니다.

 내선 번호 GA
az stream-analytics input list

지정된 스트리밍 작업 아래에 있는 모든 입력을 나열합니다.

 내선 번호 GA
az stream-analytics input show

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

 내선 번호 GA
az stream-analytics input test

Azure Stream Analytics 서비스에서 입력의 데이터 원본에 연결할 수 있고 사용할 수 있는지 테스트합니다.

 내선 번호 GA
az stream-analytics input update

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

 내선 번호 GA
az stream-analytics input wait

stream-analytics 입력 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

 내선 번호 GA

az stream-analytics input create

기존 스트리밍 작업에서 입력을 만들거나 기존 입력을 대체합니다.

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

예제

CSV serialization을 사용하여 참조 Blob 입력 만들기

az stream-analytics input create --properties "{\"type\":\"Reference\",\"datasource\":{\"type\":\"Microsoft.Storage/Blob\",\"properties\":{\"container\":\"state\",\"dateFormat\":\"yyyy/MM/dd\",\"pathPattern\":\"{date}/{time}\",\"storageAccounts\":[{\"accountKey\":\"someAccountKey==\",\"accountName\":\"someAccountName\"}],\"timeFormat\":\"HH\"}},\"serialization\":{\"type\":\"Csv\",\"properties\":{\"encoding\":\"UTF8\",\"fieldDelimiter\":\",\"}}}" --input-name "input7225" --job-name "sj9597" --resource-group "sjrg8440"

JSON serialization을 사용하여 스트림 이벤트 허브 입력 만들기

az stream-analytics input create --properties "{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.ServiceBus/EventHub\",\"properties\":{\"consumerGroupName\":\"sdkconsumergroup\",\"eventHubName\":\"sdkeventhub\",\"serviceBusNamespace\":\"sdktest\",\"sharedAccessPolicyKey\":\"someSharedAccessPolicyKey==\",\"sharedAccessPolicyName\":\"RootManageSharedAccessKey\"}},\"serialization\":{\"type\":\"Json\",\"properties\":{\"encoding\":\"UTF8\"}}}" --input-name "input7425" --job-name "sj197" --resource-group "sjrg3139"

Avro serialization을 사용하여 스트림 IoT Hub 입력 만들기

az stream-analytics input create --properties "{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.Devices/IotHubs\",\"properties\":{\"consumerGroupName\":\"sdkconsumergroup\",\"endpoint\":\"messages/events\",\"iotHubNamespace\":\"iothub\",\"sharedAccessPolicyKey\":\"sharedAccessPolicyKey=\",\"sharedAccessPolicyName\":\"owner\"}},\"serialization\":{\"type\":\"Avro\"}}" --input-name "input7970" --job-name "sj9742" --resource-group "sjrg3467"

CSV serialization을 사용하여 스트림 Blob 입력 만들기

az stream-analytics input create --properties "{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.Storage/Blob\",\"properties\":{\"container\":\"state\",\"dateFormat\":\"yyyy/MM/dd\",\"pathPattern\":\"{date}/{time}\",\"sourcePartitionCount\":16,\"storageAccounts\":[{\"accountKey\":\"someAccountKey==\",\"accountName\":\"someAccountName\"}],\"timeFormat\":\"HH\"}},\"serialization\":{\"type\":\"Csv\",\"properties\":{\"encoding\":\"UTF8\",\"fieldDelimiter\":\",\"}}}" --input-name "input8899" --job-name "sj6695" --resource-group "sjrg8161"

필수 매개 변수

--input-name --name -n

입력의 이름입니다.

--job-name

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

--resource-group -g

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

선택적 매개 변수

--if-match

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

--if-none-match

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

--properties

입력과 연결된 속성입니다. PUT(CreateOrReplace) 요청에 필요합니다. 예상 값: json-string/json-file/@json-file.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

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

az stream-analytics input delete

스트리밍 작업에서 입력을 삭제합니다.

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

예제

입력 삭제

az stream-analytics input delete --input-name "input7225" --job-name "sj9597" --resource-group "sjrg8440"

필수 매개 변수

--input-name --name -n

입력의 이름입니다.

--job-name

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

--resource-group -g

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

선택적 매개 변수

--yes -y

확인 메시지를 표시하지 않습니다.

기본값: False
전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

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

az stream-analytics input list

지정된 스트리밍 작업 아래에 있는 모든 입력을 나열합니다.

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

예제

스트리밍 작업의 모든 입력 나열

az stream-analytics input list --job-name "sj9597" --resource-group "sjrg8440"

스트리밍 작업의 모든 입력을 나열하고 $select OData 쿼리 매개 변수를 사용하여 진단 정보를 포함합니다.

az stream-analytics input list --select "*" --job-name "sj7804" --resource-group "sjrg3276"

필수 매개 변수

--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
기본값: json
--query

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

--subscription

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

--verbose

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

az stream-analytics input show

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

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

예제

CSV serialization을 사용하여 참조 Blob 입력 가져오기

az stream-analytics input show --input-name "input7225" --job-name "sj9597" --resource-group "sjrg8440"

JSON serialization을 사용하여 스트림 이벤트 허브 입력 가져오기

az stream-analytics input show --input-name "input7425" --job-name "sj197" --resource-group "sjrg3139"

Avro serialization을 사용하여 스트림 IoT Hub 입력 가져오기

az stream-analytics input show --input-name "input7970" --job-name "sj9742" --resource-group "sjrg3467"

CSV serialization을 사용하여 스트림 Blob 입력 가져오기

az stream-analytics input show --input-name "input8899" --job-name "sj6695" --resource-group "sjrg8161"

필수 매개 변수

--input-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
기본값: json
--query

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

--subscription

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

--verbose

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

az stream-analytics input test

Azure Stream Analytics 서비스에서 입력의 데이터 원본에 연결할 수 있고 사용할 수 있는지 테스트합니다.

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

예제

입력에 대한 연결 테스트

az stream-analytics input test --input-name "input7225" --job-name "sj9597" --resource-group "sjrg8440"

필수 매개 변수

--input-name --name -n

입력의 이름입니다.

--job-name

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

--resource-group -g

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

선택적 매개 변수

--no-wait

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

기본값: False
--properties

입력과 연결된 속성입니다. PUT(CreateOrReplace) 요청에 필요합니다. 예상 값: json-string/json-file/@json-file.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

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

az stream-analytics input update

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

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

예제

참조 Blob 입력 업데이트

az stream-analytics input update --properties "{\"type\":\"Reference\",\"datasource\":{\"type\":\"Microsoft.Storage/Blob\",\"properties\":{\"container\":\"differentContainer\"}},\"serialization\":{\"type\":\"Csv\",\"properties\":{\"encoding\":\"UTF8\",\"fieldDelimiter\":\"|\"}}}" --input-name "input7225" --job-name "sj9597" --resource-group "sjrg8440"

스트림 이벤트 허브 입력 업데이트

az stream-analytics input update --properties "{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.ServiceBus/EventHub\",\"properties\":{\"consumerGroupName\":\"differentConsumerGroupName\"}},\"serialization\":{\"type\":\"Avro\"}}" --input-name "input7425" --job-name "sj197" --resource-group "sjrg3139"

스트림 IoT Hub 입력 업데이트

az stream-analytics input update --properties "{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.Devices/IotHubs\",\"properties\":{\"endpoint\":\"messages/operationsMonitoringEvents\"}},\"serialization\":{\"type\":\"Csv\",\"properties\":{\"encoding\":\"UTF8\",\"fieldDelimiter\":\"|\"}}}" --input-name "input7970" --job-name "sj9742" --resource-group "sjrg3467"

스트림 Blob 입력 업데이트

az stream-analytics input update --properties "{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.Storage/Blob\",\"properties\":{\"sourcePartitionCount\":32}},\"serialization\":{\"type\":\"Csv\",\"properties\":{\"encoding\":\"UTF8\",\"fieldDelimiter\":\"|\"}}}" --input-name "input8899" --job-name "sj6695" --resource-group "sjrg8161"

필수 매개 변수

--input-name --name -n

입력의 이름입니다.

--job-name

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

--resource-group -g

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

선택적 매개 변수

--if-match

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

--properties

입력과 연결된 속성입니다. PUT(CreateOrReplace) 요청에 필요합니다. 예상 값: json-string/json-file/@json-file.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

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

az stream-analytics input wait

stream-analytics 입력 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

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

예제

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

az stream-analytics input wait --input-name "input8899" --job-name "sj6695" --resource-group "sjrg8161" --created

필수 매개 변수

--input-name --name -n

입력의 이름입니다.

--job-name

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

--resource-group -g

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

선택적 매개 변수

--created

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

기본값: False
--custom

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

--deleted

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

기본값: False
--exists

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

기본값: False
--interval

폴링 간격(초)입니다.

기본값: 30
--timeout

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

기본값: 3600
--updated

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

기본값: False
전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

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