Partilhar via


Explore os eventos de itens do espaço de trabalho do Fabric no hub Fabric Real-Time (pré-visualização)

Os eventos de item do espaço de trabalho de malha permitem que você receba notificações quando determinadas ações ocorrem em seus itens de espaço de trabalho. Por exemplo, quando um novo artefato é criado ou um artefato existente é excluído. Esses eventos podem ser usados para alertar sobre outras ações ou fluxos de trabalho no Fabric, como executar um pipeline de dados ou enviar uma notificação por e-mail usando os recursos de alerta do Ativador de Malha. Este artigo explica como explorar eventos de item do espaço de trabalho do Fabric no hub em tempo real.

Nota

Não há suporte para o consumo de eventos da Malha e do Azure por meio do fluxo de eventos ou do Ativador de Malha se a região de capacidade do fluxo de eventos ou do Ativador estiver nas seguintes regiões: Alemanha Centro-Oeste, Centro-Sul dos EUA, Oeste dos EUA2, Oeste US3, Índia Ocidental.

Exibir página de detalhes de eventos de item do espaço de trabalho de malha

  1. No hub em tempo real, selecione Eventos de malha.

  2. Selecione Eventos de item de espaço de trabalho de malha na lista.

    Captura de tela que mostra a seleção de eventos de item do espaço de trabalho Malha na página Eventos do Fabric.

  3. Você deve ver a exibição de detalhes para eventos de item do espaço de trabalho Malha.

    Captura de tela que mostra a página de detalhes dos eventos de item do espaço de trabalho Malha.

Ações

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

  • Create eventstream - permite criar um fluxo de eventos com base em eventos do item de espaço de trabalho Malha selecionado.

  • Definir alerta - permite definir um alerta quando uma operação é feita para um item de espaço de trabalho de malha, como um novo artefato é criado.

    Captura de tela que mostra ações na página de detalhes de eventos de item do espaço de trabalho Malha.

Veja o que está a utilizar esta categoria

Esta seção mostra os artefatos usando eventos de item do espaço de trabalho Malha. Aqui estão as colunas e suas descrições mostradas na lista.

Column Descrição
Name Nome do artefato que está usando eventos de item do espaço de trabalho Malha.
Type Tipo de artefato – Ativador ou fluxo de eventos
Área de trabalho Espaço de trabalho onde o artefato vive.
Origem Nome do espaço de trabalho que é a origem dos eventos.

Captura de tela que mostra a seção Ver o que está usando esta categoria na página de detalhes de eventos de item do espaço de trabalho Malha.

Perfil de eventos de item do espaço de trabalho de malha

Captura de tela que mostra a seção Perfil da página de detalhes de eventos do item do espaço de trabalho Malha.

Tipos de evento

Nome de tipo de evento Descrição
Microsoft.Fabric.ItemCreateSucceeded Esse evento é ativado quando uma operação de criação no recurso é bem-sucedida. Por exemplo, um evento produzido quando um novo artefato é criado com êxito.
Microsoft.Fabric.ItemCreateFailed Esse evento é ativado quando uma operação de criação no recurso falha. Por exemplo, um evento produzido quando um novo artefato falhou durante a criação.
Microsoft.Fabric.ItemUpdateSucceeded Esse evento é ativado quando uma operação de atualização no recurso é bem-sucedida. Por exemplo, um evento produzido quando um fluxo de dados é atualizado com êxito.
Microsoft.Fabric.ItemUpdateFailed Esse evento é ativado quando uma operação de atualização no recurso falha. Por exemplo, um evento produzido quando um fluxo de dados falhou durante a atualização.
Microsoft.Fabric.ItemDeleteSucceeded Esse evento é ativado quando uma operação de exclusão no recurso é bem-sucedida. Por exemplo, um evento produzido quando um fluxo de dados é excluído com êxito.
Microsoft.Fabric.ItemDeleteFailed Esse evento é ativado quando uma operação de exclusão no recurso falha. Por exemplo, um evento produzido quando um fluxo de dados falhou durante a exclusão.
Microsoft.Fabric.ItemReadSucceeded Esse evento é ativado quando uma operação de leitura no recurso é bem-sucedida. Por exemplo, um evento produzido quando um artefato é lido com êxito.
Microsoft.Fabric.ItemReadFailed Esse evento é ativado quando uma operação de leitura no recurso falha. Por exemplo, um evento produzido quando um artefato falhou durante a leitura.

Esquemas

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

Propriedade Type Descrição Exemplo
source string Identifica o contexto em que um evento aconteceu. 00000000-0000-0000-0000-000000000000
subject string Identifica o assunto do evento no contexto do produtor do evento. /workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000
type string Contém um valor que descreve o tipo de evento relacionado à ocorrência de origem. Microsoft.Fabric.ItemCreateSucceeded
time carimbo de data/hora Carimbo de data/hora de quando a ocorrência aconteceu. 2024-04-23T21:17:32.6029537+00:00
id string Identificador exclusivo do evento. 00000000-0000-0000-0000-000000000000
specversion string A versão da especificação do Cloud Event. 1.0
dataschemaversion String A versão do esquema de dados. 1.0
capacityId string Identificador único da capacidade. 00000000-0000-0000-0000-000000000000
domainId string Identificador exclusivo do domínio. 00000000-0000-0000-0000-000000000000

O data objeto tem as seguintes propriedades:

Propriedade Type Descrição Exemplo
itemId guid Identificador exclusivo para o item/artefato. 00000000-0000-0000-0000-000000000000
itemKind string O tipo de item/artefato. Tipo de item como Notebook, Lakehouse, etc. Consulte a próxima seção para obter uma lista de tipos de item não suportados por eventos de item de espaço de trabalho
itemName string O nome do item/artefato. Test Notebook
workspaceId guid Identificador exclusivo para o espaço de trabalho. 00000000-0000-0000-0000-000000000000
workspaceName string O nome do espaço de trabalho. Test Workspace
principalId guid Identificador exclusivo para o usuário. 00000000-0000-0000-0000-000000000000
executingPrincipalType string O tipo de usuário. User

Nota

Atualmente, não há suporte para eventos de item do espaço de trabalho de malha para os seguintes tipos de item do Power BI (itemKind):

  • Modelo semântico
  • Relatório paginado
  • Relatório
  • Aplicação
  • Dashboard