Skip to content

Commit 80d6ab8

Browse files
authored
Update concepts-pipeline-execution-triggers.md
Adding note about Scheduled Trigger DST auto updates. renamed sections and reordered for better usability and flow
1 parent bb14110 commit 80d6ab8

File tree

1 file changed

+18
-13
lines changed

1 file changed

+18
-13
lines changed

articles/data-factory/concepts-pipeline-execution-triggers.md

Lines changed: 18 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ You will see the trigger configuration window, allowing you to choose the trigge
3636
Read more about [scheduled](#schedule-trigger-with-json), [tumbling window](#tumbling-window-trigger), [storage event](#event-based-trigger), and [custom event](#event-based-trigger) triggers below.
3737

3838

39-
## Manual execution with JSON
39+
## Manual execution
4040

4141
The manual execution of a pipeline is also referred to as _on-demand_ execution.
4242

@@ -152,7 +152,7 @@ https://management.azure.com/subscriptions/mySubId/resourceGroups/myResourceGrou
152152

153153
For a complete sample, see [Quickstart: Create a data factory by using the REST API](quickstart-create-data-factory-rest-api.md).
154154

155-
## Trigger execution with JSON
155+
## Trigger Types
156156

157157
Triggers are another way that you can execute a pipeline run. Triggers represent a unit of processing that determines when a pipeline execution needs to be kicked off. Currently, the service supports three types of triggers:
158158

@@ -190,7 +190,7 @@ Pipelines and triggers have a many-to-many relationship (except for the tumbling
190190
}
191191
```
192192

193-
## Schedule trigger with JSON
193+
## Schedule trigger
194194
A schedule trigger runs pipelines on a wall-clock schedule. This trigger supports periodic and advanced calendar options. For example, the trigger supports intervals like "weekly" or "Monday at 5:00 PM and Thursday at 9:00 PM." The schedule trigger is flexible because the dataset pattern is agnostic, and the trigger doesn't discern between time-series and non-time-series data.
195195

196196
For more information about schedule triggers and, for examples, see [Create a trigger that runs a pipeline on a schedule](how-to-create-schedule-trigger.md).
@@ -259,6 +259,12 @@ The following table provides a high-level overview of the major schema elements
259259
| **interval** | A positive integer that denotes the interval for the **frequency** value. The **frequency** value determines how often the trigger runs. For example, if the **interval** is 3 and the **frequency** is "week", the trigger recurs every three weeks. |
260260
| **schedule** | The recurrence schedule for the trigger. A trigger with a specified **frequency** value alters its recurrence based on a recurrence schedule. The **schedule** property contains modifications for the recurrence that are based on minutes, hours, weekdays, month days, and week number. |
261261

262+
> [!NOTE]
263+
> For time zones that observe daylight saving, trigger time auto-adjusts for the twice-a-year change, if the recurrence is set to **Days** or above. To opt out of the daylight saving change, select a time zone that doesn't observe daylight saving, for instance, UTC.
264+
>
265+
> Daylight saving adjustment only happens for a trigger with the recurrence set to **Days** or above. If the trigger is set to **Hours** or **Minutes** frequency, it continues to fire at regular intervals.
266+
267+
262268
### Schedule trigger example
263269

264270
```json
@@ -376,6 +382,15 @@ The examples assume that the **interval** value is 1 and that the **frequency**
376382
| `{"minutes":[0,15,30,45], "monthlyOccurrences":[{"day":"friday", "occurrence":-1}]}` | Run every 15 minutes on the last Friday of the month. |
377383
| `{"minutes":[15,45], "hours":[5,17], "monthlyOccurrences":[{"day":"wednesday", "occurrence":3}]}` | Run at 5:15 AM, 5:45 AM, 5:15 PM, and 5:45 PM on the third Wednesday of every month. |
378384

385+
## Event-based trigger
386+
387+
An event-based trigger runs pipelines in response to an event. From behavior perspective, if you stop and start an event-based trigger, it resumes old trigger pattern which may result in unwanted trigger of the pipeline. In this case, you should delete and create new event based trigger. The new trigger starts fresh without history. There are two flavors of event-based triggers.
388+
389+
* _Storage event trigger_ runs a pipeline against events happening in a Storage account, such as the arrival of a file, or the deletion of a file in Azure Blob Storage account.
390+
* _Custom event trigger_ processes and handles [custom articles](../event-grid/custom-topics.md) in Event Grid
391+
392+
For more information about event-based triggers, see [Storage Event Trigger](how-to-create-event-trigger.md) and [Custom Event Trigger](how-to-create-custom-event-trigger.md).
393+
379394
## Trigger type comparison
380395

381396
The tumbling window trigger and the schedule trigger both operate on time heartbeats. How are they different?
@@ -394,16 +409,6 @@ The following table provides a comparison of the tumbling window trigger and sch
394409
| **System variables** | Along with @trigger().scheduledTime and @trigger().startTime, it also supports the use of the **WindowStart** and **WindowEnd** system variables. Users can access `trigger().outputs.windowStartTime` and `trigger().outputs.windowEndTime` as trigger system variables in the trigger definition. The values are used as the window start time and window end time, respectively. For example, for a tumbling window trigger that runs every hour, for the window 1:00 AM to 2:00 AM, the definition is `trigger().outputs.windowStartTime = 2017-09-01T01:00:00Z` and `trigger().outputs.windowEndTime = 2017-09-01T02:00:00Z`. | Only supports default @trigger().scheduledTime and @trigger().startTime variables. |
395410
| **Pipeline-to-trigger relationship** | Supports a one-to-one relationship. Only one pipeline can be triggered. | Supports many-to-many relationships. Multiple triggers can kick off a single pipeline. A single trigger can kick off multiple pipelines. |
396411

397-
## Event-based trigger
398-
399-
An event-based trigger runs pipelines in response to an event. From behavior perspective, if you stop and start an event-based trigger, it resumes old trigger pattern which may result in unwanted trigger of the pipeline. In this case, you should delete and create new event based trigger. The new trigger starts fresh without history. There are two flavors of event-based triggers.
400-
401-
* _Storage event trigger_ runs a pipeline against events happening in a Storage account, such as the arrival of a file, or the deletion of a file in Azure Blob Storage account.
402-
* _Custom event trigger_ processes and handles [custom articles](../event-grid/custom-topics.md) in Event Grid
403-
404-
For more information about event-based triggers, see [Storage Event Trigger](how-to-create-event-trigger.md) and [Custom Event Trigger](how-to-create-custom-event-trigger.md).
405-
406-
407412
## Related content
408413

409414
See the following tutorials:

0 commit comments

Comments
 (0)