Créez une tâche déclenchée manuellement dans DataStudio et gérez-la dans Operation Center. Cette rubrique explique comment créer une telle tâche et la déployer dans l'environnement de production.
Notes d'utilisation
Si vous n'avez pas besoin de déployer la tâche dans l'environnement de production pour l'exécuter sur un moteur de calcul, créez plutôt une requête ponctuelle.
Une tâche déclenchée manuellement s'exécute uniquement manuellement ; elle ne prend pas en charge la planification automatique.
Définissez l'ordre d'exécution des tâches déclenchées manuellement en les reliant par des lignes. Notez que cela ne crée pas de dépendance de planification.
Les différences entre un flux de travail déclenché manuellement et un flux de travail planifié sont minimes. Pour découvrir l'interface utilisateur, consultez Fonctionnalités de la page DataStudio.
Accéder à la page des flux de travail déclenchés manuellement
Accédez à la page pour créer des tâches déclenchées manuellement.
-
Accédez à la page DataStudio.
Connectez-vous à la console DataWorks. Dans la région cible, cliquez sur dans le volet de navigation de gauche. Sélectionnez un espace de travail dans la liste déroulante, puis cliquez sur Go to Data Development.
Sur la page Data Studio, cliquez sur Manually Triggered Workflows dans le volet de navigation de gauche. Si cet élément de menu n'est pas visible, consultez Ajuster les modules DataStudio affichés pour l'ajouter manuellement.
Créer un flux de travail déclenché manuellement
Dans DataWorks, vous organisez les tâches de développement de données au sein d'un flux de travail. Ce dernier agit comme un conteneur offrant un canevas sur lequel vous disposez des nœuds, des outils et des actions de gestion pour un objectif métier spécifique. Les étapes suivantes décrivent la création d'un flux de travail :
-
Créez un flux de travail en utilisant l'une des méthodes suivantes :
Méthode 1 : Placez le pointeur sur l'icône
, puis cliquez sur Create Workflow.Méthode 2 : Dans l'arborescence de gauche de DataStudio, cliquez avec le bouton droit sur Manually Triggered Workflows et sélectionnez Create Workflow.
Dans la boîte de dialogue Create Workflow, saisissez un nom et une description pour le flux de travail, puis cliquez sur Create.
Pour plus d'informations sur les flux de travail, consultez Créer et gérer des flux de travail.
Créer un nœud déclenché manuellement
Vous pouvez créer un nœud à partir de l'arborescence ou du canevas du flux de travail.
-
Créez un nœud déclenché manuellement.
-
Méthode 1 : Création à partir de l'arborescence.
Dans l'arborescence sous Manually Triggered Workflows, recherchez le flux de travail créé lors de l'étape Créer un flux de travail déclenché manuellement.
Cliquez avec le bouton droit sur le moteur de calcul requis et sélectionnez un type de nœud sous Create Node.
-
Méthode 2 : Création à partir du canevas du flux de travail.
Dans l'arborescence sous Manually Triggered Workflows, recherchez le flux de travail créé lors de l'étape Créer un flux de travail déclenché manuellement.
Double-cliquez sur le flux de travail pour ouvrir son canevas.
En haut du canevas, cliquez sur Create Node. Ensuite, dans le volet de navigation de gauche, cliquez sur le type de nœud requis ou faites-le glisser sur le canevas.
-
Configurez le nom du nœud, l'instance de moteur de calcul et les autres informations.
-
Définissez le code de la tâche.
Rédigez la logique de la tâche en utilisant la syntaxe du moteur de calcul sélectionné. Pour transmettre des paramètres de manière dynamique, définissez des variables au format
${Nom de la variable}. Attribuez ensuite des valeurs par défaut à ces variables dans les propriétés du nœud, comme pour les tâches planifiées.RemarqueLa configuration des paramètres de planification varie selon le type de nœud. Par exemple, les variables dans un nœud Shell doivent utiliser le format $1, $2, $3, etc. Pour plus d'informations, consultez Configurer les paramètres de planification pour différents types de nœuds.
(Facultatif) Définir l'ordre d'exécution
La définition d'un ordre d'exécution pour les nœuds d'un flux de travail déclenché manuellement est facultative. Vous pouvez toutefois connecter les nœuds sur le canevas du flux de travail pour établir un ordre d'exécution amont-aval. Lors de l'exécution de l'intégralité du flux de travail, les nœuds sans ordre défini sont déclenchés simultanément, tandis que ceux dont l'ordre est défini sont déclenchés séquentiellement.
Configurer les propriétés du nœud
Si la tâche doit accéder aux données d'un moteur de calcul dans l'environnement de production, configurez ses propriétés d'exécution dans le panneau de droite de l'éditeur de nœud. Ces propriétés sont identiques à celles d'une tâche planifiée. Les propriétés disponibles sont les suivantes :
|
Propriété |
Description |
|
Le nom, l'ID, le type et le propriétaire du nœud s'affichent automatiquement. Aucune configuration n'est requise. Remarque
|
|
|
Définit les paramètres utilisés lors de l'exécution du nœud. Remarque
DataWorks fournit des paramètres intégrés et personnalisés pour attribuer dynamiquement des valeurs lors de l'exécution des tâches. Si vous avez défini des variables dans votre code, attribuez-leur leurs valeurs dans cette section. |
|
|
Spécifie le groupe de ressources utilisé pour exécuter la tâche après son déploiement dans l'environnement de production. Vous pouvez sélectionner un groupe de ressources de planification disponible pour l'espace de travail actuel. Nous vous recommandons d'acheter et d'utiliser un groupe de ressources serverless DataWorks. Pour plus d'informations, consultez Utiliser un groupe de ressources serverless. |
Déboguer les nœuds déclenchés manuellement
Utilisez les icônes 
et 
de la barre d'outils de l'éditeur de nœud pour déboguer le nœud actuel. Vous pouvez également cliquer sur l'icône d'exécution 
sur le canevas du flux de travail pour déboguer l'intégralité du flux de travail déclenché manuellement.
Cette opération s'exécute sous votre compte et utilise la source de données configurée pour l'environnement de développement. Pour afficher ou gérer les sources de données, accédez à la page . Pour plus d'informations, consultez Gérer les sources de données.
(Facultatif) Définir les paramètres du flux de travail
Si votre flux de travail déclenché manuellement contient des variables portant le même nom et que vous souhaitez leur attribuer des valeurs à un seul endroit, définissez des paramètres de flux de travail sur le canevas du flux de travail. Une fois les paramètres définis, exécutez le flux de travail, attribuez des valeurs aux paramètres et affichez les détails d'exécution des tâches déclenchées manuellement avec ces valeurs.
Vous pouvez définir des valeurs par défaut pour les paramètres du flux de travail, ou définir uniquement les noms des paramètres et attribuer des valeurs spécifiques à chaque exécution du flux de travail dans l'environnement de production.
Valider et déployer un nœud
Pour exécuter une tâche déclenchée manuellement dans l'environnement de production, enregistrez, validez et déployez le nœud vers Operation Center. Pour plus d'informations, consultez Déployer des nœuds. Confirmez l'état final du déploiement, car celui-ci peut échouer.
Une fois la tâche déployée, accédez à pour afficher le nœud déclenché manuellement que vous avez déployé.
Exécuter une tâche en production
Pour exécuter une tâche déclenchée manuellement, accédez à et ouvrez la page Tâches déclenchées manuellement. Sur cette page, recherchez et exécutez la tâche cible.
Une tâche déclenchée manuellement peut s'exécuter pendant un maximum de trois jours. Si une tâche dépasse cette limite, DataWorks l'arrête automatiquement et l'instance correspondante échoue.
Attribution de valeurs aux paramètres du flux de travail : Si le flux de travail déclenché manuellement comporte des paramètres de flux de travail, vous pouvez leur attribuer des valeurs à chaque exécution. Cette action attribue les mêmes valeurs à toutes les variables portant des noms correspondants dans le code des nœuds du flux de travail. Cette option est disponible uniquement pour les flux de travail disposant de paramètres de flux de travail définis.
-
Ordre d'exécution des tâches : L'ordre d'exécution suit la logique décrite dans la section « (Facultatif) Définir l'ordre d'exécution des nœuds déclenchés manuellement » :
Lorsque vous exécutez un flux de travail entier, les tâches sans ordre d'exécution défini sont déclenchées simultanément.
Les tâches dont l'ordre d'exécution est défini s'exécutent séquentiellement.
L'exécution d'une tâche déclenchée manuellement dans l'environnement de production génère une instance déclenchée manuellement. Affichez les résultats d'exécution sur la page Instances déclenchées manuellement, située sous .