Definování časových plánů pomocí syntaxe CRON
V systému Mervis je často potřeba plánovat opakovaně spouštěné automatizované úlohy – například určit, jak často bude DataNode komunikovat s externím API nebo databází. K definování těchto přesných časových plánů používá Mervis standardní syntaxi CRON.
Nejčastěji se s ní setkáte ve vlastnostech typu DataNode v poli `CommTaskCron`.
Struktura výrazu CRON
Výraz CRON je textový řetězec složený z pěti polí, která jsou oddělena mezerami. Každé pole představuje určitou časovou jednotku.
Standardní formát je:
* * * * *
Jednotlivá pole zleva doprava představují:
- Minuta (0–59)
- Hodina (0–23)
- Den v měsíci (1–31)
- Měsíc (1–12)
- Den v týdnu (0–7, kde hodnoty 0 i 7 představují neděli)
Speciální znaky
Pro vytváření flexibilních časových plánů můžete v jednotlivých polích použít následující speciální znaky:
- `*` (hvězdička): Představuje „každou“ nebo „libovolnou“ hodnotu. Pokud je hvězdička uvedena v poli Hodina, znamená to „každou hodinu“.
- `/` (lomítko): Slouží k určení intervalu (kroku). Například `*/15` v poli Minuta znamená „každých 15 minut“.
- `-` (pomlčka): Definuje rozsah hodnot. Například `9-17` v poli Hodina znamená „každou hodinu od 9:00 do 17:00“.
- `,` (čárka): Slouží k oddělení jednotlivých hodnot v seznamu. Například `1,3,5` v poli Den v týdnu znamená „v pondělí, ve středu a v pátek“.
Běžné příklady výrazů CRON
Níže naleznete přehled nejčastěji používaných výrazů CRON pro komunikaci DataNode a další automatizované úlohy:
| Výraz CRON | Popis / Časový plán |
|---|---|
| `0 */6 * * *` | Každých 6 hodin (v 0. minutě). (Jedná se o příklad zobrazený na obrázku výše.) |
| `* * * * *` | Každou minutu. |
| `*/5 * * * *` | Každých 5 minut. |
| `*/15 * * * *` | Každých 15 minut. |
| `0 * * * *` | Každou hodinu, vždy v 0. minutě. |
| `30 * * * *` | Každou hodinu, vždy ve 30. minutě. |
| `0 0 * * *` | Každý den o půlnoci (00:00). |
| `30 8 * * *` | Každý den v 8:30. |
| `0 8-18 * * *` | Každou hodinu mezi 8:00 a 18:00. |
| `0 8 * * 1-5` | Každý pracovní den (pondělí až pátek) v 8:00. |
| `0 0 * * 0` | Každou neděli o půlnoci. |
| `0 0 1 * *` | První den každého měsíce o půlnoci. |
Důležité upozornění: Při zápisu výrazů CRON věnujte pozornost mezerám mezi jednotlivými poli. Chybějící nebo přebytečná mezera způsobí, že nebude možné časový plán správně zpracovat.
Potřebujete pomoci s vytvořením časového plánu?
Pokud se vám syntaxe CRON zdá složitá, můžete využít některý z následujících online nástrojů, které za vás vytvoří správný výraz. Stačí v nich nastavit požadovaný časový plán a výsledný výraz zkopírovat do pole `CommTaskCron`.
- Crontab Generator – Jednoduché grafické rozhraní pro vytváření výrazů CRON.
- Crontab Online – Vhodné pro testování a ověřování správnosti výrazů.
- Cron Expression To Go – Užitečný nástroj pro vytváření běžných časových plánů, například „dvakrát denně“.