Creación de un desencadenador que ejecuta una canalización en una programación

SE APLICA A: Azure Data Factory Azure Synapse Analytics

En este artículo se proporciona información sobre el desencadenador de programación y los pasos para crear, iniciar y supervisar un desencadenador de programación. Para otros tipos de desencadenadores, consulte Ejecución y desencadenadores de canalización.

Al crear un desencadenador programado, se especifica una programación, como una fecha de inicio, una recurrencia o una fecha de finalización para el desencadenador, y se asocia a una canalización. Las canalizaciones y los desencadenadores tienen una relación de varios a varios. Varios desencadenadores pueden comenzar una única canalización. Un único desencadenador puede iniciar varias canalizaciones.

En las secciones siguientes se proporcionan los pasos necesarios para crear un desencadenador de programación de diferentes maneras.

Experiencia del portal de Azure Data Factory y Azure Synapse

Puede crear un desencadenador de programación para programar una canalización que se ejecute periódicamente, como cada hora o diariamente.

1. Cambie a la pestaña Editar de Data Factory o a la pestaña Integrar de Azure Synapse.

   • Azure Data Factory
   • Azure Synapse

   

2. Seleccione Trigger (Desencadenador) en el menú y, después, seleccione New/Edit (Nuevo/Editar).

   

3. En la página Agregar desencadenadores, seleccione Elegir desencadenador y luego seleccione Nuevo.

   

4. En la página Nuevo desencadenador:

   1. Asegúrese de que Programación está seleccionado para Tipo.

   2. Especifique la fecha y hora de inicio del desencadenador para Fecha de inicio. De forma predeterminada, se establece la fecha y hora actuales en la hora universal coordinada (UTC).

   3. Especifique la zona horaria en la que se crea el desencadenador. La configuración de zona horaria se aplica a Fecha de inicio, Fecha de finalización y Programación de tiempos de ejecución en Opciones de periodicidad avanzadas. Cambiar la configuración de la zona horaria no cambia automáticamente la fecha de inicio. Asegúrese de que la fecha de inicio es correcta en la zona horaria especificada. La hora de ejecución programada del desencadenador se considera posterior a la fecha de inicio. (Asegúrese de que la fecha de inicio sea al menos de 1 minuto que el tiempo de ejecución o de lo contrario desencadena la canalización en la siguiente periodicidad).

      Nota:

      En el caso de las zonas horarias que observan el horario de verano, el tiempo de desencadenador se ajusta automáticamente para el cambio de dos veces al año, si la periodicidad se establece en Días o superior. Para no participar en el cambio de horario de verano, seleccione una zona horaria que no observe el horario de verano, por ejemplo, UTC.

      El ajuste del horario de verano solo se produce para un desencadenador con la periodicidad establecida en Días o superior. Si el desencadenador se establece en la frecuencia Horas o Minutos, sigue activándose a intervalos regulares.

   4. Especifique Periodicidad para el desencadenador. Seleccione uno de los valores de la lista desplegable (Cada minuto, Cada hora, Diaria, Semanalo Mensual). Introduzca el multiplicador en el cuadro de texto. Por ejemplo, si desea que el desencadenador se ejecute una vez cada 15 minutos, seleccione Cada minuto y escriba 15 en el cuadro de texto.

   5. En Periodicidad, si selecciona Día(s), Semana(s) o Mes(es) en la lista desplegable, podrá ver las Opciones de periodicidad avanzadas.

      

   6. Para especificar una hora de finalización, seleccione Especificar una fecha de finalización. Especifique la información de Finaliza en y luego seleccione Aceptar.

      Un costo está asociado a cada ejecución de canalización. Si está probando, es posible que quiera asegurarse de que la canalización se desencadene solo un par de veces. No obstante, asegúrese de que hay tiempo suficiente para que la canalización se ejecute entre la hora de publicación y la hora de finalización. El desencadenador se aplica después de publicar la solución, no cuando se guarda en la interfaz de usuario.

      

      

5. En la ventana Nuevo desencadenador, seleccione Sí en la opción Activada y luego seleccione Aceptar. Puede utilizar esta casilla para desactivar el desencadenador más adelante.

   

6. En la ventana Nuevo desencadenador, revise el mensaje de advertencia y seleccione Aceptar.

   

7. Seleccione Publicar todo para publicar los cambios. El desencadenador no inicia las ejecuciones de canalización hasta que se publican los cambios.

   

8. Cambie a la pestaña Ejecuciones de canalización de la izquierda y seleccione Actualizar para actualizar la lista. Verá que el desencadenador programado ejecuta las ejecuciones de la canalización. Observe los valores de la columna Triggered By (Desencadenado por). Si usa la opción Desencadenar ahora, verá que el desencadenador manual se ejecuta en la lista.

   • Azure Data Factory
   • Azure Synapse

   

9. Cambie a la vista Ejecuciones de desencadenador>Programación.

   • Azure Data Factory
   • Azure Synapse

   

Azure PowerShell

En esta sección se muestra cómo usar Azure PowerShell para crear, iniciar y supervisar un desencadenador de la programación. Para ver que este ejemplo funciona, consulte primero Inicio rápido: crear una factoría de datos mediante Azure PowerShell. A continuación, agregue el código siguiente al método principal, de modo que se crea e inicia un desencadenador de programación que se ejecuta cada 15 minutos. El desencadenador está asociado a una canalización denominada Adfv2QuickStartPipeline que se crea como parte del inicio rápido.

Requisitos previos

• Suscripción de Azure. Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
• Azure PowerShell. Siga las instrucciones de Install Azure PowerShell on Windows with PowerShellGet (Instalar Azure PowerShell en Windows con PowerShellGet).

Código de ejemplo

1. Cree un archivo JSON llamado MyTrigger.json en la carpeta *C:\ADFv2QuickStartPSH* con el siguiente contenido:

   Importante

   Antes de guardar el archivo JSON, establezca el valor del elemento startTime en la hora UTC actual. Establezca el valor del elemento endTime en una hora más allá de la hora UTC actual.

   {
       "properties": {
           "name": "MyTrigger",
           "type": "ScheduleTrigger",
           "typeProperties": {
               "recurrence": {
                   "frequency": "Minute",
                   "interval": 15,
                   "startTime": "2017-12-08T00:00:00Z",
                   "endTime": "2017-12-08T01:00:00Z",
                   "timeZone": "UTC"
               }
           },
           "pipelines": [{
                   "pipelineReference": {
                       "type": "PipelineReference",
                       "referenceName": "Adfv2QuickStartPipeline"
                   },
                   "parameters": {
                       "inputPath": "adftutorial/input",
                       "outputPath": "adftutorial/output"
                   }
               }
           ]
       }
   }
   

   En el fragmento de código de JSON:

   • El elemento type del desencadenador se establece en ScheduleTrigger.

   • El elemento frequency se establece en Minute y el elemento interval se establece en 15. Por lo tanto, el desencadenador ejecuta la canalización cada 15 minutos entre las horas de inicio y finalización.

   • El elemento timeZone especifica la zona horaria en la que se crea el desencadenador. Esta configuración afecta tanto a startTime como a endTime.

   • El elemento endTime es una hora después del valor del elemento startTime. Por lo tanto, el desencadenador ejecuta la canalización 15 minutos, 30 minutos y 45 minutos después de la hora de inicio. No olvide actualizar la hora de inicio a la hora UTC actual y la hora de finalización a una hora más allá de la hora de inicio.

     Importante

     Para la zona horaria UTC, startTime y endTime deben seguir el formato yyyy-MM-ddTHH:mm:ssZ. Para otras zonas horarias, startTime y endTime siguen el formato yyyy-MM-ddTHH:mm:ss.

     Según el estándar ISO 8601, el sufijo Z se usa para marcar la marca de tiempo de la fecha y hora a la zona horaria UTC y hacer que el campo timeZone sea inútil. Si falta el sufijo Z para la zona horaria UTC, el resultado es un error al desencadenar activación.

   • El desencadenador está asociado a la canalización de Adfv2QuickStartPipeline. Para asociar varias canalizaciones a un desencadenador, agregue más secciones pipelineReference.

   • La canalización del inicio rápido toma dos valores de parameters: inputPath y outputPath. Estos parámetros se pasan desde el desencadenador.

2. Cree un desencadenador mediante el cmdlet Set-AzDataFactoryV2Trigger:

   Set-AzDataFactoryV2Trigger -ResourceGroupName $ResourceGroupName -DataFactoryName $DataFactoryName -Name "MyTrigger" -DefinitionFile "C:\ADFv2QuickStartPSH\MyTrigger.json"
   

3. Confirme que el estado del desencadenador es Detenido mediante el cmdlet Get-AzDataFactoryV2Trigger:

   Get-AzDataFactoryV2Trigger -ResourceGroupName $ResourceGroupName -DataFactoryName $DataFactoryName -Name "MyTrigger"
   

4. Inicie el desencadenador mediante el cmdlet Start-AzDataFactoryV2Trigger:

   Start-AzDataFactoryV2Trigger -ResourceGroupName $ResourceGroupName -DataFactoryName $DataFactoryName -Name "MyTrigger"
   

5. Confirme que el estado del desencadenador es Iniciado mediante el cmdlet Get-AzDataFactoryV2Trigger:

   Get-AzDataFactoryV2Trigger -ResourceGroupName $ResourceGroupName -DataFactoryName $DataFactoryName -Name "MyTrigger"
   

6. Haga que el desencadenador se ejecute en Azure PowerShell mediante el cmdlet Get-AzDataFactoryV2TriggerRun. Para obtener información acerca de cómo se ejecuta el desencadenador, ejecute el siguiente comando periódicamente. Actualice los valores de TriggerRunStartedAfter y TriggerRunStartedBefore para que coincidan con los valores de la definición del desencadenador:

   Get-AzDataFactoryV2TriggerRun -ResourceGroupName $ResourceGroupName -DataFactoryName $DataFactoryName -TriggerName "MyTrigger" -TriggerRunStartedAfter "2017-12-08T00:00:00" -TriggerRunStartedBefore "2017-12-08T01:00:00"
   

   Nota:

   La hora de desencadenado de los desencadenadores programados se especifica en la marca de tiempo UTC. TriggerRunStartedAfter y TriggerRunStartedBefore también esperan la marca de tiempo UTC.

   Para supervisar las ejecuciones del desencadenador y de la canalización en Azure Portal, consulte la sección acerca de la supervisión de ejecuciones de canalización.

CLI de Azure

En esta sección se muestra cómo usar la CLI de Azure para crear, iniciar y supervisar un desencadenador programado. Para ver que este ejemplo funciona, consulte primero Inicio rápido: crear un Azure Data Factory mediante la CLI de Azure. A continuación, siga los pasos para crear e iniciar un desencadenador programado que se ejecute cada 15 minutos. El desencadenador está asociado a una canalización denominada Adfv2QuickStartPipeline que se crea como parte del inicio rápido.

Requisitos previos

• Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.

  

• Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.

  • Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.

  • En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.

  • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

Código de ejemplo

1. En su directorio de trabajo, cree un archivo JSON llamado MyTrigger.json con las propiedades del desencadenador. En este ejemplo, use el siguiente contenido:

   Importante

   Antes de guardar el archivo JSON, establezca el valor del elemento startTime en la hora UTC actual. Establezca el valor del elemento endTime en una hora más allá de la hora UTC actual.

   {
       "name": "MyTrigger",
       "type": "ScheduleTrigger",
       "typeProperties": {
           "recurrence": {
               "frequency": "Minute",
               "interval": 15,
               "startTime": "2017-12-08T00:00:00Z",
               "endTime": "2017-12-08T01:00:00Z",
               "timeZone": "UTC"
           }
       },
       "pipelines": [{
               "pipelineReference": {
                   "type": "PipelineReference",
                   "referenceName": "Adfv2QuickStartPipeline"
               },
               "parameters": {
                   "inputPath": "adftutorial/input",
                   "outputPath": "adftutorial/output"
               }
           }
       ]
   }
   

   En el fragmento de código de JSON:

   • El elemento type del desencadenador se establece en ScheduleTrigger.

   • El elemento frequency se establece en Minute y el elemento interval se establece en 15. Por lo tanto, el desencadenador ejecuta la canalización cada 15 minutos entre las horas de inicio y finalización.

   • El elemento timeZone especifica la zona horaria en la que se crea el desencadenador. Esta configuración afecta tanto a startTime como a endTime.

   • El elemento endTime es una hora después del valor del elemento startTime. Por lo tanto, el desencadenador ejecuta la canalización 15 minutos, 30 minutos y 45 minutos después de la hora de inicio. No olvide actualizar la hora de inicio a la hora UTC actual y la hora de finalización a una hora más allá de la hora de inicio.

     Importante

     Para la zona horaria UTC, el startTime y endTime deben seguir el formato yyyy-MM-ddTHH:mm:ssZ. Para otras zonas horarias, startTime y endTime siguen el formato yyyy-MM-ddTHH:mm:ss.

     Según el estándar ISO 8601, el sufijo Z se usa para marcar la marca de tiempo de la fecha y hora a la zona horaria UTC y representar el campo timeZone inútil. Si falta el sufijo de Z para la zona horaria UTC, el resultado es un error al desencadenar activación.

   • El desencadenador está asociado a la canalización de Adfv2QuickStartPipeline. Para asociar varias canalizaciones a un desencadenador, agregue más secciones pipelineReference.

   • La canalización del inicio rápido toma dos valores de parameters: inputPath y outputPath. Estos parámetros se pasan desde el desencadenador.

2. Cree un desencadenador utilizando el comando az datafactory trigger create:

   az datafactory trigger create --resource-group "ADFQuickStartRG" --factory-name "ADFTutorialFactory"  --name "MyTrigger" --properties @MyTrigger.json  
   

3. Confirme que el estado del desencadenador es Detenido utilizando el comando az datafactory trigger show:

   az datafactory trigger show --resource-group "ADFQuickStartRG" --factory-name "ADFTutorialFactory" --name "MyTrigger" 
   

4. Inicie el desencadenador utilizando el comando az datafactory trigger start:

   az datafactory trigger start --resource-group "ADFQuickStartRG" --factory-name "ADFTutorialFactory" --name "MyTrigger" 
   

5. Confirme que el estado del desencadenador es Iniciado utilizando el comando az datafactory trigger show:

   az datafactory trigger show --resource-group "ADFQuickStartRG" --factory-name "ADFTutorialFactory" --name "MyTrigger" 
   

6. Obtenga las ejecuciones del desencadenador en la CLI de Azure mediante el comando az datafactory trigger-run query-by-factory. Para obtener información sobre cómo se ejecuta el desencadenador, ejecute el siguiente comando periódicamente. Actualice los valores de last-updated-after y last-updated-before para que coincidan con los valores de la definición del desencadenador:

   az datafactory trigger-run query-by-factory --resource-group "ADFQuickStartRG" --factory-name "ADFTutorialFactory" --filters operand="TriggerName" operator="Equals" values="MyTrigger" --last-updated-after "2017-12-08T00:00:00" --last-updated-before "2017-12-08T01:00:00"
   

   Nota:

   Las horas de desencadenador de los desencadenadores programados se especifican en la marca de tiempo UTC. last-updated-after y last-updated-before también esperan una marca de tiempo UTC.

   Para supervisar las ejecuciones del desencadenador y de la canalización en Azure Portal, consulte la sección acerca de la supervisión de ejecuciones de canalización.

.NET SDK

En esta sección se muestra cómo usar el SDK de.NET para crear, iniciar y supervisar un desencadenador. Para ver que este ejemplo funciona, consulte primero Inicio rápido: Creación crear una factoría de datos mediante el SDK de .NET. A continuación, agregue el código siguiente al método principal, de modo que se crea e inicia un desencadenador de programación que se ejecuta cada 15 minutos. El desencadenador está asociado a una canalización denominada Adfv2QuickStartPipeline que se crea como parte del inicio rápido.

Para crear e iniciar un desencadenador de programación que se ejecuta cada 15 minutos, agregue el código siguiente al método principal:

            // Create the trigger
            Console.WriteLine("Creating the trigger");

            // Set the start time to the current UTC time
            DateTime startTime = DateTime.UtcNow;

            // Specify values for the inputPath and outputPath parameters
            Dictionary<string, object> pipelineParameters = new Dictionary<string, object>();
            pipelineParameters.Add("inputPath", "adftutorial/input");
            pipelineParameters.Add("outputPath", "adftutorial/output");

            // Create a schedule trigger
            string triggerName = "MyTrigger";
            ScheduleTrigger myTrigger = new ScheduleTrigger()
            {
                Pipelines = new List<TriggerPipelineReference>()
                {
                    // Associate the Adfv2QuickStartPipeline pipeline with the trigger
                    new TriggerPipelineReference()
                    {
                        PipelineReference = new PipelineReference(pipelineName),
                        Parameters = pipelineParameters,
                    }
                },
                Recurrence = new ScheduleTriggerRecurrence()
                {
                    // Set the start time to the current UTC time and the end time to one hour after the start time
                    StartTime = startTime,
                    TimeZone = "UTC",
                    EndTime = startTime.AddHours(1),
                    Frequency = RecurrenceFrequency.Minute,
                    Interval = 15,
                }
            };

            // Now, create the trigger by invoking the CreateOrUpdate method
            TriggerResource triggerResource = new TriggerResource()
            {
                Properties = myTrigger
            };
            client.Triggers.CreateOrUpdate(resourceGroup, dataFactoryName, triggerName, triggerResource);

            // Start the trigger
            Console.WriteLine("Starting the trigger");
            client.Triggers.Start(resourceGroup, dataFactoryName, triggerName);

Para crear desencadenadores en una zona horaria diferente, aparte de UTC, se requiere la siguiente configuración:

<<ClientInstance>>.SerializationSettings.DateFormatHandling = Newtonsoft.Json.DateFormatHandling.IsoDateFormat;
<<ClientInstance>>.SerializationSettings.DateTimeZoneHandling = Newtonsoft.Json.DateTimeZoneHandling.Unspecified;
<<ClientInstance>>.SerializationSettings.DateParseHandling = DateParseHandling.None;
<<ClientInstance>>.DeserializationSettings.DateParseHandling = DateParseHandling.None;
<<ClientInstance>>.DeserializationSettings.DateFormatHandling = Newtonsoft.Json.DateFormatHandling.IsoDateFormat;
<<ClientInstance>>.DeserializationSettings.DateTimeZoneHandling = Newtonsoft.Json.DateTimeZoneHandling.Unspecified;

Para supervisar una ejecución de desencadenador, agregue el código siguiente a la última instrucción Console.WriteLine del ejemplo:

            // Check that the trigger runs every 15 minutes
            Console.WriteLine("Trigger runs. You see the output every 15 minutes");

            for (int i = 0; i < 3; i++)
            {
                System.Threading.Thread.Sleep(TimeSpan.FromMinutes(15));
                List<TriggerRun> triggerRuns = client.Triggers.ListRuns(resourceGroup, dataFactoryName, triggerName, DateTime.UtcNow.AddMinutes(-15 * (i + 1)), DateTime.UtcNow.AddMinutes(2)).ToList();
                Console.WriteLine("{0} trigger runs found", triggerRuns.Count);

                foreach (TriggerRun run in triggerRuns)
                {
                    foreach (KeyValuePair<string, string> triggeredPipeline in run.TriggeredPipelines)
                    {
                        PipelineRun triggeredPipelineRun = client.PipelineRuns.Get(resourceGroup, dataFactoryName, triggeredPipeline.Value);
                        Console.WriteLine("Pipeline run ID: {0}, Status: {1}", triggeredPipelineRun.RunId, triggeredPipelineRun.Status);
                        List<ActivityRun> runs = client.ActivityRuns.ListByPipelineRun(resourceGroup, dataFactoryName, triggeredPipelineRun.RunId, run.TriggerRunTimestamp.Value, run.TriggerRunTimestamp.Value.AddMinutes(20)).ToList();
                    }
                }
            }

Para supervisar las ejecuciones del desencadenador y de la canalización en Azure Portal, consulte la sección acerca de la supervisión de ejecuciones de canalización.

SDK de Python

En esta sección se muestra cómo usar el SDK de Python para crear, iniciar y supervisar un desencadenador. Para ver este ejemplo en funcionamiento, consulte primero Inicio rápido: crear una factoría de datos mediante el SDK de Python. A continuación, agregue el siguiente bloque de código después del bloque de código monitor the pipeline run en el script de Python. Este código crea un desencadenador de programación que se ejecuta cada 15 minutos entre las horas de inicio y finalización especificadas. Actualice la variable start_time a la hora UTC actual y la variable end_time a una hora más allá de la hora UTC actual.

    # Create a trigger
    tr_name = 'mytrigger'
    scheduler_recurrence = ScheduleTriggerRecurrence(frequency='Minute', interval='15',start_time='2017-12-12T04:00:00Z', end_time='2017-12-12T05:00:00Z', time_zone='UTC')
    pipeline_parameters = {'inputPath':'adftutorial/input', 'outputPath':'adftutorial/output'}
    pipelines_to_run = []
    pipeline_reference = PipelineReference('copyPipeline')
    pipelines_to_run.append(TriggerPipelineReference(pipeline_reference, pipeline_parameters))
    tr_properties = TriggerResource(properties=ScheduleTrigger(description='My scheduler trigger', pipelines = pipelines_to_run, recurrence=scheduler_recurrence))
    adf_client.triggers.create_or_update(rg_name, df_name, tr_name, tr_properties)

    # Start the trigger
    adf_client.triggers.start(rg_name, df_name, tr_name)

Para supervisar las ejecuciones del desencadenador y de la canalización en Azure Portal, consulte la sección acerca de la supervisión de ejecuciones de canalización.

Plantilla del Administrador de recursos de Azure

Puede usar una plantilla de Azure Resource Manager para crear un desencadenador. Para obtener instrucciones paso a paso, consulte Crear una factoría de datos de Azure mediante una plantilla de Azure Resource Manager.

Transmisión de la hora de inicio del desencadenador a una canalización

La versión 1 de Azure Data Factory admite la lectura o escritura de datos con particiones mediante las variables del sistema SliceStart, SliceEnd, WindowStarty WindowEnd. En la versión actual de las canalizaciones de Data Factory y Azure Synapse, puede lograr este comportamiento mediante un parámetro de canalización. La hora de inicio y la hora programada para el desencadenador se establecen como el valor del parámetro de la canalización. En el ejemplo siguiente, la hora programada para el desencadenador se pasa como un valor al parámetro de canalización scheduledRunTime:

"parameters": {
    "scheduledRunTime": "@trigger().scheduledTime"
}

Esquema JSON

La siguiente definición de JSON le muestra cómo crear un desencadenador de programación con la programación y periodicidad:

{
  "properties": {
    "type": "ScheduleTrigger",
    "typeProperties": {
      "recurrence": {
        "frequency": <<Minute, Hour, Day, Week, Month>>,
        "interval": <<int>>,             // Optional, specifies how often to fire (default to 1)
        "startTime": <<datetime>>,
        "endTime": <<datetime - optional>>,
        "timeZone": "UTC"
        "schedule": {                    // Optional (advanced scheduling specifics)
          "hours": [<<0-23>>],
          "weekDays": [<<Monday-Sunday>>],
          "minutes": [<<0-59>>],
          "monthDays": [<<1-31>>],
          "monthlyOccurrences": [
               {
                    "day": <<Monday-Sunday>>,
                    "occurrence": <<1-5>>
               }
           ]
        }
      }
    },
   "pipelines": [
            {
                "pipelineReference": {
                    "type": "PipelineReference",
                    "referenceName": "<Name of your pipeline>"
                },
                "parameters": {
                    "<parameter 1 Name>": {
                        "type": "Expression",
                        "value": "<parameter 1 Value>"
                    },
                    "<parameter 2 Name>" : "<parameter 2 Value>"
                }
           }
      ]
  }
}

Información general del esquema

En la tabla siguiente se proporciona información general de alto nivel de los elementos de esquema principales relacionados con la periodicidad y la programación de un desencadenador.

Valores predeterminados del esquema, límites y ejemplos

Opción de zona horaria

Estas son algunas de las zonas horarias compatibles con los desencadenadores programados.

Esta lista está incompleta. Para obtener una lista completa de las opciones de zona horaria, consulte la página Crear desencadenadores en el portal.

Propiedad startTime

En la tabla siguiente se muestra cómo la propiedad startTime controla una ejecución de desencadenador.

Veamos un ejemplo de lo que sucede cuando startTime se encuentra en el pasado, con periodicidad, pero sin programación. Suponga que la hora actual es 2017-04-08 13:00, la hora de inicio es 2017-04-07 14:00, y la periodicidad es cada dos días. (El valor recurrence se define estableciendo la propiedad frequency en day y la propiedad interval en 2). Observe que el valor startTime está en el pasado y se produce antes de la hora actual.

En estas condiciones, la primera ejecución será el 2017-04-09 a las 14:00. El motor de Scheduler calcula las repeticiones de la ejecución desde la hora de inicio. Se descartan las instancias en el pasado. El motor utiliza la instancia siguiente que tiene lugar en el futuro. En este escenario, la hora de inicio será el 2017-04-07 a las 2:00pm, así que la siguiente instancia es dos días a partir de ese momento, que es el 2017-04-09 a las 2:00pm.

La primera vez de ejecución es la misma incluso si el valor startTime es 2017-04-05 14:00 o 2017-04-01 14:00. Después de la primera ejecución, las ejecuciones posteriores se calculan mediante la programación. Por lo tanto, las ejecuciones posteriores se realizan el 2017-04-11 a las 2:00pm, después el 2017-04-13 a las 2:00pm, después el 2017-04-15 a las 2:00pm y así sucesivamente.

Por último, cuando las horas o minutos no se establecen en la programación de un desencadenador, las horas o minutos de la primera ejecución se usan como valores predeterminados.

Propiedad schedule

El uso de una programación puede limitar el número de ejecuciones de desencadenadores. Por ejemplo, si un desencadenador con frecuencia mensual tiene un valor programado para ejecutarse solo el día 31, el desencadenador se ejecuta solo en los meses que tienen 31 días.

Una programación también puede expandir el número de ejecuciones de desencadenadores. Por ejemplo, un desencadenador con una frecuencia mensual programado para ejecutarse en los días primero y segundo del mes, se ejecuta el primer y segundo día del mes, en lugar de una vez al mes.

Si se especifican varios elementos schedule, el orden de evaluación es del valor de programación más grande al más pequeño. La evaluación comienza con el número de semana y luego el día del mes, el día de la semana, la hora y, por último, el minuto.

En la tabla siguiente se describen los elementos schedule en detalle.

Ejemplos de programaciones de periodicidad del desencadenador

En esta sección se proporcionan ejemplos de programaciones de periodicidad y se centra en el objeto schedule y sus elementos.

En los ejemplos se supone que el interval valor es 1 y que el valor frequency es correcto según la definición de programación. Por ejemplo, no puede tener un valor frequency de day y también tener una modificación monthDays en el objeto schedule. Restricciones como estas se mencionan en la tabla de la sección anterior.

Contenido relacionado

• Para obtener más información sobre los desencadenadores, consulte ejecución y desencadenadores de canalización.
• Para obtener información sobre cómo hacer referencia a metadatos de desencadenador en la canalización, consulte Referencia de metadatos de desencadenador en ejecuciones de canalización.