Hinzufügen einer benutzerdefinierten App-Quelle zu einem Eventstream

  • Artikel

In diesem Artikel wird veranschaulicht, wie Sie einem Eventstream eine benutzerdefinierte App-Quelle hinzufügen.

Voraussetzungen

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

  • Erhalten Sie Zugriff auf einen Premium-Arbeitsbereich mit Mitwirkender-Berechtigungen oder höher, in dem sich Ihr Ereignisstream befindet.

Hinweis

  • Die maximale Anzahl der Quellen und Ziele für einen Ereignisstream beträgt 11.
  • Die Aufbewahrung von Ereignisdaten in einem Ereignisstream beträgt 1 Tag, mit der Möglichkeit, sie zu erweitern und in Zukunft konfigurierbar zu machen.

Hinzufügen einer benutzerdefinierten Anwendung als Quelle

Wenn Sie Ihre eigene Anwendung mit einem Ereignisstream verbinden möchten, können Sie eine benutzerdefinierte App-Quelle hinzufügen. Senden Sie dann Daten mit Ihrer eigenen Anwendung an den Ereignisstream, wobei der Verbindungsendpunkt in der benutzerdefinierten App verfügbar gemacht wird. Führen Sie die folgenden Schritte aus, um eine benutzerdefinierte App-Quelle hinzuzufügen:

  1. Wählen Sie im Menüband Neue Quelle oder in der Canvas des Haupt-Editors „+“ und dann Benutzerdefinierte App aus.

  2. Geben Sie einen Quellennamen für die benutzerdefinierte App ein, und wählen Sie Hinzufügen aus.

    Screenshot der Konfiguration der Quelle „Benutzerdefinierte App“.

  3. Nachdem Sie die benutzerdefinierte Anwendungsquelle erfolgreich erstellt haben, können Sie die folgenden Informationen dazu auf der Registerkarte Details im unteren Bereich wechseln und anzeigen:

    Screenshot der Quelle „Benutzerdefinierte App“.

    • Basic: Zeigt den Namen, die Beschreibung, den Typ und den Status Ihrer benutzerdefinierten App an.
    • Schlüssel: Zeigt die Verbindungszeichenfolge für Ihre benutzerdefinierte App an, die Sie in Ihre Anwendung kopieren und einfügen können.
    • Beispielcode: Zeigt Beispielcode, auf den Sie sich beziehen oder den Sie kopieren können, um die Ereignisdaten in diesen Ereignisstream zu schieben oder die Ereignisdaten aus diesem Ereignisstream zu ziehen.

    Für jede Registerkarte (Basic / Schlüssel / Beispielcode) können Sie auch zwischen drei Protokollregisterkarten wechseln: Eventhub, **AMQP und Kafka, um auf verschiedene Protokollformate zuzugreifen:

    Die Verbindungszeichenfolge ist eine Event Hub-kompatible Verbindungszeichenfolge, die Sie in Ihrer Anwendung verwenden können, um Ereignisse von Ihrem Ereignisstream zu empfangen. Die Verbindungszeichenfolge verfügt über mehrere Protokollformate, die Sie auf der Registerkarte Schlüssel auswechseln und auswählen können. Das folgende Beispiel zeigt, wie die Verbindungszeichenfolge im Event Hubs-Format aussieht:

    Endpoint=sb://eventstream-xxxxxxxx.servicebus.windows.net/;SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxxxxx;EntityPath=es_xxxxxxxx

    Das EventHub-Format ist das Standardformat für die Verbindungszeichenfolge und ist mit dem Azure Event Hubs SDK kompatibel. Mit diesem Format können Sie mithilfe des Event Hubs-Protokolls eine Verbindung mit Eventstream herstellen.

    Screenshot mit den Details der benutzerdefinierten App.

    Die anderen beiden Protokollformate sind AMQP und Kafka. Diese können Sie auswählen, indem Sie auf die entsprechenden Registerkarten auf der Registerkarte Schlüssel klicken.

    Das AMQP-Format ist mit dem AMQP 1.0-Protokoll kompatibel, einem Standard-Nachrichtenprotokoll, das die Interoperabilität zwischen verschiedenen Plattformen und Sprachen unterstützt. Sie können dieses Format verwenden, um mithilfe des AMQP-Protokolls eine Verbindung mit Eventstream herzustellen.

    Das Kafka-Format ist mit dem Apache Kafka-Protokoll kompatibel, einer beliebten verteilten Streaming-Plattform, die Datenverarbeitung mit hohem Durchsatz und niedriger Wartezeit unterstützt. Sie können dieses Format verwenden, um mithilfe des Kafka-Protokolls eine Verbindung mit Eventstream herzustellen.

    Sie können das Protokollformat wählen, das Ihren Anwendungsanforderungen und -präferenzen entspricht, und die Verbindungszeichenfolge kopieren und in Ihre Anwendung einfügen. Sie können auch auf den Beispielcode verweisen oder ihn kopieren, den wir auf der Registerkarte Beispielcode zur Verfügung stellen und der zeigt, wie man Ereignisse mit verschiedenen Protokollen sendet oder empfängt.

Zugehöriger Inhalt

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

Informationen zum Hinzufügen eines Ziels zum Eventstream finden Sie in den folgenden Artikeln: