Erstellen einer Regel in Fabric Aktivator

Wenn Sie Streamingdaten in einen Aktivator übertragen oder Objekten Ereignisse zuweisen, können Sie Regeln erstellen, um auf Ihre Daten zu reagieren. Die Aktivierung dieser Regeln kann das Senden einer Benachrichtigung sein, z. B. eine E-Mail oder Teams-Nachricht. Die Aktivierung dieser Regeln kann auch einen Workflow auslösen, z. B. das Starten eines Power Automate Flusses.

Aktivierungsregeln können auch Aktionen basierend auf Fabric-Ereignissen und Azure Blob Storage-Ereignissen auslösen, die über Eventstream empfangen werden, wodurch ereignisgesteuerte Orchestrierung ermöglicht wird. Sie können beispielsweise Spark-Aufträge oder Dataflows starten, wenn Dateien in einem BLOB-Container landen. Weitere Informationen zum Verbinden von Ereignisquellen finden Sie unter Eine Fabric Activator-Zieladresse zu einem Ereignisstrom hinzufügen.

Voraussetzungen

  • Ein Arbeitsbereich mit einer Microsoft Fabric-fähigen Kapazität.

Öffnen des Activator

Tipp

Warnungserstellung und Regelverwaltung werden auch direkt in Fabric Eventstream eingebettet. Sie können Aktivatorregeln im Kontext erstellen und verwalten, während Sie Ereignisdatenströme konfigurieren, ohne zu einer separaten Aktivierungsumgebung zu wechseln.

Öffnen Sie zunächst Fabric in Ihrem Browser.

Wählen Sie im Navigationsbereich Erstellen>Activator aus. Wenn Erstellen nicht angezeigt wird, wählen Sie die Auslassungspunkte (...) aus, um weitere Optionen anzuzeigen.

Wählen Sie "Beispiel testen" aus, um einen Aktivator zu erstellen, der mit Beispielereignissen und -objekten aufgefüllt ist.

Definieren einer Regelbedingung und -aktion

Geben Sie unter Regeln die Werte, die Sie in Ereignissen überwachen möchten, die Bedingungen, die Sie erkennen möchten, und die Aktionen an, die Activator ausführen soll.

Auswählen ihrer Regeldaten

Wählen Sie im Activator-Explorer die Eigenschaft oder den Eventstream aus, die bzw. der in Ihrer Regel überwacht werden soll. Informationen zu Eigenschaften finden Sie im Abschnitt " Eigenschaften erstellen ".

Nachdem Sie eine Eigenschaft oder einen Ereignisstream ausgewählt haben, wird eine Vorschau der Werte für ein Beispiel der Instanzen des Objekts angezeigt.

Hinweis

Aktivator kann auch veröffentlichte Power BI Berichte überwachen und Sie benachrichtigen, wenn eine neue Zeile in einer Tabellenanzeige angezeigt wird. Sie konfigurieren diese Überwachung über die Power BI-Dienst. Die resultierende Regel kann dieselben Aktionen auslösen (E-Mail, Teams, Fabric Element oder Power Automate). Weitere Informationen finden Sie unter Create an alert in Power BI report.

Aktivator unterstützt das Erstellen von Regeln für Fabric Data Warehouse SQL-Abfrageergebnisse (Vorschau). Diese Regeln werten eine SQL-Abfrage für einen konfigurierbaren Zeitplan aus und lösen Aktionen aus, wenn Bedingungen erfüllt sind, wodurch eine regelmäßige Überwachung von Lagerdaten ermöglicht wird.

Erstellen einer neuen Activator-Regel

Um eine neue Regel zu erstellen, wählen Sie den soeben hinzugefügten Datenstrom aus. Auf der rechten Seite wird ein Regel erstellen-Bereich angezeigt. Der Abschnitt "Überwachen" der Regel wird mit dem von Ihnen ausgewählten Datenstrom vorab aufgefüllt.

Definieren Sie die Bedingung zum Erkennen

Wählen Sie als Nächstes den Typ der Bedingung aus, die Sie erkennen möchten. Sie können Bedingungen verwenden, die Folgendes überprüfen:

  • Führen Sie für jedes Ereignis eine Aktion aus.
  • Führen Sie für jedes Ereignis, wenn ein Wert erfüllt wird, eine Aktion aus.
  • Führen Sie für jedes Ereignis, das nach einem Feld gruppiert ist, eine Aktion aus (z. B. für jedes PackageId-Ereignis, wenn die Temperatur größer als 30 ist)

Wählen Sie schließlich aus, ob die Aktion Ihnen eine E-Mail senden oder Ihnen eine Teams-Nachricht senden soll, und wählen Sie "Erstellen" aus. Sie können die Bedingungen und Aktionen später ändern.

Die Diagramme auf der Registerkarte "Definition " werden aktualisiert, um ein Beispiel der Ereignisse anzuzeigen, die den von Ihnen festgelegten Bedingungen entsprechen.

Screenshot einer Erkennungskarte mit zwei Diagrammen.

Wenn Sie zur Registerkarte "Analyse " wechseln, werden zwei Diagramme angezeigt. Das erste Diagramm zeigt die Gesamtzahl der Auslösungen der Regeln für alle Objekt-IDs, die Aktivator nachverfolgt. Verwenden Sie dieses Diagramm, um die Anzahl der Benachrichtigungen zu verstehen, die für alle Objekt-IDs ausgelöst wurden. Das zweite Diagramm zeigt die Gesamtanzahl der Regelaktivierungen für die fünf Objekt-IDs. Verwenden Sie dieses Diagramm, um besser zu verstehen, ob bestimmte Objekt-IDs am meisten zu allen Aktivierungen beitragen, die ausgelöst werden.

Definieren der auszuführenden Aktion

Schließlich können Sie im Abschnitt Aktion auswählen, was geschehen soll, wenn die Bedingung erkannt wird.

Screenshot: Auswahl einer Aktion, wenn eine Bedingung erkannt wird.

Hier sind die unterstützten Aktionstypen:

  • E-Mail – Senden Sie eine E-Mail an die angegebenen Empfänger.

  • Teams – Senden Sie eine Teams-Nachricht an bestimmte Empfänger, Gruppenchats oder Kanal.

  • Fabric Item – Führen Sie die ausgewählte Fabric Pipeline, Fabric Notizbuch, Fabric Spark Job Definition, Fabric Dataflow oder Fabric Benutzerdatenfunktion aus. Verwenden Sie diese Aktionen, um ereignisgesteuerte Pipelines zu implementieren. Weitere Informationen finden Sie unter Trigger Fabric Elemente.

  • Benutzerdefinierte Aktion – Aktivieren eines Power Automate Flow.

Screenshot des Abschnitts

Verschiedene Aktionstypen haben unterschiedliche Parameter. Einige dieser Parameter umfassen die E-Mail-Adresse, an die Sie senden möchten, den Teams-Kanal oder den Gruppenchat, den Workflow, den Sie starten möchten, die Betreffzeile oder zusätzliche Informationen (Kontext). Für "Kontext" können Sie die zusätzlichen Eigenschaften auswählen, die in die Warnmeldung aufgenommen werden sollen.

Sie können Eigenschaften auch taggen, indem Sie @ eingeben, um den von Ihnen gesendeten Aktionen Kontext hinzuzufügen. Beispiel: @bikeId.

Wenn Sie die Eigenschaft auf der Monitorkarte zusammenfassen, sendet die Aktion den ursprünglichen Wert der Eigenschaft anstelle des zusammengefassten Werts.

Wählen Sie "Bearbeiten"-Aktion aus, um einen Editor mit einer Vorschau der Nachricht anzuzeigen, die die Aktion sendet, und Optionen, um der Aktion weitere Informationen hinzuzufügen.

Regel testen

Nachdem Sie eine Regel erstellt haben, können Sie sie testen, indem Sie Testbenachrichtigung senden auswählen. Durch das Auswählen dieser Schaltfläche wird ein vergangenes Ereignis gesucht, für das die Regelaktivierung true lautet. Dann wird eine Warnung gesendet, damit Sie sehen können, wie die Warnung für dieses Ereignis aussieht.

  • Die Testwarnung wird immer an Sie gesendet, unabhängig vom Empfängerfeld auf der Aktionskarte .
  • Die Option Testbenachrichtigung senden ist nur aktiviert, wenn es mindestens ein vergangenes Ereignis gibt, für das die Regelbedingung wahr ist.

Starten und Stoppen Ihrer Regel

Regeln werden im Zustand Angehalten erstellt. Dieser Zustand bedeutet, dass das System die Regel nicht auswertet, da Daten in das System fließen, und die Regel führt keine Aktionen als Ergebnis aus. Nachdem Sie die Regel definiert haben, wählen Sie "Speichern" aus, und beginnen Sie damit, die Regel zu aktivieren. Wenn Sie nicht bereit sind, Ihre Regel zu starten, speichern Sie sie, und kehren Sie später zurück. Wenn Sie bereit sind, wählen Sie Start auf der Symbolleiste aus, damit Activator mit der Ausführung des Triggers beginnt und entsprechende Aktionen ausführt.

Screenshot: Starten einer Warnung

Nach dem Starten wird im Titelbereich der Regelkarte Wird ausgeführt angezeigt. Außerdem zeigt das Symbol im Explorer an, dass die Regel ausgeführt wird. Wenn Sie die Regel starten, werden neue Aktivierungen für neue erfasste Daten ausgeführt. Ihre Regel wird nicht für Daten aktiviert, die bereits aufgenommen wurden. Wählen Sie Beenden aus, um die Warnung zu beenden.

Wenn Sie Änderungen an der Regel vornehmen (z. B. die gesuchte Bedingung ändern), wählen Sie " Aktualisieren" in der Symbolleiste aus, um sicherzustellen, dass die ausgeführte Regel die neuen Werte verwendet.

Wenn Sie eine Regel (oder ein Objekt) löschen, kann es bis zu fünf Minuten dauern, bis die Back-End-Verarbeitung von Daten abgeschlossen ist. Gelöschte Regeln überwachen möglicherweise weiterhin Daten und ergreifen entsprechende Aktionen für einige Minuten nach dem Löschen.

Eigenschaften erstellen

Manchmal müssen Sie eine Regellogik für mehrere Regeln wiederverwenden. Erstellen Sie eine Eigenschaft, um eine wiederverwendbare Bedingung oder ein wiederverwendbares Measure zu definieren, und verweisen Sie dann aus mehreren Regeln auf diese Eigenschaft.

Um eine Eigenschaft zu erstellen, wählen Sie den Datenstrom aus, den Sie dem objekt hinzugefügt haben, das Sie interessieren, wählen Sie im Menüband "Neue Eigenschaft " und dann die Eigenschaft aus, die Sie in der Regellogik verwenden möchten.

Screenshot: Erstellen einer Eigenschaft für eine Warnung

Nachdem Sie eine Eigenschaft definiert haben, können Sie aus einer oder mehreren Regeln darauf verweisen. In diesem Beispiel verweisen Sie auf die Temperatureigenschaft"Zu heiß" für die Medizin.

Screenshot: Eigenschaft „Paket zu warm“ für eine Warnmeldung

Bereinigen von Ressourcen

Löschen Sie den Beispieler-Eventstream, indem Sie die Auslassungspunkte (...) rechts neben dem Eventstream Paketzustellungsereignis und dann Löschenauswählen.

Nächster Schritt