Tutorial: Cria e ativa uma regra do Fabric Activator

O Fabric Activator no Microsoft Fabric permite-lhe agir quando detetar padrões ou condições em fluxos de dados. Se és novo no Fabric Activator, vê O que é Fabric Activator. Neste tutorial, utiliza os dados de exemplo incluídos com o Fabric Activator para completar as seguintes tarefas:

  • Revise um item de exemplo do Ativador
  • Explorar os dados
  • Explorar uma regra
  • Iniciar a regra
  • Criar um objeto
  • Criar uma regra

Pré-requisitos

Antes de começar, precisa de um espaço de trabalho com capacidade para Fabric. Para saber mais sobre Fabric espaços de trabalho, consulte o artigo Workspaces. Se não tiver Fabric, será solicitado a iniciar uma versão de teste.

Crie um Ativador de exemplo

  1. Na página inicial do Fabric, no painel de navegação à esquerda, selecione a reticência (...) e depois selecione Criar.

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

  2. Na página Criar, em Inteligência em Tempo Real, selecione Activator.

    Captura de ecrã a mostrar a página Criar com o Ativador selecionado.

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

    Captura de ecrã que mostra o ponto de entrada esquerdo das amostras Try.

    Siga os prompts guiados para ativar os dados de amostra e explore a interface do Activator.

Explorar os dados

Neste passo, explora os dados do fluxo de eventos sobre os quais a amostra é construída.

O novo item Ativador tem uma secção de Explorador . Desça e selecione Bicycle readings stream.

Captura de ecrã do painel do Activator UI Explorer a mostrar leituras de bicicleta.

Estes eventos mostram leituras de ciclismo em tempo real.

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. Pode ser necessário percorrer a página para ver tudo.

Explorar uma regra

Usa uma regra para especificar os valores de eventos que queres monitorizar, as condições que queres detetar e as ações que queres que o Fabric Activator realize.

O painel Explorer exibe objetos, como fluxos de eventos, para esse ativador. As leituras da estação são um dos objetos criados a partir dos fluxos de eventos Eventos de leitura de bicicletas.

  1. No painel do Explorador, selecione o objeto chamado Leituras da Estação. Podes criar regras sobre objetos que usam dados do eventstream de eventos de leitura de bicicletas. Por exemplo, uma regra que verifica a disponibilidade de bicicletas nas estações.

    Captura de ecrã a mostrar as leituras da estação de bicicletas.

  2. Note que os Eventos por 'BikepointID' estão organizados por ID Bikepoint. O ID do Bikepoint é o ID da coluna que identifica de forma única cada estação de bicicletas. Use este ID único para associar eventos de bicicleta a objetos de bicicleta.

    Captura de ecrã a mostrar as leituras da estação para o ID do ponto de bicicletas.

  3. Selecione a regra No_Empty_Docks (que significa número de docks vazios) chamada Sem docks vazios (Email). No painel mais à direita, veja o painel de Definição para ver como funciona a regra.

    Captura de ecrã a mostrar o painel Definições da regra de e-mail

  4. Na secção Monitor , selecione No_Empty_Docks. O número de valores de docas vazias provém da coluna No_Empty_Docks na tabela de leituras da Estação . Pode ver a coluna No_Empty_Docks numa captura de ecrã anterior.

  5. Na secção Condição, vê a condição da regra para monitorizar o número de docas vazias inferior a 1.

    Captura de ecrã que mostra o painel Monitor Definitions para o número de docas vazias.

  6. Desça mais para baixo até Filtros de propriedade. A regra aplica-se apenas às paragens na Arlington Street. Na tabela de Leituras da Estação , a regra analisa a coluna chamada Rua. Na coluna Street, algumas das bicicletas têm o valor de Arlington Street.

    Captura de ecrã a mostrar os filtros da propriedade, mais especificamente a Arlington Street.

  7. Desça até Ação. Escolha uma das seguintes ações a tomar quando a condição for cumprida:

    1. Enviar notificação por email: Envia um email para ti próprio ou para outros membros da tua organização.

      1. Para Selecionar ação, selecione Enviar e-mail.

      2. Para To, insira os endereços de email dos destinatários ou utilize a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de email. O seu endereço de email é preenchido aqui por defeito.

      3. Em Assunto, introduza o assunto da notificação por email ou deixe como está.

      4. Em Título, introduza o título da notificação por email ou deixe como está.

        1. Em Mensagem, introduza notas para a notificação por email.

        Observação

        Ao introduzir o assunto, o título ou as notas, pode referir-se a propriedades dos dados escrevendo @ ou selecionando o botão junto às caixas de texto. Por exemplo, @No_Empty_Docks.

      5. Para contextualizar, selecione os valores da lista suspensa que pretende incluir na notificação por email.

        Captura de ecrã a mostrar o painel de Ações com ações de Email selecionadas.

    2. Enviar Microsoft Teams notificação: Envia uma notificação Microsoft Teams a indivíduos, a um grupo de chat ou a um canal. Pode personalizar o título e o conteúdo da mensagem.

      1. Para selecionar ação, selecione Mensagem do Teams>para indivíduos, Mensagem de Grupo no chat ou Publicação no Canal.

      2. Siga um destes passos dependendo da sua escolha:

        • Se selecionou Mensagem para indivíduos, insira os endereços de email dos destinatários ou utilize a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de email. Quando a condição é cumprida, o Fabric Activator envia uma mensagem Teams aos indivíduos especificados.
        • Se selecionaste mensagem no chat de grupo, seleciona um chat de grupo na lista suspensa. Quando a condição é cumprida, o Fabric Activator publica uma mensagem no grupo de chat.
        • Se selecionou publicação no canal, selecione uma equipa e um canal nas listas pendentes. Quando a condição é cumprida, o Fabric Activator publica uma mensagem no canal selecionado.
      3. No Campo 'Título', introduza o título da notificação do Teams.

      4. Em Mensagem, introduza notas para a notificação do Teams.

        Observação

        Ao introduzir o assunto, o título ou as notas, pode referir-se a propriedades dos dados escrevendo @ ou selecionando o botão junto às caixas de texto. Por exemplo, @No_Empty_Docks.

      5. Para Context, selecione os valores da lista pendente que pretende incluir na notificação do Teams.

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

    3. Executar atividades do Fabric: Para configurar o alerta para iniciar um pipeline do Fabric, um Dataflow, uma tarefa do Spark, um notebook, uma Função, uma tarefa de cópia ou publicar um evento empresarial (pré-visualização) quando a condição for satisfeita, siga estes passos:

      1. Para Selecionar ação, selecione Executar Ação, Executar Pipeline, Executar Fluxo de Dados, Executar o trabalho Spark, Executar o Caderno, Executar Função, Executar o trabalho de cópia, ou Publicar evento de negócio.
      2. Ao selecionar o item Fabric para executar, selecione o item Fabric (Ação, pipeline, fluxo de dados, notebook, tarefa Spark, função, trabalho de cópia ou evento de publicação de negócio) da lista.
      3. Selecione Adicionar parâmetro e depois especifique o nome do parâmetro para o item Fabric e um valor para ele. Você pode adicionar mais de um parâmetro. Pode passar parâmetros a partir dos dados de alerta escrevendo @ ou selecionando o botão ao lado da caixa de texto. Por exemplo, @BikePointID. Os jobs de cópia não aceitam parâmetros, por isso este passo não se aplica a eles.

      Captura de ecrã que mostra a secção Ação do painel de Definições com a ação de email selecionada.

    4. Ações personalizadas: Para configurar o alerta para chamar uma ação personalizada quando a condição for cumprida, siga estes passos:

      1. Para Selecionar ação, selecione Criar ação personalizada.

      Captura de ecrã que mostra a secção de Ação do painel de Definição com a ação personalizada selecionada.

      1. Primeiro, crie a regra. Depois, conclua a configuração de ações personalizadas seguindo os passos em Acionar ações personalizadas (fluxos do Power Automate).
      2. Depois de criar a ação personalizada, no painel Definição, selecione a sua ação personalizada na lista suspensa Selecionar ação.
  8. Depois de configurares a ação selecionada, seleciona Criar para guardar a tua regra de Ativador.

Criaste uma regra do Fabric Ativator. A regra é executada no fluxo de eventos Bicycle readings. A regra procura o número de cais vazios com menos de 1 bicicleta e verifica de cada vez que a condição é cumprida. Quando o número de bicicletas é inferior a 1, a regra envia uma mensagem no Teams.

Este exemplo de item Ativador inclui outras regras. Explora-os ao teu próprio ritmo para perceberes como funcionam.

Iniciar a regra

Agora que já conheces os eventos e objetos usados para criar uma regra, começa a regra.

  1. Selecione No_empty_docks (Email).

  2. Opcionalmente, envie uma mensagem de teste selecionando Enviar-me uma ação de teste. Primeiro, verifique se é 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. Recebe um email semelhante ao seguinte:

    Captura de ecrã a mostrar o email ativador.

  4. Selecione Iniciar. Esta ação ativa a regra. Recebes um email sempre que um dock tem menos de uma bicicleta disponível. A regra é ativada sempre que a condição é cumprida.

    Captura de ecrã que mostra o botão Iniciar no painel Definições.

  5. Mais tarde, podes desligar a regra usando o botão Parar na fita.

    Captura de ecrã a mostrar o botão de paragem da fita superior selecionado para parar a regra.

Criar um objeto

Agora cria um objeto. Nesta secção, apagas o objeto Bike Station e recrias-lo com as propriedades que vais usar na próxima secção para criar uma regra.

  1. No painel Explorer, clique com o botão direito em Bike station e selecione Eliminar. Na janela Excluir item , selecione Excluir.

    Captura de ecrã a mostrar o botão de apagar para a Bike Station.

  2. Selecione o fluxo de leituras de bicicleta e depois selecione Novo objeto no friso.

    Captura de ecrã a mostrar a criação de um novo objeto a partir do Eventstream.

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

    1. Nomeie o seu novo objeto estação de bicicletas.

    2. Escolha o BikepointID como o ID único.

    3. Selecione No_Bikes, No_Empty_Docks e Street como propriedades do objeto.

    4. Selecione Criar.

      Captura de ecrã a mostrar o painel do objeto de construção

Criar uma regra

Cria uma regra que te alerte quando o número de docas vazias for inferior a 1.

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

    Captura de ecrã a mostrar nova regra - não há docas vazias.

  2. No painel de Definições , siga estes passos:

    1. Para o Monitor, escolha o atributo a monitorizar e, opcionalmente, adicione filtros.

    2. Para Condição, defina a condição para disparar quando No_Empty_Docks for inferior a 1.

    3. Para Ação, selecione uma das opções para enviar uma mensagem no Teams ou por email.

    4. Selecione Guardar.

      Captura de ecrã com o painel de definições.

  3. Vês a regra sob o alerta No_Empty_Docks no painel do Explorador. Selecione a regra. No painel do meio, selecione o ícone do lápis no topo e atualize o nome para No_Empty_Docks (Email).

    Captura de ecrã a mostrar a nova regra No_Empty_Docks (Email).

  4. No painel de Definição à direita, selecione No_Empty_Docks. Depois, selecione Adicionar resumo>Máximo.

    Captura de ecrã mostrando o painel de Definições com a lista pendente 'Adicionar resumo' definida para 'Máximo'.

  5. Defina um tamanho de janela de agregação de um minuto e um tamanho de passo igual ao tamanho da janela, e depois selecione Guardar.

    Captura de ecrã do painel de Definição mostrando a sumarização definida para Máximo com tamanho de janela de 1 minuto.

  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 ecrã do gráfico do Monitor mostrando dados resumidos com janela de 1 minuto e tamanho de passo aplicados.

  7. Teste a sua regra selecionando o botão Enviar-me uma ação de teste. Certifique-se de receber um alerta. Se usares email, pode demorar um ou dois minutos a chegar.

    Captura de ecrã do editor de regras com o botão 'Enviar-me uma ação de teste' destacado a vermelho.

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

    Captura de ecrã do painel de Regras com o botão Iniciar destacado no friso e o painel de Definição aberto.

Você criou seu primeiro objeto e regra. Como próximo passo, tenta configurar outras regras no objeto Bike station .

Quando estiver pronto para tentar usar o Fabric Activator nos seus próprios dados, siga os passos no artigo Get data for Fabric Activator.

Limpar recursos

Quando terminares as regras que criaste como parte do tutorial, pára-as. Se não suspender as regras, continuará a receber as notificações. Também pode incorrer em custos por processamento em segundo plano. Selecione cada regra por vez e selecione o botão Parar na barra de ferramentas.

Para saber mais sobre a Microsoft Fabric, veja: