Connettore Cron

Panoramica

Il connettore Cron pianifica il rilascio dati basato su espressioni cron.

Tipo Connettore: MeddleCron

Modalità Default

Rilascia tutti i dati accumulati agli orari pianificati:

{
  "type": "MeddleCron",
  "config": {
    "mode": "Default",
    "expression": "0 */5 * * * *",
    "maxRetained": 100,
    "timezone": "Europe/Rome"
  }
}

Modalità Unique Key

Deduplica i dati per chiave prima del rilascio:

{
  "type": "MeddleCron",
  "config": {
    "mode": "UniqueKey",
    "expression": "0 0 * * * *",
    "uniqueKey": "sensor_id",
    "maxRetained": 1000
  }
}

Modalità Unique Key Keep Missing

Deduplica ma mantieni i record senza la chiave univoca:

{
  "type": "MeddleCron",
  "config": {
    "mode": "UniqueKeyKeepMissing",
    "expression": "0 30 * * * *",
    "uniqueKey": "device_id",
    "maxRetained": 500
  }
}

Formato Espressione Cron

Formato: secondo minuto ora giorno mese giornosettimana

Espressioni Comuni

0 */5 * * * *      Ogni 5 minuti
0 0 * * * *        Ogni ora
0 0 0 * * *        Ogni giorno a mezzanotte
0 30 9 * * 1-5     Alle 9:30 nei giorni feriali
0 0 12 * * 0       A mezzogiorno la domenica
0 0 */6 * * *      Ogni 6 ore
0 15 10 * * *      Alle 10:15 ogni giorno

Valori Campi

• Secondo: 0-59
• Minuto: 0-59
• Ora: 0-23
• Giorno: 1-31
• Mese: 1-12
• Giorno Settimana: 0-6 (0 = Domenica)

Caratteri Speciali

• * - Qualsiasi valore
• */n - Ogni n unità
• n-m - Intervallo da n a m
• n,m - Valori specifici

Parametri di Configurazione

• mode: Default, UniqueKey, o UniqueKeyKeepMissing
• expression: Espressione cron
• maxRetained: Massimo payload da mantenere in memoria
• timezone: Fuso orario per la pianificazione (es. “Europe/Rome”, “America/New_York”)
• uniqueKey: (Modalità UniqueKey) Campo da usare per la deduplicazione

Casi d’Uso

1. Report Orari

{
  "type": "MeddleCron",
  "config": {
    "mode": "Default",
    "expression": "0 0 * * * *",
    "maxRetained": 1000,
    "timezone": "UTC"
  }
}

2. Elaborazione Batch Giornaliera

{
  "type": "MeddleCron",
  "config": {
    "mode": "UniqueKey",
    "expression": "0 0 0 * * *",
    "uniqueKey": "machine_id",
    "maxRetained": 5000
  }
}

3. Solo Orario Lavorativo

{
  "type": "MeddleCron",
  "config": {
    "mode": "Default",
    "expression": "0 0 9-17 * * 1-5",
    "maxRetained": 500,
    "timezone": "Europe/Rome"
  }
}

Best Practice

• Imposta maxRetained per prevenire problemi di memoria
• Usa modalità UniqueKey per evitare dati duplicati
• Scegli il fuso orario appropriato per il tuo caso d’uso
• Testa le espressioni con calcolatori cron online

Connettori Correlati

• Merge - Combinazione dati basata sul tempo
• Filter - Filtra prima della pianificazione