Del via

Legge til egendefinert endepunktkilde i en hendelsesstrøm

  • Artikkel

Hvis du vil koble ditt eget program til en hendelsesstrøm, kan du legge til en egendefinert endepunktkilde (dvs. Egendefinert app i standardfunksjonalitet). Deretter kan du sende hendelser i sanntid til hendelsesstrømmen fra ditt eget program med tilkoblingsendepunktet eksponert på det egendefinerte endepunktet (det vil si egendefinert app i standardfunksjonalitet). Med Apache Kafka-protokollen tilgjengelig som et alternativ for egendefinerte endepunkter (det vil si Egendefinert app i standardfunksjonalitet), kan du sende hendelser i sanntid ved hjelp av Apache Kafka-protokollen. Denne artikkelen viser deg hvordan du legger til en egendefinert endepunktkilde (det vil si Egendefinert app i standardfunksjonalitet) i en hendelsesstrøm.

Merk

Hvis du vil bruke forbedrede funksjoner som er i forhåndsvisning, velger du Forbedrede funksjoner øverst. Ellers velger du Standardfunksjoner. Hvis du vil ha informasjon om forbedrede funksjoner som er i forhåndsversjon, kan du se Innføring i fabric-hendelsesstrømmer.

Forutsetning

  • Tilgang til Fabric Premium-arbeidsområdet med bidragsyter eller høyere tillatelser.

Viktig

Forbedrede funksjoner for Fabric-hendelsesstrømmer er for øyeblikket i forhåndsversjon.

Merk

Maksimalt antall kilder og mål for én hendelsesstrøm er 11.

Legge til egendefinerte endepunktdata som en kilde

Følg disse trinnene for å legge til en egendefinert endepunktkilde:

  1. Hvis du vil opprette en ny hendelsesstrøm, velger du Eventstream fra startskjermen. Kontroller at alternativet Forbedrede funksjoner (forhåndsvisning) er aktivert.

    Et skjermbilde av oppretting av en ny hendelsesstrøm.

  2. Hvis du vil legge til egendefinert endepunktkilde, velger du Bruk egendefinert endepunkt på startsiden.

    Et skjermbilde av å velge Bruk egendefinert endepunkt.

    Hvis du allerede har en publisert hendelsesstrøm og vil legge til egendefinerte endepunktdata som kilde, kan du bytte til redigeringsmodus . Velg deretter Legg til kilde på båndet, og velg Egendefinert endepunkt.

    Et skjermbilde av å velge Egendefinert endepunkt som skal legges til i en eksisterende hendelsesstrøm.

  3. Skriv inn et navn for den egendefinerte kilden under Kildenavn på skjermbildet Egendefinert endepunkt, og velg deretter Legg til.

    Et skjermbilde som viser skjermbildet Egendefinert endepunkt med Legg til-knappen uthevet.

  4. Når du har opprettet den egendefinerte endepunktkilden, ser du den lagt til i hendelsesstrømmen på lerretet i redigeringsmodus. Hvis du vil implementere disse nylig tilføyde egendefinerte kildedataene for apper, velger du Publiser.

    Et skjermbilde som viser eventstream i redigeringsmodus, med Publiser-knappen uthevet.

Når du har fullført disse trinnene, er de egendefinerte endepunktdataene tilgjengelige for visualisering i live-visning.

Et skjermbilde som viser hendelsesstrømmen i live-visning.

Få endepunktdetaljer i detaljruten for å sende hendelser

Detaljruten har tre protokollfaner: Event Hub, AMQP og Kafka. Hver protokollfane har tre sider: Grunnleggende, nøkler og eksempelkode som gir endepunktdetaljer med tilsvarende protokoll for tilkobling.

Grunnleggende viser navnet, beskrivelsen, typen og statusen til det egendefinerte endepunktet.

[Et skjermbilde som viser grunnleggende informasjon i Detalj-ruten i eventstream Live-visningen

Taster og eksempelkodesider gir deg informasjon om tilkoblingsnøkler og eksempelkoden med de tilsvarende tastene som er innebygd, som du kan bruke til å strømme hendelsene til hendelsesstrømmen. Kodeinformasjonen For nøkler og eksempel varierer etter protokoll.

Hendelseshub

Nøklene i hendelseshubprotokollformatet inneholder informasjon relatert til en hendelseshub tilkoblingsstreng, inkludert navnet på hendelseshuben, navn på delt tilgangsnøkkel, primærnøkkel og primærnøkkel for tilkoblingsstreng. Hendelseshubformatet er standard for tilkoblingsstreng og fungerer med Azure Event Hubs SDK. Med dette formatet kan du koble til eventstream via Event Hubs-protokollen. Følgende eksempel viser hvordan tilkoblingsstreng ser ut i hendelseshubformat:

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

[Et skjermbilde som viser Nøkler-informasjonen i Detalj-ruten i den direktesendte visningen for hendelsesbanen]

Eksempelkodesiden i Hendelseshuber-fanen tilbyr kode som er klar til bruk, med den nødvendige informasjonen om tilkoblingsnøkler i Event Hub inkludert. Bare kopier og lim den inn i programmet for bruk.

[Et skjermbilde som viser eksempelkoden i Detalj-ruten i den direktesendte visningen for hendelsesbanen]

Kafka

Kafka-formatet er kompatibelt med Apache Kafka-protokollen, som er en populær distribuert strømmeplattform som støtter databehandling med høy gjennomstrømming og lav ventetid. Du kan bruke tastene og eksempelkoden i Kafka-protokollformat til å koble til hendelsesstrømmen og strømme hendelsene.

[Et skjermbilde som viser kafka-tastene i Detalj-ruten i live-visningen for hendelsesbanen]

På samme måte gir eksempelkodesiden i Kafka-fanen deg ferdigkode, inkludert de nødvendige tilkoblingsnøklene i Kafka-format. Bare kopier den for din bruk.

[Et skjermbilde som viser kafkaeksempelkoden i Detalj-ruten i eventstream Live-visningen]

AMQP

AMQP-formatet er kompatibelt med AMQP 1.0-protokollen, som er en standard meldingsprotokoll som støtter interoperabilitet mellom ulike plattformer og språk. Du kan bruke dette formatet til å koble til hendelsesstrømmen ved hjelp av AMQP-protokollen.

[Et skjermbilde som viser amqp-tastene i Detalj-ruten i hendelsesstrømsvisning]

Eksempelkodesiden i AMQP-fanen gir deg også klar til bruk-koden med informasjon om tilkoblingsnøkler i AMQP-format.

[Et skjermbilde som viser amqp-eksempelkoden i Detalj-ruten i den direktesendte visningen av hendelsesbanen]

Du kan velge protokollformatet som passer dine programbehov og innstillinger, og kopiere og lime inn tilkoblingsstreng i programmet. Du kan også referere til eller kopiere eksempelkoden vi oppgir i eksempelkodefanen, som viser hvordan du sender eller mottar hendelser ved hjelp av forskjellige protokoller.

Relatert innhold

Hvis du vil lære hvordan du legger til andre kilder i en hendelsesstrøm, kan du se følgende artikler:

Forutsetning

Før du begynner, må du fullføre følgende forutsetninger:

  • Få tilgang til et premium arbeidsområde med bidragsyter - eller høyere tillatelser der hendelsesstrømmen er plassert.

Merk

Maksimalt antall kilder og mål for én hendelsesstrøm er 11.

Legge til en egendefinert app som kilde

Hvis du vil koble ditt eget program til en hendelsesstrøm, kan du legge til en egendefinert appkilde. Deretter sender du data til eventstreamen med ditt eget program med tilkoblingsendepunktet eksponert i den egendefinerte appen. Følg disse trinnene for å legge til en egendefinert appkilde:

  1. Velg Ny kilde på båndet eller «+» i hovedredigeringslerretet og deretter Egendefinert app.

  2. Skriv inn et kildenavn for den egendefinerte appen, og velg Legg til.

    Skjermbilde som viser konfigurasjonen for den egendefinerte appkilden.

  3. Når du har opprettet den egendefinerte programkilden, kan du bytte og vise følgende informasjon i Detaljer-fanen i den nedre ruten:

    Skjermbilde som viser den egendefinerte appkilden.

Få endepunktdetaljer i detaljruten for å sende hendelser

Detaljruten har tre protokollfaner: Event Hub, AMQP og Kafka. Hver protokollfane har tre sider: Grunnleggende, nøkler og eksempelkode som gir endepunktdetaljer med tilsvarende protokoll for tilkobling.

Grunnleggende viser navnet, beskrivelsen, typen og statusen til den egendefinerte appen.

[Et skjermbilde som viser customapp Basic-informasjonen i Detalj-ruten i hendelsesstrømmen.]

Taster og eksempelkodesider gir deg informasjon om tilkoblingsnøkler og eksempelkoden med de tilsvarende tastene som er innebygd, som du kan bruke til å strømme hendelsene til hendelsesstrømmen. Kodeinformasjonen For nøkler og eksempel varierer etter protokoll.

Hendelseshub

Nøklene i hendelseshubprotokollformatet inneholder informasjon relatert til en hendelseshub tilkoblingsstreng, inkludert navnet på hendelseshuben, navn på delt tilgangsnøkkel, primærnøkkel og primærnøkkel for tilkoblingsstreng. Hendelseshubformatet er standard for tilkoblingsstreng og fungerer med Azure Event Hubs SDK. Med dette formatet kan du koble til eventstream via Event Hubs-protokollen. Følgende eksempel viser hvordan tilkoblingsstreng ser ut i hendelseshubformat:

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

[Et skjermbilde som viser Nøkler-informasjonen i Detalj-ruten i hendelsesstrømmen.]

Eksempelkodesiden i Hendelseshuber-fanen tilbyr kode som er klar til bruk, med den nødvendige informasjonen om tilkoblingsnøkler i Event Hub inkludert. Bare kopier og lim den inn i programmet for bruk.

[Et skjermbilde som viser eksempelkoden i Detalj-ruten i hendelsesstrømmen.]

Kafka

Kafka-formatet er kompatibelt med Apache Kafka-protokollen, som er en populær distribuert strømmeplattform som støtter databehandling med høy gjennomstrømming og lav ventetid. Du kan bruke tastene og eksempelkoden i Kafka-protokollformat til å koble til hendelsesstrømmen og strømme hendelsene.

[Et skjermbilde som viser kafkatastene i Detaljer-ruten i eventstreamen.]

På samme måte gir eksempelkodesiden i Kafka-fanen deg ferdigkode, inkludert de nødvendige tilkoblingsnøklene i Kafka-format. Bare kopier den for din bruk.

[Et skjermbilde som viser kafka-eksempelkoden i Detalj-ruten i hendelsesstrømmen.]

AMQP

AMQP-formatet er kompatibelt med AMQP 1.0-protokollen, som er en standard meldingsprotokoll som støtter interoperabilitet mellom ulike plattformer og språk. Du kan bruke dette formatet til å koble til hendelsesstrømmen ved hjelp av AMQP-protokollen.

[Et skjermbilde som viser amqp-tastene i Detalj-ruten i hendelsesstrømmen.]

Eksempelkodesiden i AMQP-fanen gir deg også klar til bruk-koden med informasjon om tilkoblingsnøkler i AMQP-format.

[Et skjermbilde som viser amqp-eksempelkoden i Detalj-ruten i hendelsesstrømmen.]

Du kan velge protokollformatet som passer dine programbehov og innstillinger, og kopiere og lime inn tilkoblingsstreng i programmet. Du kan også referere til eller kopiere eksempelkoden vi oppgir i eksempelkodefanen, som viser hvordan du sender eller mottar hendelser ved hjelp av forskjellige protokoller.

Relatert innhold

Hvis du vil lære hvordan du legger til andre kilder i en hendelsesstrøm, kan du se følgende artikler: