Создание триггера, который запускает конвейер по расписанию

ОБЛАСТЬ ПРИМЕНЕНИЯ: Фабрика данных Azure Azure Synapse Analytics

В этой статье описан триггер расписания и шаги по его созданию, запуску и мониторингу. Сведения о других типах триггеров см. в статье Выполнение конвейера и триггеры в фабрике данных Azure.

При создании триггера расписания необходимо указать расписание, например дату начала, повторения или окончания триггера и связать его с конвейером. Конвейеры и триггеры имеют связь "многие ко многим". Несколько триггеров могут запускать один конвейер. Один триггер может запускать несколько конвейеров.

В следующих разделах приведены шаги по созданию триггера расписания различными методами.

Фабрика данных Azure и портал Azure Synapse

Вы можете создать триггер расписания для периодического выполнения конвейера, например почасовой или ежедневной.

1. Перейдите на вкладку "Изменить " в Фабрике данных или вкладку "Интеграция " в Azure Synapse.

   • Фабрика данных Azure
   • Azure Synapse

   

2. Выберите Trigger (Запустить) в меню, а затем выберите New/Edit (Создать/изменить).

   

3. На странице "Добавить триггеры" выберите "Выбрать триггер", а затем нажмите кнопку "Создать".

   

4. На странице создания триггера:

   1. Убедитесь, что в качестве параметра Тип выбрано Расписание.

   2. Укажите дату и время запуска триггера в поле Дата начала. По умолчанию будет задано текущее значение даты и времени в формате UTC.

   3. Укажите часовой пояс, в котором создается триггер. Параметр часового пояса применяется к дате начала, дате окончания и времени выполнения расписания в расширенных параметрах повторения. Изменение параметра часового пояса не изменяет дату начала автоматически. Убедитесь, что дата начала указана правильно в указанном часовом поясе. Время запланированного выполнения триггера считается датой начала. (Убедитесь, что дата начала не менее 1 минуты меньше времени выполнения или в противном случае активирует конвейер в следующем повторении.)

      Примечание.

      Для часовых поясов, которые отслеживают летнее время, активируйте автоматическое изменение в два раза в год, если для повторения задано значение Days или более поздней версии. Чтобы отказаться от изменения дневного света, выберите часовой пояс, который не наблюдает дневного света, например UTC.

      Корректировка летнего времени выполняется только для триггера с параметром повторения в "Дни " или выше. Если для триггера задана частота "Часы " или "Минуты" , она продолжает выполняться через регулярные интервалы.

   4. Задайте интервал повторения для триггера. Выберите одно из значений в раскрывающемся списке (каждую минуту, почасовую, ежедневную, еженедельную или ежемесячную). Введите множитель в текстовом поле. Например, если вы хотите, чтобы триггер выполнялся один раз в течение 15 минут, выберите каждую минуту и введите 15 в текстовом поле.

   5. В разделе "Повторение", если в раскрывающемся списке выбраны дни, недели или месяцы , можно просмотреть дополнительные параметры повторения.

      

   6. Чтобы указать время окончания, выберите "Указать дату окончания". Укажите сведения о конце и нажмите кнопку "ОК".

      Стоимость связана с каждым запуском конвейера. При тестировании может потребоваться убедиться, что конвейер активируется всего несколько раз. Но при этом обязательно оставьте достаточно времени, чтобы конвейер успел запуститься между временем публикации и временем окончания. Триггер вступит в силу только после публикации решения, а не сразу при сохранении триггера в пользовательском интерфейсе.

      

      

5. В окне "Новый триггер" выберите "Да" в параметре "Активировано" и нажмите кнопку "ОК". С помощью этого флажка позже можно деактивировать этот триггер.

   

6. В окне "Новый триггер" просмотрите предупреждение и нажмите кнопку "ОК".

   

7. Выберите Опубликовать все, чтобы опубликовать изменения. Пока вы не опубликуете изменения, триггер не будет активировать запуски конвейера.

   

8. Перейдите на вкладку "Конвейер выполняется " слева, а затем выберите "Обновить ", чтобы обновить список. Вы увидите выполнения конвейера, активированные запланированным триггером. Обратите внимание на значения в столбце Активировано. Если вы используете параметр "Активировать сейчас ", в списке будет запущен триггер вручную.

   • Фабрика данных Azure
   • Azure Synapse

   

9. Перейдите в режим "Триггер" для просмотра>расписания.

   • Фабрика данных Azure
   • Azure Synapse

   

Azure PowerShell

В этом разделе показано, как использовать Azure PowerShell для создания, запуска и мониторинга триггера расписания. Чтобы просмотреть этот пример работы, сначала ознакомьтесь с кратким руководством по созданию фабрики данных с помощью Azure PowerShell. Затем добавьте следующий код в метод Main, который создает и запускает триггер расписания, выполняемый каждые 15 минут. Триггер связан с конвейером, который Adfv2QuickStartPipeline создается в рамках краткого руководства.

Необходимые компоненты

• Подписка Azure. Если у вас нет подписки Azure, создайте бесплатную учетную запись, прежде чем приступить к работе.
• Azure PowerShell. Выполните инструкции из руководства Install Azure PowerShell on Windows with PowerShellGet (Установка Azure PowerShell в Windows c помощью PowerShellGet).

Пример кода

1. Создайте JSON-файл с именем MyTrigger.json в папке *C:\ADFv2QuickStartPSH* со следующим содержимым:

   Внимание

   Перед сохранением JSON-файла задайте значение startTime элемента в текущее время в формате UTC. Задайте значение endTime элемента в течение одного часа после текущего времени в формате UTC.

   {
       "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"
                   }
               }
           ]
       }
   }
   

   Во фрагменте кода JSON:

   • Для type элемента триггера задано значение ScheduleTrigger.

   • Для frequency элемента задано значение, а interval для элемента Minute задано значение 15. Таким образом, триггер запускает конвейер каждые 15 минут в период между временем начала и окончания.

   • Элемент timeZone задает часовой пояс, в котором создается триггер. Этот параметр влияет как на, так startTime и endTime.

   • Элемент endTime составляет один час после значения startTime элемента. Таким образом, триггер запускает конвейер через 15, 30 и 45 минут после времени начала. Не забудьте обновить время начала до текущего времени в формате UTC и времени окончания до одного часа после начала.

     Внимание

     Для часового пояса startTime UTC и endTime должны соответствовать формату yyyy-MM-ddTHH:mm:ssZ. Для других часовых поясов startTime и endTime следуйте формату yyyy-MM-ddTHH:mm:ss .

     В стандарте Z ISO 8601 суффикс используется для метки времени помечания даты и часового пояса UTC и отрисовки timeZone поля без использования. Z Если суффикс для часового пояса UTC отсутствует, результатом является ошибка при активации триггера.

   • Триггер связан с конвейером Adfv2QuickStartPipeline . Чтобы связать несколько конвейеров с триггером, добавьте дополнительные pipelineReference разделы.

   • Конвейер в кратком руководстве принимает два parameters значения: inputPath и outputPath. Значения этих параметров передаются из триггера.

2. Создайте триггер с помощью командлета Set-AzDataFactoryV2Trigger:

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

3. Убедитесь, что триггер находится в состоянии Остановлено, используя командлет Get AzDataFactoryV2Trigger:

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

4. Запустите триггер с помощью командлета: Start-AzDataFactoryV2Trigger:

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

5. Убедитесь, что триггер находится в состоянии Запущено, используя командлет:Get-AzDataFactoryV2Trigger:

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

6. Получите сведения о выполнениях триггера в Azure PowerShell с помощью командлета Get-AzDataFactoryV2TriggerRun. Для этого следующую команду нужно выполнять периодически. TriggerRunStartedAfter Обновите значения и TriggerRunStartedBefore значения, чтобы они соответствовали значениям в определении триггера:

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

   Примечание.

   Время триггера триггеров расписания указывается в метке времени UTC. TriggerRunStartedAfter кроме TriggerRunStartedBefore того, ожидается метка времени UTC.

   Сведения о том, как отслеживать выполнения триггера и конвейера на портале Azure, см. в разделе Мониторинг конвейера.

Azure CLI

В этом разделе показано, как использовать Azure CLI для создания, запуска и мониторинга триггера расписания. Чтобы просмотреть этот пример работы, сначала ознакомьтесь с кратким руководством. Создание Фабрика данных Azure с помощью Azure CLI. Затем выполните действия, чтобы создать и запустить триггер расписания, который выполняется каждые 15 минут. Триггер связан с конвейером, который Adfv2QuickStartPipeline создается в рамках краткого руководства.

Необходимые компоненты

• Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см . в кратком руководстве по Bash в Azure Cloud Shell.

  

• Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.

  • Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других возможностях, доступных при входе, см. в статье Вход с помощью Azure CLI.

  • Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье Использование расширений с Azure CLI.

  • Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.

Пример кода

1. В рабочей папке создайте JSON-файл с именем MyTrigger.JSON и свойствами триггера. В этом примере используйте следующее содержимое:

   Внимание

   Перед сохранением JSON-файла задайте значение startTime элемента в текущее время в формате UTC. Задайте значение endTime элемента в течение одного часа после текущего времени в формате UTC.

   {
       "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"
               }
           }
       ]
   }
   

   Во фрагменте кода JSON:

   • Для type элемента триггера задано значение ScheduleTrigger.

   • Для frequency элемента задано значение, а interval для элемента Minute задано значение 15. Таким образом, триггер запускает конвейер каждые 15 минут в период между временем начала и окончания.

   • Элемент timeZone задает часовой пояс, в котором создается триггер. Этот параметр влияет как на, так startTime и endTime.

   • Элемент endTime составляет один час после значения startTime элемента. Таким образом, триггер запускает конвейер через 15, 30 и 45 минут после времени начала. Не забудьте обновить время начала до текущего времени в формате UTC и времени окончания до одного часа после начала.

     Внимание

     Для часового пояса startTime UTC и endTime необходимо следовать формату yyyy-MM-ddTHH:mm:ssZ. Для других часовых поясов startTime и endTime следуйте формату yyyy-MM-ddTHH:mm:ss .

     В стандарте ISO 8601 суффикс Z используется для метки времени помечания даты и часового пояса UTC и отрисовки timeZone поля без использования. Если суффикс Z отсутствует для часового пояса UTC, результатом является ошибка при активации активации.

   • Триггер связан с конвейером Adfv2QuickStartPipeline . Чтобы связать несколько конвейеров с триггером, добавьте дополнительные pipelineReference разделы.

   • Конвейер в кратком руководстве принимает два parameters значения: inputPath и outputPath. Значения этих параметров передаются из триггера.

2. Создайте триггер с помощью команды az datafactory trigger create:

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

3. Убедитесь, что триггер находится в состоянии Остановлено, с помощью команды az datafactory trigger show:

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

4. Запустите триггер с помощью команды az datafactory trigger start:

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

5. Убедитесь, что триггер находится в состоянии Запущено, с помощью команды az datafactory trigger show:

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

6. Получение триггера выполняется в Azure CLI с помощью команды az datafactory trigger-run query-by-factory . Чтобы получить сведения о выполнениях триггера, периодически выполняйте следующую команду. last-updated-after Обновите значения и last-updated-before значения, чтобы они соответствовали значениям в определении триггера:

   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"
   

   Примечание.

   Время триггера триггеров расписания указывается в метке времени UTC. После последнего обновления и последнего обновления до этого также ожидает метку времени UTC.

   Сведения о том, как отслеживать выполнения триггера и конвейера на портале Azure, см. в разделе Мониторинг конвейера.

Пакет SDK для .NET

В этом разделе показано, как использовать пакет SDK для .NET для создания, запуска и мониторинга триггера. Чтобы просмотреть этот пример работы, сначала ознакомьтесь с кратким руководством по созданию фабрики данных с помощью пакета SDK для .NET. Затем добавьте следующий код в метод Main, который создает и запускает триггер расписания, выполняемый каждые 15 минут. Триггер связан с конвейером, который Adfv2QuickStartPipeline создается в рамках краткого руководства.

Чтобы создать и запустить триггер расписания, который выполняется каждые 15 минут, добавьте следующий код в метод Main:

            // 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);

Чтобы создать триггеры в другом часовом поясе, отличном от UTC, требуются следующие параметры:

<<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;

Для мониторинга выполнения триггера добавьте следующий код перед последней инструкцией Console.WriteLine в этом примере:

            // 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();
                    }
                }
            }

Сведения о том, как отслеживать выполнения триггера и конвейера на портале Azure, см. в разделе Мониторинг конвейера.

Пакет SDK для Python

В этом разделе показано, как использовать пакет SDK для Python для создания, запуска и мониторинга триггера. Чтобы просмотреть этот пример работы, сначала ознакомьтесь с кратким руководством по созданию фабрики данных с помощью пакета SDK для Python. Затем добавьте следующий блок кода после monitor the pipeline run блока кода в скрипте Python. Этот код создает триггер расписания, который выполняется каждые 15 минут между указанным временем начала и окончания. start_time Обновите переменную до текущего времени в формате UTC и end_time переменной до одного часа после текущего времени в формате UTC.

    # 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)

Сведения о том, как отслеживать выполнения триггера и конвейера на портале Azure, см. в разделе Мониторинг конвейера.

Шаблон Azure Resource Manager

Для создания триггера можно использовать шаблон Azure Resource Manager. Пошаговые инструкции см. в статье "Создание фабрики данных Azure" с помощью шаблона Azure Resource Manager.

Передача времени запуска триггера в конвейер

Фабрика данных Azure версии 1 поддерживает чтение или запись секционированных данных с помощью системных переменныхSliceStart, SliceEndWindowStartиWindowEnd. В текущей версии конвейеров Фабрики данных и Azure Synapse это поведение можно достичь с помощью параметра конвейера. Время начала и запланированное время для триггера задаются в качестве значения для параметра конвейера. В следующем примере запланированное время триггера передается в качестве значения в параметр конвейера scheduledRunTime :

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

Схема JSON

Следующее определение JSON показывает, как создать триггер расписания с указанием расписания и повторения:

{
  "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>"
                }
           }
      ]
  }
}

Общее представление схемы

В следующей таблице представлен общий обзор основных элементов схемы, связанных с повторением и планированием триггера.

Параметры схемы по умолчанию, ограничения и примеры

Параметр часового пояса

Ниже приведены некоторые часовые пояса, поддерживаемые для триггеров расписания.

Этот список неполный. Полный список параметров часового пояса см . на странице создания триггера на портале.

Свойство startTime

В следующей таблице показано, как startTime свойство управляет запуском триггера.

Рассмотрим, как работает триггер, для которого время начала установлено в прошлом, указан параметр recurrence и отсутствует параметр schedule. Предположим, что текущее время — 2017-04-08 13:00, время начала — 2017-04-07 14:00, а повторение — каждые два дня. recurrence(Значение определяется путем задания frequency свойства day в значение .interval2) Обратите внимание, что startTime значение находится в прошлом и возникает до текущего времени.

В этих условиях первое выполнение происходит 2017-04-09 в 14:00. От времени начала ядро планировщика отсчитывает время повторных выполнений. Выполнения, которые приходятся на прошлое, игнорируются. Ядро берет очередной случай выполнения, который приходится на будущее. В данном сценарии время начала имеет значение 2017-04-07 в 2:00pm, поэтому следующее выполнение состоится через 2 дня от этого времени начала, то есть 2017-04-09 в 2:00pm.

Первое время выполнения совпадает, даже если startTime значение равно 2017-04-05 14:00 или 2017-04-01 14:00. Все последующие выполнения после первого вычисляются по расписанию (свойство schedule). Таким образом, последующие выполнения проходят 2017-04-11, в 2:00pm, затем 2017-04-13 в 2:00pm, затем 2017-04-15 в 2:00pm и т. д.

Наконец, если часы или минуты не заданы в расписании триггера, в качестве значений по умолчанию используются часы или минуты первого выполнения.

Свойство schedule

Использование расписания может ограничить количество выполнения триггеров. Например, если триггеру назначена ежемесячная частота и параметр schedule, который запускает триггер только в 31-й день месяца, он будет выполняться только в те месяцы, в которых есть 31 день.

Расписание также может расширить количество выполнения триггеров. Например, триггер с ежемесячной частотой и параметром schedule, который запускает триггер в 1 и 2 день месяца, будет выполняться в первый и второй дни месяца, а не раз в месяц.

Если задано несколько schedule элементов, порядок оценки — от самого большого до наименьшего параметра расписания. Оценка начинается с номера недели, а затем месяца, дня недели, часа и, наконец, минуты.

В следующей таблице подробно описаны schedule элементы.

Примеры расписаний повторения триггеров

В этом разделе приведены примеры расписаний повторения и сосредоточение внимания на schedule объекте и его элементах.

В примерах предполагается, что interval это значение 1 и что frequency значение правильно в соответствии с определением расписания. Например, нельзя иметь frequency значение day , а также monthDays изменить объект schedule . Такие ограничения указаны в таблице в предыдущем разделе.

Связанный контент

• Дополнительные сведения об триггерах см. в разделе "Выполнение конвейера" и "Триггеры".
• Сведения о том, как ссылаться на метаданные триггера в конвейере, см. в разделе "Справочные метаданные триггера" в запусках конвейера.