Připojení z pracovních postupů v Azure Logic Apps

Konektor Azure Event Hubs vám pomůže připojit pracovní postupy aplikací logiky k centrem událostí v Azure. Pracovní postupy pak můžete sledovat a spravovat události, které se odesílaly do centra událostí. Pracovní postup může například z centra událostí kontrolovat, odesílat a přijímat události. Tento článek obsahuje příručku Začínáme s používáním konektoru Azure Event Hubs tím, že ukazuje, jak se připojit k centru událostí a přidat do pracovního Event Hubs trigger nebo akci.

Další informace o Azure Event Hubs nebo Azure Logic Apps najdete v Azure Event Hubs nebo Co je Azure Logic Apps.

Dostupné operace

Informace o všech operacích a dalších technických informacích, jako jsou vlastnosti, omezení atd., najdete na Event Hubs referenční stránce konektoru služby.

Požadavky

• Účet a předplatné Azure. Pokud nemáte předplatné Azure, zaregistrujte si bezplatný účet Azure.

• Obor Event Hubs a centrum událostí

• Pracovní postup aplikace logiky, ve kterém chcete získat přístup k centru událostí

  Pokud chcete spustit pracovní postup s Event Hubs triggerem, potřebujete prázdný pracovní postup. Pokud se s aplikací Azure Logic Apps, vyzkoušejte tento rychlý starta vytvořte příklad pracovního postupu aplikace logiky.

Kontrola oprávnění a získání připojovacího řetězce

Abyste se ujistili, že váš pracovní postup má přístup k vašemu centru událostí, zkontrolujte oprávnění a pak získejte připojovací řetězec pro obor názvů vašeho centra událostí.

1. V části Azure Portalpřejděte do svého oboru názvů Event Hubs, nikoli na konkrétní centrum událostí.

2. V nabídce oboru názvů v části Nastavení vyberte Zásady sdíleného přístupu. Ve sloupci Deklarace identity zkontrolujte, že máte alespoň oprávnění Spravovat pro tento obor názvů.

   

3. Pokud chcete později ručně zadat informace o připojení, získejte připojovací řetězec pro váš obor názvů centra událostí.

   1. Ve sloupci Zásady vyberte RootManageSharedAccessKey.

   2. Vyhledejte připojovací řetězec primárního klíče. Zkopírujte a uložte připojovací řetězec pro pozdější použití.

      

      Tip

      Pokud chcete ověřit, jestli je váš připojovací řetězec přidružený k vašemu Event Hubs oboru názvů nebo ke konkrétnímu centru událostí, ujistěte se, že připojovací řetězec nemá EntityPath parametr . Pokud najdete tento parametr, připojovací řetězec je pro konkrétní Event Hubs "entitu" a není to správný řetězec pro použití s pracovním postupem.

Vytvoření připojení k centru událostí

Při prvním Event Hubs události nebo akce se zobrazí výzva k vytvoření připojení k centru událostí.

1. Po zobrazení výzvy zvolte jednu z následujících možností:

   • Zadejte následující informace o připojení:

     Vlastnost	Požaduje se	Hodnota	Popis
     Název připojení	Ano	<název připojení>	Název, který se má vytvořit pro vaše připojení
     Event Hubs názvů	Ano	<event-hubs-namespace>	Vyberte obor Event Hubs, který chcete použít.

   • Pokud chcete ručně zadat dříve uložený připojovací řetězec, vyberte Ručně zadat informace o připojení. Zjistěte, jak najít připojovací řetězec.

2. Vyberte zásadu Event Hubs, která se má použít, pokud ještě není vybraná, a pak vyberte Vytvořit.

   

3. Po vytvoření připojení pokračujte přidáním triggeru Event Hubs nebo Přidání Event Hubs události.

Přidání triggeru Event Hubs

V Azure Logic Apps musí každý pracovní postup začínán triggerem, který se aktivuje, když je splněna určitá podmínka. Pokaždé, když se trigger aktivuje, Logic Apps služba vytvoří instanci pracovního postupu a spustí kroky v pracovním postupu.

Následující kroky popisují obecný způsob přidání triggeru, například Když jsou v centru událostí dostupné události. Tento příklad ukazuje, jak přidat trigger, který v centru událostí vyhledá nové události a spustí spuštění pracovního postupu, když existují nové události.

1. V návrháři Logic Apps otevřete prázdný pracovní postup aplikace logiky, pokud ještě není otevřený.

2. Do vyhledávacího pole operace zadejte event hubs . V seznamu triggerů vyberte trigger s názvem When events are available in Event Hub (Když jsou v centru událostí k dispozici události).

   

3. Pokud se zobrazí výzva k vytvoření připojení k centru událostí, zadejte požadované informace o připojení.

4. V triggeru zadejte informace o centru událostí, které chcete monitorovat, například:

   Vlastnost	Povinné	Popis
   Název centra událostí	Ano	Název centra událostí, které chcete monitorovat
   Typ obsahu	No	Typ obsahu události Výchozí formát je application/octet-stream.
   Název skupiny uživatelů	No	Název skupiny uživatelů Event Hubs, která se má použít pro čtení událostí. Pokud není zadaný, použije se výchozí skupina uživatelů.
   Maximální počet událostí	No	Maximální počet událostí. Trigger se vrátí mezi jednou a počtem událostí určených touto vlastností.
   Interval	Ano	Kladné celé číslo, které popisuje, jak často se pracovní postup spouští na základě frekvence
   Frekvence	Ano	Jednotka času pro opakování

   Pokud chcete zobrazit další vlastnosti, otevřete seznam Přidat nový parametr. Výběrem parametru se tato vlastnost přidá do triggeru, například:

   

   Další vlastnosti

   Vlastnost	Povinné	Popis
   Schéma obsahu	No	Schéma obsahu JSON pro události, které se budou číst z centra událostí. Pokud například zadáte schéma obsahu, můžete pracovní postup aktivovat pouze pro události, které odpovídají schématu.
   Minimální klíč oddílu	No	Zadejte minimální ID oddílu , který se má přečíst. Ve výchozím nastavení jsou všechny oddíly čteny.
   Maximální klíč oddílu	No	Zadejte maximální ID oddílu , který se má přečíst. Ve výchozím nastavení jsou všechny oddíly čteny.
   Časové pásmo	No	Platí pouze v případě, že zadáte čas spuštění, protože tato aktivační událost nepřijímá posun UTC. Vyberte časové pásmo, které chcete použít. Další informace najdete v tématu vytváření a spouštění opakujících se úloh a pracovních postupů s Azure Logic Apps.
   Čas spuštění	No	Zadejte čas spuštění v tomto formátu: RRRR-MM-DDThh: mm: SS Pokud vyberete časové pásmo -nebo- RRRR-MM-DDThh: mm: ssZ, pokud nevyberete časové pásmo Další informace najdete v tématu vytváření a spouštění opakujících se úloh a pracovních postupů s Azure Logic Apps.

5. Až budete hotovi, na panelu nástrojů návrháře vyberte Uložit.

6. Nyní pokračujte v přidávání jedné nebo více akcí, aby bylo možné provádět další úlohy pomocí výstupů aktivačních událostí.

   Pokud například chcete filtrovat události na základě konkrétní hodnoty, jako je například kategorie, můžete přidat podmínku tak, aby akce Odeslat událost odeslala pouze události, které splňují vaši podmínku.

Chování při dotazování triggeru

Všechny triggery Event Hubs jsou triggery s dlouhým dotazem. Toto chování znamená, že když se Trigger aktivuje, Trigger zpracuje všechny události a počká 30 sekund, než se v centru událostí zobrazí další události. V případě, že se během 30 sekund nezobrazí žádné události, aktivační událost se přeskočí. V opačném případě aktivační událost pokračuje v čtení událostí, dokud vaše centrum událostí nebude prázdné. Následující dotaz na Trigger probíhá na základě intervalu opakování, který jste nastavili ve vlastnostech triggeru.

Pokud je například aktivační událost nastavená se čtyřmi oddíly, může zpoždění trvat až dvě minuty, než se Trigger dokončí dotazování všech oddílů. Pokud v rámci této prodlevy neobdrží žádné události, spuštění triggeru se přeskočí. V opačném případě aktivační událost pokračuje v čtení událostí, dokud vaše centrum událostí nebude prázdné. Následující dotaz na Trigger probíhá na základě intervalu opakování, který zadáte ve vlastnostech triggeru.

Pokud znáte konkrétní oddíly, ve kterých se zobrazují zprávy, můžete Trigger aktualizovat tak, aby četl události jenom z tohoto nebo těchto oddílů nastavením maximálního a minimálního klíče oddílu. Další informace najdete v části Přidání aktivační události Event Hubs .

Chování kontrolního bodu triggeru

Když aktivační událost Event Hubs čte události z každého oddílu centra událostí, Trigger uživatele vlastního stavu udržuje informace o posunu datového proudu (pozice události v oddílu) a oddílech, z nichž Trigger načítá události.

Při každém spuštění pracovního postupu Trigger načte události z oddílu a začne od posunu datového proudu, který je uložený ve stavu triggeru. V případě kruhového dotazování spustí aktivační událost jednotlivé oddíly v centru událostí a přečte události v následných spuštěních triggerů. Jediné spuštění načte události z jednoho oddílu po druhém.

Trigger nepoužívá tuto funkci kontrolního bodu v úložišti, takže nemá žádné dodatečné náklady. Klíčovým bodem je však, že aktualizace aktivační události Event Hubs resetuje stav triggeru, což může způsobit, že Trigger načtou události na začátku streamu.

Přidání akce Event Hubs

v Azure Logic Apps akce sleduje trigger nebo jinou akci a ve vašem pracovním postupu provádí určitou operaci. Následující kroky popisují obecný způsob, jak přidat akci, například Odeslat událost. V tomto příkladu se spustí pracovní postup Event Hubs triggeru, který kontroluje nové události v centru událostí.

1. V Návrháři Logic Apps otevřete pracovní postup aplikace logiky, pokud ještě není otevřený.

2. V aktivační události nebo jiné akci přidejte nový krok.

   Pokud chcete přidat krok mezi stávajícími kroky, přesuňte ukazatel myši na šipku. Vyberte symbol plus ( + ), který se zobrazí, a pak vyberte přidat akci.

3. Do vyhledávacího pole operace zadejte event hubs . V seznamu akce vyberte akci s názvem Odeslat událost.

   

4. Pokud budete vyzváni k vytvoření připojení k centru událostí, Zadejte požadované informace o připojení.

5. V akci zadejte informace o událostech, které chcete odeslat.

   Vlastnost	Povinné	Popis
   Název centra událostí	Ano	Centrum událostí, do kterého chcete událost odeslat
   Obsah	No	Obsah události, kterou chcete odeslat
   Vlastnosti	No	Vlastnosti a hodnoty aplikace, které se mají odeslat
   Klíč oddílu	No	ID oddílu , kde má být událost odeslána

   Pro další vlastnosti otevřete seznam Přidat nový parametr . Výběr parametru přidá tuto vlastnost do akce, například:

   

   Můžete třeba poslat výstup z aktivační události Event Hubs do jiného centra událostí:

   

6. Až budete hotovi, na panelu nástrojů návrháře vyberte Uložit.

Referenční informace ke konektorům

Informace o všech operacích a dalších technických informacích, jako jsou vlastnosti, omezení a tak dále, najdete na referenční stránce konektoru Event Hubs.

Další kroky

• Další informace o dalších konektorech Logic Apps