Créer une dépendance de déclencheur de fenêtre bascule
S’APPLIQUE À : 
Azure Data Factory Azure Synapse Analytics
Conseil
Essayez Data Factory dans Microsoft Fabric, une solution d’analyse tout-en-un pour les entreprises. Microsoft Fabric couvre tous les aspects, du déplacement des données à la science des données, en passant par l’analyse en temps réel, l’aide à la décision et la création de rapports. Découvrez comment démarrer un nouvel essai gratuitement !
Cet article explique étape par étape comment créer une dépendance envers un déclencheur de fenêtre bascule. Pour obtenir des informations générales sur les déclencheurs de fenêtre bascule, consultez Créer un déclencheur de fenêtre bascule.
Pour créer une chaîne de dépendance et faire en sorte qu’un déclencheur ne soit exécuté qu’après l’exécution réussie d’un autre déclencheur dans le service, utilisez cette fonctionnalité avancée de création d’une dépendance envers une fenêtre bascule.
Pour obtenir une démonstration de la création de pipelines dépendants à l’aide d’un déclencheur de fenêtre bascule, regardez la vidéo suivante :
Créer une analyse de dépendance dans l'IU
Pour créer une dépendance sur un déclencheur, sélectionnez Déclencheur>Avancé>Nouveau. Choisissez ensuite le déclencheur dont vous souhaitez dépendre avec le décalage et la taille appropriés. Sélectionnez Terminer et publiez les modifications pour que les dépendances prennent effet.
Propriétés de la dépendance envers une fenêtre bascule
Un déclencheur de fenêtre bascule avec une dépendance présente les propriétés suivantes :
{
"name": "MyTriggerName",
"properties": {
"type": "TumblingWindowTrigger",
"runtimeState": <<Started/Stopped/Disabled - readonly>>,
"typeProperties": {
"frequency": <<Minute/Hour>>,
"interval": <<int>>,
"startTime": <<datetime>>,
"endTime": <<datetime - optional>>,
"delay": <<timespan - optional>>,
"maxConcurrency": <<int>> (required, max allowed: 50),
"retryPolicy": {
"count": <<int - optional, default: 0>>,
"intervalInSeconds": <<int>>,
},
"dependsOn": [
{
"type": "TumblingWindowTriggerDependencyReference",
"size": <<timespan - optional>>,
"offset": <<timespan - optional>>,
"referenceTrigger": {
"referenceName": "MyTumblingWindowDependency1",
"type": "TriggerReference"
}
},
{
"type": "SelfDependencyTumblingWindowTriggerReference",
"size": <<timespan - optional>>,
"offset": <<timespan>>
}
]
}
}
}
Le tableau suivant donne la liste des attributs nécessaires pour définir une dépendance envers une fenêtre bascule.
| Nom de la propriété | Description | Type | Requis |
|---|---|---|---|
type |
Tous les déclencheurs de fenêtre bascule existants sont affichés dans cette liste déroulante. Choisissez le déclencheur sur lequel portera la dépendance. | TumblingWindowTriggerDependencyReference ou SelfDependencyTumblingWindowTriggerReference |
Oui |
offset |
Décalage du déclencheur de dépendance. Indiquez une valeur au format d’intervalle de temps. Les décalages négatifs et positifs sont autorisés. Cette propriété est obligatoire si le déclencheur dépend de lui-même. Dans tous les autres cas, elle est facultative. L’autodépendance doit toujours correspondre à un décalage négatif. Si aucune valeur n’est spécifiée, la fenêtre est la même que le déclencheur lui-même. | Timespan (hh:mm:ss) |
Autodépendance : Oui Autre : Non |
size |
Taille de la fenêtre bascule de dépendance. Fournissez une valeur TimeSpan positive. Cette propriété est facultative. | Timespan (hh:mm:ss) |
Non |
Notes
Un déclencheur de fenêtre bascule peut dépendre d’un maximum de cinq autres déclencheurs.
Propriétés d’autodépendance d’une fenêtre bascule
Dans les scénarios où le déclencheur ne doit pas passer à la fenêtre suivante tant que la fenêtre précédente n’est pas terminée, créez une autodépendance. Un déclencheur d’autodépendance qui dépend de la réussite de ses exécutions antérieures au cours de l’heure précédente présente les propriétés indiquées dans le code suivant.
Remarque
Si votre pipeline déclenché compte sur la sortie des pipelines dans les fenêtres déclenchées précédemment, nous vous recommandons d’utiliser uniquement l’autodépendance du déclencheur de la fenêtre bascule. Pour limiter les exécutions de déclencheurs parallèles, définissez le nombre maximal de déclencheurs simultanés.
{
"name": "DemoSelfDependency",
"properties": {
"runtimeState": "Started",
"pipeline": {
"pipelineReference": {
"referenceName": "Demo",
"type": "PipelineReference"
}
},
"type": "TumblingWindowTrigger",
"typeProperties": {
"frequency": "Hour",
"interval": 1,
"startTime": "2018-10-04T00:00:00Z",
"delay": "00:01:00",
"maxConcurrency": 50,
"retryPolicy": {
"intervalInSeconds": 30
},
"dependsOn": [
{
"type": "SelfDependencyTumblingWindowTriggerReference",
"size": "01:00:00",
"offset": "-01:00:00"
}
]
}
}
}
Scénarios et exemples d’utilisation
Les scénarios suivants montrent l’utilisation des propriétés de dépendance envers une fenêtre bascule.
Décalage de la dépendance
Taille de la dépendance
Autodépendance
Dépendance envers un autre déclencheur de fenêtre bascule
L’exemple suivant montre un travail de traitement quotidien des données de télémétrie qui dépend d’un autre travail quotidien d’agrégation de la sortie des sept derniers jours et qui génère des flux sur une fenêtre glissante de sept jours.
Dépendance envers soi-même
L’exemple suivant montre un travail quotidien sans écart dans les flux de sortie du travail.
Effectuer le monitoring des dépendances
Vous pouvez effectuer le monitoring de la chaîne de dépendance et des fenêtres correspondantes sur la page de monitoring des exécutions du déclencheur. Accédez à Monitoring>Exécutions de déclencheur. Si un déclencheur de fenêtre bascule a des dépendances, le nom du déclencheur porte un lien hypertexte vers une vue de monitoring des dépendances.
Cliquez sur le nom du déclencheur pour afficher les dépendances du déclencheur. Le volet de droite affiche les informations d’exécution du déclencheur comme l’ID d’exécution, la durée de la fenêtre et l’état.
Vous pouvez voir l’état des dépendances et les fenêtres pour chaque déclencheur dépendant. Si l’un des déclencheurs de dépendances échoue, vous devez le réexécuter correctement pour que le déclencheur dépendant s’exécute.
Un déclencheur de fenêtre bascule attend des dépendances pendant sept jours avant d’arriver à expiration. Après sept jours, l’exécution du déclencheur échoue.
Remarque
Un déclencheur de fenêtre bascule ne peut pas être annulé lorsqu’il est dans l’état En attente de dépendance. L’activité dépendante doit se terminer avant que le déclencheur de fenêtre bascule ne puisse être annulé. Cette restriction est intentionnelle et garantit que les activités dépendantes peuvent se terminer une fois démarrées. Elle permet également de réduire la probabilité de résultats inattendus.
Pour un rendu plus visuel de la planification des dépendances du déclencheur, sélectionnez l’affichage de Gantt.
Les zones transparentes montrent les fenêtres de dépendance pour chaque déclencheur dépendant en aval. Les zones de couleur unie dans l’image précédente montrent des exécutions de fenêtres individuelles. Voici quelques conseils pour interpréter la vue du diagramme de Gantt :
- Les zones transparentes s’affichent en bleu lorsque les fenêtres dépendantes sont dans l’état En attente ou En cours d’exécution.
- Une fois que toutes les fenêtres ont été correctement exécutées pour un déclencheur dépendant, la zone transparente devient verte.
- La zones transparentes s’affichent en rouge lorsqu’une fenêtre dépendante échoue. Recherchez une zone rouge pour identifier l’exécution de la fenêtre en échec.
Pour réexécuter une fenêtre en mode Diagramme de Gantt, sélectionnez la zone de couleur unie pour la fenêtre. Un Volet Actions s’affiche avec des informations et des options de réexécution.