Documentation Oracle Cloud Infrastructure

Configuration des paramètres entrants pour les tâches

Cette procédure s'applique uniquement aux tâches lorsque des paramètres ont été affectés ou dans les flux de données sous-jacents des tâches d'intégration.

Les paramètres affectés ont des valeurs par défaut qui sont utilisées lors de la conception et l'exécution du pipeline.

Si vous le souhaitez, vous pouvez remplacer la valeur par défaut d'un paramètre entrant au moment de la conception et de l'exécution. Vous pouvez également remplacer la valeur par défaut d'un paramètre utilisé dans une expression d'un paramètre entrant.

Pour remplacer une valeur, vous pouvez définir directement une autre valeur lors de la conception, ou ajouter un paramètre défini par l'utilisateur du pipeline pour la valeur à définir lors de l'exécution. Le cas échéant, vous pouvez également affecter à l'entrée une valeur de paramètre système ou une valeur de sortie d'un opérateur précédent.

  1. Sur le canevas d'un pipeline, sélectionnez la tâche pour laquelle afficher ou configurer les valeurs des paramètres entrants.
  2. Dans le panneau Propriétés de la tâche sélectionnée, sélectionnez Configuration.
  3. En regard de Paramètres entrants configurés, vérifiez le nombre de paramètres entrants configurés et disponibles.
    Par exemple, 0/4 signifie que quatre paramètres entrants sont disponibles dans la tâche et qu'aucun n'a été reconfiguré.
  4. Sélectionnez Configurer en regard de Paramètres entrants configurés.
  5. Sur la page Configurer les paramètres entrants, vérifiez les entrées pouvant être configurées.
    Une entrée possède une valeur par défaut. Si le paramètre entrant est reconfiguré, l'entrée possède une valeur configurée. Une valeur configurée peut être un nom de paramètre défini par l'utilisateur avec la valeur configurée indiquée entre parenthèses.
  6. (Facultatif) Sur la ligne du type et de la valeur de paramètre à reconfigurer, sélectionnez Configurer.
    Si le paramètre entrant est déjà reconfiguré, sélectionnez Modifier pour modifier la valeur configurée ou Effacer pour enlever la valeur.
  7. Sur la page Configurer le paramètre entrant pour <type> qui apparaît pour le paramètre sélectionné, effectuez l'une des options de configuration d'entrée, puis sélectionnez Terminé pour revenir à la page précédente.

    Lors de la configuration des paramètres entrants, tenez compte des points suivants :

    • Si une tâche est configurée pour être exécutée dans le service OCI Data Flow, utilisez le format suivant si vous modifiez les valeurs de paramètre par défaut pour OCI_DF_LOG_BUCKET et OCI_DF_ARTIFACT_BUCKET : oci://<bucket-name>@<tenancy-name>

    • Si la stratégie d'extraction incrémentielle d'une source BICC est configurée pour utiliser une date gérée par le paramètre système Data Integration SYS.LAST_LOAD_DATE, vous n'êtes pas autorisé à modifier la valeur de date lors de la conception.

    • Si la stratégie d'extraction incrémentielle d'une source BICC est configurée pour utiliser une date de dernière extraction paramétrée que vous avez ajoutée, vous pouvez modifier la valeur de date lors de la conception et de l'exécution.

    • Si une entité de données cible paramétrée est configurée pour utiliser la stratégie Fusionner, vous pouvez modifier la sélection de la clé Fusionner.

    • Pour une ressource de données paramétrée nécessitant un emplacement de préparation : si vous sélectionnez une ressource de données pour laquelle aucun emplacement de préparation par défaut n'est indiqué dans cette ressource de données, Data Integration affiche une notification d'avertissement. Lorsque vous voyez la notification, choisissez l'une des options suivantes :
      • Mettez à jour cette ressource de données en ajoutant un emplacement de transfert par défaut.
      • Choisissez une autre ressource de données dotée d'un emplacement de préparation par défaut.

    • Pour une tâche OCI Data Flow paramétrée :

      • Avec une forme de pilote ou d'exécuteur paramétrée, les OCPU et les valeurs de mémoire sont ignorées si une forme non flexible est configurée dans le paramètre. Les OCPU et les valeurs de mémoire sont utilisées uniquement lorsque vous configurez une forme flexible en tant que valeur de paramètre.

      • Avec des OCPU paramétrées et des valeurs de mémoire pour une forme flexible, veillez à indiquer une valeur comprise dans la plage de valeurs acceptable pour cette propriété. Les valeurs acceptables pour les OCPU dépendent de la forme flexible. Les valeurs acceptables pour la mémoire dépendent de la valeur des OCPU.

    Option d'entrée Description
    Affecter une valeur

    Remplacez la valeur par défaut de ce paramètre en spécifiant directement une valeur. La façon dont vous indiquez la valeur dépend du type de paramètre entrant.

    Par exemple, entrez une valeur dans un champ pour le type numérique, chaîne ou date, mais utilisez un menu afin de sélectionner une valeur pour un paramètre de type ressource de données, connexion, schéma et entité de données. Pour le type condition ou expression, utilisez l'éditeur de conditions ou d'expressions.
    Sortie d'opérateur précédente

    Pour utiliser une valeur de sortie d'un opérateur précédent comme entrée pour ce paramètre, sélectionnez une valeur dans la liste des sorties disponibles.

    Seules les sorties du même type que le paramètre entrant peuvent être sélectionnées.

    Par exemple, si le paramètre entrant est STRING, seules les sorties SYS.STATUS et SYS.ERROR_MESSAGE sont disponibles.
    Affecter un paramètre

    Indiquez un paramètre de pipeline pour définir une valeur différente lors de l'exécution du pipeline. Vous pouvez affecter un paramètre défini par l'utilisateur ou un paramètre système en tant qu'entrée du paramètre entrant.

    • Utiliser des paramètres définis par l'utilisateur : sélectionnez un paramètre défini par l'utilisateur existant dans la liste des paramètres disponibles, le cas échéant. Seuls les paramètres du même type que le paramètre entrant peuvent être sélectionnés.

      Le cas échéant, sélectionnez Ajouter le paramètre pour créer le paramètre à choisir dans le pipeline. Dans le panneau d'ajout de paramètre qui s'affiche, entrez un nom et une description (facultative) pour le paramètre. Le type de données ne peut pas être modifié, ce qui est identique au type du paramètre entrant. La façon dont vous définissez les autres champs d'un paramètre dépend du type entrant. Pour créer le paramètre, sélectionnez Ajouter. Par défaut, le nouveau paramètre défini par l'utilisateur ajouté est sélectionné.

    • Utiliser les paramètres système : sélectionnez un paramètre système dans la liste des paramètres disponibles générés par le système d'exécution, le cas échéant. Seuls les paramètres système du même type que le paramètre entrant peuvent être sélectionnés. Les paramètres système OCID sont traités sous le type STRING.

      Par exemple, si un paramètre entrant est VARCHAR, seuls TASK_RUN_NAME, TASK_RUN_KEY, PARENT_TASK_RUN_KEY, TASK_SCHEDULE_TIMEZONE, PIPELINE_NAME et PIPELINE_IDENTIFIER sont disponibles.
  8. Sur la page Configurer les paramètres entrants, vérifiez la valeur par défaut et la valeur configurée du paramètre que vous venez de reconfigurer.
    Une valeur configurée peut être un nom de paramètre défini par l'utilisateur avec la valeur configurée indiquée entre parenthèses.
  9. Répétez les étapes 6 et 7 pour configurer d'autres valeurs d'entrée, si nécessaire. Vous pouvez également sélectionner Modifier ou Effacer pour modifier une valeur précédemment configurée.
  10. Sur la page Configurer le paramètre entrant, sélectionnez Configurer lorsque vous avez terminé de configurer les valeurs des paramètres entrants dans la tâche.