Verbinding maken vanuit werkstromen in een event hub Azure Logic Apps

De Azure Event Hubs-connector helpt u om uw werkstromen voor logische apps te verbinden met Event Hubs in Azure. Vervolgens kunt u uw werkstromen gebeurtenissen laten bewaken en beheren die naar een Event Hub worden verzonden. Uw werkstroom kan bijvoorbeeld gebeurtenissen van uw Event Hub controleren, verzenden en ontvangen. Dit artikel bevat een aan de slag-handleiding voor het gebruik van de Azure Event Hubs-connector door te laten zien hoe u verbinding maakt met een Event Hub en een Event Hubs-trigger of -actie aan uw werkstroom toevoegt.

Voor meer informatie over Azure Event Hubs of Azure Logic Apps, bekijkt u Wat is Azure Event Hubs of Wat is Azure Logic Apps.

Beschikbare bewerkingen

Voor alle bewerkingen en andere technische informatie, zoals eigenschappen, limieten, Event Hubs de referentiepagina van de connector.

Vereisten

• Een Azure-account en -abonnement. Als u nog geen abonnement op Azure hebt, registreer u dan nu voor een gratis Azure-account.

• Een Event Hubs-naamruimte en Event Hub

• De werkstroom van de logische app waar u toegang wilt krijgen tot uw Event Hub

  Als u een werkstroom wilt starten met Event Hubs trigger, hebt u een lege werkstroom nodig. Als u nog geen tijd hebt Azure Logic Apps, Azure Logic Apps deze quickstart om een voorbeeld van een werkstroom voor logische apps te maken.

Machtigingen controleren en connection string

Controleer uw machtigingen en haal vervolgens de connection string voor de naamruimte van uw Event Hub op om ervoor te zorgen dat uw werkstroom toegang heeft tot uw Event Hub.

1. Ga in Azure Portalnaar uw Event Hubs- en niet een specifieke Event Hub.

2. Selecteer in het naamruimtemenu onder Instellingen de optie Beleid voor gedeelde toegang. Controleer in de kolom Claims of u ten minste machtigingen voor beheren voor die naamruimte hebt.

   

3. Als u uw verbindingsgegevens later handmatig wilt invoeren, moet u de connection string voor uw Event Hub-naamruimte op te halen.

   1. Selecteer in de kolom Beleid de optie RootManageSharedAccessKey.

   2. Zoek de gegevens van uw primaire connection string. Kopieer de gegevens en connection string voor later gebruik.

      

      Tip

      Als u wilt controleren of uw connection string is gekoppeld aan uw Event Hubs-naamruimte of aan een specifieke Event Hub, controleert u of de connection string niet de EntityPath parameter heeft. Als u deze parameter vindt, is de connection string voor een specifieke Event Hubs 'entiteit' en is dit niet de juiste tekenreeks voor gebruik met uw werkstroom.

Een Event Hub-verbinding maken

Wanneer u voor het Event Hubs een trigger of actie toevoegt, wordt u gevraagd om een verbinding met uw Event Hub te maken.

1. Wanneer u hier om wordt gevraagd, kiest u een van de volgende opties:

   • Geef de volgende verbindingsgegevens op:

     Eigenschap	Vereist	Waarde	Beschrijving
     Verbindingsnaam	Ja	<connection-name>	De naam die moet worden gemaakt voor uw verbinding
     Event Hubs naamruimte	Ja	<event-hubs-namespace>	Selecteer de Event Hubs naamruimte die u wilt gebruiken.

   • Als u de eerder opgeslagen gegevens handmatig wilt connection string, selecteert u Handmatig verbindingsgegevens invoeren. Meer informatie over het vinden van uw connection string.

2. Selecteer het Event Hubs te gebruiken, als dit nog niet is geselecteerd, en selecteer vervolgens Maken.

   

3. Nadat u de verbinding hebt gemaakt, gaat u verder met een trigger Event Hubs toevoegen of een Event Hubs toevoegen.

Azure Event Hubs-trigger toevoegen

In Azure Logic Apps moet elke werkstroom beginnen met een trigger, die wordt activeren wanneer aan een specifieke voorwaarde wordt voldaan. Telkens wanneer de trigger wordt gestart, maakt Logic Apps service een werkstroom-exemplaar en wordt gestart met het uitvoeren van de stappen in de werkstroom.

In de volgende stappen wordt de algemene manier beschreven om een trigger toe te voegen, bijvoorbeeld Wanneer gebeurtenissen beschikbaar zijn in Event Hub. In dit voorbeeld ziet u hoe u een trigger toevoegt die controleert op nieuwe gebeurtenissen in uw Event Hub en een werkstroomuit voeren start wanneer er nieuwe gebeurtenissen bestaan.

1. Open in Logic Apps Designer de werkstroom van uw lege logische app, als deze nog niet is geopend.

2. Voer in het zoekvak voor de bewerking event hubs in. Selecteer in de lijst met triggers de trigger met de naam Wanneer gebeurtenissen beschikbaar zijn in Event Hub.

   

3. Als u wordt gevraagd om een verbinding met uw Event Hub te maken, geeft u de aangevraagde verbindingsgegevens op.

4. Geef in de trigger informatie op over de Event Hub die u wilt bewaken, bijvoorbeeld:

   Eigenschap	Vereist	Beschrijving
   Naam van de Event Hub	Ja	De naam van de Event Hub die u wilt bewaken
   Inhoudstype	Nee	Het inhoudstype van de gebeurtenis. De standaardwaarde is application/octet-stream.
   Naam van consumentengroep	Nee	De naam voor de Event Hubs die moet worden gebruikt voor het lezen van gebeurtenissen. Als dit niet is opgegeven, wordt de standaard consumentengroep gebruikt.
   Maximum aantal gebeurtenissen	Nee	Het maximum aantal gebeurtenissen. De trigger retourneert tussen één en het aantal gebeurtenissen dat is opgegeven door deze eigenschap.
   Interval	Ja	Een positief geheel getal dat beschrijft hoe vaak de werkstroom wordt uitgevoerd op basis van de frequentie
   Frequentie	Ja	De tijdseenheid voor het terugkeerpatroon

   Open de lijst Nieuwe parameter toevoegen voor meer eigenschappen. Als u een parameter selecteert, wordt die eigenschap toegevoegd aan de trigger, bijvoorbeeld:

   

   Meer eigenschappen

   Eigenschap	Vereist	Beschrijving
   Inhoudsschema	Nee	Het JSON-inhoudsschema voor de gebeurtenissen die u uit uw Event Hub kunt lezen. Als u bijvoorbeeld het inhoudsschema opgeeft, kunt u de werkstroom alleen activeren voor gebeurtenissen die overeenkomen met het schema.
   Minimale partitiesleutel	Nee	Voer de minimale partitie-id in die u wilt lezen. Standaard worden alle partities gelezen.
   Maximale partitiesleutel	Nee	Voer de maximale partitie-id in die u wilt lezen. Standaard worden alle partities gelezen.
   Tijdzone	Nee	Is alleen van toepassing wanneer u een begintijd opgeeft omdat deze trigger geen UTC-offset accepteert. Selecteer de tijdzone die u wilt toepassen. Zie Terugkerende taken en werkstromen maken en uitvoeren met Azure Logic Apps.
   Begintijd	Nee	Geef een begintijd op in deze indeling: YYYY-MM-DDThh:mm:ss als u een tijdzone selecteert -of- YYYY-MM-DDThh:mm:ssZ als u geen tijdzone selecteert Zie Terugkerende taken en werkstromen maken en uitvoeren met Azure Logic Apps.

5. Selecteer Opslaan op de werkbalk van de ontwerper wanneer u klaar bent.

6. Ga nu verder met het toevoegen van een of meer acties, zodat u andere taken kunt uitvoeren met behulp van de triggeruitvoer.

   Als u bijvoorbeeld gebeurtenissen wilt filteren op basis van een specifieke waarde, zoals een categorie, kunt u een voorwaarde toevoegen, zodat de actie Gebeurtenis verzenden alleen de gebeurtenissen verzendt die aan uw voorwaarde voldoen.

Pollinggedrag activeren

Alle Event Hubs triggers zijn triggers voor lange polling. Dit gedrag betekent dat wanneer een trigger wordt gemaakt, de trigger alle gebeurtenissen verwerkt en 30 seconden wacht totdat er meer gebeurtenissen worden weergegeven in uw Event Hub. Als er binnen 30 seconden geen gebeurtenissen worden weergegeven, wordt de trigger overgeslagen. Anders blijft de trigger gebeurtenissen lezen totdat uw Event Hub leeg is. De volgende trigger-poll vindt plaats op basis van het terugkeerpatroon dat u hebt ingesteld in de eigenschappen van de trigger.

Als de trigger bijvoorbeeld is ingesteld met vier partities, kan deze vertraging tot twee minuten duren voordat de trigger alle partities heeft gepeild. Als er binnen deze vertraging geen gebeurtenissen worden ontvangen, wordt de triggeruit voeren overgeslagen. Anders blijft de trigger gebeurtenissen lezen totdat uw Event Hub leeg is. De volgende trigger-poll vindt plaats op basis van het terugkeerpatroon dat u opgeeft in de eigenschappen van de trigger.

Als u weet welke specifieke partities waar de berichten worden weergegeven, kunt u de trigger bijwerken om alleen gebeurtenissen van deze of die partities te lezen door de maximale en minimale partitiesleutels van de trigger in te stellen. Bekijk de sectie Trigger toevoegen Event Hubs meer informatie.

Gedrag van controlepunten activeren

Wanneer een Event Hubs-trigger gebeurtenissen van elke partitie in een Event Hub leest, wordt de status van de trigger gebruikers eigen om informatie bij te houden over de stream-offset (de gebeurtenispositie in een partitie) en de partities van waaruit de trigger gebeurtenissen leest.

Telkens als uw werkstroom wordt uitgevoerd, leest de trigger gebeurtenissen van een partitie, beginnend bij de stroom-offset die wordt bewaard door de triggerstatus. Op round robin-wijze doorloop de trigger elke partitie in de Event Hub en leest deze gebeurtenissen in volgende trigger-runs. Eén run haalt gebeurtenissen op uit één partitie tegelijk.

De trigger maakt geen gebruik van deze controlepuntmogelijkheid in de opslag, wat leidt tot geen extra kosten. Het belangrijkste punt is echter dat bij het bijwerken van de Event Hubs-trigger de status van de trigger opnieuw wordt ingesteld, waardoor de trigger gebeurtenissen aan het begin van de stroom kan lezen.

Azure Event Hubs actie toevoegen

In Azure Logic Apps volgt een actie de trigger of een andere actie en voert een bewerking uit in uw werkstroom. In de volgende stappen wordt de algemene manier beschreven om een actie toe te voegen, bijvoorbeeld Gebeurtenis verzenden. Voor dit voorbeeld begint de werkstroom met een Event Hubs trigger die controleert op nieuwe gebeurtenissen in uw Event Hub.

1. Open in Logic Apps Designer de werkstroom van uw logische app, als deze nog niet is geopend.

2. Voeg onder de trigger of een andere actie een nieuwe stap toe.

   Als u een stap tussen bestaande stappen wilt toevoegen, beweegt u de muis over de pijl. Selecteer het plusteken ( + ) dat wordt weergegeven en selecteer vervolgens Een actie toevoegen.

3. Voer in het zoekvak voor de bewerking event hubs in. Selecteer in de lijst met acties de actie met de naam Gebeurtenis verzenden.

   

4. Als u wordt gevraagd om een verbinding met uw Event Hub te maken, geeft u de aangevraagde verbindingsgegevens op.

5. Geef in de actie informatie op over de gebeurtenissen die u wilt verzenden.

   Eigenschap	Vereist	Beschrijving
   Naam van de Event Hub	Ja	De Event Hub waar u de gebeurtenis wilt verzenden
   Inhoud	Nee	De inhoud voor de gebeurtenis die u wilt verzenden
   Eigenschappen	Nee	De app-eigenschappen en -waarden die moeten worden verzenden
   Partitiesleutel	Nee	De partitie-id voor waar de gebeurtenis moet worden verzenden

   Open de lijst Nieuwe parameter toevoegen voor meer eigenschappen. Als u een parameter selecteert, wordt die eigenschap toegevoegd aan de actie, bijvoorbeeld:

   

   U kunt bijvoorbeeld de uitvoer van uw Event Hubs naar een andere Event Hub verzenden:

   

6. Selecteer Opslaan op de werkbalk van de ontwerper wanneer u klaar bent.

Connector-verwijzing

Voor alle bewerkingen en andere technische informatie, zoals eigenschappen, limieten, Event Hubs de referentiepagina van de connector.

Volgende stappen

• Meer informatie over Logic Apps connectors