Lägga till en anpassad slutpunkt eller anpassad appkälla i en händelseström

Artikel
11/19/2024

Om du vill ansluta ditt eget program till en händelseström kan du lägga till en anpassad slutpunkt eller en anpassad app som källa. Sedan kan du skicka realtidshändelser till händelseströmmen från ditt eget program med anslutningsslutpunkten som exponeras på den anpassade slutpunkten eller den anpassade appen. Med Apache Kafka-protokollet tillgängligt som ett alternativ för anpassade slutpunkter eller anpassade appar kan du också skicka realtidshändelser med hjälp av Apache Kafka-protokollet.

Den här artikeln visar hur du lägger till en anpassad slutpunktskälla eller en anpassad appkälla till en händelseström i Microsoft Fabric-händelseströmmar.

Kommentar

Förbättrade funktioner är aktiverade som standard när du skapar eventstreams nu. Om du har eventstreams som har skapats med standardfunktioner fortsätter dessa händelseströmmar att fungera. Du kan fortfarande redigera och använda dem som vanligt. Vi rekommenderar att du skapar en ny händelseström för att ersätta standardhändelseströmmar så att du kan dra nytta av ytterligare funktioner och fördelar med förbättrade eventstreams.

Förutsättningar

Åtkomst till en arbetsyta i infrastrukturkapacitetslicensläget (eller) utvärderingslicensläget med deltagare eller högre behörigheter.
Om du inte har en händelseström skapar du en händelseström.

Lägga till anpassade slutpunktsdata som källa

Om du vill lägga till en anpassad slutpunktskälla går du till sidan Komma igång och väljer Använd anpassad slutpunkt. Om du redan har en publicerad händelseström och vill lägga till anpassade slutpunktsdata som källa växlar du till redigeringsläge. I menyfliksområdet väljer du Lägg till anpassad källslutpunkt>.
I dialogrutan Anpassad slutpunkt anger du ett namn för den anpassade källan under Källnamn och väljer sedan Lägg till.
När du har skapat den anpassade slutpunktskällan läggs den till i din eventstream på arbetsytan i redigeringsläge. Om du vill implementera nyligen tillagda data från den anpassade appkällan väljer du Publicera.

Kommentar

Det maximala antalet källor och mål för en händelseström är 11.

Hämta slutpunktsinformation i informationsfönstret

När du har skapat en anpassad slutpunktskälla är dess data tillgängliga för visualisering i livevyn.

Skärmbild som visar händelseströmmen i livevyn.

Fönstret Information har tre protokollflikar: Event Hub, AMQP och Kafka. Varje protokollflik har tre sidor: Grundläggande och SAS-nyckelautentisering. Dessa sidor erbjuder slutpunktsinformation med motsvarande protokoll för anslutning.

Basic visar namn, typ och status för din anpassade slutpunkt.

Sidan SAS-nyckelautentisering innehåller information om anslutningsnycklar och även en länk till exempelkoden, med motsvarande nycklar inbäddade, som du kan använda för att strömma händelserna till din händelseström. Informationen på sidan Nycklar varierar beroende på protokoll.

Händelsehubb

Sidan SAS-nyckelautentisering på fliken Händelsehubb innehåller information om en händelsehubbs anslutningssträng. Informationen omfattar Händelsehubbnamn, Namn på delad åtkomstnyckel, Primärnyckel, Sekundär nyckel, Anslutningssträng primärnyckel, Anslutningssträng-sekundär nyckel.

Skärmbild som visar viktig information i fönstret Information i händelseströmmen.

Formatet för händelsehubben är standard för anslutningssträng och fungerar med Azure Event Hubs SDK. Med det här formatet kan du ansluta till din händelseström via Event Hubs-protokollet.

I följande exempel visas hur anslutningssträng ser ut i händelsehubbformat:

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

Om du väljer knappen Visa exempelkod visas java-koden som innehåller nödvändig information om anslutningsnycklar i händelsehubben. Kopiera och klistra in den i programmet för användning.

Skärmbild som visar exempelkod i fönstret Information i livevyn eventstream.

Advanced Message Queuing Protocol (AMQP)

AMQP-formatet är kompatibelt med AMQP 1.0-protokollet, som är ett standardmeddelandeprotokoll som stöder samverkan mellan olika plattformar och språk. Du kan använda det här formatet för att ansluta till din händelseström med hjälp av AMQP-protokollet.

Skärmbild som visar AMQP-nycklar i fönstret Information i livevyn eventstream.

När du väljer Visa exempelkod-knappen visas den färdiga Java-koden med anslutningsinformation i AMQP-format.

Skärmbild som visar AMQP-exempelkod i fönstret Information i livevyn eventstream.

Kafka

Kafka-formatet är kompatibelt med Apache Kafka-protokollet, som är en populär distribuerad strömningsplattform som stöder databearbetning med högt dataflöde och låg latens. Du kan använda SAS-nyckelautentiseringsinformationen för Kafka-protokollformatet för att ansluta till din händelseström och strömma händelserna.

Skärmbild som visar Kafka-nycklar i fönstret Information i livevyn eventstream.

När du väljer knappen Visa exempelkod visas java-koden som är redo att användas, inklusive nödvändiga anslutningsnycklar i Kafka-format. Kopiera den för din användning.

Skärmbild som visar Kafka-exempelkod i fönstret Information i livevyn eventstream.

Kommentar

Du kan välja det protokollformat som passar dina programbehov och inställningar och sedan kopiera och klistra in anslutningssträng i programmet. Du kan också referera till eller kopiera exempelkoden, som visar hur du skickar eller tar emot händelser med hjälp av olika protokoll.

Om du vill avsluta exempelkodvyn väljer du Dölj exempelkod.

En lista över källor som stöds finns i Lägga till en händelsekälla i en händelseström

Förutsättningar

Innan du börjar måste du få åtkomst till en arbetsyta med deltagare eller högre behörigheter där din eventstream finns.

Kommentar

Det maximala antalet källor och mål för en händelseström är 11.

Lägga till en anpassad app som källa

Om du vill ansluta ditt eget program till en händelseström kan du lägga till en anpassad appkälla. Skicka sedan data till händelseströmmen från ditt eget program med anslutningsslutpunkten som exponeras i den anpassade appen.

Så här lägger du till en anpassad appkälla:

Välj Ny källa i menyfliksområdet eller plustecknet (+) på huvudredigerarens arbetsyta och välj sedan Anpassad app.
I fönstret Anpassad app anger du ett källnamn för den anpassade appen och väljer sedan Lägg till.

Hämta slutpunktsinformation i fönstret Information för att skicka händelser

När du har skapat det anpassade programmet som källa kan du visa informationen i fönstret Information .

Fönstret Information har tre protokollflikar: Event Hub, AMQP och Kafka. Varje protokollflik har tre sidor: Grundläggande, Nycklar och Exempelkod. Dessa sidor erbjuder slutpunktsinformation med motsvarande protokoll för anslutning.

Basic visar namn, typ och status för din anpassade app.

Skärmbild som visar grundläggande information för en anpassad app i fönstret Information i en händelseström.

Nycklar innehåller information om anslutningsnycklar. Exempelkoden innehåller exempelkoden, med motsvarande nycklar inbäddade, som du kan använda för att strömma händelserna till din händelseström. Informationen på dessa sidor varierar beroende på protokoll.