Partilhar via

Tutorial: Criar e ativar uma regra do Fabric Activator

O Ativador de malha no Microsoft Fabric permite que você execute ações quando padrões ou condições são detetados em fluxos de dados. Se você é novo no Ativador de malha, consulte O que é o ativador de malha. Neste tutorial, você usa os dados de exemplo incluídos no Ativador de malha para concluir as seguintes tarefas:

  • Revisar um ativador de exemplo
  • Explorar os dados
  • Explorar uma regra
  • Iniciar a regra
  • Criar um objeto
  • Criar uma regra

Pré-requisitos

Antes de começar, você precisa de um espaço de trabalho com uma capacidade do Fabric. Você pode aprender mais sobre os espaços de trabalho Fabric no artigo Workspaces. Se você não tiver o Fabric, será solicitado que inicie uma avaliação.

Criar um ativador de exemplo

  1. Navegue até o portal do Fabric.

  2. No painel de navegação esquerdo, selecione Criar e, em seguida, selecione Ativador na seção Real-Time Inteligência . Se não vir Criar, selecione as reticências(...), e, em seguida, selecione Criar.

    Captura de ecrã a mostrar o painel de navegação esquerdo com Criar selecionado.

  3. Na página Ativador , selecione Experimentar amostra.

    Captura de tela mostrando a opção para adicionar dados ou usar os dados de exemplo.

Explorar os dados

Nesta etapa, exploramos os dados do fluxo de eventos nos quais esse exemplo foi criado.

O novo ativador tem uma seção "Explorer". Role para baixo e selecione o fluxo de eventos de entrega de pacotes.

Captura de tela do Ativador com o fluxo de eventos de entrega de pacote selecionado.

Esses eventos mostram o status em tempo real dos pacotes que estão em processo de entrega.

Observe os eventos recebidos e passe o mouse sobre os dados do evento na tabela ao vivo. Cada ponto de dados contém informações sobre o evento. Talvez precise rolar para ver tudo.

Explorar uma regra

Use uma regra para especificar os valores de evento que você deseja monitorar, as condições que deseja detetar e as ações que deseja que o Ativador de malha execute.

O painel Explorer exibe objetos, como fluxos de eventos, para esse ativador. Eventos de entrega é um dos objetos criados a partir do eventstream eventos de entrega de pacotes.

  1. No painel Explorer, selecione o objeto chamado Eventos de entrega. Você pode criar regras sobre objetos que usam dados do fluxo de eventos de entrega de pacote. Por exemplo, uma regra que verifica a temperatura dos pacotes.

    Captura de ecrã a mostrar a tabela Eventos de entrega e a coluna de temperatura.

  2. Observe que a secção Eventos por ID do objeto é organizada por ID do pacote. ID do pacote é o identificador que identifica exclusivamente cada pacote. Usamos essa ID exclusiva para atribuir os eventos Package aos objetos Package.

    Captura de tela mostrando a coluna ID exclusiva na tela Eventos por ID do objeto.

  3. Selecione a regra Temperatura chamada Demasiado quente para o medicamento.

    Captura de tela mostrando a regra de exemplo.

  4. No painel mais à direita, consulte o painel Definição para ver como a regra funciona. Na seção Monitor, selecione Temperatura. Os valores de temperatura vêm da coluna de Temperatura na tabela Eventos de entrega. Você pode ver a coluna Temperatura em uma captura de tela anterior.

    Captura de ecrã a mostrar a secção Monitor do painel Definição.

  5. Na seção Resumo , você vê o tamanho da janela, o tamanho da etapa e o uso da operação de agregação (média). Ele procura basicamente pela média das leituras de temperatura numa janela de 10 minutos.

  6. Na seção Condição , você vê a condição da regra para monitorar temperaturas superiores a 20 graus Celsius.

  7. Desloque-se ainda mais para baixo até Filtro de Propriedade. A nossa regra aplica-se apenas a embalagens que contenham medicamentos. Na tabela Eventos de Entrega, a regra analisa a coluna denominada Conteúdo de cuidados especiais. Na coluna Cuidados especiais, algumas das embalagens têm um valor de Medicina.

    Captura de tela mostrando a seção Filtro de propriedade do painel Definição.

  8. Por fim, role para baixo até Ação. Nossa regra envia uma mensagem do Teams se a condição for cumprida.

    Captura de ecrã a mostrar a secção Ação do painel Definição.

Criamos uma regra do Ativador de malha. A regra está a ser executada contra o fluxo de eventos Eventos de entrega de pacotes. A regra procura embalagens que tenham medicamentos e verifica se a temperatura agora é superior a 20 graus Celsius. Quando a temperatura se torna superior a 20 graus Celsius, é enviada uma mensagem do Teams.

Veja as outras regras para saber como funcionam.

Iniciar a regra

Agora você está familiarizado com os eventos e objetos usados para criar uma regra. O próximo passo é iniciar a regra.

  1. Selecione Demasiado quente para o medicamento.

  2. Opcionalmente, envie uma mensagem de teste selecionando Enviar-me uma ação de teste. Primeiro, verifique se você é o destinatário.

    Captura de ecrã a mostrar a secção Ação do painel Definição com o botão Enviar-me uma ação de teste realçado.

  3. Você deve receber uma mensagem semelhante à seguinte:

    Captura de ecrã a mostrar a notificação de exemplo do Teams.

  4. Selecione Iniciar. Isso faz com que a regra se torne ativa. Você recebe uma mensagem do Teams sempre que um pacote de medicamento está muito quente. A regra deve ser acionada várias vezes a cada hora.

    Captura de ecrã a mostrar o botão Iniciar realçado.

  5. Mais tarde, pode desativar a regra utilizando o botão Parar no friso.

    Captura de ecrã a mostrar o botão Parar no friso realçado.

Criar um objeto

Agora é hora de criar um objeto próprio. Nesta seção, exclua o objeto Package . Em seguida, recrie-o para acompanhar o status dos pacotes em trânsito onde as horas de entrega se tornam superiores a 25.

  1. No painel Explorer , clique com o botão direito do mouse em Pacote e selecione Excluir. Na janela Excluir item , selecione Excluir.

    Captura de tela mostrando o menu Excluir no objeto Package.

  2. Selecione o fluxo de eventos de entrega de pacotes e, em seguida, selecione Novo objeto na faixa de opções.

    Captura de ecrã a mostrar o botão Novo objeto no friso.

  3. No painel Construir objeto à direita, siga estas etapas:

    1. Nomeie seu novo objeto como Package2.

    2. Escolha PackageId como o ID exclusivo.

    3. Selecione HoursInTransit e City como propriedades do objeto.

    4. Selecione Criar.

      Captura de tela mostrando o painel de objetos Build.

Criar uma nova regra

Crie uma regra que o alerte se o tempo de trânsito na entrega exceder um limite.

  1. Selecione a sua nova propriedade HoursInTransit. Na faixa de opções, selecione Nova regra.

    Captura de ecrã a mostrar o botão Nova regra no friso.

  2. No painel Criar regras , siga estes passos:

    1. Em Condição, selecione Aumentos acima.

    2. Em Valor, selecione 25.

    3. Em Ocorrência, selecione Toda vez que a condição for atendida.

    4. Em Ação, selecione uma das opções para enviar um e-mail para mensagem no Teams.

    5. Selecione Criar.

      Captura de ecrã a mostrar o painel Criar regras.

  3. Você deve ver a regra em HoursInTransit no painel Explorer. Selecione a regra. No painel central, selecione o ícone de lápis na parte superior e atualize o nome para Tempo médio de trânsito acima do alvo.

    Captura de ecrã a mostrar o ícone de lápis para alterar o nome da regra.

  4. No painel Definição à direita, selecione HoursInTransit. Em seguida, selecione Adicionar resumo>média.

    Captura de ecrã a mostrar o painel Definição com a agregação média selecionada.

  5. Defina um tamanho de janela de agregação de cinco minutos e um tamanho de etapa de cinco minutos e, em seguida, selecione Salvar.

    Captura de tela mostrando o painel Definição com o tamanho da janela e da etapa.

  6. O gráfico do Monitor é atualizado para refletir o resumo, e o gráfico do Monitor das suas regras tem esta aparência.

    Captura de tela do gráfico de tempo médio de trânsito para o tutorial do ativador.

  7. Teste a sua regra selecionando o botão Enviar-me uma ação de teste. Certifique-se de receber um alerta. Se estiver usando e-mail, pode levar um ou dois minutos para chegar.

    Captura de ecrã que mostra o botão Testar selecionado no friso.

  8. Inicie a regra selecionando Salvar e iniciar no painel Definição ou selecionando Iniciar na faixa de opções.

    Captura de ecrã que mostra o botão Iniciar no friso selecionado.

    Você criou seu primeiro objeto e regra. Como próximas etapas, você pode tentar configurar algumas outras regras no objeto Package2 . Quando estiver pronto para tentar usar o Fabric Activator nos seus próprios dados, siga as etapas no artigo Obter dados para o Fabric Activator.

Limpar recursos

Depois de terminar com as regras que você criou como parte do tutorial, certifique-se de pará-las. Se não suspender as regras, continuará a receber as notificações. Você também pode incorrer em cobranças relacionadas ao processamento em segundo plano. Selecione cada regra por vez e selecione o botão Parar na barra de ferramentas.

Conteúdos relacionados

Você também pode saber mais sobre o Microsoft Fabric: