Explorar eventos do OneLake no Hub Real-Time do Fabric (versão prévia)
Eventos do OneLake informam sobre alterações no 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 Ativador de Dados para configurar alertas com base em condições específicas e definir ações a serem executadas quando essas condições forem atendidas. Este artigo orienta você sobre como explorar eventos do OneLake usando o Hub Real-Time
Nota
Não há suporte para o consumo de eventos do Fabric e do Azure por meio do eventstream ou do Fabric Activator se a região de capacidade do fluxo de eventos ou do Ativador estiver nas seguintes regiões: Índia Ocidental, Israel Central, Coreia Central, Catar Central, Cingapura, Centro dos Emirados Árabes Unidos, Centro da Espanha, Sudeste do Brasil, Eua Central, Centro-Sul dos EUA, Oeste dos EUA 2, Oeste dos EUA 3.
Exibir a página de detalhes de eventos do OneLake
No Hub em Tempo Real, selecione Eventos do Fabric.
Selecione Eventos do OneLake na lista.
Você verá o modo de exibição Detalhe dos eventos de OneLake.
Ações
Na parte superior da página de detalhes, você verá as duas ações a seguir.
Criar eventstream, que permite criar um eventstream baseado em eventos do item do OneLake selecionado.
Definir alerta, que permite definir um alerta quando uma operação for realizada em um item do OneLake, tal como a criação de um novo arquivo.
Essas ações também estão disponíveis no modo de exibição de lista de eventos do Fabric.
Veja o que está usando essa categoria
Esta seção mostra os artefatos usando eventos do OneLake. Aqui estão as colunas e suas descrições:
| Coluna | Descrição |
|---|---|
| Nome | Nome do artefato que está usando eventos do OneLake. |
| Tipo | Tipo de artefato – Ativador de Dados ou Eventstream |
| Área de trabalho | Ambiente de trabalho onde o artefato reside. |
| Fonte | Nome do workspace que é a origem dos eventos. |
Perfil de eventos do OneLake
Tipos de evento
Aqui estão os eventos do OneLake com suporte:
| Nome do tipo de evento | Descrição |
|---|---|
| Microsoft.Fabric.OneLake.FileCreated | Gerado quando um arquivo é criado ou substituído no OneLake. |
| Microsoft. Fabric.OneLake.FileDeleted | Gerado quando um arquivo é excluído no OneLake. |
| Microsoft. Fabric.OneLake.FileRenamed | Gerado quando um arquivo é renomeado no OneLake. |
| Microsoft.Fabric.OneLake.FolderCreated | Gerado quando uma pasta é criada no OneLake. |
| Microsoft. Fabric.OneLake.FolderDeleted | Acionado ao excluir uma pasta no OneLake. |
| Microsoft. Fabric.OneLake.FolderRenamed | Gerado quando uma pasta é renomeada no OneLake. |
Esquemas
Um evento tem os seguintes dados de nível superior:
| Propriedade | Tipo | Descrição | Exemplo |
|---|---|---|---|
source |
cadeia de caracteres | Identifica o contexto no qual ocorreu um evento. | /aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/workspaces/bbbbbbbb-1111-2222-3333-cccccccccccc/items/cccccccc-2222-3333-4444-dddddddddddd |
subject |
cadeia de caracteres | Identifica o assunto do evento no contexto do produtor de eventos. | /Files/FolderA/FileName.txt |
type |
cadeia de caracteres | Um dos tipos de evento registrados como origem do 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 |
cadeia de caracteres | Identificador exclusivo para o evento. | bbbbbbbb-1111-2222-3333-cccccccccccc |
data |
objeto | Dados do evento. | Consulte a próxima tabela para obter detalhes. |
dataschemaversion |
cadeia de caracteres | A versão do esquema de dados. | 1.0 |
specversion |
cadeia de caracteres | A versão da especificação de evento de nuvem. | 1.0 |
O objeto data tem as seguintes propriedades:
| Propriedade | Tipo | Descrição | Exemplo |
|---|---|---|---|
eTag |
cadeia de caracteres | O valor que você pode usar para executar operações condicionalmente. | "\"0x8D4BCC2E4835CD0\" |
contentLength |
cadeia de caracteres | Tamanho do arquivo em bytes. | 0 |
contentType |
cadeia de caracteres | Tipo de conteúdo especificado para o arquivo. | text/plain |
blobUrl |
cadeia de caracteres | URL do Blob para indicar 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 |
cadeia de caracteres | URL do OneLake para indicar 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 |
cadeia de caracteres | A operação que disparou o evento. | CreateFile |
clientRequestId |
cadeia de caracteres | Uma ID de solicitação fornecida pelo cliente para a operação de API de armazenamento. | 00001111-aaaa-2222-bbbb-3333cccc4444 |
requestId |
cadeia de caracteres | ID de solicitação gerada pelo serviço para a operação de API de armazenamento. | 11112222-bbbb-3333-cccc-4444dddd5555 |
contentOffset |
número | O deslocamento de bytes de uma operação de gravação realizada no ponto em que o aplicativo de gatilho do evento conclui a gravação no arquivo. | 0 |
sequencer |
cadeia de caracteres | Um valor de cadeia de caracteres opaca que representa a sequência lógica de eventos. | 00000000000004420000000000028963 |