Utforska Azure Blob Storage-händelser i Fabric Real-Time Hub
Den här artikeln visar hur du utforskar Azure Blob Storage-händelser i Fabric Real-Time Hub. Med Azure Blob Storage-händelser kan du ta emot meddelanden när vissa åtgärder inträffar på dina blobar. Du kan till exempel få ett meddelande när en ny blob skapas eller om en befintlig blob ändras. Dessa händelser kan användas för att ange aviseringar för andra åtgärder eller arbetsflöden, till exempel att uppdatera en databas eller skicka ett meddelande. Den här artikeln innehåller egenskaper och schema för Azure Blob Storage-händelser.
Kommentar
Den här funktionen finns i förhandsgranskning.
Kommentar
Användning av Fabric- och Azure-händelser via eventstream eller Fabric Activator stöds inte om kapacitetsregionen för eventstream eller Activator finns i följande regioner: Tyskland, västra centrala, USA, södra centrala, USA, västra 2, USA, västra 3, västra Indien.
Visa informationssidan för Azure Blob Storage-händelser
I Realtidshubben väljer du Azure-händelser på den vänstra navigeringsmenyn.
Välj Azure Blob Storage-händelser i listan.
Du bör se informationssidan för Azure Blob Storage-händelser.
Åtgärder
Överst på informationssidan för Azure Blob Storage-händelser visas följande två åtgärder.
Skapa eventstream – låter dig skapa en händelseström baserat på händelser från den valda Azure Blob Storage.
Ange avisering – låter dig ange en avisering när en åtgärd utförs på en Azure Blob Storage-artefakt. Du kan till exempel ange en avisering när en blob skapas eller tas bort.
Se vad som använder den här kategorin
Det här avsnittet visar artefakter som använder Azure Blob Storage-händelser. Här är kolumnerna och deras beskrivningar som visas i listan.
| Kolumn | Beskrivning |
|---|---|
| Name | Namnet på artefakten som använder Azure Blob Storage-händelser. |
| Typ | Artefakttyp – Aktivator eller Händelseström |
| Arbetsyta | Arbetsyta där artefakten finns. |
| Källa | Namnet på källan (Azure Blob Storage-konto). |
Händelseprofil för Azure Blob Storage
Händelsetyper
| Händelsetypens namn | beskrivning |
|---|---|
| Microsoft.Storage.BlobSkapat | Den här händelsen aktiveras när en ny blob läggs till eller när en befintlig blob uppdateras. Händelsen utlöses av klienter som använder CreateFile och FlushWithClose -åtgärderna, som finns i REST-API:et för Azure Data Lake Storage Gen2. |
| Microsoft.Storage.BlobDeleted | Den här händelsen aktiveras när en blob tas bort. Den utlöses när klienter använder den DeleteFile åtgärd som finns i REST-API:et för Azure Data Lake Storage Gen2. |
| Microsoft.Storage.BlobRenamed | Den här händelsen aktiveras när en blob genomgår en namnändring, särskilt när användare använder funktionen RenameFile som finns i Rest-API:et för Azure Data Lake Storage Gen2. |
| Microsoft.Storage.BlobTierChanged | Den här händelsen aktiveras när blobåtkomstnivån ändras via SetBlobTier åtgärden i BLOB REST-API:et och utlöses när ändringen har bearbetats fullständigt. |
| Microsoft.Storage.AsyncOperationInitiated | Den här händelsen inträffar när data flyttas eller kopieras från arkivet till frekventa eller lågfrekventa nivåer. Det händer när klienter använder API:et SetBlobTier för att flytta en blob från arkiv till frekvent eller lågfrekvent nivå, eller när klienter använder API:et CopyBlob för att kopiera data från en arkivnivåblob till en frekvent eller lågfrekvent blob. |
| Microsoft.Storage.DirectorySkapat | Den här händelsen aktiveras när en ny katalog skapas, eller när en klient använder åtgärden CreateDirectory som anges i REST-API:et för Azure Data Lake Storage Gen2 för att skapa en ny katalog. |
| Microsoft.Storage.DirectoryRenamed | Den här händelsen aktiveras när en katalog genomgår en namnändring, särskilt när klienter använder funktionen RenameDirectory i REST API:et för Azure Data Lake Storage Gen2. |
| Microsoft.Storage.DirectoryTa bort | Den här händelsen aktiveras när en katalog tas bort, när kunder använder funktionen DeleteDirectory som finns i REST-API:et för Azure Data Lake Storage Gen2. |
| Microsoft.Storage.BlobInventoryPolicyCompleted | Den här händelsen aktiveras när inventeringskörningen slutförs för en princip som anges som en inventeringsprincip. Den aktiveras också om inventeringskörningen misslyckas på grund av ett användarfel innan den påbörjas, till exempel en felaktig princip eller en frånvarande målcontainer. |
| Microsoft.Storage.LifecyclePolicyCompleted | Den här händelsen refererar till aktiveringen av en livscykelhanteringsprincip när dess definierade åtgärder körs. |
Scheman
En händelse har följande data på den översta nivån:
| Property | Type | Beskrivning | Exempel |
|---|---|---|---|
source |
sträng | Fullständig resurssökväg till händelsekällan. Det här fältet kan inte skrivas. Event Grid ger det här värdet. | /subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account |
subject |
sträng | Utgivardefinierad sökväg till händelseobjektet. | /blobServices/default/containers/my-file-system/blobs/new-file.txt |
type |
sträng | En av de registrerade händelsetyperna för den här händelsekällan. | Microsoft.Storage.BlobCreated |
time |
sträng | Den tid då händelsen genereras baserat på leverantörens UTC-tid. | 2017-06-26T18:41:00.9584103Z |
id |
sträng | Unik identifierare för händelsen. | 00000000-0000-0000-0000-000000000000 |
data |
objekt | Händelsedata för Blob Storage. | {{Data object}} |
specversion |
sträng | CloudEvents schemaspecifikationsversion. | 1.0 |
fabricsource |
sträng | ID för Fabric-händelseströmmen för Azure Blob Storage-händelsekällan. | /tenants/00000000-0000-0000-0000-000000000000/workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000 |
fabricsubject |
sträng | ID för händelselänken för Azure Blob Storage-händelsekällan. | eventLinks/00000000-0000-0000-0000-000000000000 |
Objektet data har följande egenskaper:
| Property | Type | Beskrivning | Exempel |
|---|---|---|---|
api |
sträng | Åtgärden som utlöste händelsen. | CreateFile |
clientRequestId |
sträng | Ett begärande-ID som tillhandahålls av klienten för lagrings-API-åtgärden. Det här ID:t kan användas för att korrelera med Azure Storage-diagnostikloggar med hjälp av client-request-id fältet i loggarna och kan anges i klientbegäranden med hjälp av x-ms-client-request-id huvudet. Se Loggformat. |
00000000-0000-0000-0000-000000000000 |
requestId |
sträng | Tjänstgenererat begärande-ID för lagrings-API-åtgärden. Kan användas för att korrelera till Azure Storage-diagnostikloggar med hjälp av request-id-header fältet i loggarna och returneras från att API-anropet initieras i x-ms-request-id huvudet. Se Loggformat. |
00000000-0000-0000-0000-000000000000 |
eTag |
sträng | Det värde som du kan använda för att köra åtgärder villkorligt. | \"0x8D4BCC2E4835CD0\" |
contentType |
sträng | Den innehållstyp som angetts för bloben. | text/plain |
contentLength |
integer | Storleken på bloben i byte. | 0 |
blobType |
sträng | Typen av blob. Giltiga värden är antingen BlockBlob eller PageBlob. |
BlockBlob |
contentOffset |
Nummer | Förskjutningen i byte av en skrivåtgärd som utfördes vid den tidpunkt då det händelseutlösande programmet slutförde skrivning till filen. Visas endast för händelser som utlöses på bloblagringskonton som har ett hierarkiskt namnområde. |
0 |
destinationUrl |
sträng | Url:en för filen som ska finnas när åtgärden har slutförts. Om en fil till exempel har bytt namn innehåller egenskapen destinationUrl url:en för det nya filnamnet. Visas endast för händelser som utlöses på bloblagringskonton som har ett hierarkiskt namnområde. |
https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt |
sourceUrl |
sträng | URL:en för filen som finns innan åtgärden är klar. Om en fil till exempel har bytt namn innehåller sourceUrl url:en för det ursprungliga filnamnet före namnbytet. Visas endast för händelser som utlöses på bloblagringskonton som har ett hierarkiskt namnområde. |
https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-directory |
url |
sträng | Sökvägen till bloben. Om klienten använder ett REST-API för blobar har URL:en följande struktur: |
https://myaccount.blob.core.windows.net/container01/file.txt |
recursive |
sträng | Sant att köra åtgärden på alla underordnade kataloger; annars Falskt. Visas endast för händelser som utlöses på bloblagringskonton som har ett hierarkiskt namnområde. |
true |
sequencer |
sträng | Ett täckande strängvärde som representerar den logiska sekvensen av händelser för ett visst blobnamn. Användare kan använda standardsträngjämförelse för att förstå den relativa sekvensen av två händelser med samma blobnamn. | 00000000000004420000000000028963 |
identity |
sträng | Ett strängvärde som representerar den identitet som är associerad med händelsen. För SFTP (Secure File Transfer Protocol) är värdet det lokala användarnamnet. | localuser |
storageDiagnostics |
objekt | Diagnostikdata ingår ibland i Azure Storage-tjänsten. När det är dags bör händelsekonsumenterna ignorera det. | {{Storage diagnostic object}} |