Jaa


Azure-tapahtumatoimintolähteen lisääminen tapahtumavirtaan

Tässä artikkelissa kerrotaan, miten voit lisätä Azure Event Hubs -lähteen tapahtumavirtaan.

Edellytykset

Ennen kuin aloitat, sinun on täytettävä seuraavat edellytykset:

  • Työtilan käyttöoikeus Fabric-kapasiteetin käyttöoikeustilassa (tai) kokeiluversion käyttöoikeustilassa Osallistuja-oikeudella tai korkeammilla käyttöoikeuksilla.
  • Tarvitset asianmukaisen käyttöoikeuden, jotta voit saada tapahtumatoiminnon käyttöoikeusavaimet. Jos tapahtumatoimintosi on suojatussa verkossa, muodostaa siihen yhteyden hallitulla yksityisellä päätepisteellä. Muussa tapauksessa varmista, että tapahtumatoiminto on julkisesti käytettävissä palomuurin sijaan.
  • Jos sinulla ei ole tapahtumastreamia, luo tapahtumavirta.

Käynnistä ohjattu Tietolähteen valitseminen -toiminto

Jos et ole vielä lisännyt lähdettä tapahtumavirtaan, valitse Käytä ulkoista lähderuutua .

Näyttökuvassa näkyy Käytä ulkoista lähderuutua -valinta.

Jos lisäät lähteen jo julkaistuun tapahtumavirtaan, vaihda Muokkaa-tilaan , valitse valintanauhasta Lisää lähde ja valitse sitten Ulkoiset lähteet.

Näyttökuvassa näkyy Lisää lähde ulkoisiin lähteisiin -valikko.

Etsi ja valitse Valitse tietolähde -sivulla Yhdistä Azure-tapahtumatoiminnot-ruudussa.

Näyttökuvassa näkyy azure-tapahtumatoimintojen valinta lähdetyypiksi ohjatussa Hae tapahtumat -toiminnossa.

Määritä Azure Event Hubs -liitin

  1. Varmista Yhdistä-sivulla, että ominaisuustasoksi on valittu Perus, ja valitse sitten Uusi yhteys.

    Näyttökuvassa näkyy Yhdistä-sivu ja Uusi yhteys -linkki korostettuna.

    Jos Azure-tapahtumatoimintoon on aiemmin luotu yhteys, valitse olemassa oleva yhteys seuraavassa kuvassa esitetyllä tavalla ja siirry sitten vaiheeseen Tietojen muodon määrittäminen seuraavissa vaiheissa.

    Näyttökuvassa näkyy Yhdistä sivu aiemmin luodulla yhteydellä Azure-tapahtumatoimintoon.

  2. Tee Yhteysasetukset-osiossa seuraavat vaiheet:

    1. Anna Tapahtumatoiminnot-nimitilan nimi.

    2. Anna tapahtumatoiminnon nimi.

      Näyttökuvassa näkyvät yhteysasetukset, kun Event Hubs -nimitila ja tapahtumakeskus on määritetty.

  3. Tee Yhteyden tunnistetiedot -osiossa seuraavat vaiheet:

    1. Anna Yhteyden nimi -kenttään tapahtumatoimintoyhteyden nimi.

    2. Vahvista todennuslajiksi, että jaettu käyttöoikeusavain on valittuna.

    3. Kirjoita Jaetun käyttöavaimen nimi -kohtaan jaetun käyttöavaimen nimi. Katso ohjeet pääsyavaimen hankkimiseen kohdasta Hae yhteysmerkkijono.

    4. Anna Jaettu käyttöoikeus -avaimelle jaetun käyttöavaimen arvo.

    5. Valitse yhdistä sivun alareunasta.

      Näyttökuvassa näkyy Azure Event Hubs -liittimen yhdistämissivu 1.

  4. Kirjoita nyt ohjatun toiminnon Yhdistä-sivulla Kuluttajaryhmä-kohtaan kuluttajaryhmän nimi. Oletusarvoisesti $Default se on valittuna. Se on tapahtumakeskuksen oletusarvoinen kuluttajaryhmä.

  5. Valitse Tietojen muoto -kohdassa tietomuoto saapuville reaaliaikaisille tapahtumille, jotka haluat saada Azure-tapahtumakeskuksesta. Voit valita tietomuodoista JSON, Avro ja CSV (jossa otsikko).

    Näyttökuva, jossa näkyy kuluttajaryhmä ja tietomuoto Streamin tiedot -osiossa.

  6. Valitse oikealla olevassa Streamin tiedot -ruudussa Kynäkuvake lähteen nimen vierestä ja anna lähteelle nimi. Tämä vaihe on valinnainen.

    Näyttökuvassa näkyy lähteen nimi Streamin tiedot -osassa.

  7. Valitse seuraava sivun alareunasta.

    Näyttökuvassa näkyy Azure Event Hubs -liittimen yhdistämissivu 2.

  8. Tarkista + yhdistä -sivulla asetukset ja valitse Lisää.

    Näyttökuvassa näkyy Azure Event Hubs -liittimen tarkistus- ja luontisivu.

  1. Valitse Yhdistä-sivunOminaisuustaso-kohdassaLaajennetut ominaisuudet (esikatselu).

    Näyttökuva, jossa näkyy Määritä yhteysasetukset -sivu, jossa on valittuna Laajennetut ominaisuudet -vaihtoehto.

    Jos Azure-tapahtumatoimintoon on aiemmin luotu yhteys, valitse olemassa oleva yhteys seuraavassa kuvassa esitetyllä tavalla ja siirry sitten vaiheeseen Tietojen muodon määrittäminen seuraavissa vaiheissa.

  2. Tee Yhteysasetukset-osiossa seuraavat vaiheet:

    1. Anna Tapahtumatoiminnot-nimitilan nimi.

    2. Anna tapahtumatoiminnon nimi.

      Näyttökuvassa näkyvät yhteysasetukset, kun Event Hubs -nimitila ja tapahtumakeskus on määritetty.

  3. Tee Yhteyden tunnistetiedot -osiossa seuraavat vaiheet:

    1. Anna Yhteyden nimi -kenttään tapahtumatoimintoyhteyden nimi.

    2. Vahvista todennuslajiksi, että jaettu käyttöoikeusavain on valittuna.

    3. Kirjoita Jaetun käyttöavaimen nimi -kohtaan jaetun käyttöavaimen nimi. Katso ohjeet pääsyavaimen hankkimiseen kohdasta Hae yhteysmerkkijono.

    4. Anna Jaettu käyttöoikeus -avaimelle jaetun käyttöavaimen arvo.

    5. Valitse yhdistä sivun alareunasta.

      Näyttökuvassa näkyy Azure Event Hubs -liittimen yhdistämissivu 1.

  4. Kirjoita nyt ohjatun toiminnon Yhdistä-sivulla Kuluttajaryhmä-kohtaan kuluttajaryhmän nimi. Oletusarvoisesti $Default se on valittuna. Se on tapahtumakeskuksen oletusarvoinen kuluttajaryhmä.

    Näyttökuva, jossa näkyy kuluttajaryhmä Streamin tiedot -osiossa.

  5. (Valinnainen) Jos haluat mukauttaa lähteen nimeä, valitse kynäkuvake lähteen nimen vieressä oikealla olevassa Streamin tiedot -ruudussa ja anna lähteelle nimi. Valitse sitten sivun alareunasta Seuraava .

    Näyttökuva, jossa näkyy lähteen nimi Striimin tiedot -osiossa, kun Laajennetut ominaisuudet -vaihtoehto on valittuna.

  6. Rakenteen käsittely -sivulla sinun on annettava säännöt valitusta tapahtumakeskuksesta vastaanotettujen tapahtumien käsittelemiseksi, jotta Eventstream voi käyttää niitä oikein. Yhdistämissäännöt määräytyvät sen mukaan, miten tapahtumat mallinnetaan.

    Jos sinulla on yksi rakenne, joka hallitsee kaikkia tapahtumia, valitset kiinteän rakenteen.

    Vaihtoehtoisesti, jos sinulla on useita rakenteita, jotka edustavat eri saapuvia tapahtumia, voit määrittää vastaavuussääntöjä mallien käyttämiseksi. Jos haluat valita tämän tilan, valitse Dynaaminen rakenne otsikon kautta -vaihtoehto ja määritä sitten säännöt otsikko- ja arvoparien avulla kunkin rakenteen valitsemiseksi. Otsikko on mukautettu Kafka-otsikkoominaisuus, joka on osa tapahtuman metatietoja. Arvo on kyseisen ominaisuuden odotusarvo.

    Näyttökuva, jossa näkyy Rakenteen käsittely -sivu, jossa on valittuna Laajennetut ominaisuudet -vaihtoehto.

  7. Molemmissa tiloissa voit valita rakenteet napsauttamalla avattavaa Lisää rakenteita -valikkoa ja valitsemalla yhden tai useamman aiemmin luodun rakenteen tapahtumarakenteen rekisteristä. Jos sinulla ei ole rakenteita, joista valita, voit luoda uusia rakenteita tästä näkymästä. Lisätietoja uuden tapahtumarakenteen määrittämisestä on artikkelissa Tapahtumarakenteiden luominen ja hallinta rakennejoukoissa.

    Näyttökuva, jossa näkyy valittu kiinteä rakennevaihtoehto.

    Jos valitset Valitse tapahtumarakenteen rekisteristä -vaihtoehdon, näet Liitä tapahtumarakenne -sivun. Valitse rekisteristä yksi tai useampi rakenne rakenteen vastaavuustilan mukaan ja valitse sitten sivun alareunasta Valitse.

    Näyttökuva, jossa näkyy Liitä tapahtumarakenne -sivu.

  8. Jos valitsit Kiinteä rakenne -vaihtoehdon, sinun ei tarvitse antaa enempää sääntöjä, jotka vastaavat rakennetta. Voit jatkaa seuraavaan vaiheeseen. Jos valitsit Dynaaminen rakenne otsikoiden kautta -vaihtoehdon, määritä Kafka-otsikkoominaisuus ja odotettu arvo , joka yhdistetään rakenteeseen. Lisää rakenteita ja määritä erilaisia otsikon ominaisuuksia ja/tai eri arvoja, jotka yhdistetään näihin rakenteisiin.

    Muistiinpano

    Kun määrität yhdistämissäännöt, otsikon jokaisen arvon TÄYTYY olla yksilöllinen. Jos yrität käyttää rakennetta uudelleen, näkyviin tulee varoitussanoma, joka ilmoittaa, että saatat katkaista aiemmin luodut viestivirrat. Niin kauan kuin yhdistämissäännöt ovat samat, voit käyttää rakennetta uudelleen. Jos tämä rajoitus vaikuttaa käyttöösi, ota yhteyttä Microsoftin edustajaan ja anna palautetta. Pyrimme aktiivisesti poistamaan tämän rajoituksen.

    Näyttökuva, jossa näkyy rakenneeseen yhdistetty ominaisuus ja arvo.

  9. Kun kaikkien odotettujen tapahtumien rakenteet on yhdistetty, valitse Rakenteen käsittely -sivun alareunasta Seuraava.

    Näyttökuva, jossa näkyy Rakenteen käsittely -sivu.

  10. Tarkista Tarkista ja yhdistä -sivulta asetukset ja valitse Yhdistä.

    Näyttökuva, jossa näkyy Azure Event Hubs -liittimen Tarkista ja luo -sivu, kun laajennetut ominaisuudet ovat käytössä.

  11. Valitse Tarkista + yhdistä -sivulla Lisää nyt.

    Näyttökuva, jossa näkyy Tarkista ja luo -sivu, kun resurssit on luotu onnistuneesti.

Muistiinpano

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

  • Lähde: Mukautettu päätepiste.
  • Kohteet: Mukautettu päätepiste ja Eventhouse, jossa on suora käsittely.

Sellaisia lähteitä tai kohteita, jotka eivät ole mukana yllä olevassa luettelossa ja joita ei ole liitetty oletusvirtaan, ei lasketa mukaan tähän rajaan.

Näytä päivitetty tapahtumavirta

  1. Näet, että Tapahtumatoiminnot-lähde lisätään tapahtumavirtaan pohjalle Muokkaa-tilassa. Valitse alaruudusta Päivitä , jolloin näet tapahtumakeskuksen tietojen esikatselun. Jos haluat ottaa käyttöön tämän äskettäin lisätyn Azure-tapahtumatoiminnon, valitse valintanauhasta Julkaise .

    Näyttökuva, jossa editori on valittuna Julkaise-painike.

  2. Kun olet suorittanut nämä vaiheet, Azure-tapahtumakeskus on visualisoitavissa live-näkymässä. Valitse kaavion Tapahtumakeskus-ruutu , jotta näet seuraavanlaisen sivun.

    Näyttökuva, jossa editori näkyy reaaliaikaisessa näkymässä.

Näytä päivitetty tapahtumavirta

  1. Näet, että Tapahtumatoiminnot-lähde lisätään tapahtumavirtaan pohjalle Muokkaa-tilassa. Valitse alaruudusta Päivitä , jolloin näet tapahtumakeskuksen tietojen esikatselun. Jos haluat ottaa käyttöön tämän äskettäin lisätyn Azure-tapahtumatoiminnon, valitse valintanauhasta Julkaise .

    Näyttökuva, jossa editori on valittuna Julkaise-painike.

  2. Kun olet suorittanut nämä vaiheet, Azure-tapahtumakeskus on visualisoitavissa live-näkymässä. Valitse kaavion Tapahtumakeskus-ruutu , jotta näet seuraavanlaisen sivun.

    Näyttökuva, jossa editori näkyy reaaliaikaisessa näkymässä.

Tapahtumavirran kohteiden määrittäminen käyttämään rakenteita

Tällä hetkellä vain Eventhouse-, mukautettua päätepistettä ja johdettuja stream-kohteita tuetaan tapahtumavirroissa, joissa laajennetut ominaisuudet (kuten rakennetuki) ovat käytössä. Tässä osiossa kerrotaan, miten voit lisätä ja määrittää Eventhouse-kohteen, kun laajennetut ominaisuudet (kuten rakennetuki) ovat käytössä tapahtumavirrassa.

Mukautetun päätepisteen kohteen rakenteen määrittäminen

  1. Valitse Muunna tapahtumat tai Lisää kohde ja valitse sitten Mukautettu päätepiste.

  2. Määritä Mukautettu päätepiste -ruudussa kohteen nimi tavalliseen tapaan.

  3. Valitse Syöterakenne-kohdassa tapahtumien rakenne. Tämä kenttä on ylimääräinen kenttä, jonka täytät, kun otat käyttöön tapahtumavirran rakenteen tuen.

    Näyttökuva, jossa näkyy Mukautetun päätepisteen määrityssivu.

    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. Määritä Eventhouse-sivulla seuraavat rakenteeseen liittyvät asetukset:
    1. Valitse Syöterakenne-kohdassa yksi tai useampi rakenne avattavasta luettelosta.

      Näyttökuva, jossa näkyy Eventhousen määrityssivu, jossa on valittuna syöterakenne.

      Muistiinpano

      Jos valitsit Dynaaminen rakenne otsikoiden kautta -vaihtoehdon määrittäessäsi tapahtumatoimintojen lähdettä, olet ehkä määrittänyt lähteelle useita rakenteita ja yhdistänyt ne eri ominaisuuksiin ja niiden arvoihin.

    2. Valitse Taulukon luontimenetelmä -kohdassa jokin vaihtoehdoista tarpeidesi mukaan: Yksittäinen taulukko, jossa kaikki rakenteet on yhdistetty, tai Erilliset taulukot kullekin rakenteelle.

      Näyttökuva, jossa näkyy Eventhousen määrityssivu, jossa on taulukon luontimenetelmät.

    3. Valitse Kirjoita tiedot -kohdassa jokin seuraavista vaihtoehdoista:

      • Vain hyötykuorma: Poimittujen hyötykuormatietojen kirjoittaminen taulukkoon. Jos syöterakenteita on useita, tiedot lähetetään useisiin taulukoihin.

      • Metatiedot ja hyötykuorma: Kirjoita metatiedot ja tietosisältötiedot yhteen taulukkoon. Esimerkkisarakkeet: source , subject, type, data, jne.

        Näyttökuva, jossa näkyy Eventhousen määrityssivu, jossa on kirjoitustietojen asetukset.

      Lisätietoja Eventhouse-kohteen määrittämisestä on kohdassa Eventhouse-kohteen lisääminen tapahtumavirtaan.

Luettelo tuetuista lähteistä on artikkelissa Tapahtumalähteen lisääminen tapahtumavirtaan.