Freigeben über


Erkunden von Fabric-Arbeitsbereichselementereignissen im Fabric Real-Time-Hub

Fabric-Arbeitsbereichselement-Ereignisse ermöglichen es Ihnen, Benachrichtigungen zu erhalten, wenn bestimmte Aktionen für Ihre Arbeitsbereichselemente auftreten. Das geschieht beispielsweise, wenn ein neues Artefakt erstellt oder ein vorhandenes Artefakt gelöscht wird. Diese Ereignisse können verwendet werden, um auf anderen Aktionen oder Workflows in Fabric hinzuweisen, z. B. das Ausführen einer Datenpipeline oder das Senden einer E-Mail-Benachrichtigung mithilfe von Fabric Activator-Benachrichtigungsfunktionen. In diesem Artikel wird erläutert, wie Sie Fabric-Arbeitsbereichselementereignisse im Echtzeithub erkunden.

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 Aktivators in den folgenden Regionen befindet: Westindien, Israel Central, Korea Central, Katar Central, Singapur, UAE Central, Spanien Central, Brasilien Südost, Zentral-USA, Süd-Zentral-USA, West-USA 2, West-USA 3.

Hinweis

Ab dem 21. März 2025 sind die ereignistypen Microsoft.Fabric.ItemReadSucceeded und Microsoft.Fabric.ItemReadFailed veraltet. Benutzer in Ihrer Organisation sehen diese Ereignistypen also beim Erstellen von Abonnements (Eventstreams oder Warnungen) für den Fabric-Arbeitsbereich nicht.

Vorhandene Abonnements (Ereignisströme oder Warnungen) für diese Ereignisse werden ab dem 21. März 2025 keine Ereignisse mehr erhalten.

Detailseite des Fabric-Arbeitsbereichselements anzeigen

  1. Wählen Sie unter Echtzeit-HubFabric-Ereignisse aus.

  2. Wählen Sie Fabric-Arbeitsbereichselement-Ereignisse aus der Liste aus.

    Screenshot der Auswahl von Fabric-Arbeitsbereichselement-Ereignissen auf der Seite „Fabric-Ereignisse“.

  3. Die Detailansicht für Fabric-Arbeitsbereichselementereignisse sollte angezeigt werden.

    Screenshot der Detailseite für Fabric-Arbeitsbereichselementereignisse.

Aktionen

Oben auf der Detailseite werden die folgenden beiden Aktionen angezeigt.

  • Ereignisstream erstellen – Ermöglicht ihnen das Erstellen eines Ereignisstreams basierend auf Ereignissen aus dem ausgewählten Fabric-Arbeitsbereichselement.

  • Festlegen einer Benachrichtigung – Ermöglicht das Festlegen einer Warnung, wenn ein Vorgang für ein Fabric-Arbeitsbereichselement ausgeführt wird, z. B. ein neues Artefakt erstellt wird.

    Screenshot, der Aktionen auf der Detailseite des Fabric-Arbeitsbereichelements zeigt.

Anzeigen der Verwendung dieser Kategorie

Dieser Abschnitt zeigt die Artefakte mithilfe von Fabric-Arbeitsbereichselementereignissen. Hier sind die Spalten und ihre Beschreibungen, die in der Liste angezeigt werden.

Spalte Beschreibung
Name Name des Artefakts, das Fabric-Arbeitsbereichselementereignisse verwendet.
type Artefakttyp – Activator oder Eventstream
Arbeitsbereich Arbeitsbereich, in dem sich das Artefakt befindet.
Quelle Name des Arbeitsbereichs, der Quelle der Ereignisse ist.

Screenshot des Abschnitts „Informationen zur Verwendung dieser Kategorie“ auf der Detailseite „Fabric-Arbeitsbereichselement-Ereignisse“.

Fabric-Arbeitsbereichselement-Ereignisprofil

Screenshot des Abschnitts

Ereignistypen

Name des Ereignistyps Beschreibung
Microsoft.Fabric.ItemCreateSucceeded Dieses Ereignis wird aktiviert, wenn ein Erstellungsvorgang für die Ressource erfolgreich ist. Beispiel: Ein Ereignis, das beim erfolgreichen Erstellen eines neuen Artefakts erzeugt wird.
Microsoft.Fabric.ItemCreateFailed Dieses Ereignis wird aktiviert, wenn ein Erstellungsvorgang für die Ressource fehlschlägt. Beispielsweise ein Ereignis, das beim Erstellen eines neuen Artefakts erzeugt wurde.
Microsoft.Fabric.ItemUpdateSucceeded Dieses Ereignis wird aktiviert, wenn ein Aktualisierungsvorgang für die Ressource erfolgreich ausgeführt wird. Beispiel: Ein Ereignis, das erstellt wird, wenn ein Datenfluss erfolgreich aktualisiert wird.
Microsoft.Fabric.ItemUpdateFailed Dieses Ereignis wird aktiviert, wenn ein Aktualisierungsvorgang für die Ressource fehlschlägt. Beispielsweise ein Ereignis, das erzeugt wird, wenn während der Aktualisierung ein Datenflussfehler aufgetreten ist.
Microsoft.Fabric.ItemDeleteSucceeded Dieses Ereignis wird aktiviert, wenn ein Löschvorgang für die Ressource erfolgreich ist. Ein Ereignis, das beispielsweise beim erfolgreichen Löschen eines Datenflusses erzeugt wird.
Microsoft.Fabric.ItemDeleteFailed Dieses Ereignis wird aktiviert, wenn ein Löschvorgang für die Ressource fehlschlägt. Beispielsweise ein Ereignis, das beim Löschen eines Datenflusses erzeugt wurde.

Schemas

Ein Ereignis weist die folgenden Daten auf oberster Ebene aus:

Eigenschaft type Beschreibung Beispiel
source Zeichenfolge Gibt den Kontext an, in dem ein Ereignis aufgetreten ist. 00000000-0000-0000-0000-000000000000
subject Zeichenfolge Gibt den Betreff des Ereignisses im Kontext des Ereignisherstellers an. /workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000
type Zeichenfolge Enthält einen Wert, der den Typ des Ereignisses beschreibt, der mit dem ursprünglichen Vorkommen verknüpft ist. Microsoft.Fabric.ItemCreateSucceeded
time Zeitstempel Zeitstempel des Auftretens. 2024-04-23T21:17:32.6029537+00:00
id Zeichenfolge Eindeutiger Bezeichner für das Ereignis. 00000000-0000-0000-0000-000000000000
specversion Zeichenfolge Gibt die Versionsnummer des Ereignisses an. 1.0
dataschemaversion String Die Version des Datenbankschemas. 1.0
capacityId Zeichenfolge Eindeutiger Bezeichner für den Katalog. 00000000-0000-0000-0000-000000000000
domainId Zeichenfolge Eindeutiger Bezeichner des Dokuments. 00000000-0000-0000-0000-000000000000

Das data-Objekt weist die folgenden Eigenschaften auf:

Eigenschaft type Beschreibung Beispiel
itemId guid Ein eindeutiger Bezeichner für das Element. 00000000-0000-0000-0000-000000000000
itemKind Zeichenfolge Die Art des Elements/Artefakts. Elementtyp, z. B. Notebook, Lakehouse, etc. Im nächsten Abschnitt finden Sie eine Liste von Elementtypen, die von Arbeitsbereichselement-Ereignissen nicht unterstützt werden
itemName Zeichenfolge Der Element-/Artefaktname. Test Notebook
workspaceId guid Dies ist der eindeutige Bezeichner des Arbeitsbereichs. 00000000-0000-0000-0000-000000000000
workspaceName Zeichenfolge Den Namen des Arbeitsbereichs Test Workspace
principalId guid Ein eindeutiger Bezeichner für den Benutzer. 00000000-0000-0000-0000-000000000000
executingPrincipalType Zeichenfolge Drei Arten von Benutzer*innen: User

Hinweis

Derzeit werden Fabric-Arbeitsbereichselement-Ereignisse für die folgenden Power BI-Elementtypen (itemKind) nicht unterstützt:

  • Semantikmodell
  • Paginierter Bericht
  • Report
  • App
  • Dashboard

Berechtigung abonnieren

Weitere Informationen finden Sie unter Abonnieren der Berechtigung für Fabric-Ereignisse.