Een aangepast eindpunt of aangepaste app-bestemming toevoegen aan een eventstream
Als u uw eigen toepassing wilt verbinden met een eventstream, kunt u een aangepast eindpunt of een aangepaste app als bestemming toevoegen. Vervolgens kunt u realtimegebeurtenissen van de eventstream naar uw eigen toepassing gebruiken, 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 realtime gebeurtenissen gebruiken met behulp van het Apache Kafka-protocol.
In dit artikel leest u hoe u een aangepast eindpuntdoel of een aangepaste app-bestemming toevoegt aan een eventstream in Microsoft Fabric-gebeurtenisstreams.
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
Voordat u begint, moet u toegang krijgen tot een werkruimte in de modus Fabric-capaciteitslicentie (of) de modus Proeflicentie met inzender- of hogere machtigingen waar uw eventstream zich bevindt.
Notitie
Het maximum aantal bronnen en bestemmingen voor één eventstream is 11.
Een aangepast eindpunt toevoegen als bestemming
Als u gebeurtenisgegevens naar uw app wilt routeren, kunt u een aangepast eindpunt toevoegen als uw eventstream-bestemming:
Als u zich in de liveweergave bevindt, schakelt u over naar de bewerkingsmodus door Bewerken op het lint te selecteren.
Voeg in de bewerkingsmodus een aangepast eindpuntdoel toe op een van de volgende manieren:
Selecteer Bestemming toevoegen op het lint, selecteer Aangepast eindpunt en verbind het eindpunt vervolgens met uw standaardstream of afgeleide stream.
Selecteer in de editor transformatiegebeurtenissen of voeg bestemming toe en selecteer vervolgens Aangepast eindpunt.
Voer voor de doelnaam een naam in voor het aangepaste eindpunt. Selecteer vervolgens Opslaan.
Koppel de standaardstreamtegel aan de tegel van het aangepaste eindpunt als er geen bestaande verbinding is.
Als u de gedetailleerde informatie van uw aangepaste eindpunt wilt bekijken, selecteert u Publiceren.
Eindpuntdetails ophalen in het deelvenster Details om gebeurtenissen te gebruiken
Selecteer in de liveweergave de tegel van het aangepaste eindpunt. Het deelvenster Details dat wordt weergegeven, bevat drie protocoltabbladen: Event Hub, AMQP en Kafka.
Elk protocoltabblad heeft drie pagina's: Basiscode, Sleutels en Voorbeeldcode. 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.
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.
Event Hub
De pagina Sleutels 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 en de primaire sleutel van de verbindingsreeks.
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
De pagina Voorbeeldcode op het tabblad Event Hub bevat kant-en-klare code met de vereiste informatie over verbindingssleutels in de Event Hub . Kopieer en plak deze in uw toepassing voor gebruik.
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 informatie over sleutels en voorbeeldcode voor de Kafka-protocolindeling gebruiken om verbinding te maken met de eventstream en de gebeurtenissen te gebruiken.
De pagina Voorbeeldcode op het tabblad Kafka biedt kant-en-klare code, inclusief de benodigde verbindingssleutels in kafka-indeling. Kopieer deze gewoon voor uw gebruik.
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.
De pagina Voorbeeldcode op het tabblad AMQP biedt kant-en-klare code met informatie over de verbindingssleutel in AMQP-indeling.
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 verwijzen naar of de voorbeeldcode kopiëren op de pagina Voorbeeldcode , waarin wordt getoond hoe u gebeurtenissen verzendt of ontvangt met behulp van verschillende protocollen.
Gerelateerde inhoud
Zie de volgende artikelen voor meer informatie over het toevoegen van andere bestemmingen aan een eventstream:
Vereisten
Voordat u begint, moet u toegang krijgen tot de werkruimte van de eventstream in de licentiemodus voor infrastructuurcapaciteit (of) de modus Proeflicentie met inzender- of hogere machtigingen.
Notitie
Het maximum aantal bronnen en bestemmingen voor één eventstream is 11.
Een aangepaste app toevoegen als bestemming
Als u gebeurtenisgegevens naar uw toepassing wilt routeren, kunt u een aangepaste app toevoegen als uw eventstream-bestemming:
Selecteer Nieuwe bestemming op het lint of het plusteken (+) in het canvas van de hoofdeditor en selecteer vervolgens Aangepaste app.
Voer in het deelvenster Aangepaste app een doelnaam in voor de aangepaste app en selecteer vervolgens Toevoegen.
Eindpuntdetails ophalen in het deelvenster Details om gebeurtenissen te gebruiken
Nadat u de aangepaste toepassing als bestemming hebt gemaakt, kunt u de informatie bekijken 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.
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.
Event Hub
De pagina Sleutels 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 en de primaire sleutel van de verbindingsreeks.
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
De pagina Voorbeeldcode op het tabblad Event Hub bevat kant-en-klare code met de vereiste informatie over verbindingssleutels in de Event Hub . Kopieer en plak deze in uw toepassing voor gebruik.
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 informatie over sleutels en voorbeeldcode voor de Kafka-protocolindeling gebruiken om verbinding te maken met de eventstream en de gebeurtenissen te gebruiken.
De pagina Voorbeeldcode op het tabblad Kafka biedt kant-en-klare code, inclusief de benodigde verbindingssleutels in kafka-indeling. Kopieer deze gewoon voor uw gebruik.
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.
De pagina Voorbeeldcode op het tabblad AMQP biedt kant-en-klare code met informatie over de verbindingssleutel in AMQP-indeling.
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 verwijzen naar of de voorbeeldcode kopiëren op de pagina Voorbeeldcode , waarin wordt getoond hoe u gebeurtenissen verzendt of ontvangt met behulp van verschillende protocollen.
Een bestemming beheren
U kunt een eventstream-bestemming bewerken (via de opdracht Bewerken ) of verwijderen (via de opdracht Verwijderen ) via het deelvenster Gegevens of het canvas.
Wanneer u Bewerken selecteert, wordt het bewerkingsvenster aan de rechterkant van de hoofdeditor geopend. U kunt de configuratie naar wens wijzigen, inclusief de logica voor gebeurtenistransformatie via de editor van de gebeurtenisprocessor.
Gerelateerde inhoud
Zie de volgende artikelen voor meer informatie over het toevoegen van andere bestemmingen aan een eventstream: