Lägga till en anpassad slutpunkt eller ett anpassat appmål i en händelseström

2025-06-26

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 mål. Sedan kan du ta emot realtidshändelser från händelseströmmen till ditt eget program via anslutningsslutpunkten som exponeras av 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å använda realtidshändelser med hjälp av Apache Kafka-protokollet.

Den här artikeln visar hur du lägger till ett anpassat slutpunktsmål eller ett anpassat appmål i en händelseström i Microsoft Fabric-händelseströmmar.

Anteckning

Förbättrade funktioner aktiveras som standard när du skapar eventstreams. Om du har eventstreams som du har skapat via 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

Innan du börjar kontrollerar du att du har åtkomst till arbetsytan där din eventstream finns. Arbetsytan måste vara i Fabric capacity eller Trial läge.

Bidragsgivare eller högre behörigheter krävs för att redigera evenemangsströmmen för att lägga till en anpassad slutpunkt som destination.
Om du vill använda Entra-ID-autentisering för att ansluta ditt program behöver du medlems - eller högre behörigheter.

Om du använder Entra-ID-autentisering måste du också se till att den hanterade identiteten för den anpassade slutpunkten har de behörigheter som krävs. Konfigurera nödvändiga inställningar i administratörsportalen:

Välj Inställningar (kugghjulsikon) i det övre högra hörnet.
Välj Administratörsportal under avsnittet Styrning och insikter .
Aktivera följande klientinställning för att ge tjänstehuvudmännens åtkomst till Fabric-API:er för att skapa arbetsytor, anslutningar eller distributionspipelines.
- På sidan Inställningar för klientorganisation går du till avsnittet Inställningar för utvecklare och expanderar alternativet tjänstehuvudnamn kan använda Fabric API.
- Växla till Aktiverad.
- Gäller för hela organisationen.
- Välj Använd.
Aktivera det här alternativet för att komma åt alla andra API:er (aktiverade som standard för nya klienter):
- På sidan Klientinställningar utökar du alternativet Tillåt tjänstehuvuden att skapa och använda profiler.
- Växla till Aktiverad.
- Gäller för hela organisationen.
- Välj Använd.

Anteckning

En händelseström kan endast stödja upp till 11 kombinerade källor och mål när du använder följande typer:

Källa: Anpassad slutpunkt.
Mål: Anpassad slutpunkt och Eventhouse med direkt inmatning.

Alla källor eller mål som inte ingår i listan ovan och mål som inte läggs till i standardströmmen räknas inte mot den här gränsen.

Lägga till en anpassad slutpunkt som mål

Om du vill dirigera händelsedata till din app kan du lägga till en anpassad slutpunkt som ditt eventstream-mål:

Om du är i livevyn växlar du till redigeringsläge genom att välja Redigera i menyfliksområdet.
I redigeringsläge lägger du till ett anpassat slutpunktsmål på något av följande sätt:
- Välj Lägg till mål i menyfliksområdet, välj Anpassad slutpunkt och anslut sedan slutpunkten till din standardström eller härledda ström.
- I redigeraren väljer du Transformera händelser eller lägg till mål och sedan Anpassad slutpunkt.
Som Målnamn anger du ett namn för den anpassade slutpunkten. Välj sedan Spara.

Om du använder scheman vid källan väljer du schemat för händelser för Indataschema. Det här fältet är det extra fält som du fyller i när du aktiverar schemastöd för en händelseström.
Anslut den förvalda strömrutan till den anpassade slutpunktsrutan om det inte finns någon befintlig anslutning.
Om du vill visa detaljerad information om din anpassade slutpunkt väljer du Publicera.

Hämta slutpunktsinformation i informationsfönstret för att hantera händelser

I Live-view väljer du den anpassade slutpunktsrutan. Fönstret Information som visas innehåller tre protokollflikar: Event Hub, AMQP och Kafka.

Varje protokollflik innehåller tre sidor: Basic, SAS Key Authentication och Entra ID Authentication. Dessa sidor innehåller slutpunktsinformation som är specifik för det valda protokollet.

Sidan Grundläggande visar namn, typ och status för din anpassade slutpunkt.
SAS-nyckelautentisering och Entra-ID-autentisering är två autentiseringsmetoder som stöds för att ansluta till ditt program:
- SAS-nyckelautentisering ger den information som behövs för att producera och använda Eventstream-data med hjälp av SAS-nycklar (Signatur för delad åtkomst).
- Entra ID-autentisering gör det möjligt för ett säkerhetsobjekt (till exempel en användare eller tjänstens huvudnamn) att använda Eventstream-data med Microsoft Entra ID-autentisering.

Anvisningar för hur du använder Entra ID-autentisering finns i Aktivera Entra-ID-autentisering för ett program i Eventstream.
I följande avsnitt beskrivs hur du ansluter till ett anpassat slutpunktsmål med hjälp av SAS-nyckelautentisering.

Händelsecentral

Sidan Nycklar på fliken Händelsehubb innehåller information om en händelsehubbs anslutningssträng. Informationen innehåller händelsehubbens namn, nyckelnamn för delad åtkomst, primärnyckel och primärnyckel för anslutningssträng.

Skärmbild som visar händelsehubbens nycklar i informationsfönstret i eventstream live-vyn.

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

Välj Knappen Visa exempelkod på sidan Händelsehubb för att få färdig kod som innehåller nödvändig information om anslutningsnycklar i händelsehubben. Kopiera och klistra in det i programmet för användning.

Skärmbild som visar exempelkod för händelsehubben 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 informationen om Nycklar och Exempelkod för Kafka-protokollformatet för att ansluta till händelseströmmen och förbruka händelserna.

Skärmbild som visar Kafka-nycklar i detaljpanelen i eventstream-livevyn.

Välj Knappen Visa exempelkod på Kafka-sidan för att hämta färdig kod, inklusive nödvändiga anslutningsnycklar i Kafka-format. Kopiera den bara för din användning.

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

En tydlig guide om hur du använder den anpassade slutpunkten med Kafka-protokollet finns i den här guiden. Den innehåller detaljerade steg för strömning och användning av händelser med hjälp av den anpassade slutpunkten med Kafka-protokollet.

AMQP (Advanced Message Queuing Protocol)

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 informationsfönstret i den levande vyn för eventström.

Välj Knappen Visa exempelkod på AMQP-sidan för att hämta ger färdig kod med information om anslutningsnyckeln i AMQP-format.

Skärmbild som visar AMQP-exempelkod i informationsfönstret i eventstream-livevy.

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 på sidan Exempelkod , som visar hur du skickar eller tar emot händelser med hjälp av olika protokoll.

Mer information om hur du lägger till andra mål i en händelseström finns i följande artiklar:

Förutsättningar

Innan du börjar måste du få åtkomst till eventstream-arbetsytan i Fabric-kapacitetslicensläget eller testlicensläget med bidragsgivare eller högre behörigheter.

Anteckning

En händelseström kan endast stödja upp till 11 kombinerade källor och mål när du använder följande typer:

Källa: Anpassad slutpunkt.
Mål: Anpassad slutpunkt och Eventhouse med direkt inmatning.

Alla källor eller mål som inte ingår i listan ovan och mål som inte läggs till i standardströmmen räknas inte mot den här gränsen.

Lägga till en anpassad app som mål

Om du vill dirigera händelsedata till ditt program kan du lägga till en anpassad app som ditt eventstream-mål:

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

Hämta slutpunktsinformation i informationsfönstret för att hantera händelser

När du har skapat det anpassade programmet som mål 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.