Explorar eventos Armazenamento de Blobs do Azure no hub em Tempo Real do Fabric (versão prévia)

Este artigo mostra como explorar eventos do Armazenamento de Blobs do Azure no hub em Tempo Real do Fabric. Os eventos do Armazenamento de Blobs do Azure permitem que você receba notificações quando determinadas ações ocorrem em seus Blobs. Por exemplo, é possível receber uma notificação quando um novo Blob for criado ou um Blob existente for modificado. É possível usar esses eventos para definir alertas sobre outras ações ou outros fluxos de trabalho, como atualizar um banco de dados ou enviar uma notificação. Este artigo fornece as propriedades e o esquema para eventos do Armazenamento de Blobs do Azure.

Observação

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.

Como realizar a exibição da página de detalhes dos eventos do Armazenamento de Blobs do Azure

1. No Hub em Tempo Real, selecione Eventos do Azure no menu de navegação à esquerda.

2. Selecione Eventos do Armazenamento de Blobs do Azure na lista.

   

3. Você deverá visualizar a página de detalhes dos eventos do Armazenamento de Blobs do Azure.

   

Ações

Na parte superior da página de detalhes dos eventos do Armazenamento de Blobs do Azure, você verá as duas ações apresentadas a seguir.

• Criar eventstream: permite criar um eventstream com base em eventos do Armazenamento de Blobs do Azure selecionado.

• Definir alerta: permite definir um alerta quando uma operação é realizada em um artefato do Armazenamento de Blobs do Azure. Por exemplo, é possível definir um alerta quando um Blob for criado ou excluído.

  

Veja o que usa esta categoria

Esta seção mostra artefatos que usam eventos do Armazenamento de Blobs do Azure. Veja a seguir as colunas e suas descrições mostradas na lista.

Coluna	Descrição
Nome	Nome do artefato que usa eventos do Armazenamento de Blobs do Azure.
Tipo	Tipo de artefato – Activator ou Eventstream
Workspace	Espaço de trabalho em que o artefato reside.
Origem	Nome da origem (conta do Armazenamento de Blobs do Azure).

Perfil de eventos do Armazenamento de Blobs do Azure

Tipos de evento

Nome do tipo de evento	Descrição
Microsoft.Storage.BlobCreated	Esse evento é ativado quando um novo Blob é adicionado ou quando um Blob existente é atualizado. O evento é acionado por clientes que usam as operações CreateFile e FlushWithClose, que podem ser encontradas na API REST do Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobDeleted	Esse evento é ativado quando um Blob é removido. Ele é acionado quando os clientes usam a operação DeleteFile que pode ser encontrada na API REST do Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobRenamed	Esse evento é ativado quando um Blob sofre uma alteração de nome, especialmente quando os usuários empregam a função RenameFile, que é encontrada na API REST do Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobTierChanged	Esse evento é ativado quando a camada de acesso do Blob é modificada por meio da operação SetBlobTier na API REST do Blob e é acionado quando a alteração é totalmente processada.
Microsoft.Storage.AsyncOperationInitiated	Esse evento ocorre quando os dados são movidos ou copiados do arquivo para as camadas de acesso frequente ou esporádico. Isso acontece quando os clientes usam a API SetBlobTier para mover um Blob do arquivo para as camadas de acesso frequente ou esporádico, ou quando os clientes usam a API CopyBlob para copiar dados de um Blob da camada de arquivo para um Blob da camada de acesso frequente ou esporádico.
Microsoft.Storage.DirectoryCreated	Esse evento é ativado quando um novo diretório é criado ou um cliente usa a operação CreateDirectory fornecida na API REST do Azure Data Lake Storage Gen2 para formar um novo diretório.
Microsoft.Storage.DirectoryRenamed	Esse evento é ativado quando um diretório sofre uma alteração de nome, especialmente quando os clientes usam o recurso RenameDirectory na API REST do Azure Data Lake Storage Gen2.
Microsoft.Storage.DirectoryDeleted	Esse evento é ativado quando um diretório é removido, quando os clientes usam o recurso DeleteDirectory presente na API REST do Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobInventoryPolicyCompleted	Esse evento é ativado quando a execução do inventário é concluída para uma política especificada como uma política de inventário. Além disso, ele é ativado se a execução do inventário falhar devido a um erro do usuário antes de começar, como uma política errada ou um contêiner de destino ausente.
Microsoft.Storage.LifecyclePolicyCompleted	Esse evento se refere à ativação de uma política de gerenciamento do ciclo de vida quando as ações definidas são executadas.

Esquemas

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

Propriedade	Tipo	Descrição	Exemplo
source	string	Caminho de recurso completo para a origem do evento. Este campo não é gravável. A Grade de Eventos fornece esse valor.	/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account
subject	string	Caminho definido pelo publicador para o assunto do evento.	/blobServices/default/containers/my-file-system/blobs/new-file.txt
type	string	Um dos tipos de evento registrados para a origem do evento.	Microsoft.Storage.BlobCreated
time	string	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.	00000000-0000-0000-0000-000000000000
data	objeto	Dados de eventos do armazenamento de blob.	{{Data object}}
specversion	string	Versão de especificação do esquema CloudEvents.	1.0
fabricsource	string	ID do fluxo de eventos do Fabric para a origem do evento do Armazenamento de Blobs do Azure.	/tenants/00000000-0000-0000-0000-000000000000/workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000
fabricsubject	string	ID do link de evento para a origem do evento do Armazenamento de Blobs do Azure.	eventLinks/00000000-0000-0000-0000-000000000000

O objeto data tem as seguintes propriedades:

Propriedade	Tipo	Descrição	Exemplo
api	string	A operação que disparou o evento.	CreateFile
clientRequestId	string	Uma ID de solicitação fornecida pelo cliente para a operação da API de armazenamento. Essa ID pode ser usada para correlacionar aos logs de diagnóstico do Armazenamento do Azure usando o campo client-request-id nos logs e pode ser fornecida em solicitações de cliente usando o cabeçalho x-ms-client-request-id. Consulte Formato de Log.	00000000-0000-0000-0000-000000000000
requestId	string	ID da solicitação gerada pelo serviço de operação da API de armazenamento. Pode ser usada para correlacionar aos logs de diagnóstico do Armazenamento do Azure usando o campo request-id-header nos logs, e retornada pela inicialização da chamada á API no cabeçalho x-ms-request-id. Consulte Formato de Log.	00000000-0000-0000-0000-000000000000
eTag	string	O valor que você pode usar para executar as operações condicionalmente.	\"0x8D4BCC2E4835CD0\"
contentType	string	O tipo de conteúdo especificado para o blob.	text/plain
contentLength	Número inteiro	O tamanho do blob em bytes.	0
blobType	string	O tipo de blob. Os valores válidos são BlockBlob ou PageBlob.	BlockBlob
contentOffset	número	O deslocamento de bytes de uma operação de gravação realizada no ponto em que o aplicativo de gatilho de evento conclui a gravação no arquivo. Aparece somente durante os eventos disparados nas contas de armazenamento de BLOBs que têm um namespace hierárquico.	0
destinationUrl	string	O arquivo com URL existirá após a conclusão da operação. Por exemplo, se um arquivo for renomeado, a propriedade destinationUrl conterá a URL do novo nome de arquivo. Aparece somente durante os eventos disparados nas contas de armazenamento de BLOBs que têm um namespace hierárquico.	https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt
sourceUrl	string	O arquivo com URL existirá antes da operação ser concluída. Por exemplo, se um arquivo for renomeado, sourceUrl conterá a URL do nome de arquivo original antes da operação de renomeação. Aparece somente durante os eventos disparados nas contas de armazenamento de BLOBs que têm um namespace hierárquico.	https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-directory
url	string	O caminho para o blob. Se o cliente usar uma API REST de Blob, a url terá essa estrutura:<storage-account-name>.blob.core.windows.net\<container-name>\<file-name>. Se o cliente usar uma API REST Data Lake Storage, a url terá essa estrutura:<storage-account-name>.dfs.core.windows.net/<file-system-name>/<file-name>.	https://myaccount.blob.core.windows.net/container01/file.txt
recursive	string	Verdadeiro para realizar a execução da operação em todos os diretórios secundários. Caso contrário, Falso. Aparece somente durante os eventos disparados nas contas de armazenamento de BLOBs que têm um namespace hierárquico.	true
sequencer	string	Um valor de cadeia de caracteres opaca que representa a sequência lógica de eventos para qualquer nome específico de blob. Os usuários podem usar a comparação de cadeia de caracteres padrão para entender a sequência relativa dos dois eventos no mesmo nome de blob.	00000000000004420000000000028963
identity	string	Um valor de cadeia de caracteres que representa a identidade associada ao evento. Para o Protocolo SFTP (Secure File Transfer Protocol), o valor é o nome de usuário local.	localuser
storageDiagnostics	objeto	Dados de diagnóstico ocasionalmente incluídos pelo serviço de Armazenamento do Azure. Quando presente, os consumidores do evento devem ignorá-lo.	{{Storage diagnostic object}}

Conteúdo relacionado

• Explorar eventos de itens do espaço de trabalho do Fabric