AnalyticDB PostgreSQL版設定周期執行的計劃時,需要使用Cron運算式,本文為您介紹什麼是Cron運算式以及相關樣本。
Cron運算式是一個具有時間含義的字串,字串以5~6個空格隔開,分為6~7個域,格式為秒 分鐘 小時 日期 月份 星期 年
。最後一個代表年份的域非必須,可省略。單個域有多個取值時,使用半形逗號(,)隔開取值。每個域可以是確定的取值,也可以是萬用字元。
域取值
下表為Cron運算式中六個域的取值範圍以及支援的萬用字元。
域 | 是否必需 | 取值範圍 | 萬用字元 |
秒 | 是 | [0, 59] | * , - / |
分鐘 | 是 | [0, 59] | * , - / |
小時 | 是 | [0, 23] | * , - / |
日期 | 是 | [1, 31] | * , - / ? L W |
月份 | 是 | [1, 12]或[JAN, DEC] | * , - / |
星期 | 是 | [1, 7]或[MON, SUN]。若您使用[1, 7]表達方式,1 代表星期一,7 代表星期日。 | * , - / ? L # |
年 | 否 | [1970,2099] | * , - / |
萬用字元
Cron運算式中的每個域都支援萬用字元,每個萬用字元有其特殊含義。
萬用字元 | 含義 | 樣本 |
* | 所有值。 | 在月域中,* 表示每個月;在星期域中,* 表示星期的每一天。 |
, | 列出枚舉值。 | 在分鐘域中,5,20 表示分別在5分鐘和20分鐘觸發一次。 |
- | 範圍。 | 在分鐘域中,5-20 表示從5分鐘到20分鐘之間每分鐘觸發一次。 |
/ | 指定數值的增量。 | 在分鐘域中,0/15 表示從第0分鐘開始,每15分鐘觸發一次。3/20 表示從第3分鐘開始,每20分鐘觸發一次。 |
? | 不指定值。僅日期和星期域支援該字元。 | 當日期或星期域其中之一被指定了值以後,為了避免衝突,需要將另一個域的值設為? 。 |
L | 單詞Last的首字母,表示最後一天。僅日期和星期域支援該字元。 說明 指定 L 字元時,避免指定列表或者範圍,否則,會導致邏輯問題。 |
|
W | 除周末以外的工作日,在離指定日期的最近的工作日觸發事件。W 字元尋找最近工作日時不會跨過當前月份,連用字元LW 時表示為指定月份的最後一個工作日。僅日期域支援該字元。 | 在日期域中5W ,如果5日是星期六,則將在最近的工作日星期五,即4日觸發。如果5日是星期天,則將在最近的工作日星期一,即6日觸發。如果5日在星期一到星期五中的一天,則就在5日觸發。 |
# | 每個月第幾個星期幾。僅星期域支援該字元。 | 在星期域中,4#2 表示某月的第二個星期四。 |
樣本
以下為Cron運算式的取值樣本。
重要 計劃管理的Cron運算式使用的是UTC時間,實際使用時請將當地時間轉換成UTC時間。
情境 | 樣本(情境為UTC時間時) | 樣本(情境為北京時間時) |
每天上午10:15執行計畫 | 0 15 10 ? * * | 0 15 18 ? * * |
每天上午10:15執行計畫 | 0 15 10 * * ? | 0 15 18 * * ? |
每天中午12:00執行計畫 | 0 0 12 * * ? | 0 0 20 * * ? |
每天上午10:00點、下午14:00以及下午16:00執行計畫 | 0 0 10,14,16 * * ? | 0 0 18,22,0 * * ? |
每天上午09:00到下午17:00時間段內每隔半小時執行計畫 | 0 0/30 9-17 * * ? | 0 0/30 17-2 * * ? |
每天下午14:00到下午14:59時間段內每隔1分鐘執行計畫 | 0 * 14 * * ? | 0 * 22 * * ? |
每天下午14:00到下午14:05時間段內每隔1分鐘執行計畫 | 0 0-5 14 * * ? | 0 0-5 22 * * ? |
每天下午14:00到下午14:55時間段內每隔5分鐘執行計畫 | 0 0/5 14 * * ? | 0 0/5 22 * * ? |
每天下午14:00到下午14:55、下午18:00到下午18:55時間段內每隔5分鐘執行計畫 | 0 0/5 14,18 * * ? | 0 0/5 22,3 * * ? |
每個星期三中午12:00執行計畫 | 0 0 12 ? * WED | 0 0 20 ? * WED |
每月15日上午10:15執行計畫 | 0 15 10 15 * ? | 0 15 18 15 * ? |
每月最後一日上午10:15執行計畫 | 0 15 10 L * ? | 0 15 18 L * ? |
每月最後一個星期六上午10:15執行計畫 | 0 15 10 ? * 6L | 0 15 18 ? * 6L |
每月第三個星期六上午10:15執行計畫 | 0 15 10 ? * 6#3 | 0 15 18 ? * 6#3 |
每年3月的每個星期三下午14:10和14:44執行計畫 | 0 10,44 14 ? 3 WED | 0 10,44 22 ? 3 WED |
2022年每天上午10:15執行計畫 | 0 15 10 ? * * 2022 | 0 15 18 ? * * 2022 |
每年每天上午10:15執行計畫 | 0 15 10 ? * * * | 0 15 18 ? * * * |
2022年每天下午14:00到下午14:55、下午18:00到下午18:55時間段內每隔5分鐘執行計畫 | 0 0/5 14,18 * * ? 2022 | 0 0/5 22,3 * * ? 2022 |
2022年至2023年每月第三個星期六上午10:15執行計畫 | 0 15 10 ? * 6#3 2022,2023 | 0 15 18 ? * 6#3 2022,2023 |
2022年至2025年每天上午09:00到下午17:30時間段內每隔半小時執行計畫 | 0 0/30 9-17 * * ? 2022-2025 | 0 0/30 17-2 * * ? 2022-2025 |
從2022年開始,每隔兩年3月的每個星期三下午14:10和14:44執行計畫 | 0 10,44 14 ? 3 WED 2022/2 | 0 10,44 22 ? 3 WED 2022/2 |