Del via

Føj et brugerdefineret slutpunkt eller en brugerdefineret appdestination til en hændelsesstream

Hvis du vil oprette forbindelse mellem dit eget program og en hændelsesstream, kan du tilføje et brugerdefineret slutpunkt eller en brugerdefineret app som en destination. Derefter kan du forbruge hændelser i realtid fra eventstream til dit eget program med forbindelsesslutpunktet, der vises på det brugerdefinerede slutpunkt eller den brugerdefinerede app. Når Apache Kafka-protokollen er tilgængelig som en mulighed for brugerdefinerede slutpunkter eller brugerdefinerede apps, kan du også forbruge hændelser i realtid ved hjælp af Apache Kafka-protokollen.

I denne artikel kan du se, hvordan du føjer en brugerdefineret slutpunktsdestination eller en brugerdefineret appdestination til en hændelsesstream i Microsoft Fabric-hændelsesstrømme.

Bemærk

Forbedrede funktioner aktiveres som standard, når du opretter eventstreams nu. Hvis du har hændelsesstreams, der er oprettet ved hjælp af standardfunktioner, fungerer disse hændelsesstreams fortsat. Du kan stadig redigere og bruge dem som normalt. Vi anbefaler, at du opretter en ny hændelsesstream for at erstatte standardhændelsesstreams, så du kan drage fordel af yderligere funktioner og fordele ved forbedrede hændelsesstreams.

Forudsætninger

Før du starter, skal du sørge for, at du har adgang til det arbejdsområde, hvor din eventstream er placeret. Arbejdsområdet skal være i Fabric-kapacitet eller prøveversionstilstand .

  • Der kræves bidragydertilladelser eller højere tilladelser for at redigere hændelsesstrømmen for at tilføje en brugerdefineret slutpunktsdestination .
  • Hvis du vil bruge Entra ID-godkendelse til at oprette forbindelse til dit program, skal du have medlemstilladelser eller nyere tilladelser.

Hvis du bruger entra-id-godkendelse, skal du også sikre dig, at det brugerdefinerede slutpunkts administrerede identitet har de nødvendige tilladelser. Det gør du ved at konfigurere de nødvendige indstillinger på administrationsportalen:

  1. Vælg Indstillinger (tandhjulsikon) i øverste højre hjørne.

  2. Vælg Administrationsportal under afsnittet Styring og indsigt .

    Skærmbillede, der viser linket til valg af administrationsportal i afsnittet Styring og indsigt.

  3. Aktivér følgende lejerindstilling for at give tjenesteprincipalen adgang til Fabric-API'er til oprettelse af arbejdsområder, forbindelser eller udrulningspipelines:

    • På siden Lejerindstillinger skal du i afsnittet Udviklerindstillinger udvide indstillingen Tjenesteprincipalen kan bruge Fabric API .
    • Skift til aktiveret.
    • Anvend på hele organisationen.
    • Vælg Anvend.

    Skærmbillede, der viser udviklerindstillingerne.

  4. Aktivér denne indstilling for at få adgang til alle andre API'er (aktiveret som standard for nye lejere):

    • Udvid indstillingen Tillad tjenesteprincipaler at oprette og bruge profiler på siden Lejerindstillinger.
    • Skift til aktiveret.
    • Anvend på hele organisationen.
    • Vælg Anvend.

Bemærk

En eventstream kan kun understøtte op til 11 kombinerede kilder og destinationer, når du bruger følgende typer:

  • Kilde: Brugerdefineret slutpunkt.
  • Destinationer: Brugerdefineret slutpunkt og Eventhouse med direkte indtagelse.

Alle kilder eller destinationer, der ikke er inkluderet på listen ovenfor, og destinationer, der ikke er føjet til standardstrømmen, tæller ikke med i denne grænse.

Tilføj et brugerdefineret slutpunkt som en destination

Hvis du vil distribuere hændelsesdata til din app, kan du tilføje et brugerdefineret slutpunkt som destination for eventstream:

  1. Hvis du er i livevisningen, kan du skifte til redigeringstilstand ved at vælge Rediger på båndet.

    Skærmbillede, der viser knappen Rediger, hvor du kan skifte til redigeringstilstand.

  2. I redigeringstilstand skal du tilføje en brugerdefineret slutpunktsdestination på en af følgende måder:

    • Vælg Tilføj destination på båndet, vælg Brugerdefineret slutpunkt, og opret derefter forbindelse mellem slutpunktet og din standardstream eller afledte stream.

      Skærmbillede, der viser valget af et brugerdefineret slutpunkt som en destination på båndet.

    • Vælg Transformér hændelser i editoren, eller tilføj destination, og vælg derefter Brugerdefineret slutpunkt.

      Skærmbillede, der viser valget af et brugerdefineret slutpunkt i editoren.

  3. Angiv et navn til det brugerdefinerede slutpunkt for Destinationsnavn. Vælg derefter Gem.

    Skærmbillede, der viser ruden til angivelse af et navn til et brugerdefineret slutpunkt.

  4. Opret forbindelse mellem standardstreamfeltet og det brugerdefinerede slutpunktfelt, hvis der ikke er nogen eksisterende forbindelse.

    Skærmbillede, der viser forbindelsen til et brugerdefineret slutpunktfelt.

  5. Hvis du vil have vist de detaljerede oplysninger om dit brugerdefinerede slutpunkt, skal du vælge Publicer.

    Skærmbillede, der viser knappen Publicer.

Hent slutpunktsoplysninger i ruden Detaljer for at forbruge hændelser

Vælg det brugerdefinerede slutpunktsfelt i livevisningen. Ruden Detaljer , der vises, indeholder tre protokolfaner: Event Hub, AMQP og Kafka.

Skærmbillede, der viser ruden Detaljer for et brugerdefineret slutpunkt.

Hver protokolfane indeholder tre sider: Basic, SAS Key Authentication og Entra ID Authentication. Disse sider indeholder slutpunktsoplysninger, der er specifikke for den valgte protokol.

  • På siden Basis kan du se navnet, typen og status for dit brugerdefinerede slutpunkt.

    Skærmbillede, der viser grundlæggende oplysninger om et brugerdefineret slutpunkt i livevisningen for eventstream.

  • SAS-nøglegodkendelse og entra-id-godkendelse er to understøttede godkendelsesmetoder til oprettelse af forbindelse til dit program:

    • SAS-nøglegodkendelse indeholder de oplysninger, der er nødvendige for at producere og forbruge Eventstream-data ved hjælp af SAS-nøgler (Shared Access Signature).
    • Godkendelse af entra-id gør det muligt for en sikkerhedskonto (f.eks. en bruger eller tjenesteprincipal) at forbruge Eventstream-data ved hjælp af Microsoft Entra ID-godkendelse.

Du kan finde trin til at bruge entra-id-godkendelse under Aktivér entra-id-godkendelse for et program i Eventstream.
I følgende afsnit beskrives det, hvordan du opretter forbindelse til en brugerdefineret slutpunktsdestination ved hjælp af SAS-nøglegodkendelse.

Hændelseshub

Siden Nøgler under fanen Event Hub indeholder oplysninger, der er relateret til en hændelseshubs forbindelsesstreng. Oplysningerne omfatter Navn på hændelseshub, Navn på delt adgangsnøgle, Primær nøgle og Forbindelsesstrengens primære nøgle.

Skærmbillede, der viser hændelseshubnøgler i ruden Detaljer i livevisningen for eventstream.

Hændelseshubformatet er standard for forbindelsesstreng, og det fungerer sammen med Azure Event Hubs SDK. Dette format giver dig mulighed for at oprette forbindelse til din eventstream via Event Hubs-protokollen.

I følgende eksempel kan du se, hvordan forbindelsesstreng ser ud i hændelseshubformat:

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

Vælg Knappen Vis eksempelkode på siden Event Hub for at blive klar til brug-kode, der indeholder de påkrævede oplysninger om forbindelsesnøgler i hændelseshubben. Du skal blot kopiere og indsætte det i dit program til brug.

Skærmbillede, der viser eksempelkoden for hændelseshubben i ruden Detaljer i livevisningen for eventstream.

Kafka

Kafka-formatet er kompatibelt med Apache Kafka-protokollen, som er en populær distribueret streamingplatform, der understøtter databehandling med høj gennemløb og lav ventetid. Du kan bruge kodeoplysningerne Nøgler og Eksempel til Kafka-protokolformatet til at oprette forbindelse til hændelsesstrømmen og forbruge hændelserne.

Skærmbillede, der viser Kafka-nøgler i ruden Detaljer i livevisningen for eventstream.

Vælg Knappen Vis eksempelkode på Kafka-siden for at få færdiglavet kode, herunder de nødvendige forbindelsesnøgler i Kafka-format. Du skal blot kopiere det til din brug.

Skærmbillede, der viser Kafka-eksempelkode i ruden Detaljer i livevisningen for eventstream.

Du kan finde en tydelig vejledning i brug af det brugerdefinerede slutpunkt med Kafka-protokollen i dette selvstudium. Den indeholder detaljerede trin til streaming og forbrug af hændelser ved hjælp af det brugerdefinerede slutpunkt med Kafka-protokollen.

AMQP

AMQP-formatet er kompatibelt med AMQP 1.0-protokollen, som er en standardmeddelelsesprotokol, der understøtter interoperabilitet mellem forskellige platforme og sprog. Du kan bruge dette format til at oprette forbindelse til din eventstream ved hjælp af AMQP-protokollen.

Skærmbillede, der viser AMQP-nøgler i ruden Detaljer i livevisningen for eventstream.

Vælg Knappen Vis eksempelkode på siden AMQP for at få klar til brug-kode med oplysninger om forbindelsesnøgle i AMQP-format.

Skærmbillede, der viser AMQP-eksempelkode i ruden Detaljer i livevisningen af eventstream.

Du kan vælge det protokolformat, der passer til dine programbehov og -indstillinger, og derefter kopiere og indsætte forbindelsesstreng i dit program. Du kan også referere til eller kopiere eksempelkoden på siden Eksempelkode , som viser, hvordan du sender eller modtager hændelser ved hjælp af forskellige protokoller.

Relateret indhold

Du kan få mere at vide om, hvordan du føjer andre destinationer til en eventstream, i følgende artikler:

Forudsætninger

Før du starter, skal du have adgang til eventstream-arbejdsområdet i Fabric-kapacitetslicenstilstanden (eller) prøvelicenstilstanden med bidragydertilladelser eller højere tilladelser.

Bemærk

En eventstream kan kun understøtte op til 11 kombinerede kilder og destinationer, når du bruger følgende typer:

  • Kilde: Brugerdefineret slutpunkt.
  • Destinationer: Brugerdefineret slutpunkt og Eventhouse med direkte indtagelse.

Alle kilder eller destinationer, der ikke er inkluderet på listen ovenfor, og destinationer, der ikke er føjet til standardstrømmen, tæller ikke med i denne grænse.

Tilføj en brugerdefineret app som destination

Hvis du vil distribuere hændelsesdata til dit program, kan du tilføje en brugerdefineret app som destination for eventstream:

  1. Vælg Ny destination på båndet eller plustegnet (+) på hovededitorens lærred, og vælg derefter Brugerdefineret app.

  2. Angiv et destinationsnavn for den brugerdefinerede app i ruden Brugerdefineret app , og vælg derefter Tilføj.

    Skærmbillede af ruden til konfiguration af en brugerdefineret app som destination.

Hent slutpunktsoplysninger i ruden Detaljer for at forbruge hændelser

Når du har oprettet det brugerdefinerede program som destination, kan du få vist oplysningerne i ruden Detaljer .

Skærmbillede, der viser ruden Detaljer for en brugerdefineret appdestination.

Ruden Detaljer har tre protokolfaner: Event Hub, AMQP og Kafka. Hver protokolfane har tre sider: Grundlæggende, nøgler og eksempelkode. Disse sider indeholder slutpunktsoplysninger med den tilsvarende protokol til oprettelse af forbindelse.

Basic viser navn, type og status for din brugerdefinerede app.

Skærmbillede, der viser grundlæggende oplysninger om en brugerdefineret app i ruden Detaljer i en hændelsesstream.

Nøgler indeholder oplysninger om forbindelsesnøgler. Eksempelkoden indeholder eksempelkoden med de tilsvarende nøgler integreret, som du kan bruge til at streame hændelserne til din eventstream. Oplysningerne på disse sider varierer efter protokol.

Hændelseshub

Siden Nøgler under fanen Event Hub indeholder oplysninger, der er relateret til en hændelseshubs forbindelsesstreng. Oplysningerne omfatter Navn på hændelseshub, Navn på delt adgangsnøgle, Primær nøgle og Forbindelsesstrengens primære nøgle.

Skærmbillede, der viser hændelseshubnøgler i ruden Detaljer i hændelsesstrømmen.

Hændelseshubformatet er standard for forbindelsesstreng, og det fungerer sammen med Azure Event Hubs SDK. Dette format giver dig mulighed for at oprette forbindelse til din eventstream via Event Hubs-protokollen.

I følgende eksempel kan du se, hvordan forbindelsesstreng ser ud i hændelseshubformat:

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

Kodesiden Eksempel på fanen Event Hub indeholder klar til brug-kode, der indeholder de påkrævede oplysninger om forbindelsesnøgler i hændelseshubben. Du skal blot kopiere og indsætte det i dit program til brug.

Skærmbillede, der viser eksempelkoden for hændelseshubben i ruden Detaljer i hændelsesstrømmen.

Kafka

Kafka-formatet er kompatibelt med Apache Kafka-protokollen, som er en populær distribueret streamingplatform, der understøtter databehandling med høj gennemløb og lav ventetid. Du kan bruge kodeoplysningerne Nøgler og Eksempel til Kafka-protokolformatet til at oprette forbindelse til hændelsesstrømmen og forbruge hændelserne.

Skærmbillede, der viser Kafka-nøgler i ruden Detaljer i hændelsesstrømmen.

Tegntabeleksemplet på fanen Kafka indeholder færdiglavet kode, herunder de nødvendige forbindelsesnøgler i Kafka-format. Du skal blot kopiere det til din brug.

Skærmbillede, der viser Kafka-eksempelkode i ruden Detaljer i hændelsesstrømmen.

AMQP

AMQP-formatet er kompatibelt med AMQP 1.0-protokollen, som er en standardmeddelelsesprotokol, der understøtter interoperabilitet mellem forskellige platforme og sprog. Du kan bruge dette format til at oprette forbindelse til din eventstream ved hjælp af AMQP-protokollen.

Skærmbillede, der viser AMQP-nøgler i ruden Detaljer i hændelsesstrømmen.

Tegntabeleksemplet under fanen AMQP indeholder klar til brug-kode med forbindelsesnøgleoplysninger i AMQP-format.

Skærmbillede, der viser AMQP-eksempelkode i ruden Detaljer i hændelsesstrømmen.

Du kan vælge det protokolformat, der passer til dine programbehov og -indstillinger, og derefter kopiere og indsætte forbindelsesstreng i dit program. Du kan også referere til eller kopiere eksempelkoden på siden Eksempelkode , som viser, hvordan du sender eller modtager hændelser ved hjælp af forskellige protokoller.

Administrer en destination

Du kan redigere (via kommandoen Rediger ) eller fjerne (via kommandoen Fjern ) en eventstream-destination via ruden Data eller lærredet.

Når du vælger Rediger, åbnes redigeringsruden i højre side af hovededitoren. Du kan ændre konfigurationen, som du vil, herunder hændelsestransformationslogikken via hændelsesbehandlereditoren.

Skærmbillede, der viser, hvor du kan vælge indstillingerne for ændring og sletning for destinationer på lærredet.

Relateret indhold

Du kan få mere at vide om, hvordan du føjer andre destinationer til en eventstream, i følgende artikler: