Adicionar um Hub IoT do Azure como origem a um Eventstream

Este artigo mostra como adicionar um Hub IoT do Azure como origem a um Eventstream.

Observação

Se você quiser usar funcionalidades avançadas que estão em pré-visualização, selecione funcionalidades Avançadas no topo. Caso contrário, selecione Funcionalidades Standard. Para obter informações sobre recursos avançados que estão em versão prévia, consulte Introdução aos fluxos de eventos do Fabric.

Pré-requisitos

Antes de começar, você deve concluir os seguintes pré-requisitos:

  • Obtenha acesso a um workspace premium com permissões de Colaborador ou superior no local em que seu fluxo de eventos está localizado.
  • Você precisa ter permissão apropriada para obter as chaves de acesso do Hub IoT. O hub IoT deve ser acessível publicamente e não estar por trás de um firewall ou protegido em uma rede virtual.

Importante

Atualmente, os recursos avançados dos fluxos de eventos do Fabric estão em preview.

Observação

O número máximo de origens e destinos para um fluxo de eventos é 11.

Adicionar um hub IoT do Azure como fonte

Siga estas etapas para adicionar um hub IoT do Azure como sua origem do eventstream:

  1. Crie um eventstream com recursos avançados.

  2. Se você ainda não tiver adicionado uma origem ao seu eventstream, escolha Adicionar origem externa na Página de introdução.

    Captura de tela mostrando um novo eventstream com o bloco Adicionar origem externa escolhida.

    Se você estiver adicionando um hub IoT do Azure como fonte a um eventstream já publicado, mude para o modo de edição, escolha Adicionar fonte na faixa e escolha Fontes externas.

    Captura de tela mostrando o menu Adicionar origem externa para um eventstream publicado.

Configurar o conector do Hub IoT do Azure

  1. Na página Selecionar uma fonte de dados, escolha Hub IoT do Azure.

    Captura de tela mostrando a escolha do Hub IoT do Azure como o tipo de fonte no assistente Obter eventos.

  2. Se já houver uma conexão com o hub IoT do Azure, escolha esta conexão, conforme mostrado na imagem a seguir, e vá para a etapa de configuração do Formato de dados nas etapas a seguir.

    Captura de tela que mostra a página Conectar com uma conexão existente com um hub IoT do Azure.

  3. Na página Conectar, selecione Nova conexão.

    Captura de tela mostrando a página Conectar com o link Nova conexão em destaque.

  4. Na seção Configurações de conexão, em Hub IoT, especifique o nome do hub IoT do Azure.

    Captura de tela mostrando as configurações de conexão do hub IoT com o nome do hub IoT.

  5. Na seção Credenciais de conexão, execute estas etapas:

    1. Se já houver uma conexão, selecione-a na lista suspensa. Caso contrário, confirme se Criar nova conexão está escolhida para essa opção.

    2. Em Nome da conexão, insira um nome para a conexão com o Hub IoT.

    3. Em Método de autenticação, confirme se a opção Chave de acesso compartilhada está escolhida.

    4. Em Nome da chave de acesso compartilhada, insira o nome da chave de acesso compartilhada.

    5. Em Chave de acesso compartilhada, insira o valor da chave de acesso compartilhada.

    6. Na parte inferior da página, selecione Conectar.

      Captura de tela mostrando a página um de Conectar para o conector do Hub IoT do Azure.

      Para obter o nome e o valor da chave de acesso, execute estas etapas:

      1. Navegue até a página Hub IoT do Hub IoT do Azure no portal do Azure.

      2. Na página Hub IoT, escolha Políticas de acesso compartilhado no menu de navegação esquerdo.

      3. Escolha um nome de política na lista. Anote o nome da política.

      4. Escolha o botão de cópia ao lado de Chave primária.

        Captura de tela mostrando a chave de acesso para um Hub IoT do Azure.

  6. Agora, na página Conectar do assistente, em Grupo de consumidores, insira o nome do grupo de consumidores. Por padrão, $Default é selecionado, que é o grupo de consumidores padrão para o Hub IoT.

  7. Em Formato de dados escolha um formato dos eventos de entrada em tempo real que você deseja obter do Hub IoT do Azure. Escolha entre os formatos de dados JSON, Avro e CSV e, em seguida, escolha Conectar.

  8. Selecione Avançar na parte inferior da página.

    Captura de tela mostrando a página dois de Conectar para o conector do Hub IoT do Azure.

  9. Na página Revisar e criar, revise as configurações e selecione Adicionar.

    Captura de tela mostrando a página Revisar e criar para o conector do Hub IoT do Azure.

Você verá que a fonte do Hub IoT do Azure é adicionada ao eventstream na tela no Modo de edição. Para implementar esse hub IoT do Azure recém-adicionado, escolha Publicar na faixa.

Captura de tela mostrando o editor com o botão Publicar escolhido.

Depois de concluir essas etapas, o Hub IoT do Azure estará disponível para visualização na Exibição ao vivo. Escolha o bloco Hub IoT no diagrama para ver a página semelhante à que se segue.

Captura de tela mostrando o editor na exibição ao vivo.

Para saber como adicionar outras origens a um Eventstream, consulte os seguintes artigos:

Pré-requisitos

Antes de começar, você deve concluir os seguintes pré-requisitos:

  • Obtenha acesso a um workspace premium com permissões de Colaborador ou superior no local em que seu fluxo de eventos está localizado.
  • Você precisa ter permissão apropriada para obter as chaves de acesso do Hub IoT. O hub IoT deve ser acessível publicamente e não estar por trás de um firewall ou protegido em uma rede virtual.

Observação

O número máximo de origens e destinos para um fluxo de eventos é 11.

Adicionar um hub IoT do Azure como origem

Siga estas etapas para adicionar um hub IoT do Azure como sua origem do eventstream:

  1. No editor do Eventstream, expanda o menu suspenso Nova origem dentro do nó e escolha Hub IoT do Azure.

    Captura de tela que mostra onde adicionar uma origem do Hub IoT do Azure no eventstream.

  2. No painel de configuração do Hub IoT do Azure, insira os seguintes detalhes:

    Captura de tela que mostra onde configurar o Hub IoT do Azure no eventstream.

    1. Nome de origem: insira um nome para seu Hub IoT do Azure, como iothub-source.

    2. Conexão de nuvem: selecione uma conexão de nuvem existente que vincule seu Hub IoT do Azure ao Microsoft Fabric. Se você não tiver uma, vá para a etapa 3 para criar uma nova conexão de nuvem.

    3. Formato de dados. Escolha um formato de dados (AVRO, JSON ou CSV) para transmitir seus dados do Hub IoT para o eventstream.

    4. Grupo de consumidores. Escolha um grupo de consumidores em seu Hub IoT do Azure ou deixe-o como $Default. Em seguida, selecione Adicionar para concluir a configuração do Hub IoT do Azure.

    5. Depois de adicionado com êxito, você poderá ver uma origem do Hub IoT do Azure adicionada ao eventstream no editor.

      Captura de tela que mostra a origem do Hub IoT do Azure no editor do Eventstream.

  3. Para criar uma nova conexão de nuvem para seu Hub IoT do Azure, siga estas etapas:

    Captura de tela que mostra onde criar uma nova conexão de nuvem.

    1. Selecione Criar nova conexão no menu suspenso, preencha as Configurações de conexão e Credenciais de conexão do Hub IoT do Azure e selecione Criar.

      Captura de tela que mostra onde configurar uma nova conexão de nuvem.

    2. Hub IoT. Insira o nome do Hub IoT no portal do Azure.

    3. Nome da conexão. Insira um nome para a nova conexão de nuvem, como iothub-connection.

    4. Nome da chave de acesso compartilhado e Chave de acesso compartilhado. Insira as credenciais de conexão do Hub IoT do Azure. Você pode encontrá-lo em Políticas de acesso compartilhado no portal do Azure. Você deve ter permissões adequadas para acessar qualquer um dos pontos de extremidade de Hub IoT.

      Captura de tela que mostra onde encontrar a chave de acesso compartilhado no portal do Azure.

    5. Retorne ao painel de configuração do Hub IoT do Azure e selecione Atualizar para carregar a nova conexão de nuvem.

      Captura de tela que mostra onde atualizar a conexão de nuvem do Hub IoT do Azure.

Depois que o Hub IoT do Azure for adicionado ao eventstream, selecione Visualizar dados para verificar a configuração bem-sucedida. Você deve ser capaz de visualizar os dados de entrada no seu eventstream.

Captura de tela que mostra onde visualizar os dados do Hub IoT.

Para saber como adicionar outras origens a um Eventstream, consulte os seguintes artigos: