Dispositivos não podem se inscrever em tópicos de outros dispositivos nem publicar mensagens neles. O Data Forwarding processa mensagens de um tópico de dispositivo com uma instrução SQL e encaminha os resultados para outro tópico, viabilizando a comunicação M2M.
Como funciona
O Data Forwarding roteia dados do Tópico 1 para o Tópico 2. A figura a seguir ilustra o fluxo de dados.
O Data Forwarding roteia mensagens do Tópico 1 do Dispositivo 1 para o Tópico 2 do Dispositivo 2. Para receber as mensagens encaminhadas, o Dispositivo 2 precisa ter permissão de inscrição no Tópico 2.
Na figura:
Tópico de origem 1: Os tipos de mensagem compatíveis com o Tópico 1 estão descritos em Formatos de dados.
-
Instrução SQL: Escreva uma instrução SQL para analisar e processar os dados JSON reportados pelo dispositivo. Para sintaxe SQL, consulte Instruções SQL.
NotaDados em formato binário não são analisados e são encaminhados sem alterações.
-
Destino dos dados: Tópico 2, que recebe mensagens do Tópico 1. Tipos de tópicos compatíveis:
Tópicos personalizados e tópicos de dados downstream da Thing Specification Language (TSL):
/sys/${productKey}/${deviceName}/thing/service/property/set.
Casos de uso
-
Tópico personalizado:
Comunicação entre dispositivos do mesmo produto.
Comunicação entre dispositivos de produtos diferentes.
-
Tópico de dados downstream da TSL:
/sys/${productKey}/${deviceName}/thing/service/property/set.O dispositivo recebe dados encaminhados deste tópico e define valores de propriedades com base no payload da mensagem.
Limitações
O tópico de destino deve ter permissão de inscrição e o dispositivo de destino precisa estar inscrito nesse tópico. Caso contrário, as mensagens encaminhadas não serão recebidas.
O Data Forwarding (Versão Anterior) não é compatível com produtos e dispositivos do Cloud Gateway ou instâncias baseadas em MQTT. Utilize o Data Forwarding (Nova Versão).
Pré-requisitos
Uma regra de encaminhamento de dados com instrução SQL já está configurada. Configure uma regra de encaminhamento de dados.
Adicionar um destino de dados
Faça login no console do IoT Platform.
Na página Overview, localize a instância que deseja gerencie e clique em no ID ou no nome da instância.
No painel de navegação à esquerda, escolha .
-
Clique em View ao lado da regra desejada. A página Data Forwarding Rule será exibida.
ImportanteSe a página Data Forwarding (Nova Versão) for exibida, clique em Back to Previous Version no canto superior direito e, em seguida, clique em View ao lado da regra desejada.
Na seção Forward Data, clique em Add Operation.
-
Na caixa de diálogo Add Operation, selecione Publish Data to Another Topic na lista suspensa Operation, configure os parâmetros e clique em OK.
Parâmetro
Descrição
Selecionar operação
Selecione Publish Data to Another Topic.
Tópico
Selecione o tópico de destino.
Valores válidos:
-
Custom: Um tópico personalizado. Defina a permissão de operação do dispositivo como Subscribe para que os dispositivos possam receber mensagens encaminhadas.
-
Send Downstream TSL Data: O tópico para definir valores de propriedades do dispositivo:
thing/service/property/set. Os dispositivos recebem os dados encaminhados e definem os valores das propriedades conforme necessário.
Após selecionar um tipo de tópico, escolha um produto, dispositivo e tópico.
ImportanteSe um dispositivo não estiver inscrito no tópico de destino, ele não poderá receber mensagens encaminhadas.
Por exemplo, se o Dispositivo A se conectar ao IoT Platform via MQTT.fx, ele não se inscreve automaticamente nos tópicos do dispositivo. Se o Dispositivo B encaminhar dados para o tópico
thing/service/property/setdo Dispositivo A sem que este esteja inscrito, o Dispositivo A não receberá a mensagem.Para inscrições automáticas em tópicos, consulte Tópicos com inscrição automática.
-
Na página Data Forwarding, localize a regra e clique em Start na coluna Actions.