DataWorks:Nœud de paramètre

Présentation

Un nœud de paramètre est un nœud virtuel qui n'exécute pas de tâches de calcul de données ni ne produit de données. Il sert principalement à transmettre des paramètres entre les nœuds et à centraliser leur gestion.

• Transmission de paramètres entre les nœuds

  Lorsqu'un nœud en aval nécessite des paramètres de sortie provenant de plusieurs nœuds en amont situés à différents niveaux, regroupez-les dans un nœud de paramètre. Ajoutez tous les paramètres requis au nœud de paramètre, puis configurez le nœud en aval pour qu'il dépende directement de ce dernier.

  

  Dans l'illustration ci-dessus, le nœud Sq_MySQL_G requiert les paramètres de sortie des nœuds Sq_MySQL_B et Sq_MySQL_E. Utilisez un nœud de paramètre comme nœud en aval pour les nœuds Sq_MySQL_B et Sq_MySQL_E. Ajoutez tous les paramètres dont Sq_MySQL_G a besoin au nœud de paramètre. Définissez ensuite Sq_MySQL_G comme nœud en aval du nœud de paramètre afin de recevoir ses paramètres de sortie. De cette manière, Sq_MySQL_G peut obtenir les paramètres de Sq_MySQL_B et Sq_MySQL_E via le nœud de paramètre.

• Gestion centralisée des paramètres

  Lorsque les nœuds de tâche en aval d'un workflow ont besoin de certains paramètres constants ou variables, ajoutez-les tous à un seul nœud de paramètre. Les nœuds en aval dépendent alors directement du nœud de paramètre, ce qui permet de centraliser la gestion des paramètres pour le workflow.

  

  Dans l'illustration ci-dessus, les nœuds Sq2_MySQL_A, Sq2_MySQL_C, Sq2_MySQL_D, Sq2_MySQL_E et Sq2_MySQL_F nécessitent tous des paramètres. Utilisez un nœud de paramètre pour obtenir les paramètres de sortie des nœuds en amont et configurer les paramètres variables ou constants nécessaires. Ce nœud de paramètre sert alors de dépendance en amont pour ces nœuds.

Prérequis

• Le compte RAM que vous souhaitez utiliser a été ajouté à votre espace de travail.

  Si vous voulez utiliser un compte RAM pour développer des tâches, ajoutez-le à votre espace de travail en tant que membre et attribuez-lui le rôle Develop ou Workspace Administrator. Le rôle Workspace Administrator dispose de plus d'autorisations que nécessaire. Faites preuve de prudence lors de l'attribution de ce rôle. Pour plus d'informations sur l'ajout d'un membre et l'attribution de rôles, consultez la rubrique Ajouter des membres à un espace de travail.

• Un groupe de ressources serverless est associé à votre espace de travail. Pour plus d'informations, consultez les rubriques du répertoire Utiliser des groupes de ressources serverless.

• Avant de pouvoir configurer un nœud de paramètre, vous devez en créer un. Pour plus d'informations, consultez la rubrique Créer des nœuds pour un workflow planifié.

Remarque

Pour référencer les paramètres d'un nœud de paramètre, un nœud de tâche doit être son nœud en aval direct et définir le nœud de paramètre comme dépendance en amont.

Étape 1 : Configurer le nœud de paramètre

Vous pouvez créer des paramètres constants, des paramètres variables et des variables de transmission dans un nœud de paramètre. Les sections suivantes décrivent comment configurer chaque type.

Une fois la configuration des paramètres du nœud de paramètre terminée, configurez ses paramètres de planification. Pour plus d'informations, consultez la rubrique Configurer les paramètres de planification.

Étape 2 : Utiliser les paramètres dans les nœuds en aval

Après avoir configuré le nœud de paramètre, utilisez ses paramètres directement dans les nœuds en aval pour une gestion centralisée des paramètres.

1. Associez les paramètres du nœud de paramètre en amont.

   1. Ouvrez l'éditeur du nœud de paramètre et cliquez sur Paramètres de planification sur le côté droit. Dans Scheduling Settings > Scheduling Dependency > Node dependency configuration, cliquez sur Ajouter une dépendance et configurez le nœud de paramètre comme dépendance en amont.

   2. Après avoir configuré la dépendance, accédez à l'onglet Scheduling Parameters et cliquez sur Add parameters. Configurez les paramètres suivants :

      1. Saisissez un nom personnalisé pour le nouveau paramètre.

      2. Cliquez sur le bouton pour rechercher et associer un paramètre de sortie du nœud de paramètre en amont.

2. Une fois les paramètres configurés, référencez-les dans le script du nœud en utilisant ${parameter name} pour obtenir les paramètres transmis par le nœud de paramètre.

Étape 2 : Déployer et gérer le nœud

1. Une fois les paramètres de planification terminés, soumettez et déployez le nœud ainsi que ses nœuds en amont et en aval dans l'environnement de production. Pour plus d'informations, consultez la rubrique Déployer des nœuds.

2. Après le déploiement, la tâche s'exécute périodiquement selon la planification que vous avez configurée. Consultez les tâches planifiées déployées et effectuez des opérations d'exploitation et de maintenance (O&M) dans Operation and Maintenance Center > Node O&M > Auto Triggered Task O&M > Auto Triggered Task. Pour plus d'informations, consultez la rubrique Gérer les tâches planifiées.