Erkunden von Azure Blob-Storage-Ereignisse-Ereignissen im Fabric Real-Time-Hub
Dieser Artikel zeigt, wie Sie Azure Blob-Storage-Ereignisse im Fabric Echtzeithub untersuchen können. Azure Blob-Storage-Ereignisse ermöglichen es Ihnen, Benachrichtigungen zu empfangen, wenn bestimmte Aktionen auf Ihren Blobs stattfinden. So können Sie zum Beispiel eine Benachrichtigung erhalten, wenn ein neuer Blob erstellt oder ein bestehender Blob geändert wird. Diese Ereignisse können verwendet werden, um Warnungen für andere Aktionen oder Workflows festzulegen, z. B. das Aktualisieren einer Datenbank oder das Senden einer Benachrichtigung. In diesem Artikel werden die Eigenschaften und das Schema für Blob Storage-Ereignisse beschrieben.
Hinweis
Diese Funktion befindet sich derzeit in der Vorschau.
Hinweis
Das Verwenden von Fabric- und Azure-Ereignissen über Eventstream oder Fabric Activator wird nicht unterstützt, wenn sich die Kapazitätsregion des Eventstreams oder Activators in einer der folgenden Regionen befindet: Deutschland, Westen-Mitte; USA, Süden-Mitte; USA, Westen 2; USA, Westen 3; Indien, Westen.
Detailseite für Azure Blob-Storage-Ereignisse anzeigen
Wählen Sie im Echtzeit-Hub Azure-Ereignisse im linken Navigationsmenü aus.
Wählen Sie Azure Blob-Storage-Ereignisse in der Liste.
Sie sollten die Detailseite der Azure Blob-Storage-Ereignisse sehen.
Aktionen
Oben auf der Detailseite der Azure Blob-Storage-Ereignisse sehen Sie die folgenden beiden Aktionen.
Eventstream erstellen – Ermöglicht ihnen das Erstellen eines Eventstreams basierend auf Ereignissen aus dem ausgewählten Azure Blob Storage.
Benachrichtigung festlegen – Ermöglicht das Festlegen einer Warnung, wenn ein Vorgang für ein Azure Blob Storage-Artefakt ausgeführt wird. Sie können beispielsweise eine Warnung festlegen, wenn ein Blob erstellt oder gelöscht wird.
Anzeigen der Verwendung dieser Kategorie
Dieser Abschnitt zeigt Artefakte mit Azure Blob Storage-Ereignissen. Hier sind die Spalten und ihre Beschreibungen, die in der Liste angezeigt werden.
| Spalte | Beschreibung |
|---|---|
| Name | Name des Artefakts, das Azure Blob Storage-Ereignisse verwendet. |
| type | Artefakttyp – Activator oder Eventstream |
| Arbeitsbereich | Arbeitsbereich, in dem sich das Artefakt befindet. |
| Quelle | Name der Quelle (Azure Blob Storage-Konto). |
Azure Blob-Storage-Ereignisprofil
Ereignistypen
| Name des Ereignistyps | Beschreibung |
|---|---|
| Microsoft.Storage.BlobCreated | Dieses Ereignis wird aktiviert, wenn ein neuer Blob hinzugefügt oder ein vorhandener Blob aktualisiert wird. Das Ereignis wird von Clients ausgelöst, die CreateFile- und FlushWithClose-Operationen verwenden, die in der Azure Data Lake Storage Gen2 REST API zu finden sind. |
| Microsoft.Storage.BlobDeleted | Dieses Ereignis wird aktiviert, wenn ein Blob entfernt wird. Es wird ausgelöst, wenn Clients die DeleteFile-Operation verwenden, die in der Azure Data Lake Storage Gen2 REST API zu finden ist. |
| Microsoft.Storage.BlobRenamed | Dieses Ereignis wird aktiviert, wenn ein Blob einen neuen Namen erhält, insbesondere wenn Benutzer die RenameFile-Funktion in der Azure Data Lake Storage Gen2 REST API verwenden. |
| Microsoft.Storage.BlobTierChanged | Dieses Ereignis wird aktiviert, wenn die Blob-Zugriffsebene durch die SetBlobTier-Operation in der Blob REST API geändert wird, und wird ausgelöst, sobald die Änderung vollständig verarbeitet wurde. |
| Microsoft.Storage.AsyncOperationInitiated | Dieses Ereignis tritt auf, wenn Daten aus dem Archiv in die heiße oder kalte Ebene verschoben oder kopiert werden. Dies geschieht, wenn Clients die SetBlobTier-API verwenden, um einen Blob vom Archiv in die heiße oder kalte Ebene zu verschieben, oder wenn Clients die CopyBlob-API verwenden, um Daten von einem Blob der Archivebene in einen Blob der heißen oder kalten Ebene zu kopieren. |
| Microsoft.Storage.DirectoryCreated | Dieses Ereignis wird aktiviert, wenn ein neues Verzeichnis erstellt wird, oder ein Client verwendet die CreateDirectory-Operation, die in der REST-API von Azure Data Lake Storage Gen2 bereitgestellt wird, um ein neues Verzeichnis zu bilden. |
| Microsoft.Storage.DirectoryRenamed | Dieses Ereignis wird aktiviert, wenn ein Verzeichnis eine Namensänderung erfährt, insbesondere wenn Kunden die Feature RenameDirectory in der Azure Data Lake Storage Gen2 REST API verwenden. |
| Microsoft.Storage.DirectoryDeleted | Dieses Ereignis wird aktiviert, wenn ein Verzeichnis entfernt wird, wenn Kunden die DeleteDirectory-Feature in der Azure Data Lake Storage Gen2 REST API nutzen. |
| Microsoft.Storage.BlobInventoryPolicyCompleted | Dieses Ereignis wird aktiviert, wenn der Inventarisierungslauf für eine Richtlinie, die als Inventarisierungsrichtlinie angegeben ist, beendet wird. Sie wird auch aktiviert, wenn der Inventarisierungslauf aufgrund eines Benutzerfehlers fehlschlägt, bevor er beginnt, z. B. aufgrund einer fehlerhaften Richtlinie oder eines fehlenden Zielcontainers. |
| Microsoft.Storage.LifecyclePolicyCompleted | Dieses Ereignis bezieht sich auf die Aktivierung einer Lebenszyklusmanagement-Richtlinie, wenn ihre definierten Aktionen ausgeführt werden. |
Schemas
Ein Ereignis weist die folgenden Daten auf oberster Ebene aus:
| Eigenschaft | Typ | Beschreibung | Beispiel |
|---|---|---|---|
source |
Zeichenfolge | Vollständiger Ressourcenpfaf zur Ereignisquelle. Dieses Feld ist nicht beschreibbar. Dieser Wert wird von Event Grid bereitgestellt. | /subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account |
subject |
Zeichenfolge | Vom Herausgeber definierter Pfad zum Ereignisbetreff | /blobServices/default/containers/my-file-system/blobs/new-file.txt |
type |
Zeichenfolge | Einer der registrierten Ereignistypen für die Ereignisquelle. | Microsoft.Storage.BlobCreated |
time |
Zeichenfolge | Die Zeit, in der das Ereignis generiert wird, basierend auf der UTC-Zeit des Anbieters. | 2017-06-26T18:41:00.9584103Z |
id |
Zeichenfolge | Eindeutiger Bezeichner für das Ereignis. | 00000000-0000-0000-0000-000000000000 |
data |
Objekt (object) | Ereignisdaten für Blob Storage. | {{Data object}} |
specversion |
Zeichenfolge | Version der CloudEvents-Schemaspezifikation. | 1.0 |
fabricsource |
Zeichenfolge | ID des Fabric-Eventstream für die Azure Blob Storage-Ereignisquelle. | /tenants/00000000-0000-0000-0000-000000000000/workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000 |
fabricsubject |
Zeichenfolge | ID des Eventlinks für die Azure Blob Storage-Ereignisquelle. | eventLinks/00000000-0000-0000-0000-000000000000 |
Das data-Objekt weist die folgenden Eigenschaften auf:
| Eigenschaft | Typ | Beschreibung | Beispiel |
|---|---|---|---|
api |
Zeichenfolge | Der Vorgang, durch den das Ereignis ausgelöst wurde. | CreateFile |
clientRequestId |
Zeichenfolge | Eine vom Client bereitgestellte Anforderungs-ID für den Speicher-API-Vorgang. Diese ID kann zum Korrelieren mit Azure Storage-Diagnoseprotokollen anhand des Felds client-request-id in den Protokollen verwendet und in Clientanforderungen mit dem Header x-ms-client-request-id bereitgestellt werden. Informationen finden Sie unter Storage Analytics Log Format (Storage Analytics-Protokollformat). |
00000000-0000-0000-0000-000000000000 |
requestId |
Zeichenfolge | Vom Dienst generierte Anforderungs-ID für den Speicher-API-Vorgang. Kann zum Korrelieren mit Azure Storage-Diagnoseprotokolle mithilfe des Felds request-id-header in den Protokollen verwendet werden, und wird vom einleitenden API-Aufruf im Headers x-ms-request-id zurückgegeben. Informationen finden Sie unter Storage Analytics Log Format (Storage Analytics-Protokollformat). |
00000000-0000-0000-0000-000000000000 |
eTag |
Zeichenfolge | Der Wert, mit dem Sie Vorgänge bedingt ausführen können. | \"0x8D4BCC2E4835CD0\" |
contentType |
Zeichenfolge | Der für das Blob angegebene Inhaltstyp. | text/plain |
contentLength |
integer | Die Größe des Blobs in Byte. | 0 |
blobType |
Zeichenfolge | Der Blobtyp. Gültige Werte sind BlockBlob oder PageBlob. |
BlockBlob |
contentOffset |
Zahl | Das Offset (in Bytes) eines Schreibvorgangs zu dem Zeitpunkt, zu dem die ereignisauslösende Anwendung das Schreiben in die Datei abgeschlossen hat. Nur relevant für Ereignisse, die für Blob Storage-Konten mit einem hierarchischen Namespace ausgelöst wurden. |
0 |
destinationUrl |
Zeichenfolge | Die URL der Datei, die nach Abschluss des Vorgangs vorhanden ist. Wenn also beispielsweise eine Datei umbenannt wird, enthält die Eigenschaft die Ziel-URL des neuen Dateinamens. Nur relevant für Ereignisse, die für Blob Storage-Konten mit einem hierarchischen Namespace ausgelöst wurden. |
https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt |
sourceUrl |
Zeichenfolge | Die URL der Datei, die vor dem erfolgten Vorgang vorhanden ist. Wenn also beispielsweise eine Datei umbenannt wird, enthält die Quell-URL des ursprünglichen Dateinamens vor dem Umbenennungsvorgang. Nur relevant für Ereignisse, die für Blob Storage-Konten mit einem hierarchischen Namespace ausgelöst wurden. |
https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-directory |
url |
Zeichenfolge | Der Pfad des Blobs. Wenn der Client eine Blob-REST-API verwendet, hat die URL die folgende Struktur: |
https://myaccount.blob.core.windows.net/container01/file.txt |
recursive |
Zeichenfolge | True, um den Vorgang für alle untergeordneten Verzeichnisse auszuführen; andernfalls False. Nur relevant für Ereignisse, die für Blob Storage-Konten mit einem hierarchischen Namespace ausgelöst wurden. |
true |
sequencer |
Zeichenfolge | Ein nicht transparenter Zeichenfolgenwert, der die logische Reihenfolge von Ereignissen für einen bestimmten Blobnamen darstellt. Benutzer können anhand des standardmäßigen Zeichenfolgenvergleichs die relative Reihenfolge von zwei Ereignissen unter dem gleichen Blobnamen verstehen. | 00000000000004420000000000028963 |
identity |
Zeichenfolge | Ein Zeichenfolge-Wert, der die mit dem Ereignis verbundene Identität angibt. Für das sichere File Transfer Protocol (SFTP) ist der Wert der lokale Benutzername. | localuser |
storageDiagnostics |
Objekt | Diagnosedaten, die gelegentlich vom Azure Storage-Dienst einbezogen werden. Falls vorhanden, sollten sie vom Ereignisconsumer ignoriert werden. | {{Storage diagnostic object}} |