Hinzufügen Azure IoT Hub Quelle zu einem Ereignisstream

In diesem Artikel wird gezeigt, wie Sie einem Microsoft Fabric Eventstream eine Azure IoT Hub Quelle hinzufügen.

Voraussetzungen

  • Zugriff auf einen Arbeitsbereich im Fabric-Kapazitätslizenz-Modus oder Testlizenz-Modus mit Mitwirkender- oder höheren Berechtigungen.
  • Entsprechende Berechtigung, um die Zugriffsschlüssel Ihres IoT-Hubs zu erhalten. Wenn sich Ihr IoT-Hub in einem geschützten Netzwerk befindet, stellen Sie mithilfe eines Streaming-vNet-Datengateways eine Verbindung mit ihm her. Stellen Sie andernfalls sicher, dass der IoT-Hub öffentlich zugänglich ist und nicht hinter einer Firewall.

Starten des Assistenten zum Auswählen einer Datenquelle

Wenn Sie Ihrem Eventstream noch keine Quelle hinzugefügt haben, wählen Sie die Kachel "Datenquellen verbinden" aus . Sie können auch Quelle hinzufügen>Datenquellen verbinden im Menüband auswählen.

Screenshot, der die Auswahl der Kachel für die Verwendung einer externen Quelle zeigt.

Wenn Sie die Quelle zu einem bereits veröffentlichten Ereignisstream hinzufügen, wechseln Sie zum Bearbeitungsmodus . Wählen Sie im Menüband "Quelle hinzufügen; Datenquellen verbinden" aus.

Screenshot der Auswahl zum Hinzufügen externer Quellen.

Suchen Sie auf der Seite Auswahl einer Datenquelle nach Azure IoT Hub. Wählen Sie auf der Kachel Azure IoT HubVerbinden aus.

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

Konfigurieren eines Azure IoT Hub Connectors

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

    Screenshot der Seite

    Wenn eine Verbindung mit Ihrem IoT-Hub besteht, wählen Sie diese vorhandene Verbindung aus, und fahren Sie dann mit der Konfiguration des Datenformats in den folgenden Schritten fort.

    Screenshot der Seite

  2. Geben Sie im Abschnitt Connection für IoT Hub den Namen Ihrer IoT hub an.

    Screenshot der Verbindungseinstellungen mit dem Namen eines IoT-Hubs.

  3. Führen Sie im Abschnitt "Verbindungsanmeldeinformationen " die folgenden Schritte aus:

    1. Wenn eine Verbindung vorhanden ist, wählen Sie sie aus der Dropdownliste 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. Für Authentifizierungsart bestätigen Sie, dass 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.

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

      1. Wechseln Sie zur Seite für Ihren IoT-Hub im Azure-Portal.
      2. Wählen Sie im linken Bereich unter "Sicherheitseinstellungen" die Option "Richtlinien für den freigegebenen Zugriff" aus.
      3. Wählen Sie einen Richtliniennamen aus der Liste aus. Notieren Sie sich den Richtliniennamen.
      4. Klicken Sie auf die Kopier-Taste neben dem Primärschlüssel.

      Screenshot der Zugriffstaste für einen IoT-Hub.

  4. Wählen Sie Verbinden aus.

    Screenshot, der die Schaltfläche

  5. Geben Sie für "Consumer"-Gruppe den Namen der Consumergruppe ein. Die Standard-Consumergruppe für den IoT-Hub ist $Default.

  6. Wählen Sie für das Datenformat ein Datenformat für die eingehenden Echtzeitereignisse aus, die Sie von Ihrem IoT-Hub abrufen möchten. Sie können aus JSON-, Avro- und CSV-Datenformaten auswählen. Wählen Sie dann Verbinden aus.

Stream- oder Quelldetails

  1. Führen Sie auf der Seite "Verbinden " einen dieser Schritte aus, je nachdem, ob Sie Eventstream oder Real-Time Hub verwenden.

    • Eventstream:

      Führen Sie im Bereich " Quelldetails " rechts die folgenden Schritte aus:

      1. Wählen Sie für den Quellnamen die Stiftschaltfläche aus, um den Namen zu ändern.

      2. Beachten Sie, dass der Eventstream-Name und der Stream-Name schreibgeschützt sind.

    • Real-Time Hub:

      Führen Sie im Abschnitt Datenstromdetails die folgenden Schritte aus:

      1. Wählen Sie den arbeitsbereich Fabric aus, in dem Sie den Ereignisstream erstellen möchten.

      2. Wählen Sie für den Eventstream-Namen die Stiftschaltfläche aus, und geben Sie einen Namen für den Eventstream ein.

      3. Der Wert für den Stream-Namen wird automatisch generiert, indem "-stream " an den Namen des Ereignisstreams angefügt wird. Dieser Datenstrom wird auf der Seite "Alle Datenströme" des Echtzeithubs angezeigt, wenn der Assistent beendet wird.

  2. Wählen Sie unten auf der Seite "Konfigurieren" die Option "Weiter" aus.

Überprüfen und Verbinden

Überprüfen Sie auf dem Bildschirm "Überprüfen + Verbinden " die Zusammenfassung, und wählen Sie "Hinzufügen " (Eventstream) oder "Verbinden " (Real-Time Hub) aus.

  1. Wählen Sie auf der Seite "Verbinden " für die Featureebene die Option "Erweiterte Features " (Vorschau) 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, und fahren Sie dann mit dem Schritt fort, um Azure IoT Hub Datenquelle zu konfigurieren.

  2. Geben Sie im Abschnitt Verbinden den Namen Ihrer Azure IoT Hub ein:

    Screenshot mit den Verbindungseinstellungen für den IoT Hub mit dem Namen IoT Hub.

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

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

    2. Geben Sie für Connection-Name einen Namen für die Verbindung mit dem IoT Hub ein.

    3. Wählen Sie für Data-Gateway die entsprechende Option basierend auf Ihrer IoT Hub Netzwerkkonfiguration aus:

      • Wenn Ihre IoT Hub öffentlich ist, wählen Sie none aus.
      • Wenn sich Ihre IoT Hub unter einem privaten Netzwerk befindet und Sie eine Verbindung über ein Streaming-Gateway für virtuelle Netzwerkdaten herstellen möchten, wählen Sie das Streaming-vNet-Datengateway aus (präfix "[Streaming VNet]). Sie können das Aktualisierungssymbol auswählen, um das neu erstellte Gateway anzuzeigen.

      Hinweis

      Wenn ein Datengateway ausgewählt ist, überspringen Sie den Testverbindungsschritt in diesem Verbindungserstellungs-Assistenten.

    4. Für die Authentifizierungsart ist der Standardwert "Shared Access Key".

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

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

    7. 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 im Azure-Portal zur Seite Ihres Azure IoT Hub.

      2. Wählen Sie auf der Seite IoT Hub im linken Navigationsmenü unter SicherheitseinstellungenFreigegebene 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 Verbrauchergruppe den Namen der Verbrauchergruppe ein. Standardmäßig ist $Default ausgewählt, bei dem es sich um die Standard-Consumergruppe für den IoT Hub handelt.

  5. Wählen Sie für die Startposition die Stelle im Datenstrom aus, um mit dem Lesen von Datensätzen zu beginnen.

  6. Wählen Sie dann unten auf der Seite "Weiter" aus.

    Screenshot mit dem Abschnitt

  7. Wählen Sie auf der Seite "Überprüfen+ Verbinden " die Option "Jetzt hinzufügen" aus.

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

Stream- oder Quelldetails

  1. Führen Sie auf der Seite "Verbinden " einen dieser Schritte aus, je nachdem, ob Sie Eventstream oder Real-Time Hub verwenden.

    • Eventstream:

      Führen Sie im Bereich " Quelldetails " rechts die folgenden Schritte aus:

      1. Wählen Sie für den Quellnamen die Stiftschaltfläche aus, um den Namen zu ändern.

      2. Beachten Sie, dass der Eventstream-Name und der Stream-Name schreibgeschützt sind.

    • Real-Time Hub:

      Führen Sie im Abschnitt Datenstromdetails die folgenden Schritte aus:

      1. Wählen Sie den arbeitsbereich Fabric aus, in dem Sie den Ereignisstream erstellen möchten.

      2. Wählen Sie für den Eventstream-Namen die Stiftschaltfläche aus, und geben Sie einen Namen für den Eventstream ein.

      3. Der Wert für den Stream-Namen wird automatisch generiert, indem "-stream " an den Namen des Ereignisstreams angefügt wird. Dieser Datenstrom wird auf der Seite "Alle Datenströme" des Echtzeithubs angezeigt, wenn der Assistent beendet wird.

  2. Wählen Sie unten auf der Seite "Konfigurieren" die Option "Weiter" aus.

Hinweis

Ein Eventstream kann bis zu 11 kombinierte Quellen und Ziele nur unterstützen, wenn Sie die folgenden Typen verwenden:

  • Quelle: Benutzerdefinierter Endpunkt.
  • Ziele: Benutzerdefinierter Endpunkt und Eventhouse mit direkter Verarbeitung.

Alle Quellen oder Ziele, die nicht in der vorherigen Liste enthalten sind, und Ziele, die nicht an den Standarddatenstrom angefügt werden, zählen nicht zu diesem Grenzwert.

Anzeigen eines aktualisierten Ereignisstreams

  1. Vergewissern Sie sich, dass die Azure IoT Hub Quelle ihrem Eventstream im Editmodus hinzugefügt wird. Um diesen neu hinzugefügten IoT-Hub zu implementieren, wählen Sie im Menüband "Veröffentlichen" aus.

    Screenshot des Editors mit ausgewählter Schaltfläche

  2. Der IoT-Hub ist für die Visualisierung in der Liveansicht verfügbar. Wählen Sie die IoT-Hubkachel im Diagramm aus, um eine Seite ähnlich dem folgenden Beispiel anzuzeigen.

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

Zugehöriger Inhalt

  • Last updated on