文档首页/ 函数工作流 FunctionGraph/ 用户指南/ 配置函数/ 配置函数的触发器/ 使用定时触发器
更新时间：2024-12-16 GMT+08:00
查看PDF
分享

使用定时触发器

关于定时触发器事件源具体介绍请参见支持的事件源。

前提条件

已经创建函数，创建过程请参见创建函数。

创建定时触发器

  1. 登录函数工作流控制台，在左侧的导航栏选择“函数 > 函数列表”。
  2. 选择待配置的函数，单击进入函数详情页。
  3. 选择“设置 > 触发器”，单击“创建触发器”，弹出“创建触发器”对话框。

    图1 创建触发器

  4. 设置以下信息。

    • 触发器类型：选择“定时触发器 (TIMER)”。
    • 定时器名称：您自定义的定时器名称，例如：Timer。
    • 触发规则：固定频率和Cron表达式。
      • 固定频率：固定时间间隔触发函数，该类型下支持配置单位为分、时、天，每种类型仅支持整数配置，其中分钟支持范围(0，60]，小时支持范围(0，24]，天支持范围(0，30]。
      • Cron表达式：设置更为复杂的函数执行计划，例如：周一到周五上午08:30:00执行函数等，具体请参见Cron表达式规则。
    • 是否开启：是否开启定时触发器。
    • 附加信息：如果用户配置了触发事件，会将该事件填写到TIMER事件源的“user_event”字段，详情请参见支持的事件源。

  5. 单击“确定”，完成定时触发器的创建。

查看函数运行结果

函数的定时触发器创建以后，每隔一分钟执行一次函数，可以查看函数运行日志。

  1. 返回函数工作流控制台，在左侧的导航栏选择“函数 > 函数列表”。
  2. 选择函数，单击进入函数详情页。
  3. 选择“监控 > 日志”，查询函数运行日志。

Cron表达式规则

函数Cron表达式下支持如下几种配置方式。
  • @every格式

    @every NUnit，其中N表示一个正整数，Unit可以为ns, µs, ms, s, m, h，表示每隔N个Unit时间触发一次函数如表1所示。

    表1 表达式示例

    表达式

    含义

    @every 30m

    每隔30分钟触发一次函数

    @every 1.5h

    每隔1.5小时触发一次函数

    @every 2h30m

    每隔2小时30分钟触发一次函数
  • 标准cron表达式

    cron表达式格式要求“秒 分 时 日 月 周(可选)”，每个字段间以空格隔开，其中各字段说明如表2所示。

    表2 cron表达式字段说明

    字段

    说明

    取值范围

    允许的特殊字符

    CRON_TZ

    可选。不设置则默认使用region所在时区。

    -

    -

    秒

    必选

    0-59

    , - * /

    分钟

    必选

    0-59

    , - * /

    时

    必选

    0-23

    , - * /

    日(Day of month)

    必选

    1-31

    , - * ? /

    月

    必选

    1-12或者Jan-Dec（英文不区分大小写）如表3所示。

    , - * /

    星期几(Day of week)

    可选

    0-6或者Sun-Sat（0表示星期天，英文不区分大小写），如表4所示。

    , - * ? /
    表3 月份字段取值说明

    月份

    数字

    英文简写

    1月

    1

    Jan

    2月

    2

    Feb

    3月

    3

    Mar

    4月

    4

    Apr

    5月

    5

    May

    6月

    6

    Jun

    7月

    7

    Jul

    8月

    8

    Aug

    9月

    9

    Sep

    10月

    10

    Oct

    11月

    11

    Nov

    12月

    12

    Dec
    表4 星期字段取值说明

    星期

    数字

    英文简写

    星期一

    1

    Mon

    星期二

    2

    Tue

    星期三

    3

    Wed

    星期四

    4

    Thu

    星期五

    5

    Fri

    星期六

    6

    Sat

    星期日

    0

    Sun

    cron表达式字段特殊字符说明如表5所示。

    表5 特殊字符说明

    特殊字符

    含义

    说明

    *

    表示该字段中的所有值

    在“分钟”字段中表示每一分钟都执行。

    ,

    指定多个值（可以不连续）

    在“月”字段中指定“Jan,Apr,Jul,Oct”或者“1,4,7,10”，表示1月，4月，7月和10月，在“星期几”字段中指定“Sat,Sun”或者“6,0”表示周六，周日。

    -

    指定一个范围

    在“分钟”字段中使用0-3，表示从0分到3分

    ?

    指定一个或另一个

    仅“日”和“星期几”字段可以指定。例如，如果指定了一个特定的日期，但你不关心该日期对应星期几，那么“星期几”字段就可以使用该特殊字符。

    /

    表示起步和步幅，n/m表示从n开始，每次增加m

    在“分钟”字段1/3表示在满足其它字段情况下，从时间1分（例如00:01:00）开始，每隔3分钟触发一次。

    cron表达式配置示例如表6所示。

    表6 cron表达式配置示例

    配置实例

    Cron 表达式（以北京时区为例）

    每天12点调度函数

    CRON_TZ=Asia/Shanghai 0 0 12 * * *

    每天12:30调度函数

    CRON_TZ=Asia/Shanghai 0 30 12 * * *

    每小时的26分，29分，33分调度函数

    CRON_TZ=Asia/Shanghai 0 26,29,33 * * * *

    周一到周五的每天12:30调度函数

    CRON_TZ=Asia/Shanghai 0 30 12 ? * MON-FRI

    周一到周五的每天12:00～14:59每5分钟调度函数

    CRON_TZ=Asia/Shanghai 0 0/5 12-14 ? * MON-FRI

    一月到四月每天12:00调度函数

    CRON_TZ=Asia/Shanghai 0 0 12 ? JAN,FEB,MAR,APR *

    Cron表达式未设置时，默认以region所在时区运行。如果您的任务需要按照特定时区运行，可以通过CRON_TZ指定，例如在北京时间每个月一号的04:00触发函数执行，则可以使用CRON_TZ=Asia/Shanghai 0 0 4 1 * *。不同地域的时区表达式存在差异，请以实际情况为准。

相关文档