Conector Cron

Descripción General

El conector Cron programa la liberación de datos basándose en expresiones cron.

Tipo de Conector: MeddleCron

Modo Por Defecto

Liberar todos los datos acumulados en momentos programados:

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

Modo Clave Única

Deduplicar datos por clave antes de la liberación:

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

Modo Clave Única Mantener Faltantes

Deduplicar pero mantener registros sin la clave única:

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

Formato de Expresión Cron

Formato: segundo minuto hora día mes día_semana

Expresiones Comunes

0 */5 * * * *      Cada 5 minutos
0 0 * * * *        Cada hora
0 0 0 * * *        Cada día a medianoche
0 30 9 * * 1-5     A las 9:30 AM en días laborables
0 0 12 * * 0       Al mediodía los domingos
0 0 */6 * * *      Cada 6 horas
0 15 10 * * *      A las 10:15 AM todos los días

Valores de Campo

• Segundo: 0-59
• Minuto: 0-59
• Hora: 0-23
• Día: 1-31
• Mes: 1-12
• Día de la Semana: 0-6 (0 = Domingo)

Caracteres Especiales

• * - Cualquier valor
• */n - Cada n unidades
• n-m - Rango de n a m
• n,m - Valores específicos

Parámetros de Configuración

• mode: Default, UniqueKey o UniqueKeyKeepMissing
• expression: Expresión cron
• maxRetained: Máximo de cargas a retener en memoria
• timezone: Zona horaria para programación (ej., “Europe/Rome”, “America/New_York”)
• uniqueKey: (Modos UniqueKey) Campo a usar para deduplicación

Casos de Uso

1. Informes por Hora

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

2. Procesamiento por Lotes Diario

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

3. Solo Horario Laboral

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

Mejores Prácticas

• Establece maxRetained para prevenir problemas de memoria
• Usa modo UniqueKey para evitar datos duplicados
• Elige zona horaria apropiada para tu caso de uso
• Prueba expresiones con calculadoras cron en línea

Conectores Relacionados

• Merge - Combinación de datos basada en tiempo
• Filter - Filtrar antes de programar