Trigger časovače pro Azure Functions

Tento článek vysvětluje, jak pracovat s triggery časovače ve službě Azure Functions. Trigger časovače umožňuje spustit funkci podle plánu.

Toto jsou referenční informace pro vývojáře Azure Functions. Pokud s Azure Functions začínáte, začněte s následujícími prostředky:

• Referenční informace pro vývojáře Azure Functions

• Koncepty triggerů a vazeb Azure Functions.

• Místní psaní kódu a testování funkcí Azure Functions

Informace o ručním spuštění funkce aktivované časovačem najdete v tématu Ruční spuštění funkce neaktivované protokolem HTTP.

Podpora této vazby se automaticky poskytuje ve všech vývojových prostředích. Balíček nemusíte instalovat ručně ani registrovat rozšíření.

Zdrojový kód balíčku rozšíření časovače je v úložišti GitHubu azure-webjobs-sdk-extensions .

Příklad

//<docsnippet_fixed_delay_retry_example>
[Function(nameof(TimerFunction))]
[FixedDelayRetry(5, "00:00:10")]
public static void Run([TimerTrigger("0 */5 * * * *")] TimerInfo timerInfo,
    FunctionContext context)
{
    var logger = context.GetLogger(nameof(TimerFunction));

[FunctionName("TimerTriggerCSharp")]
public static void Run([TimerTrigger("0 */5 * * * *")]TimerInfo myTimer, ILogger log)
{
    if (myTimer.IsPastDue)
    {
        log.LogInformation("Timer is running late!");
    }
    log.LogInformation($"C# Timer trigger function executed at: {DateTime.Now}");
}

@FunctionName("keepAlive")
public void keepAlive(
  @TimerTrigger(name = "keepAliveTrigger", schedule = "0 */5 * * * *") String timerInfo,
      ExecutionContext context
 ) {
     // timeInfo is a JSON string, you can deserialize it to an object using your favorite JSON library
     context.getLogger().info("Timer is triggered: " + timerInfo);
}

import datetime
import logging
import azure.functions as func

app = func.FunctionApp()

@app.function_name(name="mytimer")
@app.timer_trigger(schedule="0 */5 * * * *", 
              arg_name="mytimer",
              run_on_startup=True) 
def test_function(mytimer: func.TimerRequest) -> None:
    utc_timestamp = datetime.datetime.utcnow().replace(
        tzinfo=datetime.timezone.utc).isoformat()
    if mytimer.past_due:
        logging.info('The timer is past due!')
    logging.info('Python timer trigger function ran at %s', utc_timestamp)

{
    "schedule": "0 */5 * * * *",
    "name": "myTimer",
    "type": "timerTrigger",
    "direction": "in"
}

import datetime
import logging

import azure.functions as func


def main(mytimer: func.TimerRequest) -> None:
    utc_timestamp = datetime.datetime.now(datetime.timezone.utc).isoformat()

    if mytimer.past_due:
        logging.info('The timer is past due!')

    logging.info('Python timer trigger function ran at %s', utc_timestamp)

import { app, InvocationContext, Timer } from '@azure/functions';

export async function timerTrigger1(myTimer: Timer, context: InvocationContext): Promise<void> {
    context.log('Timer function processed request.');
}

app.timer('timerTrigger1', {
    schedule: '0 */5 * * * *',
    handler: timerTrigger1,
});

const { app } = require('@azure/functions');

app.timer('timerTrigger1', {
    schedule: '0 */5 * * * *',
    handler: (myTimer, context) => {
        context.log('Timer function processed request.');
    },
});

{
    "schedule": "0 */5 * * * *",
    "name": "myTimer",
    "type": "timerTrigger",
    "direction": "in"
}

module.exports = async function (context, myTimer) {
    var timeStamp = new Date().toISOString();

    if (myTimer.isPastDue)
    {
        context.log('Node is running late!');
    }
    context.log('Node timer trigger function ran!', timeStamp);   
};

{
    "schedule": "0 */5 * * * *",
    "name": "myTimer",
    "type": "timerTrigger",
    "direction": "in"
}

# Input bindings are passed in via param block.
param($myTimer)

# Get the current universal time in the default string format.
$currentUTCtime = (Get-Date).ToUniversalTime()

# The 'IsPastDue' property is 'true' when the current function invocation is later than scheduled.
if ($myTimer.IsPastDue) {
    Write-Host "PowerShell timer is running late!"
}

# Write an information log with the current time.
Write-Host "PowerShell timer trigger function ran! TIME: $currentUTCtime"

Při místním vývoji přidejte nastavení aplikace do souboru local.settings.json v kolekci Values .

Kompletní příklady najdete v části Příklad.

Využití

Při vyvolání funkce triggeru časovače se do funkce předá objekt časovače. Následující JSON je příkladem reprezentace objektu časovače.

{
    "Schedule":{
        "AdjustForDST": true
    },
    "ScheduleStatus": {
        "Last":"2016-10-04T10:15:00+00:00",
        "LastUpdated":"2016-10-04T10:16:00+00:00",
        "Next":"2016-10-04T10:20:00+00:00"
    },
    "IsPastDue":false
}

{
    "schedule":{
        "adjustForDST": true
    },
    "scheduleStatus": {
        "last":"2016-10-04T10:15:00+00:00",
        "lastUpdated":"2016-10-04T10:16:00+00:00",
        "next":"2016-10-04T10:20:00+00:00"
    },
    "isPastDue":false
}

Vlastnost isPastDue je true , když aktuální vyvolání funkce je pozdější než naplánované. Restartování aplikace funkcí může například způsobit zmeškané vyvolání.

Výrazy NCRONTAB

Azure Functions používá knihovnu NCronTab k interpretaci výrazů NCRONTAB. Výraz NCRONTAB se podobá výrazu CRON s tím rozdílem, že obsahuje další šesté pole na začátku, které se použije pro přesnost času v sekundách:

{second} {minute} {hour} {day} {month} {day-of-week}

Každé pole může mít jeden z následujících typů hodnot:

Pokud chcete zadat měsíce nebo dny, můžete použít číselné hodnoty, názvy nebo zkratky názvů:

• Pro dny jsou číselné hodnoty 0 až 6, kde 0 začíná v neděli.
• Názvy jsou v angličtině. Příklad: Monday, January.
• Názvy nerozlišují malá a velká písmena.
• Názvy mohou být zkráceny. Pro zkratky doporučujeme použít tři písmena. Příklad: Mon, Jan.

Příklady NCRONTAB

Tady je několik příkladů výrazů NCRONTAB, které můžete použít pro trigger časovače ve službě Azure Functions.

Časová pásma NCRONTAB

Čísla ve výrazu NCRONTAB odkazují na čas a datum, nikoli časové rozpětí. Například hodnota 5 v hour poli odkazuje na 5:00, ne každých 5 hodin.

Výchozím časovým pásmem používaným pro výrazy CRON je koordinovaný univerzální čas (UTC). Pokud chcete, aby byl výraz CRON založený na jiném časovém pásmu, vytvořte nastavení aplikace pro aplikaci funkcí s názvem WEBSITE_TIME_ZONE.

Hodnota tohoto nastavení závisí na operačním systému a plánu, ve kterém příslušná aplikace funkcí běží.

Například východní čas v USA (reprezentovaný Eastern Standard Time (Windows) nebo America/New_York (Linux)) v současné době používá UTC-05:00 ve standardním čase a UTC-04:00 během letního času. Pokud chcete mít aktivaci časovače každý den v 10:00 východního času, vytvořte nastavení aplikace pro aplikaci funkcí s názvem WEBSITE_TIME_ZONE, nastavte hodnotu na Eastern Standard Time (Windows) nebo America/New_York (Linux) a pak použijte následující výraz NCRONTAB:

"0 0 10 * * *"

Když použijete WEBSITE_TIME_ZONE čas, upraví se pro změny času v konkrétním časovém pásmu, včetně letního času a změn ve standardním čase.

TimeSpan

Dá TimeSpan se použít jenom pro aplikaci funkcí, která běží v plánu služby App Service.

Na rozdíl od výrazu TimeSpan NCRONTAB určuje hodnota časový interval mezi voláním jednotlivých funkcí. Po dokončení funkce po spuštění delšího než zadaného intervalu časovač okamžitě vyvolá funkci znovu.

Vyjádřeno jako řetězec je TimeSpan formát hh:mm:ss , pokud hh je menší než 24. Pokud jsou první dvě číslice 24 nebo větší, formát je dd:hh:mm. Několik příkladů:

Škálování na víc systémů

Pokud aplikace funkcí škáluje kapacitu na více instancí, spustí se ve všech instancích pouze jedna instance funkce aktivované časovačem. Pokud stále běží nevyvolání, znovu se neaktivuje.

Aplikace funkcí sdílejí úložiště

Pokud sdílíte účty úložiště mezi aplikacemi funkcí, které nejsou nasazené ve službě App Service, budete možná muset každému aplikaci explicitně přiřadit ID hostitele.

Můžete vynechat identifikační hodnotu nebo ručně nastavit konfiguraci identifikující jednotlivé aplikace funkcí na jinou hodnotu.

Trigger časovače používá zámek úložiště k zajištění, že existuje pouze jedna instance časovače, když aplikace funkcí škáluje kapacitu na více instancí. Pokud dvě aplikace funkcí sdílejí stejnou identifikaci konfigurace a každý používá trigger časovače, spustí se jenom jeden časovač.

Chování opakování

Na rozdíl od triggeru fronty se trigger časovače po selhání funkce neopakuje. Pokud se funkce nezdaří, nebude znovu volána až do příštího spuštění plánu.

Ruční vyvolání triggeru časovače

Trigger časovače pro Azure Functions poskytuje webhook HTTP, který se dá vyvolat, aby funkci aktivoval ručně. To může být velmi užitečné v následujících scénářích.

• Testování integrace
• Prohození slotů v rámci orientačního testu nebo aktivity zahřátí
• Počáteční nasazení funkce pro okamžité naplnění mezipaměti nebo vyhledávací tabulky v databázi

Podrobnosti o tom, jak ručně vyvolat funkci aktivovanou časovačem, najdete v článku o ručním spuštění funkce, která není aktivovaná protokolem HTTP.

Řešení problému

Informace o tom, co dělat, když trigger časovače nefunguje podle očekávání, najdete v tématu Zkoumání a hlášení problémů s neaktivovanými funkcemi časovače.

Další kroky