az iot ops schema

Note

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

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

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

명령

Name	Description	형식	상태
az iot ops schema create	스키마 레지스트리 내에 스키마를 만듭니다.	Extension	GA
az iot ops schema delete	스키마 레지스트리 내에서 대상 스키마를 삭제합니다.	Extension	GA
az iot ops schema list	스키마 레지스트리 내의 스키마를 나열합니다.	Extension	GA
az iot ops schema registry	스키마 레지스트리 관리.	Extension	GA
az iot ops schema registry create	스키마 레지스트리를 만듭니다.	Extension	GA
az iot ops schema registry delete	대상 스키마 레지스트리를 삭제합니다.	Extension	GA
az iot ops schema registry list	리소스 그룹 또는 구독의 스키마 레지스트리를 나열합니다.	Extension	GA
az iot ops schema registry show	스키마 레지스트리의 세부 정보를 표시합니다.	Extension	GA
az iot ops schema show	스키마 레지스트리 내의 스키마 세부 정보를 표시합니다.	Extension	GA
az iot ops schema show-dataflow-refs	데이터 흐름에 사용되는 스키마 참조를 표시합니다.	Extension	Experimental
az iot ops schema version	스키마 버전 관리.	Extension	GA
az iot ops schema version add	스키마에 스키마 버전을 추가합니다.	Extension	GA
az iot ops schema version list	특정 스키마에 대한 스키마 버전을 나열합니다.	Extension	GA
az iot ops schema version remove	대상 스키마 버전을 제거합니다.	Extension	GA
az iot ops schema version show	스키마 버전의 세부 정보를 표시합니다.	Extension	GA

az iot ops schema create

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

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

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

예제

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

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

추가 사용자 지정을 사용하여 'myschema'라는 스키마를 만듭니다. 이 스키마에 대한 스키마 버전 14가 만들어집니다. 인라인 콘텐츠는 bash 구문 예제입니다. 자세한 예제는 https://aka.ms/inline-json-examples 참조하세요.

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"

필수 매개 변수

--format

스키마 형식입니다.

속성	값
허용되는 값:	delta, json

--name -n

스키마 이름입니다.

--registry

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

--resource-group -g

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

--type

스키마 유형입니다.

속성	값
허용되는 값:	message

--vc --version-content

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

속성	값
매개 변수 그룹:	Version Arguments

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--desc

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

--display-name

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

--vd --version-desc

버전에 대한 설명입니다.

속성	값
매개 변수 그룹:	Version Arguments

--ver --version

스키마 버전 이름입니다.

속성	값
매개 변수 그룹:	Version Arguments
Default value:	1

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot ops schema delete

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

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

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot ops schema list

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

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

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot ops schema show

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

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

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

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

예제

스키마 "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

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False