Documentation sur Oracle Cloud Infrastructure

Configuration de paramètres entrants pour les tâches

Cette procédure s'applique seulement aux tâches où 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 de 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 de pipeline défini par l'utilisateur pour la valeur à définir lors de l'exécution. Le cas échéant, vous pouvez également affecter à l'entrée la valeur d'un paramètre de système ou la valeur de la sortie d'un opérateur précédent.

  1. Sur le canevas d'un pipeline, sélectionnez la tâche pour laquelle vous souhaitez voir 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. À côté 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 cette tâche et qu'ils n'ont pas été configurés de nouveau.
  4. Sélectionnez Configurer à côté des paramètres entrants configurés.
  5. Dans la page Configurer les paramètres entrants, vérifiez les entrées qui peuvent être configurées.
    Une entrée a une valeur par défaut. Si le paramètre entrant est configuré de nouveau, l'entrée a une valeur configurée. Une valeur configurée peut être le nom d'un paramètre défini par l'utilisateur avec la valeur configurée indiquée entre parenthèses.
  6. (Facultatif) Dans la rangée du type de paramètre et de la valeur à configurer, sélectionnez Configurer.
    Si le paramètre entrant est déjà reconfiguré, sélectionnez Modifier pour modifier la valeur configurée ou Effacer pour supprimer la valeur.
  7. Dans la page Configurer le paramètre entrant pour <type> qui s'affiche 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.

    Notez les points suivants lors de la configuration des paramètres entrants :

    • Si une tâche est configurée pour s'exécuter dans le service de flux de données OCI, 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 de système du service d'intégration de données 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 de fusion, vous pouvez modifier la sélection de la clé de fusion.

    • Pour une ressource de données paramétrée qui nécessite un emplacement temporaire : Si vous sélectionnez une ressource de données qui n'a pas d'emplacement temporaire par défaut spécifié dans cette ressource de données, le service d'intégration de données affiche un avis d'avertissement. Lorsque l'avis s'affiche, sélectionnez l'une des options suivantes :
      • Mettez à jour cette ressource de données en ajoutant un emplacement temporaire par défaut.
      • Sélectionnez une ressource de données différente qui a un emplacement temporaire par défaut.

    • Pour une tâche de flux de données OCI paramétrée :

      • Avec une forme de pilote ou d'exécuteur paramétrée, les valeurs d'OCPU et 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 ne sont utilisées que lorsque vous configurez une forme flexible en tant que valeur de paramètre.

      • Avec les OCPU paramétrées et les valeurs de mémoire pour une forme flexible, assurez-vous de spécifier une valeur comprise dans l'intervalle 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 une valeur directement. La façon de spécifier une valeur dépend du type de paramètre entrant.

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

    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 un paramètre entrant est une chaîne (STRING), seuls SYS.STATUS et SYS.ERROR_MESSAGE sont disponibles.
    Affecter un paramètre

    Spécifiez un paramètre de pipeline pour définir une valeur différente lorsque le pipeline est exécuté. Vous pouvez affecter un paramètre défini par l'utilisateur ou un paramètre de système comme entrée du paramètre entrant.

    • Utiliser les 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.

      S'il y a lieu, sélectionnez Ajouter un paramètre pour créer un paramètre dans le pipeline et le sélectionner. Dans le panneau Ajouter un paramètre qui s'affiche, entrez un nom et une description facultative pour le paramètre. Impossible de modifier le type de données, qui est le même que le type du paramètre entrant. La façon de remplir le reste des champs pour un paramètre dépend du type de paramètre entrant. Pour créer le paramètre, sélectionnez Ajouter. Par défaut, le nouveau paramètre défini par l'utilisateur est sélectionné.

    • Utiliser les paramètres de système : Sélectionnez un paramètre de 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 de système du même type que le paramètre entrant peuvent être sélectionnés. Les paramètres de système OCID sont traités comme des chaînes (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. Dans la page Configurer les paramètres entrants, vérifiez la valeur par défaut et la valeur configurée pour le paramètre que vous venez de configurer.
    Une valeur configurée peut être le nom d'un 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, s'il y a lieu. Vous pouvez également sélectionner Modifier ou Supprimer pour modifier une valeur précédemment configurée.
  10. Dans la page Configurer les paramètres entrants, sélectionnez Configurer lorsque vous avez terminé la configuration des valeurs des paramètres entrants dans la tâche.