Documentation Oracle Cloud Infrastructure

Créer et utiliser des variables

Une variable est un objet qui stocke une seule valeur, qui peut être une chaîne, un nombre ou une date.

Sujets

  • Création d'une variable
    Vous pouvez indiquer la valeur des variables lorsque vous créez la variable ou que vous définissez la valeur à l'aide d'une expression de requête.
  • Utilisation de variables dans un flux de données
    Vous pouvez utiliser des variables dans un flux de données en les utilisant comme définition de filtre. Vous pouvez faire référence aux variables d'un flux de données au format #<variable_name>. Au cours de l'exécution, la variable est remplacée par la valeur.
  • Utilisation de variables dans un workflow
    Le panneau de gauche de la page Détails du workflow répertorie les variables que vous pouvez utiliser en tant qu'étapes dans un workflow.

Rubrique parent : Page Data Transforms

créer une variable ;

Vous pouvez indiquer la valeur des variables lorsque vous créez la variable ou que vous définissez la valeur à l'aide d'une expression de requête.

La page Variables répertorie toutes les variables existantes. Cliquez sur l'icône Actions (Icône Actions) d'une variable pour la modifier, l'actualiser ou la supprimer. Toutes les variables disponibles sont également répertoriées dans le panneau de gauche de la page Détails du workflow. Vous pouvez utiliser des variables en tant qu'étapes dans les flux de données et les workflows.

Pour créer une variable :

  1. Sur la page d'accueil, cliquez sur le titre de projet requis. Accédez à la page Détails du projet.
  2. Dans le panneau gauche, cliquez sur Variables. La page Créer une variable apparaît.
  3. Entrez le nom de la variable.
  4. Dans la liste déroulante Type de données, sélectionnez l'une des options suivantes :
    • Texte court : la valeur peut être alphanumérique, contenir des caractères spéciaux et ne peut pas dépasser 255 caractères.
    • Texte long : la valeur peut être alphanumérique, contenir des caractères spéciaux et ne peut pas dépasser 64000 caractères.
    • Numérique : la valeur peut être une valeur numérique et être précédée d'un signe moins (-). La valeur ne peut pas dépasser 10 chiffres. La plage de valeurs possibles est -999999999 à 999999999.
    • Date : la valeur est un format de date.
  5. Dans le champ Valeur par défaut, entrez la valeur à affecter à la variable. La valeur autorisée dépend du type de données sélectionné.
  6. Pour les variables que vous modifiez, vous pouvez cliquer sur le menu Actions en regard de la variable pour ouvrir la page Refresh Variable afin de mettre à jour la valeur. Dans la liste déroulante Conserver l'historique, sélectionnez le mode d'affichage de la valeur de variable sur la page Actualiser la variable :
    • Toutes les valeurs : vous pouvez voir l'historique de toutes les valeurs de cette variable.
    • Dernière valeur : vous ne pouvez voir que la dernière valeur indiquée pour la variable.
    • Aucun historique : les transformations de données ne conservent pas l'historique des valeurs détenues par cette variable.
    • Valeur sécurisée : cette option est utile lorsque la variable contient des mots de passe ou d'autres données confidentielles. La valeur n'est pas affichée dans la page Refresh Variable.
  7. Entrez une description pour la variable.
  8. Si vous souhaitez que la valeur de variable soit définie par une requête, cliquez sur l'onglet Actualiser. Sélectionnez le type de connexion et le schéma dans lesquels vous souhaitez exécuter la commande. Entrez la requête et cliquez sur Valider pour vérifier la syntaxe de l'expression.
  9. Cliquez sur Enregistrer.

    La variable nouvellement créée est répertoriée dans la page Variables ainsi que dans le noeud Variables du panneau de gauche de la page Détails du workflow.

Utilisation de variables dans un flux de données

Vous pouvez utiliser des variables dans un flux de données en les utilisant comme définition de filtre. Vous pouvez faire référence aux variables d'un flux de données au format #<variable_name>. Au cours de l'exécution, la variable est remplacée par la valeur.

Lorsque vous exécutez le flux de données, la page Valeurs de variable qui affiche la liste des variables que vous avez ajoutées au flux de données apparaît. Vous pouvez choisir d'utiliser la valeur actuelle, la valeur par défaut ou de définir une valeur personnalisée pour chaque variable. Notez que la valeur personnalisée est appliquée uniquement à l'exécution en cours du flux de données. La valeur personnalisée n'est pas conservée pour les sessions suivantes.

Voici un exemple d'utilisation d'une variable dans un flux de données :


Description de l'image variables_in_data_flows.png
Description de l'image variables_in_data_flows.png

Dans cet exemple, le flux de données utilise la variable DEVICE_TYPE en tant qu'étape avec l'ensemble de conditions de filtre comme suit :

MOVIESALES_CA.DEVICE = '#DEVICE_TYPE'

La variable est entre guillemets car la valeur de substitution doit être entre guillemets. Etant donné que la valeur de la variable est remplacée au cours de l'exécution, vous pouvez l'utiliser dans de nombreux cas d'emploi tels que l'expression de transformation dans le mapping.

Utilisation de variables dans un workflow

Le panneau de gauche de la page Détails du workflow répertorie les variables que vous pouvez utiliser en tant qu'étapes dans un workflow.

Vous pouvez glisser-déplacer les variables à utiliser dans le workflow sur le canevas de conception. Le panneau Propriétés disponible sur le côté droit du canevas de conception affiche divers détails sur l'étape, tels que les suivants.
  • Nom, Type et le numéro de séquence de l'étape. Il s'agit de valeurs non modifiables.
  • Cliquez sur le lien sous Objet lié pour visualiser et mettre à jour les détails de la variable.
  • Opération : sélectionnez l'une des options suivantes :
    • Définir la variable : cette étape possède deux fonctions :

      La fonction Mettre à jour définit la valeur en cours d'une variable.

      La incrémentation augmente ou diminue une valeur numérique en fonction du nombre spécifié.

    • Actualiser la variable : cette étape de variable actualise la variable en exécutant la requête indiquée dans sa définition.
    • Evaluer la variable : ce type d'étape de variable compare la valeur de la variable avec une valeur donnée en fonction d'un opérateur. Lorsque la condition est remplie, l'étape d'évaluation prend la valeur True. Sinon, la valeur est False.
  • Nombre de tentatives en cas d'échec
  • Temps entre les tentatives en secondes
  • Etapes de journalisation dans le journal : vous pouvez sélectionner Toujours, Jamais ou Erreur.

Lorsque vous exécutez le workflow, la page Valeurs de variable qui affiche la liste des variables que vous avez ajoutées au workflow s'affiche. Vous pouvez choisir d'utiliser la valeur actuelle, la valeur par défaut ou de définir une valeur personnalisée pour chaque variable. Notez que la valeur personnalisée est appliquée uniquement à l'exécution en cours du workflow. La valeur personnalisée n'est pas conservée pour les sessions suivantes.

Voici un exemple d'utilisation d'une variable dans un workflow :


Description de l'image variables_in_workflows.png
Description de l'image variables_in_workflows.png

Dans cet exemple, une variable appelée DEVICE _TYPE avec la valeur "iphone" est utilisée comme étape dans le workflow. Le workflow effectue les opérations suivantes :

  1. Exécutez le flux de données "REFRESH_DEVICE".
  2. Si l'exécution du flux de données "REFRESH_DEVICE" réussit, exécutez le flux de données "Load_movies_for_device".
  3. Si l'exécution du flux de données "Load_movies_for_device" réussit, exécutez l'étape d'évaluation de la variable "IF_IPHONE".
  4. Si la valeur de la variable est égale à 'iphone', exécutez le chemin pour "true".
  5. Si la valeur de la variable n'est pas égale à 'iphone', exécutez le chemin pour "false".