Comment afficher et gérer les instances manuelles - DataWorks

Les instances manuelles sont générées lors de l'exécution de tâches manuelles. Consultez les détails des instances et gérez-les depuis une vue en liste ou un diagramme DAG.

Important

Les alarmes de surveillance sont disponibles uniquement pour les instances récurrentes et les instances de workflow déclenchées ; elles ne sont pas prises en charge pour les instances de remplissage de données ni pour les instances de test.
Vous devez souscrire à DataWorks Professional Edition ou à une version ultérieure pour que les instances manuelles prennent en charge la fonctionnalité de diagnostic des instances ainsi que la fonctionnalité Export Query Results.

Accéder à la page des instances manuelles

Connectez-vous à la console DataWorks. Dans la région cible, cliquez sur Data Development and O&M > Operation Center dans le volet de navigation de gauche. Sélectionnez un espace de travail dans la liste déroulante, puis cliquez sur Go to Operation Center.
Dans le volet de navigation de gauche, cliquez sur Manually Triggered Task O&M > Manually Triggered Node Instance pour ouvrir la page des instances manuelles.

Gérer les instances

Cette page regroupe les instances manuelles, les instances de workflow basées sur un déclencheur et les instances de workflow déclenchées manuellement.

Gérer les instances manuelles

L'exécution d'une tâche manuelle depuis la page Gérer les tâches manuelles génère une instance manuelle sur cette page.

Accédez à l'onglet Manually Triggered Node Instance. Filtrez et affichez les informations relatives aux instances manuelles selon des critères tels que Node Name, Task type et Business Time.
Gérez les instances manuelles.
- Opération unique : dans la colonne Actions d'une instance, Terminate ou relancez (rerun) une instance manuelle, ou bien cliquez sur More pour consulter les journaux d'exécution de l'instance et d'autres informations.
- Opérations par lot : sélectionnez plusieurs instances manuelles, puis cliquez sur Stop ou rerun en bas de la page.
- Exporter les résultats de la requête : filtrez d'abord les instances selon vos critères. Une fois la recherche terminée, cliquez sur Export Query Results au-dessus de la liste pour exporter les résultats filtrés vers votre appareil local. Il s'agit d'une opération asynchrone. Suivez la progression et téléchargez le fichier depuis la page Afficher les enregistrements d'actions du centre d'opérations.
- Opérations DAG : pour plus d'informations, consultez la rubrique Gérer le DAG des instances manuelles.
Remarque
Lorsque vous relancez une instance manuelle, le commutateur Rerun With Latest Configuration de la boîte de dialogue de confirmation est désactivé par défaut. Activez ce commutateur si vous avez modifié la configuration du nœud après la génération de l'instance, afin que celle-ci s'exécute avec la dernière configuration. N'activez pas ce commutateur si vous avez modifié manuellement les propriétés de l'instance, car ces propriétés seront réinitialisées. Le commutateur met à jour les propriétés suivantes de l'instance selon les dernières configurations de tâche : ressource de calcul, groupe de ressources, unités de calcul (CUs), priorité, image, type de planification, politique de relance, définition du délai d'expiration, propriétaire, tags et configurations DQC. Que ce commutateur soit activé ou non, le code du nœud utilise toujours la dernière version à chaque relance.

Gérer les instances de workflow basées sur un déclencheur

Les workflows basés sur un déclencheur peuvent être exécutés manuellement depuis la page Gérer les workflows basés sur un déclencheur ou via un déclencheur d'événement. Lorsqu'ils sont déclenchés, une instance de workflow correspondante apparaît sur cette page.

Accédez à l'onglet Triggered Workflow Instance. Filtrez et affichez les informations relatives aux instances de workflow basées sur un déclencheur selon des critères tels que Node Name, Trigger et Business Time.
Remarque
- Déclenchement manuel : si une instance de workflow a été déclenchée manuellement, la colonne Trigger affiche -.
- Déclencheur d'événement : si une instance de workflow a été déclenchée par un événement, la colonne Trigger affiche le nom du déclencheur.
Gérez les instances de workflow basées sur un déclencheur.
- Actions individuelles : Terminate ou relancez (rerun) une instance de workflow basée sur un déclencheur dans la colonne Actions de l'instance, ou bien cliquez sur More > Edit Node pour la modifier dans Data Studio.
- Opérations par lot : sélectionnez plusieurs instances de workflow basées sur un déclencheur, puis cliquez sur Terminate, Batch Rerun, Set as Successful, Change Priority, Change Resource Group ou Refresh Instance en bas de la page.
- Exporter les résultats de la requête : filtrez d'abord les instances selon vos critères. Une fois la recherche terminée, cliquez sur Export Query Results au-dessus de la liste pour exporter les résultats filtrés vers votre appareil local. Il s'agit d'une opération asynchrone. Suivez la progression et téléchargez le fichier depuis la page Afficher les enregistrements d'actions du centre d'opérations.
- Opérations DAG : pour plus d'informations, consultez la rubrique Gérer le DAG des instances manuelles.
Remarque
Lorsque vous relancez une instance de workflow basée sur un déclencheur, le commutateur Rerun With Latest Configuration de la boîte de dialogue de confirmation est désactivé par défaut. Activez ce commutateur si vous avez modifié la configuration du nœud après la génération de l'instance, afin que celle-ci s'exécute avec la dernière configuration. N'activez pas ce commutateur si vous avez modifié manuellement les propriétés de l'instance, car ces propriétés seront réinitialisées. Le commutateur met à jour les propriétés suivantes de l'instance selon les dernières configurations de tâche : ressource de calcul, groupe de ressources, unités de calcul (CUs), priorité, image, type de planification, politique de relance, définition du délai d'expiration, propriétaire, tags et configurations DQC. Que ce commutateur soit activé ou non, le code du nœud utilise toujours la dernière version à chaque relance.
Les icônes situées sous l'instance de tâche indiquent son état d'exécution.
- : nombre d'instances en cours d'exécution.
- : nombre d'instances ayant réussi.
- : nombre d'instances ayant échoué.
- : nombre d'instances qui n'ont pas encore été exécutées.

Gérer les instances de workflow déclenchées manuellement

L'exécution d'un workflow déclenché manuellement depuis la page Gérer les workflows déclenchés manuellement génère une instance de workflow déclenchée manuellement sur cette page.

Accédez à l'onglet Manual Workflow Instance. Filtrez et affichez les informations relatives aux instances de workflow déclenchées manuellement selon des critères tels que Workflow, Running status et Business Time.
Gérez les instances de workflow déclenchées manuellement.
- Opération unique : Batch Terminate ou relancez (rerun) une instance de workflow déclenchée manuellement dans sa colonne Actions.
- Opérations par lot : sélectionnez plusieurs instances de workflow déclenchées manuellement, puis cliquez sur Terminate, Rerun, Set as Successful, Change Priority, Change Resource Group ou Refresh Instance en bas de la page.
- Exporter les résultats de la requête : filtrez d'abord les instances selon vos critères. Une fois la recherche terminée, cliquez sur Export Query Results au-dessus de la liste pour exporter les résultats filtrés actuels vers votre appareil local. Il s'agit d'une opération asynchrone. Suivez la progression et téléchargez le fichier depuis la page Afficher les enregistrements d'actions du centre d'opérations.
- Opérations DAG : pour plus d'informations, consultez la rubrique Gérer le DAG des instances manuelles.
Remarque
Lorsque vous relancez une instance de workflow déclenchée manuellement, le commutateur Rerun With Latest Configuration de la boîte de dialogue de confirmation est désactivé par défaut. Activez ce commutateur si vous avez modifié la configuration du nœud après la génération de l'instance, afin que celle-ci s'exécute avec la dernière configuration. N'activez pas ce commutateur si vous avez modifié manuellement les propriétés de l'instance, car ces propriétés seront réinitialisées. Le commutateur met à jour les propriétés suivantes de l'instance selon les dernières configurations de tâche : ressource de calcul, groupe de ressources, unités de calcul (CUs), priorité, image, type de planification, politique de relance, définition du délai d'expiration, propriétaire, tags et configurations DQC. Que ce commutateur soit activé ou non, le code du nœud utilise toujours la dernière version à chaque relance.
Les icônes situées sous le workflow déclenché manuellement indiquent l'état d'exécution de ses instances.
- : nombre d'instances en cours d'exécution.
- : nombre d'instances ayant réussi.
- : nombre d'instances ayant échoué.
- : nombre d'instances dans d'autres états.

Actions de suivi automatisées pour les opérations par lot

Important

Cette fonctionnalité est actuellement prise en charge uniquement pour les opérations par lot sur les workflows basés sur un déclencheur.

DataWorks propose des Post-O&M Actions optionnelles pour quatre opérations par lot : Change Priority, Modify Resource Group, Refresh Instance et Stop. Définissez une action enchaînée qui s'exécute automatiquement après la réussite de l'opération principale, garantissant ainsi l'application immédiate des modifications.

Cas d'utilisation

Lorsque vous modifiez les propriétés d'une instance déjà présente dans la file d'attente de planification (par exemple, avec un statut En attente de l'heure, En attente de ressources ou En cours d'exécution), les modifications ne s'appliquent pas immédiatement à l'instance actuellement en file d'attente ou en cours d'exécution. La fonctionnalité d'action de suivi automatise le processus d'arrêt-modification-relance, permettant d'effectuer toute la chaîne en une seule opération.

1. Modifier la priorité par lot, modifier le groupe de ressources et actualiser l'instance

Lorsque vous effectuez une opération Change Priority, Modify Resource Group ou Refresh Instance sur des instances de workflow basées sur un déclencheur, spécifiez une action de suivi pour garantir l'application immédiate de vos modifications.

Procédure

Sur la page Triggered workflow instance, sélectionnez une ou plusieurs instances que vous souhaitez modifier.
Cliquez sur Change Priority, Change Resource Group ou Refresh Instance en bas de la page.
Dans la boîte de dialogue qui s'affiche, une nouvelle section Follow-up O&M Actions apparaît en plus des paramètres de l'opération principale.

Options d'action de suivi O&M

Choisissez l'une des actions de suivi suivantes :

Arrêter les instances en attente de l'heure, en attente de ressources ou en cours d'exécution :
- Effet : le système applique d'abord la modification de propriété que vous avez spécifiée (comme le changement de priorité), puis arrête automatiquement toutes les instances cibles dont le statut est « En attente de l'heure », « En attente de ressources » ou « En cours d'exécution ».
- Cas d'utilisation : arrêtez les instances en cours d'exécution et décidez ultérieurement s'il convient de les relancer. Cela empêche les instances utilisant d'anciennes configurations de consommer des ressources.
Relancer les instances :
- Effet : après application de la modification de propriété, le système relance immédiatement toutes les instances sélectionnées.
- Cas d'utilisation : utilisez cette option lorsque vous souhaitez que les modifications prennent effet immédiatement et relancer la tâche avec la nouvelle configuration (nouvelle priorité, nouveau groupe de ressources ou code actualisé).

2. Arrêt par lot

Lors de l'exécution d'une opération Batch Stop, vous pouvez également définir une action de suivi, telle qu'une relance automatique, afin de récupérer rapidement après un arrêt des instances.

Procédure

Sur la page Triggered workflow instance, sélectionnez une ou plusieurs instances que vous souhaitez arrêter.
Cliquez sur le bouton Terminate en bas de la page.
Dans la boîte de dialogue qui s'affiche, une nouvelle section Post-O&M Actions apparaît.

Dans la boîte de dialogue Batch Stop, vous pouvez définir Task Scope sur All Tasks (arrête toutes les tâches au sein des instances de workflow basées sur un déclencheur sélectionnées) ou sur Specified Tasks (arrête uniquement les tâches spécifiées). Vous pouvez également filtrer par Instance Status en sélectionnant En attente de l'heure, En attente de ressources, En cours d'exécution ou Vérification. Dans la section Follow-up O&M Actions, vous pouvez sélectionner Rerun Instances et activer l'option Reset instance status before rerunning.

Options d'action de suivi O&M

Rerun Instance :
- Effet : après avoir arrêté les instances sélectionnées, le système les relance immédiatement.
- Cas d'utilisation : utilisez cette option lorsqu'une tâche est bloquée ou s'exécute trop longtemps et que vous souhaitez l'arrêter puis la redémarrer immédiatement avec la configuration d'origine.
Reset instance status before rerunning :
- Effet : il s'agit d'une opération d'arrêt et de relance plus radicale. Le système force d'abord le statut de toutes les instances sélectionnées sur « Non exécuté » (même les tâches en cours d'exécution sont arrêtées), puis les relance.
- Cas d'utilisation : utilisez cette option pour une réinitialisation complète de l'état lorsque l'état interne d'une instance est corrompu et qu'un simple arrêt-relance ne résout pas le problème.

Gérer le DAG des instances manuelles

Cliquez sur le nom de l'instance, ou bien cliquez sur Actions dans la colonne DAG pour ouvrir le DAG de cette instance. Cliquez avec le bouton droit sur un nœud de tâche dans le DAG pour accéder à des opérations telles que show ancestor nodes, show descendant nodes, view runtime log, instance diagnosis, view code, edit node, view lineage, Trigger DQC Check, Stop, rerun et set to successful.

Remarque

Dans la liste des workflows déclenchés manuellement, cliquez sur un workflow pour afficher son DAG à droite. Le DAG peut contenir plusieurs tâches.

Actions	Description
Show Ancestor Nodes	Développe jusqu'à six niveaux de nœuds en amont pour le nœud sélectionné. Remarque Vous ne pouvez développer les nœuds ancêtres que pour les instances de workflow déclenchées manuellement.
Show Descendent Nodes	Développe jusqu'à six niveaux de nœuds en aval pour le nœud sélectionné. Remarque Vous ne pouvez développer les nœuds descendants que pour les instances de workflow déclenchées manuellement.
View Runtime Log	Affiche le journal d'exécution de l'instance actuelle. Remarque Vous ne pouvez pas supprimer manuellement les instances. La plateforme supprime automatiquement les instances après leur expiration, généralement au bout d'environ 30 jours. Pour les tâches exécutées sur le groupe de ressources partagé pour la planification, les instances sont conservées pendant un mois et les journaux pendant une semaine. Si le journal d'une instance terminée dépasse 3 Mo, il est purgé quotidiennement selon une planification définie. Pour les tâches exécutées sur un groupe de ressources exclusif pour la planification, les instances et les journaux sont conservés pendant un mois.
Run Diagnostics	Diagnostique l'exécution de bout en bout d'une tâche pour aider à localiser les problèmes. Pour plus d'informations, consultez la rubrique diagnostic intelligent.
View Code	Affiche le code du nœud actuel.
Edit Node	Ouvre le workflow dans DataStudio pour modification.
View Lineage	Affiche la lignée de données de l'instance actuelle.
Terminate	Arrête l'instance actuelle. Cette opération n'affecte pas les autres instances.
Rerun	Relance la tâche sélectionnée, utile pour traiter les nœuds ayant échoué ou manqués. Dans la boîte de dialogue de confirmation, le commutateur Rerun With Latest Configuration est désactivé par défaut. Activez ce commutateur si vous avez modifié la configuration du nœud après la génération de l'instance. N'activez pas ce commutateur si vous avez modifié manuellement les propriétés de l'instance, car ces propriétés seront réinitialisées. Le commutateur met à jour les propriétés suivantes de l'instance selon les dernières configurations de tâche : ressource de calcul, groupe de ressources, unités de calcul (CUs), priorité, image, type de planification, politique de relance, définition du délai d'expiration, propriétaire, tags et configurations DQC. Que ce commutateur soit activé ou non, le code du nœud utilise toujours la dernière version à chaque relance. Remarque Vous ne pouvez relancer que les tâches dont l'état est Réussi ou Échoué.