Event Hub-Adapter in BizTalk

Übersicht

Beginnen mit BizTalk Server 2016 Feature Pack 2: Sie können Nachrichten zwischen BizTalk Server und Azure Event Hubs senden und empfangen.

Azure Event Hubs ist eine hochgradig skalierbare Datenstreamingplattform, die Millionen von Ereignissen pro Sekunde empfangen und verarbeiten kann. Was ist Event Hubs? stellt weitere Details bereit.

Voraussetzungen

Ihr Event Hub wird jetzt erstellt, und Sie verfügen über die zum Senden und Empfangen von Ereignissen erforderlichen Verbindungszeichenfolgen.

Senden von Nachrichten an Ereignis-Hubs

  1. Klicken Sie in der BizTalk Server-Verwaltungskonsole mit der rechten Maustaste auf Sendeports, wählen Sie Neu und dann Statischer, einseitiger Sendeport aus.

    Erstellen eines Sendeports enthält einige Anleitungen.

  2. Geben Sie einen Namen ein. Legen Sie unter Transport den Typ auf EventHub fest, und wählen Sie Konfigurieren aus.

  3. Konfigurieren Sie die Eigenschaften des Azure-Kontos:

    Option Aufgabe
    Anmeldung Anmelden bei Ihrem Azure-Konto
    Abonnement Wählen Sie das Abonnement mit Ihrem EventHubs-Namespace aus.
    Ressourcengruppe Wählen Sie Ihre Ressourcengruppe mit Ihrem EventHubs-Namespace aus.
  4. Konfigurieren Sie die Endpunkteigenschaften:

    Option Aufgabe
    Namespace Wählen Sie Ihren Event Hubs Namespace aus, der etwa sb://IhremEventHubnamespace.servicebus.windows.net/
    Name Wählen Sie den Namen Ihres Event Hubs (der in Ihrem Event Hubs-Namespace erstellt wurde) aus.
    Standardpartitionsschlüssel (Optional) Event Hubs Programmierhandbuch enthält weitere Details zu diesem Schlüssel.
    Authentifizierung Die Namespacezugriffssignatur ist die Standardeinstellung und verwendet automatisch den RootManageSharedAccessKey, der beim Erstellen eines Event Hubs Namespace erstellt wird.

    Entity Access Signature ist die SAS-Richtlinie, die Sie auf Event Hub-Ebene erstellen können (nicht auf der Event Hubs Namespaceebene).

    Event Hubs Übersicht über Features werden weitere Informationen erläutert.

    Wenn Sie fertig sind, sehen Ihre Eigenschaften in etwa wie folgt aus:

    Beispieleigenschaften für Namespace, Name, Partitionsschlüssel und Authentifizierung im Event Hub-Adapter senden Portendpunkteigenschaften in BizTalk Server

  5. (Optional) Konfigurieren Sie die Nachrichteneigenschaften. Der Wert Namespace für benutzerdefinierte Nachrichteneigenschaften stellt den Namespace für Kontexteigenschaften dar, die Event Hubs Nachrichteneigenschaften zugeordnet sind. Dies kann mithilfe eines Eigenschaftenschemas erreicht werden.

  6. Wählen Sie OK aus, um die Änderungen zu speichern.

Testen des Sendeports

Sie können einen einfachen Dateie receive-Port und -Speicherort verwenden, um Nachrichten an Ihren Azure Event Hub zu senden.

  1. Erstellen Sie mithilfe des Dateiadapters einen Empfangsport. Legen Sie an Ihrem Empfangsspeicherort den Ordner Receive auf \ C:\Temp\In fest, und legen Sie die Dateimaske auf *.xml fest.

  2. Legen Sie in den Eigenschaften ihres Event Hub-Sendeports die Filter auf BTS.ReceivePortName == FileReceivePort fest.

  3. Fügen Sie Folgendes in einen Text-Editor ein, und speichern Sie die Datei als EventHubMessage.xml. Dies ist Ihre Beispielmeldung.

    <Data>
      <DataID>DataID_0</DataID>
      <DataDetails>DataDetails_0</DataDetails>
    </Data>
    
  4. Starten Sie den Dateieingspeicherort und den Event Hub-Sendeport.

  5. Kopieren Sie EventHubMessage.xml Beispielnachricht in den Empfangsordner (C:\Temp\In ) ). Der Sendeport sendet die XML-Datei an den Event Hub.

Empfangen von Nachrichten von Event Hubs

  1. Klicken Sie in der BizTalk Server-Verwaltungskonsole mit der rechten Maustaste auf Empfangsports, wählen Sie Neu und dann One-Way-Empfangsport aus.

    Erstellen eines Empfangsports enthält einige Anleitungen.

  2. Geben Sie einen Namen ein, und wählen Sie Empfangsspeicherorte aus.

  3. Wählen Sie Neu aus, und nennen Sie den Empfangsspeicherort. Wählen Sie unter Transport in der Dropdownliste Typ die Option EventHub und dann Konfigurieren aus.

  4. Konfigurieren Sie die Eigenschaften des Azure-Kontos:

    Option Aufgabe
    Anmeldung Anmelden bei Ihrem Azure-Konto
    Abonnement Wählen Sie das Abonnement mit Ihrem EventHubs-Namespace aus.
    Ressourcengruppe Wählen Sie Ihre Ressourcengruppe mit Ihrem EventHubs-Namespace aus.
  5. Konfigurieren Sie die Endpunkteigenschaften:

    Option Aufgabe
    Namespace Wählen Sie Ihren Event Hubs Namespace aus, der etwa sb://IhremEventHubnamespace.servicebus.windows.net/
    Name Wählen Sie den Namen Ihres Event Hubs (der in Ihrem Event Hubs-Namespace erstellt wurde) aus.
    Consumergruppe Wählen Sie die Consumergruppe in Ihrem Event Hub aus. Eine Standardgruppe wird automatisch erstellt.

    Event Hubs Bietet weitere Details.
    Authentifizierung Die Namespacezugriffssignatur ist die Standardeinstellung und verwendet automatisch den RootManageSharedAccessKey, der beim Erstellen eines Event Hubs Namespace erstellt wird.

    Entity Access Signature ist die SAS-Richtlinie, die Sie auf Event Hub-Ebene erstellen können (nicht auf der Event Hubs Namespaceebene).

    Event Hubs Übersicht über Features werden weitere Informationen erläutert.

    Wenn Sie fertig sind, sehen Ihre Eigenschaften in etwa wie folgt aus:

    Beispieleigenschaften für Namespace, Name, Consumergruppe und Authentifizierung im Event Hub-Adapter empfangen Standortendpunkteigenschaften in BizTalk Server

  6. Konfigurieren Sie die Prüfpunkteigenschaften. Dieser Adapter verwendet ein Azure Blob Storage-Konto, um Ereignisse zuverlässig mithilfe eines Prüfpunkts zu lesen und nach einem Neustart fortzusetzen.

    Storage Authentifizierung
    Wählen Sie eine Authentifizierungsmethode aus. In der Regel wird empfohlen, eine Shared Access Signature zu verwenden. Die folgenden Links sind gute Ressourcen, die Ihnen bei der Entscheidung helfen, welche für Ihr Szenario geeignet ist:

    Informationen zu Azure-Speicherkonten
    Verwenden von Shared Access Signatures (SAS)

    Wenn Sie fertig sind, sehen Ihre Eigenschaften in etwa wie folgt aus:

    Prüfpunkteigenschaften

  7. Konfigurieren Sie die Nachrichteneigenschaften:

    Option Aufgabe
    Namespace für benutzerdefinierte Nachrichteneigenschaften http://schemas.microsoft.com/BizTalk/EventHubAdapter/EventData/User ist das Standardschema, aber Sie können ein anderes Schema eingeben. Dieser Wert stellt ein BizTalk-Nachrichtenschema dar, das Event Hubs Nachrichteneigenschaften zugeordnet ist.
    Benutzerdefinierte Eigenschaften promoten (Optional) Sie können diese Eigenschaften nach Ihren Bevorzugten promoten.

    HINWEIS
    Für die Eigenschaften, die promotet werden müssen, muss ein Eigenschaftenschema bereitgestellt werden, bevor Ereignisse empfangen werden.
  8. Wählen Sie OK aus, um die Änderungen zu speichern.

Testen der Empfangseinstellungen

Sie können einen einfachen Sendeport für Dateien verwenden, um Nachrichten von Ihrem Azure Event Hub zu empfangen.

  1. Erstellen Sie mithilfe des Dateiadapters einen Sendeport. Legen Sie in den Sendeporteigenschaften den Zielordner auf C:\Temp\Out \ und den Dateinamen und auf %MessageID%.xml.
  2. Legen Sie in den Eigenschaften des Sendeports für Datei die Filter auf BTS.ReceivePortName == EHReceivePort fest.
  3. Starten Sie den Event Hub-Empfangsspeicherort und den Sendeport Datei.
  4. Suchen Sie im Zielordner nach Nachrichten (c:\temp\out).

Weitere Informationen

Event Hubs gilt als "Front Door" für viele andere Azure-Dienste, einschließlich Azure Data Lake, HD Insight und mehr. Es wurde entwickelt, um viele Nachrichten zu verarbeiten und schnell zu verarbeiten. Erfahren Sie mehr über Event Hubs und die features:

Event Hubs-Features im Überblick
Was ist Event Hubs?