如何使用云函数的定时触发功能?

一、新建 config.json

1. 新建 config.json

在需要添加触发器的云函数目录下新建文件config.json,格式如下:

{
  // triggers 字段是触发器数组,目前仅支持一个触发器,即数组只能填写一个,不可添加多个
  "triggers": [
    {
      "name": "myTrigger",
      // type: 触发器类型,目前仅支持 timer (即 定时触发器)
      "type": "timer",
      // config: 触发器配置,在定时触发器下,config 格式为 cron 表达式,规则见下方说明
      "config": "0 0 2 1 * * *"
    }
  ]
}

在云函数的event中我们可以获取到定时器的信息。所以可以通过判断event.Type等于timer来判断是定时器触发的,通过event.TriggerName来判断是哪一个定时器。

2. 定时器Cron表达式详解

Cron表达式是一个字符串,字符串以56空格隔开,分为67个域,每一个域代表一个含义,Cron有如下两种语法格式。

基本格式

// 格式一
Seconds Minutes Hours DayofMonth Month DayofWeek Year

// 格式二
Seconds Minutes Hours DayofMonth Month DayofWeek

各字段的含义

字段 允许值 允许的特殊字符
秒(Seconds) 0~59的整数 , - * /
分(Minutes) 0~59的整数 , - * /
小时(Hours) 0~23的整数 , - * /
日期(DayofMonth) 1~31的整数(但是你需要考虑你月的天数) , - * / ? L W C
月份(Month) 1~12的整数或者 JAN-DEC , - * /
星期(DayofWeek) 1~7的整数或者 SUN-SAT (1=SUN) , - * / ? L C #
年(可选)(Year) 1970~2099 , - * /

关于特殊字符的意义

字符 含义 实例
* 匹配该域的任意值。比如在Seconds域使用*, 即表示每秒钟都会触发事件。
- 表示范围。比如在Minutes域使用5-20,表示从5分到20分钟每分钟触发一次。
/ 表示起始时间开始触发,然后每隔固定时间触发一次。例如在Minutes域使用5/20,则意味着5分钟触发一次,然后每个20分钟触发一次。 */5 * * * * *表示每五秒钟执行一次。
? 只能用在DayofMonthDayofWeek两个域。它也匹配域的任意值,但实际不会。因为DayofMonthDayofWeek会相互影响。例如想在每月的20日触发调度,不管20日到底是星期几,则只能使用如下写法: 13 13 15 20 * ?, 其中最后一位只能用,而不能使用*,如果使用*表示不管星期几都会触发,实际上并不是这样。

二、实例讲解

1、每隔2小时执行一次

0 0 */2 * * *

2、如何表达每隔90秒执行一次?

有的人觉得可以用*/90 * * * * *来表示,实际上是行不通的。斜杠后面的数字不能超过正确的时间表示。表如秒,最多就60,你赋予大于60的数字不会生效。

虽然*/2表示的意思是每两小时执行一次,但是你要记得把秒和分的位设为0(或者其它某个固定的数字)。否则用* * */2 * * *达不到预期效果。

比如有两个定时器:
1:*/5 * * * * *
2: 10/5 * * * * *
这两个定时器都是5秒钟触发一次,但是区别在于第一次的执行时间不一样。第一个定时器在执行后就会触发,然后每隔5秒钟触发一次。而第二个定时器必须要在X分10秒时第一次触发,然后每隔5秒钟触发一次。

三、上传触发器

这一步很多人都遗忘了,导致触发器没有生效!!!

640.png

三、定时触发器入参说明

定时触发器在触发函数时,会把如下的数据结构封装在event里传给云函数。同时,定时触发器支持自定义传入Message,缺省为空。

{
    "Type":"Timer",
    "TriggerName":"myTrigger",
    "Time":"2019-02-21T11:49:00Z",
    "Message":""
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容