Partilhar via


Explore os eventos do OneLake no hub do Fabric Real-Time (em visualização)

Os eventos do OneLake informam sobre alterações em seu data lake, como a criação, modificação ou exclusão de arquivos e pastas.

Real-Time Hub permite que você descubra e assine essas alterações no OneLake, permitindo que você reaja instantaneamente. Por exemplo, você pode monitorar alterações em arquivos e pastas do Lakehouse e utilizar os recursos de alerta do Data Activator para configurar alertas com base em condições específicas e definir ações a serem tomadas quando essas condições forem atendidas. Este artigo orienta você sobre como explorar eventos do OneLake usando o Real-Time Hub

Observação

Não há suporte para o consumo de eventos do Fabric e do Azure por meio do fluxo de eventos ou do Ativador do Fabric se a região de capacidade do fluxo de eventos ou do Ativador estiver nas seguintes regiões: Alemanha Oeste Central, South-Central EUA, Oeste dos EUA 2, Oeste dos EUA 3, Índia Ocidental.

Ver página de detalhes dos eventos do OneLake

  1. Em Real-Time hub, selecione eventos do Fabric.

  2. Selecione eventos do OneLake na lista.

    Captura de tela que mostra a seleção de eventos do OneLake na página de eventos do Fabric.

  3. Você deve ver a vista detalhada para eventos OneLake.

    Captura de tela que mostra a página de detalhes dos eventos do OneLake.

Ações

Na parte superior da página de detalhes, você verá as duas ações a seguir.

  • Criar fluxo de eventos, que permite criar um fluxo de eventos com base em eventos do item OneLake selecionado.

  • Configurar alerta, que permite definir um alerta quando uma operação é concluída para um item do OneLake, como a criação de um novo ficheiro.

    Captura de tela que mostra ações na página de detalhes de eventos do OneLake.

    Essas ações também estão disponíveis no modo de exibição de lista de eventos do Fabric.

Veja o que está a ser utilizado nesta categoria

Esta seção mostra os artefatos usando eventos OneLake. Aqui estão as colunas e suas descrições:

Coluna Descrição
Nome Nome do artefato que está usando eventos OneLake.
Tipo Tipo de artefato – Ativador de dados ou fluxo de eventos
Espaço de trabalho Espaço de trabalho onde o artefato vive.
Fonte Nome do espaço de trabalho que é a origem dos eventos.

Perfil de eventos do OneLake

Captura de tela que mostra a seção Perfil da página de detalhes de eventos do OneLake.

Tipos de eventos

Aqui estão os eventos OneLake suportados:

Nome do tipo de evento Descrição
Microsoft.Fabric.OneLake.FileCreated Gerado quando um arquivo é criado ou substituído no OneLake.
Microsoft. Fabric.OneLake.FicheiroApagado Gerado quando um arquivo é excluído no OneLake.
Microsoft. Fabric.OneLake.FileRenomeado Gerado quando um arquivo é renomeado no OneLake.
Microsoft.Fabric.OneLake.FolderCreated Criado quando uma pasta é criada no OneLake.
Microsoft. Fabric.OneLake.FolderDeleted Gerado quando uma pasta é excluída no OneLake.
Microsoft. Fabric.OneLake.FolderRenomeado Gerado quando uma pasta é renomeada no OneLake.

Esquemas

Um evento tem os seguintes dados de nível superior:

Propriedade Tipo Descrição Exemplo
source string Identifica o contexto em que um evento aconteceu. /aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/workspaces/bbbbbbbb-1111-2222-3333-cccccccccccc/items/cccccccc-2222-3333-4444-dddddddddddd
subject string Identifica o assunto do evento no contexto do produtor do evento. /Files/FolderA/FileName.txt
type string Um dos tipos de evento registrados para essa fonte de evento. Microsoft.Fabric.OneLake.FileCreated
time Carimbo de data/hora A hora em que o evento é gerado com base na hora UTC do provedor. 2017-06-26T18:41:00.9584103Z
id string Identificador exclusivo do evento. bbbbbbbb-1111-2222-3333-cccccccccccc
data objeto Dados do evento. Consulte a tabela seguinte para obter detalhes.
dataschemaversion string A versão do esquema de dados. 1.0
specversion string A versão da especificação do Cloud Event. 1.0

O objeto data tem as seguintes propriedades:

Propriedade Tipo Descrição Exemplo
eTag string O valor que você pode usar para executar operações condicionalmente. "\"0x8D4BCC2E4835CD0\"
contentLength string Tamanho do ficheiro em bytes. 0
contentType string Tipo de conteúdo especificado para o arquivo. text/plain
blobUrl string URL de Blob para o caminho do arquivo. https://onelake.blob.fabric.microsoft.com/55556666-ffff-7777-aaaa-8888bbbb9999 < 66667777-aaaa-8888-bbbb-9999cccc0000/Files/FolderA/File1.txt
url string URL do OneLake para o caminho do arquivo. https://onelake.dfs.fabric.microsoft.com/eeeeeeee-4444-5555-6666-ffffffffffff < aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb/Files/FolderA/File1.txt
api string A operação que desencadeou o evento. CreateFile
clientRequestId string Um ID de solicitação fornecido pelo cliente para a operação da API de armazenamento. 00001111-aaaa-2222-bbbb-3333cccc4444
requestId string ID de solicitação gerada pelo serviço para a operação da API de armazenamento. 11112222-bbbb-3333-cccc-4444dddd5555
contentOffset número O deslocamento em bytes de uma operação de gravação feita no ponto em que o aplicativo que aciona eventos concluiu a gravação no arquivo. 0
sequencer string Um valor de cadeia de caracteres opaco que representa a sequência lógica de eventos. 00000000000004420000000000028963