Ansluta arbetsflöden till händelsehubbar i Azure Logic Apps

Gäller för: Azure Logic Apps (Förbrukning + Standard)

Om du vill automatisera uppgifter som övervakar och hanterar händelser i en händelsehubb inifrån ditt arbetsflöde i Azure Logic Apps använder du azure Event Hubs-anslutningsåtgärderna . Ditt arbetsflöde kan till exempel kontrollera, skicka och ta emot händelser från händelsehubben.

Den här artikeln visar hur du ansluter till din händelsehubb genom att lägga till en Event Hubs-utlösare eller åtgärd i arbetsflödet.

Referens för anslutningsprogram

Information om den här anslutningsappens åtgärder, deras parametrar och annan teknisk information, till exempel gränser, kända problem och så vidare, finns på referenssidan för Event Hubs-anslutningsappen.

Förutsättningar

• Ett Azure-konto och prenumeration. Om du inte har någon prenumeration kan du registrera ett kostnadsfritt Azure-konto.

• Ett Event Hubs-namnområde och en händelsehubb.

  Kontrollera att arbetsflödet har åtkomst till din händelsehubb. Slutför den här uppgiften genom att följa dessa steg:

  1. I Azure Portal går du till Event Hubs-namnområdet, inte en specifik händelsehubb.

  2. På namnområdesmenyn går du till Inställningar och väljer Principer för delad åtkomst. I kolumnen Anspråk kontrollerar du att du har minst Hantera behörigheter för det namnområdet.

     Anmärkning

     När du senare skapar en anslutning till Event Hubs-namnområdet uppmanas du att välja en autentiseringstyp för anslutningen. Baserat på valet av autentiseringstyp kan du behöva anslutningssträngen för namnområdet. Åtkomstnyckelautentisering kräver till exempel den här anslutningssträngen.

  3. Om du planerar att senare välja en autentiseringstyp som kräver anslutningssträngen för Event Hubs-namnområdet sparar du strängen nu så att du kan ange den informationen senare:

     1. I kolumnen Princip väljer du RootManageSharedAccessKey.

     2. Hitta primärnyckelns anslutningssträng. Kopiera och spara anslutningssträng för senare användning.

        Kontrollera att anslutningssträngen tillhör event hubs-namnområdet och inte en specifik händelsehubb genom att kontrollera att anslutningssträngen inte har parametern EntityPath . Om du hittar den här parametern tillhör anslutningssträngen en händelsehubb och är inte rätt sträng att använda med arbetsflödet.

        

• Arbetsflödet för logikappen där du vill komma åt din händelsehubb

  Om du vill starta arbetsflödet med en Event Hubs-utlösare behöver du ett tomt arbetsflöde. Om du vill använda en Event Hubs-åtgärd i arbetsflödet kan du använda alla utlösare som fungerar bäst för ditt scenario för att starta arbetsflödet.

Lägga till en Event Hubs-utlösare

I Azure Logic Apps måste varje arbetsflöde börja med en utlösare som utlöses när ett visst villkor uppfylls. Varje gång utlösaren utlöses skapar Azure Logic Apps en instans av arbetsflödet och börjar köra stegen i arbetsflödet.

Följande steg beskriver det allmänna sättet att lägga till en Event Hubs-utlösare , till exempel När händelser är tillgängliga i Händelsehubb. Den här exempelutlösaren söker efter nya händelser i händelsehubben och startar en arbetsflödeskörning när nya händelser finns.

1. Öppna logikappresursen i Azure Portal.

2. Beroende på om du har en förbrukningsbaserad eller standard logik appresurs, följ de motsvarande stegen:

   • Förbrukning: I resurslisten går du till Utvecklingsverktyg och väljer designern för att öppna ditt tomma arbetsflöde.

   • Standard: I sidofältet för resursen går du till Arbetsflöden, väljer Arbetsflöden och sedan ditt tomma arbetsflöde. I arbetsflödets sidofält går du till Verktyg och väljer designern för att öppna det tomma arbetsflödet.

3. I designern följer du de här allmänna stegen för att lägga till den Event Hubs-utlösare som du vill använda i arbetsflödet.

   Mer information finns i Event Hubs – Utlösare. Det här exemplet fortsätter med utlösaren med namnet When events are available in Event Hub (När händelser är tillgängliga i Händelsehubb). Den här utlösaren söker efter nya händelser i händelsehubben och startar en arbetsflödeskörning när nya händelser finns.

4. Ange anslutningsinformationen för händelsehubben om du uppmanas att göra det.

5. Ange nödvändig information för den valda utlösaren i utlösaren.

   För exempelutlösaren beskriver följande tabeller de tillgängliga parametrarna, som börjar med följande standardparameter:

   Parameter	Obligatoriskt	beskrivning
   Namn på händelsehubb	Ja	Namnet på den händelsehubb som ska övervakas.

   Under Hur ofta vill du söka efter objekt är följande standardparametrar tillgängliga:

   Parameter	Obligatoriskt	beskrivning
   Intervall	Ja	Ett positivt heltal som beskriver hur ofta arbetsflödet körs baserat på frekvensen.
   Frekvens	Ja	Tidsenheten för upprepningen.
   Tidszon	Nej	Gäller endast när du anger en starttid eftersom den här utlösaren inte accepterar UTC-förskjutning. Välj den tidszon som du vill använda. Mer information finns i Schemalägga och köra återkommande arbetsflöden.
   Starttid	Nej	Ange en starttid i det här formatet: ÅÅÅÅ-MM-DDThh:mm:ss om du väljer en tidszon -eller- ÅÅÅÅ-MM-DDThh:mm:ssZ om du inte väljer en tidszon Mer information finns i Schemalägga och köra återkommande arbetsflöden.

   I listan Avancerade parametrar är följande valfria parametrar tillgängliga:

   Parameter	Obligatoriskt	beskrivning
   Innehållstyp	Nej	Händelsens innehållstyp. Standardvärdet är application/octet-stream.
   Innehållsschema	Nej	Händelsens innehållsschema.
   Namn på konsumentgrupp	Nej	Namnet på konsumentgruppen för händelsehubben som ska användas för att läsa händelser. Om den är ospecificerad används standardkonsumentgruppen.
   Minsta partitionsnyckel	Nej	Ange det minsta partitions-ID som ska läsas. Som standard är alla partitioner lästa.
   Maximal partitionsnyckel	Nej	Ange det maximala partitions-ID som ska läsas. Som standard är alla partitioner lästa.
   Maximalt antal händelser	Nej	Det maximala antalet händelser. Utlösaren returnerar mellan en och antalet händelser som anges av den här egenskapen.

6. När du är klar klickar du på tabelldesignern Spara på kommandofältet.

7. Fortsätt nu att lägga till en eller flera åtgärder så att du kan utföra andra uppgifter med utlösarutdata.

   Om du till exempel vill filtrera händelser baserat på ett specifikt värde, till exempel en kategori, kan du lägga till ett villkor så att åtgärden Skicka händelse endast skickar de händelser som uppfyller ditt villkor.

Utlösarbeteende

Utlösa avsökningsbeteende

Alla Event Hubs-utlösare är utlösare för långa avsökningar. Det här beteendet innebär att när en utlösare utlöses bearbetar utlösaren alla händelser och väntar i 30 sekunder på att fler händelser ska visas i händelsehubben. Om inga händelser visas på 30 sekunder hoppas utlösaren över. Annars fortsätter utlösaren att läsa händelser tills händelsehubben är tom. Nästa utlösaravsökning sker baserat på det upprepningsintervall som du anger i utlösarens egenskaper.

Om utlösaren till exempel har konfigurerats med fyra partitioner kan den här fördröjningen ta upp till två minuter innan utlösaren har slutfört avsökningen av alla partitioner. Om inga händelser tas emot inom den här fördröjningen hoppas utlösarkörningen över. Annars fortsätter utlösaren att läsa händelser tills händelsehubben är tom. Nästa utlösaravsökning sker baserat på det upprepningsintervall som du anger i utlösarens egenskaper.

Om du känner till de specifika partitioner där meddelandena visas kan du uppdatera utlösaren till att bara läsa händelser från dessa partitioner. Ange utlösarens högsta och lägsta partitionsnycklar. Mer information finns i avsnittet Lägg till Event Hubs-utlösare .

Beteende för utlösarkontrollpunkt

När en Event Hubs-utlösare läser händelser från varje partition i en händelsehubb, använder utlösaren sitt eget tillstånd för att underhålla information om strömförskjutningen (händelsepositionen i en partition) och de partitioner som utlösaren läser händelser från.

Varje gång arbetsflödet körs läser utlösaren händelser från en partition, med början från strömförskjutningen som lagras i utlösartillståndet. I resursallokering itererar utlösaren över varje partition i händelsehubben och läser händelser i efterföljande utlösarkörningar. En enda körning hämtar händelser från en enskild partition i taget.

Utlösaren använder inte den här kontrollpunktsfunktionen i lagringen, vilket resulterar i ingen extra kostnad. Om du uppdaterar Event Hubs-utlösaren återställs utlösarens tillstånd, vilket kan leda till att utlösaren läser händelser i början av strömmen.

Lägga till Event Hubs-åtgärd

I Azure Logic Apps följer en åtgärd utlösaren eller en annan åtgärd och utför en uppgift i arbetsflödet. Följande steg beskriver det allmänna sättet att lägga till en händelsehubbåtgärd , till exempel Skicka händelse. I det här exemplet börjar arbetsflödet med en Event Hubs-utlösare som söker efter nya händelser i händelsehubben.

1. Öppna logikappresursen i Azure Portal.

2. Beroende på om du har en förbrukningsbaserad eller standard logik appresurs, följ de motsvarande stegen:

   • Förbrukning: Under Utvecklingsverktyg i resurspanelen väljer du designern för att öppna arbetsflödet.

   • Standard: I resurslisten går du till Arbetsflöden, väljer Arbetsflöden och sedan ditt arbetsflöde. I arbetsflödets sidofält, under Verktyg, väljer du designern för att öppna arbetsflödet.

3. I designern följer du de här allmänna stegen för att lägga till den händelsehubbåtgärd som du vill använda i arbetsflödet.

   Mer information finns i Event Hubs – Åtgärder. Det här exemplet fortsätter med åtgärden Skicka händelse.

4. Ange anslutningsinformationen för händelsehubben om du uppmanas att göra det.

5. Ange nödvändig information för den valda åtgärden i åtgärden.

   För exempelåtgärden beskriver följande tabeller de tillgängliga parametrarna, som börjar med följande standardparameter:

   Parameter	Obligatoriskt	beskrivning
   Namn på händelsehubb	Ja	Namnet på den händelsehubb där du vill skicka händelsen.

   I listan Avancerade parametrar är följande valfria parametrar tillgängliga:

   Parameter	Obligatoriskt	beskrivning
   Partitionsnyckel	Nej	Partitions-ID:t för var händelsen ska skickas.
   Innehåll	Nej	Innehållet för den händelse som du vill skicka.
   Egenskaper	Nej	Appegenskaper och -värden som ska skickas.

   Du kan till exempel skicka utdata från Event Hubs-utlösaren till en annan händelsehubb:

   

6. När du är klar klickar du på tabelldesignern Spara på kommandofältet.

Skapa en anslutning

När du lägger till en Event Hubs-utlösare eller åtgärd för första gången uppmanas du att skapa en anslutning till din händelsehubb. För den här anslutningen anger du följande information och väljer Skapa ny:

När du har skapat anslutningen fortsätter du med Lägg till en Event Hubs-utlösare eller Lägg till en händelsehubbåtgärd.

Relaterat innehåll

• Vad är anslutningsappar i Azure Logic Apps
• Hanterade anslutningsappar för Azure Logic Apps