Atribuir dados a objetos no Activator

Depois de configurar uma fonte data para Fabric Activator, atribua seus eventos a objetos. Atribua eventos a objetos quando houver uma entidade distinta que você deseja rastrear, como um dispositivo, computador, pacote ou repositório. Cada objeto usa um Identificador Exclusivo para rastrear instâncias individuais ao longo do tempo. Os exemplos neste artigo usam o exemplo de Eventos de Entrega de Pacotes que vem com o Fabric Activator, onde os pacotes são as entidades rastreadas. Substitua seus próprios valores ao trabalhar com seus próprios dados.

Observação

Se você usar uma fonte baseada em consultas (Power BI, conjunto de consultas KQL ou painel em tempo real), o Activator manipulará a associação de dados de forma diferente e poderá criar objetos automaticamente. Este artigo se aplica principalmente a fontes de streaming como eventstreams, eventos Fabric e eventos Azure.

Pré-requisitos

  • Um espaço de trabalho com capacidade habilitada para o Microsoft Fabric.
  • Uma fonte de dados de streaming conectada a um item do Activator, como um fluxo de eventos. Para configurar uma fonte de dados de streaming, consulte Ingestão de Eventstreams.

Atribuir dados a um novo objeto

  1. Abra um item do Activator que tenha uma fonte de dados de streaming conectada a ele ou crie um ativador de exemplo para usar o fluxo de eventos de entrega de pacotes .

    Observação

    O item Activator deve estar em execução para Novo objeto estar disponível na faixa de opções. Se não for iniciado, selecione Iniciar na faixa de opções, volte para o espaço de trabalho e reabra o item do Activator.

  2. No painel Do Explorer, selecione o fluxo de eventos que você deseja atribuir a um objeto. Por exemplo, selecione o fluxo de eventos de entrega de pacote .

  3. Selecione Novo objeto na faixa de opções. O painel Build objeto é aberto com Criar um novo objeto selecionado por padrão. Forneça os seguintes valores:

    • Nome do objeto: um nome para a entidade que você está rastreando.
    • Identificador Exclusivo: uma coluna em seus eventos que identifica exclusivamente cada instância que você está monitorando.

    Para este exemplo, escolha Package como o nome do objeto e a ID do Pacote como o identificador exclusivo.

    Captura de tela do painel do objeto Build no Activator.

  4. Selecione Criar.

    Depois que o Activator criar o objeto, você verá as colunas recebidas desse fluxo de eventos. Os eventos são organizados pelos valores na coluna de identificador exclusivo.

    Captura de tela dos eventos recebidos pelo Activator, organizados pelo identificador exclusivo.

    Por padrão, o gráfico mostra eventos para cinco das instâncias de objeto disponíveis nas últimas 24 horas. Use os seletores de Instância e Hora no canto superior direito do gráfico para alterar esses valores. Você também pode ativar ou desativar a atualização automática para controlar se o gráfico é atualizado automaticamente.

Atribuir dados a um objeto existente

Você pode atribuir vários fluxos de eventos a um único objeto. Atribuir vários fluxos a um objeto é útil quando dados sobre a mesma entidade são distribuídos em vários fluxos. Por exemplo, se os dados de referência de alteração lenta chegarem em um fluxo de eventos e as atualizações rápidas chegarem em outro. Ao atribuir dados a um objeto existente, escolha um Identificador Exclusivo que faça referência às mesmas IDs usadas quando você criou o objeto pela primeira vez. Caso contrário, propriedades e regras produzem resultados inesperados.

Para obter um passo a passo completo usando dois fluxos de eventos, consulte Combinar vários fluxos de eventos em uma regra Activator.

Atribuir uma origem de evento a vários objetos

Você pode atribuir colunas de uma única origem de evento a vários objetos. Atribuir uma fonte de evento a vários objetos é útil quando sua fonte de evento contém dados para mais de uma entidade. Por exemplo, o fluxo de eventos de pacotes de exemplo contém um PackageID e uma coluna City . A criação de um objeto Package permite que você acompanhe e defina regras em pacotes individuais. Por exemplo, alerta quando a temperatura de um pacote específico excede um limite. A criação de um objeto City separado do mesmo fluxo permite que você acompanhe as condições no nível da cidade. Por exemplo, monitore o número total de pacotes em trânsito em uma cidade ou detecte quando o volume de entrega de uma cidade cai inesperadamente. Cada tipo de objeto tem suas próprias regras e propriedades, para que você possa monitorar e agir no nível individual e agregado de um único fluxo de eventos.

  1. Siga as etapas em Atribuir dados a um novo objeto para criar seu primeiro objeto. Por exemplo, crie um objeto Package usando PackageID como o identificador exclusivo.

  2. Volte para o workspace e, em seguida, reabra o item do Ativador e selecione o mesmo fluxo de eventos no painel do Explorer.

  3. Selecione Novo objeto na faixa de opções.

  4. No painel de objetos Build, Criar um novo objeto é selecionado por padrão. Insira um nome para o segundo objeto e escolha uma coluna diferente como o identificador exclusivo. Por exemplo, nomeie o objeto Cidade e selecione Cidade como o identificador exclusivo.

  5. Selecione Criar.

Repita as etapas 2 a 5 para cada objeto adicional que você deseja criar a partir do mesmo fluxo de eventos. Para obter mais informações sobre como criar propriedades e medidas de agregação em seus objetos, consulte Criar propriedades.