Utilisation des opérateurs de pipeline

Dans le service d'intégration de données, les opérateurs de pipeline représentent différentes tâches et différentes activités qui peuvent ê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âches d'intégration et de chargement de données qui permettent d'exécuter des solutions d'intégration de données dans un pipeline. Vous pouvez configurer les entrées des opérateurs. Les entrées de l'opérateur de tâche sont similaires 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 permettent d'exécuter des procédures stockées SQL dans un pipeline. Vous pouvez configurer des valeurs pour les paramètres dans les procédures stockées.
  • Opérateurs de tâche du service de flux de données OCI qui vous permettent d'exécuter des applications de flux de données OCI dans un pipeline.
  • Opérateurs de tâche REST qui vous permettent d'exécuter des points d'extrémité 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 permettent d'exécuter un autre pipeline dans un pipeline.

Vérifiez les informations et considérations relatives à la prise en charge lors de 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 de projets dans l'espace de travail courant et des tâches publiées à partir de n'importe quelle application dans l'espace de travail courant. Avec les tâches REST publiées et les tâches de flux de données OCI, vous pouvez également sélectionner une tâche dans n'importe quelle application d'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 Fusion et indiquer une condition pour gérer les opérations subséquentes en aval. Pour prendre la sortie de n'importe quel opérateur et la transmettre à l'opérateur suivant, vous pouvez utiliser un opérateur Expression.

Vous utilisez un concepteur similaire au concepteur de flux de données pour créer un pipeline. Le concepteur s'ouvre avec un opérateur Démarrer et un opérateur Fin déjà placés sur le canevas pour vous. Il ne peut y avoir qu'un seul opérateur Démarrer et un seul opérateur Fin dans un pipeline. Un pipeline doit comporter au moins un opérateur de tâche pour être valide. Vous pouvez ajouter n'importe quel nombre de tâches, puis les connecter dans une séquence entre l'opérateur de début et l'opérateur de fin. À partir du panneau Opérateurs, faites glisser des opérateurs sur 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 qui sont connectées directement à l'opérateur Démarrer sont toujours exécutées. Les tâches suivantes de la séquence peuvent être configurées pour s'exécuter en fonction de l'état de l'opérateur précédent. Par exemple, considérez un pipeline qui a la séquence Démarrer > 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 entrant dans le panneau Propriétés pour que la tâche soit toujours exécutée ou seulement lorsque le statut de la tâche A satisfait à une condition d'exécution spécifique.

Pour connecter des opérateurs, survolez le premier avec le pointeur de la souris jusqu'à ce que le symbole de connexion (petit cercle) apparaisse sur son côté droit. Puis faites glisser le connecteur vers l'opérateur suivant auquel vous souhaitez le connecter. La connexion est valide lorsqu'une ligne relie les deux opérateurs.

En général, un opérateur n'a qu'un seul port entrant et un ou plusieurs ports sortants pour la circulation des processus dans le pipeline. Par exemple, vous pouvez connecter le même port sortant de l'opérateur Tâche SQL aux ports entrants de deux opérateurs d'expression distincts. Seuls l'opérateur Fin et l'opérateur Fusion peuvent avoir plusieurs ports entrants.

Vous pouvez rapidement dupliquer un opérateur Tâche ou 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 dans le canevas et sélectionnez Dupliquer dans le menu qui s'affiche. Renommez ensuite l'identificateur de l'opérateur dupliqué dans le panneau Propriétés. Si l'opérateur initial est connecté à d'autres opérateurs, les connexions et toute référence aux sorties d'un opérateur précédent ne sont pas copiées vers l'opérateur dupliqué.

Opérateur Démarrer et opérateur Fin

Lorsque vous commencez à créer un pipeline, le concepteur s'ouvre avec un opérateur Démarrer et un opérateur Fin déjà placés sur le canevas. Il ne peut y avoir qu'un seul opérateur Démarrer et un seul opérateur Fin dans un pipeline.

L'opérateur Démarrer n'a aucune propriété configurable.

Pour ce qui est de l'opérateur Fin, vous pouvez configurer la propriété Condition de lien entrant afin d'indiquer l'une des règles d'exécution suivantes pour une tâche de pipeline :

  • Tous terminés : Le statut de tâche du pipeline est Réussite même si une des tâches du pipeline échoue.
  • Tous réussis : Le statut de tâche du pipeline est Réussite si toutes les tâches du pipeline sont terminées avec succès.
  • Tout a échoué : Le statut de tâche du pipeline est Réussite si toutes les tâches du pipeline ont échoué.

Opérateur Fusion

Pour les tâches qui s'exécutent en parallèle, vous pouvez utiliser l'opérateur Fusion et spécifier une condition pour décider comment gérer les opérations suivantes en aval.

Ajout et configuration d'un opérateur Fusion

Un opérateur Fusion peut avoir plusieurs liaisons d'entrée (en amont) et plusieurs liaisons de sortie (en aval).

  1. À partir du panneau Opérateurs, faites glisser l'opérateur Fusion sur le canevas.
  2. Dans l'onglet Détails du panneau Propriétés, entrez un nom et une description facultative pour l'opérateur Fusion.
  3. Pour Condition de fusion, vous pouvez sélectionner une des options suivantes :
    • Réussite : Toutes les opérations parallèles qui sont reliées en amont doivent être terminées et réussies avant que la prochaine opération en aval puisse être effectuée. Cette option est la valeur par défaut.
    • Tous en échec : Toutes les opérations parallèles liées en amont doivent être terminées et en échec avant que la prochaine opération en aval puisse être effectuée.
    • Tous terminés : Toutes les opérations parallèles reliées en amont doivent être terminées avant que la prochaine opération en aval puisse être effectuée.
    • Au moins une réussite : Au moins une opération liée en amont doit être terminée et réussie avant que la prochaine opération en aval puisse être effectuée.
    • Au moins un échec : Au moins une opération liée en amont doit être terminée et en échec avant que la prochaine opération en aval puisse être effectuée.
  4. Dans l'onglet Sortie du panneau Propriétés, vous pouvez voir les sorties qui peuvent être utilisées comme entrées du prochain opérateur dans le pipeline.
    Les sorties disponibles sont une combinaison de paramètres de sortie du système et des sorties de chaque opérateur de tâche connecté à l'opérateur Fusion.

Opérateur Expression

Un opérateur Expression de pipeline permet de créer de nouveaux champs dérivés dans un pipeline, de manière similaire à l'opérateur Expression dans un flux de données.

Ajout et configuration d'un opérateur Expression

Contrairement à un opérateur Expression pour flux de données, un opérateur Expression pour pipeline ne s'applique pas sur des données. Un opérateur Expression de pipeline permet d'appliquer une expression à la sortie de l'opérateur précédent, aux paramètres de pipeline et à la sortie générée par le système.

  1. À partir du panneau Opérateurs, faites glisser l'opérateur Expression sur le canevas.
  2. Avec l'opérateur Expression en évidence, dans l'onglet Détails du panneau Propriétés, entrez un nom dans le champ Identificateur ou laissez le nom tel quel.
  3. (Facultatif) Pour Condition de lien entrant, vous pouvez sélectionner parmi les 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 qui sont connectés directement à l'opérateur Démarrer.

    • Exécuter lors de la réussite de l'opérateur précédent : Exécute le noeud sélectionné uniquement lorsque le statut du noeud en amont est Réussi.

      Une ligne verte avec un crochet indique une condition de réussite.

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

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

  4. Sous Expressions, sélectionnez 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 données de l'expression.
  7. Selon le type que vous avez sélectionné, vous devrez peut-être spécifier d'autres valeurs, par exemple Longueur ou Ééchelle.
  8. Créez une expression dans le générateur d'expression et sélectionnez Ajouter.
    La valeur dérivée d'une expression peut être utilisée dans l'opérateur suivant connecté à cet opérateur Expression dans le pipeline.
  9. Répétez les étapes pour ajouter d'autres expressions.
  10. Dans l'onglet Sortie du panneau Propriétés, vous pouvez voir les sorties d'expression qui peuvent être utilisées comme entrées pour le prochain opérateur dans le pipeline.
    Chaque expression que vous ajoutez a une sortie. La sortie porte le même nom que l'expression.
  11. Sous l'onglet Validation du panneau Propriétés, vous pouvez valider l'opérateur pour vérifier 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 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'expressions, cliquez deux fois pour sélectionner une valeur entrante, un paramètre ou une fonction, ou faites-les glisser pour créer l'expression.
    Une expression peut être une combinaison de sorties système d'un opérateur précédent, de paramètres de 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 Fusion, les sorties système sont les sorties combinées des opérateurs de tâche connectés à l'opérateur Fusion.
  3. Pour Paramètres, vous pouvez choisir parmi les paramètres du système et les paramètres définis par l'utilisateur qui sont créés dans le pipeline.
    • Défini 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 ou sélectionner Ajouter pour en créer un.

      1. Dans le panneau Ajouter un paramètre, entrez un nom pour le paramètre et une description facultative.
      2. Sélectionnez le type de données pour ce paramètre.
      3. Définissez le reste des champs de 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. Sélectionnez Ajouter.
    • Défini par le système : Au moment de l'exécution, le service d'intégration de données génère certains paramètres de système pour un pipeline. Les valeurs des paramètres générés par le système peuvent être utilisées dans les expressions, mais elles ne peuvent pas être modifiées.
  4. Pour Fonctions, vous pouvez choisir parmi les fonctions d'intégration de données disponibles pour les opérateurs de pipeline.
  5. Dans le panneau Ajouter une expression, sélectionnez 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 Expression.
  2. Avec l'opérateur Expression en évidence, dans l'onglet Détails du panneau Propriétés, sélectionnez l'expression à supprimer, puis sélectionnez Supprimer.
  3. Dans la boîte de dialogue Supprimer l'expression, assurez-vous que vous voulez supprimer cette expression, puis sélectionnez 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 a 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 Décision.
  3. Pour Condition de décision, procédez de la façon suivante :
    1. Sélectionnez Ajouter.
    2. Dans le panneau Ajouter une condition de décision, écrivez une condition à l'aide de valeurs entrantes, de paramètres ou de fonctions, de sorte que l'expression de condition donne 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 du système et les paramètres définis par l'utilisateur qui sont créés dans le pipeline.

        • Défini 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 ou sélectionner Ajouter pour en créer un.

        • Défini par le système : Au moment de l'exécution, le service d'intégration de données génère certains paramètres de système pour un pipeline. Les valeurs des paramètres générés par le système peuvent être utilisées dans les expressions, mais elles ne peuvent pas être modifiées.

      • Pour Fonctions, vous pouvez choisir parmi les fonctions d'intégration de données disponibles pour les opérateurs de pipeline.

  4. (Facultatif) Pour Condition de lien entrant, vous pouvez sélectionner parmi les 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 qui sont connectés directement à l'opérateur Démarrer.

    • Exécuter lors de la réussite de l'opérateur précédent : Exécute le noeud sélectionné uniquement lorsque le statut du noeud en amont est Réussi.

      Une ligne verte avec un crochet indique une condition de réussite.

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

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

  5. Sur le canevas, connectez les ports de sortie appropriés sur 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 Fusion ou à un opérateur Fin.

Opérateur Tâche de chargement de données

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

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

Un opérateur Tâche de chargement de données qui est connecté directement à l'opérateur Démarrer est toujours exécuté.

Pour un opérateur de tâche qui n'est pas connecté directement à l'opérateur Démarrer, vous pouvez utiliser la propriété Condition de lien entrant pour configurer la tâche afin qu'elle soit toujours exécutée ou qu'elle ne s'exécute que lorsque le statut de l'opérateur précédent satisfait à une condition d'exécution spécifique.

  1. À partir du panneau Opérateurs, glissez l'opérateur Chargeur de données sur 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 pour l'opérateur de tâche non lié, cliquez sur Sélectionner. Dans le panneau qui s'affiche, 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 à taper 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 courant 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 courants sont répertoriées pour sélection. Vous pouvez utiliser les menus pour passer à une autre application dans l'espace de travail courant. Vous pouvez également commencer à entrer 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 chargement de données, sélectionnez une tâche et cliquez sur Sélectionner.
    L'icône de l'opérateur sur le canevas prend le nom de la tâche sélectionnée.
  4. Dans l'onglet Détails du panneau Propriétés pour l'opérateur de tâche sélectionné :
    1. Renommez l'opérateur si vous le souhaitez.
    2. Pour Condition de lien entrant, vous pouvez sélectionner parmi les 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 la tâche sélectionnée peu importe 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 Démarrer.

      • Exécuter lors de la réussite de l'opérateur précédent : Exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur amont est 'Réussi'.

        Une ligne verte avec un crochet indique une condition de réussite.

      • Exécuter lors de l'échec de l'opérateur précédent : N'exécute la tâche sélectionnée que si le statut de l'opérateur amont est 'échec'.

        Une ligne rouge avec un "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 qui échouent.
    2. Configurer les valeurs des paramètres entrants.
  6. Dans l'onglet Sortie du panneau Propriétés, vous pouvez voir les sorties qui peuvent être utilisées comme entrées du prochain opérateur dans le pipeline.
  7. Dans l'onglet Validation du panneau Propriétés, vous pouvez valider la tâche pour vérifier les erreurs et avertissements dans les valeurs de paramètre configurées, le cas échéant.

Opérateur Tâche d'intégration

Un opérateur 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 enveloppé dans une tâche d'intégration.

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

Un opérateur Tâche d'intégration connecté directement à l'opérateur Démarrer est toujours exécuté.

Pour un opérateur de tâche qui n'est pas connecté directement à l'opérateur Démarrer, vous pouvez utiliser la propriété Condition de lien entrant pour configurer la tâche afin qu'elle soit toujours exécutée ou qu'elle ne s'exécute que lorsque le statut de l'opérateur précédent satisfait à une condition d'exécution spécifique.

  1. À partir du panneau Opérateurs, faites glisser un opérateur Intégration sur 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 pour l'opérateur de tâche non lié, cliquez sur Sélectionner. Dans le panneau qui s'affiche, 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 à taper 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 courant 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 courants sont répertoriées pour sélection. Vous pouvez utiliser les menus pour passer à une autre application dans l'espace de travail courant. Vous pouvez également commencer à entrer 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.
    L'icône de l'opérateur sur le canevas prend le nom de la tâche sélectionnée.
  4. Dans l'onglet Détails du panneau Propriétés pour l'opérateur de tâche sélectionné :
    1. Renommez l'opérateur si vous le souhaitez.
    2. Pour Condition de lien entrant, vous pouvez sélectionner parmi les 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 la tâche sélectionnée peu importe 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 Démarrer.

      • Exécuter lors de la réussite de l'opérateur précédent : Exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur amont est 'Réussi'.

        Une ligne verte avec un crochet indique une condition de réussite.

      • Exécuter lors de l'échec de l'opérateur précédent : N'exécute la tâche sélectionnée que si le statut de l'opérateur amont est 'échec'.

        Une ligne rouge avec un "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 qui échouent.
    2. Configurer les valeurs des paramètres entrants.
  6. Dans l'onglet Sortie du panneau Propriétés, vous pouvez voir les sorties qui peuvent être utilisées comme entrées du prochain opérateur dans le pipeline.
  7. Dans l'onglet Validation du panneau Propriétés, vous pouvez valider la tâche pour vérifier les erreurs et avertissements dans les valeurs de paramètre configurées, le cas échéant.

Opérateur Tâche de pipeline

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

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

Un opérateur Tâche de pipeline connecté directement à l'opérateur Démarrer est toujours exécuté.

Pour un opérateur de tâche qui n'est pas connecté directement à l'opérateur Démarrer, vous pouvez utiliser la propriété Condition de lien entrant pour configurer la tâche afin qu'elle soit toujours exécutée ou qu'elle ne s'exécute que lorsque le statut de l'opérateur précédent satisfait à une condition d'exécution spécifique.

  1. À partir du panneau Opérateurs, faites glisser l'opérateur Pipeline sur 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 pour l'opérateur de tâche non lié, cliquez sur Sélectionner. Dans le panneau qui s'affiche, 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 à taper 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 courant 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 courants sont répertoriées pour sélection. Vous pouvez utiliser les menus pour passer à une autre application dans l'espace de travail courant. Vous pouvez également commencer à entrer 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.
    L'icône de l'opérateur sur le canevas prend le nom de la tâche sélectionnée.
  4. Dans l'onglet Détails du panneau Propriétés pour l'opérateur de tâche sélectionné :
    1. Renommez l'opérateur si vous le souhaitez.
    2. Pour Condition de lien entrant, vous pouvez sélectionner parmi les 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 la tâche sélectionnée peu importe 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 Démarrer.

      • Exécuter lors de la réussite de l'opérateur précédent : Exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur amont est 'Réussi'.

        Une ligne verte avec un crochet indique une condition de réussite.

      • Exécuter lors de l'échec de l'opérateur précédent : N'exécute la tâche sélectionnée que si le statut de l'opérateur amont est 'échec'.

        Une ligne rouge avec un "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 qui échouent.
    2. Configurer les valeurs des paramètres entrants.
  6. Dans l'onglet Sortie du panneau Propriétés, vous pouvez voir les sorties qui peuvent être utilisées comme entrées du prochain opérateur dans le pipeline.
  7. Dans l'onglet Validation du panneau Propriétés, vous pouvez valider la tâche pour vérifier les erreurs et avertissements dans les valeurs de paramètre configurées, le cas échéant.

Opérateur Tâche SQL

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

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

Un opérateur Tâche SQL connecté directement à l'opérateur Démarrer est toujours exécuté.

Pour un opérateur de tâche qui n'est pas connecté directement à l'opérateur Démarrer, vous pouvez utiliser la propriété Condition de lien entrant pour configurer la tâche afin qu'elle soit toujours exécutée ou qu'elle ne s'exécute que lorsque le statut de l'opérateur précédent satisfait à une condition d'exécution spécifique.

  1. À partir du panneau Opérateurs, faites glisser l'opérateur SQL sur 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 pour l'opérateur de tâche non lié, cliquez sur Sélectionner. Dans le panneau qui s'affiche, 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 à taper 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 courant 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 courants sont répertoriées pour sélection. Vous pouvez utiliser les menus pour passer à une autre application dans l'espace de travail courant. Vous pouvez également commencer à entrer 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.
    L'icône de l'opérateur sur le canevas prend le nom de la tâche sélectionnée.
  4. Dans l'onglet Détails du panneau Propriétés pour l'opérateur de tâche sélectionné :
    1. Renommez l'opérateur si vous le souhaitez.
    2. Pour Condition de lien entrant, vous pouvez sélectionner parmi les 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 la tâche sélectionnée peu importe 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 Démarrer.

      • Exécuter lors de la réussite de l'opérateur précédent : Exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur amont est 'Réussi'.

        Une ligne verte avec un crochet indique une condition de réussite.

      • Exécuter lors de l'échec de l'opérateur précédent : N'exécute la tâche sélectionnée que si le statut de l'opérateur amont est 'échec'.

        Une ligne rouge avec un "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 qui échouent.
    2. Configurer les valeurs des paramètres entrants.

      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.

      Note

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

    Les paramètres de sortie générés par le système et les paramètres de sortie de la procédure SQL stockée sont affichés. Voir aussi Paramètres de sortie.

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

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

Opérateur de tâche de flux de données OCI

Un opérateur de tâche de flux de données OCI vous permet d'exécuter une application de flux de données OCI dans un pipeline.

Ajout et configuration d'un opérateur de tâche de flux de données OCI

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

Pour un opérateur de tâche qui n'est pas connecté directement à l'opérateur Démarrer, vous pouvez utiliser la propriété Condition de lien entrant pour configurer la tâche afin qu'elle soit toujours exécutée ou qu'elle ne s'exécute que lorsque le statut de l'opérateur précédent satisfait à une condition d'exécution spécifique.

  1. À partir du panneau Opérateurs, faites glisser l'opérateur Flux de données OCI 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 pour l'opérateur de tâche non lié, cliquez sur Sélectionner. Dans le panneau qui s'affiche, 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 à taper 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 courant 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 courants sont répertoriées pour sélection. Vous pouvez utiliser les menus pour passer à une autre application dans l'espace de travail courant, ou à un autre espace de travail dans le même compartiment ou un autre compartiment. Vous pouvez également commencer à entrer 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 flux de données OCI, sélectionnez une tâche et cliquez sur Sélectionner.
    L'icône de l'opérateur sur le canevas prend le nom de la tâche sélectionnée.
  4. Dans l'onglet Détails du panneau Propriétés pour l'opérateur de tâche sélectionné :
    1. Renommez l'opérateur si vous le souhaitez.
    2. Pour Condition de lien entrant, vous pouvez sélectionner parmi les 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 la tâche sélectionnée peu importe 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 Démarrer.

      • Exécuter lors de la réussite de l'opérateur précédent : Exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur amont est 'Réussi'.

        Une ligne verte avec un crochet indique une condition de réussite.

      • Exécuter lors de l'échec de l'opérateur précédent : N'exécute la tâche sélectionnée que si le statut de l'opérateur amont est 'échec'.

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

  5. Dans l'onglet Configuration du panneau Propriétés, vous pouvez :
    1. Configurer les valeurs des paramètres entrants.

      Les valeurs de paramètre affectées aux valeurs de propriété dans la tâche du service de flux de données OCI sous-jacente peuvent être reconfigurées.

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

    Les paramètres de sortie générés par le système et les paramètres de sortie de l'application sont affichés. Voir aussi Paramètres de sortie.

  7. Dans l'onglet Validation du panneau Propriétés, vous pouvez valider la tâche pour vérifier les erreurs et 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 vous permet d'exécuter un point d'extrémité 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 Démarrer est toujours exécuté.

Pour un opérateur de tâche qui n'est pas connecté directement à l'opérateur Démarrer, vous pouvez utiliser la propriété Condition de lien entrant pour configurer la tâche afin qu'elle soit toujours exécutée ou qu'elle ne s'exécute que lorsque le statut de l'opérateur précédent satisfait à une condition d'exécution spécifique.

  1. À partir du panneau Opérateurs, faites glisser l'opérateur REST sur 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 pour l'opérateur de tâche non lié, cliquez sur Sélectionner. Dans le panneau qui s'affiche, 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 à taper 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 courant 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 courants sont répertoriées pour sélection. Vous pouvez utiliser les menus pour passer à une autre application dans l'espace de travail courant, ou à un autre espace de travail dans le même compartiment ou un autre compartiment. Vous pouvez également commencer à entrer 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.
    L'icône de l'opérateur sur le canevas prend le nom de la tâche sélectionnée.
  4. Dans l'onglet Détails du panneau Propriétés pour l'opérateur de tâche sélectionné :
    1. Renommez l'opérateur si vous le souhaitez.
    2. Pour Condition de lien entrant, vous pouvez sélectionner parmi les 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 la tâche sélectionnée peu importe 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 Démarrer.

      • Exécuter lors de la réussite de l'opérateur précédent : Exécute la tâche sélectionnée uniquement lorsque le statut de l'opérateur amont est 'Réussi'.

        Une ligne verte avec un crochet indique une condition de réussite.

      • Exécuter lors de l'échec de l'opérateur précédent : N'exécute la tâche sélectionnée que si le statut de l'opérateur amont est 'échec'.

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

  5. Dans l'onglet Configuration du panneau Propriétés, vous pouvez :
    1. Configurer les valeurs des paramètres entrants.

      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 qui échouent.
  6. Dans l'onglet Sortie du panneau Propriétés, vous pouvez voir les sorties qui peuvent être utilisées comme entrées du prochain opérateur dans le pipeline.

    Les paramètres de sortie générés par le système et les paramètres de sortie de la réponse REST sont affichés. Voir aussi Paramètres de sortie.

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