Paramètres spécifiques aux composants - 6.5

Guide de référence des scripts de Jobs Talend

EnrichVersion
6.5
EnrichProdName
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Real-Time Big Data Platform
EnrichPlatform
Studio Talend
Talend CommandLine
task
Création et développement > Création de Jobs

Le tableau suivant présente les fonctions et paramètres des scripts de Jobs que vous pouvez définir dans la fonction setSettings {} du composant.

Fonction/paramètre Description Obligatoire ?

USE_DYNAMIC_JOB

Configurez ce paramètre à true pour activer l'option Use dynamic job autorisant les appels et le traitement de Jobs multiples.

Lorsque cette case est cochée, seule la dernière version des Jobs peut être appelée et traitée. Un processus indépendant sera utilisé pour exécuter le sous-Job.

Avertissement :
  • Cette option n'est pas compatible avec le cache du JobServer. Il est possible que l'exécution échoue si vous exécutez un Job contenant un tRunJob avec cette option activée dans Talend Administration Center.

  • Cette option est incompatible avec l'option Use or register a shared DB Connection des composants de base de données. Lorsqu'un composant tRunJob s'exécute avec un composant de connexion à une base de données, si les deux options sont activées, votre Job échoue.

Non

CONTEXT_JOB

Utilisez ce paramètre pour spécifier :

  • le nom du Job que vous souhaitez appeler, dans la liste des Jobs spécifiés.
  • une variable globale ou une variable de contexte définie pour charger dynamiquement le Job que vous souhaitez appeler, dans la liste des Jobs spécifiés.

Ce paramètre fonctionne uniquement lorsque le paramètre USE_DYNAMIC_JOB est configuré à true.

Avertissement :

Assurez-vous que je Jobs spécifié ou le Job représenté par la variable spécifiée correspond à l'un des ID de processus spécifiés.

Oui si USE_DYNAMIC_JOB est configuré à true

PROCESS

Utilisez ce paramètre pour spécifier :

  • le nom du Job à appeler,
  • le nom de chaque Job à appeler lorsque le paramètre USE_DYNAMIC_JOB est configuré à true. Utilisez un point-virgule (;) pour séparer les différents noms de Jobs.

Oui

PROCESS:PROCESS_TYPE_CONTEXT

Utilisez ce paramètre pour spécifier le contexte défini pour le Job à appeler par le tRunJob.

Ce paramètre est utile uniquement lorsque le paramètre USE_DYNAMIC_JOB n'est pas fourni ou est configuré à false.

Oui si USE_DYNAMIC_JOB est configuré à false

PROCESS:PROCESS_TYPE_PROCESS

Utilisez ce paramètre pour spécifier :

  • l'ID du processus du Job à appeler,
  • l'ID du processus de chaque Job à appeler lorsque le paramètre USE_DYNAMIC_JOB est configuré à true. Utilisez un point-virgule (;) pour séparer les différents ID des processus.

Pour obtenir l'ID du processus d'un Job, allez dans le répertoire <studiodir>/workspace/<projectname>/<processdir>/<jobfolder> et ouvrez le fichier <job>.properties à l'aide d'un éditeur XML. L'ID du processus est la valeur de l'attribut id de l'élément TalendProperties:Property, où :

  • <studiodir> est le répertoire où est installé votre Studio Talend ;
  • <projectname> est le nom du projet ;
  • <processdir> est le dossier contenant les fichiers des propriétés de vos Jobs. Il y a plusieurs dossiers :
    • process pour les Jobs Standard
    • process_mr pour les Jobs MapReduce et Spark Batch
    • process_storm pour les Jobs Spark Streaming et Storm
  • <jobfolder> est le dossier du Job si le Job n'est pas créé sous la racine du référentiel ;
  • <job> est le nom complet du Job, version comprise.

Assurez-vous d'avoir exécuté une fois le ou les Job(s) auparavant, pour une exécution fluide via le tRunJob.

Oui

PROCESS:PROCESS_TYPE_VERSION

Utilisez ce paramètre pour spécifier la version du Job enfant à exécuter.

Par défaut, la dernière version du Job enfant sera exécutée.

Ce paramètre est utile uniquement lorsque le paramètre USE_DYNAMIC_JOB n'est pas fourni ou est configuré à false.

Non

USE_INDEPENDENT_PROCESS

Configurez ce paramètre à true pour utiliser un processus indépendant pour exécuter le sous-Job. Cela vous permettra de résoudre des problèmes liés à la taille limite de la mémoire.

Ce paramètre est utile uniquement lorsque le paramètre USE_DYNAMIC_JOB n'est pas fourni ou est configuré à false.

Avertissement :
  • Cette option n'est pas compatible avec le cache du JobServer. Il est possible que l'exécution échoue si vous exécutez un Job contenant un tRunJob avec cette option activée dans Talend Administration Center.

  • Cette option est incompatible avec l'option Use or register a shared DB Connection des composants de base de données. Lorsqu'un composant tRunJob s'exécute avec un composant de connexion à une base de données, si les deux options sont activées, votre Job échoue.

Non

DIE_ON_CHILD_ERROR

Configurez ce paramètre à false pour exécuter le Job enfant même si une erreur survient lors de l'exécution du Job enfant.

Par défaut, ce paramètre est configuré à true.

Non

TRANSMIT_WHOLE_CONTEXT

Configurez ce paramètre à true pour obtenir toutes les variables de contexte du Job enfant. Configurez-le à false pour obtenir toutes les variables de contexte du Job enfant.

Si ce paramètre est configuré à true lorsque les Jobs parent et enfant ont les mêmes variables de contexte définies :

  • les valeurs des variables du Job enfant seront utilisées durant l'exécution du Job enfant si aucune valeur cohérente n'est définie dans la fonction CONTEXTPARAMS.

  • sinon, les valeurs définies dans la fonction CONTEXTPARAMS seront utilisées durant l'exécution du Job enfant.

Non

CONTEXTPARAMS {}

Dans cette fonction, utilisez les paramètres suivants pour modifier la valeur des variables de contexte définies dans le Job enfant.

  • PARAM_NAME_COLUMN : utilisez ce paramètre pour spécifier la variable de contexte dont vous souhaitez modifier la valeur.
  • PARAM_VALUE_COLUMN : utilisez ce paramètre afin de spécifier une nouvelle valeur pour la variable de contexte.

Les valeurs définies ici seront utilisées durant l'exécution du Job enfant même si le paramètre TRANSMIT_WHOLE_CONTEXT est configuré à true.

Non

PROPAGATE_CHILD_RESULT

Configurez ce paramètre à true afin de propager les données de sortie stockées dans la mémoire tampon via un composant tBufferOutput dans le Job enfant au composant de sortie dans le Job enfant.

Par défaut, ce paramètre est configuré à false.

Ce paramètre est utile uniquement lorsque le paramètre USE_DYNAMIC_JOB n'est pas fourni ou est configuré à false.

Non

PRINT_PARAMETER

Configurez ce paramètre à true pour afficher les paramètres internes et externes dans la console de la vue Run.

Non

TSTATCATCHER_STATS

Configurez ce paramètre à true pour rassembler les métadonnées de traitement au niveau du Job ainsi qu'un niveau des composants.

Par défaut, ce paramètre est configuré à false.

Non

LABEL

Utilisez ce paramètre pour spécifier un libellé textuel pour le composant.

Non