Tutorial: Criar e ativar uma regra do Fabric Activator

Ativador do Fabric no Microsoft Fabric permite que você execute ações quando detecta padrões ou condições em fluxos de dados. Se você não estiver familiarizado com Fabric Activator, consulte O que é Fabric Activator. Neste tutorial, você usará os dados de exemplo incluídos com Fabric Activator para concluir as seguintes tarefas:

  • Revise um item de amostra do Ativador
  • 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 workspace com capacidade do Fabric. Para saber mais sobre Fabric workspaces, consulte o artigo Workspaces. Se você não tiver Fabric, será solicitado que você inicie uma avaliação.

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 tela mostrando o painel de navegação esquerdo com Criar selecionado.

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

    Captura de tela mostrando a página de Criar com o Ativador selecionado.

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

    Captura de tela mostrando o ponto de entrada Samples do Try à esquerda.

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

Explorar os dados

Nessa etapa, você explora os dados de eventstream sobre os quais a amostra é construída.

O novo item Ativador tem uma seção de Explorador . Role para baixo e selecione Bicycle readings stream.

Captura de tela do painel Activator UI Explorer mostrando leituras de bicicleta.

Esses eventos mostram leituras relacionadas a bicicletas em tempo real.

Observe os eventos de entrada e passe o mouse sobre os dados do evento na tabela em tempo real. Cada ponto de dados contém informações sobre o evento. Talvez você precise rolar a página para ver tudo.

Explorar uma regra

Use uma regra para especificar os valores de evento que você deseja monitorar, as condições que você deseja detectar e as ações que você deseja que Fabric Activator execute.

O painel Explorer exibe objetos, como fluxos de eventos, para este ativador. Leituras de estação são um dos objetos criados a partir dos fluxos de eventos Bicycles reading events.

  1. No painel do Explorador, selecione o objeto chamado Leituras da Estação. Você pode criar regras sobre objetos que usam dados do fluxo de eventos Bicycles reading events. Por exemplo, uma regra que verifica a disponibilidade de bicicletas em estações.

    Captura de tela mostrando as leituras da estação de bicicletas.

  2. Note que a seção Eventos por 'BikepointID' é organizada pelo ID do Bikepoint. Bikepoint ID é o identificador da coluna que identifica de forma única cada estação de bicicletas. Use este ID único para atribuir eventos de bicicleta a objetos de bicicleta.

    Captura de tela mostrando 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 (E-mail). No painel mais à direita, veja o painel de Definição para ver como a regra funciona.

    Captura de tela mostrando o painel Definições da regra de e-mail No empty docks.

  4. Na seção Monitor, selecione No_Empty_Docks. O número de valores de docas vazias vem da coluna No_Empty_Docks na tabela de leituras da Estação . Você pode ver a coluna No_Empty_Docks em uma captura de tela anterior.

  5. Na seção Condição, você vê a condição da regra para monitorar o número de docas vazias menor que 1.

    Captura de tela mostrando o painel Monitor Definitions para o número de docks vazios.

  6. Role mais para baixo até filtros de propriedade. A regra se aplica apenas às unidades na Arlington Street. Na tabela de Leituras da Estação , a regra analisa a coluna chamada Rua. Na coluna Rua, alguns registros têm o valor Rua Arlington.

    Captura de tela mostrando os filtros da propriedade, mais especificamente a Arlington Street.

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

    1. Enviar notificação por email: Envia um email para si mesmo ou para outras pessoas em sua organização.

      1. Para selecionar a ação, selecione Enviar email.

      2. Para To, insira os endereços de e-mail dos destinatários ou use a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de e-mail. Seu endereço de e-mail é preenchido aqui por padrão.

      3. Em Assunto, insira o assunto da notificação por e-mail ou deixe como está.

      4. Título, insira o título da notificação por e-mail ou deixe como está.

        1. Para Mensagem, insira as notas para a notificação por e-mail.

        Observação

        Ao inserir o assunto, o título ou as notas, pode consultar propriedades nos dados digitando @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @No_Empty_Docks.

      5. Para Contexto, selecione os valores da lista suspensa que você deseja incluir na notificação por e-mail.

        Captura de tela mostrando o painel de Ações com ações de E-mail selecionadas.

    2. Send Microsoft Teams notification: Envia uma notificação de Microsoft Teams para indivíduos, um chat em grupo ou um canal. Você pode personalizar o título e o conteúdo da mensagem.

      1. Para selecionar ação, selecione Mensagem do Teams>para indivíduos, Mensagem em grupo no chat ou postagem no canal.

      2. Siga um destes passos dependendo da sua escolha:

        • Se você selecionou Mensagem para indivíduos, insira os endereços de e-mail dos destinatários ou use a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de e-mail. Quando a condição é cumprida, o Fabric Activator envia uma mensagem do Teams para os indivíduos especificados.
        • Se você selecionou mensagem de chat em grupo, selecione uma conversa em grupo na lista suspensa. Quando a condição é cumprida, o Fabric Activator posta uma mensagem no grupo de conversa.
        • Se você selecionou Postagem no canal, selecione uma equipe e um canal nas listas suspensas. Quando a condição é cumprida, o Fabric Activator posta uma mensagem no canal selecionado.
      3. Para Título, insira o título da notificação do Teams.

      4. Em Mensagem, insira as notas da notificação do Teams.

        Observação

        Ao inserir o assunto, o título ou as notas, pode consultar propriedades nos dados digitando @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @No_Empty_Docks.

      5. Para Contexto, selecione os valores da lista suspensa que deseja incluir na notificação do Teams.

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

    3. Executar atividades do Fabric: Para configurar o alerta para executar um pipeline do Fabric, um Dataflow, um job do Spark, um notebook, uma função, um job de cópia ou publicar um evento de negócios (versão prévia) quando a condição for atendida, siga estas etapas:

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

      Captura de tela mostrando a seção Ação do painel Definição 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 atendida, siga estas etapas:

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

      Captura de tela mostrando a seção de Ação do painel de Definição com ação personalizada selecionada.

      1. Primeiro, crie a regra. Depois, complete 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 sua ação personalizada na lista suspensa Selecionar ação.
  8. Depois de configurar a ação selecionada, selecione Criar para salvar sua regra Ativador.

Você criou uma regra Fabric Activator. A regra é executada no eventstream de leituras de bicicleta. A regra busca o número de docas com menos de 1 bicicleta e verifica toda vez que a condição é cumprida. Quando o número de bicicletas é menor que 1, a regra envia uma mensagem no Teams.

Este item Activator de exemplo inclui outras regras. Explore no seu próprio ritmo para ver como funcionam.

Iniciar a regra

Agora que você está familiarizado com os eventos e objetos usados para criar uma regra, inicie a regra.

  1. Selecione No_empty_docks (E-mail).

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

    Captura de tela mostrando a seção Ação do painel Definição com o botão Enviar-me uma ação de teste realçado.

  3. Você recebe um e-mail semelhante ao seguinte:

    Captura de tela mostrando o e-mail ativador.

  4. Selecione Iniciar. Essa ação ativa a regra. Você recebe um e-mail sempre que um dock tem menos de 1 bicicleta disponível. A regra é acionada toda vez que a condição é cumprida.

    Captura de tela mostrando o botão Iniciar do painel Definições.

  5. Posteriormente, você pode desativar a regra usando o botão Parar na faixa de opções.

    Captura de tela mostrando o botão de parada na fita superior selecionado para parar a regra.

Criar um objeto

Agora crie um objeto. Nesta seção, você exclui o objeto Bike Station e o recria com as propriedades que usará na próxima seção para criar uma regra.

  1. No painel Explorer, clique com o botão direito em Estação de bicicletas e selecione Excluir. Na janela Excluir item , selecione Excluir.

    Captura de tela mostrando o botão de excluir para a Bike Station.

  2. Selecione o fluxo de leituras de bicicleta e depois selecione Novo objeto na Faixa de Opções.

    Captura de tela mostrando a criação de um novo objeto a partir do Eventstream.

  3. No painel Construção à direita, siga estas etapas:

    1. Dê um nome ao seu novo objeto Bike station.

    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 tela mostrando o painel do objeto de compilação

Criar uma regra

Crie uma regra que te alerte quando o número de docas vazias for menor que 1.

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

    Captura de tela mostrando nova regra - nada de docks vazios.

  2. No painel Definição , siga estas etapas:

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

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

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

    4. Clique em Salvar.

      Captura de tela mostrando o painel de definições.

  3. Você vê 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 tela mostrando a nova regra No_Empty_Docks (E-mail).

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

    Captura de tela mostrando o painel Definições com o menu suspenso 'Adicionar resumo' definido como '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 então selecione Salvar.

    Captura de tela 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 de regra tem esta aparência.

    Captura de tela do gráfico do Monitor mostrando dados resumidos com janela de 1 minuto e tamanho de passo aplicados.

  7. Teste sua regra selecionando o botão Enviar-me uma ação de teste. Verifique se você recebeu um alerta. Se você usar email, pode levar um ou dois minutos para chegar.

    Captura de tela do editor de regras com o botão 'Me enviar uma ação de teste' destacado em vermelho.

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

    Captura de tela do painel de Regras com o botão Start destacado na faixa de opções e o painel de Definição aberto.

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

Quando você estiver pronto para tentar usar Fabric Activator em seus próprios dados, siga as etapas no artigo Get data for Fabric Activator.

Limpar os recursos

Quando terminar com as regras criadas como parte do tutorial, interrompa-as. Se você não parar as regras, continuará recebendo as notificações da regra. Você também pode incorrer em encargos para processamento em segundo plano. Selecione cada regra por vez e selecione o botão Parar na faixa de opções.

Para saber mais sobre Microsoft Fabric, confira: