Partilhar via


az iot ops schema

Note

Essa referência faz parte da extensão azure-iot-ops para a CLI do Azure (versão 2.67.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az iot ops schema . Saiba mais sobre extensões.

Registro de esquema e gerenciamento de esquema.

Os esquemas são documentos que descrevem dados para permitir o processamento e a contextualização. Os esquemas de mensagem descrevem o formato de uma mensagem e seu conteúdo. Um registro de esquema é necessário para criar e gerenciar esquemas.

Comandos

Name Description Tipo Status
az iot ops schema create

Crie um esquema dentro de um registro de esquema.

Extension disponibilidade geral
az iot ops schema delete

Exclua um esquema de destino dentro de um registro de esquema.

Extension disponibilidade geral
az iot ops schema list

Listar esquemas dentro de um registro de esquema.

Extension disponibilidade geral
az iot ops schema registry

Gerenciamento de registro de esquema.

Extension disponibilidade geral
az iot ops schema registry create

Crie um registro de esquema.

Extension disponibilidade geral
az iot ops schema registry delete

Exclua um registro de esquema de destino.

Extension disponibilidade geral
az iot ops schema registry list

Listar registros de esquema em um grupo de recursos ou assinatura.

Extension disponibilidade geral
az iot ops schema registry show

Mostrar detalhes de um registro de esquema.

Extension disponibilidade geral
az iot ops schema show

Mostrar detalhes de um esquema dentro de um registro de esquema.

Extension disponibilidade geral
az iot ops schema show-dataflow-refs

Mostrar as referências de esquema usadas para fluxos de dados.

Extension Experimental
az iot ops schema version

Gerenciamento de versão do esquema.

Extension disponibilidade geral
az iot ops schema version add

Adicione uma versão do esquema a um esquema.

Extension disponibilidade geral
az iot ops schema version list

Listar versões de esquema para um esquema específico.

Extension disponibilidade geral
az iot ops schema version remove

Remova uma versão do esquema de destino.

Extension disponibilidade geral
az iot ops schema version show

Mostrar detalhes de uma versão do esquema.

Extension disponibilidade geral

az iot ops schema create

Crie um esquema dentro de um registro de esquema.

Esta operação requer um registro de esquema pré-criado e adicionará uma versão de esquema. Para criar o esquema e adicionar uma versão, a conta de armazenamento associada precisará ter o acesso à rede pública habilitado. Para obter mais informações sobre o formato de arquivo delta, consulte 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]

Exemplos

Crie um esquema chamado 'myschema' no registro 'myregistry' com entradas mínimas. O esquema versão 1 será criado para este esquema com o conteúdo do arquivo.

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

Crie um esquema chamado 'myschema' com personalização adicional. A versão 14 do esquema será criada para este esquema. O conteúdo embutido é um exemplo de sintaxe bash. Para obter mais exemplos, consulte 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"

Parâmetros Obrigatórios

--format

Formato do esquema.

Propriedade Valor
Valores aceites: delta, json
--name -n

Nome do esquema.

--registry

Nome do registro do esquema.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--type

Tipo de esquema.

Propriedade Valor
Valores aceites: message
--vc --version-content

Caminho do arquivo contendo ou conteúdo embutido para a versão.

Propriedade Valor
Grupo de parâmetros: Version Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--desc

Descrição do esquema.

--display-name

Nome para exibição do esquema.

--vd --version-desc

Descrição da versão.

Propriedade Valor
Grupo de parâmetros: Version Arguments
--ver --version

Nome da versão do esquema.

Propriedade Valor
Grupo de parâmetros: Version Arguments
Default value: 1
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az iot ops schema delete

Exclua um esquema de destino dentro de um registro de esquema.

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

Exemplos

Exclua um esquema de destino 'myschema' dentro de um registro de esquema 'myregistry'.

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

Parâmetros Obrigatórios

--name -n

Nome do esquema.

--registry

Nome do registro do esquema.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--yes -y

Confirme [s]es sem um prompt. Útil para cenários de CI e automação.

Propriedade Valor
Valores aceites: false, true
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az iot ops schema list

Listar esquemas dentro de um registro de esquema.

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

Exemplos

Listar registros de esquema no registro de esquema 'myregistry'.

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

Parâmetros Obrigatórios

--registry

Nome do registro do esquema.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az iot ops schema show

Mostrar detalhes de um esquema dentro de um registro de esquema.

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

Exemplos

Mostrar detalhes do esquema de destino 'myschema' dentro de um registro de esquema 'myregistry'.

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

Parâmetros Obrigatórios

--name -n

Nome do esquema.

--registry

Nome do registro do esquema.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az iot ops schema show-dataflow-refs

Experimental

Este comando é experimental e está em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Mostrar as referências de esquema usadas para fluxos de dados.

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

Exemplos

Mostrar referência de esquema para o esquema "myschema" e versão 1.

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

Mostrar referência de esquema para todas as versões no esquema "myschema".

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

Mostrar referência de esquema para todas as versões e esquemas no registro de esquema "myregistry".

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

Mostrar referência de esquema para todos os esquemas, mas apenas as versões mais recentes no registro de esquema "myregistry".

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

Parâmetros Obrigatórios

--registry

Nome do registro do esquema.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--latest

Sinalizar para mostrar apenas a(s) versão(ões) mais recente(s).

Propriedade Valor
Valores aceites: false, true
--schema

Nome do esquema. Obrigatório se estiver usando --version.

--ver --version

Nome da versão do esquema. Se usado, --latest será ignorado.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False