Köra en Azure-funktion enligt ett schema
Det är vanligt att köra en del av logiken med ett angivet intervall. Anta att du är bloggägare och att du märker att dina prenumeranter inte läser dina senaste inlägg. Du bestämmer dig för att den bästa åtgärden är att skicka ett e-postmeddelande till dem en gång i veckan för att påminna dem om att gå in på din blogg. Du implementerar den här logiken genom att skapa en funktionsapp i Azure med en timerutlösare som anropar funktionen varje vecka.
Vad är en timerutlösare?
En timerutlösare är en utlösare som kör en funktion med ett konsekvent intervall. Om du vill skapa en timerutlösare måste du ange två typer av information.
- Ett tidsstämpelparameternamn, vilket helt enkelt är en identifierare som får åtkomst till utlösaren i koden.
- Ett schema som är ett CRON-uttryck som anger intervallet för timern.
Vad är ett CRON-uttryck?
Ett CRON-uttryck är en sträng som består av sex fält som motsvarar olika tider.
Ordningen på de sex fälten i Azure är: {second} {minute} {hour} {day} {month} {day of the week}.
Ett CRON-uttryck för att skapa en utlösare som körs var femte minut ser till exempel ut så här: 0 */5 * * * *
Först kan strängen se förvirrande ut. Vi kommer tillbaka till de här begreppen när vi tar en närmare titt på CRON-uttryck.
För att kunna skapa ett CRON-uttryck måste du ha en grundläggande förståelse för vissa specialtecken.
| Specialtecken | Innebörd | Exempel |
|---|---|---|
| * | Väljer varje värde i ett fält | En asterisk ”*” i fältet för veckodag innebär varje dag. |
| , | Avgränsar objekt i en lista | Ett kommatecken ”1,3” i fältet för veckodag innebär enbart måndagar (dag 1) och onsdagar (dag 3). |
| - | Anger ett intervall | Ett bindestreck ”10-12” i fältet för timme innebär ett intervall för timmarna 10, 11 och 12. |
| / | Anger en ökning | Ett snedstreck ”*/10” i fältet för minuter innebär en ökning var tionde minut. |
Vi ska gå nu tillbaka till det ursprungliga exemplet på CRON-uttryck. Vi kan förstå det bättre om vi bryter ned ett fält i taget.
0 */5 * * * *
Det första fältet motsvarar sekunder. Det här fältet stöder värdena 0–59. Eftersom fältet innehåller en nolla, väljs det första möjliga värdet som är en sekund.
Det andra fältet motsvarar minuter. Värdet ”*/5” innehåller två specialtecken. Först betyder asterisken (*) "välj varje värde i fältet". Eftersom det här fältet representerar minuter är de möjliga värdena 0–59. Det andra specialtecknet är ett snedstreck (/) som motsvarar en ökning. När du kombinerar dessa tecken innebär det att var femte värde ska väljas för alla värden 0–59. Ett enklare sätt att säga det är helt enkelt ”var femte minut”.
De återstående fyra fälten representerar numeriskt timmen under en 24-timmars dag, dag i månaden, månad i ett 12-månadersår och dag i 7-dagarsveckan. En asterisk i dessa fält innebär att alla möjliga värden ska väljas. I det här exemplet väljer vi ”varje timme varje dag i varje månad”.
När du sätter ihop alla fält läss uttrycket som "den första sekunden av var femte minut i varje timme, varje dag, varje månad".
Skapa en timerutlösare
Du kan skapa en timerutlösare i Azure-portalen. I funktionsappen väljer du timerutlösare i listan med utlösarmallar. Ange den logik som du vill köra. Ange ett tidsstämpelparameternamn och CRON-uttrycket.
I den här modulen fokuserar vi på att skapa utlösare i portalen, men du kan också skapa utlösare programmatiskt med hjälp av Core Tools, Visual Studio eller Visual Studio Code.
En timerutlösare anropar funktionskoden enligt ett konsekvent schema. Vi definierade schemat för en timerutlösare genom att skapa ett CRON-uttryck, vilket är en sträng som motsvarar olika tider.