Een aangepast eindpunt of aangepaste app-bron toevoegen aan een eventstream

Artikel
11/19/2024

Als u uw eigen toepassing wilt verbinden met een eventstream, kunt u een aangepast eindpunt of een aangepaste app toevoegen als bron. Vervolgens kunt u realtimegebeurtenissen vanuit uw eigen toepassing verzenden naar de eventstream, waarbij het verbindingseindpunt wordt weergegeven op het aangepaste eindpunt of de aangepaste app. Met het Apache Kafka-protocol dat beschikbaar is als optie voor aangepaste eindpunten of aangepaste apps, kunt u ook realtime gebeurtenissen verzenden met behulp van het Apache Kafka-protocol.

In dit artikel leest u hoe u een aangepaste eindpuntbron of een aangepaste app-bron toevoegt aan een eventstream in Microsoft Fabric-gebeurtenisstromen.

Notitie

Verbeterde mogelijkheden zijn standaard ingeschakeld wanneer u nu eventstreams maakt. Als u eventstreams hebt die zijn gemaakt met behulp van standaardmogelijkheden, blijven deze eventstreams werken. U kunt ze nog steeds bewerken en gebruiken zoals gebruikelijk. U wordt aangeraden een nieuwe eventstream te maken om standaard eventstreams te vervangen, zodat u kunt profiteren van extra mogelijkheden en voordelen van verbeterde eventstreams.

Vereisten

Toegang tot een werkruimte in de licentiemodus voor infrastructuurcapaciteit (of) de modus Voor proeflicenties met inzender- of hogere machtigingen.
Als u geen eventstream hebt, maakt u een eventstream.

Aangepaste eindpuntgegevens toevoegen als bron

Als u een aangepaste eindpuntbron wilt toevoegen, selecteert u Aangepast eindpunt gebruiken op de pagina Aan de slag. Als u al een gepubliceerde eventstream hebt en u aangepaste eindpuntgegevens als bron wilt toevoegen, schakelt u over naar de bewerkingsmodus. Selecteer Op het lint het aangepaste broneindpunt> toevoegen.
Voer in het dialoogvenster Aangepast eindpunt een naam in voor de aangepaste bron onder Bronnaam en selecteer Vervolgens Toevoegen.
Nadat u de aangepaste eindpuntbron hebt gemaakt, wordt deze toegevoegd aan uw eventstream op het canvas in de bewerkingsmodus. Als u de zojuist toegevoegde gegevens uit de aangepaste app-bron wilt implementeren, selecteert u Publiceren.

Notitie

Het maximum aantal bronnen en bestemmingen voor één eventstream is 11.

Eindpuntdetails ophalen in het deelvenster Details

Nadat u een aangepaste eindpuntbron hebt gemaakt, zijn de gegevens beschikbaar voor visualisatie in de liveweergave.

Schermopname van de eventstream in de liveweergave.

Het deelvenster Details bevat drie protocoltabbladen: Event Hub, AMQP en Kafka. Elk protocoltabblad heeft drie pagina's: Basis- en SAS-sleutelverificatie. Deze pagina's bieden de eindpuntgegevens met het bijbehorende protocol voor verbinding.

Basic toont de naam, het type en de status van uw aangepaste eindpunt.

De pagina SAS-sleutelverificatie bevat informatie over verbindingssleutels en ook een koppeling naar de voorbeeldcode, waarbij de bijbehorende sleutels zijn ingesloten, die u kunt gebruiken om de gebeurtenissen naar uw eventstream te streamen. De informatie op de pagina Sleutels verschilt per protocol.

Event Hub

De pagina SAS-sleutelverificatie op het tabblad Event Hub bevat informatie met betrekking tot de verbindingsreeks van een Event Hub. De informatie bevat de naam van de Event Hub, de naam van de gedeelde toegangssleutel, de primaire sleutel van de primaire sleutel van de verbinding, de secundaire sleutel van de verbindingsreeks.

Schermopname van belangrijke informatie in het deelvenster Details van de eventstream.

De Event Hub-indeling is de standaardindeling voor de verbindingsreeks en werkt met de Azure Event Hubs SDK. Met deze indeling kunt u verbinding maken met uw eventstream via het Event Hubs-protocol.

In het volgende voorbeeld ziet u hoe de verbindingsreeks eruitziet in event hub-indeling:

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

Als u de knop Voorbeeldcode weergeven selecteert, ziet u de kant-en-klare Java-code met de vereiste informatie over verbindingssleutels in de Event Hub. Kopieer en plak deze in uw toepassing voor gebruik.

Schermopname van voorbeeldcode in het deelvenster Details van de liveweergave van eventstream.

Advanced Message Queuing Protocol (AMQP)

De AMQP-indeling is compatibel met het AMQP 1.0-protocol, een standaardberichtenprotocol dat interoperabiliteit tussen verschillende platforms en talen ondersteunt. U kunt deze indeling gebruiken om verbinding te maken met uw eventstream met behulp van het AMQP-protocol.

Schermopname van AMQP-sleutels in het deelvenster Details van de liveweergave van eventstream.

Wanneer u de knop Voorbeeldcode weergeven selecteert, ziet u de kant-en-klare Java-code met verbindingssleutelgegevens in AMQP-indeling.

Schermopname van AMQP-voorbeeldcode in het deelvenster Details van de liveweergave van eventstream.

Kafka

De Kafka-indeling is compatibel met het Apache Kafka-protocol, een populair gedistribueerd streamingplatform dat ondersteuning biedt voor gegevensverwerking met hoge doorvoer en lage latentie. U kunt de SAS-sleutelverificatiegegevens voor de Kafka-protocolindeling gebruiken om verbinding te maken met uw eventstream en de gebeurtenissen te streamen.

Schermopname van Kafka-sleutels in het deelvenster Details van de liveweergave van eventstream.

Wanneer u de knop Voorbeeldcode weergeven selecteert, ziet u de kant-en-klare Java-code, inclusief de benodigde verbindingssleutels in Kafka-indeling. Kopieer deze voor uw gebruik.

Schermopname van kafka-voorbeeldcode in het deelvenster Details van de liveweergave van eventstream.

Notitie

U kunt de protocolindeling kiezen die past bij uw toepassingsbehoeften en voorkeuren en vervolgens de verbindingsreeks in uw toepassing kopiëren en plakken. U kunt ook de voorbeeldcode raadplegen of kopiëren, die laat zien hoe u gebeurtenissen verzendt of ontvangt met behulp van verschillende protocollen.

Als u de voorbeeldcodeweergave wilt afsluiten, selecteert u Voorbeeldcode verbergen.

Zie Een gebeurtenisbron toevoegen in een eventstream voor een lijst met ondersteunde bronnen

Vereisten

Voordat u begint, moet u toegang krijgen tot een werkruimte met inzender- of hogere machtigingen waar uw eventstream zich bevindt.

Notitie

Het maximum aantal bronnen en bestemmingen voor één eventstream is 11.

Een aangepaste app toevoegen als bron

Als u uw eigen toepassing wilt verbinden met een eventstream, kunt u een aangepaste app-bron toevoegen. Verzend vervolgens vanuit uw eigen toepassing gegevens naar de eventstream met het verbindingseindpunt dat in de aangepaste app wordt weergegeven.

Een aangepaste app-bron toevoegen:

Selecteer Nieuwe bron op het lint of het plusteken (+) in het canvas van de hoofdeditor en selecteer vervolgens Aangepaste app.
Voer in het deelvenster Aangepaste app een bronnaam in voor de aangepaste app en selecteer vervolgens Toevoegen.

Eindpuntdetails ophalen in het deelvenster Details om gebeurtenissen te verzenden

Nadat u de aangepaste toepassing als bron hebt gemaakt, kunt u de informatie weergeven in het deelvenster Details .

Het deelvenster Details bevat drie protocoltabbladen: Event Hub, AMQP en Kafka. Elk protocoltabblad heeft drie pagina's: Basisbeginselen, Sleutels en Voorbeeldcode. Deze pagina's bieden de eindpuntgegevens met het bijbehorende protocol voor verbinding.

In Basic ziet u de naam, het type en de status van uw aangepaste app.

Schermopname van basisinformatie voor een aangepaste app in het deelvenster Details van een eventstream.

Sleutels bevatten informatie over verbindingssleutels. Voorbeeldcode biedt de voorbeeldcode , met de bijbehorende sleutels ingesloten, die u kunt gebruiken om de gebeurtenissen naar uw eventstream te streamen. De informatie op deze pagina's verschilt per protocol.