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

• Azure-fiók és -előfizetés. Ha nem rendelkezik Azure-előfizetéssel, regisztráljon egy ingyenes Azure-fiókra.

• Event Hubs-névtér és eseményközpont

• A logikai alkalmazás munkafolyamata, amelyhez hozzá szeretne férni az eseményközponthoz

  Ha egy Event Hubs-eseményindítóval szeretne munkafolyamatot indítani, üres munkafolyamatra van szüksége. Ha még csak most ismerkedik az Azure Logic Appsszel, próbálja ki ezt a rövid útmutatót, és hozzon létre egy példát a Használat logikai alkalmazás munkafolyamatára.

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.

   

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.

      

      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.

   

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.

   

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:

   

   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.

   

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:

   

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

   

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

• Felügyelt összekötők az Azure Logic Appshez
• Beépített összekötők az Azure Logic Appshez
• Mik azok az összekötők az Azure Logic Appsben?