Criar uma regra no Fabric Activator

Ao colocar dados de streaming em um ativador ou atribuir eventos a objetos, você pode criar regras para agir em seus dados. A ativação dessas regras pode ser o envio de uma notificação, como um email ou uma mensagem do Teams. A ativação dessas regras também pode disparar um fluxo de trabalho, como iniciar um fluxo de Power Automate.

As regras do ativador também podem disparar ações com base em eventos Fabric e eventos Azure Blob Storage recebidos por meio do Eventstream, habilitando a orquestração controlada por eventos. Por exemplo, você pode iniciar trabalhos do Spark ou fluxos de dados quando os arquivos chegam em um contêiner de blob. Para obter mais informações sobre como conectar fontes de eventos, consulte Adicione um destino Fabric Activator a um fluxo de eventos.

Pré-requisitos

• Um espaço de trabalho com capacidade habilitada para o Microsoft Fabric.

Abrir o Ativador

Comece abrindo Fabric no navegador.

No painel de navegação, selecione Criar>Ativador. Se você não vir Criar, selecione as reticências (...) para exibir mais opções.

Selecione Experimentar exemplo para criar um ativador pré-preenchido com eventos e objetos de exemplo.

Definir uma condição e uma ação de regra

Use Regras para especificar os valores que você deseja monitorar em seus eventos, as condições que você deseja detectar e as ações que você deseja que o Activator execute.

Selecione seus dados de regra

No Activator Explorer, selecione a propriedade ou o Eventstream a ser monitorado em sua regra. Para obter informações sobre propriedades, consulte a seção Criar propriedades .

Depois de selecionar uma propriedade ou fluxo de eventos, você verá uma visualização dos valores de uma amostra das instâncias do objeto.

Criar uma nova regra de Ativador

Para criar uma nova regra, selecione o fluxo que você acabou de adicionar. Você verá um painel Criar regra no lado direito. A seção Monitor da regra é pré-preenchida com o fluxo de dados selecionado.

Definir a condição a ser detectada

Em seguida, escolha o tipo de condição que você deseja detectar. Você pode usar condições que verificam:

• Em cada evento, execute uma ação.
• Em cada evento quando um valor é atendido, execute uma ação.
• Em cada evento agrupado por um campo, execute uma ação (por exemplo, em cada evento PackageId quando a temperatura for maior que 30)

Por fim, selecione se deseja que a ação envie um email ou envie uma mensagem do Teams e selecione Criar. Você pode modificar as condições e as ações posteriormente.

Os gráficos na guia Definição são atualizados para mostrar um exemplo dos eventos que atendem às condições definidas.

Se você acessar a guia Análise, verá dois gráficos . O primeiro gráfico mostra o número total de vezes que a regra foi disparada, para todas as IDs de objeto que o Activator está rastreando. Use este gráfico para entender o volume de notificações disparadas em todas as IDs de objeto. O segundo gráfico mostra o número total de vezes que a regra foi ativada para as cinco IDs de objeto. Use este gráfico para entender melhor se as IDs de objeto específicas contribuem mais para todas as ativações que são disparadas.

Definir a ação a ser tomada

Por fim, use a seção Ação para escolher o que fazer quando a condição for detectada.

Aqui estão os tipos de ação com suporte:

• Email – Enviar um email para os destinatários especificados.

• Teams – Enviar uma mensagem do Teams para destinatários, chat em grupo ou canal especificados.

• Fabric item – execute o pipeline do Fabric selecionado, notebook do Fabric, definição de trabalho do Spark do Fabric, fluxo de dados do Fabric ou função de dados do usuário do Fabric. Use essas ações para implementar pipelines controlados por eventos. Para obter mais informações, consulte Trigger Fabric itens.

• Custom Action – Ativar um fluxo de Power Automate.

Diferentes tipos de ação têm parâmetros diferentes. Alguns desses parâmetros incluem o endereço de email para o qual você deseja enviar, o canal do Teams ou o chat em grupo, o fluxo de trabalho que você deseja iniciar, a linha de assunto ou informações adicionais (contexto). Para Contexto, você pode selecionar as propriedades adicionais a serem incluídas na mensagem de alerta.

Você também pode marcar propriedades inserindo @ para adicionar contexto às ações enviadas. Por exemplo: @bikeId.

Se você resumir a propriedade no cartão Monitor, a ação enviará o valor original da propriedade em vez do valor resumido.

Selecione Editar ação para ver um editor com uma visualização da mensagem que a ação envia e opções para adicionar mais informações à ação.

Testar a regra

Depois de criar uma regra, teste-a selecionando Enviar-me um alerta de teste. Selecionar esse botão localiza um evento anterior para o qual a ativação da regra é verdadeiro e envia um alerta para que você possa ver a aparência do alerta para esse evento.

• O alerta de teste sempre vai para você, independentemente do campo de destinatário no cartão Ação.
• A opção Enviar um alerta de teste só será habilitada se você tiver pelo menos um evento passado para o qual a condição da regra seja verdadeira.

Iniciar e interromper sua regra

As regras são criadas em um estado Parado. Esse estado significa que o sistema não está avaliando a regra à medida que os dados fluem para o sistema e a regra não toma nenhuma ação como resultado. Depois de definir a regra, selecione Salvar e começar a ativar a regra. Se você não estiver pronto para iniciar sua regra, salve-a e volte mais tarde. Quando estiver pronto, selecione Iniciar na barra de ferramentas para que o Activator comece a executar o gatilho e tomar as ações.

Uma vez iniciado, você verá Executando na área de título do cartão de regra. Além disso, o ícone no Explorer mostra que a regra está em execução. Quando você inicia a regra, novas ativações começam a ser executadas em relação aos novos dados ingeridos. Sua regra não é ativada em dados que já foram ingeridos. Para interromper o alerta, selecione Parar.

Se você fizer alterações na regra (por exemplo, alterar a condição que ela procura), selecione Atualizar na barra de ferramentas para garantir que a regra em execução use os novos valores.

Quando você exclui uma regra (ou objeto), pode levar até cinco minutos para que qualquer processamento de back-end de dados seja concluído. As regras excluídas podem continuar monitorando os dados e executando ações adequadamente por alguns minutos depois de excluí-los.

Criar propriedades

Às vezes, você precisa reutilizar a lógica de regra em várias regras. Crie uma propriedade para definir uma condição ou medida reutilizável e, em seguida, referencie essa propriedade de várias regras.

Para criar uma propriedade, selecione o fluxo que você adicionou ao objeto no qual você está interessado, selecione Nova Propriedade na faixa de opções e selecione a propriedade que você deseja usar na lógica de regra.

Depois de definir uma propriedade, você pode referenciá-la de uma ou mais regras. Neste exemplo, você faz referência à propriedade TemperatureMuito quente para medicina.

Limpar recursos

Exclua o eventstream de exemplo selecionando as reticências (...) à direita do eventstream Eventos de entrega de pacote e selecionando Excluir.

Próxima etapa

Conteúdo relacionado

• Visão geral das regras do Ativador
• Tutorial do Ativador