Azure İşlevleri için zamanlayıcı tetikleyicisi

Bu makalede, Azure İşlevleri'da zamanlayıcı tetikleyicileriyle çalışma açıklanmaktadır. Zamanlayıcı tetikleyicisi, bir işlevi zamanlamaya göre çalıştırmanıza olanak tanır.

Bu, Azure İşlevleri geliştiricilerin başvuru bilgileridir. Azure İşlevleri kullanmaya yeni başladıysanız aşağıdaki kaynaklarla başlayın:

• Azure İşlevleri geliştirici başvurusu

• Azure İşlevleri tetikleyicileri ve bağlama kavramları

• Azure İşlevleri’ni yerel olarak kodlama ve test etme

Zamanlayıcıyla tetiklenen bir işlevi el ile çalıştırma hakkında bilgi için bkz . HTTP ile tetiklenmeyen bir işlevi el ile çalıştırma.

Bu bağlama desteği tüm geliştirme ortamlarında otomatik olarak sağlanır. Paketi el ile yüklemeniz veya uzantıyı kaydetmeniz gerekmez.

Zamanlayıcı uzantısı paketinin kaynak kodu azure-webjobs-sdk-extensions GitHub deposundadır.

Örnek

//<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"

Yerel olarak geliştirme yaparken uygulama ayarlarınızı koleksiyondaki local.settings.json dosyasına Values ekleyin.

Tam örnekler için Örnek bölümüne bakın.

Kullanım

Zamanlayıcı tetikleyici işlevi çağrıldığında, işleve bir zamanlayıcı nesnesi geçirilir. Aşağıdaki JSON, zamanlayıcı nesnesinin örnek bir gösterimidir.

{
    "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
}

isPastDue özelliği, true geçerli işlev çağrısının zamanlanandan sonra olmasıdır. Örneğin, bir işlev uygulamasının yeniden başlatılması çağrının kaçırılmasına neden olabilir.

NCRONTAB ifadeleri

Azure İşlevleri,NCRONTAB ifadelerini yorumlamak için NCronTab kitaplığı. NCRONTAB ifadesi CRON ifadesine benzer, ancak başlangıçta saniye olarak zaman duyarlığı için kullanılacak ek bir altıncı alan içerir:

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

Her alan aşağıdaki değer türlerinden birine sahip olabilir:

Ayları veya günleri belirtmek için adların sayısal değerlerini, adlarını veya kısaltmalarını kullanabilirsiniz:

• Günler için sayısal değerler 0 ile 6 arasıdır ve burada 0 Pazar ile başlar.
• İsimler İngilizcedir. Örneğin: Monday, January.
• Adlar büyük/küçük harfe duyarlı değildir.
• Adlar kısaltılabilir. Kısaltmalar için üç harf kullanmanızı öneririz. Örneğin: Mon, Jan.

NCRONTAB örnekleri

Azure İşlevleri zamanlayıcı tetikleyicisi için kullanabileceğiniz NCRONTAB ifadelerinin bazı örnekleri aşağıda verilmiştir.

NCRONTAB saat dilimleri

NCRONTAB ifadesindeki sayılar bir zaman aralığına değil saat ve tarihe başvurur. Örneğin, alandaki 5 hour , her 5 saatte bir değil, 05:00'e başvurur.

CRON ifadeleriyle kullanılan varsayılan saat dilimi Eşgüdümlü Evrensel Saat'tir (UTC). CRON ifadenizin başka bir saat dilimine dayalı olmasını sağlamak için işlev uygulamanız için adlı WEBSITE_TIME_ZONEbir uygulama ayarı oluşturun.

Bu ayarın değeri, işlev uygulamanızın üzerinde çalıştırıldığı işletim sistemine ve plana bağlıdır.

Örneğin, ABD'de Doğu Saati ((Windows) veya America/New_York (Linux) ile Eastern Standard Time temsil edilir) şu anda standart saat sırasında UTC-05:00 ve yaz saati sırasında UTC-04:00 kullanır. Zamanlayıcı tetikleyicisinin her gün doğu saatiyle 10:00'da tetikleyebilmek için işlev uygulamanız için adlı WEBSITE_TIME_ZONEbir uygulama ayarı oluşturun, değeri Eastern Standard Time (Windows) veya America/New_York (Linux) olarak ayarlayın ve aşağıdaki NCRONTAB ifadesini kullanın:

"0 0 10 * * *"

Kullandığınızda WEBSITE_TIME_ZONE saat, gün ışığından yararlanma saati ve standart saat değişiklikleri de dahil olmak üzere belirli bir saat dilimindeki saat değişiklikleri için ayarlanır.

TimeSpan

yalnızca TimeSpan App Service Planı üzerinde çalışan bir işlev uygulaması için kullanılabilir.

NCRONTAB ifadelerinden farklı olarak, bir TimeSpan değer her işlev çağrısı arasındaki zaman aralığını belirtir. Belirtilen aralıktan daha uzun süre çalıştırıldıktan sonra bir işlev tamamlandığında, zamanlayıcı işlevi hemen yeniden çağırır.

Dize olarak ifade edilen biçim, TimeSpan 24'ten küçük olduğundadır hh:mm:ss hh . İlk iki basamak 24 veya daha büyük olduğunda, biçimi şeklindedir dd:hh:mm. Burada bazı örnekler verilmiştir:

Ölçeklendirme

Bir işlev uygulamasının ölçeği birden çok örneğe genişletilirse, tüm örneklerde zamanlayıcıyla tetiklenen bir işlevin yalnızca tek bir örneği çalıştırılır. Hala çalışan bekleyen bir çağrı varsa, yeniden tetiklenmez.

Depolamayı paylaşan işlev uygulamaları

Depolama hesaplarını app service'e dağıtılmayan işlev uygulamaları arasında paylaşıyorsanız, her uygulamaya açıkça konak kimliği atamanız gerekebilir.

Tanımlayıcı değeri atlayabilir veya her işlev uygulamasının tanımlayıcı yapılandırmasını farklı bir değere el ile ayarlayabilirsiniz.

Zamanlayıcı tetikleyicisi, bir işlev uygulamasının ölçeğini birden çok örneğe genişlettiğinde yalnızca bir zamanlayıcı örneği olduğundan emin olmak için bir depolama kilidi kullanır. İki işlev uygulaması aynı tanımlayıcı yapılandırmayı paylaşıyorsa ve her biri bir zamanlayıcı tetikleyicisi kullanıyorsa, yalnızca bir zamanlayıcı çalışır.

Yeniden deneme davranışı

Kuyruk tetikleyicisinin aksine, bir işlev başarısız olduktan sonra zamanlayıcı tetikleyicisi yeniden denemez. Bir işlev başarısız olduğunda, zamanlamada bir sonraki sefere kadar yeniden çağrılmaz.

Zamanlayıcı tetikleyicilerini el ile çağırma

Azure İşlevleri için zamanlayıcı tetikleyicisi, işlevi el ile tetikleme amacıyla çağrılabilen bir HTTP web kancası sağlar. Bu, aşağıdaki senaryolarda son derece yararlı olabilir.

• Tümleştirme testi
• Duman testi veya ısınma etkinliğinin parçası olarak yuva değiştirmeleri
• Veritabanındaki bir önbelleği veya arama tablosunu hemen doldurmak için bir işlevin ilk dağıtımı

Zamanlayıcıyla tetiklenen bir işlevi el ile çağırma hakkında ayrıntılı bilgi için lütfen HTTP ile tetiklenmeyen bir işlevi el ile çalıştırma bölümüne bakın.

Sorun giderme

Zamanlayıcı tetikleyicisi beklendiği gibi çalışmadığında yapılması gerekenler hakkında bilgi için bkz . Zamanlayıcı ile tetiklenen işlevlerin tetiklenmemesiyle ilgili sorunları araştırma ve raporlama.

Sonraki adımlar