Un nœud de paramètre est un nœud virtuel qui gère les paramètres au sein des flux de travail et assure leur transmission entre les différents nœuds. Il prend en charge les paramètres constants, les paramètres variables ainsi que la transmission transparente des paramètres issus des nœuds ancêtres.
Informations générales
Les nœuds de paramètre sont des nœuds virtuels qui n'exécutent pas de tâches de calcul. Ils transmettent les paramètres entre les nœuds et les gèrent au sein des flux de travail.
-
Parameter passing between nodes
Si un nœud d'un flux de travail nécessite les paramètres de sortie de ses nœuds ancêtres, créez un nœud de paramètre pour faire office d'intermédiaire. Placez-le en tant que descendant de ces nœuds ancêtres et en tant qu'ancêtre du nœud cible, puis ajoutez-y tous les paramètres requis.
Dans l'illustration ci-dessus, le nœud sql_7 a besoin des paramètres de sortie des nœuds sql_1, sql_3 et sql_4. Un nœud de paramètre est inséré entre eux pour collecter et transmettre tous les paramètres requis au nœud sql_7. -
Parameter management
Si plusieurs nœuds d'un flux de travail partagent des paramètres constants ou variables, créez un nœud de paramètre qui servira d'ancêtre commun et ajoutez-y tous les paramètres partagés. Cette approche permet de centraliser la gestion des paramètres pour l'ensemble du flux de travail.
Dans l'illustration ci-dessus, les nœuds sql_3, sql_4, sql_5 et sql_7 partagent des paramètres via un nœud de paramètre commun qui agit comme leur ancêtre.
Précautions
Pour qu'un nœud puisse utiliser les paramètres définis dans un nœud de paramètre, il doit être un descendant direct de ce dernier.
Limites
Régions prises en charge : Chine (Hangzhou), Chine (Shanghai), Chine (Beijing), Chine (Shenzhen), Chine (Chengdu), Chine (Hong Kong), Japon (Tokyo), Singapour, Malaisie (Kuala Lumpur), Indonésie (Jakarta), Allemagne (Francfort), Royaume-Uni (Londres), États-Unis (Silicon Valley) et États-Unis (Virginie).
Créer un nœud de paramètre
-
Connectez-vous à la console DataWorks. Dans la région cible, accédez au volet de navigation de gauche et cliquez sur . Sélectionnez un espace de travail dans la liste déroulante, puis cliquez sur Go to Data Development.
-
Sur la page DataStudio , survolez l'icône
et choisissez .Vous pouvez également ouvrir un flux de travail, effectuer un clic droit sur General , puis choisir .
Dans la boîte de dialogue Create Node , saisissez un Name et sélectionnez un Path .
Cliquez sur OK .
Configurer les propriétés de planification du nœud de paramètre
Après avoir créé le nœud de paramètre, configurez ses propriétés de planification en fonction de vos besoins métier.
Les propriétés de planification incluent les propriétés de base, les propriétés temporelles, les propriétés de ressources et les dépendances de planification. Étant donné qu'un nœud de paramètre se contente de gérer et de transmettre des paramètres sans exécuter de tâches de développement de données, portez une attention particulière à ses dépendances de planification.
Pour qu'un nœud utilise les paramètres d'un nœud de paramètre, il doit être un descendant de ce nœud de paramètre.
Les nœuds ancêtres dont les paramètres doivent être transmis de manière transparente doivent être des nœuds ancêtres du nœud de paramètre.
Pour plus d'informations sur la configuration des propriétés de planification d'un nœud de paramètre, consultez les rubriques Configurer les propriétés de base , Configurer les propriétés temporelles , Configurer la propriété de ressource et Configurer les dépendances de planification sur le même cycle .
Ajouter des paramètres au nœud de paramètre
Une fois les propriétés de planification configurées, ajoutez au nœud de paramètre les paramètres que vous souhaitez gérer ou transmettre.
Sur la page de configuration du nœud de paramètre, cliquez sur Add Parameter .
-
Configurez le Parameter name , le Type , la Value et la Description , puis cliquez sur Save .
Une note en haut de la page vous rappelle que tout nœud faisant référence à ces paramètres doit être un descendant direct de ce nœud de paramètre. Les types de paramètres disponibles sont Constant , Variable et Pass-through Variable .
Constant : Le paramètre possède une valeur fixe.
Variable : La valeur du paramètre est dynamique. Sélectionnez ce type si vous devez utiliser des variables système, telles que l'heure actuelle. Pour plus d'informations sur les formats pris en charge, consultez la rubrique Formats pris en charge pour les paramètres de planification .
Pass-through Variable : Transmet un paramètre de sortie d'un nœud ancêtre direct à un nœud descendant. Pour ce type, sélectionnez la valeur dans une liste contenant tous les paramètres de sortie disponibles provenant des nœuds ancêtres directs de ce nœud de paramètre.
Étapes suivantes : Utiliser les paramètres du nœud de paramètre
Une fois le nœud de paramètre configuré, ses nœuds descendants peuvent utiliser directement les paramètres, ce qui permet une gestion centralisée des paramètres et un développement des tâches plus efficace.
Pour exploiter ces paramètres, configurez-les en tant que paramètres d'entrée des nœuds descendants afin qu'ils puissent être référencés directement dans le code du nœud.
-
Configurez les paramètres en tant que paramètres d'entrée des nœuds descendants.
Pour le nœud descendant, accédez à la section . Dans la sous-section Input Parameters , cliquez sur Add . Saisissez le nom du paramètre, sélectionnez la source de la valeur, puis cliquez sur Save. Voici les détails de la configuration :
Nom du paramètre : nom du paramètre que le nœud descendant doit utiliser. Vous pouvez consulter le nom du paramètre dans le nœud de paramètre.
-
Source de la valeur : source du paramètre que le nœud descendant doit utiliser.
Survolez les informations tronquées sur le paramètre pour afficher les détails complets. Les paramètres provenant du nœud de paramètre sont affichés au format Output name of the parameter node:Parameter name . Sélectionnez le nom de la source se terminant par le nom du paramètre requis.
Utilisez les paramètres dans le code du nœud descendant.