Delen via


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 realtime-gebeurtenissen van de eventstream verwerken in uw eigen toepassing, waarbij het verbindingseindpunt beschikbaar wordt gesteld 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.

Vereiste voorwaarden

Voordat u begint, moet u ervoor zorgen dat u toegang hebt tot de werkruimte waar uw eventstream zich bevindt. De werkruimte moet zich in Fabriccapaciteit of Trial modus bevinden.

  • Inzender - of hogere machtigingen zijn vereist om de eventstream te bewerken om een aangepast eindpuntdoel toe te voegen.
  • Als u Entra ID-verificatie wilt gebruiken om verbinding te maken met uw toepassing, hebt u lid- of hogere machtigingen nodig.

Als u Entra ID-verificatie gebruikt, moet u er ook voor zorgen dat de beheerde identiteit van het aangepaste eindpunt over de vereiste machtigingen beschikt. Hiervoor configureert u de benodigde instellingen in de beheerportal:

  1. Selecteer Instellingen (tandwielpictogram) in de rechterbovenhoek.

  2. Selecteer de beheerportal in de sectie Governance en inzichten .

    Schermopname van de selectie van de beheerportalkoppeling in de sectie Governance en inzichten.

  3. Activeer de volgende tenantinstelling om de service-principal toegang te verlenen tot Fabric-API's voor het maken van werkruimten, verbindingen of implementatiepijplijnen:

    • Vouw op de pagina Tenantinstellingen in de sectie Instellingen voor ontwikkelaars de optie Service principal kan gebruikmaken van de Fabric-API.
    • Schakel naar Ingeschakeld.
    • Toepassen op de hele organisatie.
    • Selecteer de optie Toepassen.

    Schermopname van de instellingen voor ontwikkelaars.

  4. Schakel deze optie in voor toegang tot alle andere API's (standaard ingeschakeld voor nieuwe tenants):

    • Vouw op de pagina Tenantinstellingen de optie Sta serviceprincipals toe om profielen te maken en te gebruiken uit.
    • Schakel naar Ingeschakeld.
    • Toepassen op de hele organisatie.
    • Selecteer de optie Toepassen.

Notitie

Een eventstream kan maximaal 11 gecombineerde bronnen en bestemmingen ondersteunen wanneer u de volgende typen gebruikt:

  • Bron: Aangepast eindpunt.
  • Bestemmingen: Aangepast eindpunt en Eventhouse met directe opname.

Bronnen of bestemmingen die niet zijn opgenomen in de bovenstaande lijst en bestemmingen die niet aan de standaardstroom zijn toegevoegd, tellen niet mee voor deze limiet.

Een aangepast eindpunt toevoegen als bestemming

Als u gebeurtenisgegevens naar uw app wilt routeren, kunt u een aangepast eindpunt toevoegen als uw eventstream-bestemming:

  1. Als u zich in de liveweergave bevindt, schakelt u over naar de bewerkingsmodus door Bewerken op het lint te selecteren.

    Schermopname van de knop Bewerken waarmee u kunt overschakelen naar de bewerkingsmodus.

  2. 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.

      Schermopname van de selectie van een aangepast eindpunt als bestemming op het lint.

    • Selecteer in de editor transformatiegebeurtenissen of voeg een bestemming toe en selecteer vervolgens Aangepast eindpunt.

      Schermopname van de selectie van een aangepast eindpunt in de editor.

  3. Voer voor de doelnaam een naam in voor het aangepaste eindpunt. Selecteer vervolgens Opslaan.

    Schermopname van het deelvenster voor het invoeren van een naam voor een aangepast eindpunt.

  4. Koppel de standaardstreamtegel aan de tegel van het aangepaste eindpunt als er geen bestaande verbinding is.

    Schermopname van de verbinding met een aangepaste eindpunttegel.

  5. Als u de gedetailleerde informatie van uw aangepaste eindpunt wilt bekijken, selecteert u Publiceren.

    Schermopname van de knop Publiceren.

Eindpuntdetails ophalen in het deelvenster Details om gebeurtenissen te verwerken

Selecteer in de liveweergave de tegel van het aangepaste eindpunt. Het deelvenster Details dat wordt weergegeven, bevat drie protocoltabbladen: Event Hub, AMQP en Kafka.

Schermopname van het deelvenster Details voor een aangepast eindpunt.

Elk protocoltabblad bevat drie pagina's: Basisverificatie, SAS-sleutelverificatie en Entra-id-verificatie. Deze pagina's bieden eindpuntinformatie die specifiek is voor het geselecteerde protocol.

  • Op de pagina Basis ziet u de naam, het type en de status van uw aangepaste eindpunt.

    Schermopname van basisdetails voor een aangepast eindpunt in de liveweergave van eventstream.

  • SAS-sleutelverificatie en Entra ID-verificatie zijn twee ondersteunde verificatiemethoden voor het maken van verbinding met uw toepassing:

    • SAS-sleutelverificatie biedt de informatie die nodig is voor het produceren en gebruiken van Eventstream-gegevens met behulp van SAS-sleutels (Shared Access Signature).
    • Met Entra ID-verificatie kan een beveiligingsprincipaal (zoals een gebruiker of service-principal) Eventstream-gegevens gebruiken met behulp van Microsoft Entra ID-verificatie.

Zie Entra ID-verificatie inschakelen voor een toepassing in Eventstream voor stappen voor het gebruik van Entra ID-verificatie.
In de volgende sectie wordt beschreven hoe u verbinding maakt met een aangepast eindpuntdoel met behulp van SAS-sleutelverificatie.

Gebeurtenishub

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.

Schermopname van Event Hub-sleutels in het deelvenster Details van de liveweergave van 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

Selecteer de knop Voorbeeldcode weergeven op de pagina Event Hub om kant-en-klare code te krijgen die de vereiste informatie over verbindingssleutels in de Event Hub bevat. Kopieer en plak deze in uw toepassing voor gebruik.

Schermopname van voorbeeldcode van Event Hub 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 informatie voor sleutels en voorbeeldcode voor de Kafka-protocolindeling gebruiken om verbinding te maken met de eventstream en de gebeurtenissen te consumeren.

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

Selecteer de knop Voorbeeldcode weergeven op de Kafka-pagina om kant-en-klare code op te halen, inclusief de benodigde verbindingssleutels in kafka-indeling. Kopieer deze gewoon voor uw gebruik.

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

Raadpleeg voor een duidelijke handleiding over het gebruik van het aangepaste eindpunt met het Kafka-protocol deze handleiding. Het biedt gedetailleerde stappen voor het streamen en gebruiken van gebeurtenissen met behulp van het aangepaste eindpunt met het Kafka-protocol.

AMQP (Advanced Message Queuing Protocol)

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.

Selecteer de knop Voorbeeldcode weergeven op de AMQP-pagina om kant-en-klare code met verbindingssleutelgegevens in AMQP-indeling op te halen.

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

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.

Zie de volgende artikelen voor meer informatie over het toevoegen van andere bestemmingen aan een eventstream:

Vereiste voorwaarden

Voordat u begint, moet u toegang krijgen tot de werkruimte van de eventstream in de Fabric capaciteit licentiemodus of de Proeflicentie modus met bijdrager- of hogere machtigingen.

Notitie

Een eventstream kan maximaal 11 gecombineerde bronnen en bestemmingen ondersteunen wanneer u de volgende typen gebruikt:

  • Bron: Aangepast eindpunt.
  • Bestemmingen: Aangepast eindpunt en Eventhouse met directe opname.

Bronnen of bestemmingen die niet zijn opgenomen in de bovenstaande lijst en bestemmingen die niet aan de standaardstroom zijn toegevoegd, tellen niet mee voor deze limiet.

Een aangepaste app toevoegen als bestemming

Als u gebeurtenisgegevens naar uw toepassing wilt routeren, kunt u een aangepaste app toevoegen als uw eventstream-bestemming:

  1. Selecteer Nieuwe bestemming op het lint of het plusteken (+) in het canvas van de hoofdeditor en selecteer vervolgens Aangepaste app.

  2. Voer in het deelvenster Aangepaste app een doelnaam in voor de aangepaste app en selecteer vervolgens Toevoegen.

    Schermopname van het deelvenster voor het configureren van een aangepaste app als bestemming.

Eindpuntdetails ophalen in het deelvenster Details om gebeurtenissen te verwerken

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

Schermopname van het deelvenster Details voor een aangepaste app-bestemming.

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 basisdetails 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.

Gebeurtenishub

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.

Schermopname van Event Hub-sleutels 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

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.

Schermopname van voorbeeldcode van Event Hub in het deelvenster Details van de 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 informatie voor sleutels en voorbeeldcode voor de Kafka-protocolindeling gebruiken om verbinding te maken met de eventstream en de gebeurtenissen te consumeren.

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

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.

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

AMQP (Advanced Message Queuing Protocol)

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 eventstream.

De pagina Voorbeeldcode op het tabblad AMQP biedt kant-en-klare code met informatie over de verbindingssleutel in AMQP-indeling.

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

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.

Schermopname die laat zien waar u de opties voor wijzigen en verwijderen voor bestemmingen op het canvas kunt selecteren.

Zie de volgende artikelen voor meer informatie over het toevoegen van andere bestemmingen aan een eventstream: