Aviso:

Para brindarle información de soporte completa de manera más rápida, el contenido de esta página ha sido traducido al español mediante traducción automática. Para consultar la información de soporte más precisa, consulte la versión en inglés de este contenido.

Conceptos clave

En esta sección, revisaremos algunas definiciones y conceptos sobre el componente Cron para asegurarnos de que utilices cron de manera efectiva.

Tipos de Cron

Hay dos tipos de cron: Pre-Defined Cron y Dynamic Cron. La siguiente tabla ilustra sus diferencias y usos:

Criterio Pre-Defined Cron Dynamic Cron
Definición Estos crons se crean y configuran usando la funcionalidad Builder presente en la consola. Estos crons también pueden configurarse usando la funcionalidad Builder. Sin embargo, dado que estos crons están diseñados para crearse dinámicamente durante el runtime de producción, la práctica ideal es crear y configurar estos crons mediante código con el soporte de los Catalyst SDKs en Java, Node.js y Python.
Ventaja principal Puedes crear y configurar estos crons sin codificación adicional.
Estos crons pueden migrarse al entorno de producción cuando despliegues tu proyecto.
Dado que estos crons se crean dinámicamente durante el runtime, puedes crearlos y configurarlos mediante código.
Mayor flexibilidad para configurar el cron con precisión y satisfacer tu requisito.
Restricción principal A pesar de tener múltiples opciones de personalización, podría surgir la posibilidad de que encuentres restricciones menores en términos de satisfacer tu requisito con precisión.
Por ejemplo, no es posible permitir que los usuarios finales creen tu cron. La funcionalidad de este tipo de cron es más adecuada para propósitos estáticos.
Los crons creados en el entorno de desarrollo no se migrarán al entorno de producción cuando despliegues tu proyecto.
Compatibilidad con Cron Expression El Builder te proporciona opciones de formato que te permiten configurar la programación de estos crons usando Cron Expressions El Catalyst SDK soporta el uso de Cron Expressions para definir la programación del cron.
Ejemplos de casos de uso ideales Adecuado para cualquier tipo de caso de uso donde requieras un cron para programar y ejecutar tareas periódicamente bajo la suposición de condiciones preestablecidas.
También adecuado para casos de uso donde necesites que el cron creado en desarrollo esté presente durante la producción.
Puedes usar este tipo de cron para satisfacer cualquier tipo de caso de uso donde requieras que una acción particular ocurra en un momento particular.
Dado que estos crons se crean mediante código, te permite crear crons con mayor flexibilidad para emplear soluciones versátiles.

Cron ID

Cron ID es el identificador único generado por Catalyst cuando creas un cron Pre-defined o Dynamic. catalyst_job_scheduling_cron_id_high

Tipo de formato

Hay dos tipos de formato que puedes usar para configurar tu cron:

  • Standard: Standard es el tipo de formato que debes seleccionar si prefieres usar las opciones basadas en el calendario de la interfaz presentes en tu builder para configurar tu cron. catalyst_job_scheduling_cron_std_format_type

  • Cron Expression: Usas expresiones similares a regex para configurar tu cron. La expresión te permite configurar el cron de una manera más rápida. Además, te permite migrar fácilmente los crons que configuraste usando otros servicios al Cron de Job Scheduling. El uso de cron expressions también te proporciona más flexibilidad en la configuración de crons ya que tienes mayor libertad de entrada. catalyst_job_scheduling_cron_format_cron_exp

Nota: Ambos tipos de formato son compatibles con el Catalyst SDK. Puedes emplear el SDK relevante en Java, Node.js y Python y configurar tu cron mediante código.

Cron Expressions

Este es un tipo de formato que puedes elegir para configurar tu cron. Puedes usar estas expresiones especiales para proporcionar cinco entradas y completar la configuración de tu cron. catalyst_job_scheduling_cron_format_cron_express

Estudia esta sección cuidadosamente para utilizar las Cron Expressions correctamente.

Nota: Si cometes algún error de sintaxis al usar Cron Expressions, el cron no se ejecutará.

Campos de entrada presentes en las cron expressions

Campos de entrada Significado Valores posibles (Rango)
Mins Minutos del reloj 0-59
Hrs Horas del reloj o la hora en formato de 24 horas 0-23
Day(Month) Días del mes calendario 1-31
Month Meses presentes en un año calendario 1-12
Day(Week) Días de la semana 0-6 (0/6 puede ser domingo)

Caracteres especiales presentes en las Cron Expressions

Caracteres especiales Significado Ejemplo de uso
Asterisco (*) Todos los valores Un asterisco en el campo de entrada Mins significaría "Cada minuto"
Coma (,) Se usa para denotar valores específicos en una lista de valores Hay una lista de siete días en una semana. Entonces, si se ingresa 1,3,5 en el campo de entrada Days(Week), los números y la coma significarían lunes, miércoles y viernes
Guion (-) Se usa para denotar el rango completo de valores en una lista de valores Si ingresas el valor 1-3 en el campo de entrada Days(Week), la expresión significaría de lunes a miércoles.
Barra (/) Se usa para denotar incrementos repetitivos de un valor Si ingresas la expresión 0/15 en el campo de entrada Mins, la expresión significaría "Cada 15 minutos".
Almohadilla (#) Se usa para denotar 'el enésimo día' de la semana en el mes actual Si ingresas la expresión 6#3 en el campo de entrada Days (Week), significaría "El 3er viernes del mes actual"

Algunos ejemplos de configuración de crons usando Cron Expressions

Ejemplo 1

Requisito: Configurar un cron que se ejecute el 8.º día de diciembre del año actual a las 11:15 PM.

Solución: Dado que es un cron de una sola vez, no necesitamos usar caracteres especiales; solo los valores numéricos serían suficientes. La expresión se vería así:

catalyst_job_scheduling_cron_exp_eg_1

Ejemplo 2

Requisito: Configurar un cron recurrente que se ejecute cada 15 minutos durante todo el año de cada año.

Solución: Para lograr este cron, usaremos el carácter especial barra (/) de cron expression, con el valor 15 en la sección de entrada Mins.

catalyst_job_scheduling_cron_exp_eg_2

Ejemplo 3

Requisito: Configurar un cron recurrente que se ejecute cada minuto de las 3 PM el 6.º día de abril si cae en martes.

Solución: Para lograr este cron, usaremos el carácter especial Asterisco (*) junto con los valores de campo apropiados.

catalyst_job_scheduling_cron_exp_eg_3

Nota: Cuando configures un cron mediante código usando Cron Expressions, te recomendamos usar el Builder de la interfaz presente en la consola para confirmar si tu cron expression es correcta y cumple con tu requisito, y luego usarla en tu código.

Tipo de programación

El tipo de programación determina la frecuencia con la que un cron envía un job al job pool. Un cron puede programarse de dos maneras:

  • One Time: El cron programa el envío del job solo una vez en la fecha y hora configuradas.
  • Recursive: El envío de jobs por el cron se activa múltiples veces de forma recurrente según la frecuencia, fecha y hora que configures. Esta funcionalidad continuará hasta que lo deshabilites o elimines, o proporciones una condición de terminación. La frecuencia mínima de recurrencia con la que se puede activar un cron es de un minuto.

Última actualización 2026-03-20 21:51:56 +0530 IST