探索 Fabric 即時中樞中的 Azure Blob 記憶體事件 （預覽）

注意

實時中樞目前為預覽狀態。

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

注意

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

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

1. 在 [即時中樞] 中，切換至 [網狀架構事件] 索引標籤。

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

   

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

   

動作

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

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

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

  

查看使用此類別的內容

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

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

Azure Blob 記憶體事件配置檔

事件類型

事件類型名稱	描述
Microsoft.Storage.BlobCreated	當新增 Blob 或更新現有的 Blob 時，就會啟動此事件。 事件是由使用 CreateFile 和 FlushWithClose 作業的用戶端所觸發，您可以在 Azure Data Lake Storage Gen2 REST API 中找到此事件。
Microsoft.Storage.BlobDeleted	拿掉 Blob 時會啟動此事件。 當用戶端使用 DeleteFile 可在 Azure Data Lake Storage Gen2 REST API 中找到的作業時，就會觸發此作業。
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 或非經常性存取層 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。 例如，如果檔案已重新命名，destinationUrl 屬性會包含新檔名的 URL。 只有當事件是在具有階層命名空間的 Blob 儲存體帳戶上觸發時，才會出現此情形。	https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt
sourceUrl	string	作業完成之前就存在的檔案 URL。 例如，如果檔案已重新命名，sourceUrl 會在重新命名作業之前包含源檔名稱的 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	字串	True 是表示 在所有子目錄上執行作業;否則為 False。 只有當事件是在具有階層命名空間的 Blob 儲存體帳戶上觸發時，才會出現此情形。	true
sequencer	string	不透明的字串值表示任何特定 Blob 名稱之事件的邏輯順序。 使用者可使用標準字串比較，以了解 Blob 名稱相同之兩個事件的相對順序。	00000000000004420000000000028963
identity	string	字串值，表示與事件相關聯的身分識別。 若為 SFTP，此值為本機用戶名稱。	localuser
storageDiagnostics	object	Azure 儲存體服務偶爾包含診斷資料。 當存在時，事件取用者應該忽略它。	{{Storage diagnostic object}}

相關內容

• 探索 Fabric 工作區專案事件