探索 Fabric 實時中樞中的 Azure Blob 記憶體事件

本文說明如何在 Fabric 實時中樞探索 Azure Blob 記憶體事件。 Azure Blob 記憶體事件可讓您在 Blob 上發生特定動作時收到通知。 例如，您可以在建立新的 Blob 或修改現有的 Blob 時收到通知。 這些事件可用來設定其他動作或工作流程的警示，例如更新資料庫或傳送通知。 本文提供 blob 儲存體事件的屬性與結構描述。

注意

此功能目前為預覽功能。

注意

如果 Eventstream 或 Activator 的容量區域位於下列區域，則不支援透過 eventstream 或 Fabric 啟動器取用 Fabric 和 Azure 事件：德國中西部、美國中南部、美國西部 2、美國西部 3、印度西部。

檢視 Azure Blob 記憶體事件詳細數據頁面

1. 在 [實時中樞] 中，選取 左側導覽功能表上的 [Azure 事件 ]。

2. 在清單中選取 [Azure Blob 記憶體事件 ]。

   

3. 您應該會看到 Azure Blob 記憶體事件詳細數據頁面。

   

動作

在 Azure Blob 記憶體事件詳細數據頁面頂端，您會看到下列兩個動作。

• 建立 eventstream - 可讓您根據所選 Azure Blob 記憶體的事件來建立事件串流。

• 設定警示 - 可讓您在 Azure Blob 記憶體成品上完成作業時設定警示。 例如，您可以在建立或刪除 Blob 時設定警示。

  

查看使用此類別的內容

本節顯示使用 Azure Blob 儲存體 事件的成品。 以下是清單中顯示的數據列及其描述。

資料行	描述
名稱	使用 Azure Blob 儲存體 事件的成品名稱。
類型	成品類型 – 啟動器或 Eventstream
工作區	成品所在的工作區。
來源	= Azure 資源的儲存體帳戶名稱。

Azure Blob 記憶體事件配置檔

事件類型

事件類型名稱	描述
Microsoft.Storage.BlobCreated	當新增 Blob 或更新現有的 Blob 時，就會啟動此事件。 事件是由使用 CreateFile 和 FlushWithClose 作業的用戶端所觸發，您可以在 Azure Data Lake Storage Gen2 REST API 中找到此事件。
Microsoft.Storage.BlobDeleted	拿掉 Blob 時會啟動此事件。 具體來說，當用戶端使用 Azure Data Lake Storage Gen2 REST API 中可用的 DeleteFile 作業時，就會觸發此事件。
Microsoft.Storage.BlobRenamed	此事件會在 Blob 進行名稱變更時啟動，特別是當用戶採用 RenameFile Azure Data Lake Storage Gen2 REST API 中找到的函式時。
Microsoft.Storage.BlobTierChanged	當 Blob 存取層透過 SetBlobTier Blob REST API 中的作業進行修改時，就會啟動此事件，並在完全處理變更後觸發。
Microsoft.Storage.AsyncOperationInitiated	當數據從封存移至經常性存取層或非經常性存取層時，就會發生此事件。 具體來說，當用戶端呼叫 SetBlobTier API 以便將 Blob 從封存存取層移至經常性存取層或非經常性存取層時，或是當用戶端呼叫 CopyBlob API 以便將資料從封存存取層中的 Blob 複製到經常性存取層或非經常性存取層中的 Blob 時，就會觸發此事件。
Microsoft.Storage.DirectoryCreated	建立新目錄時會啟動此事件，或用戶端會利用 CreateDirectory Azure Data Lake Storage Gen2 REST API 中提供的作業來形成新的目錄。
Microsoft.Storage.DirectoryRenamed	當目錄進行名稱變更時，會啟動此事件，特別是當用戶端在 Azure Data Lake Storage Gen2 REST API 中使用 RenameDirectory 功能時。
Microsoft.Storage.DirectoryDeleted	當移除目錄時，當客戶利用 DeleteDirectory Azure Data Lake Storage Gen2 REST API 中的功能時，就會啟動此事件。
Microsoft.Storage.BlobInventoryPolicyCompleted	當清查執行完成指定為清查原則的原則時，就會啟動此事件。 如果清查執行因使用者錯誤在開始前失敗，例如錯誤原則或不存在的目的地容器，也會啟動它。
Microsoft.Storage.LifecyclePolicyCompleted	此事件是指在執行其已定義動作時啟用生命週期管理原則。

結構描述

事件具有下列的最高層級資料：

屬性	類型​	描述	範例
source	字串	事件來源的完整資源路徑。 此欄位無法寫入。 事件方格提供此值。	/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account
subject	string	發行者定義事件主旨的路徑。	/blobServices/default/containers/my-file-system/blobs/new-file.txt
type	string	此事件來源已註冊的事件類型之一。	Microsoft.Storage.BlobCreated
time	string	事件產生的時間，以提供者的 UTC 時間為準。	2017-06-26T18:41:00.9584103Z
id	string	事件的唯一識別碼。	00000000-0000-0000-0000-000000000000
data	object	blob 儲存體帳戶。	{{Data object}}
specversion	string	CloudEvents 結構描述規格版本。	1.0
fabricsource	字串	Azure Blob 儲存體 事件來源的 Fabric 事件資料流標識碼。	/tenants/00000000-0000-0000-0000-000000000000/workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000
fabricsubject	字串	Azure Blob 儲存體 事件來源的事件鏈接標識碼。	eventLinks/00000000-0000-0000-0000-000000000000

data 物件具有下列屬性：

屬性	類型​	描述	範例
api	字串	觸發事件的作業。	CreateFile
clientRequestId	string	儲存體 API 作業由用戶端所提供的要求識別碼。 此標識碼可用來使用client-request-id記錄中的字段來 Azure 儲存體 診斷記錄相互關聯，而且可以使用標頭在用戶端要求x-ms-client-request-id中提供。 請參閱記錄格式。	00000000-0000-0000-0000-000000000000
requestId	string	儲存體 API 作業由服務所產生的要求識別碼。 可以用來與request-id-header使用記錄中的欄位來 Azure 儲存體 診斷記錄相互關聯，並從標頭中x-ms-request-id起始 API 呼叫傳回。 請參閱記錄格式。	00000000-0000-0000-0000-000000000000
eTag	string	此值可讓您依條件執行作業。	\"0x8D4BCC2E4835CD0\"
contentType	string	為 blob 指定內容類型。	text/plain
contentLength	整數	Blob 大小 (以位元組為單位)。	0
blobType	string	Blob 的類型。 有效值為 BlockBlob 或 PageBlob。	BlockBlob
contentOffset	數值	在事件觸發應用程式完成寫入至檔案的作業時，所發生的寫入作業的位元組位移。 只有當事件是在具有階層命名空間的 Blob 儲存體帳戶上觸發時，才會出現此情形。	0
destinationUrl	string	作業完成之後會存在的檔案 URL。 例如，如果重新命名檔案， 屬性會包含新檔案名稱的 URL。 只有當事件是在具有階層命名空間的 Blob 儲存體帳戶上觸發時，才會出現此情形。	https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt
sourceUrl	string	作業完成之前就存在的檔案 URL。 例如，如果重新命名檔案，則 會包含在重新命名作業之前的原始檔案名稱 URL。 只有當事件是在具有階層命名空間的 Blob 儲存體帳戶上觸發時，才會出現此情形。	https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-directory
url	string	blob 的路徑。 如果用戶端使用 Blob REST API，則 URL 會具有此結構：<storage-account-name>.blob.core.windows.net\<container-name>\<file-name>。 如果用戶端使用 Data Lake Storage REST API，則 URL 會具有此結構：<storage-account-name>.dfs.core.windows.net/<file-system-name>/<file-name>。	https://myaccount.blob.core.windows.net/container01/file.txt
recursive	字串	可在所有子目錄上執行作業；否則為 。 只有當事件是在具有階層命名空間的 Blob 儲存體帳戶上觸發時，才會出現此情形。	true
sequencer	string	不透明的字串值表示任何特定 Blob 名稱之事件的邏輯順序。 使用者可使用標準字串比較，以了解 Blob 名稱相同之兩個事件的相對順序。	00000000000004420000000000028963
identity	string	字串值，表示與事件相關聯的身分識別。 針對安全檔案傳輸通訊協定 （SFTP），值為本機用戶名稱。	localuser
storageDiagnostics	object	Azure 儲存體服務偶爾包含診斷資料。 出現時，事件消費者應該予以忽略。	{{Storage diagnostic object}}

相關內容

• 探索 Fabric 工作區專案事件