Connexions paramétrées
Utilisez des connexions paramétrées pour gérer la même connexion dans plusieurs environnements (développement, préproduction, production) et pour éviter de coder en dur les identifiants.
Utilisation de connexions paramétrées
Pour gérer les valeurs de connexion dans différents environnements à l'aide de connexions paramétrées, cochez la case « Activer les paramètres » dans l'onglet « Aperçu de la connexion ». Une fois la connexion paramétrée activée, vous pouvez soit importer le jeu de paramètres existant, soit en créer un nouveau. Lorsque cette option est désactivée, les valeurs sont enregistrées directement dans la configuration de la connexion.
Comportement lors de l'exécution
L'activation des connexions paramétrées n'a aucune incidence sur la manière dont vous exécutez les tâches. Aucune étape supplémentaire n'est nécessaire lors de l'exécution, car la plateforme résout toutes les valeurs des paramètres avant d'appeler le connecteur. Par conséquent, les services en aval (par exemple, watsonx.ai ) reçoivent des valeurs de connexion entièrement résolues et n'ont pas connaissance des jeux de paramètres.
Importation des propriétés de connexion
- Dans l'onglet « Aperçu de la connexion », cochez la case « Activer les paramètres ».
- Cliquez sur l'onglet « Sélectionner un ensemble de paramètres ».
- Dans la fenêtre « Propriétés de la connexion d'importation », sélectionnez l'ensemble de paramètres dans la liste déroulante.
- Dans l'onglet « Paramètres candidats », sélectionnez les paramètres à importer, puis cliquez sur « Ajouter ».
Création d'un nouvel ensemble de paramètres
Si vous ne disposez pas encore d'un jeu de paramètres à utiliser pour votre connexion, créez-en un nouveau et importez-y les propriétés de connexion que vous souhaitez y inclure.
- Dans l'onglet « Aperçu de la connexion », cochez la case « Activer les paramètres ».
- Cliquez sur l'onglet « Sélectionner un ensemble de paramètres ».
- Dans la fenêtre « Propriétés de la connexion d'importation », cliquez sur le bouton « Ajouter un jeu de paramètres ».
- Dans la fenêtre « Définir des ensembles de paramètres réutilisables », saisissez le nom de l'ensemble de paramètres et ajoutez (si vous le souhaitez) une description. Cliquez ensuite sur Créer.
- Dans la fenêtre des paramètres, sélectionnez l'onglet « Importer les propriétés de connexion ».
- Sélectionnez un type de connexion dans la liste déroulante.
- Sélectionnez les paramètres que vous souhaitez importer dans votre jeu de paramètres et examinez les colonnes suivantes dans le tableau d'importation :
- Nom - Le nom du paramètre.
- Type - Le type du paramètre, par exemple chaîne de caractères (ligne unique, plusieurs lignes, chiffrée), entier ou booléen.
- Invite - Un titre descriptif pour le paramètre.
- Valeur par défaut - Une valeur facultative que vous pouvez indiquer lors de l'importation. Elle sert de solution de secours si aucune valeur spécifique à l'environnement n'est définie au moment de l'exécution. Si vous laissez ce champ vide, le paramètre n'a pas de valeur par défaut et doit être défini dans un ensemble de valeurs.
- Texte d'aide - Brève description du paramètre.
- Cliquez sur « Importer ».
- (Facultatif) Cliquez sur l'icône Modifier pour modifier le type de paramètre, ajouter une description ou attribuer une valeur par défaut. Vous pouvez également supprimer un paramètre de l'ensemble de paramètres.
Lors de la création d'un ensemble de paramètres, vous pouvez ajouter des variables d'environnement que vous souhaitez utiliser comme paramètres dans votre flux ou créer de nouveaux paramètres.
Ajouter des ensembles de valeur
Vous pouvez définir un ensemble de valeurs, c'est-à-dire un ensemble nommé de valeurs pour les paramètres d'un ensemble de paramètres. Chaque ensemble de valeurs correspond à un environnement spécifique, tel que le développement, la préproduction ou la production, et contient les valeurs adaptées à cet environnement. Au moment de l'exécution, la plateforme applique l'ensemble de valeurs correspondant à l'environnement dans lequel le pipeline de données est exécuté.
Par exemple, un ensemble de paramètres pour une connexion peut inclure des propriétés telles que le nom d'utilisateur, le mot de passe et l'hôte. Vous pouvez définir un ensemble de valeurs distinct pour chaque environnement (par exemple, un avec les identifiants de développement et un autre avec ceux de production) afin que les valeurs appropriées soient appliquées automatiquement en fonction de l'environnement dans lequel le pipeline s'exécute.
Pour créer un ensemble de valeurs :
- Dans la fenêtre des paramètres, ouvrez l'onglet « Ensembles de valeurs ».
- Cliquez sur « Créer un ensemble de valeurs ».
- Dans la fenêtre « Créer un ensemble de valeurs », saisissez un nom pour votre ensemble de valeurs.
- Pour chaque paramètre de l'ensemble de paramètres, indiquez la valeur à utiliser dans cet environnement.
- Cliquez sur « Enregistrer ».
Gestion et modification des jeux de paramètres pour les connexions
Vous pouvez consulter et modifier vos jeux de paramètres dans le tableau « Ressources » de votre projet. Vous pouvez y importer des propriétés de connexion supplémentaires (les propriétés déjà paramétrées ne seront pas dupliquées), ajouter des variables d'environnement et créer de nouveaux paramètres pour vos jeux.
Instructions
Lorsqu'un ensemble de paramètres contient des propriétés provenant de plusieurs types de connexion, la plateforme affiche un avertissement sans blocage. Cet avertissement est purement informatif, sert de guide et n'a aucune incidence sur l'exécution ou la configuration. Cela ne vous empêche pas de continuer, et aucune mesure immédiate n'est requise. Cela indique que votre jeu de paramètres est conforme à l'utilisation de la fonctionnalité « DataStage-style », dans laquelle un seul jeu de paramètres prend en charge plusieurs connexions. Vous pouvez toujours utiliser des jeux de paramètres combinant plusieurs types de connexion.
Si vous prévoyez d'utiliser un ensemble de paramètres pour une liaison de connexion 1:1, vous pouvez créer un ensemble de paramètres contenant uniquement les propriétés d'un seul type de connexion.