Utilisation d'opérateurs de pipeline

Dans Data Integration, les opérateurs de pipeline représentent différentes tâches et activités pouvant être utilisées dans un pipeline.

Les types d'opérateur de tâche que vous pouvez utiliser dans un pipeline sont les suivants :

  • Opérateurs de tâche d'intégration et de programme de chargement de données qui vous permettent d'exécuter des solutions d'intégration de données dans un pipeline. Vous pouvez configurer des entrées pour les opérateurs. Les entrées d'opérateur de tâche sont semblables aux paramètres définis au niveau d'une tâche ou d'un flux de données.
  • Opérateurs de tâche SQL qui vous permettent d'exécuter des procédures SQL stockées dans un pipeline. Vous pouvez configurer des valeurs pour les paramètres dans les procédures stockées.
  • Opérateurs de tâche OCI Data Flow qui vous permettent d'exécuter des applications OCI Data Flow dans un pipeline.
  • Opérateurs de tâche REST qui vous permettent d'exécuter des adresses d'API REST dans un pipeline. Vous pouvez reconfigurer les valeurs des paramètres utilisés dans la tâche REST.
  • Opérateurs de tâche de pipeline qui vous permettent d'exécuter un autre pipeline dans un pipeline.

Veillez à consulter les informations de support et considérations relatives à l'utilisation des pipelines avant de créer ou de modifier un pipeline. Par exemple, faites attention au niveau de profondeur imbriqué et à la limite de tâche par niveau.

Pour tous les opérateurs de tâche, vous pouvez sélectionner des tâches de conception à partir des projets de l'espace de travail en cours et des tâches publiées à partir de n'importe quelle application de l'espace de travail en cours. Avec les tâches REST publiées et les tâches OCI Data Flow, vous pouvez également sélectionner une tâche à partir de n'importe quelle application dans un autre espace de travail du même compartiment ou d'un autre compartiment.

Pour les tâches exécutées en parallèle, vous pouvez utiliser un opérateur de fusion et indiquer une condition pour gérer les opérations en aval ultérieures. Pour utiliser la sortie d'un opérateur et la transmettre à l'opérateur suivant, vous pouvez recourir à un opérateur d'expression.

Vous utilisez un concepteur semblable au concepteur de flux de données pour créer un pipeline. Le concepteur est ouvert avec un opérateur de début et un opérateur de fin déjà placés sur le canevas. Un pipeline ne peut comporter qu'un seul opérateur de début et un seul opérateur de fin. Un pipeline doit inclure au moins un opérateur de tâche pour être valide. Vous pouvez ajouter le nombre de tâches de votre choix, puis les connecter dans une séquence entre l'opérateur de début et l'opérateur de fin. A partir du panneau Opérateurs, faites glisser les opérateurs vers le canevas pour concevoir le pipeline. Utilisez ensuite le panneau Propriétés pour configurer les propriétés de chaque opérateur.

Les tâches connectées directement à l'opérateur de début sont toujours exécutées. Les tâches suivantes dans la séquence peuvent être configurées pour être exécutées en fonction de la condition de l'opérateur précédent. Par exemple, prenons un pipeline dont la séquence est Début > Tâche A > Tâche B > Fin. La tâche A est toujours exécutée. Pour la tâche B, vous pouvez utiliser la propriété Condition de lien entrante dans le panneau Propriétés pour configurer la tâche de sorte qu'elle soit toujours exécutée, ou exécutée uniquement lorsque le statut de la tâche A répond à une condition d'exécution spécifique.

Pour connecter des opérateurs, positionnez le curseur de la souris sur un opérateur jusqu'à ce que le connecteur (petit cercle) apparaisse à droite de l'opérateur. Ensuite, faites glisser le connecteur vers l'opérateur suivant auquel vous souhaitez vous connecter. La connexion est valide lorsqu'une ligne connecte les opérateurs une fois que vous avez déposé le connecteur.

En général, un opérateur ne comporte qu'un seul port entrant, et des ports sortants permettant aux processus de parcourir le pipeline. Par exemple, vous pouvez connecter le même port sortant d'opérateur de tâche SQL aux ports entrants de deux opérateurs d'expression distincts. Seuls l'opérateur de fin et l'opérateur de fusion peuvent comporter plusieurs ports entrants.

Vous pouvez rapidement dupliquer une tâche ou un opérateur d'expression qui a été ajouté à un pipeline. Pour dupliquer l'opérateur, cliquez avec le bouton droit de la souris sur l'icône de l'opérateur sur le canevas et sélectionnez Duplicate dans le menu qui apparaît. Renommez ensuite l'identificateur de l'opérateur dupliqué dans le panneau Propriétés. Si l'opérateur d'origine est connecté à d'autres opérateurs, les connexions et les références aux sorties d'un opérateur précédent ne sont pas copiées vers l'opérateur dupliqué.

Opérateur de début et opérateur de fin

Lorsque vous commencez à créer un pipeline, le concepteur est ouvert avec un opérateur de début et un opérateur de fin déjà placés sur le canevas. Un pipeline ne peut comporter qu'un seul opérateur de début et un seul opérateur de fin.

L'opérateur de début ne possède aucune propriété que vous pouvez configurer.

Avec l'opérateur de fin, vous pouvez configurer la propriété condition de lien entrante afin de spécifier l'une des règles suivantes pour le statut d'une exécution de tâche de pipeline :

  • Tous terminés : le statut de tâche de pipeline affiché est Succès, même en cas d'échec de l'une des tâches du pipeline.
  • Tous les éléments réussis : le statut de tâche de pipeline affiché est Terminé lorsque toutes les tâches du pipeline sont réussies.
  • Tous les échecs : le statut de tâche de pipeline affiché est Succès en cas d'échec de toutes les tâches du pipeline.

Opérateur de fusion

Pour les tâches exécutées en parallèle, vous pouvez utiliser l'opérateur de fusion et indiquer une condition pour décider comment gérer les opérations en aval ultérieures.

Ajout et configuration d'un opérateur de fusion

Un opérateur de fusion peut comporter plusieurs liens d'entrée (en amont) et plusieurs liens de sortie (en aval).

  1. A partir du panneau Opérateurs, faites glisser l'opérateur Fusionner vers le canevas.
  2. Dans l'onglet Détails du panneau Propriétés, entrez un nom et une description facultative pour l'opérateur de fusion.
  3. Pour condition de fusion, vous pouvez sélectionner l'une des options suivantes :
    • Tous les éléments réussis : toutes les opérations parallèles liées en amont doivent se terminer et réussir pour que l'opération en aval suivante puisse continuer. Il s'agit de l'option par défaut.
    • Tous les échecs : toutes les opérations parallèles liées en amont doivent se terminer et échouer pour que l'opération en aval suivante puisse continuer.
    • Tous les éléments terminés : toutes les opérations parallèles liées en amont doivent se terminer pour que l'opération en aval suivante puisse continuer.
    • Au moins un succès : au moins une opération liée en amont doit se terminer et réussir pour que l'opération en aval suivante puisse continuer.
    • Au moins un échec : au moins une opération liée en amont doit se terminer et échouer pour que l'opération en aval suivante puisse continuer.
  4. Dans l'onglet Résultat du panneau Propriétés, vous pouvez visualiser les résultats qui peuvent être utilisés comme entrées pour l'opérateur suivant dans le pipeline.
    Les sorties disponibles sont la combinaison de paramètres de sortie du système et des sorties de chaque opérateur de tâche connecté à l'opérateur de fusion.

Opérateur d'expression

Un opérateur d'expression de pipeline permet de créer des champs dérivés dans un pipeline, comme un opérateur d'expression dans un flux de données.

Ajout et configuration d'un opérateur d'expression

Contrairement à un opérateur d'expression de flux de données, un opérateur d'expression de pipeline n'agit pas sur les données. Un opérateur d'expression de pipeline vous permet d'agir sur la sortie de l'opérateur précédent, les paramètres de pipeline et la sortie générée par le système.

  1. Dans le panneau Opérateurs, faites glisser l'opérateur Expression vers le canevas.
  2. Avec le focus sur l'opérateur d'expression, dans l'onglet Détails du panneau Propriétés, entrez un nom dans le champ Identificateur ou laissez le nom en l'état.
  3. (Facultatif) Pour Condition de lien entrante, vous pouvez sélectionner l'une des conditions d'exécution suivantes. Lorsque les opérateurs sont connectés, une ligne colorée indique la condition sélectionnée.
    • Toujours exécuter : exécute le noeud sélectionné quel que soit le statut du noeud en amont.

      Une ligne grise indique la condition Toujours exécuter.

      Vous ne pouvez pas modifier la condition de lien pour les noeuds connectés directement à l'opérateur de début.

    • Exécuter en cas de succès de l'opérateur précédent : exécute le noeud sélectionné uniquement lorsque le statut du noeud en amont est Su succès.

      Une ligne verte avec une coche indique une condition de succès.

    • Exécuter en cas d'échec de l'opérateur précédent : exécute le noeud sélectionné uniquement lorsque le statut du noeud en amont est Echec.

      Une ligne rouge avec une croix "x" indique une condition d'échec.

  4. Sous Expressions, cliquez sur Ajouter.
  5. Dans le panneau Ajouter une expression, entrez un nom dans le champ Identificateur ou laissez le nom tel quel.
  6. Sélectionnez le type de l'expression.
  7. Selon le type sélectionné, vous devrez peut-être spécifier d'autres valeurs, telles qu'une longueur ou une échelle.
  8. Cliquez sur Créer une expression dans le générateur d'expression, puis sur Ajouter.
    La valeur dérivée d'une expression peut être utilisée dans l'opérateur suivant connecté à cet opérateur d'expression de pipeline.
  9. Répétez ces étapes pour ajouter d'autres expressions.
  10. Dans l'onglet sortie du panneau Propriétés, vous pouvez visualiser les sorties d'expression qui peuvent être utilisées comme entrées pour l'opérateur suivant dans le pipeline.
    Chaque expression que vous ajoutez possède une sortie. La sortie porte le même nom que l'expression.
  11. Dans l'onglet Validation du panneau Propriétés, vous pouvez valider l'opérateur pour rechercher les erreurs et les avertissements.
Ajout d'une expression

Utilisez le générateur d'expressions pour sélectionner visuellement des éléments afin de créer une expression pour un opérateur d'expression dans un pipeline. Vous pouvez également entrer une expression manuellement dans l'éditeur.

Le générateur d'expressions est une section du panneau Ajouter une expression.

  1. Dans le générateur d'expression, cliquez deux fois pour sélectionner ou faites glisser une valeur entrante, un paramètre ou une fonction afin de créer l'expression.
    Une expression peut être une combinaison de sorties système d'un opérateur précédent, de paramètres système, de paramètres définis par l'utilisateur et de fonctions.
  2. Pour les valeurs entrantes, vous pouvez choisir parmi les sorties système de l'opérateur précédent. Si l'opérateur précédent est un opérateur de fusion, les sorties système sont les sorties combinées des opérateurs de tâche connectés à l'opérateur de fusion.
  3. Pour Paramètres, vous pouvez choisir parmi les paramètres système et les paramètres définis par l'utilisateur créés dans le pipeline.
    • Définition par l'utilisateur : un paramètre défini par l'utilisateur est un paramètre personnalisé que vous créez.

      Vous pouvez sélectionner un paramètre existant dans la liste des paramètres définis par l'utilisateur disponibles ou cliquer sur Ajouter pour en créer un.

      1. Dans le panneau Ajouter un paramètre, entrez le nom du paramètre et une description (facultatif).
      2. Sélectionnez le type de données pour ce paramètre.
      3. Définissez les autres champs pour ce paramètre en fonction du type de données sélectionné.
      4. Définissez une valeur par défaut pour ce paramètre.
      5. Cliquez sur Ajouter.
    • Défini par le système : lors de l'exécution, Data Integration génère certains paramètres système pour un pipeline. Les valeurs de paramètre système générées peuvent être utilisées dans des expressions, mais elles ne peuvent pas être modifiées.
  4. Pour Fonctions, vous pouvez choisir parmi les fonctions Data Integration disponibles pour les opérateurs de pipeline.
  5. Dans le panneau Ajouter une expression, cliquez sur Ajouter pour créer ou mettre à jour l'expression.
Suppression d'une expression

Vous pouvez supprimer des expressions lorsque vous n'en avez plus besoin.

  1. Sur le canevas d'un pipeline, sélectionnez un opérateur d'expression.
  2. Avec le focus sur l'opérateur d'expression, dans l'onglet Détails du panneau Propriétés, sélectionnez l'expression à supprimer, puis cliquez sur Supprimer.
  3. Dans la boîte de dialogue Supprimer l'expression, vérifiez que vous voulez supprimer cette expression, puis cliquez sur Supprimer.

Opérateur de décision

Utilisez l'opérateur de décision pour écrire une condition booléenne qui détermine le flux de branchement dans le pipeline. Le branchement est basé sur trois résultats possibles, à savoir TRUE, FALSE et ERROR.

Ajout et configuration d'un opérateur de décision

Un opérateur de décision possède une liaison d'entrée (en amont) et trois liaisons de sortie (en aval).

  1. Dans le panneau Opérateurs, faites glisser l'opérateur Décision sur le canevas.

    Par défaut, l'icône de l'opérateur de décision est développée et affiche trois ports de sortie, à savoir TRUE, FALSE et ERROR.

  2. Dans l'onglet Détails du panneau Propriétés, entrez un nom et une description facultative pour l'opérateur de décision.
  3. Pour Condition de décision, procédez comme suit :
    1. Cliquez sur Ajouter.
    2. Dans le panneau Ajouter une condition de décision, écrivez une condition à l'aide de valeurs, de paramètres ou de fonctions entrants, de sorte que l'expression de condition renvoie une valeur booléenne.

      Par exemple, une condition peut évaluer le statut d'exécution de la tâche précédente : PREVIOUS_TASK_1.SYS.STATUS = 'SUCCESS'

      • Pour les valeurs entrantes, vous pouvez choisir parmi les sorties système de l'opérateur précédent.

      • Pour Paramètres, vous pouvez choisir parmi les paramètres système et les paramètres définis par l'utilisateur créés dans le pipeline.

        • Définition par l'utilisateur : un paramètre défini par l'utilisateur est un paramètre personnalisé que vous créez.

          Vous pouvez sélectionner un paramètre existant dans la liste des paramètres définis par l'utilisateur disponibles ou cliquer sur Ajouter pour en créer un.

        • Défini par le système : lors de l'exécution, Data Integration génère certains paramètres système pour un pipeline. Les valeurs de paramètre système générées peuvent être utilisées dans des expressions, mais elles ne peuvent pas être modifiées.

      • Pour Fonctions, vous pouvez choisir parmi les fonctions Data Integration disponibles pour les opérateurs de pipeline.

  4. (Facultatif) Pour Condition de lien entrante, vous pouvez sélectionner l'une des conditions d'exécution suivantes. Lorsque les opérateurs sont connectés, une ligne colorée indique la condition sélectionnée.
    • Toujours exécuter : exécute le noeud sélectionné quel que soit le statut du noeud en amont.

      Une ligne grise indique la condition Toujours exécuter.

      Vous ne pouvez pas modifier la condition de lien pour les noeuds connectés directement à l'opérateur de début.

    • Exécuter en cas de succès de l'opérateur précédent : exécute le noeud sélectionné uniquement lorsque le statut du noeud en amont est Su succès.

      Une ligne verte avec une coche indique une condition de succès.

    • Exécuter en cas d'échec de l'opérateur précédent : exécute le noeud sélectionné uniquement lorsque le statut du noeud en amont est Echec.

      Une ligne rouge avec une croix "x" indique une condition d'échec.

  5. Dans le canevas, connectez les ports de sortie appropriés de l'opérateur de décision à un opérateur de tâche ou d'expression en aval.

    Un port de sortie d'opérateur de décision ne peut pas être lié directement à un opérateur de fusion ou à un opérateur de fin.

Opérateur de tâche de programme de chargement de données

Un opérateur de tâche de programme de chargement de données permet d'exécuter une tâche de programme de chargement de données dans un pipeline.

Ajout et configuration d'un opérateur de tâche de programme de chargement de données

Un opérateur de tâche de programme de chargement de données connecté directement à l'opérateur de début est toujours exécuté.

Pour un opérateur de tâche qui n'est pas directement connecté à l'opérateur de début, vous pouvez utiliser la propriété Condition de lien entrante afin de configurer la tâche de sorte qu'elle soit toujours exécutée, ou exécutée uniquement lorsque le statut de l'opérateur précédent répond à une condition d'exécution spécifique.

  1. Dans le panneau Opérateurs, faites glisser l'opérateur Programme de chargement de données vers le canevas.
    L'icône de l'opérateur sur le canevas affiche un nom par défaut, ce qui indique que l'opérateur n'est pas encore lié à une tâche dans l'espace de travail.
  2. Dans l'onglet Détails du panneau Propriétés de l'opérateur de tâche non limité, cliquez sur Sélectionner. Dans le panneau qui apparaît, utilisez le menu pour choisir le type de tâche à ajouter, puis sélectionnez la tâche.

    Tâches de conception : pour utiliser une tâche dans un projet, sélectionnez d'abord un projet dans le menu de liste Projets. Vous pouvez également commencer à saisir un nom de projet pour filtrer la liste et effectuer une sélection dans une liste filtrée de noms correspondants. Seuls les projets de l'espace de travail en cours peuvent être sélectionnés.

    Tâches publiées : les tâches publiées à partir de la dernière application mise à jour dans l'espace de travail et le compartiment en cours sont répertoriées pour sélection. Vous pouvez utiliser les menus pour basculer vers une autre application dans l'espace de travail en cours. Vous pouvez également commencer à saisir un nom dans la zone Espaces de travail ou Applications et effectuer une sélection dans une liste filtrée de noms correspondants.

  3. Dans le panneau Sélectionner une tâche de programme de chargement de données, sélectionnez une tâche et cliquez sur Sélectionner.
    Le nom figurant sur l'icône de l'opérateur sur le canevas devient le nom de la tâche sélectionnée.
  4. Dans l'onglet Détails du panneau Propriétés de l'opérateur de tâche sélectionné :
    1. Renommez l'opérateur si vous le souhaitez.
    2. Pour condition de lien entrante, vous pouvez sélectionner l'une des conditions d'exécution suivantes. Lorsque les opérateurs sont connectés, une ligne colorée indique la condition sélectionnée.
      • Exécuter toujours : exécute la tâche sélectionnée quel que soit le statut de l'opérateur en amont.

        Une ligne grise indique la condition Toujours exécuter.

        Vous ne pouvez pas modifier la condition de lien pour les tâches connectées directement à l'opérateur de début.

      • Exécuter en cas de succès de l'opérateur précédent : exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur en amont est Succès.

        Une ligne verte avec une coche indique une condition de succès.

      • Exécuter en cas d'échec de l'opérateur précédent : exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur en amont est Echec.

        Une ligne rouge avec une croix "x" indique une condition d'échec.

  5. Dans l'onglet Configuration du panneau Propriétés, vous pouvez :
    1. Configurer les options d'exécution pour indiquer comment gérer les exécutions de tâche en échec
    2. Configurer les valeurs de paramètre entrantes
  6. Dans l'onglet Résultat du panneau Propriétés, vous pouvez visualiser les résultats qui peuvent être utilisés comme entrées pour l'opérateur suivant dans le pipeline.
  7. Dans l'onglet Validation du panneau Propriétés, vous pouvez valider la tâche afin d'identifier les erreurs et les avertissements dans les valeurs de paramètre configurées, le cas échéant.

Opérateur de tâche d'intégration

Un opérateur de tâche d'intégration permet d'exécuter un flux de données configuré pour un contexte spécifique. Le flux de données doit être encapsulé dans une tâche d'intégration.

Ajout et configuration d'un opérateur de tâche d'intégration

Un opérateur de tâche d'intégration connecté directement à l'opérateur de début est toujours exécuté.

Pour un opérateur de tâche qui n'est pas directement connecté à l'opérateur de début, vous pouvez utiliser la propriété Condition de lien entrante afin de configurer la tâche de sorte qu'elle soit toujours exécutée, ou exécutée uniquement lorsque le statut de l'opérateur précédent répond à une condition d'exécution spécifique.

  1. Dans le panneau Opérateurs, faites glisser l'opérateur Intégration vers le canevas.
    L'icône de l'opérateur sur le canevas affiche un nom par défaut, ce qui indique que l'opérateur n'est pas encore lié à une tâche dans l'espace de travail.
  2. Dans l'onglet Détails du panneau Propriétés de l'opérateur de tâche non limité, cliquez sur Sélectionner. Dans le panneau qui apparaît, utilisez le menu pour choisir le type de tâche à ajouter, puis sélectionnez la tâche.

    Tâches de conception : pour utiliser une tâche dans un projet, sélectionnez d'abord un projet dans le menu de liste Projets. Vous pouvez également commencer à saisir un nom de projet pour filtrer la liste et effectuer une sélection dans une liste filtrée de noms correspondants. Seuls les projets de l'espace de travail en cours peuvent être sélectionnés.

    Tâches publiées : les tâches publiées à partir de la dernière application mise à jour dans l'espace de travail et le compartiment en cours sont répertoriées pour sélection. Vous pouvez utiliser les menus pour basculer vers une autre application dans l'espace de travail en cours. Vous pouvez également commencer à saisir un nom dans la zone Espaces de travail ou Applications et effectuer une sélection dans une liste filtrée de noms correspondants.

  3. Dans le panneau Sélectionner une tâche d'intégration, sélectionnez une tâche et cliquez sur Sélectionner.
    Le nom figurant sur l'icône de l'opérateur sur le canevas devient le nom de la tâche sélectionnée.
  4. Dans l'onglet Détails du panneau Propriétés de l'opérateur de tâche sélectionné :
    1. Renommez l'opérateur si vous le souhaitez.
    2. Pour condition de lien entrante, vous pouvez sélectionner l'une des conditions d'exécution suivantes. Lorsque les opérateurs sont connectés, une ligne colorée indique la condition sélectionnée.
      • Exécuter toujours : exécute la tâche sélectionnée quel que soit le statut de l'opérateur en amont.

        Une ligne grise indique la condition Toujours exécuter.

        Vous ne pouvez pas modifier la condition de lien pour les tâches connectées directement à l'opérateur de début.

      • Exécuter en cas de succès de l'opérateur précédent : exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur en amont est Succès.

        Une ligne verte avec une coche indique une condition de succès.

      • Exécuter en cas d'échec de l'opérateur précédent : exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur en amont est Echec.

        Une ligne rouge avec une croix "x" indique une condition d'échec.

  5. Dans l'onglet Configuration du panneau Propriétés, vous pouvez :
    1. Configurer les options d'exécution pour indiquer comment gérer les exécutions de tâche en échec
    2. Configurer les valeurs de paramètre entrantes
  6. Dans l'onglet Résultat du panneau Propriétés, vous pouvez visualiser les résultats qui peuvent être utilisés comme entrées pour l'opérateur suivant dans le pipeline.
  7. Dans l'onglet Validation du panneau Propriétés, vous pouvez valider la tâche afin d'identifier les erreurs et les avertissements dans les valeurs de paramètre configurées, le cas échéant.

Opérateur de tâche de pipeline

Un opérateur de tâche de pipeline permet d'exécuter un pipeline dans un autre pipeline.

Ajout et configuration d'un opérateur de tâche de pipeline

Un opérateur de tâche de pipeline connecté directement à l'opérateur de début est toujours exécuté.

Pour un opérateur de tâche qui n'est pas directement connecté à l'opérateur de début, vous pouvez utiliser la propriété Condition de lien entrante afin de configurer la tâche de sorte qu'elle soit toujours exécutée, ou exécutée uniquement lorsque le statut de l'opérateur précédent remplit une condition d'exécution spécifique.

  1. Dans le panneau Opérateurs, faites glisser l'opérateur Pipeline vers le canevas.
    L'icône de l'opérateur sur le canevas affiche un nom par défaut, ce qui indique que l'opérateur n'est pas encore lié à une tâche dans l'espace de travail.
  2. Dans l'onglet Détails du panneau Propriétés de l'opérateur de tâche non limité, cliquez sur Sélectionner. Dans le panneau qui apparaît, utilisez le menu pour choisir le type de tâche à ajouter, puis sélectionnez la tâche.

    Tâches de conception : pour utiliser une tâche dans un projet, sélectionnez d'abord un projet dans le menu de liste Projets. Vous pouvez également commencer à saisir un nom de projet pour filtrer la liste et effectuer une sélection dans une liste filtrée de noms correspondants. Seuls les projets de l'espace de travail en cours peuvent être sélectionnés.

    Tâches publiées : les tâches publiées à partir de la dernière application mise à jour dans l'espace de travail et le compartiment en cours sont répertoriées pour sélection. Vous pouvez utiliser les menus pour basculer vers une autre application dans l'espace de travail en cours. Vous pouvez également commencer à saisir un nom dans la zone Espaces de travail ou Applications et effectuer une sélection dans une liste filtrée de noms correspondants.

  3. Dans le panneau Sélectionner une tâche de pipeline, sélectionnez une tâche et cliquez sur Sélectionner.
    Le nom figurant sur l'icône de l'opérateur sur le canevas devient le nom de la tâche sélectionnée.
  4. Dans l'onglet Détails du panneau Propriétés de l'opérateur de tâche sélectionné :
    1. Renommez l'opérateur si vous le souhaitez.
    2. Pour condition de lien entrante, vous pouvez sélectionner l'une des conditions d'exécution suivantes. Lorsque les opérateurs sont connectés, une ligne colorée indique la condition sélectionnée.
      • Exécuter toujours : exécute la tâche sélectionnée quel que soit le statut de l'opérateur en amont.

        Une ligne grise indique la condition Toujours exécuter.

        Vous ne pouvez pas modifier la condition de lien pour les tâches connectées directement à l'opérateur de début.

      • Exécuter en cas de succès de l'opérateur précédent : exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur en amont est Succès.

        Une ligne verte avec une coche indique une condition de succès.

      • Exécuter en cas d'échec de l'opérateur précédent : exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur en amont est Echec.

        Une ligne rouge avec une croix "x" indique une condition d'échec.

  5. Dans l'onglet Configuration du panneau Propriétés, vous pouvez :
    1. Configurer les options d'exécution pour indiquer comment gérer les exécutions de tâche en échec
    2. Configurer les valeurs de paramètre entrantes
  6. Dans l'onglet Résultat du panneau Propriétés, vous pouvez visualiser les résultats qui peuvent être utilisés comme entrées pour l'opérateur suivant dans le pipeline.
  7. Dans l'onglet Validation du panneau Propriétés, vous pouvez valider la tâche afin d'identifier les erreurs et les avertissements dans les valeurs de paramètre configurées, le cas échéant.

Opérateur de tâche SQL

Un opérateur de tâche SQL permet d'exécuter un objet SQL, tel qu'une procédure stockée.

Ajout et configuration d'un opérateur de tâche SQL

Un opérateur de tâche SQL connecté directement à l'opérateur de début est toujours exécuté.

Pour un opérateur de tâche qui n'est pas directement connecté à l'opérateur de début, vous pouvez utiliser la propriété Condition de lien entrante afin de configurer la tâche de sorte qu'elle soit toujours exécutée, ou exécutée uniquement lorsque le statut de l'opérateur précédent remplit une condition d'exécution spécifique.

  1. Dans le panneau Opérateurs, faites glisser l'opérateur SQL vers le canevas.
    L'icône de l'opérateur sur le canevas affiche un nom par défaut, ce qui indique que l'opérateur n'est pas encore lié à une tâche dans l'espace de travail.
  2. Dans l'onglet Détails du panneau Propriétés de l'opérateur de tâche non limité, cliquez sur Sélectionner. Dans le panneau qui apparaît, utilisez le menu pour choisir le type de tâche à ajouter, puis sélectionnez la tâche.

    Tâches de conception : pour utiliser une tâche dans un projet, sélectionnez d'abord un projet dans le menu de liste Projets. Vous pouvez également commencer à saisir un nom de projet pour filtrer la liste et effectuer une sélection dans une liste filtrée de noms correspondants. Seuls les projets de l'espace de travail en cours peuvent être sélectionnés.

    Tâches publiées : les tâches publiées à partir de la dernière application mise à jour dans l'espace de travail et le compartiment en cours sont répertoriées pour sélection. Vous pouvez utiliser les menus pour basculer vers une autre application dans l'espace de travail en cours. Vous pouvez également commencer à saisir un nom dans la zone Espaces de travail ou Applications et effectuer une sélection dans une liste filtrée de noms correspondants.

  3. Dans le panneau Sélectionner une tâche SQL, sélectionnez une tâche et cliquez sur Sélectionner.
    Le nom figurant sur l'icône de l'opérateur sur le canevas devient le nom de la tâche sélectionnée.
  4. Dans l'onglet Détails du panneau Propriétés de l'opérateur de tâche sélectionné :
    1. Renommez l'opérateur si vous le souhaitez.
    2. Pour condition de lien entrante, vous pouvez sélectionner l'une des conditions d'exécution suivantes. Lorsque les opérateurs sont connectés, une ligne colorée indique la condition sélectionnée.
      • Exécuter toujours : exécute la tâche sélectionnée quel que soit le statut de l'opérateur en amont.

        Une ligne grise indique la condition Toujours exécuter.

        Vous ne pouvez pas modifier la condition de lien pour les tâches connectées directement à l'opérateur de début.

      • Exécuter en cas de succès de l'opérateur précédent : exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur en amont est Succès.

        Une ligne verte avec une coche indique une condition de succès.

      • Exécuter en cas d'échec de l'opérateur précédent : exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur en amont est Echec.

        Une ligne rouge avec une croix "x" indique une condition d'échec.

  5. Dans l'onglet Configuration du panneau Propriétés, vous pouvez :
    1. Configurer les options d'exécution pour indiquer comment gérer les exécutions de tâche en échec
    2. Configurer les valeurs de paramètre entrantes

      Les variables définies dans une procédure stockée sont affichées en tant que paramètres d'entrée, de sortie et d'entrée/sortie. Seuls les paramètres d'entrée peuvent être configurés.

      Remarque

      La valeur configurée d'un paramètre d'entrée doit correspondre au type de données défini de ce paramètre. Par exemple, vous ne pouvez pas fournir de valeur de type String pour un paramètre d'entrée dont le type de données est NUMERIC. De plus, la valeur configurée d'un paramètre d'entrée de type de données NUMERIC ne peut pas être NULL lors de l'exécution.
  6. Dans l'onglet sortie du panneau Propriétés, vous pouvez visualiser les sorties qui peuvent être utilisées comme entrées pour l'opérateur suivant dans le pipeline.

    Les paramètres de sortie générés par le système et ceux de la procédure SQL stockée sont affichés. Reportez-vous également à Paramètres de sortie.

  7. Dans l'onglet Validation du panneau Propriétés, vous pouvez valider la tâche afin d'identifier les erreurs et les avertissements dans les valeurs de paramètre configurées, le cas échéant.
    Remarque

    L'exécution d'une tâche SQL échoue si les paramètres d'entrée de type de données NUMERIC configurés ont la valeur par défaut NULL. Pour éviter les échecs d'exécution de tâche, remplacez les valeurs NULL par 0 (zéro).

Opérateur de tâche OCI Data Flow

Un opérateur de tâche OCI Data Flow permet d'exécuter une application OCI Data Flow dans un pipeline.

Ajout et configuration d'un opérateur de tâche OCI Data Flow

Un opérateur de tâche connecté directement à l'opérateur de début est toujours exécuté.

Pour un opérateur de tâche qui n'est pas directement connecté à l'opérateur de début, vous pouvez utiliser la propriété Condition de lien entrante afin de configurer la tâche de sorte qu'elle soit toujours exécutée, ou exécutée uniquement lorsque le statut de l'opérateur précédent remplit une condition d'exécution spécifique.

  1. Dans le panneau Opérateurs, faites glisser l'opérateur OCI Data Flow vers le canevas.
    L'icône de l'opérateur sur le canevas affiche un nom par défaut, ce qui indique que l'opérateur n'est pas encore lié à une tâche dans l'espace de travail.
  2. Dans l'onglet Détails du panneau Propriétés de l'opérateur de tâche non limité, cliquez sur Sélectionner. Dans le panneau qui apparaît, utilisez le menu pour choisir le type de tâche à ajouter, puis sélectionnez la tâche.

    Tâches de conception : pour utiliser une tâche dans un projet, sélectionnez d'abord un projet dans le menu de liste Projets. Vous pouvez également commencer à saisir un nom de projet pour filtrer la liste et effectuer une sélection dans une liste filtrée de noms correspondants. Seuls les projets de l'espace de travail en cours peuvent être sélectionnés.

    Tâches publiées : les tâches publiées à partir de la dernière application mise à jour dans l'espace de travail et le compartiment en cours sont répertoriées pour sélection. Vous pouvez utiliser les menus pour passer à une autre application dans l'espace de travail en cours, ou à un autre espace de travail dans le même compartiment ou dans un autre compartiment. Vous pouvez également commencer à saisir un nom dans la zone Espaces de travail ou Applications et effectuer une sélection dans une liste filtrée de noms correspondants.

  3. Dans le panneau Sélectionner une tâche OCI Data Flow, sélectionnez une tâche et cliquez sur Sélectionner.
    Le nom figurant sur l'icône de l'opérateur sur le canevas devient le nom de la tâche sélectionnée.
  4. Dans l'onglet Détails du panneau Propriétés de l'opérateur de tâche sélectionné :
    1. Renommez l'opérateur si vous le souhaitez.
    2. Pour condition de lien entrante, vous pouvez sélectionner l'une des conditions d'exécution suivantes. Lorsque les opérateurs sont connectés, une ligne colorée indique la condition sélectionnée.
      • Exécuter toujours : exécute la tâche sélectionnée quel que soit le statut de l'opérateur en amont.

        Une ligne grise indique la condition Toujours exécuter.

        Vous ne pouvez pas modifier la condition de lien pour les tâches connectées directement à l'opérateur de début.

      • Exécuter en cas de succès de l'opérateur précédent : exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur en amont est Succès.

        Une ligne verte avec une coche indique une condition de succès.

      • Exécuter en cas d'échec de l'opérateur précédent : exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur en amont est Echec.

        Une ligne rouge avec une croix "x" indique une condition d'échec.

  5. Dans l'onglet Configuration du panneau Propriétés, vous pouvez :
    1. Configurer les valeurs de paramètre entrantes

      Les valeurs des paramètres affectés aux valeurs de propriété dans la tâche OCI Data Flow sous-jacente peuvent être reconfigurées.

    2. Configurer les options d'exécution pour indiquer comment gérer les exécutions de tâche en échec
  6. Dans l'onglet sortie du panneau Propriétés, vous pouvez visualiser les sorties qui peuvent être utilisées comme entrées pour l'opérateur suivant dans le pipeline.

    Les paramètres de sortie générés par le système et ceux de l'application sont affichés. Reportez-vous également à Paramètres de sortie.

  7. Dans l'onglet Validation du panneau Propriétés, vous pouvez valider la tâche afin d'identifier les erreurs et les avertissements dans les valeurs de paramètre configurées, le cas échéant.

Opérateur de tâche REST

Un opérateur de tâche REST permet d'exécuter une adresse d'API REST dans un pipeline.

Ajout et configuration d'un opérateur de tâche REST

Un opérateur de tâche connecté directement à l'opérateur de début est toujours exécuté.

Pour un opérateur de tâche qui n'est pas directement connecté à l'opérateur de début, vous pouvez utiliser la propriété Condition de lien entrante afin de configurer la tâche de sorte qu'elle soit toujours exécutée, ou exécutée uniquement lorsque le statut de l'opérateur précédent remplit une condition d'exécution spécifique.

  1. Dans le panneau Opérateurs, faites glisser l'opérateur REST vers le canevas.
    L'icône de l'opérateur sur le canevas affiche un nom par défaut, ce qui indique que l'opérateur n'est pas encore lié à une tâche dans l'espace de travail.
  2. Dans l'onglet Détails du panneau Propriétés de l'opérateur de tâche non limité, cliquez sur Sélectionner. Dans le panneau qui apparaît, utilisez le menu pour choisir le type de tâche à ajouter, puis sélectionnez la tâche.

    Tâches de conception : pour utiliser une tâche dans un projet, sélectionnez d'abord un projet dans le menu de liste Projets. Vous pouvez également commencer à saisir un nom de projet pour filtrer la liste et effectuer une sélection dans une liste filtrée de noms correspondants. Seuls les projets de l'espace de travail en cours peuvent être sélectionnés.

    Tâches publiées : les tâches publiées à partir de la dernière application mise à jour dans l'espace de travail et le compartiment en cours sont répertoriées pour sélection. Vous pouvez utiliser les menus pour passer à une autre application dans l'espace de travail en cours, ou à un autre espace de travail dans le même compartiment ou dans un autre compartiment. Vous pouvez également commencer à saisir un nom dans la zone Espaces de travail ou Applications et effectuer une sélection dans une liste filtrée de noms correspondants.

  3. Dans le panneau Sélectionner une tâche REST, sélectionnez une tâche et cliquez sur Sélectionner.
    Le nom figurant sur l'icône de l'opérateur sur le canevas devient le nom de la tâche sélectionnée.
  4. Dans l'onglet Détails du panneau Propriétés de l'opérateur de tâche sélectionné :
    1. Renommez l'opérateur si vous le souhaitez.
    2. Pour Condition de lien entrante, vous pouvez sélectionner l'une des conditions d'exécution suivantes. Lorsque les opérateurs sont connectés, une ligne colorée indique la condition sélectionnée.
      • Exécuter toujours : exécute la tâche sélectionnée quel que soit le statut de l'opérateur en amont.

        Une ligne grise indique la condition Toujours exécuter.

        Vous ne pouvez pas modifier la condition de lien pour les tâches connectées directement à l'opérateur de début.

      • Exécuter en cas de succès de l'opérateur précédent : exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur en amont est Succès.

        Une ligne verte avec une coche indique une condition de succès.

      • Exécuter en cas d'échec de l'opérateur précédent : exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur en amont est Echec.

        Une ligne rouge avec une croix "x" indique une condition d'échec.

  5. Dans l'onglet Configuration du panneau Propriétés, vous pouvez :
    1. Configurer les valeurs de paramètre entrantes

      Les valeurs des paramètres d'URL et d'autres paramètres de tâche définis dans la tâche REST sous-jacente peuvent être reconfigurées.

    2. Configurer les options d'exécution pour indiquer comment gérer les exécutions de tâche en échec
  6. Dans l'onglet sortie du panneau Propriétés, vous pouvez visualiser les sorties qui peuvent être utilisées comme entrées pour l'opérateur suivant dans le pipeline.

    Les paramètres de sortie générés par le système et ceux de la réponse REST sont affichés. Reportez-vous également à Paramètres de sortie.

  7. Dans l'onglet Validation du panneau Propriétés, vous pouvez valider la tâche afin d'identifier les erreurs et les avertissements dans les valeurs de paramètre configurées, le cas échéant.