Изучение событий хранилища объектов BLOB Azure в центре Fabric Real-Time (предварительный просмотр)
В этой статье показано, как изучить события хранилища BLOB-объектов Azure в Центре реального времени Fabric. События хранилища BLOB-объектов Azure позволяют получать уведомления при выполнении определенных действий в больших двоичных объектах. Например, при создании нового большого двоичного объекта можно получить уведомление или изменить существующий большой двоичный объект. Эти события можно использовать для настройки оповещений о других действиях или рабочих процессах, таких как обновление базы данных или отправка уведомления. Эта статья содержит свойства и схему для событий хранилища BLOB-объектов Azure.
Примечание.
Использование событий Fabric и Azure через eventstream или Fabric Активатор не поддерживается, если регион емкости потока событий или активатора находится в следующих регионах: Западная Индия, Израиль Центральный, Центральная Корея, Катар Центральный, Сингапур, Центральная ОАЭ, Центральная Испания, Юго-Восточная Бразилия, Центральная часть США, Южная центральная часть США, Западная часть США 2, Западная часть США 3.
Страница сведений о событиях хранилища BLOB-объектов Azure
В центре реального времени выберите события Azure в меню навигации слева.
Выберите события хранилища BLOB-объектов Azure в списке.
Вы увидите страницу сведений о событиях хранилища BLOB-объектов Azure.
Действия
В верхней части страницы сведений о событиях хранилища BLOB-объектов Azure вы увидите следующие два действия.
Создание потока событий позволяет создать поток событий на основе событий из выбранного хранилища BLOB-объектов Azure.
Задать оповещение— позволяет задать оповещение при выполнении операции в артефакте хранилища BLOB-объектов Azure. Например, можно задать оповещение при создании или удалении большого двоичного объекта.
См. сведения об использовании этой категории
В этом разделе показаны артефакты с помощью событий Хранилище BLOB-объектов Azure. Ниже приведены столбцы и их описания, отображаемые в списке.
| Столбец | Описание: |
|---|---|
| Имя. | Имя артефакта, использующее события Хранилище BLOB-объектов Azure. |
| Тип | Тип артефакта — активатор или поток событий |
| Рабочая область | Рабочая область, в которой находится артефакт. |
| Исходный код | Имя источника (Хранилище BLOB-объектов Azure учетной записи). |
Профиль событий хранилища BLOB-объектов Azure
Типы событий
| Имя типа события | Описание: |
|---|---|
| Microsoft.Storage.BlobCreated | Это событие активируется при добавлении нового большого двоичного объекта или при обновлении существующего большого двоичного объекта. Событие активируется клиентами, использующими CreateFile операции и FlushWithClose операции, которые можно найти в REST API Azure Data Lake Storage 2-го поколения. |
| Microsoft.Storage.BlobDeleted | Это событие активируется при удалении большого двоичного объекта. Он активируется, когда клиенты используют DeleteFile операцию, которую можно найти в REST API Azure Data Lake Storage 2-го поколения. |
| Microsoft.Storage.BlobRenamed | Это событие активируется при изменении имени большого двоичного объекта, особенно если пользователи используют RenameFile функцию, найденную в Azure Data Lake Storage 2-го поколения REST API. |
| Microsoft.Storage.BlobTierChanged | Это событие активируется при изменении уровня доступа к BLOB-объектам с помощью SetBlobTier операции в REST API BLOB-объектов и активируется после полной обработки изменения. |
| Microsoft.Storage.AsyncOperationInitiated | Это событие происходит при перемещении или копировании данных из архива на горячие или холодные уровни. Это происходит, когда клиенты используют API для перемещения большого двоичного объекта из архива в горячие или холодные уровни или когда клиенты используют SetBlobTierCopyBlob API для копирования данных из большого двоичного объекта уровня архива в горячий или холодный большой двоичный объект. |
| Microsoft.Storage.DirectoryCreated | Это событие активируется при создании нового каталога или клиент использует CreateDirectory операцию, указанную в REST API Azure Data Lake Storage 2-го поколения для формирования нового каталога. |
| Microsoft.Storage.DirectoryRenamed | Это событие активируется при изменении имени каталога, особенно если клиенты используют функцию RenameDirectory в AZURE DATA LAKE STORAGE 2-ГО ПОКОЛЕНИЯ REST API. |
| Microsoft.Storage.DirectoryDeleted | Это событие активируется при удалении каталога, когда клиенты используют функциюDeleteDirectory, присутствующих в AZURE DATA LAKE STORAGE 2-ГО ПОКОЛЕНИЯ REST API. |
| Microsoft.Storage.BlobInventoryPolicyCompleted | Это событие активируется при завершении выполнения инвентаризации для политики, указанной в качестве политики инвентаризации. Он также активируется, если запуск инвентаризации завершается сбоем из-за ошибки пользователя перед началом работы, например ошибочной политикой или отсутствующим целевым контейнером. |
| Microsoft.Storage.LifecyclePolicyCompleted | Это событие относится к активации политики управления жизненным циклом при выполнении определенных действий. |
Схемы
Событие содержит следующие высокоуровневые данные:
| Свойство | Тип | Описание: | Пример |
|---|---|---|---|
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 для источника событий Хранилище BLOB-объектов Azure. | /tenants/00000000-0000-0000-0000-000000000000/workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000 |
fabricsubject |
строка | Идентификатор ссылки на событие для источника событий Хранилище BLOB-объектов Azure. | eventLinks/00000000-0000-0000-0000-000000000000 |
Объект data имеет следующие свойства.
| Свойство | Тип | Описание: | Пример |
|---|---|---|---|
api |
строка | Операция, вызвавшая событие. | CreateFile |
clientRequestId |
строка | Идентификатор предоставленного клиентом запроса для операции API хранилища. Этот идентификатор можно использовать для сопоставления с служба хранилища Azure журналов диагностики с помощью client-request-id поля в журналах и может быть предоставлен в клиентских запросах с помощью заголовкаx-ms-client-request-id. Ознакомьтесь со статьей Storage Analytics Log Format (Формат журналов Аналитики Службы хранилища). |
00000000-0000-0000-0000-000000000000 |
requestId |
строка | Создаваемый службой идентификатор запроса для операции API хранилища. Можно использовать для корреляции с служба хранилища Azure журналов диагностики с помощью request-id-header поля в журналах и возвращается из вызова API инициации вызова API в заголовкеx-ms-request-id. Ознакомьтесь со статьей Storage Analytics Log Format (Формат журналов Аналитики Службы хранилища). |
00000000-0000-0000-0000-000000000000 |
eTag |
строка | Значение, которое позволяет выполнять операции условно. | \"0x8D4BCC2E4835CD0\" |
contentType |
строка | Тип содержимого, указанный для BLOB-объекта. | text/plain |
contentLength |
integer | Размер большого двоичного объекта в байтах. | 0 |
blobType |
строка | Тип большого двоичного объекта. Допустимые значения: BlockBlob или PageBlob. |
BlockBlob |
contentOffset |
number | Смещение в байтах для операции записи, выполненной в тот момент, когда приложение, активирующее событие, завершило запись в файл. Отображается только для событий, активированных для учетных записей хранения BLOB-объектов с иерархическим пространством имен. |
0 |
destinationUrl |
строка | URL-адрес файла, который будет существовать после завершения операции. Например, если файл переименован, свойство destinationUrl содержит URL-адрес нового имени файла. Отображается только для событий, активированных для учетных записей хранения BLOB-объектов с иерархическим пространством имен. |
https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt |
sourceUrl |
строка | URL-адрес файла, который существует до завершения операции. Например, если файл переименован, sourceUrl содержит URL-адрес исходного имени файла перед операцией переименования. Отображается только для событий, активированных для учетных записей хранения BLOB-объектов с иерархическим пространством имен. |
https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-directory |
url |
строка | Путь к BLOB-объекту. Если клиент использует REST API BLOB-объектов, URL-адрес имеет следующую структуру: |
https://myaccount.blob.core.windows.net/container01/file.txt |
recursive |
строка | Значение true, чтобы выполнить операцию во всех дочерних каталогах; в противном случае значение False. Отображается только для событий, активированных для учетных записей хранения BLOB-объектов с иерархическим пространством имен. |
true |
sequencer |
строка | Значение непрозрачной строки, представляющее логическую последовательность событий для любого отдельного имени большого двоичного объекта. Пользователи могут использовать стандартное сравнение строк для понимания относительной последовательности двух событий в одном имени большого двоичного объекта. | 00000000000004420000000000028963 |
identity |
строка | Строковое значение, представляющее удостоверение, связанное с событием. Для протокола безопасной передачи файлов (SFTP) значение — это имя локального пользователя. | localuser |
storageDiagnostics |
объект | Диагностические данные, которые иногда включаются службой хранилища Azure. В настоящее время потребители событий должны игнорировать его. | {{Storage diagnostic object}} |