Freigeben über


Azure IoT Hub Quelle zu einem Eventstream hinzufügen

Dieser Artikel zeigt Ihnen, wie Sie eine Azure IoT Hub-Quelle zu einem Eventstream 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

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 die entsprechende Berechtigung zum Abrufen der Zugriffsschlüssel des IoT-Hubs. Der IoT Hub muss öffentlich zugänglich sein und darf sich nicht hinter einer Firewall befinden oder in einem virtuellen Netzwerk geschützt sein.
  • Wenn Sie keinen Eventstream haben, erstellen Sie einen Eventstream.

Starten des Assistenten zum Auswählen einer Datenquelle

Wenn Sie Ihrem Eventstream noch keine Quelle hinzugefügt haben, wählen Sie die Kachel Externe Quelle verwenden aus.

Screenshot der Auswahl der Kachel „Externe Quelle verwenden“.

Wenn Sie die Quelle zu einem bereits veröffentlichten Eventstream hinzufügen, wechseln Sie zum Bearbeitungsmodus, wählen Sie im Band Quelle hinzufügen und dann Externe Quellen aus.

Screenshot der Auswahl des Menüs Quelle zu externen Quellen hinzufügen.

Suchen Sie auf der Seite Datenquelle auswählen auf der Kachel Azure IoT Hub verbinden, und wählen Sie Verbinden aus.

Screenshot der Auswahl von Azure IoT Hub als Quellentyp im Assistenten zum Abrufen von Ereignissen.

Konfigurieren des Azure IoT Hub-Konnektors

  1. Wählen Sie auf der Seite Verbinden die Option Neue Verbindung aus.

    Screenshot der Seite Verbinden auf welcher der Link

    Wenn eine Verbindung mit Ihrem Azure IoT Hub besteht, wählen Sie diese vorhandene Verbindung aus, wie in der folgenden Abbildung dargestellt, und fahren Sie dann mit dem Schritt fort, um das Datenformat in den folgenden Schritten zu konfigurieren.

    Screenshot, der die Seite Verbinden mit einer bestehenden Verbindung zu einem Azure IoT Hub zeigt.

  2. Geben Sie im Abschnitt Verbindungseinstellungen für IoT-Hub den Namen Ihres Azure IoT Hubs an.

    Screenshot der Verbindungseinstellungen für den IoT-Hub mit dem Namen des IoT-Hubs.

  3. Führen Sie im Abschnitt Verbindungs-Anmeldedaten die folgenden Schritte aus:

    1. Wenn eine Verbindung vorhanden ist, wählen Sie sie aus der Einblendliste aus. Wenn dies nicht der Fall ist, vergewissern Sie sich, dass für diese Option Neue Verbindung erstellen ausgewählt ist.

    2. Für Verbindungsname geben Sie einen Namen für die Verbindung mit dem IoT-Hub ein.

    3. Vergewissern Sie sich bei der Authentifizierungsmethode, dass der Freigegebene Zugriffsschlüssel ausgewählt ist.

    4. Geben Sie für den Namen des freigegebenen Zugriffsschlüssels den Namen des freigegebenen Zugriffsschlüssels ein.

    5. Geben Sie für den Freigegebenen Zugriffsschlüssel den Wert des freigegebenen Zugriffsschlüssels ein.

    6. Wählen Sie am unteren Rand der Seite die Option Verbinden aus.

      Der Screenshot zeigt die Verbindungsseite eins für den Azure IoT Hub-Konnektor.

      Führen Sie die folgenden Schritte aus, um den Namen und den Wert des Zugriffsschlüssels abzurufen:

      1. Navigieren Sie zur IoT-Hub-Seite für Ihren Azure IoT Hub im Azure-Portal.

      2. Wählen Sie auf der Seite IoT Hub unter Sicherheitseinstellungen im linken Navigationsmenü Freigegebene Zugriffsrichtlinien aus.

      3. Wählen Sie in der Liste einen Richtlinien-Namen aus. Notieren Sie sich den Richtliniennamen.

      4. Klicken Sie auf die Kopier-Taste neben dem Primärschlüssel.

        Screenshot des Zugriffsschlüssels für einen Azure IoT Hub.

  4. Geben Sie nun auf der Seite Verbinden des Assistenten unter Consumergruppe den Namen der Consumergruppe ein. Standardmäßig ist $Default ausgewählt, was die Standard-Consumergruppe für den IoT-Hub ist.

  5. Für Datenformat wählen Sie ein Datenformat der eingehenden Echtzeitereignisse aus, die Sie von Ihrem Azure IoT Hub abrufen möchten. Sie können aus JSON-, Avro- und CSV-Datenformaten auswählen und dann Verbinden auswählen.

  6. Wählen Sie im Abschnitt Stream-Details auf der rechten Seite das Bleistiftsymbol unter Quellname aus, und geben Sie einen Namen für die Quelle ein. Dieser Schritt ist optional.

  7. Wählen Sie unten auf der Seite die Option Weiter aus.

    Der Screenshot zeigt die Verbindungsseite zwei für den Azure IoT Hub-Konnektor.

  8. Überprüfen Sie die Einstellungen auf der Seite Überprüfen und erstellen, und wählen Sie Hinzufügen aus.

    Der Screenshot zeigt die Seite „Überprüfen und Erstellen“ für den Azure IoT Hub-Konnektor.

Hinweis

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

Anzeigen des aktualisierten Eventstreams

  1. Sie sehen, dass die Azure IoT Hub-Quelle ihrem Eventstream im Bearbeitungsmodus auf dem Kollaborationsbereich hinzugefügt wird. Um diesen neu hinzugefügten Azure IoT Hub zu implementieren, wählen Sie im Band Veröffentlichen aus.

    Screenshot des Editors mit ausgewählter Veröffentlichen-Taste.

  2. Nachdem Sie diese Schritte ausgeführt haben, steht der Azure IoT-Hub für die Visualisierung in der Live-Ansicht zur Verfügung. Wählen Sie die Kachel IoT Hub im Diagramm aus, um die Seite ähnlich der folgenden anzuzeigen.

    Screenshot, der den Editor in der Live-Ansicht zeigt.

Eine Liste der unterstützten Quellen finden Sie unter Hinzufügen einer Ereignisquelle in einem Ereignisstream

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 die entsprechende Berechtigung zum Abrufen der Zugriffsschlüssel des IoT-Hubs. Der IoT Hub muss öffentlich zugänglich sein und darf sich nicht hinter einer Firewall befinden oder in einem virtuellen Netzwerk geschützt sein.

Hinweis

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

Hinzufügen eines Azure IoT Hubs als Quelle

Führen Sie die folgenden Schritte aus, um einen Azure IoT Hub als Ereignisstreamquelle hinzuzufügen:

  1. Erweitern Sie im Eventstream-Editor das Dropdownmenü Neue Quelle im Knoten, und wählen Sie Azure IoT Hub aus.

    Screenshot: Hier fügen Sie eine Azure IoT Hub-Quelle für den Eventstream hinzu.

  2. Geben Sie im Konfigurationsbereich Azure IoT Hub folgende Daten ein:

    Screenshot: Hier konfigurieren Sie Azure IoT Hub für den Eventstream.

    1. Name der Quelle: Geben Sie einen Namen für Ihren Azure IoT Hub ein, z. B. iothub-source.

    2. Cloudverbindung: Wählen Sie eine vorhandene Cloudverbindung aus, die Ihren Azure IoT Hub mit Microsoft Fabric verknüpft. Wenn noch keine Cloudverbindung vorhanden ist, fahren Sie mit Schritt 3 fort, um eine neue zu erstellen.

    3. Datenformat: Wählen Sie ein Datenformat (AVRO, JSON oder CSV) zum Streamen Ihrer IoT Hub-Daten in den Eventstream aus.

    4. Consumergruppe. Wählen Sie eine Consumergruppe aus Ihrem Azure IoT Hub aus, oder übernehmen Sie den Standardwert $Default. Wählen Sie dann Hinzufügen aus, um die Azure IoT Hub-Konfiguration abzuschließen.

    5. Nach erfolgreichem Abschluss des Vorgangs sehen Sie im Editor eine Azure IoT Hub-Quelle, die Ihrem Eventstream hinzugefügt wurde.

      Screenshot: Azure IoT Hub-Quelle im Eventstream-Editor.

  3. Um eine neue Cloudverbindung für Ihre Azure IoT Hub zu erstellen, führen Sie die folgenden Schritte aus:

    Screenshot: Hier erstellen Sie eine neue Cloudverbindung.

    1. Wählen Sie Neue Verbindung erstellen aus dem Dropdownmenü, geben Sie die Verbindungseinstellungen und Anmeldeinformationen für Ihren Azure IoT Hub ein und wählen Sie dann Erstellen aus.

      Screenshot: Hier konfigurieren Sie eine neue Cloudverbindung.

    2. IoT Hub. Geben Sie den Namen des IoT Hub im Azure-Portal ein.

    3. Verbindungsname. Geben Sie einen Namen für die neue Cloudverbindung ein, z. B. iothub-connection.

    4. Name des gemeinsamen Zugriffsschlüssels und Gemeinsamer Zugriffsschlüssel. Geben Sie die Verbindungsanmeldeinformationen für Ihren Azure IoT Hub ein. Diese finden Sie im Azure-Portal unter Richtlinien für gemeinsamen Zugriff. Sie müssen über Berechtigungen für den Zugriff auf IoT Hub-Endpunkte verfügen.

      Screenshot: Hier finden Sie den Schlüssel für den gemeinsamen Zugriff im Azure-Portal.

    5. Kehren Sie zum Konfigurationsbereich von Azure IoT Hub zurück, und wählen Sie Aktualisieren aus, um die neue Cloudverbindung zu laden.

      Screenshot: Hier aktualisieren Sie die Cloudverbindung für Azure IoT Hub.

Wenn der Azure IoT Hub zu Ihrem Eventstream hinzugefügt wurde, wählen Sie Datenvorschau aus, um zu überprüfen, ob die Konfiguration erfolgreich war. Sie sollten eine Vorschau eingehender Daten für Ihren Eventstream anzeigen können.

Screenshot: Hier zeigen Sie eine Vorschau der IoT Hub-Daten an.

Informationen zum Hinzufügen anderer Quellen zu einem Eventstream finden Sie in den folgenden Artikeln: