Exploración de eventos de Azure Blob Storage en Fabric Real-Time Hub (versión preliminar)
En este artículo se muestra cómo explorar eventos de almacenamiento de blobs de Azure en el centro en tiempo real de Fabric. Los eventos de almacenamiento de blobs de Azure permiten recibir notificaciones cuando se producen determinadas acciones en los blobs. Por ejemplo, puede recibir una notificación cuando se crea un blob o se modifica un blob existente. Estos eventos se pueden usar para establecer alertas en otras acciones o flujos de trabajo, como actualizar una base de datos o enviar una notificación. En este artículo se proporcionan las propiedades y el esquema de los eventos de almacenamiento de blobs de Azure.
Nota:
No se admite el consumo de eventos de Fabric y Azure mediante el flujo de eventos o Fabric Activator si la región de capacidad del flujo de eventos o Activator se encuentra en las siguientes regiones: Centro-oeste de Alemania, Centro-sur de EE. UU., Oeste de EE. UU. 2, Oeste de EE. UU. 3 u Oeste de la India.
Visualización de la página de detalles de eventos de almacenamiento de blobs de Azure
En centro en tiempo real, seleccione Eventos de Azure en el menú de navegación izquierdo.
Seleccione Eventos de almacenamiento de blobs de Azure en la lista.
Debería ver la página de detalles de eventos de almacenamiento de blobs de Azure.
Acciones
En la parte superior de la página de detalles de eventos de almacenamiento de blobs de Azure, verá las dos acciones siguientes.
Creación de secuencia de eventos: permite crear una secuencia de eventos en función de los eventos del almacenamiento de blobs de Azure seleccionado.
Establecer alerta: permite establecer una alerta cuando se realiza una operación en un artefacto de almacenamiento de blobs de Azure. Por ejemplo, puede establecer una alerta cuando se crea o elimina un blob.
Visualización de lo que usa esta categoría
En esta sección se muestran artefactos mediante eventos de almacenamiento de blobs de Azure. Estas son las columnas y sus descripciones que se muestran en la lista.
| Columna | Descripción |
|---|---|
| Nombre | Nombre del artefacto que usa eventos de Azure Blob Storage. |
| Tipo | Tipo de artefacto: Activator o Eventstream |
| Área de trabajo | Área de trabajo donde reside el artefacto. |
| Source | Nombre del recurso (cuenta de Azure Blob Storage). |
Perfil de eventos de almacenamiento de blobs de Azure
Tipos de evento
| Nombre de tipo de evento | Descripción |
|---|---|
| Microsoft.Storage.BlobCreated | Este evento se activa cuando se agrega un nuevo blob o cuando se actualiza un blob existente. Los clientes que usan las operaciones CreateFile y FlushWithClose desencadenan el evento, que se puede encontrar en la API REST de Azure Data Lake Storage Gen2. |
| Microsoft.Storage.BlobDeleted | Este evento se activa cuando se quita un blob. Se desencadena cuando los clientes usan la operación DeleteFile que se puede encontrar en la API REST de Azure Data Lake Storage Gen2. |
| Microsoft.Storage.BlobRenamed | Este evento se activa cuando un blob se somete a un cambio de nombre, especialmente cuando los usuarios emplean la función RenameFile que se encuentra en la API REST de Azure Data Lake Storage Gen2. |
| Microsoft.Storage.BlobTierChanged | Este evento se activa cuando se modifica el nivel de acceso de blobs mediante la operación SetBlobTier en la API REST Blob y se desencadena una vez que el cambio se procesa por completo. |
| Microsoft.Storage.AsyncOperationInitiated | Este evento se produce cuando los datos se mueven o copian del archivo a los niveles de acceso frecuente o esporádico. Se produce cuando los clientes llaman a la API SetBlobTier para mover un blob del nivel de archivo al nivel de acceso frecuente o esporádico, o bien cuando los clientes usan la API CopyBlob para copiar datos de un blob en el nivel de acceso de archivo a un blob en el nivel de acceso frecuente o esporádico. |
| Microsoft.Storage.DirectoryCreated | Este evento se activa cuando se crea un directorio o un cliente utiliza la operación CreateDirectory proporcionada en la API REST de Azure Data Lake Storage Gen2 para formar un nuevo directorio. |
| Microsoft.Storage.DirectoryRenamed | Este evento se activa cuando un directorio se somete a un cambio de nombre, especialmente cuando los clientes usan la característica RenameDirectory en la API REST de Azure Data Lake Storage Gen2. |
| Microsoft.Storage.DirectoryDeleted | Este evento se activa cuando se quita un directorio, cuando los clientes usan la característica DeleteDirectory presente en la API REST de Azure Data Lake Storage Gen2. |
| Microsoft.Storage.BlobInventoryPolicyCompleted | Este evento se activa cuando la ejecución del inventario finaliza para una directiva que se especifica como una directiva de inventario. También se activa si se produce un error en la ejecución del inventario debido a un error de usuario antes de comenzar, como una directiva errónea o un contenedor de destino ausente. |
| Microsoft.Storage.LifecyclePolicyCompleted | Este evento hace referencia a la activación de una directiva de administración del ciclo de vida cuando se ejecutan sus acciones definidas. |
Esquemas
Un evento tiene los siguientes datos de nivel superior:
| Propiedad | Tipo | Descripción | Ejemplo |
|---|---|---|---|
source |
string | Ruta de acceso completa a los recursos del origen del evento. En este campo no se puede escribir. Event Grid proporciona este valor. | /subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account |
subject |
string | Ruta al asunto del evento definida por el anunciante. | /blobServices/default/containers/my-file-system/blobs/new-file.txt |
type |
string | Uno de los tipos de eventos registrados para este origen de eventos. | Microsoft.Storage.BlobCreated |
time |
string | La hora de generación del evento en función de la hora UTC del proveedor. | 2017-06-26T18:41:00.9584103Z |
id |
string | Identificador único para el evento | 00000000-0000-0000-0000-000000000000 |
data |
object | Datos de eventos de Blob Storage. | {{Data object}} |
specversion |
string | Versión de especificación del esquema CloudEvents. | 1.0 |
fabricsource |
string | Id. del Eventstream de Fabric para el origen del evento de Azure Blob Storage. | /tenants/00000000-0000-0000-0000-000000000000/workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000 |
fabricsubject |
string | Id. del vínculo de evento para el origen del evento de Azure Blob Storage. | eventLinks/00000000-0000-0000-0000-000000000000 |
El objeto data tiene las siguientes propiedades:
| Propiedad | Tipo | Descripción | Ejemplo |
|---|---|---|---|
api |
string | Operación que desencadenó el evento. | CreateFile |
clientRequestId |
string | Id. de solicitud que proporciona el cliente para la operación de la API de almacenamiento. Este identificador se puede usar para correlacionar los registros de diagnóstico de Azure Storage mediante el campo client-request-id de los registros y se puede proporcionar en las solicitudes de cliente mediante el encabezado x-ms-client-request-id. Consulte Storage Analytics Log Format (Formato de registro de Storage Analytics). |
00000000-0000-0000-0000-000000000000 |
requestId |
string | Id. de solicitud generado por el servicio para la operación de la API de Storage. Se puede usar para establecer la correlación con los registros de diagnóstico de Azure Storage que usan el campo request-id-header en los registros y se devuelve cuando se inicia la llamada API en el encabezado x-ms-request-id. Consulte Storage Analytics Log Format (Formato de registro de Storage Analytics). |
00000000-0000-0000-0000-000000000000 |
eTag |
string | Valor que puede usar para ejecutar operaciones de manera condicional. | \"0x8D4BCC2E4835CD0\" |
contentType |
string | Tipo de contenido especificado para el blob. | text/plain |
contentLength |
integer | Tamaño del blob en bytes. | 0 |
blobType |
string | El tipo de blob. Los valores válidos son BlockBlob o PageBlob. |
BlockBlob |
contentOffset |
number | Desplazamiento en bytes de una operación de escritura realizada en el punto en el que la aplicación de desencadenamiento de eventos completa la escritura del archivo. Solo aparece para los eventos desencadenados en las cuentas de almacenamiento de blobs que tienen un espacio de nombres jerárquico. |
0 |
destinationUrl |
string | Dirección URL del archivo que existirá una vez completada la operación. Por ejemplo, si se cambia el nombre de un archivo, la propiedad destinationUrl contiene la dirección URL del nuevo nombre de archivo. Solo aparece para los eventos desencadenados en las cuentas de almacenamiento de blobs que tienen un espacio de nombres jerárquico. |
https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt |
sourceUrl |
string | Dirección URL del archivo que existe antes de completarse la operación. Por ejemplo, si se cambia el nombre de un archivo, sourceUrl contiene la dirección URL del nombre de archivo original antes de la operación de cambio de nombre. Solo aparece para los eventos desencadenados en las cuentas de almacenamiento de blobs que tienen un espacio de nombres jerárquico. |
https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-directory |
url |
string | Ruta de acceso al blob. Si el cliente usa una API REST de blobs, la dirección URL tiene esta estructura: |
https://myaccount.blob.core.windows.net/container01/file.txt |
recursive |
string | True para ejecutar la operación en todos los directorios secundarios; en caso contrario, es False. Solo aparece para los eventos desencadenados en las cuentas de almacenamiento de blobs que tienen un espacio de nombres jerárquico. |
true |
sequencer |
string | Un valor de cadena opaco que representa la secuencia lógica de eventos para cualquier nombre de blob concreto. Los usuarios pueden usar una comparación de cadenas estándar para conocer la secuencia relativa de dos eventos que estén en el mismo nombre de blob. | 00000000000004420000000000028963 |
identity |
string | El valor de esta cadena representa a la identidad que esté asociada con el evento. En Secure File Transfer Protocol (SFTP), el valor es el nombre de usuario local. | localuser |
storageDiagnostics |
object | Datos de diagnóstico que, en ocasiones, incluye el servicio Azure Storage. Cuando está presente, los consumidores de eventos deben ignorarlo. | {{Storage diagnostic object}} |