Del via

Føj et brugerdefineret slutpunkt eller en brugerdefineret appkilde 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 kilde. Derefter kan du sende hændelser i realtid til eventstream fra dit eget program med forbindelsesslutpunktet vist 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å sende hændelser i realtid ved hjælp af Apache Kafka-protokollen.

I denne artikel kan du se, hvordan du føjer en brugerdefineret slutpunktskilde eller en brugerdefineret appkilde 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 slutpunktskilde .
  • 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 brugerdefinerede slutpunktsdata som en kilde

  1. Hvis du vil tilføje en brugerdefineret slutpunktskilde, skal du vælge Brug brugerdefineret slutpunkt på siden Introduktion. Eller hvis du allerede har en publiceret hændelsesstream, og du vil tilføje brugerdefinerede slutpunktsdata som en kilde, skal du skifte til redigeringstilstand. Vælg Tilføj brugerdefineret kildeslutpunkt> på båndet.

    Skærmbillede af muligheden for at bruge et brugerdefineret slutpunkt.

  2. I dialogboksen Brugerdefineret slutpunkt skal du angive et navn til den brugerdefinerede kilde under Kildenavn og derefter vælge Tilføj.

    Skærmbillede af dialogboksen til tilføjelse af et brugerdefineret slutpunkt.

  3. Når du har oprettet den brugerdefinerede slutpunktskilde, føjes den til din eventstream på lærredet i redigeringstilstand. Hvis du vil implementere de nyligt tilføjede data fra den brugerdefinerede appkilde, skal du vælge Publicer.

    Skærmbillede, der viser hændelsesstrømmen i redigeringstilstand, hvor knappen Publicer er fremhævet.

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.

Hent oplysninger om slutpunkter i ruden Detaljer

Når du har oprettet en brugerdefineret slutpunktskilde, er dens data tilgængelige til visualisering i livevisningen.

Skærmbillede, der viser eventstreamen i livevisningen.

Ruden Detaljer har tre protokolfaner: Event Hub, AMQP og Kafka. Hver protokolfane har tre sider: Basis- og SAS-nøglegodkendelse. Disse sider indeholder slutpunktsoplysninger med den tilsvarende protokol til oprettelse af forbindelse.

Basic viser navn, type og status for dit brugerdefinerede slutpunkt.

Skærmbillede, der viser grundlæggende oplysninger i ruden Detaljer i livevisningen for eventstream.

Siden SAS-nøglegodkendelse indeholder oplysninger om forbindelsesnøgler og også et link til eksempelkoden med de tilsvarende nøgler integreret, som du kan bruge til at streame hændelserne til din eventstream. Oplysningerne på siden Nøgler varierer efter protokol.

Hændelseshub

Siden SAS-nøglegodkendelse 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, Sekundær nøgle, Forbindelsesstrengens primære nøgle, Forbindelsesstrengens sekundære nøgle.

Skærmbillede, der viser vigtige oplysninger 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

Hvis du vælger knappen Vis eksempelkode , kan du se den klar til brug Java-kode , der indeholder de påkrævede oplysninger om forbindelsesnøgler i hændelseshubben. Kopiér og indsæt den i dit program til brug.

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

AMQP (Advanced Message Queuing Protocol)

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.

Når du vælger Knappen Vis eksempelkode , kan du se den færdige Java-kode med oplysninger om forbindelsesnøgle i AMQP-format.

Skærmbillede, der viser AMQP-eksempelkode i ruden Detaljer i livevisningen af 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 SAS-nøglegodkendelsesoplysningerne til Kafka-protokolformatet til at oprette forbindelse til din eventstream og streame hændelserne.

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

Når du vælger knappen Vis eksempelkode , får du vist java-koden, der er klar til brug, herunder de nødvendige forbindelsesnøgler i Kafka-format. Kopiér den til 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.

Bemærk

  • 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, som viser, hvordan du sender eller modtager hændelser ved hjælp af forskellige protokoller.
  • Hvis du vil afslutte eksempelkodevisningen, skal du vælge Skjul eksempelkode.

Relateret indhold

Du kan se en liste over understøttede kilder under Tilføj en hændelseskilde i en hændelsesstream

Forudsætninger

  • Adgang til et arbejdsområde i Fabric-kapacitetslicenstilstand (eller) prøvelicenstilstand med bidragydertilladelser eller højere tilladelser.
  • Hvis du ikke har en eventstream, skal du oprette en eventstream.

Tilføj en brugerdefineret app som en kilde

Hvis du vil forbinde dit eget program med en eventstream, kan du tilføje en brugerdefineret appkilde. Send derefter data til eventstream fra dit eget program med forbindelsesslutpunktet, der vises i den brugerdefinerede app.

Sådan tilføjer du en brugerdefineret appkilde:

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

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

    Skærmbillede, der viser ruden til konfiguration af en brugerdefineret app som en kilde.

Hent oplysninger om slutpunkt i ruden Detaljer for at sende hændelser

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

Ruden Detaljer har tre protokolfaner: Event Hub, AMQP og Kafka. Hver protokolfane indeholder tre sider: Basic, SAS Key Authentication og Entra ID Authentication. Disse sider indeholder slutpunktsoplysninger, der er specifikke for den valgte protokol. Skærmbillede, der viser en brugerdefineret appkilde.

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

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

  • 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 vigtige oplysninger 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

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 eksempelkode 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 din eventstream og streame hændelserne.

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

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

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

Relateret indhold

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