Megosztás a következőn keresztül:


Csatlakozás eseményközponthoz az Azure Logic Apps munkafolyamataiból

A következőkre vonatkozik: Azure Logic Apps (Használat)

Az Azure Event Hubs-összekötő segítségével a logikai alkalmazás munkafolyamatait az Azure-beli eseményközpontokhoz csatlakoztathatja. Ezután a munkafolyamatok figyelhetik és kezelhetik az eseményközpontba küldött eseményeket. A munkafolyamat például ellenőrizheti, elküldheti és fogadhat eseményeket az eseményközpontból. Ez a cikk az Azure Event Hubs-összekötő használatának első lépéseit ismerteti, amely bemutatja, hogyan csatlakozhat egy eseményközponthoz, és hogyan vehet fel eseményközpont-eseményközpont-eseményindítót vagy -műveletet a munkafolyamatba.

Az Azure Event Hubsról vagy az Azure Logic Appsről további információt az Azure Event Hubs vagy az Azure Logic Apps ismertetése tartalmaz.

Elérhető műveletek

Az összes művelet és egyéb technikai információ, például tulajdonságok, korlátok és egyéb információkért tekintse át az Event Hubs-összekötő referenciaoldalát.

Előfeltételek

Engedélyek ellenőrzése és kapcsolati sztring lekérése

Annak érdekében, hogy a munkafolyamat hozzáférhessen az eseményközponthoz, ellenőrizze az engedélyeket, majd kérje le az eseményközpont névterének kapcsolati sztring.

  1. Az Azure Portalon lépjen az Event Hubs-névtérre, ne egy adott eseményközpontra.

  2. A névtér menü Beállítások területén válassza a Megosztott hozzáférési szabályzatok lehetőséget. A Jogcímek oszlopban ellenőrizze, hogy rendelkezik-e legalább az adott névtérre vonatkozó engedélyek kezelésével.

    Képernyőkép az Azure Portalról, az Event Hubs-névtérről és a

  3. Ha később manuálisan szeretné megadni a kapcsolati adatokat, kérje le az eseményközpont névterének kapcsolati sztring.

    1. A Szabályzat oszlopban válassza a RootManageSharedAccessKey lehetőséget.

    2. Keresse meg az elsődleges kulcs kapcsolati sztring. Másolja és mentse a kapcsolati sztring későbbi használatra.

      Képernyőkép az elsődleges kulcs kapcsolati sztring a kijelölt másolási gombbal.

      Tipp.

      Annak ellenőrzéséhez, hogy a kapcsolati sztring az Event Hubs-névtérhez vagy egy adott eseményközponthoz van-e társítva, győződjön meg arról, hogy a kapcsolati sztring nem rendelkezik a EntityPath paraméterrel. Ha ezt a paramétert találja, a kapcsolati sztring egy adott Event Hubs -entitáshoz tartozik, és nem a megfelelő sztring a munkafolyamathoz.

Eseményközpont-kapcsolat létrehozása

Amikor először ad hozzá eseményközpont-eseményindítót vagy műveletet, a rendszer kérni fogja, hogy hozzon létre kapcsolatot az eseményközponttal.

  1. Amikor a rendszer kéri, válasszon az alábbi lehetőségek közül:

    • Adja meg a következő kapcsolati adatokat:

      Tulajdonság Kötelező Érték Leírás
      Kapcsolat neve Igen <kapcsolat neve> A kapcsolathoz létrehozandó név
      Event Hubs-névtér Igen <event-hubs-namespace> Válassza ki a használni kívánt Event Hubs-névteret.
    • A korábban mentett kapcsolati sztring manuális megadásához válassza a Kapcsolatadatok manuális megadása lehetőséget. Megtudhatja, hogyan keresheti meg a kapcsolati sztring.

  2. Válassza ki a használni kívánt Event Hubs-szabályzatot, ha még nincs kijelölve, majd válassza a Létrehozás lehetőséget.

    Képernyőkép a megadott kapcsolati adatokról a

  3. A kapcsolat létrehozása után folytassa az Event Hubs-eseményindító hozzáadása vagy az Eseményközpontok hozzáadása művelettel.

Event Hubs-trigger hozzáadása

Az Azure Logic Appsben minden munkafolyamatnak egy eseményindítóval kell kezdődnie, amely egy adott feltétel teljesülésekor aktiválódik. Minden alkalommal, amikor az eseményindító aktiválódik, a Logic Apps szolgáltatás létrehoz egy munkafolyamat-példányt, és elkezdi futtatni a munkafolyamat lépéseit.

Az alábbi lépések ismertetik az eseményindítók hozzáadásának általános módját, például: Amikor események érhetők el az Event Hubban. Ez a példa bemutatja, hogyan vehet fel olyan eseményindítót, amely új eseményeket keres az eseményközpontban, és elindít egy munkafolyamatot, amikor új események léteznek.

  1. A Logic Apps Designerben nyissa meg az üres logikai alkalmazás munkafolyamatát, ha még nem nyitotta meg.

  2. A művelet keresőmezőjében adja meg a következőt event hubs: Az eseményindítók listájában válassza ki a When events are available in Event Hub (Eseményközpontban elérhető események) nevű eseményindítót.

    Eseményindító kiválasztása

  3. Ha a rendszer arra kéri, hogy hozzon létre kapcsolatot az eseményközponttal, adja meg a kért kapcsolatadatokat.

  4. Az eseményindítóban adja meg a figyelni kívánt eseményközpont adatait, például:

    Tulajdonság Kötelező Leírás
    Event Hub neve Igen A figyelni kívánt eseményközpont neve
    Tartalom típusa Nem Az esemény tartalomtípusa. Az alapértelmezett érték application/octet-stream.
    Fogyasztói csoport neve Nem Az események olvasásához használandó Event Hubs fogyasztói csoport neve. Ha nincs megadva, a rendszer az alapértelmezett fogyasztói csoportot használja.
    Események maximális száma Nem Az események maximális száma. Az eseményindító egy és a tulajdonság által megadott események száma között ad vissza.
    Intervallum Igen Pozitív egész szám, amely leírja, hogy milyen gyakran fut a munkafolyamat a gyakoriság alapján
    Gyakoriság Igen Az ismétlődés időegysége

    További tulajdonságokért nyissa meg az Új paraméter hozzáadása listát. Egy paraméter kiválasztása hozzáadja ezt a tulajdonságot az eseményindítóhoz, például:

    Eseményindító tulajdonságai

    További tulajdonságok

    Tulajdonság Kötelező Leírás
    Tartalomséma Nem Az eseményközpontból beolvasandó események JSON-tartalomséma. Ha például megadja a tartalomsémát, a munkafolyamatot csak a sémának megfelelő eseményekhez aktiválhatja.
    Minimális partíciókulcs Nem Adja meg az olvasáshoz szükséges minimális partícióazonosítót . Alapértelmezés szerint az összes partíció be van olvasva.
    Partíciókulcs maximális száma Nem Adja meg a maximálisan olvasható partícióazonosítót . Alapértelmezés szerint az összes partíció be van olvasva.
    Időzóna Nem Csak akkor érvényes, ha megadja a kezdési időpontot, mert ez az eseményindító nem fogadja el az UTC-eltolást. Válassza ki az alkalmazni kívánt időzónát.

    További információ: Ismétlődő feladatok és munkafolyamatok létrehozása és futtatása az Azure Logic Apps használatával.

    Kezdési idő Nem Adja meg a kezdési időpontot ebben a formátumban:

    YYYY-MM-DDThh:mm:ss, ha kiválaszt egy időzónát

    -vagy-

    YYYY-MM-DDThh:mm:ssZ, ha nem jelöl ki időzónát

    További információ: Ismétlődő feladatok és munkafolyamatok létrehozása és futtatása az Azure Logic Apps használatával.

  5. Ha elkészült, a tervező eszköztárán válassza a Mentés lehetőséget.

  6. Most folytassa egy vagy több művelet hozzáadását, hogy más feladatokat is végrehajthass az eseményindító kimeneteivel.

    Ha például egy adott érték ( például kategória) alapján szeretné szűrni az eseményeket, hozzáadhat egy feltételt, hogy az Esemény küldése művelet csak azokat az eseményeket küldje el, amelyek megfelelnek a feltételnek.

Lekérdezési viselkedés aktiválása

Minden Event Hubs-eseményindító hosszú lekérdezésű eseményindító. Ez a viselkedés azt jelenti, hogy amikor egy eseményindító aktiválódik, az eseményindító feldolgozza az összes eseményt, és 30 másodpercet vár, amíg további események jelennek meg az eseményközpontban. Ha 30 másodperc alatt nem jelennek meg események, a program kihagyja az eseményindítót. Ellenkező esetben az eseményindító addig olvassa az eseményeket, amíg az eseményközpont üres nem lesz. A következő eseményindító-lekérdezés az eseményindító tulajdonságaiban megadott ismétlődési időköz alapján történik.

Ha például az eseményindító négy partícióval van beállítva, ez a késleltetés akár két percet is igénybe vehet, amíg az eseményindító befejezi az összes partíció lekérdezését. Ha nem érkeznek események ezen a késleltetésen belül, a rendszer kihagyja az eseményindító futtatását. Ellenkező esetben az eseményindító addig olvassa az eseményeket, amíg az eseményközpont üres nem lesz. A következő eseményindító-lekérdezés az eseményindító tulajdonságaiban megadott ismétlődési időköz alapján történik.

Ha ismeri az üzeneteket tartalmazó adott partíció(ka)t, frissítheti az eseményindítót, hogy csak ebből vagy ezekből a partíciókból olvasson eseményeket az eseményindító maximális és minimális partíciókulcsainak beállításával. További információkért tekintse át az Eseményközpontok hozzáadása eseményindító szakaszt.

Eseményindító ellenőrzőpont-viselkedése

Amikor egy Event Hubs-eseményindító beolvassa az eseményeket az eseményközpont egyes partícióiról, az eseményindító a saját állapotát használja a streameltolással (a partíció eseményhelyzetével) és az eseményindító eseményolvasási helyének partícióival kapcsolatos információk megőrzéséhez.

A munkafolyamat minden futtatásakor az eseményindító beolvassa az eseményeket egy partícióról, kezdve az eseményindító állapota által megtartott streameltolástól. Ciklikus időszeleteléses módon az eseményindító iterálja az eseményközpont minden partícióját, és felolvassa az eseményeket a későbbi eseményindító-futtatások során. Egyetlen futtatás egyszerre egyetlen partícióról is lekéri az eseményeket.

Az eseményindító nem használja ezt az ellenőrzőpont-képességet a tárolóban, így nem jár többletköltséggel. A lényeg azonban az, hogy az Event Hubs-eseményindító frissítése alaphelyzetbe állítja az eseményindító állapotát, ami miatt az eseményindító felolvassa az eseményeket a stream elején.

Event Hubs-művelet hozzáadása

Az Azure Logic Appsben egy művelet követi az eseményindítót vagy egy másik műveletet, és végrehajt egy műveletet a munkafolyamatban. Az alábbi lépések egy művelet hozzáadásának általános módját mutatják be, például az Esemény küldése lehetőséget. Ebben a példában a munkafolyamat egy Event Hubs-eseményindítóval kezdődik, amely új eseményeket keres az eseményközpontban.

  1. A Logic Apps Designerben nyissa meg a logikai alkalmazás munkafolyamatát, ha még nem nyitotta meg.

  2. Az eseményindító vagy egy másik művelet alatt adjon hozzá egy új lépést.

    A meglévő lépések közötti lépés hozzáadásához vigye az egérmutatót a nyílra. Jelölje ki a megjelenő pluszjelet (+), majd válassza a Művelet hozzáadása lehetőséget.

  3. A művelet keresőmezőjében adja meg a következőt event hubs: A műveletek listájában válassza ki az Esemény küldése nevű műveletet.

    Válassza az

  4. Ha a rendszer arra kéri, hogy hozzon létre kapcsolatot az eseményközponttal, adja meg a kért kapcsolatadatokat.

  5. A műveletben adja meg az elküldeni kívánt események adatait.

    Tulajdonság Kötelező Leírás
    Event Hub neve Igen Az eseményközpont, ahová el szeretné küldeni az eseményt
    Tartalom Nem A küldeni kívánt esemény tartalma
    Tulajdonságok Nem A küldendő alkalmazástulajdonságok és értékek
    Partíciókulcs Nem Az esemény elküldésének helye partícióazonosítója

    További tulajdonságokért nyissa meg az Új paraméter hozzáadása listát. Egy paraméter kiválasztása hozzáadja ezt a tulajdonságot a művelethez, például:

    Válassza ki az eseményközpont nevét, és adja meg az esemény tartalmát

    Például elküldheti a kimenetet az Event Hubs-eseményindítóból egy másik eseményközpontba:

    Példa küldése eseményre

  6. Ha elkészült, a tervező eszköztárán válassza a Mentés lehetőséget.

Összekötőkkel kapcsolatos segédlet

Az összes művelet és egyéb technikai információ, például tulajdonságok, korlátok és egyéb információkért tekintse át az Event Hubs-összekötő referenciaoldalát.

Következő lépések