Adicionar eventos Fabric OneLake a um fluxo de eventos

Este artigo mostra-lhe como adicionar a fonte de eventos do Fabric OneLake a um fluxo de eventos.

Os eventos do OneLake permitem que você assine alterações em arquivos e pastas no OneLake e, em seguida, reaja a essas alterações em tempo real. Com os fluxos de eventos do Fabric, pode capturar estes eventos do OneLake, transformá-los e encaminhá-los para vários destinos no Fabric para análise adicional. Esta integração fluida dos eventos OneLake nos fluxos de eventos Fabric dá-lhe maior flexibilidade para monitorizar e analisar atividades no seu OneLake.

Tipos de eventos

Aqui estão os eventos OneLake suportados:

Nome do tipo de evento Descrição
Microsoft.Fabric.OneLake.FileCreated Sinalizado quando um ficheiro é criado ou substituído no OneLake.
Microsoft. Fabric. OneLake.FileDeleted Acionado quando um ficheiro é eliminado no OneLake.
Microsoft. Fabric.OneLake.FileRenomeado Gerado quando um arquivo é renomeado no OneLake.
Microsoft.Fabric.OneLake.FolderCreated Gerado quando uma pasta é criada no OneLake.
Microsoft. Fabric. OneLake.FolderDeleted Levantada quando uma pasta é eliminada no OneLake.
Microsoft. Fabric.OneLake.FolderRenomeado Acionado quando uma pasta é renomeada no OneLake.

Pré-requisitos

  • Aceda a um espaço de trabalho no modo de licença de capacidade Fabric (ou) no modo de licença de teste com permissões Contribuidor ou superiores.
  • Permissão SusbcribeOneLakeEvent nas fontes de dados.

Adicionar eventos Fabric OneLake como fonte

Se ainda não adicionaste nenhuma fonte ao teu event stream, seleciona o mosaico Connect data sources . Também pode selecionar Adicionar fonte>Conectar fontes de dados na fita.

Captura de ecrã que mostra a seleção do tile para usar uma fonte externa.

Se estiveres a adicionar a fonte a um fluxo de eventos já publicado, muda para o modo Editar. Na fita, selecione Adicionar fonte>Ligar fontes de dados.

Captura de ecrã que mostra seleções para adicionar fontes externas.

Na página Selecione uma fonte de dados, pesquise e selecione o botão Conectar no mosaico eventos OneLake.

Captura de ecrã que mostra a seleção de eventos Fabric OneLake como o tipo de origem na janela Selecionar uma fonte de dados.

Configurar e ligar-se aos eventos do Fabric OneLake

  1. Na página Connect, para Tipos de evento, selecione os tipos de evento que deseja monitorar.

    Captura de tela que mostra a seleção de tipos de evento OneLake na página Conectar.

  2. Esta etapa é opcional. Para ver os esquemas para tipos de eventos, selecione Exibir esquemas de tipo de evento selecionados . Se o selecionar, navegue pelos esquemas de eventos e, em seguida, retorne à página anterior selecionando o botão de seta para trás na parte superior.

  3. Selecione Adicionar uma fonte do OneLake em Selecionar fonte de dados para eventos.

    Captura de tela que mostra a seleção do botão Adicionar uma fonte do OneLake.

  4. Na página Escolha os dados que deseja conectar:

    1. Visualize todas as fontes de dados disponíveis ou apenas suas fontes de dados (Meus dados) ou suas fontes de dados favoritas usando os botões de categoria na parte superior. Você pode usar a caixa de texto Filtrar por palavra-chave para pesquisar uma fonte específica. Você também pode usar o botão Filter para filtrar com base no tipo de recurso (Banco de Dados KQL, Lakehouse, Banco de Dados SQL, Warehouse). O exemplo a seguir usa a opção My data.

    2. Selecione a fonte de dados na lista.

    3. Selecione Avançar na parte inferior da página.

      Captura de tela que mostra a seleção de uma fonte de dados OneLake específica.

  5. Selecione todas as tabelas ou uma tabela específica em que está interessado e, em seguida, selecione Adicionar.

    Captura de tela que mostra a seleção de todas as tabelas.

  6. Agora, na página Configurar definições de conexão, você pode adicionar filtros para definir as condições de filtro selecionando campos a serem observados e o valor do alerta. Para adicionar um filtro:

    1. Selecione + Filtrar.

    2. Selecione um campo.

    3. Selecione um operador.

    4. Selecione um ou mais valores para corresponder.

      Captura de tela que mostra a adição de um filtro.

Detalhes do fluxo ou da fonte

  1. Na página de Conectar , siga um destes passos consoante se está a usar o Eventstream ou Real-Time hub.

    • Eventstream:

      No painel de detalhes de origem à direita, siga estes passos:

      1. Para o nome da Fonte, selecione o botão Lápis para alterar o nome.

      2. Note que o nome do Eventstream e o nome do Stream são apenas de leitura.

    • Real-Time hub:

      Na seção Detalhes do fluxo à direita, siga estas etapas:

      1. Selecione o espaço de trabalho Fabric onde quer criar o fluxo de eventos.

      2. Para o nome do Eventostream, selecione o botão Pencil e insira um nome para o eventostream.

      3. O valor nome do Stream é gerado automaticamente ao adicionar -stream ao nome do eventstream. Este fluxo aparece na página Todos os fluxos de dados do hub em tempo real quando o assistente termina.

  2. Selecione Seguinte no final da página de Configurar .

Revise e conecte-se

No ecrã Revisão + ligar, reveja o resumo e selecione Adicionar (Eventstream) ou Ligar (Real-Time Hub).

Ver fluxo de eventos atualizado

  1. Depois de criada a ligação, pode ver a fonte de eventos do Fabric OneLake adicionada ao seu fluxo de eventos em modo de edição. Selecione Publicar para publicar o fluxo de eventos e capturar os eventos do OneLake.

    Uma captura de ecrã da fonte de eventos do Fabric OneLake adicionada ao fluxo de eventos.

    Observação

    Antes de avançar com a transformação ou roteamento de eventos, certifique-se de que os eventos OneLake foram acionados e enviados com sucesso para o fluxo de eventos.

  2. Se quiseres transformar os eventos Fabric OneLake, abre o teu fluxo de eventos e seleciona Edit na barra de ferramentas para entrares no modo Editar. Depois pode adicionar operações para transformar os eventos Fabric OneLake ou encaminhá-los para um destino como Lakehouse.

Captura de ecrã que mostra a fonte recém-adicionada de eventos do Fabric OneLake em vista ao vivo.

Limitações conhecidas

  • Atualmente, as mensagens de erro não estão disponíveis quando ocorre um erro em fontes de eventos discretas.
  • Atualmente, o recurso de visualização de dados não está disponível para fontes de eventos discretas.