Freigeben über

Hinzufügen eines Eventhouse-Ziels zu einem Eventstream

  • Artikel

Dieser Artikel erläutert, wie Sie ein Eventhouse als Ziel zu einem Eventstream in Microsoft Fabric-Eventstreams hinzufügen.

Hinweis

Erweiterte Funktionen sind standardmäßig aktiviert, wenn Sie jetzt Eventstreams erstellen. Wenn Sie Ereignisstreams haben, die mit Standardfunktionen erstellt wurden, funktionieren diese Ereignisstreams weiterhin. Sie können sie weiterhin wie gewohnt bearbeiten und verwenden. Es wird empfohlen, einen neuen Eventstream zu erstellen, um Standardeventstreams zu ersetzen, damit Sie zusätzliche Funktionen und Vorteile erweiterter Eventstreams nutzen können.

Voraussetzungen

  • Zugriff auf einen Arbeitsbereich im Fabric-Kapazitätslizenzmodus (oder) im Testlizenzmodus mit Mitwirkenden oder höheren Berechtigungen.
  • Zugriff auf ein Eventhouse, das in einem Fabric-Arbeitsbereich erstellt wurde, in dem Sie über Berechtigungen als Mitwirkender oder höhere Berechtigungen verfügen.

Hinweis

Die maximale Anzahl der Quellen und Ziele für einen Eventstream beträgt 11.

Hinzufügen eines Eventhouse als Ziel

Wenn Sie ein Eventhouse als Ziel hinzufügen, können Sie zwischen zwei Erfassungsmodi wählen: direkte Erfassung oder Ereignisverarbeitung vor der Erfassung.

Modus zur direkten Erfassung

Der Modus zur direkten Erfassung erfasst Ihre Ereignisdaten direkt in dem Eventhouse ohne Verarbeitung. Sie können den Modus zur direkten Erfassung verwenden, um ein Eventhouse-Ziel zu Ihrem Standardstream hinzuzufügen.

Wichtig

Sie können die direkte Erfassung nur für Ihren Standardstream verwenden. Die direkte Erfassung kann nicht auf Verarbeitungsoperatoren oder abgeleitete Streams folgen. Wenn Sie nach Verarbeitungsoperatoren oder abgeleiteten Streams ein Eventhouse-Ziel hinzufügen möchten, müssen Sie stattdessen die Ereignisverarbeitung vor der Erfassung verwenden.

  1. Wählen Sie im Bearbeitungsmodus für Ihren Eventstream im Menüband Ziel hinzufügen aus oder wählen Sie die Karte Ereignisse transformieren oder Ziel hinzufügen im Kollaborationsbereich aus und wählen Sie dann Eventhouse aus.

    Screenshot der Auswahl des Eventhouse in der Dropdownliste „Ziel hinzufügen“.

  2. Wählen Sie auf dem Bildschirm „Eventhouse“ die Option Direkte Erfassung aus.

  3. Geben Sie einen Zielnamen, einen Arbeitsbereich und ein Eventhouse aus dem ausgewählten Arbeitsbereich ein.

  4. Wählen Sie Speichern.

    Ein Screenshot des Bildschirms zur Konfiguration des Eventhouse.

  5. Verbinden Sie die Karte des neuen Eventhouse-Ziels mit der Ausgabe Ihres Eventstreams, falls noch nicht verbunden, und wählen Sie dann Veröffentlichen aus.

    Screenshot des Eventstreams mit hervorgehobener Schaltfläche „Veröffentlichen“.

  6. Wählen Sie in der Live-Ansicht im Zielknoten der KQL-Datenbank Konfigurieren aus.

    Screenshot des veröffentlichten Eventstreams mit hervorgehobener Schaltfläche „Konfigurieren“ im KQL-Datenbankziel.

  7. Ihre KQL-Datenbank wird in der Anzeige Daten abrufen geöffnet. Wählen Sie eine vorhandene Tabelle der KQL-Datenbank aus oder wählen Sie Neue Tabelle aus, um eine neue Tabelle zum Weiterleiten und Erfassen der Daten zu erstellen.

  8. Geben Sie einen Datenverbindungsnamen an oder behalten Sie den angegebenen Namen bei und wählen Sie dann Weiter aus. Es kann einige Minuten dauern, bis Daten aus dem Eventstream abgerufen werden.

    Screenshot der Anzeige „Daten abrufen“ für das KQL-Datenbankziel mit hervorgehobener Schaltfläche „Weiter“.

  9. Auf der Anzeige Daten prüfen haben Sie folgende Möglichkeiten:

    • Wählen Sie ein Format aus, um eine Vorschau anzuzeigen, wie die Daten an Ihre KQL-Datenbank gesendet werden.
    • Wählen Sie Spalten bearbeiten aus, um die Spalten für Ihre Daten zu konfigurieren.
    • Wählen Sie Erweitert aus, um Ereignisse, die einbezogen werden sollen, oder Zuordnungsoptionen auszuwählen.

    Screenshot mit den Datenformaten und erweiterten Optionen auf der Anzeige „Daten prüfen“.

  10. Wenn Sie Spalten bearbeiten auswählen, haben Sie auf der Anzeige Spalten bearbeiten folgende Möglichkeiten:

    • Wählen Sie Spalte hinzufügen aus, um eine Spalte hinzuzufügen.
    • Wählen Sie Quellspalten für die Zuordnung aus.
    • Wenden Sie die Zuordnungstransformation auf Spalten an.
    • Ändern Sie Beispieldaten-Werte.

    Wählen Sie dann Anwenden aus.

    Screenshot der Anzeige zum Bearbeiten von Spalten.

  11. Wenn Sie die Daten fertig konfiguriert haben, wählen Sie Fertigstellen auf der Anzeige Daten prüfen aus.

  12. Überprüfen Sie in der Zusammenfassung die Details und den Status Ihrer Datenerfassung, einschließlich der Tabelle mit dem von Ihnen definierten Schema und der Verbindung zwischen dem Eventstream und der KQL-Datenbank. Wählen Sie Schließen aus, um die Einrichtung der KQL-Datenbank abzuschließen.

    Screenshot der Zusammenfassung mit hervorgehobener Schaltfläche „Schließen“

Nun können Sie das KQL-Datenbankziel im Kollaborationsbereich in der Live-Ansicht sehen.

Screenshot des konfigurierten KQL-Datenbankziels in der Live-Ansicht.

Ereignisverarbeitung vor der Erfassung.

Der Modus zur Ereignisverarbeitung vor der Erfassung verarbeitet Ihre Ereignisdaten, bevor sie in die KQL-Datenbank aufgenommen werden. Verwenden Sie diesen Modus, wenn Sie Operatoren wie Filterung oder Aggregation anwenden, um die Daten vor der Aufnahme oder nach einem abgeleiteten Stream zu verarbeiten.

  1. Zeigen Sie im Bearbeitungsmodus für Ihren Eventstream auf einen Operator oder abgeleiteten Stream, wählen Sie + und dann KQL-Datenbank aus.

    Screenshot der Auswahl des +-Symbols für die Operatorausgabe und Auswählen der KQL-Datenbank.

  2. Auf der Anzeige KQL-Datenbank sollte die Ereignisverarbeitung vor der Erfassung bereits ausgewählt sein. Ergänzen Sie die restlichen Informationen zu Ihrer KQL-Datenbank und wählen Sie dann Speichern aus.

    Screenshot der Anzeige zur KQL-Datenbankkonfiguration für die Ereignisverarbeitung vor der Erfassung.

  3. Um das neu hinzugefügte KQL-Datenbankziel zu implementieren, wählen Sie Veröffentlichen.

    Screenshot des Eventstreams im Bearbeitungsmodus mit dem hinzugefügten KQL-Datenbankziel.

Sobald Sie diese Schritte abgeschlossen haben, ist der Eventstream mit dem KQL-Datenbankziel für die Visualisierung in der Live-Ansicht verfügbar.

Screenshot des konfigurierten Flows zur Verarbeitung des KQL-Datenbankereignisses in der Live-Ansicht.

Zugehöriger Inhalt

Wie Sie andere Ziele zu einem Eventstream hinzufügen können, erfahren Sie in den folgenden Artikeln:

Voraussetzungen

Bevor Sie beginnen, müssen die folgenden Voraussetzungen erfüllt sein:

  • Zugriff auf einen Arbeitsbereich im Fabric-Kapazitätslizenzmodus (oder) im Testlizenzmodus mit Mitwirkenden oder höheren Berechtigungen.
  • Sie benötigen Zugriff auf einen Premium-Arbeitsbereich mit der Berechtigung Mitwirkender oder höher, in dem sich Ihre KQL-Datenbank befindet.

Hinweis

Die maximale Anzahl der Quellen und Ziele für einen Ereignisstream beträgt 11.

Hinzufügen einer KQL-Datenbank als Ziel

Um eine KQL-Datenbank als Ziel hinzuzufügen, müssen Sie eine KQL-Datenbank im Arbeitsbereich erstellen und zwischen zwei Erfassungsmodi wählen: direkte Erfassung und Ereignisverarbeitung vor der Erfassung.

Direkte Erfassung

Dieser Modus erfasst Ihre Ereignisdaten direkt in die KQL-Datenbank ohne Verarbeitung. Sie können diesen Modus verwenden, wenn Sie ihre Ereignisdaten wie gewünscht erfassen und später in der KQL-Datenbank mithilfe von KQL-Abfragen eine Verarbeitung oder Transformation durchführen möchten.

  1. Wählen Sie im Menüband Neues Ziel oder in der Canvas des Haupt-Editors + und dann KQL-Datenbank aus. Der Konfigurationsbildschirm für das KQL-Datenbankziel wird angezeigt.

  2. Wählen Sie Direkte Erfassung aus, geben Sie einen Zielnamen ein, wählen Sie einen Arbeitsbereich aus, wählen Sie eine KQL-Datenbank aus dem ausgewählten Arbeitsbereich aus, und wählen Sie dann Hinzufügen und konfigurieren aus.

    Hinweis

    Sie können nur Arbeitsbereiche auswählen, die über dieselbe Fabric-Regionskapazität wie der Ereignisstream verfügen.

    Screenshot des Konfigurationsbildschirms für den Pull-Modus der KQL-Datenbank.

  3. Navigieren Sie auf der Seite Daten abrufen durch die Registerkarten, um die Konfiguration abzuschließen:

    1. Konfigurieren: Verwenden Sie eine vorhandene Tabelle Ihrer KQL-Datenbank, oder erstellen Sie eine neue Tabelle, um die Daten weiterzuleiten und zu erfassen. Füllen Sie die erforderlichen Felder aus, und wählen Sie dann die folgende Option aus: Weiter.

      Screenshot der Registerkarte „Ziel“ auf dem Bildschirm „Daten erfassen“ zum Erstellen eines KQL-Datenbankziels

    2. Prüfen: Wählen Sie ein Datenformat aus, und zeigen Sie eine Vorschau an, wie die Daten an Ihre KQL-Datenbank gesendet werden.

      Screenshot, der das Datenformat des Bildschirms der zu erfassenden Daten zum Erstellen eines KQL-Datenbankziels zeigt.

      Sie können auch den Spaltennamen, den Datentyp oder die Spalte aktualisieren, indem Sie in der Tabellenüberschrift auf den Pfeil klicken. Füllen Sie die erforderlichen Felder aus, und wählen Sie dann die folgende Option aus: Beenden.

      Screenshot, der zeigt, wie Sie die Spalte des Bildschirms der zu erfassenden Daten für die Erstellung eines KQL-Datenbankziels ändern.

      Der Screenshot zeigt die Änderung des Spaltennamens und des Datentyps auf dem Bildschirm der zu erfassenden Daten zur Erstellung eines KQL-Datenbankziels.

    3. Zusammenfassung: Überprüfen Sie den Status Ihrer Datenerfassung, einschließlich der Tabelle, die mit dem von Ihnen definierten Schema erstellt wurde, und der Verbindung zwischen dem Ereignisstream und der KQL-Datenbank.

      Screenshot der Registerkarte „Zusammenfassung“ des Bildschirms „Daten erfassen“ zum Erstellen eines KQL-Datenbankziels

  4. Nachdem Sie alles konfiguriert und Schließen ausgewählt haben, wird im Canvas ein KQL-Datenbankziel angezeigt, das mit Ihrem Ereignisstream verbunden ist.

    Screenshot mit dem neuen KQL-Datenbank-Pull-Modus-Ziel.

Ereignisverarbeitung vor dem Ingestion

Dieser Modus verarbeitet Ihre Ereignisdaten, bevor sie in die KQL-Datenbank aufgenommen werden. Sie können diesen Modus verwenden, wenn Sie eine Verarbeitung oder Transformation auf Ihre Ereignisdaten anwenden möchten, bevor Sie sie erfassen, z. B. Filtern, Aggregieren oder Erweitern. Sie können die Verarbeitungslogik mithilfe des Ereignisprozessors entwerfen.

  1. Wählen Sie die Ereignisverarbeitung vor der Erfassungaus, geben Sie Ihre Informationen in die KQL-Datenbank ein und wählen Sie dann Ereignisprozessor öffnen aus.

    Screenshot des Konfigurationsbildschirms für den Push-Modus der KQL-Datenbank.

  2. Entwerfen Sie die Ereignisverarbeitung mit dem Ereignisprozessor, und wählen Sie dann Speichern

    Screenshot des Bildschirms des Push-Modus-Ereignisprozessors.

  3. Wenn Sie eine vorhandene Kusto-Tabelle auswählen, wird die Schemaüberprüfung zwischen dem aktuellen Schema in diesem Eventstream und der Ziel-KQL-Tabelle ausgeführt. Wenn die beiden Schemas nicht übereinstimmen, wird eine Fehlermeldung angezeigt, die Sie daran erinnert, den Ereignisprozessor zu öffnen, um das Schema in diesem Eventstream entsprechend anzupassen.

    Screenshot des Fehlerbildschirms des Ereignisprozessors für den Pushmodus.

    Wenn Sie den Ereignisprozessor öffnen, werden die detaillierten Nichtübereinstimmungsinformationen auf der Registerkarte Erstellungsfehler angezeigt.

    Screenshot des Bildschirms für einen Nichtübereinstimmungsfehler des Pushmodus-Ereignisprozessors.

  4. Nachdem Sie alles konfiguriert und Speichernausgewählt haben, wird ein KQL-Datenbankziel auf dem Canvas angezeigt, verbunden mit Ihrem Eventstream, und Sie können die Metriken in den Datenerkenntnissen und Protokolle in Runtime-Protokollenüberprüfen.

    Screenshot, der das neue KQL-Datenbank-Push-Modus-Ziel zeigt.

Verwalten eines Ziels

Bearbeiten/Entfernen: Sie können ein Eventstreamziel entweder über den Navigationsbereich oder die Canvas bearbeiten oder entfernen.

Wenn Sie Bearbeiten auswählen, wird der Bearbeitungsbereich rechts im Haupt-Editor geöffnet. Sie können die Konfiguration wie gewünscht ändern, einschließlich der Ereignistransformationslogik, über den Ereignisprozessor-Editor.

Screenshot, auf dem gezeigt wird, wo Sie die Optionen für Ziele auf der Canvas ändern und löschen können

Zugehöriger Inhalt

Wie Sie andere Ziele zu einem Eventstream hinzufügen können, erfahren Sie in den folgenden Artikeln: