Поделиться через


Изучите события в хранилище BLOB-объектов Azure в Центре реального времени Fabric

В этой статье показано, как изучить события хранилища BLOB-объектов Azure в хабе Fabric Real-Time. События в хранилище BLOB-объектов Azure позволяют получать уведомления при выполнении определенных действий на ваших объектах BLOB. Например, при создании нового большого двоичного объекта можно получить уведомление или изменить существующий большой двоичный объект. Эти события можно использовать для настройки оповещений о других действиях или рабочих процессах, таких как обновление базы данных или отправка уведомления. Эта статья представляет свойства и схему для событий хранилища объектов BLOB Azure.

Примечание.

Использование событий Fabric и Azure через Eventstream или Активатор Fabric не поддерживается, если регион емкости Eventstream или Активатора находится в следующих регионах: Западная Индия, Центральный Катар, Сингапур, Центральный ОАЭ, Юго-Восточная Бразилия.

Просмотреть страницу подробных сведений о событиях хранилища BLOB-объектов Azure

  1. В центре реального времени выберите события Azure в меню навигации слева.

  2. Выберите события Blob-хранилища Azure в списке.

    Снимок экрана, показывающий выборку событий хранилища BLOB-объектов Azure на странице событий Azure.

  3. Вам следует видеть страницу сведений о событиях хранилища Azure Blob.

    Снимок экрана, показывающий страницу сведений о событиях хранилища объектов Azure.

Действия

В верхней части страницы сведений о событиях в хранилище BLOB-объектов Azure вы увидите два следующих действия.

  • Создание потока событий позволяет создать поток событий на основе событий из выбранного хранилища BLOB-объектов Azure.

  • Установить оповещение — позволяет настроить уведомление при выполнении операции на объекте хранилища BLOB-объектов Azure. Например, можно задать оповещение при создании или удалении блоба.

    Снимок экрана: раздел

Узнайте, что использует эту категорию

В этом разделе показаны артефакты, связанные с событиями хранилища BLOB-объектов Azure. Ниже приведены столбцы и их описания, отображаемые в списке.

Столбец Описание:
Имя. Имя артефакта, использующего события в хранилище Blob Azure.
Тип Тип артефакта — активатор или поток событий
Рабочая область Рабочая область, в которой находится артефакт.
Источник Имя источника – учетная запись хранилища BLOB-объектов Azure.

Снимок экрана, показывающий, какие элементы используют раздел на странице сведений о событиях хранилища BLOB-объектов Azure.

Профиль событий хранилища объектов BLOB в Azure

Снимок экрана, показывающий раздел профиля событий на странице сведений о событиях в хранилище BLOB-объектов Azure.

Типы событий

Имя типа события Описание:
Microsoft.Storage.Blob создан Это событие активируется при добавлении нового большого двоичного объекта или при обновлении существующего большого двоичного объекта. Событие активируется клиентами, использующими CreateFile и FlushWithClose операции, которые можно найти в REST API Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobDeleted Это событие активируется при удалении двоичного объекта. Он активируется, когда клиенты используют DeleteFile операцию, которую можно найти в REST API Azure Data Lake Storage 2-го поколения.
Microsoft.Storage.BlobRenamed Это событие активируется при изменении имени объекта Blob, особенно если пользователи используют функцию RenameFile, найденную в REST API Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobTierChanged Это событие активируется при изменении уровня доступа к BLOB-объектам с помощью SetBlobTier операции в REST API BLOB-объектов и активируется после полной обработки изменения.
Microsoft.Storage.AsyncOperationInitiated Это событие происходит при перемещении или копировании данных из архива на горячие или холодные уровни. Это происходит, когда клиенты используют SetBlobTier API для перемещения блоба из архива в горячие или холодные уровни, или когда клиенты используют CopyBlob API для копирования данных из блоба уровня архива в горячий или холодный блоб.
Майкрософт.Хранилище.ДиректорияСоздана Это событие активируется при создании нового каталога или клиент использует CreateDirectory операцию, указанную в REST API Azure Data Lake Storage 2-го поколения для формирования нового каталога.
Microsoft.Storage.DirectoryRenamed Это событие активируется при изменении имени каталога, особенно если клиенты используют функцию RenameDirectory в AZURE DATA LAKE STORAGE 2-ГО ПОКОЛЕНИЯ REST API.
Microsoft.Storage.КаталогУдалён Это событие активируется при удалении каталога, когда клиенты используют функцию DeleteDirectory, доступную в REST API Azure Data Lake Storage Gen2.
Политика инвентаризации блобов Microsoft.Storage завершена Это событие активируется при завершении выполнения инвентаризации для политики, указанной в качестве политики инвентаризации. Он также активируется, если запуск инвентаризации завершается сбоем из-за ошибки пользователя перед началом работы, например ошибочной политикой или отсутствующим целевым контейнером.
Microsoft.Storage.ЗавершениеПолитикиЖизненногоЦикла Это событие относится к активации политики управления жизненным циклом при выполнении определенных действий.

Схемы

Событие содержит следующие высокоуровневые данные:

Имущество Тип Описание: Пример
source строка Полный путь к ресурсу источника событий. Это поле недоступно для записи. Это значение предоставляет Сетка событий. /subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account
subject строка Указанный издателем путь к теме события. /blobServices/default/containers/my-file-system/blobs/new-file.txt
type строка Один из зарегистрированных типов событий для этого источника событий. Microsoft.Storage.BlobCreated
time строка Время создания события определяется на основе времени поставщика в формате UTC. 2017-06-26T18:41:00.9584103Z
id строка Уникальный идентификатор события. 00000000-0000-0000-0000-000000000000
data объект Данные события хранилища объектов BLOB. {{Data object}}
specversion строка Версия спецификации схемы CloudEvents. 1.0
fabricsource строка Идентификатор потока событий Fabric для источника событий Azure Blob Storage. /tenants/00000000-0000-0000-0000-000000000000/workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000
fabricsubject строка Идентификатор события для источника Azure Blob Storage. eventLinks/00000000-0000-0000-0000-000000000000

Объект data имеет следующие свойства.

Имущество Тип Описание: Пример
api строка Операция, вызвавшая событие. CreateFile
clientRequestId строка Идентификатор предоставленного клиентом запроса для операции API хранилища. Этот идентификатор можно использовать для сопоставления с журналами диагностики службы хранилища Azure с помощью поля client-request-id в журналах и может быть предоставлен в клиентских запросах с помощью заголовка x-ms-client-request-id. См. формат журнала. 00000000-0000-0000-0000-000000000000
requestId строка Создаваемый службой идентификатор запроса для операции API хранилища. Можно использовать для корреляции с журналами диагностики Azure Storage с помощью поля request-id-header в журналах, и это возвращается от вызова API в заголовке x-ms-request-id. См. формат журнала. 00000000-0000-0000-0000-000000000000
eTag строка Значение, которое позволяет выполнять операции условно. \"0x8D4BCC2E4835CD0\"
contentType строка Тип содержимого, указанный для BLOB-объекта. text/plain
contentLength целое число Размер BLOB в байтах. 0
blobType строка Тип бинарного объекта. Допустимые значения: BlockBlob или PageBlob. BlockBlob
contentOffset число Смещение в байтах для операции записи, выполненной в тот момент, когда приложение, инициирующее событие, завершило запись в файл.

Появляется только для событий, происходящих в учетных записях блоб-хранилища с иерархическим пространством имен.

0
destinationUrl строка URL-адрес файла, который будет существовать после завершения операции. Например, если файл переименован, свойство destinationUrl содержит URL-адрес нового имени файла.

Появляется только для событий, происходящих в учетных записях блоб-хранилища с иерархическим пространством имен.

https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt
sourceUrl строка URL-адрес файла, который существует до завершения операции. Например, если файл переименован, sourceUrl содержит URL-адрес исходного имени файла перед операцией переименования.

Появляется только для событий, происходящих в учетных записях блоб-хранилища с иерархическим пространством имен.

https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-directory
url строка Путь к блобу.

Если клиент использует REST API BLOB-объектов, URL-адрес имеет следующую структуру: <storage-account-name>.blob.core.windows.net\<container-name>\<file-name>. Если клиент использует REST API Data Lake Storage, URL-адрес имеет следующую структуру: <storage-account-name>.dfs.core.windows.net/<file-system-name>/<file-name>.

https://myaccount.blob.core.windows.net/container01/file.txt
recursive строка Значение True, чтобы выполнить операцию во всех дочерних каталогах; в противном случае значение False.

Появляется только для событий, происходящих в учетных записях блоб-хранилища с иерархическим пространством имен.

true
sequencer строка Непрозрачное буквенное значение, представляющее логическую последовательность событий для любого конкретного имени блоба. Пользователи могут использовать стандартное сравнение строк для понимания относительной последовательности двух событий в одном имени большого двоичного объекта. 00000000000004420000000000028963
identity строка Строковое значение, представляющее идентификатор, связанный с событием. Для протокола безопасной передачи файлов (SFTP) значение — это имя локального пользователя. localuser
storageDiagnostics объект Диагностические данные, которые иногда включаются службой хранилища Azure. При наличии потребители событий должны игнорировать его. {{Storage diagnostic object}}

Разрешение подписки

Дополнительные сведения см. в разделе разрешения на подписку на события Fabric.