Share via

Envie dados para um ponto de extremidade gRPC com a Versão Prévia do Processador de Dados da Internet das Coisas do Azure.

  • Artigo

Importante

O recurso Pré-visualização de Operações do Azure IoT — habilitado pelo Azure Arc — está atualmente em VERSÃO PRÉVIA. Você não deve usar esse software em versão prévia em ambientes de produção.

Veja os Termos de Uso Complementares para Versões Prévias do Microsoft Azure para obter termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que, de outra forma, ainda não foram lançados em disponibilidade geral.

Use o destino gRPC para gravar dados processados e limpos em um ponto de extremidade gRPC para processamento adicional.

Quando você envia dados para um ponto de extremidade gRPC de uma fase de destino:

  • Atualmente, a fase só dá suporte para o tipo Unary RPC.
  • Você só pode usar o formato Protobuf. Você deve usar a Protobuf com a fase de chamada do gRPC.
  • Como essa fase é um destino de pipeline, a resposta é descartada.

Pré-requisitos

Para configurar e usar uma fase de pipeline de destino, você precisa do seguinte:

  • Uma instância implantada da Versão Prévia do Processador de Dados da Internet das Coisas do Azure.
  • Um servidor gRPC acessível na instância do Processador de Dados.
  • A ferramenta protoc para gerar o descritor.

Configurar a fase de destino

A configuração JSON da fase de destino do gRPC define os detalhes da configuração da fase. Para autorizar a fase, você pode interagir com a interface do usuário baseada em formulário ou fornecer a configuração JSON na guia Avançado:

Nome Tipo Descrição Obrigatório Padrão Exemplo
Nome string Um nome a ser mostrado na interface do usuário do Processador de Dados. Sim - MLCall2
Descrição string Uma descrição amigável da fase de destino. Não Call ML endpoint 2
Server address String O endereço do servidor gRPC Sim - https://localhost:1313
O nome do RPC string O nome do RPC a ser chamado Sim - GetInsights
Descritor1 String O descritor codificado em base 64 Sim - CuIFChxnb29nb
Autenticação string O tipo de autenticação a ser usado. None/Metadata. Sim None None
A chave de metadados string A chave de metadados a ser usada quando a Authentication for definida como Metadata. Não authorization authorization
Segredo string A referência do segredo a ser usada quando a Authentication for definida como Metadata. Não - mysecret
Tentar novamente Repetir A política de nova tentativa a ser usada. Não default fixed
Solicitação da API > Caminho do corpo Caminho O caminho para a parte da mensagem do Processador de Dados que deve ser serializada e definida como o corpo da solicitação. Deixe vazio se você não precisar enviar um corpo da solicitação. Não - .payload.gRPCRequest
Solicitação da API > Metadados > Chave2 Campo Estático/Dinâmico A chave dos metadados a ser definida na solicitação. Não Campo Estático/Dinâmico
Solicitação da API > Metadados > Valor2 Campo Estático/Dinâmico O valor dos metadados a ser definido na solicitação. Não Campo Estático/Dinâmico

1Descritor: para serializar o corpo da solicitação, você precisa de um descritor codificado em Base64 do arquivo .proto.

Use o seguinte comando para gerar o descritor, substitua <proto-file> pelo nome do arquivo .proto:

protoc --descriptor_set_out=/dev/stdout --include_imports <proto-file> | base64 | tr '\n' ' ' | sed 's/[[:space:]]//g'

Use a saída do comando anterior como o descriptor na configuração.

2Solicitação de API > Metadados: cada elemento da matriz de metadados é um par chave-valor. Você pode definir a chave ou o valor dinamicamente com base no conteúdo da mensagem de entrada ou como uma cadeia de caracteres estática.

Conteúdo relacionado