Skip to content

Commit 3174c14

Browse files
committed
Merge branch 'patch-22' of https://github.com/jasonhorner/azure-docs into jasonhorner-updates
2 parents 1ebd794 + 422d09a commit 3174c14

8 files changed

+26
-21
lines changed

articles/data-factory/author-management-hub.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ To override the generated Resource Manager template parameters when publishing f
5050

5151
### Triggers
5252

53-
Triggers determine when a pipeline run should be kicked off. Currently triggers can be on a wall clock schedule, operate on a periodic interval, or depend on an event. For more information, learn about [trigger execution](concepts-pipeline-execution-triggers.md#trigger-execution-with-json). In the management hub, you can create, edit, delete, or view the current state of a trigger.
53+
Triggers determine when a pipeline run should be kicked off. Currently triggers can be on a wall clock schedule, operate on a periodic interval, or depend on an event. For more information, learn about [trigger execution](concepts-pipeline-execution-triggers.md#trigger-types). In the management hub, you can create, edit, delete, or view the current state of a trigger.
5454

5555
:::image type="content" source="media/author-management-hub/management-hub-triggers.png" alt-text="Screenshot that shows where to create, edit, delete, nor view the current state of a trigger.":::
5656

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

Lines changed: 19 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -33,10 +33,10 @@ You will see the trigger configuration window, allowing you to choose the trigge
3333

3434
:::image type="content" source="media/concepts-pipeline-execution-triggers/new-trigger-configuration.png" alt-text="Shows the new trigger configuration window with the type dropdown showing the various types of triggers you can create.":::
3535

36-
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.
36+
Read more about [scheduled](#schedule-trigger), [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:

articles/data-factory/control-flow-system-variables.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ These system variables can be referenced anywhere in the pipeline JSON.
3939
4040
## Schedule trigger scope
4141

42-
These system variables can be referenced anywhere in the trigger JSON for triggers of type [ScheduleTrigger](concepts-pipeline-execution-triggers.md#schedule-trigger-with-json).
42+
These system variables can be referenced anywhere in the trigger JSON for triggers of type [ScheduleTrigger](concepts-pipeline-execution-triggers.md#schedule-trigger).
4343

4444
| Variable Name | Description |
4545
| --- | --- |

articles/data-factory/how-to-create-custom-event-trigger.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -168,5 +168,5 @@ Specifically, you need `Microsoft.EventGrid/EventSubscriptions/Write` permission
168168

169169
## Related content
170170

171-
* Get detailed information about [trigger execution](concepts-pipeline-execution-triggers.md#trigger-execution-with-json).
171+
* Get detailed information about [trigger execution](concepts-pipeline-execution-triggers.md#trigger-types).
172172
* Learn how to [reference trigger metadata in pipeline runs](how-to-use-trigger-parameterization.md).

articles/data-factory/how-to-create-event-trigger.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -154,5 +154,5 @@ Three noticeable callouts in the workflow are related to event triggering pipeli
154154

155155
## Related content
156156

157-
* For more information about triggers, see [Pipeline execution and triggers](concepts-pipeline-execution-triggers.md#trigger-execution-with-json).
157+
* For more information about triggers, see [Pipeline execution and triggers](concepts-pipeline-execution-triggers.md#trigger-types).
158158
* To reference trigger metadata in a pipeline, see [Reference trigger metadata in pipeline runs](how-to-use-trigger-parameterization.md).

articles/data-factory/how-to-create-schedule-trigger.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -590,5 +590,5 @@ The examples assume that the `interval` value is `1` and that the `frequency` va
590590

591591
## Related content
592592

593-
- For more information about triggers, see [Pipeline execution and triggers](concepts-pipeline-execution-triggers.md#trigger-execution-with-json).
593+
- For more information about triggers, see [Pipeline execution and triggers](concepts-pipeline-execution-triggers.md#trigger-types).
594594
- To learn how to reference trigger metadata in pipeline, see [Reference trigger metadata in pipeline runs](how-to-use-trigger-parameterization.md).

articles/data-factory/how-to-create-tumbling-window-trigger.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -365,6 +365,6 @@ To monitor trigger runs and pipeline runs in the Azure portal, see [Monitor pipe
365365

366366
## Related content
367367

368-
* [Pipeline execution and triggers](concepts-pipeline-execution-triggers.md#trigger-execution-with-json)
368+
* [Pipeline execution and triggers](concepts-pipeline-execution-triggers.md#trigger-types)
369369
* [Create a tumbling window trigger dependency](tumbling-window-trigger-dependency.md)
370370
* [Reference trigger metadata in pipeline runs](how-to-use-trigger-parameterization.md)

articles/data-factory/how-to-use-trigger-parameterization.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -141,4 +141,4 @@ To use the values in a pipeline, utilize parameters, like `@pipeline().parameter
141141

142142
## Related content
143143

144-
For more information about triggers, see [Pipeline execution and triggers](concepts-pipeline-execution-triggers.md#trigger-execution-with-json).
144+
For more information about triggers, see [Pipeline execution and triggers](concepts-pipeline-execution-triggers.md#trigger-types).

0 commit comments

Comments
 (0)