다음을 통해 공유


az iot ops schema

참고 항목

이 참조는 Azure CLI(버전 2.53.0 이상)에 대한 azure-iot-ops 확장의 일부입니다. az iot ops 스키마 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

이 명령 그룹은 미리 보기 상태이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

스키마 및 레지스트리 관리.

스키마는 처리 및 컨텍스트화를 사용하도록 설정하는 데이터를 설명하는 문서입니다. 메시지 스키마는 메시지의 형식과 해당 내용을 설명합니다. 스키마를 만들고 관리하려면 스키마 레지스트리가 필요합니다.

명령

Name Description 형식 상태
az iot ops schema create

스키마 레지스트리 내에 스키마를 만듭니다.

내선 번호 프리뷰
az iot ops schema delete

스키마 레지스트리 내에서 대상 스키마를 삭제합니다.

내선 번호 프리뷰
az iot ops schema list

스키마 레지스트리 내의 스키마를 나열합니다.

내선 번호 프리뷰
az iot ops schema registry

스키마 레지스트리 관리.

내선 번호 프리뷰
az iot ops schema registry create

스키마 레지스트리를 만듭니다.

내선 번호 프리뷰
az iot ops schema registry delete

대상 스키마 레지스트리를 삭제합니다.

내선 번호 프리뷰
az iot ops schema registry list

리소스 그룹 또는 구독의 스키마 레지스트리를 나열합니다.

내선 번호 프리뷰
az iot ops schema registry show

스키마 레지스트리의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops schema show

스키마 레지스트리 내의 스키마 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops schema show-dataflow-refs

데이터 흐름에 사용되는 스키마 참조를 표시합니다.

내선 번호 실험적인
az iot ops schema version

스키마 버전 관리.

내선 번호 프리뷰
az iot ops schema version add

스키마에 스키마 버전을 추가합니다.

내선 번호 프리뷰
az iot ops schema version list

특정 스키마에 대한 스키마 버전을 나열합니다.

내선 번호 프리뷰
az iot ops schema version remove

대상 스키마 버전을 제거합니다.

내선 번호 프리뷰
az iot ops schema version show

스키마 버전의 세부 정보를 표시합니다.

내선 번호 프리뷰

az iot ops schema create

미리 보기

명령 그룹 'iot ops 스키마'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

스키마 레지스트리 내에 스키마를 만듭니다.

이 작업을 수행하려면 미리 만든 스키마 레지스트리가 필요하며 스키마 버전이 추가됩니다. 스키마를 만들고 버전을 추가하려면 연결된 스토리지 계정에 공용 네트워크 액세스를 사용하도록 설정해야 합니다. 델타 파일 형식에 대한 자세한 내용은 aka.ms/lakehouse-delta-sample 참조하세요.

az iot ops schema create --format {delta, json}
                         --name
                         --registry
                         --resource-group
                         --type {message}
                         --vc
                         [--desc]
                         [--display-name]
                         [--vd]
                         [--ver]

예제

최소 입력을 사용하여 레지스트리 'myregistry'에 'myschema'라는 스키마를 만듭니다. 이 스키마에 대해 파일 콘텐츠가 포함된 스키마 버전 1이 만들어집니다.

az iot ops schema create -n myschema -g myresourcegroup --registry myregistry --format json --type message --version-content myschema.json

추가 사용자 지정을 사용하여 'myschema'라는 스키마를 만듭니다. 이 스키마에 대한 스키마 버전 14가 만들어집니다. 인라인 콘텐츠는 powershell 구문 예제입니다.

az iot ops schema create -n myschema -g myresourcegroup --registry myregistry --format delta --type message --desc "Schema for Assets" --display-name myassetschema --version-content '{\"hello\": \"world\"}' --ver 14 --vd "14th version"

'myschema'라는 스키마를 만듭니다. 이 스키마에 대한 스키마 버전 1이 만들어집니다. 인라인 콘텐츠는 cmd 구문 예제입니다.

az iot ops schema create -n myschema -g myresourcegroup --registry myregistry --format json --type message --version-content "{\"hello\": \"world\"}"

'myschema'라는 스키마를 만듭니다. 이 스키마에 대한 스키마 버전 1이 만들어집니다. 인라인 콘텐츠는 bash 구문 예제입니다.

az iot ops schema create -n myschema -g myresourcegroup --registry myregistry --format json --type message --version-content '{"hello": "world"}'

필수 매개 변수

--format

스키마 형식입니다.

허용되는 값: delta, json
--name -n

스키마 이름입니다.

--registry

스키마 레지스트리 이름입니다.

--resource-group -g

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

--type

스키마 유형입니다.

허용되는 값: message
--vc --version-content

버전에 대한 콘텐츠 또는 인라인 콘텐츠가 포함된 파일 경로입니다.

선택적 매개 변수

--desc

스키마에 대한 설명입니다.

--display-name

스키마의 표시 이름입니다.

--vd --version-desc

버전에 대한 설명입니다.

--ver --version

스키마 버전 이름입니다.

Default value: 1
전역 매개 변수
--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 iot ops schema delete

미리 보기

명령 그룹 'iot ops 스키마'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

스키마 레지스트리 내에서 대상 스키마를 삭제합니다.

az iot ops schema delete --name
                         --registry
                         --resource-group
                         [--yes {false, true}]

예제

'myregistry' 스키마 레지스트리 내에서 대상 스키마 'myschema'를 삭제합니다.

az iot ops schema delete --name myschema --registry myregistry -g myresourcegroup

필수 매개 변수

--name -n

스키마 이름입니다.

--registry

스키마 레지스트리 이름입니다.

--resource-group -g

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

선택적 매개 변수

--yes -y

프롬프트 없이 [y]es를 확인합니다. CI 및 자동화 시나리오에 유용합니다.

허용되는 값: false, true
전역 매개 변수
--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 iot ops schema list

미리 보기

명령 그룹 'iot ops 스키마'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

스키마 레지스트리 내의 스키마를 나열합니다.

az iot ops schema list --registry
                       --resource-group

예제

스키마 레지스트리 'myregistry'에 스키마 레지스터를 나열합니다.

az iot ops schema list -g myresourcegroup --registry myregistry

필수 매개 변수

--registry

스키마 레지스트리 이름입니다.

--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 iot ops schema show

미리 보기

명령 그룹 'iot ops 스키마'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

스키마 레지스트리 내의 스키마 세부 정보를 표시합니다.

az iot ops schema show --name
                       --registry
                       --resource-group

예제

'myregistry' 스키마 레지스트리 내에서 대상 스키마 'myschema'의 세부 정보를 표시합니다.

az iot ops schema show --name myschema --registry myregistry -g myresourcegroup

필수 매개 변수

--name -n

스키마 이름입니다.

--registry

스키마 레지스트리 이름입니다.

--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 iot ops schema show-dataflow-refs

실험적

이 명령은 실험적이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

데이터 흐름에 사용되는 스키마 참조를 표시합니다.

az iot ops schema show-dataflow-refs --registry
                                     --resource-group
                                     [--latest {false, true}]
                                     [--schema]
                                     [--ver]

예제

스키마 "myschema" 및 버전 1에 대한 스키마 참조를 표시합니다.

az iot ops schema show-dataflow-refs --version 1 --schema myschema --registry myregistry -g myresourcegroup

스키마 "myschema"의 모든 버전에 대한 스키마 참조를 표시합니다.

az iot ops schema show-dataflow-refs --schema myschema --registry myregistry -g myresourcegroup

스키마 레지스트리 "myregistry"에서 모든 버전 및 스키마에 대한 스키마 참조를 표시합니다.

az iot ops schema show-dataflow-refs --registry myregistry -g myresourcegroup

스키마 레지스트리 "myregistry"의 최신 버전만 제외한 모든 스키마에 대한 스키마 참조를 표시합니다.

az iot ops schema show-dataflow-refs --registry myregistry -g myresourcegroup --latest

필수 매개 변수

--registry

스키마 레지스트리 이름입니다.

--resource-group -g

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

선택적 매개 변수

--latest

최신 버전만 표시하는 플래그입니다.

허용되는 값: false, true
--schema

스키마 이름입니다. --version을 사용하는 경우 필수입니다.

--ver --version

스키마 버전 이름입니다. 사용되는 경우 --latest는 무시됩니다.

전역 매개 변수
--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를 사용합니다.