Esplorare gli eventi di archiviazione blob di Azure nell'hub Fabric Real-Time (anteprima)
Questo articolo illustra come esplorare gli eventi di archiviazione BLOB di Azure nell'hub in tempo reale di Fabric. Gli eventi di archiviazione BLOB di Azure consentono di ricevere notifiche quando si verificano determinate azioni nei BLOB. Ad esempio, è possibile ricevere una notifica quando viene creato un nuovo BLOB o un BLOB esistente viene modificato. Questi eventi possono essere usati per impostare avvisi su altre azioni o flussi di lavoro, ad esempio l'aggiornamento di un database o l'invio di una notifica. Questo articolo illustra le proprietà e lo schema per gli eventi di archiviazione BLOB di Azure.
Nota
L'utilizzo di Fabric e degli eventi di Azure tramite eventstream o Fabric Activator non è supportato se l'area di capacità del flusso di eventi o Activator si trova nelle seguenti regioni: India occidentale, Israele centrale, Corea centrale, Qatar centrale, Singapore, Emirati Arabi Uniti centrali, Spagna centrale, Brasile sud-orientale, Stati Centrali degli Stati Uniti, Stati Uniti centro-meridionali, Stati Uniti occidentali 2, Stati Uniti occidentali 3.
Visualizzare la pagina dei dettagli degli eventi di archiviazione BLOB di Azure
Nell'hub in tempo reale selezionare Eventi di Azure nel menu di spostamento a sinistra.
Selezionare Eventi archiviazione BLOB di Azure nell’elenco.
Verrà visualizzata la pagina dei dettagli degli eventi di archiviazione BLOB di Azure.
Azioni
Nella parte superiore della pagina dei dettagli degli eventi di archiviazione BLOB di Azure vengono visualizzate le due azioni seguenti.
Creare eventstream: consente di creare un eventstream in base agli eventi dell'archiviazione BLOB di Azure selezionata.
Impostare un avviso: consente di impostare un avviso quando viene eseguita un'operazione su un artefatto di archiviazione BLOB di Azure. Ad esempio, è possibile impostare un avviso quando viene creato o eliminato un BLOB.
Informazioni sull'uso di questa categoria
Questa sezione illustra gli artefatti che usano eventi Archiviazione BLOB di Azure. Ecco le colonne e le relative descrizioni visualizzate nell'elenco.
| Colonna | Descrizione |
|---|---|
| Name | Nome dell'artefatto che usa eventi dell’Archiviazione BLOB di Azure. |
| Type | Tipo di artefatto: Activator o Eventstream |
| Area di lavoro | Area di lavoro in cui si trova l'artefatto. |
| Origine | Nome della risorsa (account di archiviazione BLOB di Azure). |
Profilo eventi archiviazione BLOB di Azure
Tipi di evento
| Nome tipo di evento | Descrizione |
|---|---|
| Microsoft.Storage.BlobCreated | Questo evento viene attivato quando viene aggiunto un nuovo BLOB o quando viene aggiornato un BLOB esistente. L'evento viene attivato dai client che usano le operazioni CreateFile e FlushWithClose, disponibili nell'API REST di Azure Data Lake Storage Gen2. |
| Microsoft.Storage.BlobDeleted | Questo evento viene attivato quando viene rimosso un BLOB. Viene attivato quando i client usano l'operazione DeleteFile disponibile nell'API REST di Azure Data Lake Storage Gen2. |
| Microsoft.Storage.BlobRenamed | Questo evento viene attivato quando un BLOB subisce una modifica del nome, in particolare quando gli utenti usano la funzione RenameFile trovata nell'API REST di Azure Data Lake Storage Gen2. |
| Microsoft.Storage.BlobTierChanged | Questo evento viene attivato quando il livello di accesso BLOB viene modificato tramite l'operazione SetBlobTier nell'API REST BLOB e viene attivato dopo l'elaborazione completa della modifica. |
| Microsoft.Storage.AsyncOperationInitiated | Questo evento si verifica quando i dati vengono spostati o copiati dall'archivio ai livelli ad accesso frequente o sporadico. Si verifica quando i client usano l'API SetBlobTier per spostare un BLOB dall'archivio a livelli ad accesso frequente o ad accesso sporadico o quando i client usano l'API CopyBlob per copiare dati da un BLOB di livello archivio a un BLOB di livello ad accesso frequente o sporadico. |
| Microsoft.Storage.DirectoryCreated | Questo evento viene attivato quando viene creata una nuova directory o un client usa l'operazione CreateDirectory fornita nell'API REST di Azure Data Lake Storage Gen2 per formare una nuova directory. |
| Microsoft.Storage.DirectoryRenamed | Questo evento viene attivato quando una directory subisce una modifica del nome, in particolare quando i client usano la funzionalità RenameDirectory nell'API REST di Azure Data Lake Storage Gen2. |
| Microsoft.Storage.DirectoryDeleted | Questo evento viene attivato quando viene rimossa una directory quando i clienti usano la funzionalità DeleteDirectory presente nell'API REST di Azure Data Lake Storage Gen2. |
| Microsoft.Storage.BlobInventoryPolicyCompleted | Questo evento viene attivato al termine dell'esecuzione dell'inventario per un criterio specificato come criterio di inventario. Viene attivato anche se l'esecuzione dell'inventario non riesce a causa di un errore dell'utente prima che venga completato, ad esempio un criterio errato o un contenitore di destinazione assente. |
| Microsoft.Storage.LifecyclePolicyCompleted | Questo evento si riferisce all'attivazione di un criterio di gestione del ciclo di vita quando vengono eseguite le azioni definite. |
Schemi
Un evento presenta i seguenti dati di primo livello:
| Proprietà | Type | Descrizione | Esempio |
|---|---|---|---|
source |
string | Percorso completo della risorsa all'origine evento. Questo campo non è scrivibile. Questo valore viene specificato da Griglia di eventi. | /subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account |
subject |
string | Percorso definito dall'editore all'oggetto dell'evento. | /blobServices/default/containers/my-file-system/blobs/new-file.txt |
type |
string | Uno dei tipi di evento registrati per l'origine evento. | Microsoft.Storage.BlobCreated |
time |
string | Ora di generazione dell'evento in base all'ora UTC del provider. | 2017-06-26T18:41:00.9584103Z |
id |
string | Identificatore univoco per l'evento. | 00000000-0000-0000-0000-000000000000 |
data |
oggetto | Dati relativi all'evento di archiviazione BLOB. | {{Data object}} |
specversion |
string | Versione della specifica dello schema CloudEvents. | 1.0 |
fabricsource |
string | ID dell’eventstream di Fabric per l'origine evento Archiviazione BLOB di Azure. | /tenants/00000000-0000-0000-0000-000000000000/workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000 |
fabricsubject |
string | ID del collegamento dell'evento per l'origine evento Archiviazione BLOB di Azure. | eventLinks/00000000-0000-0000-0000-000000000000 |
Di seguito sono elencate le proprietà dell'oggetto data:
| Proprietà | Type | Descrizione | Esempio |
|---|---|---|---|
api |
string | L'operazione che ha attivato l'evento. | CreateFile |
clientRequestId |
string | ID di richiesta generato dal client per l'operazione API di archiviazione. Questo ID può essere usato per correlare ai log di diagnostica Archiviazione di Azure usando il client-request-id campo nei log e può essere fornito nelle richieste client usando l'intestazione x-ms-client-request-id . Vedere Log Format (Formato del log). |
00000000-0000-0000-0000-000000000000 |
requestId |
string | ID di richiesta generato dal servizio per l'operazione API di archiviazione. Può essere usato per correlare ai log di diagnostica Archiviazione di Azure usando il request-id-header campo nei log e viene restituito dall'avvio della chiamata API nell'intestazionex-ms-request-id. Vedere Log Format (Formato del log). |
00000000-0000-0000-0000-000000000000 |
eTag |
string | Il valore che è possibile usare per eseguire le operazioni in modo condizionale. | \"0x8D4BCC2E4835CD0\" |
contentType |
string | Il tipo di contenuto specificato per il BLOB. | text/plain |
contentLength |
integer | La dimensione del BLOB in byte. | 0 |
blobType |
string | Il tipo di BLOB. I valori validi sono BlockBlob o PageBlob. |
BlockBlob |
contentOffset |
number | Offset in byte di un'operazione di scrittura eseguita nel punto in cui l'applicazione che attiva gli eventi ha completato la scrittura nel file. Viene visualizzato solo per gli eventi attivati sugli account di archiviazione BLOB con uno spazio dei nomi gerarchico. |
0 |
destinationUrl |
string | URL del file che esisterà al termine dell'operazione. Ad esempio, se un file viene rinominato, la proprietà destinationUrl contiene l'URL del nuovo nome file. Viene visualizzato solo per gli eventi attivati sugli account di archiviazione BLOB con uno spazio dei nomi gerarchico. |
https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt |
sourceUrl |
string | URL del file esistente prima del termine dell'operazione. Ad esempio, se un file viene rinominato, il sourceUrl contiene l'URL del nome file originale prima dell'operazione di ridenominazione. Viene visualizzato solo per gli eventi attivati sugli account di archiviazione BLOB con uno spazio dei nomi gerarchico. |
https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-directory |
url |
string | Percorso del BLOB. Se il client usa un'API REST BLOB, l'URL ha questa struttura: |
https://myaccount.blob.core.windows.net/container01/file.txt |
recursive |
string | True per eseguire l'operazione su tutte le directory figlio; in caso contrario False. Viene visualizzato solo per gli eventi attivati sugli account di archiviazione BLOB con uno spazio dei nomi gerarchico. |
true |
sequencer |
string | Valore stringa opaca che rappresenta la sequenza logica di eventi per qualsiasi nome di BLOB specifico. Gli utenti possono usare il confronto tra stringhe standard per comprendere la sequenza relativa di due eventi sullo stesso nome di BLOB. | 00000000000004420000000000028963 |
identity |
string | Valore stringa che rappresenta l'identità associata all'evento. Per Secure File Transfer Protocol (SFTP), il valore è il nome utente locale. | localuser |
storageDiagnostics |
oggetto | Dati di diagnostica occasionalmente inclusi dal servizio Archiviazione di Azure. Quando è presente, questa proprietà deve essere ignorata dai consumer di eventi. | {{Storage diagnostic object}} |