Mukautetun päätepisteen tai mukautetun sovelluslähteen lisääminen tapahtumavirtaan

Jos haluat yhdistää oman sovelluksesi tapahtumavirtaan, voit lisätä lähteeksi mukautetun päätepisteen tai mukautetun sovelluksen. Tämän jälkeen voit lähettää reaaliaikaisia tapahtumia tapahtumavirtaan omasta sovelluksestasi niin, että yhteyden päätepiste näkyy mukautetussa päätepisteessä tai mukautetussa sovelluksessa. Lisäksi Apache Kafka -protokolla on käytettävissä mukautettujen päätepisteiden tai mukautettujen sovellusten vaihtoehtona, joten voit lähettää reaaliaikaisia tapahtumia Apache Kafka -protokollan avulla.

Tässä artikkelissa näytetään, miten voit lisätä mukautetun päätepisteen lähdekoodin tai mukautetun sovelluslähteen tapahtumavirtaan Microsoft Fabricissa.

Edellytykset

  • Pääsy työtilaan, jossa tapahtumavirtasi sijaitsee. Työtilan täytyy olla Fabric-kapasiteetissa tai kokeilutilassa.

  • Osallistujan tai korkeammat oikeudet muokata eventstreamia ja lisätä mukautettu päätepiste lähteeksi.

Microsoft Entra -todennuksen oikeudet

Jos haluat käyttää Microsoft Entra -tunnistautumista sovelluksen yhdistämiseen, tarvitset jäsen- tai korkeammat käyttöoikeudet.

Sinun täytyy myös varmistaa, että mukautetun päätepisteen hallittu identiteetti sisältää tarvittavat käyttöoikeudet. Määritä asetukset hallintoportaalissa:

  1. Oikeasta yläkulmasta valitse Asetukset (hammaspyöräkuvake).

  2. Valitse Governance and Insights -osiosta Admin-portaali.

    Kuvakaappaus, joka näyttää Admin-portaalin linkin osiossa hallinnon ja asetusten näkemyksistä.

  3. Ota seuraava tenant-asetus käyttöön palvelupäämiehen pääsyn Fabric-rajapintoihin työtilojen, yhteyksien tai käyttöönottoputkien luomiseksi:

    1. Tenant settings -sivulla, Kehittäjäasetukset-osiossa, laajenna Service Principals can Use Fabric APIs -vaihtoehto.
    2. Määritä asetukseksi Käytössä.
    3. Hakemiseksi valitse koko organisaatio.
    4. Valitse Käytä.

    Kuvakaappaus, joka näyttää kehittäjän asetukset.

  4. Ota tämä asetus käyttöön, jotta voit käyttää kaikkia muita ohjelmointirajapintoja (oletusarvoisesti käytössä uusille vuokraajille):

    1. Laajenna Vuokraaja-asetukset-sivullaSalli palvelun päänimien luoda ja käyttää profiileja -vaihtoehto.
    2. Määritä asetukseksi Käytössä.
    3. Hakemiseksi valitse koko organisaatio.
    4. Valitse Käytä.

Mukautettujen päätepisteiden tietojen lisääminen lähteeksi

  1. Jos haluat lisätä mukautetun päätepistelähteen, valitse aloitussivulta Käytä mukautettua päätepistettä. Tai jos sinulla on jo julkaistu tapahtumavirta ja haluat lisätä mukautettuja päätepistetietoja lähteeksi, siirry muokkaustilaan. Valitse valintanauhasta Lisää lähteen>mukautettu päätepiste.

    Kuvakaappaus, joka näyttää mahdollisuuden käyttää mukautettua päätelaitetta.

  2. Kirjoita Mukautettu päätepiste -valintaikkunaan mukautetun lähteen nimi kohdassa Lähteen nimi ja valitse sitten Lisää.

    Kuvakaappaus, joka näyttää valintaikkunan mukautetun päätepisteen lisäämiseksi.

  3. Kun olet luonut mukautetun päätepisteen lähteen, se lisätään tapahtumavirtaan pohjalle muokkaustilassa. Toteuttaaksesi juuri lisätyn datan mukautetusta päätepisteen lähteestä, valitse Julkaise.

    Näyttökuva, joka näyttää tapahtumavirran muokkaustilassa Julkaise-painike korostettuna.

Muistiinpano

Eventstream voi tukea enintään 11 yhdistettyä lähdettä ja kohdetta, vain kun käytät seuraavia tyyppejä:

  • Lähde: Mukautettu päätepiste.
  • Kohteet: Räätälöity päätepiste ja tapahtumapaikka, jossa on suora vastaanotto.

Kaikki lähteet tai kohteet, joita ei ole edellisessä listassa, eikä päätepisteet, joita ei ole liitetty oletusvirtaan, eivät sisälly tähän rajaan.

Mukautettujen päätepisteiden tietojen lisääminen lähteeksi

  1. Jos haluat lisätä mukautetun päätepistelähteen, valitse aloitussivulta Käytä mukautettua päätepistettä. Tai jos sinulla on jo julkaistu tapahtumavirta ja haluat lisätä mukautettuja päätepistetietoja lähteeksi, siirry muokkaustilaan. Valitse valintanauhasta Lisää lähteen>mukautettu päätepiste.

    Kuvakaappaus, joka näyttää mahdollisuuden käyttää mukautettua päätelaitetta.

  2. Valitse Lisää lähde -sivulla AktivoiRakenneliitos -asetukseksi ja valitse sitten Lisää.

    Kuvakaappaus, jossa näkyy mukautettu päätepistelähde, jossa on mahdollisuus liittää skeemoja.

  3. Jos haluat liittää editorissa uuteen rakenteeseen tai aiemmin luotuun rakenteeseen rakennerekisteristä, valitse valintanauhasta Liitä tapahtumarakenne .

    Kuvakaappaus, jossa näkyy eventstream-editori, jossa on painike tapahtumaskeeman liittämiseen, valittuna nauhalle.

  4. Käyttääksesi olemassa olevaa skeemaa, valitse Valitse tapahtumaskeemarekisteristä ja seuraa sitten seuraavia vaiheita:

    1. Associate an event schema -dialogissa valitse skeema skeemarekisteristä. Tapahtumadataskeema näkyy oikeassa ruudussa.

    2. Valitse Valitse, jos haluat liittää tapahtumarakenteen mukautettuun päätepisteeseen.

      Kuvakaappaus, joka näyttää tapahtumaskeeman liittämisen skeeman yhdistämisen skeemarekisteristä valittuun skeemaan.

    3. Eventstream-editorissa valitse eventstream-ruutu . Alapaneelissa vaihda Associated skeeman välilehteen. Varmista, että skeema liittyy tapahtumavirtaan.

      Kuvakaappaus, jossa eventstream-editori on valittu tapahtumavirta ja siihen liittyvän skeeman välilehti korostettuna.

  5. Käytä jotakin seuraavista vaihtoehdoista skeeman luomiseen:

    • Jos sinulla on rakenteen JSON-tiedosto, lataa tiedosto valitsemalla Lataa . Esimerkkitiedoston löydät kohdasta Lataa tapahtumaskeema.

      Näyttökuva, jossa näkyy latausvaihtoehto rakenteen luomiseksi.

    • Aloita rakenteen luominen manuaalisesti valitsemalla Lisää rivi. Jokaiselle riville valitse kenttätyyppi, kentän nimi ja tarvittaessa syötä kuvaus.

      Näyttökuva, joka näyttää manuaalisen tavan rakentaa skeema.

    • Rakentaaksesi skeeman syöttämällä JSON-koodia, valitse Code editor -vaihtoehto. Jos valitset käyttää koodieditoria luodaksesi skeeman ja huomaa, ettet voi palata käyttöliittymän rakentajaan , ilmestyy, valitse Muokkaa.

      Näyttökuva, jossa koodieditori näyttää rakenteen luomisen.

      Syötä JSON-koodi editoriin.

      Kuvakaappaus, jossa JSON-koodi näkyy koodieditorissa skeeman rakentamiseen.

Muistiinpano

Eventstream voi tukea enintään 11 yhdistettyä lähdettä ja kohdetta, vain kun käytät seuraavia tyyppejä:

  • Lähde: Mukautettu päätepiste.
  • Kohteet: Räätälöity päätepiste ja tapahtumapaikka, jossa on suora vastaanotto.

Kaikki lähteet tai kohteet, joita ei ole edellisessä listassa, eikä päätepisteet, joita ei ole liitetty oletusvirtaan, eivät sisälly tähän rajaan.

Saat räätälöidyt päätepisteiden yhteystiedot ja esimerkkikoodi

Kun olet luonut oman päätepistelähteen tapahtumavirtaan, sen data on käytettävissä visualisointia varten live-näkymässä. Käytä Yksityiskohdat-paneelia hakeaksesi yhteysmerkkijonoja, SAS-avaimia ja käyttövalmiin esimerkkikoodin Event Hubsille, AMQP:lle tai Apache Kafka -protokollalle.

Näyttökuva, joka näyttää tapahtumavirran reaaliaikaisessa näkymässä.

Tiedot-ruudussa on kolme protokollavälilehteä: Event Hub, AMQP ja Kafka. Jokaisella protokollavälilehdellä on kaksi sivua, jotka tarjoavat päätepisteen tiedot ja vastaavan protokollan yhdistämistä varten:

  • Basic näyttää mukautetun päätepisteen nimen, tyypin ja tilan.

    Näyttökuvassa on perustietoja tapahtumavirran live-näkymän Tiedot-ruudussa.

  • SAS Key Authentication tarjoaa tietoa yhteysavaimista. Se tarjoaa myös linkin esimerkkikoodiin, johon on upotettu vastaavat avaimet, joita voit käyttää tapahtumien striimaamiseen tapahtumavirtaan. Tämän sivun tiedot vaihtelevat protokollan mukaan.

Event Hubs -protokollayhteystiedot

Event Hub -protokollan SAS Key Authentication -välilehti sisältää tietoa, joka liittyy tapahtumahubin yhteysmerkkijonoon. Tietoihin kuuluvat tapahtumakeskuksen nimi, jaetun pääsyn avaimen nimi, ensisijainen avain, toissijainen avain, yhteysmerkkijonon ensisijainen avain ja yhteysmerkkijonon toissijainen avain.

Näyttökuvassa näkyvät tärkeimmät tiedot tapahtumavirran Tiedot-ruudussa.

Tapahtumatoiminnon muoto on yhteysmerkkijonon oletusmuoto, ja se toimii Azure Event Hubs SDK:n kanssa. Tämän muodon avulla voit muodostaa yhteyden tapahtumavirtaan Event Hubs -protokollan kautta.

Seuraavassa esimerkissä näytetään yhteysmerkkijono tapahtumatoimintomuodossa:

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

Jos valitset Näytä esimerkkikoodipainikkeen , näet valmiin Java-koodin, joka sisältää vaaditut tiedot yhteysavaimista tapahtumakeskuksessa. Kopioi ja liitä se sovellukseesi käyttöä varten.

Kuvakaappaus, joka näyttää näytteen, jolla näytekoodi näytetään tapahtumastreamin live-näkymän Yksityiskohdassa.

AMQP-protokollan yhteystiedot

Advanced Message Queuing Protocol (AMQP) -formaatti on yhteensopiva AMQP 1.0:n kanssa, joka on standardiviestiprotokolla ja tukee yhteensopivuutta eri alustojen ja kielten välillä. Tämän muodon avulla voit muodostaa yhteyden tapahtumavirtaan AMQP-protokollan avulla.

Näyttökuvassa näkyvät AMQP-avaimet tapahtumavirran live-näkymän Tiedot-ruudussa.

Kun valitset Näytä näytekoodipainikkeen , näet valmiin Java-koodin yhteysavaimen tietoineen AMQP-muodossa.

Kuvakaappaus, jossa näkyy AMQP-näytekoodin näyttämispainike tapahtumastriimin live-näkymän Yksityiskohdassa.

Apache Kafka -protokollan yhteystiedot

Kafka-muoto on yhteensopiva Apache Kafka -protokollan kanssa. Se on suosittu hajautettu virtautusalusta, joka tukee suuren siirtomäärän ja pienen viivettä tietojenkäsittelyä. Voit käyttää SAS Key Authentication -tietoja Kafka-protokollan muodossa muodostaaksesi yhteyden tapahtumavirtaasi ja suoratoistaaksesi tapahtumat.

Näyttökuvassa näkyvät Kafka-avaimet tapahtumavirran live-näkymän Tiedot-ruudussa.

Kun valitset Näytä mallikoodi -painikkeen, näet käyttövalmiin Java-koodin, mukaan lukien tarvittavat yhteysavaimet Kafka-muodossa. Kopioi se käyttöäsi varten.

Kuvakaappaus, joka näyttää Kafka-näytekoodin painikkeen tapahtumalähetyksen live-näkymän Yksityiskohdassa.

Lisätietoja mukautetun päätepisteen käytöstä Kafka-protokollan kanssa löytyy kohdasta Stream and consume events with the Kafka endpoint.

Muistiinpano

  • Voit valita sovelluksesi tarpeisiin ja asetuksiin sopivan protokollamuodon ja kopioida ja liittää yhteysmerkkijonon sovellukseesi. Voit myös viitata tai kopioida esimerkkikoodin, joka näyttää, miten tapahtumia lähetetään tai vastaanotetaan eri protokollien avulla.
  • Sulkeaksesi esimerkkikoodinäkymän, valitse Piilota näytekoodi.

Määritä Eventstreamin kohdekohdat käyttämään skeemoja

Tällä hetkellä vain Eventhouse, mukautettu päätepiste ja johdetut virtakohteet ovat tuettuina Eventstreameille, joihin liittyy skeemoja. Tässä osiossa kerrotaan, miten voit lisätä ja määrittää Eventhouse-kohteen, kun laajennetut ominaisuudet (kuten rakennetuki) ovat käytössä tapahtumavirrassa.

Muistiinpano

Kun käytät DeltaFlow'ta (Preview) tuetulla Change Data Capture (CDC) -lähteellä, Eventhousen kohdetaulut luodaan ja hallitaan automaattisesti vastaamaan lähdetaulun rakennetta. Kohdetauluskeemaa ei tarvitse konfiguroida manuaalisesti. DeltaFlow käsittelee myös skeeman kehityksen automaattisesti, kun lähdetaulut muuttuvat.

Määritä skeema mukautetulle päätepisteelle

  1. Valitse Muunna tapahtumat tai lisää kohde, ja valitse sitten CustomEndpoint.

  2. Mukautettu päätepiste -paneelissa määritä kohde nimeksi.

  3. Valitse Syöterakenne-kohdassa tapahtumien rakenne. Teet valinnan tässä laatikossa, kun otat skeematuen käyttöön tapahtumavirralle.

Kuvakaappaus, joka näyttää paneelin mukautetun päätepisteen konfigurointia varten.

Yksityiskohtaiset ohjeet mukautetun päätepisteen kohteen määrittämiseen ovat artikkelissa Mukautetun päätepisteen tai mukautetun sovelluksen kohteen lisääminen tapahtumavirtaan.

Tapahtumatalon kohteen rakenteiden määrittäminen

  1. Valitse Muunna tapahtumat tai Lisää kohde ja valitse sitten Eventhouse.

  2. Eventhouse-paneelissa määritä seuraavat skeema-asetukset:

    1. Syöteskeemalle valitse yksi tai useampi skeema pudotusvalikosta.

      Kuvakaappaus, joka näyttää tapahtumatalon konfiguraatiopaneelin, jossa syöteskeema on valittuna.

      Muistiinpano

      Jos valitsit Dynamic skeeman otsikoiden kautta -vaihtoehdon konfiguroidessasi Event Hubsin lähdekoodia, saatat olla konfiguroinut useita skeemoja lähteelle ja kartoittanut ne eri ominaisuuksiin ja arvoihin.

    2. Taulun luontitapaa varten valitse Yksi taulu, jossa kaikki skeemat on yhdistetty, tai Erilliset taulukot jokaiselle skeemalle tarpeidesi mukaan.

      Kuvakaappaus, joka näyttää tapahtumatalon konfiguraatiopaneelin taulun luontimenetelmineen.

    3. Valitse Kirjoita tiedot -kohdassa jokin seuraavista vaihtoehdoista:

      • Vain hyötykuorma: Kirjoita purettu hyötykuorma taulukkoon. Jos syöterakenteita on useita, tiedot lähetetään useisiin taulukoihin.
      • Metatiedot ja hyötykuorma: Kirjoita metatiedot ja tietosisältötiedot yhteen taulukkoon. Esimerkkisarakkeita ovat source , subject, type, ja data.

      Kuvakaappaus, joka näyttää tapahtumatalon konfiguraatiopaneelin, jossa on asetukset datan kirjoittamiseen.

Yksityiskohtaiset vaiheet tapahtumatalon kohteen konfigurointiin löydät kohdasta Lisää tapahtumatalon kohde tapahtumavirtaan.

Liittyvä sisältö

  • Last updated on