Академический Документы
Профессиональный Документы
Культура Документы
5.6.2
Composants Talend Open Studio
Copyleft
Cette documentation est mise disposition selon les termes du Contrat Public Creative Commons (CPCC).
Pour plus d'informations concernant votre utilisation de cette documentation en accord avec le Contrat CPCC,
consultez : http://creativecommons.org/licenses/by-nc-sa/2.0/
Mentions lgales
Tous les noms de marques, de produits, les noms de socits, les marques de commerce et de service sont la
proprit de leurs dtenteurs respectifs.
Licence applicable
Le logiciel dcrit dans cette documentation est soumis la Licence Apache, Version 2.0 (la "Licence"). Vous ne
pouvez utiliser ce logiciel que conformment aux dispositions de la Licence. Vous pouvez obtenir une copie de
la Licence sur http://www.apache.org/licenses/LICENSE-2.0.html (en anglais). Sauf lorsqu'explicitement prvu
par la loi en vigueur ou accept par crit, le logiciel distribu sous la Licence est distribu "TEL QUEL", SANS
GARANTIE OU CONDITION D'AUCUNE SORTE, expresse ou implicite. Consultez la Licence pour connatre
la terminologie spcifique rgissant les autorisations et les limites prvues par la Licence.
Ce produit comprend les logiciels dvelopps par AOP Alliance (standards Java/J2EE AOP), ASM, Amazon,
AntlR, Apache ActiveMQ, Apache Ant, Apache Axiom, Apache Axis, Apache Axis 2, Apache Batik, Apache
CXF, Apache Chemistry, Apache Common Http Client, Apache Common Http Core, Apache Commons,
Apache Commons Bcel, Apache Commons JxPath, Apache Commons Lang, Apache Derby Database Engine
and Embedded JDBC Driver, Apache Geronimo, Apache Hadoop, Apache Hive, Apache HttpClient, Apache
HttpComponents Client, Apache JAMES, Apache Log4j, Apache Lucene Core, Apache Neethi, Apache POI,
Apache ServiceMix, Apache Tomcat, Apache Velocity, Apache WSS4J, Apache WebServices Common Utilities,
Apache Xml-RPC, Apache Zookeeper, Box Java SDK (V2), CSV Tools, DataStax Java Driver for Apache
Cassandra, Ehcache, Ezmorph, Ganymed SSH-2 for Java, Google APIs Client Library for Java, Google Gson,
Groovy, Guava : Google Core Libraries for Java, H2 Embedded Database and JDBC Driver, Hector : A high level
Java client for Apache Cassandra, Hibernate Validator, HighScale Lib, HsqlDB, Ini4j, JClouds, JLine, JSON,
JSR 305 : Annotations for Software Defect Detection in Java, JUnit, Jackson Java JSON-processor, Java API for
RESTful Services, Java Agent for Memory Measurements, Jaxb, Jaxen, Jettison, Jetty, Joda-Time, Json Simple,
LightCouch, MetaStuff, Mondrian, OpenSAML, Paraccel JDBC Driver, PostgreSQL JDBC Driver, Resty : A
simple HTTP REST client for Java, Rocoto, SL4J : Simple Logging Facade for Java, SQLite JDBC Driver, Simple
API for CSS, SshJ, StAX API, StAXON - JSON via StAX, The Castor Project, The Legion of the Bouncy Castle,
W3C, Woden, Woodstox : High-performance XML processor, Xalan-J, Xerces2, XmlBeans, XmlSchema Core,
Xmlsec - Apache Santuario, Zip4J, atinject, dropbox-sdk-java : Java library for the Dropbox Core API, google-
guice. Fournis sous leur licence respective.
tCentricCRMInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Table des matires Proprits du tCentricCRMInput . . . . . . . . . 77
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Prface ............................................. xxiii tCentricCRMOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Informations gnrales . . . . . . . . . . . . . . . . . . . . . . . xxiii Proprits du tCentricCRMOutput . . . . . . . 79
Objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Public vis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii tHL7Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Conventions typographiques . . . . . . . . . . . xxiii Proprits du tHL7Input . . . . . . . . . . . . . . . . . 81
Remarques et Support . . . . . . . . . . . . . . . . . . . . . . . . xxiv Scnario : Retrouver des
Composants Big Data ............................. 1 informations concernant les patients
tGSBucketCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 et les vnements partir dun
Proprits du tGSBucketCreate . . . . . . . . . . . 2 fichier HL7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 tHL7Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
tGSBucketDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Proprits du tHL7Output . . . . . . . . . . . . . . . . 86
Proprits du tGSBucketDelete . . . . . . . . . . . 4 Scnario : Gnrer un accus de
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 rception (Acknowledgment) HL7 . . . . . . . 86
tGSBucketExist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Proprits du tGSBucketExist . . . . . . . . . . . . . 6 tMarketoInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Proprits du tMarketoInput . . . . . . . . . . . . . 94
tGSBucketList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Proprits du tGSBucketList . . . . . . . . . . . . . . 8 tMarketoListOperation . . . . . . . . . . . . . . . . . . . . . . . . . 98
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Proprits du tMarketoListOperation . . . . 98
tGSClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Scnario : Ajouter un enregistrement
Proprits du tGSClose . . . . . . . . . . . . . . . . . . 10 de prospects dans une liste de la base
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . 10 de donnes Marketo . . . . . . . . . . . . . . . . . . . . . . 99
tGSConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 tMarketoOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Proprits du tGSConnection . . . . . . . . . . . . 11 Proprits du tMarketoOutput . . . . . . . . . . 103
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Scnario : Insrer et rcuprer des
tGSCopy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 donnes d'une base de donnes
Proprits du tGSCopy . . . . . . . . . . . . . . . . . . . 12 Marketo via un systme externe . . . . . . . . 105
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . 13 tMicrosoftCrmInput . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
tGSDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Proprits du tMicrosoftCrmInput . . . . . . 111
Proprits du tGSDelete . . . . . . . . . . . . . . . . . . 14 Scnario : Ecrire des donnes dans
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . 15 une base de donnes Microsoft
tGSGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 CRM et attribuer des conditions aux
tGSGet properties . . . . . . . . . . . . . . . . . . . . . . . . 16 colonnes pour extraire des lignes
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . 17 spcifiques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
tGSList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 tMicrosoftCrmOutput . . . . . . . . . . . . . . . . . . . . . . . . . 120
Proprits du tGSList . . . . . . . . . . . . . . . . . . . . 18 Proprits du tMicrosoftCrmOutput . . . . 120
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 122
tGSPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 tMSAXInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Proprits du tGSPut . . . . . . . . . . . . . . . . . . . . . 20 Proprits du tMSAXInput . . . . . . . . . . . . . 123
Scnario : Grer des fichiers avec Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 124
Google Cloud Storage . . . . . . . . . . . . . . . . . . . . 21 tMSAXOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
tHiveClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Proprits du tMSAXOutput . . . . . . . . . . . . 125
Proprits du tHiveClose . . . . . . . . . . . . . . . . . 28 Scnario : Insrer des donnes dans
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . 29 une table dfinie sur le serveur
tHiveConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Microsoft AX . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Proprits du tHiveConnection . . . . . . . . . . . 30 Scnario 2 : Effacer des donnes
Connexion une distribution Hadoop d'une table prcise sur le serveur
personnalise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 MicrosoftAX. . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Scnario : Crer une table Hive tNetsuiteInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
partitionne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Proprits du tNetsuiteInput . . . . . . . . . . . . 133
tHiveRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 134
Proprits du tHiveRow . . . . . . . . . . . . . . . . . . 45 tNetsuiteOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . . . 52 Proprits du tNetsuiteOutput . . . . . . . . . . 135
Composants Business ............................ 53 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 137
tAlfrescoOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 tOpenbravoERPInput . . . . . . . . . . . . . . . . . . . . . . . . . 138
Proprits du tAlfrescoOutput . . . . . . . . . . . 54 Proprits du tOpenbravoERPInput . . . . 138
Scnario : Crer des documents sur Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 139
un serveur Alfresco . . . . . . . . . . . . . . . . . . . . . . 59 tOpenbravoERPOutput . . . . . . . . . . . . . . . . . . . . . . . 140
tBonitaDeploy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Proprits du tOpenbravoERPOutput . . . 140
Proprits du tBonitaDeploy . . . . . . . . . . . . . 65 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 141
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . . 66 tSageX3Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
tBonitaInstantiateProcess . . . . . . . . . . . . . . . . . . . . . . 67 Proprits du tSageX3Input . . . . . . . . . . . . . 142
Proprits du Scnario : Utiliser les cls des
tBonitaInstantiateProcess . . . . . . . . . . . . . . . . . 67 requtes pour extraire des donnes
Scnario 1 : Excuter un processus d'un systme Sage X3 donn . . . . . . . . . . . 143
Bonita via un Job Talend . . . . . . . . . . . . . . . . 69 tSageX3Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Scnario 2 : Ecrire en sortie l'UUID Proprits du tSageX3Output . . . . . . . . . . . 147
de l'instance du processus via le lien
Row > Main . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Informations gnrales
Objectif
Ce Guide de rfrence propose des scnarios et dtaille comment paramtrer les principaux
composants accessibles partir de chacun des diffrents groupes de la Palette dans la perspective
Integration du Studio Talend.
Le Guide de rfrence des composants Talend est la version franaise non exhaustive du Components
Reference Guide anglais. Pour les composants non documents, rfrez-vous ce dernier. Veillez consulter
rgulirement le site Internet de Talend pour tlcharger la dernire version du Guide de rfrence franais.
Les informations contenues dans ce document s'appliquent la version 5.6.2 du Studio Talend.
Public vis
Ce guide s'adresse aux utilisateurs et aux administrateurs du Studio Talend.
Dans ce document, l'interface prsente par le biais des captures d'cran peut tre lgrement diffrente de
la vtre.
Conventions typographiques
Ce guide utilise les conventions typographiques suivantes :
texte en gras : boutons et champs d'une fentre ou d'une bote de dialogue, touches du clavier,
menus et options des menus ;
texte en italique : nom des fichiers, schmas, colonnes, lignes ou variables dont il est question dans
les exemples utiliss, ainsi que le nom des champs des vues Basic settings et Advanced settings
dont il est fait mention dans le tableau des proprits de chaque composant.
L'icne introduit un paragraphe apportant une information supplmentaire sur un point
important. Elle introduit galement les commentaires relatifs un tableau ou une image.
L'icne introduit un message apportant une information relative aux modalits d'excution, ou
des recommandations particulires. Elle est galement utilise pour attirer l'attention de l'utilisateur
sur certaines informations ou situations particulirement importantes.
Remarques et Support
Votre opinion nous intresse, n'hsitez pas nous faire part de vos remarques, suggestions, requtes
concernant la documentation ou le produit, et obtenez le support de notre quipe Talend, sur le Forum
Talend (en anglais) disponible l'adresse :
http://talendforge.org/forum
L'utilisation de ces composants vous permet de vous connecter aux modules de la distribution d'Hadoop que vous
utilisez dans un environnement de dveloppement unifi et d'effectuer des oprations nativement sur des clusters
Big Data.
Les composants Big Data permettent de crer des connexions diffrents outils tiers utiliss pour le transfert,
le stockage ou l'analyse de Big Data, tels que Sqoop, MongoDB ou BigQuery. Ils vous permettent de charger,
extraire, transformer et traiter rapidement des ensembles de donnes volumineux et varis.
Votre opinion nous intresse, n'hsitez pas nous faire part de vos remarques, suggestions, requtes concernant
la documentation ou le produit, et obtenez le support de notre quipe Talend, sur le Forum Talend (en anglais)
disponible l'adresse : http://www.talendforge.org/forum/index.php
tGSBucketCreate
Proprits du tGSBucketCreate
Famille de composant Big Data / Google Cloud Storage
Fonction Le composant tGSBucketCreate cre un nouveau bucket dans Google Cloud Storage.
Objectif Ce composant permet de crer un nouveau bucket que vous pouvez utiliser afin d'organiser des donnes et
contrler les accs aux donnes dans Google Cloud Storage.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key et Secret Key Saisissez les informations d'authentification obtenues de Google afin
d'effectuer des requtes sur Google Cloud Storage.
Selon l'ACL du bucket, les accs requis par les utilisateurs sont accepts
ou rejets. Si vous ne spcifiez pas d'ACL prdfinie pour le nouveau
bucket, l'ACL prive prdfinie du projet s'applique.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau
du Job qu'au niveau de chaque composant.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec un tGSBucketList afin de vrifier si le nouveau bucket est
correctement cr.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Pour des scnarios associs, consultez Scnario : Vrifier l'absence d'un bucket, le crer et lister tous les buckets
S3 .
tGSBucketDelete
Proprits du tGSBucketDelete
Famille de composant Big Data / Google Cloud Storage
Fonction Le composant tGSBucketDelete supprime un bucket dans Google Cloud Storage.
Objectif Ce composant supprime un bucket vide dans Google Cloud Storage afin de librer des ressources occupes.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key et Secret Key Saisissez les informations d'authentification obtenues de Google afin
d'effectuer des requtes sur Google Cloud Storage.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec un tGSBucketList afin de vrifier si les donnes sont bien
importes.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tGSBucketExist
Proprits du tGSBucketExist
Famille de composant Big Data / Google Cloud Storage
Fonction Le composant tGSBucketExist vrifie que le bucket spcifi existe dans Google Cloud Storage.
Objectif Ce composant permet de vrifier l'existence d'un bucket afin d'effectuer plus d'oprations.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key et Secret Key Saisissez les informations d'authentification obtenues de Google afin
d'effectuer des requtes sur Google Cloud Storage.
BUCKET_NAME : nom d'un bucket spcifi. Cette variable est une variable Flow et retourne une chane
de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilisable en tant que composant standalone.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Pour des scnarios associs, Scnario : Vrifier l'absence d'un bucket, le crer et lister tous les buckets S3 .
tGSBucketList
Proprits du tGSBucketList
Famille de composant Big Data / Google Cloud Storage
Fonction Le composant tGSBucketList effectue une boucle sur tous les buckets de tous les projets ou d'un projet
spcifique dans Google Cloud Storage.
Objectif Ce composant vous permet de rcuprer une liste des buckets de tous les projets ou d'un projet spcifique
dans Google Cloud Storage.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key et Secret Key Saisissez les informations d'authentification obtenues de Google afin
d'effectuer des requtes sur Google Cloud Storage.
NB_BUCKET : nombre de buckets. Cette variable est une variable After et retourne un nombre entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilisable en tant que composant standalone ou en tant que composant de dbut d'un Job.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Pour un scnario associ, consultez Scnario : Vrifier l'absence d'un bucket, le crer et lister tous les buckets S3 .
tGSClose
Proprits du tGSClose
Famille de composant Big Data / Google Cloud Storage
Fonction Le composant tGSClose ferme une connexion active sur Google Cloud Storage.
Objectif Ce composant permet de fermer une connexion Google Cloud Storage afin de librer les
ressources occupes.
Basic settings Component List Dans la liste, slectionnez le composant
tGSConnection si plus d'une connexion est prvue
pour le Job courant.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log,
aussi bien au niveau du Job qu'au niveau de chaque
composant.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient.
Cette variable est une variable After et retourne une chane de caractres. Cette variable
fonctionne uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Google Cloud Storage, en
particulier le tGSConnection.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Pour un scnario dans lequel le tGSClose est utilis, consultez Scnario : Grer des fichiers avec Google Cloud
Storage.
tGSConnection
Proprits du tGSConnection
Famille de composant Big Data / Google Cloud Storage
Fonction Le composant tGSConnection ouvre une connexion Google Cloud Storage.
Objectif Ce composant permet de fournir les informations d'authentification ncessaires pour effectuer des requtes
sur le systme Google Cloud Storage et permet de rutiliser la connexion cre pour Google Cloud Storage.
Basic settings Access Key et Secret Key Saisissez les informations d'authentification obtenues de Google afin
d'effectuer des requtes sur Google Cloud Storage.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Google Cloud Storage, en particulier le
tGSClose.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Pour un scnario dans lequel le tGSConnection est utilis, consultez Scnario : Grer des fichiers avec Google
Cloud Storage.
tGSCopy
Proprits du tGSCopy
Famille de composant Big Data / Google Cloud Storage
Fonction Le composant tGSCopy copie ou dplace des objets au sein d'un bucket ou entre plusieurs buckets dans
Google Cloud Storage.
Objectif Ce composant permet de rationaliser les traitements en effectuant des tches de copie de manire
automatique.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component List pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key et Secret Key Saisissez les informations d'authentification obtenues de Google afin
d'effectuer des requtes sur Google Cloud Storage.
Global Variables SOURCE_BUCKET : nom du bucket source. Cette variable est une variable After et retourne une chane
de caractres.
SOURCE_OBJECTKEY : cl d'un objet source. Cette variable est une variable After et retourne une
chane de caractres.
DESTINATION_BUCKETNAME : nom du bucket cible. Cette variable est une variable After et
retourne une chane de caractres.
DESTINATION_FOLDER : dossier cible. Cette variable est une variable After et retourne une chane
de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Pour un scnario dans lequel le tGSCopy est utilis, consultez Scnario : Grer des fichiers avec Google Cloud
Storage.
tGSDelete
Proprits du tGSDelete
Famille de composant Big Data / Google Cloud Storage
Fonction Le composant tGSDelete supprime les objets qui correspondent aux critres dfinis dans Google Cloud
Storage.
Objectif Ce composant permet de supprimer des objets depuis Google Cloud Storage afin de librer des ressources
occupes.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component List pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key et Secret Key Saisissez les informations d'authentification obtenues de Google afin
d'effectuer des requtes sur Google Cloud Storage.
Key prefix : saisissez le prfixe pour supprimer les objets dont les
cls commencent par la chane dfinie dans le bucket spcifi.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette
variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis avec le composant tGSList afin de vrifier si les objets correspondant aux
critres dfinis sont correctement supprims.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Pour un scnario dans lequel le tGSDelete est utilis, consultez Scnario : Grer des fichiers avec Google Cloud
Storage.
tGSGet
tGSGet properties
Famille de composant Big Data / Google Cloud Storage
Fonction Le composant tGSGet rcupre les objets qui correspondent aux critres dfinis dans Google Cloud Storage
et les envoie vers un dossier local.
Objectif Ce composant permet de tlcharger des fichiers depuis Google Cloud Storage vers un dossier local.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant adquat dans la liste
Component List pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Access Key et Secret Key Saisissez les informations d'authentification obtenues de Google afin
d'effectuer des requtes sur Google Cloud Storage.
Key prefix : saisissez le prfixe pour tlcharger des objets dont les
cls commencent par le prfixe spcifi dans le bucket dfini.
Si vous cochez la case Get files from bucket list, les champs
Key prefix et Delimiter, ainsi que les cases Specify project
ID et Use keys ne sont pas disponibles.
Output directory Spcifiez le dossier dans lequel vous souhaitez stocker les objets
tlchargs.
Die on error Cette case est dcoche par dfaut, afin d'ignorer les lignes en erreur et
de terminer le traitement avec les lignes sans erreur.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job
ainsi qu'au niveau de chaque composant.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette
variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Google Cloud Storage, par exemple le
tGSPut.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tGSList
Proprits du tGSList
Famille de composant Big Data / Google Cloud Storage
Fonction Le composant tGSList fait une boucle sur une liste d'objets qui correspondent aux critres spcifis dans
Google Cloud Storage.
Objectif Ce composant permet de rcuprer, un un, une liste d'objets depuis Google Cloud Storage.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant adquat dans la liste
Component List pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Access Key et Secret Key Saisissez les informations d'authentification obtenues de Google afin
d'effectuer des requtes sur Google Cloud Storage.
Key prefix : saisissez le prfixe pour lister uniquement les objets dont
les cls commencent par la chane dfinie dans le bucket spcifi.
CURRENT_KEY : cl courante. Cette variable est une variable Flow et retourne une chane de caractres.
NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette
variable est une variable After et retourne un entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Le composant tGSList peut tre utilis en standalone ou en tant que composant de dbut.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Pour un scnario dans lequel le tGSList est utilis, consultez Scnario : Grer des fichiers avec Google Cloud
Storage.
tGSPut
Proprits du tGSPut
Famille de composant Big Data / Google Cloud Storage
Fonction Le composant tGSPut met un fichier d'un dossier local dans Google Cloud Storage.
Objectif Ce composant est conu pour charger des fichiers dans Google Cloud Storage afin que vous puissiez les
grer avec Google Cloud Storage.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component List pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key et Secret Key Saisissez les informations d'authentification obtenues de Google pour
envoyer des requtes Google Cloud Storage.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis avec d'autres composants Google Cloud Storage, par exemple le tGSGet.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Prrequis : Vous devez possder un compte Google Cloud Storage et avoir cr trois buckets dans le mme
rpertoire Google Cloud Storage. Dans cet exemple, les buckets crs sont bighouse, bed_room et study_room.
1. Dposez les composants suivants de la Palette dans l'espace de modlisation graphique : un tGSConnection,
un tGSPut, deux tGSCopy, un tGSDelete, un tGSList, un tIterateToFlow, un tLogRow et un tGSClose.
2. Reliez le tGSConnection au tGSPut l'aide d'un lien Trigger > On Subjob Ok.
3. Reliez le tGSPut au premier tGSCopy l'aide d'un lien Trigger > On Subjob Ok.
4. Reliez ensuite le premier tGSCopy au second tGSCopy, le tGSCopy au tGSDelete, le tGSDelete au tGSList
et le tGSList au tGSClose l'aide de liens Trigger > On Subjob Ok.
2. Naviguez vers la console d'API de Google dans votre navigateur afin d'accder au projet Google contenant
les services Cloud Storage que vous souhaitez utiliser.
3. Cliquez sur Google Cloud Storage > Interoperable Access afin d'ouvrir la vue correspondante et copiez la
cl d'accs et la cl secrte dans votre presse-papier.
4. Dans la vue Component du Studio, collez la cl d'accs et la cl secrte dans les champs correspondants,
respectivement Access Key et Secret Key.
2. Cochez la case Use an existing connection puis slectionnez la connexion que vous avez configure
prcdemment.
3. Dans le champ Bucket name, saisissez le nom du bucket dans lequel vous souhaitez charger les fichiers,
bighouse dans cet exemple.
4. Dans le champ Local directory, parcourez votre systme vers le dossier contenant les fichiers charger, D:/
Input/House dans cet exemple.
2. Cochez la case Use an existing connection puis slectionnez la connexion que vous avez configure
prcdemment.
3. Dans le champ Source bucket name, saisissez le nom du bucket partir duquel vous souhaitez copier les
fichiers, bighouse dans cet exemple.
4. Cochez la case Source is a folder. Tous les fichiers contenus dans le bucket bighouse sont copis.
5. Dans le champ Target bucket name, saisissez le nom du bucket vers lequel vous souhaitez copier les fichiers,
bed_room dans cet exemple.
1. Double-cliquez sur le second tGSCopy afin d'ouvrir sa vue Basic settings dans l'onglet Component.
2. Cochez la case Use an existing connection puis slectionnez la connexion que vous avez configure
prcdemment.
3. Dans le champ Source bucket name, saisissez le nom du bucket contenant le fichier que vous souhaitez
dplacer, bighouse dans cet exemple.
4. Dans le champ Source object key, saisissez la cl de l'objet dplacer, computer_01.txt dans cet exemple.
5. Dans le champ Target bucket name, saisissez le nom du bucket vers lequel vous souhaitez dplacer le
fichier, study_room dans cet exemple.
6. Slectionnez Move dans la liste Action. Le fichier source dfini, computer_01.txt, est dplac du bucket
bighouse vers le bucket study_room.
7. Cochez la case Rename. Dans le champ New name, saisissez un nouveau nom pour le fichier dplac,
laptop.txt dans cet exemple.
1. Double-cliquez sur le tGSDelete, afin d'ouvrir sa vue Basic settings dans l'onglet Component.
2. Cochez la case Use an existing connection puis slectionnez la connexion que vous avez configure
prcdemment.
3. Cochez la case Delete object from bucket list. Dans la table Bucket, saisissez les informations du fichier
que vous souhaitez supprimer.
Dans cet exemple, le fichier computer_03.csv est supprim du bucket bed_room dont les fichiers sont copis
depuis le bucket bighouse.
1. Double-cliquez sur le tGSList afin d'ouvrir sa vue Basic settings dans l'onglet Component.
2. Cochez la case Use an existing connection puis slectionnez la connexion que vous avez configure
prcdemment.
3. Cochez la case List objects in bucket list. Dans la colonne Bucket name de la table Bucket, saisissez le nom
des trois buckets, bighouse, study_room et bed_room.
4. Double-cliquez sur le tIterateToFlow afin d'ouvrir sa vue Basic settings dans l'onglet Component.
5. Cliquez sur le bouton Edit schema afin de dfinir les donnes qui sont passes au tLogRow.
Dans cet exemple, ajoutez deux colonnes, bucketName et key, de type Object.
7. Double-cliquez sur le tLogRow afin d'ouvrir sa vue Basic settings dans l'onglet Component.
8. Slectionnez l'option Table (print values in cells of a table) pour un meilleur affichage des rsultats.
2. Dans la liste Component List, slectionnez la connexion que vous souhaitez fermer.
2. Appuyez sur F6 ou cliquez sur Run dans l'onglet Run afin d'excuter le Job.
Les fichiers contenus dans les trois buckets s'affichent. Comme attendu, les fichiers du bucket bighouse sont
d'abord copis vers le bucket bed_room. Ensuite, le fichier computer_01.txt du bucket bighouse est dplac
vers le bucket study_room puis renomm laptop.txt. Enfin, le fichier computer_03.csv est supprim du bucket
bed_room.
tHiveClose
Proprits du tHiveClose
Famille de composant Big Data/Hive
Fonction Le composant tHiveClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes Hive.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tHiveConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Hive, notamment le
tHiveConnection, car le tHiveConnection vous permet d'ouvrir une connexion pour la transaction
effectuer.
Prrequis La distribution Hadoop doit tre correctement installe afin de garantir les interactions avec le
Studio Talend. La liste suivante prsente des informations d'exemple relatives MapR.
Assurez-vous d'avoir install le client MapR sur la mme machine que le Studio Talend et
d'avoir ajout la bibliothque client de MapR dans la variable PATH de cette machine. D'aprs
la documentation de MapR, la ou les librairies du client MapR correspondant chaque OS
peuvent tre trouves MAPR_INSTALL\ hadoop\hadoop-VERSION\lib\native. Par exemple,
pour Windows, la bibliothque est lib\MapRClient.dll dans le fichier Jar du client MapR. Pour
plus d'informations, consultez la page suivante sur le site de MapR : http://www.mapr.com/
blog/basic-notes-on-configuring-eclipse-as-a-hadoop-development-environment-for-mapr (en
anglais).
Si vous n'ajoutez pas de librairie, il est possible que vous rencontriez l'erreur suivante : no
MapRClient in java.library.path.
au studio le chemin d'accs la bibliothque native du client MapR. Cela permet aux utilisateurs
en souscription d'utiliser entirement l'aperu des donnes (Data viewer) afin de visualiser
localement dans le studio les donnes stockes dans MapR. Pour plus d'informations concernant
la configuration de cet argument, consultez la section expliquant comment visualiser les donnes
dans le Guide de prise en main de Talend Open Studio for Big Data.
Pour plus d'informations concernant l'installation d'une distribution Hadoop, consultez le manuel
correspondant la distribution Hadoop que vous utilisez.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tHiveConnection
Proprits du tHiveConnection
Famille de composant Big Data/Hive
Fonction Le composant tHiveConnection ouvre une connexion vers une base de donnes Hive.
Objectif Ce composant vous permet d'tablir une connexion Hive rutiliser dans d'autres composants Hive
de votre Job.
Basic settings Property type Peut tre Built-in ou Repository.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les
proprits du composant. Les champs suivants sont alors pr-remplis
l'aide des donnes collectes.
Version Distribution Slectionnez dans la liste le cluster que vous utilisez. Les options de
la liste varient selon le composant que vous utilisez. Les options de la
liste dpendent des composants que vous utilisez, Parmi ces options,
les suivantes ncessitent une configuration spcifique.
mapreduce.application.framework.path=/hdp/
apps/2.2.0.0-2041/mapreduce/mapreduce.tar.gz#mr-
framework
Cloudera CDH4 +
Pivotal HD 2.0 +
Hadoop properties Set Jobtracker URI Cochez cette case pour indiquer l'emplacement du service
JobTracker utiliser, dans le cluster Hadoop. Par exemple, si vous
avez choisi une machine nomme machine1 comme JobTracker,
dfinissez son emplacement comme suit machine1:portnumber.
Notez qu'un JobTracker est le service qui assigne des tches Map/
Reduce des nuds spcifiques dans un cluster Hadoop. Le
mot "Job" dans JobTracker ne dsigne pas un Job Talend mais
un job Hadoop, dcrit comme job MR ou MapReduce dans la
documentation de Apache Hadoop : http://hadoop.apache.org (en
anglais).
Dans ce cas, vous devez saisir les valeurs que vous souhaitez utiliser
pour la mmoire alloue aux oprations map et reduce dans les
champs Mapred job map memory mb et Mapred job reduce
memory mb, respectivement. Par dfaut, les valeurs sont toutes les
deux 1000, ce qui est normalement adapt pour l'excution de ces
oprations.
Path separator in server Laissez le champ Path separator in server tel quel, sauf si vous
changez le sparateur utilis par la machine hte de votre distribution
Hadoop pour sa variable PATH. En d'autres termes, changez le
sparateur si celui-ci n'est pas le signe deux points (:). Dans ce cas,
vous devez remplacer cette valeur par celle utilise dans votre hte.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au
niveau du Job qu'au niveau de chaque composant.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants Hive, notamment le composant
tHiveClose.
Si le Studio Talend utilis pour vous connecter une base de donnes Hive fonctionne sous
Windows, vous devez crer manuellement un dossier appel tmp la racine du disque o le Studio
Talend est install.
Prrequis La distribution Hadoop doit tre correctement installe afin de garantir les interactions avec le
Studio Talend. La liste suivante prsente des informations d'exemple relatives MapR.
Assurez-vous d'avoir install le client MapR sur la mme machine que le Studio Talend et
d'avoir ajout la bibliothque client de MapR dans la variable PATH de cette machine. D'aprs
la documentation de MapR, la ou les librairies du client MapR correspondant chaque OS
peuvent tre trouves MAPR_INSTALL\ hadoop\hadoop-VERSION\lib\native. Par exemple,
pour Windows, la bibliothque est lib\MapRClient.dll dans le fichier Jar du client MapR. Pour
Si vous n'ajoutez pas de librairie, il est possible que vous rencontriez l'erreur suivante : no
MapRClient in java.library.path.
Pour plus d'informations concernant l'installation d'une distribution Hadoop, consultez le manuel
correspondant la distribution Hadoop que vous utilisez.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Une fois l'option Custom slectionne, cliquez sur le bouton pour afficher la bote de dialogue [Import
custom definition], puis procdez comme suit :
1. Selon votre cas, slectionnez Import from existing version ou Import from zip afin de configurer la
distribution Hadoop personnalise laquelle vous souhaitez vous connecter.
Si vous avez le fichier .zip de la distribution Hadoop laquelle vous souhaitez vous connecter, slectionnez
Import from zip. La communaut Talend fournit ce type de fichiers .zip que vous pouvez tlcharger
depuis http://www.talendforge.org/exchange/index.php.
Sinon, slectionnez Import from existing version pour importer une distribution de base officiellement
supporte afin de la personnaliser l'aide de l'assistant suivant.
Notez que les cases de cet assistant vous permettent de slectionner le(s) lment(s) Hadoop que vous
souhaitez importer. Selon le contexte dans lequel vous crez la connection, toutes les cases ne sont pas
disponibles. Par exemple, si vous crez cette connexion pour un composant Hive, seule la case Hive est
disponible.
2. Que vous ayez slectionn Import from existing version ou Import from zip, vrifiez que chaque case
ct de l'lment Hadoop que vous souhaitez importer est coche.
3. Cliquez sur OK et, dans la fentre d'avertissement, cliquez sur Yes pour accepter d'craser toute configuration
personnalise des fichiers Jar prcdemment implmente.
Cette bote de dialogue liste les lments Hadoop et les fichiers Jar que vous importez.
4. Si vous avez coch l'option Import from zip, cliquez sur OK afin de valider la configuration importe.
Si avez slectionn l'option Import from existing version, afin d'importer une distribution de base, vous
devez galement importer des fichiers jar pour personnaliser cette distribution. Dans l'onglet de l'lment
Hadoop que vous souhaitez personnaliser, par exemple l'onglet HDFS/HCatalog/Oozie, cliquez sur le bouton
[+] pour ouvrir la bote de dialogue [Select libraries].
6. Cliquez sur le bouton Browse... et parcourez votre systme jusqu'au fichier Jar que vous souhaitez importer.
7. Cliquez sur OK pour valider les modifications et fermer la bote de dialogue [Select libraries].
Le fichier Jar slectionn apparat dans la liste de l'onglet de l'lment Hadoop configur.
Notez que si vous souhaitez partager la configuration personnalise Hadoop avec un autre Studio Talend, vous
pouvez exporter cette connexion personnalise de la bote de dialogue [Custom Hadoop version definition]
8. Dans la bote de dialogue [Custom Hadoop version definition], cliquez sur OK afin de valider la
configuration personnalise et retourner la liste Distribution de la vue Basic settings du composant.
Une fois la configuration de la distribution Hadoop personnalise termine vous pouvez, depuis la vue Basic
settings, continuer de saisir d'autres paramtres requis pour la connexion.
Si la distribution Hadoop personnalise laquelle vous souhaitez vous connecter contient YARN, cochez la case
Use YARN ct de la liste Distribution.
Notez que les composants tHiveCreateTable et tHiveLoad ne sont disponibles que si vous utilisez une des
solutions Talend avec Big Data.
Les donnes d'exemple utiliser dans ce scnario sont des informations relatives aux employs d'une entreprise
et se prsentent comme suit :
1;Lyndon;Fillmore;21-05-2008;US
2;Ronald;McKinley;15-08-2008
3;Ulysses;Roosevelt;05-10-2008
4;Harry;Harrison;23-11-2007
5;Lyndon;Garfield;19-07-2007
6;James;Quincy;15-07-2008
7;Chester;Jackson;26-02-2008
8;Dwight;McKinley;16-07-2008
9;Jimmy;Johnson;23-12-2007
10;Herbert;Fillmore;03-04-2008
Les informations contiennent le nom de certains employs et la date de leur enregistrement dans le systme des
ressources humaines. Comme ces employs travaillent pour la filiale amricaine de l'entreprise, crez une partition
US pour ces donnes.
Avant de commencer reproduire ce scnario, assurez-vous d'avoir les droits d'accs appropris la base de
donnes Hive utiliser.
Notez que si vous utilisez le systme d'exploitation Windows, vous devez crer un dossier tmp la racine du
disque o le studio est install.
Pour plus d'informations concernant la cration de Jobs, consultez le chapitre relatif dans le Guide utilisateur
du Studio Talend.
Configurer le tHiveConnection
1. Double-cliquez sur le tHiveConnection pour ouvrir sa vue Component.
2. Dans la liste Property type, slectionnez Built-in. Si vous avez cr la connexion utiliser dans le
Repository, slectionnez Repository, cliquez sur le bouton pour ouvrir la bote de dialogue [Repository
content] et slectionnez cette connexion. Ainsi, le studio rutilise les paramtres de connexion dans le Job.
Pour plus d'informations concernant la cration d'une connexion Hadoop dans le Repository, consultez le
chapitre dcrivant le nud Hadoop cluster dans le Guide de prise en main de Talend Open Studio for Big
Data.
3. Dans la zone Version, slectionnez la distribution de Hadoop utiliser, ainsi que sa version. Si votre
distribution n'est pas dans la liste, slectionnez Custom pour vous connecter une distribution de Hadoop
non officiellement supporte dans le studio.
Pour comprendre comment utiliser l'option Custom tape par tape, consultez Connexion une distribution
Hadoop personnalise.
4. Dans la zone Connection, saisissez les paramtres de connexion la base de donnes Hive utiliser.
5. Dans le champ Name node, saisissez l'emplacement du nud matre, le NameNode, de la distribution
utiliser. Par exemple, saisissez talend-hdp-all:50300.
6. Dans le champ Job tracker, saisissez l'emplacement du JobTracker de votre distribution. Par exemple,
saisissez hdfs://talend-hdp-all:8020.
La notion de Job dans le terme de JobTracker dsigne les Jobs MR ou MapReduce dcrits dans la
documentation de Apache sur le site http://hadoop.apache.org/ (en anglais).
Dfinir le schma
2. Cochez la case Use an existing connection et, dans la liste Component list, slectionnez la connexion
configure dans le composant tHiveConnection utilis dans ce Job.
3.
Cliquez sur le bouton ct du champ Edit schema pour ouvrir l'diteur de schma.
4.
Cliquez quatre fois sur le bouton pour ajouter quatre lignes dans la colonne Column. Renommez-les
respectivement Id, FirstName, LastName et Reg_date.
Notez que vous ne pouvez pas utilisez les mots-cls rservs Hive pour nommer les colonnes, comme par
exemple location ou date.
5. Dans la colonne Type, slectionnez le type de donnes dans chaque colonne. Dans ce scnario, Id est de type
Integer, Reg_date est de type Date et les autres lignes sont de type String.
6. Dans la colonne DB type, slectionnez le type Hive de chaque colonne correspondant au type de donnes
dfini. Par exemple, Id est de type INT et Reg_date est de type TIMESTAMP.
7. Dans la colonne Data pattern, dfinissez le modle correspondant celui des donnes brutes. Dans cet
exemple, utilisez le modle par dfaut.
3. Dans la liste Format, slectionnez le format des donnes pour lequel la table Hive est cre. Dans ce scnario,
slectionnez TEXTFILE.
4. Cochez la case Set partitions pour ajouter la partition US comme expliqu au dbut de ce scnario. Pour
dfinir cette partition, cliquez sur le bouton ct du champ Edit schema.
5. Laissez la case Set file location dcoche pour utiliser le chemin par dfaut pour la table Hive.
6. Cochez la case Set Delimited row format pour afficher les options disponibles du format de ligne.
7. Cochez la case Field et saisissez un point-virgule (;) comme sparateur de champs dans le champ qui apparat.
8. Cochez la case Line et laissez la valeur par dfaut comme sparateur de lignes.
2. Cochez la case Use an existing connection et, dans la liste Component list, slectionnez la connexion
configure dans le composant tHiveConnection utilis dans ce Job.
3. Dans le champ Load action, slectionnez LOAD pour crire des donnes du fichier d'exemple prsent au
dbut du scnario.
4. Dans le champ File path, saisissez le chemin d'accs au rpertoire dans lequel sont stockes les donnes.
Dans cet exemple, les donnes sont stockes sur le systme HDFS utilis.
Notez que si vous devez lire des donnes depuis un systme de fichiers local autre que le systme HDFS,
vous devez vous assurer que les donnes lues sont stockes dans le systme de fichiers local de la machine
sur laquelle le Job est excut. Cochez ensuite la case Local dans la vue Basic settings. Par exemple, lorsque
le mode de connexion Hive est Standalone, le Job est excut sur la machine sur laquelle l'application Hive
est installe. Les donnes sont donc stockes sur cette machine.
5. Dans le champ Table name, saisissez le nom de la table cible dans laquelle charger les donnes. Dans ce
scnario, saisissez employees.
7. Cochez la case Set partitions et, dans le champ qui apparat, saisissez le nom de la partition dans laquelle
vous souhaitez ajouter des donnes. Dans ce scnario, cette partition est country='US'.
Excuter le Job
Vous pouvez appuyer sur la touche F6 pour excuter ce Job.
Cela fait, la vue Run s'ouvre automatiquement. Vous pouvez suivre le processus d'excution.
Vous pouvez galement vrifier les rsultats dans la console Web de votre distribution Hadoop.
Si vous souhaitez plus d'informations concernant le Job, il est recommand d'utiliser la console Web du JobTracker
fournie par votre distribution Hadoop.
tHiveRow
Proprits du tHiveRow
Famille de composant Big Data/Hive
Fonction tHiveRow est le composant spcifique ce type de base de donnes. Il excute des requtes Hive QL
dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux
dans le Job bien que ce composant ne produise pas de donnes en sortie.
Ce composant peut galement effectuer des requtes dans une case de donnes HBase, une fois la case
Store by HBase coche.
Objectif Selon la nature de la requte et de la base de donnes, tHiveRow agit sur la structure mme de la base
de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement
et aisment crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du
composant. Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
L'option Custom vous permet de vous connecter un cluster diffrente des clusters
de la liste, par exemple une distribution non supporte officiellement par Talend.
Pour vous connecter une distribution personnalise, une fois l'option Custom
slectionne, cliquez sur le bouton pour afficher une fentre, dans laquelle vous
pouvez :
1. Slectionner Import from existing version pour importer une distribution de base
officiellement supporte et ajouter manuellement les autres Jars requis non fournis
par cette distribution. Ou,
2. Slectionner Import from zip pour importer un fichier .zip contenant une distribution
personnalise que vous pouvez tlcharger depuis http://www.talendforge.org/
exchange/index.php.
Dans cette bote de dialogue, la case de la zone active doit tre coche,
afin d'importer les fichiers .jar correspondant la connexion cre entre la
distribution personnalise et ce composant.
Pour un exemple tape par tape expliquant comment se connecter une distribution
personnalise et partager cette connexion, consultez Connexion une distribution
Hadoop personnalise.
Hive version Slectionnez la version de la distribution Hadoop que vous utilisez. Les options
disponibles dpendent du composant que vous utilisez. En plus de l'volution de Hadoop,
veuillez noter les changements suivants :
mapreduce.application.framework.path=/hdp/apps/2.2.0.0-2041/
mapreduce/mapreduce.tar.gz#mr-framework
La liste Hive server est disponible uniquement lorsque la distribution Hadoop utiliser,
par exemple HortonWorks Data Platform V1.2.0 (Bimota) supporte HiveServer2.
Vous pouvez slectionner HiveServer2 (Hive 2), le serveur supportant mieux les
connexions simultanes de diffrents clients que HiveServer (Hive 1).
Les valeurs des paramtres suivants peuvent tre trouves dans le fichier hive-site.xml
du systme Hive utilis.
Cette case est disponible ou indisponible selon la distribution d'Hadoop laquelle vous
vous connectez.
Use SSL Cochez cette case pour activer la connexion crypte SSL.
encryption
Les champs qui s'affichent ensuite fournissent les informations d'authentification :
Dans le champ Trust store path, saisissez le chemin ou parcourez votre systme
jusqu'au fichier TrustStore utiliser. Par dfaut, les types TrustStore supports sont
JKS et PKCS 12.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets
doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Cette fonctionnalit n'est disponible que pour HiveServer2 en mode Standalone pour
les distributions suivantes :
Cloudera CDH4 +
Pivotal HD 2.0 +
Use a keytab to Cochez la case Use a keytab to authenticate pour vous connecter un systme Hadoop
authenticate utilisant Kerberos l'aide d'un fichier keytab. Un fichier keytab contient des paires de
principaux Kerberos et de cls cryptes. Vous devez saisir le principal utiliser dans le
champ Principal et le chemin d'accs au fichier keytab dans le champ Keytab.
Notez que l'utilisateur qui excute un Job utilisant un keytab n'est pas forcment celui
dsign par le principal mais qu'il doit avoir le droit de lecture pour le fichier keytab
utilis. Par exemple, le nom d'utilisateur que vous utilisez pour excuter le Job est user1
et le principal utiliser est guest. Dans cette situation, assurez-vous que user1 a les droits
de lecture pour le fichier keytab utiliser.
Hadoop properties Set Jobtracker Cochez cette case pour indiquer l'emplacement du service JobTracker utiliser, dans le
URI cluster Hadoop. Par exemple, si vous avez choisi une machine nomme machine1 comme
JobTracker, dfinissez son emplacement comme suit machine1:portnumber. Notez qu'un
JobTracker est le service qui assigne des tches Map/Reduce des nuds spcifiques
dans un cluster Hadoop. Le mot "Job" dans JobTracker ne dsigne pas un Job Talend
mais un job Hadoop, dcrit comme job MR ou MapReduce dans la documentation de
Apache Hadoop : http://hadoop.apache.org (en anglais).
Cette proprit est requise lorsque la requte que vous souhaitez utiliser est excute
dans Windows et est une requte Select. Par exemple, SELECT your_column_name
FROM your_table_name
Si vous utilisez YARN dans votre cluster Hadoop, comme Hortonworks Data Platform
V2.0.0 ou Cloudera CDH4.3 + (mode YARN), vous devez spcifier l'emplacement du
Resource Manager et non celui du Jobtracker. Vous pouvez continuer configurer les
paramtres suivants selon la configuration du cluster Hadoop utiliser (si vous ne cochez
pas la case d'un paramtre, alors la configuration de ce paramtre dans le cluster Hadoop
utiliser sera ignore lors du runtime) :
2. Allouez des volumes de mmoire corrects aux calculs Map et Reduce ainsi qu'
l'application ApplicationMaster de YARN en cochant la case Set memory dans la
vue Advanced settings.
5. Cochez la case Set Hadoop user et saisissez le nom de l'utilisateur avec lequel vous
souhaitez excuter le Job. Puisque les fichiers et rpertoires dans Hadoop ont un auteur
spcifique avec les droits appropris de lecture ou d'criture, ce champ vous permet
d'excuter le Job directement avec l'utilisateur ayant les droits d'accs appropris au
fichier ou rpertoire traiter.
Cette proprit est requise lorsque la requte que vous souhaitez utiliser est excute
dans Windows et est une requte Select. Par exemple, SELECT your_column_name
FROM your_table_name
Dans le champ Job result folder, saisissez l'emplacement o vous souhaitez stocker les
rsultats d'excution du Job dans Azure Storage.
HDInsight Saisissez les informations d'authentification information du cluster HD Insight utiliser.
configuration
Windows Azure Saisissez l'adresse et les informations d'authentification du compte Azure Storage
Storage utiliser.
configuration
Dans le champ Container, saisissez le nom du conteneur utiliser.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Notez que, lorsque le format de fichier utiliser est PARQUET, il est possible qu'il vous
soit demand de trouver le fichier Jar Parquet spcifique et l'installer dans le studio.
Lorsque le mode de connexion Hive est Embedded, le Job est excut sur votre
machine locale et appelle ce Jar install dans le studio.
Lorsque le mode de connexion Hive est Standalone, le Job est excut sur le serveur
hbergeant Hive et ce fichier Jar est envoy au systme HDFS du cluster auquel vous
vous connectez. Assurez-vous d'avoir correctement dfini l'URI du NameNode dans
le champ correspondant de la vue Basic settings.
Ce fichier Jar est tlchargeable depuis le site Web d'Apache. Pour plus d'informations
concernant l'installation d'un fichier externe, consultez https://help.talend.com/display/
KB/How+to+install+external+modules+in+the+Talend+products (en anglais).
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin
qu'ils correspondent la dfinition du schma.
Les donnes compresses en Gzip ou Bzip2 peuvent tre traites via les
instructions de requte. Pour plus d'informations, consultez la page https://
cwiki.apache.org/confluence/display/Hive/CompressedStorage (en anglais).
Define the jars Cochez cette case pour afficher la table Register jar for HBase, dans laquelle vous
to register for pouvez enregistrer tout fichier Jar manquant, requis pour HBase, par exemple, Hive
HBase Storage Handler, enregistr par dfaut avec votre installation Hive.
Register jar for
HBase Cliquez sur le bouton pour ajouter des lignes la table, puis, dans la colonne Jar
name, slectionnez le(s) fichier(s) Jar enregistrer. Dans la colonne Jar path, saisissez
le chemin d'accs ce(s) Jar(s).
Advanced settings Temporary path Si vous ne souhaitez pas configurer le Jobtracker et le NameNode lorsque vous excutez
la requte select * from your_table_name, vous devez paramtrer un chemin
d'accs temporaire. Par exemple, /C:/select_all sous Windows.
Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en
QUERY's cours. Slectionnez cette colonne dans la liste use column.
recordset
Cette option permet au composant d'avoir un schma diffrent de celui
du composant prcdent. De plus, la colonne contenant le rsultat de la
requte doit tre de type Object. Ce composant est gnralement suivi du
tParseRecordSet.
Hadoop Le Studio Talend utilise une configuration par dfaut pour son moteur, afin d'effectuer
properties des oprations dans une distribution Hadoop. Si vous devez utiliser une configuration
personnalise dans une situation spcifique, renseignez dans cette table la ou les
proprit(s) personnaliser. Lors de l'excution, la ou les proprit(s) personnalise(s)
va (vont) craser celle(s) par dfaut.
Notez que, si vous utilisez les mtadonnes stockes centralement dans le Repository,
cette table hrite automatiquement des proprits dfinies dans ces mtadonnes et
passe en lecture seule jusqu' ce que, dans la liste Property type, vous passiez de
Repository Built-in.
Pour plus d'informations concernant les proprits requises par Hadoop et ses systmes
associs, tels que HDFS et Hive, consultez la documentation Apache Hadoop sur le site
http://hadoop.apache.org (en anglais) ou la documentation de la distribution Hadoop que
vous utilisez. A titre d'exemple, les liens vers certaines proprits sont lists ci-aprs:
Apache fournit galement une page listant toutes les proprits relatives
Hive : http://hadoop.apache.org/docs/r2.6.0/hadoop-project-dist/hadoop-hdfs/hdfs-
default.xml (en anglais).
Hive properties Le Studio Talend utilise la configuration par dfaut pour son moteur afin
d'effectuer des opration dans un base de donnes Hive. Si vous devez utiliser
une configuration personnalise dans une situation spcifique, renseignez cette table
avec la (les) proprit(s) personnaliser. Ensuite, l'excution, la (les) proprit(s)
personnalise(s) crasent celles par dfaut. Pour plus d'informations concernant les
proprits ddies Hive, consultez https://cwiki.apache.org/confluence/display/Hive/
AdminManual+Configuration (en anglais).
Notez que, si vous utilisez les mtadonnes stockes centralement dans le Repository,
cette table hrite automatiquement des proprits dfinies dans ces mtadonnes et
passe en lecture seule jusqu' ce que, dans la liste Property type, vous passiez de
Repository Built-in.
Mapred job Si le systme Hadoop utilis est Hortonworks Data Platform V1.2 ou Hortonworks Data
map memory mb Platform V1.3, vous devez dfinir des allocations de mmoire suffisantes pour que les
et Mapred job oprations de map et reduce soient effectues par le systme Hadoop.
reduce memory
mb Dans ce cas, vous devez saisir les valeurs que vous souhaitez utiliser pour la mmoire
alloue aux oprations map et reduce dans les champs Mapred job map memory mb
et Mapred job reduce memory mb, respectivement. Par dfaut, les valeurs sont toutes
les deux 1000, ce qui est normalement adapt pour l'excution de ces oprations.
Path separator Laissez le champ Path separator in server tel quel, sauf si vous changez le sparateur
in server utilis par la machine hte de votre distribution Hadoop pour sa variable PATH. En
d'autres termes, changez le sparateur si celui-ci n'est pas le signe deux points (:). Dans
ce cas, vous devez remplacer cette valeur par celle utilise dans votre hte.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues
dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes
ayant la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits
de requtes Hive QL.
Si le Studio Talend utilis pour vous connecter une base de donnes Hive fonctionne sous Windows,
vous devez crer manuellement un dossier appel tmp la racine du disque o le Studio Talend est install.
Prrequis La distribution Hadoop doit tre correctement installe afin de garantir les interactions avec le Studio
Talend. La liste suivante prsente des informations d'exemple relatives MapR.
Assurez-vous d'avoir install le client MapR sur la mme machine que le Studio Talend et d'avoir ajout
la bibliothque client de MapR dans la variable PATH de cette machine. D'aprs la documentation
de MapR, la ou les librairies du client MapR correspondant chaque OS peuvent tre trouves
MAPR_INSTALL\ hadoop\hadoop-VERSION\lib\native. Par exemple, pour Windows, la bibliothque
est lib\MapRClient.dll dans le fichier Jar du client MapR. Pour plus d'informations, consultez la
page suivante sur le site de MapR : http://www.mapr.com/blog/basic-notes-on-configuring-eclipse-as-
a-hadoop-development-environment-for-mapr (en anglais).
Si vous n'ajoutez pas de librairie, il est possible que vous rencontriez l'erreur suivante : no MapRClient
in java.library.path.
Configurez l'argument -Djava.library.path, par exemple, dans la zone Job Run VM arguments
de la vue Run/Debug de la bote de dialogue [Preferences]. Cet argument fournit au studio le chemin
d'accs la bibliothque native du client MapR. Cela permet aux utilisateurs en souscription d'utiliser
entirement l'aperu des donnes (Data viewer) afin de visualiser localement dans le studio les donnes
stockes dans MapR. Pour plus d'informations concernant la configuration de cet argument, consultez
la section expliquant comment visualiser les donnes dans le Guide de prise en main de Talend Open
Studio for Big Data.
Pour plus d'informations concernant l'installation d'une distribution Hadoop, consultez le manuel
correspondant la distribution Hadoop que vous utilisez.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour un scnario associ, consultez :
Lors de la configuration du composant devant se connecter une distribution Hadoop, gardez l'esprit que des
paramtres sont requis par Hadoop, tels que le NameNode et le Jobtracker.
La famille Business regroupe les connecteurs couvrant des besoins spcifiques, tels que la lecture et l'criture de
base de donnes de type CRM ou ERP et la lecture et l'criture de systme SAP.
tAlfrescoOutput
Proprits du tAlfrescoOutput
Famille du composant Business
Fonction Le composant tAlfrescoOutput permet de crer des documents dmatrialiss sur un serveur
Alfresco o ils sont indexs selon des modles significatifs.
Objectif Ce composant permet de crer et de grer des documents sur un serveur Alfresco.
Basic settings URL Saisissez l'URL pour vous connecter l'application Web
Alfresco.
Login et Password Entrez les donnes d'identification de l'utilisateur au serveur
Alfresco.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et
retourne un entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de sortie et requiert un composant
de dbut.
Limitation/prrequis Pour pouvoir utiliser le composant tAlfrescoOutput, certaines ressources doivent tre
installes. Pour plus d'informations, consultez la sous-section Procdure d'installation ci-
dessous.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer
le studio, dans le Guide d'installation et de migration Talend.
Procdure d'installation
Pour pouvoir utiliser le composant tAlfrescoOutput dans la perspective Integration du Studio Talend, vous devez
tout d'abord installer le serveur Alfresco ainsi que quelques ressources utiles.
Les sous-sections ci-aprs indiquent en dtail les conditions pralables ncessaires, ainsi que la procdure
d'installation.
Conditions pralables
Assurez-vous que le serveur Alfresco est bien lanc avant d'utiliser le composant tAlfrescoOutput.
Notez que le fichier talendalfresco_20081014.zip est propos avec le composant tAlfrescoOutput dans la
perspective Integration du Studio Talend.
2. Ajoutez le filtre d'identification des commandes au fichier web.xml situ au chemin d'accs C:\alfresco
\tomcat\webapps\alfresco\WEB-INF son WEB-INF/, d'aprs le modle de l'exemple situ dans le dossier
talendalfresco_20081014/alfresco du fichier zipp talendalfresco_20081014.zip
Les capture d'cran ci-dessous montrent la partie ajouter (lignes en bleu) au fichier web.xml alfresco.
Dates :
Les colonnes qui ne comportent ni mapping, ni valeur par dfaut (celles du type Date par exemple) se voient
attribuer une chane de caractres vide.
Solution : effacez toutes les colonnes sans mapping ni valeur par dfaut. Notez cependant qu'une modification
de type Alfresco les rtablira.
Contenu :
Ne confondez pas le chemin d'accs au fichier dont vous voulez crer le contenu et celui de son emplacement
cible sur Alfresco.
N'oubliez pas l'URL. Elle permet de cibler de nombreux protocoles, dont le transfert de fichiers et le HTTP.
Prcdez les URLs renvoyant des fichiers du systme de fichiers en rseau de "file:", si vous utilisez Windows
en local, ou de "file://", si vous utilisez soit Windows sur un rseau (qui accepte galement la mention "file:
\ \"), soit Linux.
N'utilisez jamais la double barre oblique inverse (\\) dans le chemin d'accs cible (chappement automatique),
moins que vous n'entriez le chemin directement dans les proprits de base (Basic settings) du composant
tAlfrescoOutput ou que vous n'effectuiez une concatnation, dans l'diteur tMap par exemple.
Il est possible de n'en crer qu'une seule par document en y mappant une valeur String, ou une ou plusieurs en
y mappant une valeur List(objet).
Il est possible de vider une proprit multiple en lui mappant une liste vide que vous pouvez crer, par exemple,
en utilisant la commande new java.util.ArrayList()dans le composant tMap.
dfinissez dans un fichier une table de relation n-n, contenant par exemple une ligne name (pouvant tre retrouve
dans les input rows) et une ligne category (pouvant tre dfinie avec son mapping dans un fichier tiers).
opration : output categoryList, fonction list(object), input category. ATTENTION il s'agit d'une list
(object) et non d'une simple list !
Les rfrences sont cres par mapping d'une ou plusieurs rfrences de nud existantes (xpath ou namepath),
en type String ou List(object).
Une erreur dans l'association ou la proprit de type rfrence n'empche pas la cration du nud qui la porte.
Les proprits de type rfrence sont cres dans l'onglet des proprits standards (Basic settings).
Les associations sont cres dans l'onglet des proprits avances (Advanced settings).
Un systme de Gestion de Contenu permet de grer un large ventail de documents, allant des plus basiques aux
certificats d'actions par exemple.
Les entreprises procdent la dmatrialisation de leur contenu par traitement des documents, qui peut tre ralis
soit la main, soit de manire automatique grce une machine
Compte tenu de la diversit des contenus dmatrialiser, les entreprises sont obliges d'utiliser des technologies
diverses. Scanner les documents papier, crer des interfaces pour capter les documents lectroniques d'autres
applications, convertir les documents images en documents textes lisibles et modifiables par une machine... Ceci
n'est qu'un exemple des technologies employes.
De plus, les documents scanns ainsi que les fax numriques ne peuvent tre lus par des machines. Diffrentes
technologies de reconnaissance des caractres sont utilises pour les convertir en donnes utilisables. La
Reconnaissance de Caractres Manuscrits (RCM) et la Reconnaissance Optique de Marques (ROM) en sont deux
exemples.
Les mtadonnes de support, qui permettent d'identifier le contenu de manire efficace grce des requtes
spcifiques, sont au moins aussi importantes que le contenu capt lors de la dmatrialisation, en diffrents formats
et partir de nombreuses sources.
Ds lors, comment agrger et indexer dans un systme de Gestion de Contenu le contenu d'un document en mme
temps que ses mtadonnes associes, pour qu'il puisse tre extrait et trait de manire significative ? Talend vous
apporte la rponse par le biais de son composant tAlfrescoOutput.
Le composant tAlfrescoOutput vous permet de stocker et de grer vos documents lectroniques, ainsi que les
mtadonnes qui y sont associes, sur le serveur Alfresco, systme leader sur le march de la Gestion de Contenu.
La figure ci-dessous illustre le rle de Talend la fois dans le processus de dmatrialisation et dans le systme
Gestion de Contenu (Alfresco).
Configurer le schma
1. Dans l'diteur graphique, double-cliquez sur le tFileInputDelimited pour en afficher les paramtres de base
(Basic settings).
2. Renseignez le chemin d'accs au fichier dans le champ File Name ainsi que toutes les autres proprits. Notez
cependant que si vous avez dj stock vos schmas d'entre en local dans le Repository, vous pouvez tout
simplement rcuprer le fichier choisi partir du nud Metadata et le dposer sur l'diteur graphique. Les
paramtres du fichier dlimit s'afficheront alors automatiquement dans les champs concerns de l'onglet
Basic settings du composant concern.
Pour plus d'informations concernant les mtadonnes, consultez le Guide utilisateur du Studio Talend.
Dans ce scnario, le fichier dlimit prsente les mtadonnes et le chemin d'accs de deux documents que
vous allez crer sur le serveur Alfresco. Le schma d'entre des documents de dcompose en quatre colonnes :
file_name, destination_folder name, source_path, et author.
2. Dans la partie Alfresco Server, saisissez l'URL du serveur Alfresco ainsi que les donnes d'identification de
l'utilisateur dans les champs correspondants.
3. Dans la partie TargetLocation, vous pouvez soit saisir le nom de l'emplacement du serveur o vous voulez
stocker le document, soit cocher la case Map... puis choisir l'emplacement cible partir de la liste droulante
Column, soit destination_folder_name dans ce scnario.
Lorsque vous renseignez le nom de l'emplacement, assurez vous de bien utiliser le caractre d'chappement double
barre oblique inverse (\\).
4. Dans la liste droulante Document Mode, slectionnez le mode que vous voulez utiliser pour la cration
de vos documents.
5. Dans la liste droulante Container Mode, slectionnez le mode que vous voulez utiliser pour le dossier de
destination sur Alfresco.
Dfinir le document
1. Cliquez sur le bouton [...] de l'option Define Document Type pour ouvrir l'diteur tAlfrescoOutput.
2. Cliquez sur le bouton Add pour parcourir et slectionner le fichier xml qui comprend les mtadonnes selon
lesquelles vous voulez sauvegarder les documents sur Alfresco. Tous les aspects disponibles du modle
slectionn s'affichent dans la liste Available Aspects.
Vous pouvez parcourir le dossier modle en local ou en rseau. Une fois dfinis les aspects appliquer au document
que vous allez crer sur Alfresco, vous n'aurez plus besoin de ce dossier.
3. Si ncessaire, slectionnez le ou les aspect(s) ajouter aux mtadonnes crire sur le serveur Alfresco,
partir de la liste droulante Available Aspects. Dans ce scnario, l'objectif est de faire en sorte que le nom
de l'auteur fasse partie des mtadonnes enregistres sur Alfresco
4. Cliquez sur la liste droulante, situe en haut de la fentre de l'diteur, pour slectionner le type donner aux
documents crs sur Alfresco. Dans cet exemple, il s'agit de Content.
Tous les aspects dfinis, utiliss pour slectionner les mtadonnes crire sur Alfresco, s'affichent dans
la liste Property Mapping de l'onglet Basic settings du composant tAlfrescoOutput. Dans ce scnario,
il s'agit de trois aspects, deux aspects de base pour le type Content (content et name) ainsi qu'un aspect
additionnel (author).
2. Si ncessaire, cliquez sur Edit schema pour avoir un aperu de la structure des donnes du tAlfrescoOutput
en sortie.
3. Cliquez sur le bouton [...] situ ct du champ Result Log File Name puis parcourez le fichier o vous
voulez sauvegarder les logs aprs excution du Job.
Les deux documents sont crs sur Alfresco grce aux mtadonnes des schmas d'entre.
tBonitaDeploy
Proprits du tBonitaDeploy
Famille de composant Business/Bonita
Fonction Le tBonitaDeploy configure un moteur Bonita Runtime et dploie un processus spcifique
Bonita (un fichier .bar export de la solution Bonita solution) vers ce moteur.
Objectif Ce composant dploie un processus spcifique Bonita vers Bonita Runtime.
Basic settings Bonita version Slectionnez un numro de version pour le moteur Bonita
Runtime.
Bonita Runtime Configuration Bonita Runtime Parcourez votre rpertoire, ou saisissez le chemin d'accs au
Environment File fichier d'environnement Bonita Runtime.
Pour plus d'informations concernant les connexions, consultez la section relatives aux types de
connexions, dans le Guide utilisateur du Studio Talend.
Global Variables ProcessDefinitionUUID : identifiant du processus dploy. Cette variable est une variable
Flow et retourne une chane de caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en standalone.
Ce composant fonctionne en troite relation avec les lments BPM. Vous devez souscrire
l'une des solutions Talend avec BPM pour utiliser ce composant efficacement. Sinon,
tlchargez manuellement la solution Bonita utiliser.
Limitation Le fichier d'environnement Bonita Runtime, le fichier jaas Bonita Runtime et le fichier de log
Bonita Runtime doivent tre stocks sur le serveur d'excution du Job, l'aide de ce composant.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tBonitaInstantiateProcess
Proprits du tBonitaInstantiateProcess
Famille de composant Business/Bonita
Fonction Le composant tBonitaInstantiateProcess instancie un processus existant dans un moteur
Bonita Runtime puis lance l'excution.
Objectif Ce composant commence l'instance d'un processus spcifique dploy dans le moteur Bonita
Runtime.
Basic settings Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre
de champs qui sont traits et passs au composant suivant. Le
schma est soit local (Built-in), soit distant dans le Repository.
Row : Main.
Pour plus d'informations propos des connexions, consultez la section concernant les types de
connexions dans le Guide utilisateur du Studio Talend.
Global Variables ProcessInstanceUUID : identifiant de l'instance du processus cr. Cette variable est une
variable Flow et retourne une chane de caractres. L'identifiant peut galement tre rcupr
l'aide d'un lien de sortie Row > Main.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en standalone ou en tant que composant de sortie.
Ce composant fonctionne en troite relation avec les lments BPM. Vous devez souscrire
l'une des solutions Talend avec BPM pour utiliser ce composant efficacement. Sinon,
tlchargez manuellement la solution Bonita utiliser.
Limitation Le fichier d'environnement Bonita Runtime, le fichier jaas Bonita Runtime et le fichier de log
Bonita Runtime doivent tre stocks sur le serveur d'excution du Job utilisant ce composant.
Avant de commencer reproduire ce schma, prparez votre fichier Bonita .bar. Si vous n'avez pas souscrit
l'une des solutions Talend avec BPM, vous devez exporter manuellement ce fichier depuis le systme Bonita, puis
le dployer dans le moteur Bonita Runtime, l'aide, par exemple du composant tBonitaDeploy, prsent dans
ce scnario. Dans ce scnario, ce fichier est TEST--4.0.bar. Une fois dploy, ce processus peut tre vrifi via
l'interface Bonita.
Configurer le Job
1. Dposez les composants tBonitaDeploy, tFixedFlowInput et tBonitaInstantiateProcess de la Palette dans
l'espace de modlisation graphique.
4. Cliquez-droit sur le tFixedFlowInput pour ouvrir son menu contextuel et slectionnez Row > Main pour
relier ce composant au tBonitaInstantiateProcess, l'aide d'un lien Main.
2. Slectionnez la version 5.3.1 de Bonita dans la liste Bonita version. La version slectionne doit tre la mme
que celle du moteur Bonita Runtime que vous utilisez.
3. Dans la zone Bonita Runtime Configuration, parcourez votre rpertoire de fichiers de variables
Bonita Runtime. Dans le champ Bonita Runtime Environment file, parcourez votre rpertoire jusqu'au
fichier bonita-environnement.xml. Dans le champ Bonita Runtime Jaas File, parcourez votre rpertoire
jusqu'au fichier jaas-standard.cfg. Dans le champ Bonita Runtime Logging File, parcourez votre rpertoire
jusqu'au fichier logging.properties.
Pour les utilisateurs de la version 5.2.3 de Bonita, seuls les champs Bonita Runtime Jaas File et Bonita Runtime
Logging File sont renseigner.
Pour les utilisateurs de la version 5.6.1 de Bonita, parcourez votre systme afin de renseigner le champ Bonita Runtime
Home avec le rpertoire d'environnement de Bonita Runtime.
4. Dans le champ Business Archive, parcourez votre rpertoire jusqu'au fichier Bonita .bar, qui est le processus
export de votre systme Bonita et sera dploy dans le moteur Bonita Runtime.
5. Dans les champs Username et Password, saisissez vos informations de connexion Bonita.
2. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir l'diteur du schma.
3. Cliquez sur le bouton [+] pour ajouter une ligne. Nommez-la Name.
Le nom est identique celui du paramtre configur dans Bonita, afin d'excuter le mme processus. Ainsi,
Bonita reconnat la colonne comme un paramtre valide et lit sa valeur pour instancier le processus.
5. Dans la zone Mode de la vue Basic settings, slectionnez l'option Use inline table puis cliquez sur le bouton
[+] afin d'ajouter une ligne.
6. Dans le tableau, cliquez sur la ligne ajoute et saisissez entre guillemets le nom de la personne de votre
personnel : ychen, dont la requte sera traite par le processus dploy.
2. Slectionnez la version 5.3.1 de Bonita dans la liste Bonita version. La version slectionne doit tre la mme
que celle du moteur Bonita Runtime que vous utilisez.
3. Dans la zone Bonita Runtime Configuration, parcourez votre rpertoire de fichiers de variables
Bonita Runtime. Dans le champ Bonita Runtime Environment file, parcourez votre rpertoire jusqu'au
fichier bonita-environnement.xml. Dans le champ Bonita Runtime Jaas File, parcourez votre rpertoire
jusqu'au fichier jaas-standard.cfg. Dans le champ Bonita Runtime Logging File, parcourez votre rpertoire
jusqu'au fichier logging.properties.
Pour les utilisateurs de la version 5.2.3 de Bonita, seuls les champs Bonita Runtime Jaas File et Bonita Runtime
Logging File sont renseigner.
Pour les utilisateurs de la version 5.6.1 de Bonita, parcourez votre systme afin de renseigner le champ Bonita Runtime
Home avec le rpertoire d'environnement de Bonita Runtime.
4. Cochez la case Use Process ID pour activer le champ Process Definition Id.
5. Dans le champ Process Definition Id, cliquez entre les guillemets et appuyez sur Ctrl+Espace afin d'ouvrir
la liste d'autocompltion contenant les variables globales disponibles pour ce Job.
6. Double-cliquez sur la variable que vous souhaitez utiliser pour l'ajouter entre les guillemets. Dans ce scnario,
double-cliquez sur tBonitaDeploy_1_ProcessDefinitionUUID, qui rcupre l'ID de dfinition du processus
dploy par le composant tBonitaDeploy.
Vous pouvez galement dcocher la case Use Process ID afin d'activer les champs Process name et Process version
et renseigner les informations correspondantes. Le tBonitaInstantiateProcess concatne le nom et la version du
processus que vous avez saisis lors de la construction de l'ID du processus.
7. Dans les champs Username et Password, saisissez respectivement votre identifiant et votre mot de passe
de connexion Bonita.
Excuter le Job
Appuyez sur F6 pour excuter le Job.
Le processus est dploy dans le moteur Bonita Runtime et une instance est cre pour les requtes concernant
le personnel.
2. Dans le champ Bonita Runtime Jaas File, spcifiez le chemin d'accs et le nom du fichier jaas.
Dans le champ Bonita Runtime Logging File, spcifiez le chemin d'accs et le nom du fichier de log.
Dans le champ Business Archive, spcifiez le chemin d'accs et le nom du processus Bonita.
5. Dans le champ Bonita Runtime Jaas File, spcifiez le chemin d'accs et le nom du fichier jaas.
Dans le champ Bonita Runtime Logging File, spcifiez le chemin d'accs et le nom du fichier de log.
6. Dans les champs Process Name et Process Version, saisissez les informations de processus.
9. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour obtenir un meilleur affichage.
Excuter le Job
1. Appuyez sur les touches Ctrl+S afin de sauvegarder votre Job.
Comme affich ci-dessus, l'instance est cre et l'UUID est crit en sortie.
tCentricCRMInput
Proprits du tCentricCRMInput
Famille du composant Business/CentricCRM
Fonction Le composant tCentricCRMInput se connecte un module de la base de donnes
CentricCRM via le service Web adquat.
Objectif Le tCentricCRMInput permet d'extraire les donnes d'une base de donnes Centric CRM
l'aide d'une requte.
Basic settings CentricCRM URL Saisissez l'URL du service Web permettant de se connecter la
base de donnes CentricCRM.
Module Slectionnez le module adquat dans la liste.
Server Saisissez l'adresse IP du serveur de base de donnes.
UserID et Password Saisissez les informations d'authentification de l'utilisateur au
service Web.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie
est ncessaire.
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur
l'installation de ces fichiers .jar manquants, consultez la section dcrivant comment configurer
le Studio Talend, dans le Guide d'installation et de migration Talend.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tCentricCRMOutput
Proprits du tCentricCRMOutput
Famille du composant Business/CentricCRM
Fonction Le composant tCentricCRMOutput crit dans un module de la base de donnes CentricCRM
via le service Web adquat.
Objectif Le tCentricCRMOutput permet d'crire des donnes dans une base de donnes CentricCRM.
Basic settings CentricCRM URL Saisissez l'URL du service Web permettant de se connecter la
base de donnes CentricCRM.
Module Slectionnez le module adquat dans la liste.
Server Saisissez l'adresse IP du serveur de base de donnes.
UserID et Password Saisissez les informations d'authentification de l'utilisateur au
service Web.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis comme composant de sortie. Il ncessite un composant d'entre.
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur
l'installation de ces fichiers .jar manquants, consultez la section dcrivant comment configurer
le Studio Talend, dans le Guide d'installation et de migration Talend.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tHL7Input
Proprits du tHL7Input
Famille de composant Business > Healthcare /
Unstructured > HL7
Fonction Lit un fichier de structure HL7 et extrait des donnes ligne par ligne.
Objectif Ce composant lit un fichier HL7 structur ou un flux de donnes ligne par ligne pour le scinder
en champs et envoie les champs tels que dfinis dans le schma au composant suivant du Job
via une connexion Row.
Basic settings Property Type Peut tre Built-In ou Repository.
Built-In : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier o sont stockes les
proprits du composant. Les champs suivants sont alors pr-
remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant connexion de base
de donnes et enregistrer les paramtres de connexion que vous
avez dfinis dans la vue Basic settings du composant.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Gnralement utilis en tant que composant d'entre. Un composant de sortie est requis.
Configurer l'diteur
1. A partir de la Palette, glissez-dposez un composant tHL7Input, et trois tLogRow dans lespace de
modlisation graphique.
3. Dans le champ File path, cliquez sur [Browse...], parcourez votre rpertoire, et slectionnez votre fichier
HL7.
4. Dans la zone File Setting, saisissez le caractre de dbut de votre segment (Start character), et le caractre
de fin de votre segment (End character).
5. Dans la zone Schema View, dans la liste Segment(As Schema), slectionnez MSH.
7. Dans la zone Schema View, dans la liste Segment(As Schema), slectionnez EVN.
8. Glissez-dposez les segments EVN-1(1)-1-1[ID] et EVN-2(1)-1-1[ST] de la zone Message View dans la zone
Schema View et modifiez la valeur de la colonne User Column EVN_ID et EVN_DATE, respectivement.
9. Dans la zone Schema View, dans la liste Segment(As Schema), slectionnez PID.
10. Glissez-dposez les segments suivants de la zone Message View dans la zone Schema
View : PID-1(1)-1-1[SI], PID-5(1)-1-1[ST], PID-5(1)-2-1[ST], PID-5(1)-3-1[ST], PID-5(1)-4-1[ST],
PID-5(1)-5-1[ST], PID-7(1)-1-1[ST], PID-8(1)-1-1[IS], puis modifiez la valeur de la colonne User
Column PID_ID, PID_FNAME, PID_LNAME, PID_STNUMBER, PID_STREET, PID_CITY, PID_BDAY,
PID_GENDER, respectivement.
Sil est disponible, utilisez le bouton Auto map! situ en bas gauche de la fentre, il permet deffectuer lopration
de mapping automatiquement.
2. Slectionnez l'option Table (print values in cells of a table) afin d'afficher les rsultats d'excution dans
un tableau.
Excution du Job
1. Reliez le tHL7Input aux trois tLogRow, en utilisant respectivement les liens MSH, EVN et PID.
La console affiche les trois tables des tLogRow, qui retournent diffrents types dinformations. La premire montre
len-tte du message et sa date. La seconde retourne les informations concernant le patient. La troisime affiche
lID de lvnement ainsi que sa date.
tHL7Output
Proprits du tHL7Output
Famille de composant Business > Healthcare /
Unstructured > HL7
Fonction Ecrit un fichier de structure HL7 et insre des donnes ligne par ligne.
Objectif Ce composant crit un fichier HL7 structur selon la norme HL7.
Basic settings Property Type Peut tre Built-In ou Repository.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier o sont stockes les
proprits du composant. Les champs suivants sont alors pr-
remplis l'aide des donnes collectes.
Schema(s) Schema : Dfinissez le nud o stocker les donnes de la ligne
parente.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Gnralement utilis en tant que composant de sortie. Un composant d'entre est requis.
Limitation Le nom de chaque lien d'entre doit tre le mme que le nom du segment HL7 correspondant.
Construire le Job
1. Dposez deux composants tFixedFlowInput et un composant tHL7Output dans l'espace de modlisation
graphique.
3. Reliez le MSH et le MSA au tHL7Output l'aide d'un lien Row > Main.
Dans le champ File Name/Output Stream, spcifiez le rpertoire de sortie de l'accus de rception HL7.
Dans la liste droulante HL7 Version, slectionnez votre version de HL7, 2.3 dans cet exemple.
2. Cliquez sur le bouton Configure HL7 Tree pour ouvrir l'diteur de l'arborescence HL7.
Cliquez-droit sur le nud rootTag dans le panneau Linker Target et slectionnez import HL7 Structure
dans le menu contextuel.
3. Dans la fentre [Open], slectionnez le fichier contenant l'accus de rception (ACK) HL7 suivant.
MSH|^~\&|CATH|StJohn|AcmeHIS|StJohn|20130808||ACK|MSGID8|P|2.3
MSA|AA|MSGID8
Pour plus d'informations concernant les messages ACK HL7, consultez http://www.hl7standards.com/
blog/2007/02/01/ack-message-original-mode-acknowledgement/ (en anglais).
Cliquez sur Ok pour fermer l'diteur d'arborescence HL7. Deux lignes, row_MSH_1 et row_MSA_1 sont
ajoutes la table Schema(s) dans la vue Basic settings du tHL7Output.
4. Dans la table Schema(s), cliquez dans la colonne Parent row pour la ligne row_MSH_1 et slectionnez
MSH dans la liste droulante.
Rptez l'opration afin de slectionner MSA dans la liste droulante de la colonne Parent row pour la ligne
row_MSA_1.
5. Dans la table Schema(s), slectionnez la cellule row_MSH_1 et cliquez sur le bouton [...] de la cellule afin
d'ouvrir l'diteur de schma.
Cliquez sur le bouton puis sur OK dans la bote de dialogue afin de copier les colonnes du segment
MSH du schma de sortie dans le schma d'entre.
Rptez l'opration pour la cellule row_MSA_1 et copiez les colonnes du segment MSA du schma de sortie
au schma d'entre.
Ainsi, vous n'avez pas besoin de dfinir manuellement les colonnes du schma d'entre, colonne par colonne.
Slectionnez l'option Use Single Table dans la zone Mode et renseignez la colonne Value pour chaque ligne:
MSH_1_1__1_1_ST_: "|"
MSH_9_1__1_1_ID_: "ACK"
MSH_10_1__1_1_ST_: "MSGID66"
MSH_11_1__1_1_ST_: "P"
MSH_12_1__1_1_ID_: "2.3"
Les colonnes ci-dessus doivent avoir des valeurs spcifiques pour le segment MSH.
Pour plus d'informations, consultez http://www.hl7.org/documentcenter/public_temp_194525B1-1C23-
BA17-0C3D37E51D9F8BA0/wg/conf/HL7MSH.htm (en anglais). Renseignez les valeurs pour les autres
colonnes avec des guillemets doubles "".
Slectionnez l'option Use Single Table dans la zone Mode et renseignez la colonne Value pour chaque ligne :
MSA_1_1__1_1_ID_: "AA"
MSA_2_1__1_1_ST_: "MSGID66"
Les colonnes ci-dessus doivent avoir des valeurs spcifiques pour le segment MSA. Pour
plus d'informations, consultez http://www.hl7standards.com/blog/2007/02/01/ack-message-original-mode-
acknowledgement/ (en anglais).
Excuter le Job
1. Appuyez sur Ctrl + S afin de sauvegarder le Job.
Comme montr prcdemment, le message gnr ne contient que les informations obligatoires et est
totalement conforme aux standards HL7.
Scnario associ
Pour un scnario utilisant un autre composant HL7, consultez Scnario : Retrouver des informations concernant
les patients et les vnements partir dun fichier HL7.
tMarketoInput
Proprits du tMarketoInput
Famille de composant Business/Cloud
Fonction Le composant tMarketoIntput rcupre des donnes partir d'un serveur Web Marketo.
Objectif Ce composant vous permet de rcuprer des donnes partir d'une base de donnes Marketo
sur un serveur Web.
Basic settings Endpoint address URL du service Web Marketo appel par l'API ou les API SOAP.
Secret key Saisissez le code d'authentification crypt fourni par Marketo.
Les dates Oldest create date et Latest create date peuvent tre
spcifis ensemble ou sparment.
Batch Size Limite maximale du nombre des donnes de prospects rcuprer
par lot.
Advanced settings Max number of Spcifiez le nombre maximum de fois que vous souhaitez
reconnection attempts vous reconnecter au serveur Web Marketo en cas de perte de
connexion.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables NB_CALL : nombre d'appels. Cette variable est une variable After et retourne un nombre
entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de d'entre. Un composant de
sortie est ncessaire.
Scnario associ
Pour un scnario associ, consultez Scnario : Insrer et rcuprer des donnes d'une base de donnes Marketo
via un systme externe.
tMarketoListOperation
Proprits du tMarketoListOperation
Famille de composant Business/Cloud
Fonction Le composant tMarketoListOperation ajoute/supprime un ou plusieurs prospect(s) dans une
liste de la base de donnes Marketo. Il vrifie galement si un ou plusieurs prospect(s) existe(nt)
dans cette liste.
Objectif Ce composant vous permet d'ajouter ou de supprimer un ou plusieurs prospect(s) dans une liste
de la base de donnes Marketo. Vous pouvez galement vrifier l'existence d'un ou plusieurs
prospect(s) dans la liste.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre
de champs qui sont traits et passs au composant suivant. Le
schma est soit local (Built-in), soit distant dans le Repository.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que composant intermdiaire. Un composant
d'entre et un composant de sortie sont ncessaires.
Construire le Job
1. Dposez les composants tMarketoListOperation, tFixedFlowInput et tLogRow de la Palette dans l'espace
de modlisation graphique.
2. Cliquez sur le bouton [...] ct du champ Edit schema pour dfinir manuellement le schma.
3. Cliquez sur le bouton [+] afin d'ajouter quatre colonnes : ListKeyType, ListKeyValue, LeadKeyType
et LeadKeyValue. Laissez leurs paramtres par dfaut. Cliquez sur OK pour sauvegarder la configuration.
5. Cliquez sur le bouton [+] pour ajouter une ligne, puis remplissez-la avec les valeurs respectives.
Dans cet exemple, ces valeurs sont : MKTOLISTNAME pour ListKeyType, bchenTestList pour
ListKeyValue, IDNUM pour LeadKeyType et 308408 pour LeadKeyValue.
Configurer le tMarketoListOperation
1. Double-cliquez sur le composant tMarketoListOperation pour dfinir ses proprits dans la vue Basic
settings.
2. Cliquez sur le bouton Sync columns afin de rcuprer le schma dfini dans le tFixedFlowInput.
4. Dans le champ Endpoint address, saisissez l'URL du serveur Web Marketo. Dans cet exemple,
saisissez https://na-c.marketo.com/soap/mktows/1_5.
Notez que l'URL utilise dans ce scnario a pour but la dmonstration uniquement.
5. Dans le champ Secret key, saisissez le code d'authentification crypt fourni par Marketo. Dans cet exemple,
le code est 464407637703554044DD11AA2211998.
6. Saisissez l'ID de l'utilisateur dans le champ Client Access ID. Dans cet exemple, l'ID
est mktodemo41_785133934D1A219.
8. Saisissez la limite avant suspension de la requte dans le champ Timeout. Dans cet exemple, utilisez le dlai
par dfaut : 60000.
Excuter le Job
1. Double-cliquez sur le composant tLogRow afin de configurer ses proprits dans la vue Basic settings.
2. Cliquez sur le bouton Sync columns pour rcuprer le schma dfini dans le composant
tMarketoListOperation.
L'ajout d'un enregistrement de prospects dans une liste de la base de donnes Marketo est affich dans la
console de la vue Run.
tMarketoOutput
Proprits du tMarketoOutput
Famille de composant Business/Cloud
Fonction Le composant tMarketoOutput envoie des donnes vers un serveur Web Marketo.
Objectif Ce composant vous permet d'crire des donnes dans une base de donnes Marketo sur un
serveur Web.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre
de champs qui sont traits et passs au composant suivant. Le
schma est soit local (Built-in), soit distant dans le Repository.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de sortie. Un composant d'entre
est ncessaire.
2. Connectez le composant tFileInputDelimited au tMarketoOutput l'aide d'un lien Row > Main.
3. Connectez le composant tMarketoInput au tFileOutputDelimited l'aide d'un lien Row > Main.
4. Connectez le composant tFileInputDelimited au tMarketoInput l'aide d'un lien Trigger > OnSubjectOk.
5. Connectez le composant tMarketoInput au tJava l'aide d'un lien Trigger > OnSubjectOk.
Configurer le tFileInputDelimited
1. Double-cliquez sur le composant tFileInputDelimited pour afficher l'onglet Basic settings de sa vue
Component et dfinir ses proprits.
2. Cliquez sur le bouton [...] ct du champ File name/Stream et slectionnez un fichier local pour l'insertion
de donnes. Pour ce scnario, il s'agit de D:/SendData.csv.
3. Cliquez sur le bouton [...] ct du champ Edit schema pour configurer le schma manuellement.
4. Cliquez sur le bouton [+] pour ajouter quatre colonnes : Id, Email, ForeignSysPersonId et ForeignSysType.
Configurez le Type de Id Integer et laissez les autres colonnes telles qu'elles sont. Cliquez ensuite sur OK
pour enregistrer les paramtres.
5. Dans le champ Header, saisissez 1 et laissez les autres paramtres tels qu'ils sont.
Configurer le tMarketoOutput
1. Double-cliquez sur le composant tMarketoOutput pour afficher l'onglet Basic settings de sa vue
Component et dfinir ses proprits.
2. Cliquez sur le bouton Sync columns pour rcuprer le schma dfini dans le composant tFileInputDelimited.
Renseignez le champ Endpoint address avec l'adresse URL du serveur Web Marketo. Pour ce scnario,
saisissez https://na-c.marketo.com/soap/demo/demo1.
Notez que l'URL utilise dans ce scnario est essentiellement destine la dmonstration.
3. Renseignez le champ Secret key avec le code d'authentification crypt fourni par Marketo. Pour ce scnario,
saisissez 1234567894DEMOONLY987654321.
4. Renseignez le champ Client Access ID avec l'identifiant utilisateur. Pour ce scnario, saisissez
mktodemo1_1234567894DEMOONLY987654321.
5. A partir de la liste Operation, slectionnez syncMultipleLeads. Saisissez le dlai (en millisecondes) avant
suspension de la requte dans le champ Timeout (milliseconds). Pour ce scnario, utilisez la valeur par
dfaut : 600000.
Configurer le tMarketoInput
1. Double-cliquez sur le composant tMarketoInput afin d'afficher l'onglet Basic settings de sa vue Component
et dfinir ses proprits.
3. Dans le tableau Columns Mapping, saisissez test@talend.com dans la colonne Columns in Marketo
correspondant la colonne Email.
Notez que les donnes utilises dans ce scnario sont essentiellement destines la dmonstration.
4. Dans la liste LeadKey type, slectionnez EMAIL et saisissez test@talend.com dans le champ LeadKey
value.
5. Laissez les autres paramtres tels qu'ils sont dans le composant tMarketoOutput.
Configurer le tFileOutputDelimited
1. Double-cliquez sur le composant tFileOutputDelimited pour afficher l'onglet Basic settings de sa vue
Component et dfinir ses proprits.
2. Cliquez sur le bouton [...] ct du champ File name pour synchroniser les donnes dans un fichier local.
Dans ce scnario, le chemin d'accs au fichier est D:/ReceiveData.csv.
3. Cliquez sur le bouton Sync columns et laissez les autres paramtres tels qu'ils sont.
2. Dans le champ Code, saisissez le code suivant afin de compter le nombre d'appels d'API effectus pendant
les oprations sur les donnes :
Excuter le Job
1. Sauvegardez votre Job.
Les enregistrements des prospects insrs dans la base de donnes Marketo sont crits dans le fichier D:/
ReceiveData.csv.
Le nombre total d'appels d'APIs durant les oprations sur les donnes est affich dans la console de la vue
Run.
tMicrosoftCrmInput
Proprits du tMicrosoftCrmInput
Famille de composant Business
Fonction Le composant tMicrosoftCrmInput rcupre des donnes d'une entit de la base de donnes
MicrosoftCRM.
Objectif Ce composant permet d'extraire les donnes d'une base MicrosoftCRM selon certaines
conditions dfinies dans des colonnes spcifiques.
Basic settings Authentication Type Slectionnez le type d'authentification correspondant des
modles spcifiques de dploiement de CRM.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de
sortie. Cette variable est une variable After et retourne un entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie
est ncessaire.
Limitation Ce composant supporte Microsoft CRM 4.0 (2007) pour le type d'authentification On-Premise
et Microsoft CRM 4.0 (2007) et 2011 pour le type d'authentification Online.
Configurer le Job
1. A partir de la Palette, dposez les composants suivants dans l'diteur graphique : tFileInputDelimited,
tFileOutputDelimited, tMicrosoftCrmInput, et tMicrosoftCrmOutput.
Configurer le tFileInputDelimited
1. Double-cliquez sur le composant tFileInputDelimited pour afficher la vue Basic settings et configurer ses
paramtres de base.
2. Slectionnez le mode Repository partir de la liste droulante Property Type si vous avez stock les
paramtres du fichier d'entre sous le nud Metadata de l'arborescence Repository. Dans le cas contraire,
slectionnez le mode Built-In et remplissez manuellement les champs correspondants. Dans cet exemple, les
proprits sont dfinies en mode Built-In.
3. Cliquez sur le bouton [...] ct du champ File Name/Input Stream et parcourez vos dossiers jusqu'au
fichier dlimit contenant les donnes d'entre. Dans cet exemple, le fichier d'entre comprend les colonnes
suivantes : new_id, new_status, new_firstname, new_email, new_city, new_initial et new_zipcode.
4. Dans le champ Row separator, dfinissez le sparateur de lignes permettant d'identifier les fins de ligne.
De mme, pour Field separator, dfinissez le sparateur de champs permettant de dlimiter les diffrents
champs pour chaque ligne.
5. Dfinissez, si ncessaire, le nombre de lignes d'en-tte (Header) et de pied de page (Footer) ignorer, ainsi
que le nombre maximum de lignes (Limit) que vous souhaitez traiter. Dans cet exemple, aucun de ces trois
champs ne sont dfinis.
6. Cliquez sur Edit schema pour ouvrir une bote de dialogue dans laquelle vous pouvez dfinir le schma
d'entre que vous voulez crire dans la base de donnes MicrosoftCRM.
7.
Configurer le tMicrosoftCrmOutput
1. Double-cliquez sur le composant tMicrosoftCrmOutput pour afficher la vue Basic settings et configurer
ses paramtres de base.
2. Dans le champ Microsoft Web Service URL, saisissez l'URL du serveur Web Microsoft. Renseignez ensuite
le nom (Username) ainsi que le mot de passe (Password) correspondants.
3. Dans le champ OrganizeName, saisissez l'identifiant qui porte les droits d'accs la base de donnes
MicrosoftCRM.
4. Dans le champ Domain, renseignez le nom de domaine du serveur sur lequel la base de donnes
MicrosoftCRM est hberge. Saisissez ensuite l'adresse IP (Host) et le numro de port d'coute (Port) du
serveur.
5. A partir de la liste droulante Action, slectionnez l'opration que vous voulez effectuer. Dans cet exemple,
le but est d'insrer (Insert) des donnes dans une entit personnalise sur la base MicrosoftCRM.
6. Dans le champ Time out, dfinissez la limite de temps (en secondes) aprs laquelle le Job s'arrte
automatiquement.
7. Dans la liste Entity, slectionnez l'une des options proposes. Dans cet exemple, c'est l'option CustomEntity
qui est slectionne.
Lorsque l'option CustomEntity est slectionne, le champ Custom Entity Name apparat, dans lequel vous devez
saisir le nom de l'entit personnalise.
Le Schema est alors dfini de manire automatique, en fonction de l'entit slectionne. Cliquez si ncessaire
sur le bouton Edit schema pour afficher une bote de dialogue partir de laquelle vous pouvez modifier ce
schma et retirer les colonnes dont vous n'avez pas besoin en sortie.
8. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent.
Configurer le tMicrosoftCrmInput
1. Double-cliquez sur le composant tMicrosoftCrmInput pour afficher la vue Basic settings et configurer ses
paramtres de base.
2. Slectionnez le mode Repository partir de la liste droulante Property Type si vous avez stock les
paramtres du fichier d'entre sous le nud Metadata de l'arborescence Repository. Dans le cas contraire,
slectionnez le mode Built-In et remplissez manuellement les champs correspondants. Dans cet exemple, les
proprits sont dfinies en mode Built-In.
3. Dans le champ Microsoft Web Service URL, saisissez l'URL du serveur Web Microsoft. Renseignez ensuite
le nom (Username) ainsi que le mot de passe (Password) correspondants.
4. Dans le champ OrganizeName, saisissez l'identifiant qui porte les droits d'accs la base de donnes
MicrosoftCRM.
5. Dans le champ Domain, renseignez le nom de domaine du serveur sur lequel la base de donnes
MicrosoftCRM est hberge. Saisissez ensuite l'adresse IP (Host) et le numro du port d'coute (Port) du
serveur.
6. Dans la liste Entity, slectionnez l'une des options proposes. Dans cet exemple, c'est l'option CustomEntity
qui est slectionne.
7. Le Schema est alors dfini de manire automatique, en fonction de l'entit slectionne, mais vous pouvez
le modifier si ncessaire. Dans cet exemple, pour accder l'entit personnalise, il faut dfinir le schma
manuellement. Copiez le schma sept colonnes partir du composant tMicrosoftCrmOutput et collez-le
dans la bote de dialogue du tMicrosoftCrmInput.
8. Cliquez sur le bouton OK pour fermer la bote de dialogue. Un message pop-up vous proposera de propager
les modifications : cliquez sur le bouton Yes.
9. Dans la vue Basic settings, slectionnez l'oprateur logique And ou Or utiliser pour combiner les conditions
dfinies dans les colonnes d'entre. Dans cet exemple, pour dfinir deux conditions sur deux colonnes d'entre
diffrentes, il faut utiliser l'oprateur logique And.
10. Dans la zone Condition, cliquez sur le bouton [...] pour ajouter autant de lignes que ncessaire, puis cliquez
dans chaque ligne et slectionnez, partir de la liste droulante Input column, la colonne sur laquelle
appliquer la condition. Dans cet exemple, les deux colonnes new-city et new_id portent des conditions. Le but
est d'extraire toutes les lignes concernant les clients dont la ville correspond "New York" et dont l'identifiant
est suprieur 2.
11. Cliquez dans chaque ligne et slectionnez, partir de la liste droulante Operator, l'oprateur utiliser pour
relier la colonne d'entre avec sa valeur associe. Dans cet exemple, l'oprateur Equal est slectionn pour
la colonne new_city et Greater Than pour new_id.
12. Cliquez dans chaque ligne et dfinissez, dans la colonne Value, la valeur des colonnes d'entre : New York
pour la colonne new_city et 2 pour new_id dans cet exemple. Il est possible d'utiliser une valeur fixe aussi
bien qu'une valeur de contexte dans ce champ.
Configurer le tFileOutputDelimited
1. Double-cliquez sur le composant tFileOutputDelimited pour afficher la vue Basic settings et configurer
ses paramtres de base.
2. Slectionnez le mode Built-In partir de la liste droulante Property Type puis cliquez sur le bouton [...]
ct du champ File Name pour parcourir vos dossiers jusqu'au fichier de sortie.
4. Cochez la case Append pour ajouter des lignes la fin des entres de la base de donnes.
6. Cliquez sur le bouton Sync columns pour rcuprer le schma partir du composant prcdent.
Seuls les clients habitant la ville de New York, dont l'identifiant est suprieur 2, apparaissent dans la liste
du fichier de sortie stock en local.
tMicrosoftCrmOutput
Proprits du tMicrosoftCrmOutput
Famille de composant Business
Fonction Le composant tMicrosoftOutput crit des donnes dans une base de donnes MicrosoftCRM.
Objectif Ce composant permet d'crire des donnes dans une base de donnes MicrosoftCRM.
Basic settings Authentication Type Slectionnez le type d'authentification correspondant des
modles spcifiques de dploiement de CRM.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis comme composant de sortie. Il ncessite un composant d'entre.
Limitation Ce composant supporte Microsoft CRM 4.0 (2007) pour le type d'authentification On-Premise
et Microsoft CRM 4.0 (2007) et 2011 pour le type d'authentification Online.
Scnario associ
Pour un scnario associ, consultez le composant tMicrosoftCrmInput.
tMSAXInput
Proprits du tMSAXInput
Famille de composant Business/ Microsoft AX
Fonction Le composant tMSAXInput se connecte au serveur MicrosoftAX.
Objectif Ce composant permet de lire les donnes d'un serveur MicrosoftAX et d'effectuer des requtes
sur ces donnes.
Basic settings Property type Peut tre Built-in ou Repository.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier o sont stockes les
proprits du composant. Les champs suivants sont alors pr-
remplis l'aide des donnes collectes.
Version Slectionnez le type de connecteur mtier utiliser. Ce type peut
tre :
Dynamics AX 4.0
Dynamics AX 2012
Type Dynamics AX 2012 .NET Business Connector Parcourez votre systme ou saisissez le chemin d'accs au fichier
uniquement. Assembly Path Assembly de votre connecteur mtier .NET.
Host Saisissez l'adresse IP du serveur de MicrosoftAX.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie
est ncessaire.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tMSAXOutput
Proprits du tMSAXOutput
Famille de composant Business/ Microsoft AX
Fonction Le composant tMSAXOutput se connecte au serveur MicrosoftAX.
Objectif Ce composant permet d'crire les donnes d'un serveur MicrosoftAX.
Basic settings Property type Peut tre Built-in ou Repository.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier o sont stockes les
proprits du composant. Les champs suivants sont alors pr-
remplis l'aide des donnes collectes.
Version Slectionnez le type de connecteur mtier utiliser. Ce type peut
tre :
Dynamics AX 4.0
Dynamics AX 2012
Type Dynamics AX 2012 .NET Business Connector Parcourez votre systme ou saisissez le chemin d'accs au fichier
uniquement. Assembly Path Assembly de votre connecteur mtier .NET.
Host Saisissez l'adresse IP du serveur de MicrosoftAX.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After
et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et
retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After
et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et
retourne un entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de sortie. Un composant de dbut
est ncessaire.
Ce scnario dcrit un Job deux composants qui utilise le composant tMSAXOutput afin d'insrer une ligne
dans une table dfinie stocke sur un serveur Microsoft AX et modifie ensuite les valeurs dans l'une des colonnes
insre.
Configurer le Job
1. Glissez le composant tFixedFlowInput ainsi que le tMSAXOutput de la Palette dans l'espace de
modlisation.
Configurer le tFixedFlowInput
1. Double-cliquez sur le tFixedFlowInput afin d'afficher la vue Component et de dfinir ses proprits.
2. Slectionnez le mode Built-In dans le champ Schema et cliquez sur le bouton [...] du champ Edit schema
afin d'afficher une bote de dialogue qui vous permettra de dfinir le schma d'entre.
3. Cliquez sur le bouton [+] vert pour ajouter des colonnes dans le schma d'entre, trois dans cet exemple,
name, city et street (nom, ville et rue).
4. Cliquez sur OK pour fermer la bote de dialogue. Une nouvelle bote de dialogue s'ouvre et vous demande
si vous voulez propager les modifications, cliquez sur Yes (Oui). Les colonnes du schma s'affichent
automatiquement dans le tableau Values.
5. Cliquez sur la colonne Value et saisissez une valeur pour chaque colonne d'entre.
Configurer le tMSAXOutput
1. Double-cliquez sur le tMSAXOutput pour ouvrir la vue Component et dfinir ses proprits.
3. Dans le champ Host, saisissez l'adresse IP du serveur MicrosoftAX et, dans le champ Domain, saisissez le
nom du domaine qui hberge le serveur MicrosoftAX.
4. Entrez votre nom d'utilisateur et votre mot de passe de connexion au serveur dans les champs correspondants,
puis, dans le champ Table Name, saisissez le nom de la table dans la quelle vous souhaitez crire des donnes.
5. Dans la liste Action on data, slectionnez l'action que vous dsirez excuter, Insert dans cet exemple.
Dans cet exemple, le but est de retrouver les trois colonnes d'entre : name, city et street (nom, ville et rue)
et d'crire les donnes comprises dans les trois colonnes d'entre du serveur MicrosoftAX sans effectuer de
modification.
Si ncessaire, cliquez sur le bouton [...] du champ Edit schema afin d'ouvrir une bote de dialogue qui vous
permettra de vrifier le schma retourn.
7. Dans le tableau Additional columns, cliquez sur le bouton [+] afin d'ajouter une ligne dans laquelle vous
pouvez dfinir les paramtres de la nouvelle colonne ajouter la ligne que vous souhaitez crire dans la
table ADDRESS.
8. Dfinissez un nom, un type de donnes, une position et une colonne de rfrence dans les colonnes
correspondantes de la ligne ajoute.
Dans cet exemple, ajoutez une nouvelle colonne nomme "address" aprs la colonne "street".
9. Cliquez sur la colonne Local expression et appuyez sur Ctrl+Espace sur votre clavier pour ouvrir la liste des
variables de contexte et slectionnez : StringHandling.UPCASE(row2.city)+"-"+row2.street. Cette
expression crira le nom de la ville avec la premire lettre en majuscule, suivi du nom de la rue, pour former
l'adresse du Bryant park. La colonne address de cet exemple contiendra donc la chane de caractres suivante :
New York-Midtown Manhattan.
Excuter le Job
Sauvegardez votre Job et appuyez sur F6 pour l'excuter.
Le tMSAXOutput insre dans la table ADDRESS du serveur MicrosoftAX une ligne contenant les trois
colonnes d'entre name, city et street, en plus de la nouvelle colonne address qui contient la fois le nom
de la ville et le nom de la rue.
Ce scnario dcrit un Job deux composants qui utilise le tMSAXOutput dans le but d'effacer toutes les
lignes d'une table dfinie qui ne correspondent pas aux donnes contenues dans la colonne cl sur un serveur
MicrosoftAX.
Dans cet exemple, le schma d'entre que vous utilisez est une colonne address (adresse) qui contient les donnes
suivantes : New York-Midtown Manhattan. Vous allez effacer du serveur MicrosoftAX toutes les adresses qui ne
sont pas identiques celle-ci.
Configurer le Job
1. Glissez les composants tFixedFlowInput et tMSAXOutput de la Palette dans l'espace de modlisation
graphique.
2. Connectez les deux composants l'aide d'un lien Row de type Main.
Configurer le tFixedFlowInput
1. Double-cliquez sur le tFixedFlowInput pour afficher sa vue Component et dfinir ses proprits.
2. Slectionnez le mode Built-In dans le champ Schema et cliquez sur le bouton [...] du champ Edit schema
pour ouvrir une bote de dialogue o vous pourrez dfinir le schma.
3. Cliquez sur le bouton [+] et ajoutez les colonnes d'entre du schma, address dans cet exemple.
4. Cliquez sur OK pour fermer la bote de dialogue. Les colonnes du schma s'affichent automatiquement dans
la liste Values.
5. Cliquez sur la colonne Value et saisissez une valeur pour la colonne d'entre.
4. Dans le champ Domain, entrez le nom du domaine qui hberge le serveur MicrosoftAX.
5. Saisissez votre nom d'utilisateur et votre mot de passe de connexion au serveur dans les champs
correspondants.
6. Dans le champ Table Name, saisissez le nom de la table dans laquelle vous voulez supprimer des donnes,
ADDRESS dans cet exemple.
2. Cliquez sur Sync columns pour retourner le schma du composant prcdent. Dans cet exemple, l'objectif
est de rcuprer la colonne d'entre address.
3. Cliquez sur le bouton [...] du champ Edit Schema pour ouvrir la bote de dialogue dans laquelle vous pouvez
vrifier le schma rcupr.
4. Dans le schma de sortie, cochez la case Key (cl) ct du nom de la colonne puis cliquez sur OK pour
valider les changements et fermer la bote de dialogue.
Lorsque vous slectionnez l'action sur les donnes Delete, vous devez dfinir la colonne de rfrence Reference
column comme colonne cl afin que le tMSAXOutput supprime les lignes partir de cette colonne cl.
5. Dans le tableau Additional columns, cliquez sur le bouton [+] pour ajouter une ligne et dfinir les paramtres
que le composant utilisera comme base pour l'opration d'effacement.
6. Saisissez un nom (name), un oprateur (operator), un type de donnes (data type), une expression locale
(local expression), une position (position) et une colonne de rfrence (reference column) dans les colonnes
correspondantes la ligne que vous venez d'ajouter.
Dans cet exemple, l'objectif est d'effacer de la table ADDRESS du serveur MicrosoftAX toutes les lignes
dans lesquelles la colonne Address n'est pas identique l'adresse dans la colonne cl address, New York-
Midtown Manhattan.
Quand vous slectionnez l'option Delete, vous devez toujours paramtrer Position Replace. Sinon, les paramtres
du tableau Additional columns ne seront pas pris en compte lors de l'excution de votre Job.
Excuter le Job
Sauvegardez votre Job et appuyez sur F6 pour l'excuter.
Le tMSAXOutput supprime de la table ADDRESS du serveur MicrosoftAX toutes les lignes pour lesquelles
les donnes de la colonne address ne sont pas identiques celles de la colonne cl.
tNetsuiteInput
Proprits du tNetsuiteInput
Famille de composant Business/NetSuite
Fonction Le composant tNetsuiteInput invoque le service SOAP NetSuite et rcupre les donnes selon les
conditions spcifies.
Objectif Ce composant vous permet d'accder au serveur SOAP NetSuite et d'en rcuprer des donnes.
Basic settings Username et Password Saisissez vos informations d'authentification pour accder au service SOAP
NetSuite.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Role Saisissez l'ID de votre rle NetSuite.
Account Saisissez votre nom de compte NetSuite.
Record Type Slectionnez un type d'enregistrement rcuprer.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (Built-in),
soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi,
il peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de dbut dans un flux Talend et ncessite
un composant de sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tNetsuiteOutput
Proprits du tNetsuiteOutput
Famille de composant Business/NetSuite
Fonction Le composant tNetsuiteOutput invoque le service SOAP Netsuite et insre, met jour ou supprime des
donnes sur le serveur SOAP NetSuite.
Objectif Ce composant vous permet d'accder au serveur SOAP NetSuite et d'excuter l'action dfinie sur les
donnes, sur le serveur.
Basic settings Username et Password Saisissez vos informations d'authentification pour accder au service SOAP
NetSuite.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Role Saisissez l'ID de votre rle NetSuite.
Account Saisissez votre nom de compte NetSuite.
Action Slectionnez une action effectuer dans la liste.
Pour utiliser cette option, la colonne InternalId doit exister dans le schma
et tre dfinie comme Key.
Pour utiliser cette option, la colonne InternalId doit exister dans le schma
et tre dfinie comme Key.
Pour utiliser cette option, la colonne InternalId doit exister dans le schma
et tre dfinie comme Key.
Record Type Slectionnez le type d'enregistrement sur lequel travailler.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (Built-in),
soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi,
il peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des
entiers (integer) ou des fonctions (function), assurez-vous que les valeurs par
dfaut ne sont pas entoures de guillemets. Si c'est le cas, vous devez supprimer
manuellement les guillemets.
CURRENT_INTERNALID: The internal ID of the record currently inserted or processed. This is a Flow
variable and it returns an integer.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de fin dans un flux Talend et ncessite un
composant d'entre.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tOpenbravoERPInput
Proprits du tOpenbravoERPInput
Famille de composant Business
Fonction Le composant tOpenbravoERPInput se connecte une entit de la base de donnes
OpenbravoERP via le service Web adquat.
Objectif Ce composant permet d'extraire les donnes d'une base OpenBravoERP selon certaines
conditions dfinies dans des colonnes spcifiques.
Basic settings Openbravo REST Saisissez l'URL du service Web permettant de se connecter la
WebService URL base de donnes OpenbravoERP.
Username et Password Saisissez les informations d'authentification de l'utilisateur au
service Web.
Sort : Dans cette liste, vous pouvez choisir de trier vos rsultats de
manire ascendante (Ascending) ou descendante (Descending).
First result Saisissez le numro de la ligne que vous souhaitez rcuprer en
premier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie
est ncessaire.
Scnario associ
Pour un scnario associ, consultez le composant tMicrosoftCrmInput.
tOpenbravoERPOutput
Proprits du tOpenbravoERPOutput
Famille de composant Business
Fonction Le composant tOpenbravoERPOutput crit dans un objet de la base de donnes
OpenbravoERP via le service Web adquat.
Objectif Ce composant permet d'crire des donnes dans une base de donnes OpenbravoERP.
Basic settings Openbravo REST Saisissez l'URL du service Web permettant de se connecter la
Webservice URL base de donnes OpenbravoERP.
Username et Password Saisissez les informations d'authentification de l'utilisateur au
service Web.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After
et retourne un entier.
NB_LINE_CREATED : nombre de lignes cres. Cette variable est une variable After et
retourne un nombre entier.
NB_LINE_REMOVED : nombre de lignes supprimes. Cette variable est une variable After
et retourne un nombre entier.
NB_LINE_FAILED : nombre de lignes en erreur. Cette variable est une variable After et
retourne un nombre entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis comme composant de sortie. Il ncessite un composant d'entre.
Scnario associ
Pour un scnario associ, consultez le composant tMicrosoftCrmInput.
tSageX3Input
Proprits du tSageX3Input
Famille de Business/Sage X3
composant
Fonction Le composant tSageX3Input tire profit du Service Web fourni par un serveur Web Sage X3 pour extraire
des donnes du systme Sage X3 (serveur X3).
Objectif Le composant tSageX3Input extrait des donnes d'un systme Sage X3 donn.
Basic settings Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis,
dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles,
puis cliquez sur OK afin de sauvegarder les paramtres.
Language Saisissez le nom du code langue X3 utilis pour le dmarrage du groupe de connexions.
Pool alias Saisissez le nom du pool de connexion distribuant les requtes reues aux connexions
disponibles. Ce nom est donn depuis la console de configuration Sage X3.
Request config Saisissez la chane de caractres de configuration si vous souhaitez rcuprer les
informations de dbogage ou de traces. Par exemple, la chane de caractres peut tre :
RequestConfigDebug="adxwss.trace.on=on";
Si vous devez utiliser plusieurs chanes de caractres, sparez-les avec un &, par
exemple,
RequestConfigDebug="adxwss .trace.on=on&adxwss.trace.size=16384";
Publication name Saisissez dans ce champ le nom de l'objet, de la liste ou du sous-programme publi(e)
auquel/ laquelle vous souhaitez que votre Studio Talend accde.
Key : les noms des lments de variables utiliss comme cl pour l'extraction de
donnes.
Value : la valeur du champ cl donn utilis pour extraire les donnes correspondantes.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Gnralement utilis comme composant de dbut. Un composant de sortie est ncessaire.
Configurer le Job
1. Dposez un composant tSageX3Input et un tLogRow de la Palette dans l'espace de modlisation graphique.
2. Reliez le composant tSageX3Input au tLogRow l'aide d'un lien Row > Main.
2. Dans la liste Schema, slectionnez Built-In puis cliquez sur le bouton [...] ct du champ Edit schema
pour ouvrir l'diteur du schma.
3. Dans cet diteur, cliquez douze fois sur le bouton [+] pour ajouter 12 lignes la table.
4. Saisissez les noms que vous souhaitez utiliser pour chaque ligne. Dans cet exemple, ces lignes sont nommes
d'aprs les noms de publication des attributs des objets dfinis dans le serveur Web Sage X3. Ces colonnes
sont utilises pour mapper les champs des attributs correspondants dans le systme Sage X3.
5. Dans la colonne Type, cliquez sur la ligne IMG pour afficher une liste droulante.
6. Dans la liste droulante, slectionnez List, puisque l'attribut apparat plusieurs fois dans Sage. Rptez
l'opration pour changer le type des lignes TIT2NBLIG, ITMLNK et ZITMLNK en List pour la mme raison.
7. Cliquez sur OK pour valider les modifications et acceptez la propagation propose par la bote de dialogue
qui s'ouvre.
2. Dans le champ User, saisissez le nom de l'utilisateur de Sage X3. Dans cet exemple, l'utilisateur est ERP.
3. Dans le champ Language, saisissez le nom du code langue X3 utilis pour le dmarrage d'un groupe de
connexions, FRA dans cet exemple.
4. Dans le champ Pool alias, saisissez le nom du pool de connexion utiliser. Dans cet exemple, le pool de
connexion est appel TALEND.
5. Dans le champ Publication name, saisissez le nom de publication de l'objet appeler. Dans ce scnario, le
nom de publication est ITMDET.
Dans la table Mapping, la colonne Column a t automatiquement renseigne avec les colonnes que vous avez cres
dans l'diteur du schma.
3. Sous le tableau Conditions, cliquez sur le bouton [+] pour ajouter une ligne.
4. Dans la colonne Key, saisissez le nom de publication associ l'attribut de l'objet dont vous souhaitez extraire
les donnes.
5. Dans la colonne Value, saisissez la valeur de l'attribut que vous avez slectionn comme cl de l'extraction.
Dans ce scnario, sa valeur est CONTS00059, une des rfrences produit.
Excuter le Job
1. Slectionnez Built-In dans la liste Schema puis cliquez sur [...] ct du champ Edit schema afin d'ouvrir
l'diteur du schma.
tSageX3Output
Proprits du tSageX3Output
Famille de composant Business/Sage
X3
Fonction Le composant tSageX3Output se connecte au service Web fourni par un serveur Web Sage X3 donn
et partir de l, insre, met jour ou supprime des donnes dans le systme Sage X3 (serveur X3).
Objectif Ce composant crit des donnes dans un systme Sage X3 donn.
Basic settings Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans
le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets
doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Language Saisissez le nom du code langue X3 utilis pour le dmarrage du groupe de
connexions.
Pool alias Saisissez le nom du pool de connexion distribuant les requtes reues aux connexions
disponibles. Ce nom est donn depuis la console de configuration Sage X3.
Request config Saisissez la chane de caractres de configuration si vous souhaitez rcuprer les
informations de dbogage ou de traces. Par exemple, la chane de caractres peut tre :
RequestConfigDebug="adxwss.trace.on=on";
Si vous devez utiliser plusieurs chanes de caractres, sparez-les avec un &, par
exemple,
RequestConfigDebug="adxwss
.trace.on=on&adxwss.trace.size=16384";
Publication name Saisissez dans ce champ le nom de l'objet, de la liste ou du sous-programme publi(e)
auquel/ laquelle vous souhaitez que votre Studio Talend accde.
Action Vous pouvez effectuer l'une des oprations suivantes sur les donnes d'un systme
Sage X3:
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de sortie et requiert un composant d'entre.
Configurer le Job
1. Dposez un composant tFixedFlowInput et un tSageX3Output de la Palette dans l'espace de modlisation
graphique.
2. Reliez le composant tFixedFlowInput au composant tSageX3Output l'aide d'un lien Row > Main.
2. Cliquez sur le bouton [...] ct du champ Edit schema afin d'ouvrir l'diteur du schma.
3. Cliquez quatre fois sur le bouton [+] afin d'ajouter quatre lignes au schma.
4. Cliquez sur OK pour valider les modifications, puis acceptez la propagation propose par la bote de
dialogue qui s'ouvre ensuite. Les quatre lignes apparaissent automatiquement dans la table Values de la vue
Component.
5. Dans le tableau Values de la zone Mode, saisissez les valeurs de chacune des quatre lignes de la colonne
Value. Dans ce scnario, les valeurs (de haut en bas) sont : CONTS00059, Screen 24\" standard 16/10, Screen
24\" standard 28/10 et 2.
Les valeurs dans la colonne Value doivent tre mises entre guillemets.
2. Dans le champ Endpoint address, saisissez l'URL du service Web fourni par le serveur Web Sage X3. Dans
cet exemple, l'URL est : http://10.42.20.168:28880/adxwsvc/services/CAdxWebServiceXmlCC.
3. Dans le champ User, saisissez le nom de l'utilisateur de Sage X3. Dans cet exemple, l'utilisateur est ERP.
4. Dans le champ Language, saisissez le nom du code langue X3 utilis pour dmarrer un groupe de connexions.
Dans cet exemple, le code est FRA.
5. Dans le champ Pool alias, saisissez le nom du pool de connexion utiliser. Dans cet exemple, le pool de
connexion est appel TALEND.
6. Dans le champ Publication name, saisissez le nom de publication de l'objet appeler. Dans ce scnario, le
nom de publication est ITMDET.
Paramtrer le mapping
1. Dans la colonne Field name de la table Mapping, saisissez le nom des champs des attributs sur lesquels
effectuer l'action slectionne.
2. Dans la colonne Group ID de la table Mapping, saisissez les valeurs correspondantes afin de regrouper les
IDs des attributs slectionns. Ces IDs sont dfinis dans le serveur Web Sage X3.
Dans la table Mapping, la colonne Column a t automatiquement renseigne avec toutes les colonnes rcupres
du schma du composant prcdent.
Excuter le Job
Appuyez sur Ctrl+Espace afin de sauvegarder votre Job puis sur F6 pour excuter le Job.
Pour vrifier les donnes que vous avez insres dans ce scnario, vous pouvez utiliser le composant
tSageX3Input pour lire les donnes concernes dans le serveur Sage X3.
Pour plus d'informations concernant l'utilisation du composant tSageX3Input pour lire des donnes, consultez le
composant tSageX3Input.
tSalesforceBulkExec
Proprits du tSalesforceBulkExec
Famille de composant Business/Cloud
Fonction Le composant tSalesforceBulkExec excute les actions dfinies sur les donnes de chargement
de masse prpares.
Objectif En tant que composant ddi, le tSalesforceBulkExec vous permet d'optimiser les
performances lors des excutions d'oprations dfinies dans votre Salesforce.com.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion
adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Consumer Key et Consumer Saisissez les dtails de votre authentification OAuth. Ces
Secret informations sont disponibles dans la zone OAuth Settings de
l'application connecte cre sur le site Salesforce.com.
Advanced settings Rows to commit Saisissez le nombre de lignes devant tre traites par lot de
donnes.
Bytes to commit Saisissez le nombre d'octets par lot de donnes devant tre traits.
Concurrency mode Mode de simultanit pour le Job :
NB_SUCCESS : nombre de lignes traites avec succs. Cette variable est une variable After
et retourne un nombre entier.
NB_REJECT : nombre de lignes rejetes. Cette variable est une variable After et retourne
un nombre entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis comme composant de sortie. Il ncessite un composant d'entre.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Limitation Les donnes de masse traiter doivent tre au format .csv.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer
le studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez le composant tSalesforceOutputBulk.
tSalesforceConnection
Proprits du tSalesforceConnection
Famille de composant Business/Cloud
Fonction Le composant tSalesforceConnection ouvre une connexion vers un systme Salesforce afin d'effectuer
une transaction.
Objectif Ce composant permet de vous connecter Salesforce.
Basic settings Property type Peut tre Built-in ou Repository.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec les composants Salesforce.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations
sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont
pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton
Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans
l'onglet Modules de la perspective Integration de votre studio. Pour plus d'informations, consultez la
page https://help.talend.com/display/KB/How+to+install+external+modules+in+the+Talend+products
(en anglais) ou la section dcrivant comment configurer le studio, dans le Guide d'installation et de
migration Talend.
3. Dans les champs Consumer Key et Consumer Secret, saisissez les informations requises.
5. Dans le champ Content, saisissez les donnes crire dans Saleforce.com, par exemple :
Talend
8. Dans la liste Action, slectionnez insert pour insrer le nom du compte, Talend.
10. Cliquez sur le bouton Edit schema pour ouvrir l'diteur de schma.
11. Dans le panneau de droite, supprimez toutes les colonnes, sauf Name.
12.
Cliquez sur le bouton pour copier la colonne Name de droite gauche.
Excuter le Job
1. Appuyez sur les touches Ctrl + S pour sauvegarder le Job.
2. Appuyez sur F6 pour excuter le Job. La console du Studio affiche l'URL (surligne en jaune) de l'autorisation
OAuth.
3. Copiez l'URL dans la barre d'adresse de votre navigateur. La page de connexion Salesforce.com s'ouvre.
4. Saisissez votre identifiant et votre mot de passe puis cliquez sur le bouton Log in to Salesforce.
5. Le sous-job s'excute.
Comme vous pouvez le constater dans la console, le Job est correctement excut.
6. Allez sur Salesforce.com et consultez la page Account module. Le nom de compte Talend est ajout.
tSalesforceGetDeleted
Proprits du tSalesforceGetDeleted
Famille de composant Business/Cloud
Fonction Le composant tSalesforceGetDeleted rcupre les donnes supprimes d'un objet Salesforce
sur une priode donne.
Objectif Ce composant rcupre les donnes supprimes de l'objet Salesforce spcifi sur une priode
spcifie.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion
adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de
sortie. Cette variable est une variable After et retourne un entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis comme composant de sortie. Il ncessite un composant d'entre.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Configurer le Job
1. Cliquez et dposez les composants tSalesforceGetDeleted et tLogRow de la Palette dans le Job Designer.
2. Dans le champ Salesforce WebService URL, laissez l'URL du service Web Salesforce par dfaut ou saisissez
l'URL laquelle vous souhaitez accder.
3. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au
service Web.
4. Dans la liste Module, slectionnez l'objet auquel vous souhaitez accder. Dans ce scnario, l'objectif est
d'accder l'objet Account.
2. Dans les champs Start Date et End Date, saisissez la date de dbut et de fin de recherche des donnes
supprimes en utilisant le format de date suivant : "yyyy-MM-dd HH:mm:ss". Vous ne pouvez effectuer la
recherche que sur les 30 derniers jours. Dans ce scnario, l'objectif est de chercher les donnes supprimes
dans les cinq derniers jours.
Excuter le Job
1. Double-cliquez sur le composant tLogRow pour afficher l'onglet Basic settings de la vue Component et
paramtrer ses proprits :
2. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent.
3. Dans la zone Mode, slectionnez l'option Vertical pour faire apparatre le rsultat dans sous forme de tableau
dans la console.
La console affiche les donnes supprimes rcupres par le composant tSalesforceGetDeleted sous forme
de tableau.
tSalesforceGetServerTimestamp
Proprits du tSalesforceGetServerTimestamp
Famille de composant Business/Cloud
Fonction Le composant tSalesforceGetServerTimestamp rcupre la date actuelle du serveur
Salesforce.
Objectif Ce composant rcupre la date actuelle sous forme de timestamp du serveur Salesforce.
Basic settings Use an existing connection Un schma est une description de lignes, il dfinit le nombre
de champs qui sont traits et passs au composant suivant. Le
schma est soit local (Built-in), soit distant dans le Repository.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis comme composant de sortie. Il ncessite un composant d'entre.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tSalesforceGetUpdated
Proprits du tSalesforceGetUpdated
Famille de composant Business/Cloud
Fonction Le composant tSalesforceGetUpdated rcupre les donnes mises jour d'un objet Salesforce
sur une priode donne.
Objectif Ce composant rcupre les donnes mises jour de l'objet Salesforce spcifi sur une priode
spcifie.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion
adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de
sortie. Cette variable est une variable After et retourne un entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis comme composant de sortie. Il ncessite un composant d'entre.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tSalesforceInput
Proprits du tSalesforceInput
Famille de composant Business/Cloud
Fonction Le composant tSalesforceInput se connecte un objet de la base de donnes Salesforce via le service Web
adquat.
Objectif Ce composant permet d'extraire les donnes d'une base de donnes Salesforce l'aide d'une requte.
Basic settings Property type Peut tre Built-in ou Repository.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Query all records (include Cochez cette case pour interroger tous les enregistrements, y compris les
deleted records) enregistrements supprims.
Disponible lorsque l'option Bulk Query est slectionne dans la liste Query
mode.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Client ID Dfinissez l'ID de l'utilisateur rel afin de diffrencier ceux qui utilisent le
mme compte et le mme mot de passe pour accder au site Web Salesforce.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie est
ncessaire.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Configurer le Job
1. Dposez deux composants tSalesforceInput et deux tLogRow dans l'espace de modlisation graphique.
2. Reliez chaque composant tSalesforceInput un tLogRow, l'aide de liens Row > Main.
2. Dans le champ Salesforce WebService URL, saisissez l'URL de la base de donnes laquelle vous souhaitez
vous connecter.
3. Renseignez vos informations d'authentification dans les champs correspondants, Username pour l'identifiant
et Password pour le mot de passe.
4. Saisissez la limite de temps que vous souhaitez appliquer la requte, dans le champ Timeout (milliseconds).
2. Cochez la case Manual input of SOQL Query puis saisir votre requte ou votre requte relationnelle, en
respectant la syntaxe SOQL requise, dans le champ Query.
3. Slectionnez Built-In dans la liste Schema puis cliquez sur le bouton [...] ct du champ Edit schema,
afin d'ouvrir l'diteur du schma.
Dans cet exemple, les colonnes IsWon et FiscalYear dans la requte sont situes dans le module Opportunity
spcifi. La colonne Name est dans un module li, appel Account. Pour retourner une colonne d'un module
li, la syntaxe correcte est de saisir le nom du module li, suivi par le caractre point (.), puis par le nom de
la colonne approprie. Ici, la requte requise est donc :
4. Ajoutez une nouvelle colonne pour les champs extraits de la colonne Name du module Account.
5. Appelez cette colonne Opportunity_Account_Name puis cliquez sur OK afin de sauvegarder les
modifications et fermer l'diteur du schma. .
Pour retrouver une colonne d'un modle li, il est ncessaire de dfinir la colonne d'une manire prcise dans la vue Edit
Schema. La syntaxe correcte est : NameofCurrentModule_NameofLinkedModule_NameofColumnofInterest. Dans notre
exemple, la colonne doit se nommer : Opportunity_Account_Name. Si cette syntaxe n'est pas respecte, les donnes de la
table lie ne seront pas retournes.
2. Dans le champ Salesforce WebService URL, saisissez l'URL de la base de donnes laquelle vous souhaitez
vous connecter.
3. Saisissez vos informations d'authentification dans les champs Username pour l'identifiant et Password pour
le mot de passe.
4. Saisissez la limite de temps que vous souhaitez appliquer sur la requte, dans le champ Timeout
(milliseconds).
2. Cochez la case Manual input of SOQL Query puis saisir votre requte ou votre requte relationnelle, en
respectant la syntaxe SOQL requise, dans le champ Query.
Dans cet exemple, l'objectif est d'extraire les champs Id et CaseNumber du module Case, ainsi que les champs
Name du module Account. La requte est donc : "SELECT Id, CaseNumber, Account.Name FROM Case".
3. Slectionnez Built-In dans la liste Schema et cliquez sur le bouton [...] ct du champ Edit schema, afin
d'ouvrir l'diteur du schma.
4. Ajoutez une nouvelle colonne pour les champs extraits de la colonne Name du module Account.
5. Nommez cette colonne Case_Account_Name puis cliquez sur OK pour sauvegarder les modifications et
fermer l'diteur du schma.
Excuter le Job
1. Cliquez sur chaque composant tLogRow afin de dfinir les Basic settings comme ncessaire.
Dans cet exemple, vous n'avez pas besoin de modifier les paramtres des tLogRow.
tSalesforceOutput
Proprits du tSalesforceOutput
Famille de composant Business/Cloud
Fonction Le composant tSalesforceOutput crit dans un objet de la base de donnes Salesforce via le
service Web adquat.
Objectif Ce composant permet d'crire des donnes dans une base de donnes Salesforce.
Basic settings Property type Peut tre Built-in ou Repository.
NB_SUCCESS : nombre de lignes traites avec succs. Cette variable est une variable After
et retourne un nombre entier.
NB_REJECT : nombre de lignes rejetes. Cette variable est une variable After et retourne
un nombre entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis comme composant de sortie. Il ncessite un composant d'entre.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
1. Double-cliquez sur le composant tSalesforceInput pour afficher l'onglet Basic settings de la vue
Component et paramtrer ses proprits :
2. Dans la liste Property Type, slectionnez Repository si vous avez stock la connexion au serveur Salesforce
dans les mtadonnes du Repository. Les autres champs seront renseigns automatiquement. Si vous n'avez
pas stock la connexion dans les mtadonnes, slectionnez Built-in dans la liste et renseignez les champs
manuellement.
Pour plus d'informations concernant la cration de mtadonnes Salesforce, consultez le Guide utilisateur
du Studio Talend.
3. Dans le champ Salesforce WebService URL, laissez l'URL du service Web Salesforce par dfaut ou saisissez
l'URL laquelle vous souhaitez accder.
4. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au
service Web.
5. Saisissez, en millisecondes, le dlai avant suspension dans le champ Timeout (milliseconds). Dans ce
scnario, utilisez la valeur par dfaut.
6. Dans la liste Module, slectionnez l'objet auquel vous souhaitez accder. Dans ce scnario, l'objectif est
d'accder l'objet Account.
7. Dans la liste Schema, slectionnez Repository puis cliquez sur le bouton [...] pour slectionner le schma du
Repository que vous souhaitez utiliser pour le composant. Si vous n'avez pas enregistr le schma dans les
mtadonnes du Repository, slectionnez Built-in dans la liste Schema et cliquez sur le bouton [...] ct
du champ Edit schema et paramtrez le schma manuellement.
8. Dans le champ Query Condition, saisissez la requte que vous souhaitez appliquer. Pour ce scnario,
l'objectif est de rcuprer le ou les clients dont le nom est sForce., ainsi, saisissez la requte :
"name='sForce'".
9. Pour une requte plus avance, cochez la case Manual input of SOQL query et saisissez-la manuellement.
1. Double-cliquez sur le composant tSalesforceOutput pour afficher l'onglet Basic settings de la vue
Component et paramtrer ses proprits :
2. Dans le champ Salesforce WebService URL, laissez l'URL du service Web Salesforce par dfaut ou saisissez
l'URL laquelle vous souhaitez accder.
3. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au
service Web.
4. Saisissez, en millisecondes, le dlai avant suspension dans le champ Timeout (milliseconds). Dans ce
scnario, utilisez la valeur par dfaut.
5. Dans la liste Action, slectionnez l'action que vous souhaitez effectuer. Ici, slectionnez Delete pour
supprimer le compte sForce slectionn dans le composant prcdent.
6. Dans la liste Module, slectionnez l'objet auquel vous souhaitez accder. Dans ce scnario, l'objectif est
d'accder l'objet Account.
7. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent.
Consultez le contenu de l'objet Account et vrifiez que le compte sForce a t supprim du serveur.
Le lien Reject est disponible uniquement lorsque les cases Extended Output et Die on error sont dcoches dans
la vue Advanced settings du composant tSalesforceOutput.
1. Double-cliquez sur le composant DataToInsert pour ouvrir sa vue Basic settings dans l'onglet Component.
Vous pouvez slectionner Repository dans la liste Property Type pour renseigner automatiquement les proprits si
la mtadonne correspondante est stocke dans le Repository. Pour plus d'informations concernant la centralisation
des mtadonnes, consultez le Guide utilisateur du Studio Talend.
3. Dans le champ File name/Stream, saisissez le chemin d'accs votre fichier source, ou parcourez votre
systme jusqu' celui ci. Dans cet exemple, saisissez E:/salesforceout.csv.
4. Dans le champ Header, saisissez 1 pour rcuprer le nom des colonnes. Laissez les autres paramtres tels
qu'ils sont.
1. Double-cliquez sur le InsertToSalesforce pour ouvrir sa vue Basic settings dans l'onglet Component.
3. Dans le champ Password, saisissez votre mot de passe, par exemple, talendehmrEvHz2xZ8f2KlmTCymS0XU.
Les cases Extended Output et Die on error ont prcdemment t dcoches dans la vue Advanced settings afin
de faire apparatre le lien Reject.
2. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour une meilleure prsentation
des rsultats.
5. Appuyez sur la touche F6 pour excuter le Job. Vous pouvez constater que les donnes en erreur (s'il y en
a) sont affiches dans la vue Run.
Comme affich dans la capture d'cran, les donnes de deux champs Call Center ID sont incorrectes.
2. Cliquez sur le bouton [...] ct du champ File name/Stream afin de slectionner le fichier source.
3. Cochez la case All sheets pour rcuprer toutes les donnes du fichier Excel.
4. Saisissez 1 dans le champ Header afin que la premire ligne contienne le nom des colonnes.
5. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir l'diteur du schma.
6. Cliquez trois fois sur le bouton [+] pour ajouter trois colonnes, respectivement AccountId, LastName et Name.
7. Cliquez sur OK pour fermer l'diteur. Laissez les autre paramtres tels qu'ils sont.
4. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir l'diteur du schma.
5.
Cliquez sur le bouton pour copier toutes les colonnes de la table de sortie dans la table d'entre.
2. Dans les champs Username et Password, saisissez respectivement votre identifiant et votre mot de passe.
3. Dans la liste Module, slectionnez le module Contact afin de rcuprer les donnes.
6. Slectionnez les champs LastName et Name de la table row1 et dposez-les sur les lignes du mme nom,
dans la table row2. Ainsi, les donnes du fichier Excel sont vrifies par rapport celles du mme nom dans
le module Contact.
7. Slectionnez les champs LastName et AccountID de la table row1 et dposez-les sur les lignes du mme
nom, dans la table id. Ainsi, les donnes qualifies du fichier Excel sont passes aux champs de mme nom
dans la table id.
Excuter le Job
1. Appuyez sur Ctrl+S pour sauvegarder votre Job.
2. Renommez les deux composants tFixedFlowInput en external ids to insert et emails to upsert, les deux
tSalesforceInput en Contact (in) et Account (in), les deux tSalesforceOutput en Contact (out) et Account
(out) et les deux tLogRow en external ids inserted et emails upserted.
4. Reliez le external ids to insert au Account (out) l'aide d'un lien Row > Main.
5. Reliez le external ids to insert au Account (in) l'aide d'un lien OnSubjobOk.
6. Reliez le Account (in) au external ids inserted l'aide d'un lien Row > Main.
7. Reliez le composant Account (in) au emails to upsert l'aide d'un lien OnSubjobOk.
8. Reliez le emails to upsert au Contact (out) l'aide d'un lien Row > Main.
10. Reliez le composant Contact (in) au emails upserted l'aide d'un lien Row > Main.
Dans les champs Username et Password, saisissez respectivement votre identifiant et votre mot de passe.
2. Double-cliquez sur le external ids to insert pour ouvrir sa vue Basic settings.
Cliquez trois fois sur le bouton [+] pour ajouter trois colonnes. Nommez-les respectivement Name,
AccountID__c et AccountBizLicense__c, toutes de type String. Vous pouvez remarquer que les colonnes
AccountID__c et AccountBizLicense__c sont des champs personnaliss du module Account, avec l'attribut
de l'ID externe.
Cochez la case Use Inline Content (delimited file) dans la zone Mode et saisissez les donnes ci-dessous
dans le champ Content :
Google;US666;C.A.666
Talend;FR888;Paris888
4. Double-cliquez sur le composant Account (out) pour ouvrir sa vue Basic settings.
Slectionnez Query dans la liste Query mode et Account dans la liste Module.
Dans le champ Query Condition, saisissez l'instruction de filtre : "name like 'Tal%' OR name like
'Goo%'".
Cliquez trois fois sur le bouton [+] pour ajouter trois colonnes. Nommez-les respectivement Name,
AccountID__c et AccountBizLicense__c, toutes de type String.
7. Double-cliquez sur le composant external ids inserted pour ouvrir sa vue Basic settings.
Cochez la case Table (print values in cells of a table) pour un affichage optimal des rsultats.
Cliquez quatre fois sur le bouton [+] pour ajouter quatre colonnes. Nommez-les Email, AccountID,
AccountBizLicense et LastName, toutes de type String.
Cochez la case Use Inline Content (delimited file) dans la zone Mode et saisissez les donnes ci-dessous
dans le champ Content :
andy@talend.com;Paris888;FR888;Andy
anderson@talend.com;C.A.666;US666;Anderson
10. Double-cliquez sur Contact (out) pour ouvrir sa vue Basic settings.
Slectionnez upsert dans la liste Action, Email dans la liste Upsert Key Column et Contact dans la liste
Module.
Cliquez deux fois sur le bouton [+] pour ajouter deux lignes et slectionnez AccountBizLicense et AccountID
dans la liste, dans la colonne Column name of Talend Schema.
Saisissez le nom des champs de relations lookup dans la colonne Lookup field name, savoir Account et
Account__r.
Saisissez le nom des champs d'IDs externes dans la colonne External id name, savoir
AccountBizLicense__c et AccountID__c. Ces champs correspondent aux champs personnaliss du module
Account, avec l'attribut de l'ID externe.
Column name of Talend Schema fait rfrence aux champs du schma du composant prcdent le
tSalesforceOutput. Ces colonnes sont faites pour mettre en correspondance les champs d'IDs externes spcifis
dans la colonne External id name. Ces champs sont ceux spcifis dans la colonne Module name du module de
lookup.
Lookup field name fait rfrence aux champs de relations lookup du module slectionn dans la liste Module de la
vue Basic settings. Ils servent tablir les relations avec le module de lookup spcifi dans le champ Module name.
Pour plus d'informations concernant la dfinition des champs de relation lookup et comment saisir le bon nom dans
le champ Lookup field name, rendez-vous sur le site Web de Salesforce et lancez l'application Salesforce Data
Loader.
11. Double-cliquez sur le Contact (in) pour ouvrir sa vue Basic settings.
Slectionnez Query dans la liste Query mode et Contact dans la liste Module.
Dans le champ Query Condition, saisissez l'instruction de filtre : "Email like 'And%'".
12. Cliquez sur le bouton Edit schema pour ouvrir l'diteur de schma.
Cliquez deux fois sur le bouton [+] pour ajouter deux colonnes de type String. Nommez-les respectivement
LastName et Email.
13. Double-cliquez sur le composant emails upserted pour ouvrir sa vue Basic settings.
Slectionnez l'option Table (print values in cells of a table) pour un affichage optimal des rsultats.
Excuter le Job
1. Appuyez sur les touches Ctrl + S afin de sauvegarder votre Job.
Comme affich ci-dessus, les actions d'insertion et de mise jour ont bien t effectues.
tSalesforceOutputBulk
Proprits du tSalesforceOutputBulk
Famille de composant Business/Cloud
Fonction Le composant tSalesforceOutputBulk gnre des fichiers dans un format appropri au
traitement de masse.
Objectif Ce composant prpare le fichier devant tre trait par le tSalesForceBulkExec afin d'excuter
des actions sur Salesforce.com.
Basic settings File Name Parcourez le rpertoire o stocker les fichiers gnrs.
Append Cochez cette case afin d'crire la suite des donnes existantes.
Sinon, les donnes seront crases.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre
de champs qui sont traits et passs au composant suivant. Le
schma est soit local (Built-in), soit distant dans le Repository.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis avec le tSalesforceBulkExec. Ils permettent d'optimiser les
performances d'alimentation ou de modification des informations sur Salesforce.com.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer
le studio, dans le Guide d'installation et de migration Talend.
Ce Job est ralis en deux tapes : prparer les donnes en les transformant, puis traiter les donnes transformes.
Avant de commencer ce scnario, vous devez prparer le fichier original comprenant les donnes devant tre
traites par le Job. Dans cet exemple d'utilisation, le fichier est sforcebulk.txt, il contient des informations relatives
aux clients.
Configurer le Job
1. Glissez-dposez de la Palette dans l'espace de modlisation graphique les composants tFileInputDelimited,
tMap, tSalesforceOutputBulk, tSalesforceBulkExec et deux tLogRow.
2. Utilisez un lien Row > Main afin de connecter le tFileInputDelimited au tMap, et le lien Row > out1 du
tMap au tSalesforceOutputBulk.
3. Utilisez un lien Row > Main et un lien Row > Reject pour connecter le tSalesforceBulkExec aux deux
tLogRow respectivement.
2. Dans la liste Property Type, slectionnez Repository si vous avez dj stock votre connexion Salesforce
sous le nud Metadata dans la vue Repository. Les proprits sont automatiquement remplies. Si vous
n'avez pas dfini le serveur de connexion localement dans le Repository, renseignez les informations
manuellement, aprs avoir slectionn Built-in dans la liste Property Type.
Pour plus d'informations concernant la cration des mtadonnes de fichier dlimit, consultez le Guide
utilisateur du Studio Talend.
3.
A ct du champ File name/Stream, cliquez sur le bouton afin de parcourir votre rpertoire jusqu'
votre fichier, dans cet exemple sforcebulk.txt.
4. Dans la liste Schema, slectionnez Repository, puis cliquez sur le bouton [...] afin d'ouvrir la bote de
dialogue dans laquelle vous pourrez slectionner le schma du Repository utiliser pour ce composant. Si
vous n'avez pas dfini localement votre fichier dans les mtadonnes, slectionnez Built-in dans la liste
Schema, puis cliquez sur le bouton [...] ct du champ Edit schema, afin d'ouvrir une bote de dialogue dans
laquelle vous pourrez dfinir le schma manuellement. Dans ce scnario, le schma se compose de quatre
colonnes : Name, ParentId, Phone et Fax.
5. Selon votre fichier d'entre, paramtrez les autres champs, comme Row Separator, Field Separator.
Configurer le mapping
1. Double-cliquez sur le composant tMap afin d'ouvrir son diteur et dfinir la transformation.
2. Dans le champ File Name, parcourez votre rpertoire jusqu' l'emplacement o vous souhaitez stocker les
donnes .csv gnres pour un traitement de masse.
3. Cliquez sur le bouton Sync columns afin d'importer le schma du composant prcdent.
2. Utilisez l'URL par dfaut du service Web Salesforce, ou saisissez l'URL laquelle vous souhaitez accder.
3. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au
service Web.
4. Dans le champ Bulk file path, parcourez votre rpertoire jusqu' l'emplacement o est stock le fichier .csv
gnr par le tSalesforceOutputBulk.
5. Dans la liste Action, slectionnez l'action que vous voulez effectuer sur les donnes de masse. Dans cet
exemple, slectionnez insert.
6. Dans la liste Module, slectionnez l'lment auquel vous souhaitez accder, Account dans cet exemple.
7. Dans la liste Schema, slectionnez Repository et cliquez sur le bouton [...] afin d'ouvrir une bote de dialogue
dans laquelle vous pourrez slectionner le schma du Repository utiliser pour ce composant. Si vous n'avez
pas dfini votre schma localement dans les mtadonnes, slectionnez Built-in dans la liste Schema, puis
cliquez sur le bouton [...] ct du champ Edit schema, afin d'ouvrir une bote de dialogue dans laquelle vous
pourrez dfinir votre schma manuellement. Dans cet exemple, dfinissez-le comme le schma prcdent.
2. Cliquez sur le bouton Sync columns afin de rcuprer le schma du composant prcdent.
3. Slectionnez le mode Table afin d'afficher les rsultats d'excution dans un tableau.
Excuter le Job
1. Sauvegardez votre Job.
Dans la console de la vue Run, vous pouvez vrifier les rsultats d'excution.
Dans le tableau du tLogRow_1, vous pouvez lire les donnes insres dans votre Salesforce.com.
Dans le tableau du tLogRow_2, vous pouvez lire les donnes rejetes cause d'une incompatibilit avec les
lments Account auxquels vous avez accd.
tSalesforceOutputBulkExec
Proprits du tSalesforceOutputBulkExec
Famille de composant Business/Cloud
Fonction Le composant tSalesforceOutputBulkExec excute les actions dfinies sur les donnes .csv
pour Salesforce.com.
Objectif En tant que composant ddi, le tSalesforceOutpuBulkExec permet d'optimiser les
performances lors des oprations dfinies sur les donnes, dans votre Salesforce.com.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion
adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Consumer Key et Consumer Saisissez les dtails de votre authentification OAuth. Ces
Secret informations sont disponibles dans la zone OAuth Settings de
l'application connecte cre sur le site Salesforce.com.
Advanced settings Rows to commit Saisissez le nombre de lignes devant tre traites par lot de
donnes.
Bytes to commit Saisissez le nombre d'octets par lot de donnes devant tre traits.
Concurrency mode Mode de simultanit pour le Job :
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis comme composant de sortie. Il ncessite un composant d'entre.
Limitation Les donnes de masse traiter dans Salesforce.com doivent tre au format .csv
Avant de raliser ce Job, vous devez prparer votre fichier d'entre, contenant les donnes devant tre traites par
le Job. Dans cet exemple, le fichier sforcebulk.txt, contient des informations relatives aux clients.
Configurer le Job
1. Glissez-dposez de la Palette dans l'espace de modlisation graphique un composant tFileInputDelimited,
un tSalesforceOutputBulkExec, et deux tLogRow.
3. Utilisez un lien Row > Main et un lien Row > Reject afin de connecter le tSalesforceOutputBulkExec aux
deux tLogRow respectifs.
2. Dans la liste Property Type, slectionnez Repository si vous avez dj stock votre connexion au serveur
Salesforce dans le nud Metadata de la vue Repository. Les proprits sont automatiquement renseignes.
Si vous n'avez pas dfini la connexion au serveur localement dans le Repository, remplissez les champs
manuellement, aprs avoir slectionn Built-in dans la liste Property Type.
Pour plus d'informations concernant la cration des mtadonnes de fichier dlimit, consultez le Guide
utilisateur du Studio Talend.
3.
A ct du champ File name/Stream, cliquez sur le bouton afin de slectionner votre fichier d'entre,
par exemple sforcebulk.txt.
4. Dans la liste Schema, slectionnez Repository, puis cliquez sur le bouton [...] pour ouvrir une bote de
dialogue dans laquelle vous pourrez slectionner le schma utiliser pour ce composant. Si vous n'avez pas
dfini votre schma localement dans les mtadonnes, slectionnez Built-in dans la liste Schema, puis cliquez
sur le bouton [...] ct du champ Edit schema, afin d'ouvrir une bote de dialogue o vous pourrez dfinir le
schma manuellement. dans ce scnario, le schma se compose de quatre colonnes : Name, ParentId, Phone
et Fax.
5. Configurez les autres proprits selon votre fichier d'entre, comme Row Separator, Field Separator...
2. Dans le champ Salesforce WebService URL, utilisez l'URL par dfaut du service Web Salesforce, ou
saisissez l'URL laquelle vous souhaitez accder.
3. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au
service Web.
4. Dans le champ Bulk file path, parcourez votre rpertoire jusqu' l'emplacement o vous stockez les donnes
.csv devant tre traites.
5. Dans la liste Action, slectionnez l'action effectuer sur les donnes de masse, insert dans cet exemple.
6. Dans la liste Module, slectionnez l'lment auquel vous souhaitez accder, Account dans cet exemple.
7. Dans la liste Schema, slectionnez Repository, puis cliquez sur le bouton [...] afin d'ouvrir une bote de
dialogue dans laquelle vous pourrez slectionner le schma du Repository utiliser pour ce composant. Si
vous n'avez pas dfini votre schma localement dans les mtadonnes, slectionnez Built-in dans la liste
Schema, puis cliquez sur le bouton [...] ct du champ Edit schema afin d'ouvrir une bote de dialogue o
vous pourrez dfinir manuellement le schma. Dans cet exemple, dfinissez le schma comme prcdemment.
Excuter le Job
1. Double-cliquez sur le tLogRow_1 afin d'afficher sa vue Component et dfinir ses proprits.
2. Cliquez sur le bouton Sync columns afin de rcuprer le schma du composant prcdent.
3. Slectionnez le mode Table afin d'afficher les rsultats d'excution dans un tableau.
Dans la console de la vue Run, vous pouvez vrifier les rsultats d'excution.
Dans le tableau du tLogRow_1, vous pouvez lire les donnes insres dans Salesforce.com.
Dans le tableau du tLogRow_2, vous pouvez lire les donnes rejetes cause d'une incompatibilit avec les
lments Account auxquels vous avez accd.
Si vous souhaitez transformer les donnes d'entre avant de les charger, vous devez utiliser un
tSalesforceOutputBulk et un tSalesforceBulkExec pour raliser le Job complet. Pour plus d'informations
propos de l'utilisation de ces deux composants, consultez Scnario : Insrer des donnes de masse
transformes dans votre Salesforce.com.
tSalesforceWaveBulkExec
Proprits du tSalesforceWaveBulkExec
Famille de composant Business/Salesforce
Fonction Le tSalesforceWaveBulkExec charge des donnes dans Salesforce Analytics Cloud partir d'un fichier
CSV local.
Objectif Ce composant permet de charger des donnes dans Salesforce Analytics Cloud partir d'un fichier local.
Basic settings Property Type Peut tre Built-In ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
User Name et Password Saisissez les dtails d'authentification du service Web.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
End Point Saisissez l'URL du WebService ncessaire pour se connecter Salesforce,
https://login.salesforce.com/services/Soap/u/32.0 par exemple. Notez que la
version dans l'URL doit tre 32.0 ou ultrieure.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (Built-in),
soit distant dans le Repository.
Pour les champs de type numrique (par exemple byte, short, int, long, float,
double et BigDecimal), vous devez spcifier leur valeurs de longueur et de
prcision. dans l'diteur de schma. Les valeurs par dfaut de longueur et
prcision sont respectivement 10 et 2, mais vous pouvez spcifiez des valeurs
personnalises dans l'diteur du schma.
Pour les champs de type date, vous devez spcifier le format de la date dans
l'diteur de schma. Pour plus d'informations concernant les formats de date
supports, consultez Analytics Cloud External Data Format Reference (en
anglais).
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Upsert : Insre ou met jour des lignes dans l'ensemble de donnes. Cre
un ensemble de donnes s'il n'existe pas.
Vous devez spcifier une (et seulement une) colonne en tant que
cl primaire sur laquelle l'opration Upsert ou Delete est base.
Vous pouvez le faire en cliquant sur Edit schema et en cochant la
case situe ct de la colonne que vous souhaitez dfinir en tant
que cl primaire.
Cette case est disponible uniquement lorsque la case Auto Generate JSON
Metadata Description n'est pas coche.
Cette case est disponible uniquement lorsque la case Custom JSON Metadata
est coche.
Folder Spcifiez le rpertoire dans lequel vous souhaitez stocker le fichier de
mtadonnes JSON gnr.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone.
Scnario associ
Pour un scnario associ, consultez Scnario : Insrer des donnes de masse transformes dans votre
Salesforce.com.
tSalesforceWaveOutputBulkExec
Proprits du tSalesforceWaveOutputBulkExec
Famille de composant Business/Salesforce
Fonction Le composant tSalesforceWaveOutputBulkExec reoit des donnes depuis le composant prcdent,
gnre un fichier CSV local, puis charge les donnes de ce fichier sur Salesforce Analytics Cloud.
Objectif En tant que composant ddi, il permet de gagner en performance durant les oprations de donnes sur
Salesforce Analytics Cloud.
Basic settings Property Type Peut tre Built-In ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
User Name et Password Saisissez les dtails d'authentification du service Web.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
End Point Saisissez l'URL du WebService ncessaire pour se connecter Salesforce,
https://login.salesforce.com/services/Soap/u/32.0 par exemple. Notez que la
version dans l'URL doit tre 32.0 ou ultrieure.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (Built-in),
soit distant dans le Repository.
Pour les champs de type numrique (par exemple byte, short, int, long, float,
double et BigDecimal), vous devez spcifier leur valeurs de longueur et de
prcision. dans l'diteur de schma. Les valeurs par dfaut de longueur et
prcision sont respectivement 10 et 2, mais vous pouvez spcifiez des valeurs
personnalises dans l'diteur du schma.
Pour les champs de type date, vous devez spcifier le format de la date dans
l'diteur de schma. Pour plus d'informations concernant les formats de date
supports, consultez Analytics Cloud External Data Format Reference (en
anglais).
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Upsert : Insre ou met jour des lignes dans l'ensemble de donnes. Cre
un ensemble de donnes s'il n'existe pas.
Vous devez spcifier une (et seulement une) colonne en tant que
cl primaire sur laquelle l'opration Upsert ou Delete est base.
Vous pouvez le faire en cliquant sur Edit schema et en cochant la
case situe ct de la colonne que vous souhaitez dfinir en tant
que cl primaire.
Ce champ est disponible uniquement lorsque la case Custom the flush buffer
size est coche.
Don't generate empty file Cochez cette case si vous ne souhaitez pas gnrer de fichier vide.
SalesforceWave Auto Generate JSON Cochez cette case pour gnrer automatiquement la description des
Metadata Descriptor Metadata Description mtadonnes JSON.
Header Spcifiez le nombre de lignes ignorer dans le fichier CSV.
Cette case est disponible uniquement lorsque la case Custom JSON Metadata
est coche.
Folder Spcifiez le rpertoire dans lequel vous souhaitez stocker le fichier de
mtadonnes JSON gnr.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est principalement utilis lorsqu'aucune transformation particulire n'est requise sur les
donnes charger sur Salesforce Analytics Cloud.
Scnario associ
Pour un scnario associ, consultez Scnario : Insrer des donnes de masse dans votre Salesforce.com.
tSAPBWInput
Proprits du tSAPBWInput
Famille de composant Business
Fonction Le composant tSAPBWInput lit des donnes dans une base de donnes SAP BW l'aide d'une
connexion API JDBC et extrait des champs selon une requte SQL.
Objectif Ce composant excute une requte SQL dans un ordre strictement dfini devant correspondre
la dfinition de votre schma. Il passe ensuite la liste des champs au composant suivant via
un lien Main > Row.
Basic settings Property type Peut tre Built-in ou Repository
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes SAP
BW via une connexion JDBC.
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer
le studio, dans le Guide d'installation et de migration Talend.
Avant de configurer votre Job, assurez-vous que les prrequis suivants sont respects :
1. Vous devez copier les fichiers .jar suivants composant le pilote jdbc4olap dans le chemin d'accs votre classe :
- activation.jar
- commons-codec.jar
- jdbc4olap.jar
- saaj-api.jar
- saaj-impl.jar
2. Assurez-vous d'avoir la dernire version du pilote jdbc4olap. Vous pouvez tlcharger la dernire version du
pilote jdbc4olap sur jdbc4olap download section (en anglais). Pour plus d'informations concernant l'utilisation
du pilote jdbc4olap, consultez le Guide jdbc4olap User Guide (en anglais).
1. Configurez le Job.
Configurer le Job
1. Dposez un composant tSAPBWInput et un tLogRow de la Palette dans l'espace de modlisation graphique.
Notez que l'URL ci-dessus est uniquement affiche dans un but de dmonstration.
3. Dans les champs Username et Password, saisissez respectivement votre identifiant et votre mot de passe
d'authentification la base de donnes.
4. Cliquez sur le bouton [...] ct du champ Edit schema pour dfinir le schma utiliser.
5. Cliquez sur le bouton [+] pour ajouter de nouvelles colonnes au schma et dfinissez le type de donnes pour
chaque colonne et cliquez sur OK afin de sauvegarder vos paramtres.
2. Dans le champ Query, saisissez le script de la requte. Dans cet exemple, saisissez :
"SELECT
T1.\"[0D_CO_CODE].[LEVEL01]\" AS company,
T0.\"[Measures].[D68EEPGGHUMSZ92PIJARDZ0KA]\" AS amount
FROM
\"0D_DECU\".\"0D_DECU/PRE_QRY4\".\"[Measures]\" T0,
\"0D_DECU\".\"0D_DECU/PRE_QRY4\".\"[0D_CO_CODE]\" T1 "
Les requtes SQL supportes tant limites, les scripts de requtes utiliser doivent tre bass sur la grammaire dfinie
dans le pilote jdbc4olap. Pour plus d'informations concernant cette grammaire, consultez le guide jdbc4olap User
Guide (en anglais).
2. Cliquez sur le bouton Sync columns pour rcuprer le schma dfini dans le composant prcdent.
4. Appuyez sur Ctrl+S pour sauvegarder votre Job et appuyez sur F6 pour l'excuter.
tSAPCommit
Proprits du tSAPCommit
Famille de composant Business/SAP
Fonction Valide les donnes traites dans un Job, via un serveur connect.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Basic settings SAPConnection Component S'il y a plus d'une connexion dans le Job en cours, slectionnez le
list composant tSAPConnection dans la liste.
Release Connection Cette case est slectionne par dfaut. Elle vous permet de fermer
une connexion une base de donnes, une fois le commit effectu;
Dcochez cette case afin de continuer utiliser la connexion
slectionne, une fois que le composant a excut sa tche.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez
une variable de contexte afin de slectionner dynamiquement votre connexion SAP parmi celles
prvues dans votre Job.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants SAP et notamment avec les
composants tSAPConnection et tSAPRollback.
Scnario associ
Pour un scnario associ au tSAPCommit, consultez Scnario 1 : Insrer des donnes dans des tables mre/fille.
tSAPConnection
Proprits du tSAPConnection
Famille de composant Business
Fonction Le composant tSAPConnection ouvre une connexion vers un systme SAP afin d'effectuer
une transaction.
Objectif Ce composant permet de commiter les donnes d'un Job entier en une seule transaction vers
un systme SAP.
Basic settings Property type Peut tre Built-in ou Repository
Si la case est coche mais que SAPGUI n'est pas install, des
erreurs vont subvenir.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis avec les composants SAP, notamment les composants
tSAPCommit et tSAPRollback.
Scnario associ
Pour un scnario associ, consultez Scnario 1 : Rcuprer les mtadonnes d'un systme SAP.
tSAPInput
Proprits du tSAPInput
Famille de composant Business Ce composant est dprci.
Fonction Le composant tSAPInput se connecte un systme SAP via l'adresse IP du systme.
Objectif Il permet d'extraire des donnes d'un systme SAP n'importe quel niveau en faisant appel
des fonctions RFC ou BAPI.
Basic settings Property type Peut tre Built-in ou Repository.
ftp and http based programs Pour invoquer du serveur SAP une fonction ncessitant le
tlchargement d'un document, cochez cette case et assurez-vous
que SAPGUI a bien t install avec votre systme SAP.
Si la case est coche mais que SAPGUI n'est pas install, des
erreurs vont subvenir.
Row : Iterate
Pour plus d'informations concernant les connexions, consultez le Guide utilisateur du Studio
Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient.
Cette variable est une variable After et retourne une chane de caractres. Cette variable
fonctionne uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de dbut et requiert un composant
de sortie.
Ce scnario utilise l'assistant SAP guidant l'utilisateur travers les diffrentes tapes de cration de connexions SAP et des
fonctions RFC et BAPI. L'assistant SAP est disponible uniquement pour les utilisateurs ayant souscrit l'une des solutions
Talend. Sinon, dposez de la Palette le composant tSAPInput et configurez ses proprits manuellement.
Ce scnario utilise un assistant SAP pour crer une connexion au systme SAP, appelle une fonction BAPI pour
rcuprer les informations d'une entreprise stockes dans le systme SAP et les affiche dans le Studio Talend.
Les captures d'cran ci-dessous affichent les paramtres du systme SAP permettant d'accder aux informations
sur l'entreprise que vous souhaitez lire dans le Studio Talend l'aide du composant tSAPInput.
2. Appelez la fonction BAPI appele BAPI_COMPANY_GETDETAIL l'aide de l'assistant SAP pour accder
au document HTML BAPI stock dans le systme SAP et consultez les informations sur l'entreprise.
3. Dans le champ Name filter, saisissez BAPI* et cliquez sur le bouton Search pour afficher toutes les fonctions
BAPI disponibles.
La vue Parameter fournit les informations sur les paramtres d'entre et de sortie ncessaire la fonction
BAPI_COMPANY_GETDETAIL pour retourner les valeurs.
1. Dans la vue Parameter, cliquez sur l'onglet Input pour lister le ou les paramtre(s) d'entre. Dans ce scnario,
il n'y a qu'un seul paramtre d'entre requis par la fonction BAPI_COMPANY_GETDETAIL. Ce paramtre
s'appelle COMPANYID.
2. Dans la vue Parameter, cliquez sur l'onglet Output pour lister les paramtres de sortie retourns
par la fonction BAPI_COMPANY_GETDETAIL. Dans ce scnario, il y a deux paramtres de sortie :
COMPANY_DETAIL et RETURN.
La vue Test it permet d'ajouter ou de supprimer des paramtres d'entre en fonction de la fonction
appele. Dans ce scnario, l'objectif est de rcuprer les mtadonnes du paramtre "structure" appel
COMPANY_DETAIL qui est compos de 14 paramtres "single".
3. Dans la colonne Value de la ligne COMPANYID du premier tableau, saisissez "000001" afin de retourner
les donnes correspondant l'entreprise dont l'identifiant est 000001.
5. Cliquez sur Launch en bas de la vue pour afficher la valeur de chaque paramtre "single" retourn par la
fonction BAPI_COMPANY_GETDETAIL.
2. Dans l'assistant qui s'ouvre, slectionnez les schmas que vous souhaitez rcuprer. Ici, slectionnez les deux
schmas : COMPANY_DETAIL et RETURN.
3. Cliquez sur Next pour afficher ces diffrents schmas puis cliquez sur Finish pour ferme la bote de dialogue.
1. Dans le Repository, slectionnez la connexion SAP que vous venez de crer et glissez-la dans l'espace de
modlisation, slectionnez tSAPConnection dans la liste de composants et cliquez sur OK. Le composant
tSAPConnection portant le nom de votre connexion, sap, sera ajout votre Job et ouvrira une connexion
SAP.
2. Double-cliquez sur le tSAPConnection pour afficher la vue Component et dfinir ses proprits :
Si vous avez utilis les mtadonnes pour crer le composant, le mode Repository est slectionn dans la liste
Property Type et les champs suivants sont automatiquement renseigns. Si vous n'utilisez pas les mtadonnes,
slectionnez le mode Built-In et renseignez les champs suivants manuellement.
3. Dans le Repository, droulez le nud Metadata, puis sap et glissez le schma RFC_READ_TABLE dans
l'espace de modlisation pour ouvrir une liste de composants.
7. Pour connecter le tSAPInput au tLogRow, cliquez-droit sur le tSAPInput, slectionnez Row puis
row_COMPANY_DETAIL_1 dans le menu et cliquez sur le composant tLogRow.
8. Dans l'espace de modlisation, slectionnez le composant tSAPInput et cliquez sur la vue Component pour
afficher ses proprits.
Les proprits du composant tSAPInput apparaissent automatiquement puisque le schma est stock dans
le dossier Metadata et que le composant est initialis par l'assistant SAP.
9. Cochez la case Use an existing connection et slectionnez le composant tSAPConnection dans la liste
Component list pour utiliser la connexion ouverte par le composant de connexion, ici sap.
Dans la zone Initialize input, vous pouvez voir les paramtres d'entre ncessaires la fonction
BAPI_COMPANY_GETDETAIL.
Dans la zone Outputs, vous pouvez voir les diffrents schmas de la fonction BAPI_COMPANY_GETDETAIL,
notamment le schma COMPANY_DETAIL que vous rcuprez en sortie.
Excuter le Job
1. Dans l'espace de modlisation, slectionnez le composant tLogRow et cliquez sur la vue Component pour
paramtrer ses proprits. Pour plus d'informations, consultez tLogRow.
Le composant tSAPInput rcupre du systme SAP les mtadonnes du paramtre COMPANY_DETAIL de type
"structure" et le composant tLogRow affiche les informations dans la console.
Ce scnario utilise l'assistant SAP guidant l'utilisateur travers les diffrentes tapes de cration de connexions SAP et des
fonctions RFC et BAPI. L'assistant SAP est disponible uniquement pour les utilisateurs ayant souscrit l'une des solutions
Talend. Sinon, dposez de la Palette le composant tSAPInput et configurez ses proprits manuellement.
Ce scnario Java utilise l'assistant SAP pour crer une connexion au systme SAP et pour appeler une fonction
RFC permettant de lire directement dans une table appele SFLIGHT partir du systme SAP. Puis, il affiche
dans le Studio Talend les diffrentes structures de la table SFLIGHT stocke dans le systme SAP.
2. Appelez la fonction RFC appele RFC_READ_TABLE l'aide de l'assistant SAP pour accder la table du
systme SAP et pour visualiser sa structure.
3. Dans le champ Name filter, saisissez RFC* et cliquez sur le bouton Search pour afficher toutes les fonctions
RFC disponibles.
La vue droite de l'assistant affiche les mtadonnes de la fonction RFC_READ_TABLE et permet de dfinir les
paramtres ncessaires.
L'onglet Parameter fournit les informations sur les paramtres requis par la fonction RFC_READ_TABLE pour
pouvoir retourner les valeurs des paramtres.
1. Dans la vue Parameter, cliquez sur l'onglet Table pour obtenir une description de la structure des diffrentes
tables de la fonction RFC_READ_TABLE.
La vue Test it vous permet d'ajouter ou de supprimer des paramtres d'entre en fonction de la fonction
appele. Dans ce scnario, l'objectif est de rcuprer les diffrentes structures de la table SFLIGHT.
2. Dans la colonne Value de la ligne DELIMITER du premier tableau, saisissez ";" comme sparateur de
champ.
3. Dans la colonne Value de la ligne QUERY_TABLE, saisissez SFLIGHT comme table requter.
6. Cliquez sur Launch en bas de la vue pour afficher les valeurs de paramtres retournes par la fonction
RFC_READ_TABLE. Dans ce scnario, le dlimiteur est ";" et la table lire est SFLIGHT.
1. Cliquez-droit sur RFC_READ_TABLE dans le Repository, et slectionnez Retrieve schema dans le menu.
2. Dans l'assistant qui s'ouvre, slectionnez les schmas que vous souhaitez rcuprer. Ici, slectionnez les trois
schmas : DATA, FIELDS et OPTIONS.
Construire le Job
3. Cliquez-droit sur le tSAPInput, slectionnez Row puis row_DATA_1 dans le menu et cliquez sur le premier
composant tLogRow.
4. Cliquez-droit sur le tSAPInput, slectionnez Row puis row_FIELDS_1 dans le menu et cliquez sur le
deuxime composant tLogRow.
L'objectif de ce scnario est de rcuprer les schmas FIELDS et DATA et les mettre dans deux flux de
sortie diffrents.
5. Dans l'espace de modlisation, double-cliquez sur tSAPInput pour afficher ses proprits dans la vue
Component.
Les proprits du composant tSAPInput apparaissent automatiquement puisque le schma est stock dans
le dossier Metadata et que le composant est initialis par l'assistant SAP.
Dans la zone Initialize input, vous pouvez voir les paramtres d'entre ncessaires pour la fonction
RFC_READ_TABLE, savoir le sparateur de champ ";" et le nom de la table SFLIGHT.
Dans la zone Outputs, vous pouvez voir les diffrents schmas de la table SFLIGHT.
Excuter le job
1. Dans l'espace de modlisation, slectionnez les composants tLogRow et cliquez sur la vue Component pour
paramtrer leurs proprits. Pour plus d'informations, consultez tLogRow.
2. Appuyez sur CTRL+S pour enregistrer votre Job, puis sur F6 pour l'excuter.
Le composant tSAPInput rcupre le nom des colonnes de la table SFLIGHT et les donnes correspondantes
partir du systme SAP et les composants tLogRow les affichent sous forme de table dans la console.
le tLogRow : affiche les donnes qu'il reoit du composant prcdent dans la console.
2. Slectionnez la version de SAP Java Connector que vous utilisez dans la liste droulante SAP JCO Version.
Dans cet exemple, il s'agit de sap jco 3.*.
3. Renseignez les champs de configuration de connexion avec vos informations de connexion au systme SAP.
Pour plus de dtails concernant les paramtres de connexion, consultez le tSAPConnection
2. Cochez la case Use an existing connection, puis slectionnez la connexion que vous avez configure
auparavant dans la liste droulante Connection configuration. Dans cet exemple, il s'agit de
tSAPConnection_1.
Si vous n'utilisez pas de composant tSAPConnection, vous devez renseigner tous les paramtres de
connexion dans les champs du composant tSAPInput prvus cet effet.
3. Dans le champ FunName, saisissez le nom de la fonction SAP. Dans cet exemple, il s'agit de la fonction
RFC_READ_TABLE qui permet de lire les donnes de la table SAP.
4. Dans la table Initialize input, cliquez deux fois sur le bouton [+] pour ajouter deux paramtres d'entre
(indiqus ci-dessous) requis par la fonction laquelle vous faites appel, puis dfinissez leurs valeurs
ParameterValue, Type et ParameterName.
DELIMITER : le sparateur de champ dans les donnes crites. Il s'agit d'un paramtre de type input_single,
";" dans cet exemple.
5. Dans la table Outputs, cliquez sur le bouton [+] pour ajouter une ligne au schma des donnes crites
retournes par la fonction appele.
6. Dans la cellule TableName de la nouvelle ligne ajoute, saisissez le nom de la table partir de laquelle
rcuprer les donnes. Dans cet exemple, il s'agit de la table "DATA".
7. Dans la cellule Type de la nouvelle ligne ajoute, slectionnez table_output dans la liste droulante.
8. Slectionnez la cellule Schema de la nouvelle ligne ajoute et cliquez sur le bouton [...] dans la cellule pour
ouvrir la bote de dialogue [Give the name for the schema]. Renseignez le champ Schema Name,output
dans cet exemple.
9. Dans la bote de dialogue qui s'ouvre, cliquez sur le bouton [+] pour ajouter une colonne, WA de type String
dans cet exemple.
10. Slectionnez la cellule Mapping de la nouvelle ligne ajoute et cliquez sur le bouton [...] dans la cellule pour
ouvrir la bote de dialogue Mappings. Dans la cellule Schema XPathQuerys, saisissez la requte XPath.
Dans cet exemple, il s'agit de "WA".
Les donnes correspondantes dans l'un des schmas DATA de la table SFLIGHT sont affiches dans la
console.
tSAPOutput
Proprits du tSAPOutput
Famille de composant Business Ce composant est dprci.
Fonction Le composant tSAPOutput crit dans un systme SAP.
Objectif Il permet d'crire des donnes dans un systme SAP.
Basic settings Property type Peut tre Built-in ou Repository
Si la case est coche mais que SAPGUI n'est pas install, des
erreurs vont subvenir.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de sortie et requiert un composant
d'entre.
Scnarios associs
Aucun scnario n'est disponible pour ce composant.
tSAPRollback
Proprits du tSAPRollback
Famille de composant Business/SAP
Fonction Le composant tSAPRollback annule la transaction dans le SAP connect.
Objectif Le tSAPRollback vite le commit de transaction involontaire.
Basic settings SAPConnection Component Slectionnez le composant de connexion tSAPConnection dans la
list liste si vous prvoyez d'ajouter plus d'une connexion votre Job en
cours.
Release Connection Dcochez cette case afin de continuer utiliser la connexion
slectionne, une fois que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez
une variable de contexte afin de slectionner dynamiquement votre connexion SAP parmi celles
prvues dans votre Job.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants SAP et notamment avec les
composants tSAPConnection et tSAPCommit.
Scnario associ
Pour un scnario associ au tSAPRollback, consultez Scnario : Annuler l'insertion de donnes dans des tables
mre/fille du composant tMysqlRollback.
tSugarCRMInput
Proprits du tSugarCRMInput
Famille du composant Business/Cloud
Fonction Le tSugarCRMInput se connecte un module de la base de donnes SugarCRM via le service
Web adquat.
Objectif Le tSugarCRMInput permet d'extraire les donnes d'une base de donnes SugarCRM l'aide
d'une requte.
Basic settings SugarCRM Webservice Saisissez l'URL du service Web permettant de se connecter la
URL base de donnes SugarCRM.
Username et Password Saisissez les informations d'authentification de l'utilisateur au
service Web.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie
est ncessaire.
Configurer le Job
1. A partir de la Palette, cliquez-dposez un composant tSugarCRMInput et un composant tFileOutputExcel.
2. Connectez les composants d'entre et de sortie l'aide d'un lien de type Row > Main.
2. Remplissez les informations de connexion dans les champs SugarCRM Web Service URL, Username et
Password.
3. Slectionnez ensuite le module adquat parmi ceux proposs dans la liste Module. Dans cet exemple,
c'est Accounts qui est slectionn.
Le champ Schema est automatiquement renseign en fonction du module slectionn, mais il est possible de
le modifier et de supprimer les colonnes dont vous n'avez pas besoin en sortie.
4. Dans le champ Query Condition, saisissez la requte que vous voulez utiliser pour extraire les donnes du
CRM. Dans cet exemple : "billing_address_city='Sunnyvale'".
Excuter le Job
1. Slectionnez ensuite le composant tFileOutputExcel.
2. Renseignez le nom du fichier de destination dans le champ File Name ainsi que le nom de la feuille de calcul
dans le champ Sheet puis cochez la case Include header pour considrer les enttes.
Les donnes filtres sont inscrites en sortie dans la feuille de calcul du fichier Excel spcifi.
tSugarCRMOutput
Proprits du tSugarCRMOutput
Famille du composant Business/Cloud
Fonction Le composant tSugarCRMOutput crit dans un module de la base de donnes SugarCRM
via le service Web adquat.
Objectif Le tSugarCRMOutput permet d'crire des donnes dans une base de donnes SugarCRM.
Basic settings SugarCRM WebService Saisissez l'URL du service Web permettant de se connecter la
URL base de donnes SugarCRM.
Username et Password Saisissez les informations d'authentification de l'utilisateur au
service Web.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de
sortie. Cette variable est une variable After et retourne un entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis comme composant de sortie. Il ncessite un composant d'entre.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tVtigerCRMInput
Proprits du tVtigerCRMInput
Famille du composant Business/VtigerCRM
Fonction Le tVtigerCRMInput se connecte un module de la base de donnes vTigerCRM via le
service Web adquat.
Objectif Le tVtigerCRMInput permet d'extraire les donnes d'une base de donnes tVtigerCRM.
Basic settings
Vtiger Version Slectionnez la version du Vtiger Web Services que vous souhaitez utiliser.
Vtiger 5.0 Server Address Saisissez l'adresse IP du serveur VtigerCRM.
Port Saisissez le numro de port d'accs au serveur.
Vtiger Path Saisissez le chemin d'accs au serveur
Username et Password Saisissez les informations d'authentification de l'utilisateur au
service Web.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie
est ncessaire.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tVtigerCRMOutput
Proprits du tVtigerCRMOutput
Famille du composant Business/VtigerCRM
Fonction Le composant tVtigerCRMOutput crit dans un module de la base de donnes VtigerCRM
via le service Web adquat.
Objectif Le tVtigerCRMOutput permet d'crire des donnes dans une base de donnes VtigerCRM.
Basic settings
Vtiger Version Slectionnez la version du Vtiger Web Services que vous souhaitez utiliser.
Vtiger 5.0 Server Address Saisissez l'adresse IP du serveur VtigerCRM.
Port Saisissez le numro de port d'accs au serveur.
Vtiger Path Saisissez le chemin d'accs au serveur.
Username et Password Saisissez les informations d'authentification de l'utilisateur au
service Web.
Action Vous pouvez effectuer l'une des oprations suivantes sur les
donnes du module VtigerCRM :
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis comme composant de sortie. Il ncessite un composant d'entre.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
La famille BI regroupe tous les connecteurs couvrant des besoins tels que la lecture et l'criture de bases de donnes
multidimensionnelles ou OLAP, la gnration de rapports Jasper, le suivi des modifications de bases de donnes
l'aide de tables Slow Changing Dimension, etc.
tBarChart
Proprits du tBarChart
Famille du composant Business Intelligence/Charts
Fonction Le composant tBarChart lit des donnes partir d'un flux d'entre et transforme les donnes en
diagramme en barres dans un fichier image au format PNG.
Objectif Le composant tBarChart gnre un diagramme en barres partir des donnes d'entre afin de
faciliter l'analyse technique.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Par consquent, il requiert un composant d'entre ainsi
qu'une connexion de type Row Main.
Le fichier d'entre ayant une structure diffrente de celle requise pour l'utilisation d'un tBarChart, un tMap sera
utilis dans ce scnario, afin de mettre en correspondance les donnes avec un fichier CSV trois colonnes, avant
d'utiliser le tBarChart pour gnrer un fichier reprsentant le diagramme en barres.
Le tMap est gnralement utilis afin d'adapter le schma d'entre conformment la structure du schma du composant
tBarChart. Pour plus d'informations concernant le composant tMap, consultez le Guide utilisateur du Studio Talend ainsi
que tMap.
2. Connectez le composant tPrejob un tFileDelete l'aide d'une connexion Trigger > On Component Ok
et connectez le composant tPostjob au second tFileDelete via le mme type de connexion.
3. Connectez le premier composant tFileInputDelimited au tMap l'aide d'une connexion Row > Main.
4. Connectez le composant tMap au premier tFileOutputDelimited l'aide d'une connexion Row > Main et
appelez-la Population.
5. Rptez les tapes ci-dessus pour connecter le composant tMap aux deux autres tFileOutputDelimited
l'aide d'une connexion Row > Main et appelez-les Area et Density.
6. Connectez le tFileInputDelimited au composant tBarChart l'aide d'un lien Row > Main.
3. Spcifiez dans le champ Header le nombre de lignes d'en-tte. Dans ce scnario, il n'y a qu'une seule ligne.
4. Cliquez sur Edit schema pour dcrire la structure des donnes du fichier d'entre. Dans ce scnario, le schma
d'entre est compos de quatre colonnes : City, Population, Area, et Density. Une fois les noms de colonnes
et les types de donnes dfinis, cliquez sur OK pour fermer la bote de dialogue du schma.
Vous pouvez voir une table d'entre dans le panneau d'entre, row1 dans cet exemple et dans le panneau de
sortie, trois tables de sortie vides appeles Population, Area et Density.
2. Utilisez l'diteur Schema editor pour ajouter trois colonnes chacune des tables de sortie : series (type
String), category (type String) et value (type Integer).
3. Dans le champ Expression de chaque table de sortie, saisissez le texte afficher dans la lgende du graphique,
dans cet exemple "Population (x1000 people)", "Land area (km2)", et "Population density
(people/km2)".
4. Dposez la colonne City de la table d'entre dans la colonne category de chaque table de sortie.
5. Dposez la colonne Population de la table d'entre dans la colonne value de la table Population.
6. Dposez la colonne Area de la table d'entre dans la colonne value de la table Area.
7. Dposez la colonne Density de la table d'entre dans la colonne value de la table Density.
8. Cliquez sur OK pour sauvegarder les mappings, fermer l'diteur et propager les schmas de sortie aux
composants de sortie.
2. Dans le champ File Name, dfinissez un fichier CSV dans lequel envoyer les flux de donnes mapps. Dans
cet exemple, nommez le fichier de sortie crer Temp.csv. Ce fichier sera utilis comme fichier d'entre pour
le composant tBarChart.
4. Dfinissez les paramtres des deux autres composants tFileOutputDelimited exactement de la mme
manire que le premier tFileOutputDelimited.
Notez que l'ordre des flux de donnes sortant du composant tMap n'est pas ncessairement l'ordre dans lequel les
donnes seront crites dans le composant cible. Pour vous assurer que le fichier est correctement gnr, supprimez,
s'il existe, le fichier portant le mme nom avant d'excuter le Job. Vrifiez que la case Append est coche dans tous
les composants tFileOutputDelimited afin que tous les flux de donnes mapps aillent dans le mme fichier, sans
craser les donnes existantes.
2. Renseignez le champ File name avec le chemin d'accs au fichier, ainsi que son nom, comme dfini dans
chaque composant tFileOutputDelimited. Dans cet exemple, le fichier d'entre est LargeCities_mapped.csv.
4. Dans le champ Generated image path, renseignez le chemin d'accs du fichier image gnrer.
7. Si ncessaire, dfinissez la taille (la largeur dans le champ Image Width, la hauteur dans le champ Image
height) et le degr de transparence de l'image (dans le champ Foreground alpha). Dans ce scnario, laissez
les paramtres par dfaut.
9. Copiez toutes les colonnes du schma de sortie dans le schma d'entre en cliquant sur la double-flche
pointant vers la gauche.
1. Double-cliquez sur le premier composant tFileDelete pour afficher sa vue Basic settings.
Si la case Fail on error est coche et que le sous-job de pr-traitement choue cause d'erreurs (par exemple le fichier
supprimer n'existe pas), l'chec empche le lancement du sous-job principal. Dans cette situation, dcochez la case
Fail on error pour viter cette interruption.
tDB2SCD
Proprits du tDB2SCD
Famille du Databases/Business
composant Intelligence/DB2
Fonction Le composant tDB2SCD reflte et traque les modifications d'une table DB2 SCD ddie.
Objectif Le tDB2SCD rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une
source de donnes et en rpertoriant les modifications dans une table SCD ddie.
Basic settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Table schema Nom du schma de la base de donnes.
Username et Informations d'authentification de l'utilisateur de la base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans la
bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis cliquez
sur OK afin de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
schema et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
End date time Spcifiez la valeur de temps du paramtre de date et heure de fin du SCD au format
details HH:mm:ss. La valeur par dfaut pour ce champ est 12:00:00.
Ce champ apparat uniquement lorsqu'un SCD de Type 2 est utilis et lorsque Fixed year
value est slectionn pour crer la date de fin du SCD. Pour plus d'informations concernant
le SCD de Type 2, consultez Mthodologie de gestion du SCD.
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type
Row Main en entre.
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tDB2SCDELT
Proprits du tDB2SCDELT
Famille du Databases/Business
composant Intelligence/DB2
Fonction Le composant tDB2SCDELT reflte et traque les modifications d'une table DB2 SCD ddie.
Objectif Le tDB2SCDELT rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement
une source de donnes et en rpertoriant les modifications dans une table DB2 SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Pour plus d'informations concernant les mthodes de cration, consultez Cls SCD.
Source Keys Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer l'unicit des
donnes entrantes.
Source fields value Cochez cette case pour autoriser les valeurs Nulls dans les colonnes source.
include Null
Les colonnes source font rfrence aux champs dfinis dans les tables SCD type
1 fields et SCD type 2 fields.
Use SCD Type 1 Utilisez le type 1 si vous n'avez pas besoin de traquer les modifications, pour des corrections
fields typographiques par exemple. Slectionnez les colonnes du schma qui servira de rfrence
pour les modifications.
Use SCD Type 2 Utilisez le type 2 si vous avez besoin de traquer les modifications, pour garder une trace
fields des mises jour effectues par exemple. Slectionnez les colonnes du schma qui servira
de rfrence pour les modifications.
Start date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date
de dpart. Vous pouvez slectionner l'une des colonnes d'entre du schma comme date de
dpart (Start Date) dans la table SCD.
End Date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date
de fin pour le journal. Lorsque le journal est en mode actif, la colonne End Date a une
valeur nulle ; pour viter cela, vous pouvez slectionner l'option Fixed Year value et saisir
une anne fictive.
Log Active Status : Ajoute une colonne votre schma SCD pour renseigner les valeurs
de statut true et false. Cette colonne permet de reprer facilement le journal actif.
Log versions : Ajoute une colonne votre schma SCD pour renseigner le numro de
version du journal.
Advanced Additional JDBC Spcifiez des proprits de connexion supplmentaires pour la connexion la base de
settings parameters donnes que vous crez.
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
Variables une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie et une
connexion de type Row Main.
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez tDB2SCD et tMysqlSCD.
tGreenplumSCD
Proprits du tGreenplumSCD
Famille du Databases/Business
composant Intelligence/Greenplum
Fonction Le composant tGreenplumSCD reflte et traque les modifications d'une table Greenplum SCD ddie.
Objectif Le tGreenplumSCD rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement
une source de donnes et en rpertoriant les modifications dans une table SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis,
dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles,
puis cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Ce champ apparat uniquement lorsqu'un SCD de Type 2 est utilis et lorsque Fixed year
value est slectionn pour crer la date de fin du SCD. Pour plus d'informations concernant
le SCD de Type 2, consultez Mthodologie de gestion du SCD.
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job. Cette
fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure mais
se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement dans
lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et
excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide utilisateur
du Studio Talend.
Global NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est une
variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on error
est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type Row
Main en entre.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tInformixSCD
Proprits du tInformixSCD
Famille de Databases/
composant Business
Intelligence/
Informix
Fonction Le composant tInformixSCD reflte et traque les modifications d'une table Informix SCD ddie.
Objectif Le tInformixSCD rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement
une source de donnes et en rpertoriant les modifications dans une table SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
SCD Editor L'diteur SCD Editor permet de construire et de configurer les donnes du flux de sortie vers
la table Slowly Changing Dimension.
Ce champ apparat uniquement lorsqu'un SCD de Type 2 est utilis et lorsque Fixed year
value est slectionn pour crer la date de fin du SCD. Pour plus d'informations concernant le
SCD de Type 2, consultez Mthodologie de gestion du SCD.
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue Basic
settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type
Row Main en entre.
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tIngresSCD
Proprits du tIngresSCD
Famille de Databases/
composant Business
Intelligence/Ingres
Fonction Le composant tIngresSCD reflte et traque les modifications d'une table Ingres SCD ddie.
Objectif Le tIngresSCD rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une
source de donnes et en rpertoriant les modifications dans une table SCD ddie.
Basic settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Server Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Username et Informations d'authentification de l'utilisateur de la base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans la
bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis cliquez
sur OK afin de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
schema et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
SCD Editor L'diteur SCD Editor permet de construire et de configurer les donnes du flux de sortie vers
la table Slowly Changing Dimension.
Ce champ apparat uniquement lorsqu'un SCD de Type 2 est utilis et lorsque Fixed year
value est slectionn pour crer la date de fin du SCD. Pour plus d'informations concernant
le SCD de Type 2, consultez Mthodologie de gestion du SCD.
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Global NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type Row
Main en entre.
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tJasperOutput
Proprits du tJasperOutput
Ce composant est troitement li l'outil de reporting de Jaspersoft, iReport. Il lit et traite des donnes d'un flux
d'entre afin de crer un rapport l'aide d'un modle de rapport JRXML dfini dans iReport.
Advanced settings Specify Locale Cochez cette case afin de slectionner la langue de votre rapport dans
la liste Report Locale.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est troitement li l'outil de reporting de Jaspersoft, iReport. Il lit et traite des
donnes d'un flux d'entre afin de crer un rapport l'aide d'un modle de rapport JRXML dfini
dans iReport.
Vous pouvez slectionner Repository dans la liste Property Type afin de renseigner automatiquement les champs
correspondants si la mtadonne a t stocke localement dans le Repository. Pour plus d'informations concernant
les mtadonnes Metadata, consultez le Guide utilisateur du Studio Talend.
3. Renseignez le champ File name/Stream en saisissant le chemin d'accs et le nom du fichier source, par
exemple "C:/Documents and Settings/Andy ZHANG/nom.csv".
4. Laissez les paramtres par dfaut pour les champs Row Separator et Field Separator. Cependant, si
ncessaire, vous pouvez les modifier selon vos besoins.
5. Saisissez 1 dans le champ Header et 0 dans le champ Footer. Laissez le champ Limit vide. Cependant, si
ncessaire, vous pouvez les modifier selon vos besoins.
6. Slectionnez Built-In dans la liste droulante Schema puis cliquez sur Edit schema afin de dfinir la structure
des donnes du fichier d'entre. Dans ce cas, le fichier d'entre contient deux colonnes : Nom et Prenom.
2. Saisissez le chemin d'accs complet au fichier de modle du rapport cr via l'outil iReport de Jaspersoft dans
le champ Jrxml file. Vous pouvez galement cliquer sur le bouton [...] afin de parcourir votre systme.
Le schma du fichier utilis pour crer un modle .jrxml via iReport, doit tre le mme que celui du fichier source
utilis pour crer le rapport.
3. Dans le champ Temp path, saisissez le chemin d'accs aux fichiers temporaires gnrs durant l'excution
du Job. Vous pouvez galement cliquez sur le bouton [...] afin de parcourir votre systme.
4. Saisissez le chemin d'accs au rapport final gnr durant l'excution du Job, dans le champ Destination
path. Vous pouvez galement cliquer sur le bouton [...] afin de parcourir votre systme.
5. Saisissez le nom du rapport final gnr durant l'excution du Job, dans le champ File name/Stream.
8. Saisissez le chemin d'accs au fichier d'excution de iReport dans le champ iReport, en remplaant par
exemple __IREPORT_PATH__\ par E:\Program Files\Jaspersoft\iReport-4.1.1\bin\. Vous pouvez cliquer
sur le bouton Launch afin de lancer iReport.
Cette tape n'est pas obligatoire. Cependant, elle vous permet d'accder l'outil iReport pour effectuer les oprations
ncessaires, comme la cration d'un modle de rapport, etc.
tJasperOutputExec
Proprits du tJasperOutputExec
Ce composant est troitement li l'outil de reporting de Jaspersoft, iReport. Il lit et traite des donnes d'un fichier
afin de crer un rapport l'aide d'un modle de rapport .jrxml dfini via iReport. Ce composant permet un gain de
performance, car il est la combinaison d'un composant d'entre et d'un composant tJasperOutput. L'utilisation
de ces deux composants spars permet de transformer les donnes avant de les utiliser pour gnrer un rapport,
avec des sources riches et varies en entre.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est troitement li l'outil de reporting de Jaspersoft, iReport. Il lit et traite des
donnes partir d'un fichier source pour crer un rapport l'aide d'un modle de rapport .jrxml
dfini via iReport.
Scnario associ
Pour un scnario associ, consultez Scnario : Gnrer un rapport avec un modle .jrxml.
tLineChart
Proprits du tLineChart
Famille de composant Business Intelligence/Charts
Fonction Le composant tLineChart lit des donnes partir d'un flux d'entre et transforme les donnes en
graphique en lignes dans un fichier image au format PNG.
Objectif Le composant tLineChart gnre un graphique en lignes partir des donnes d'entre afin de
faciliter l'analyse technique.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie.
Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Par consquent, il requiert un composant d'entre ainsi
qu'une connexion de type Row Main.
Le fichier d'entre ayant une structure diffrente de celle requise pour l'utilisation d'un tLineChart, un tMap
sera utilis dans ce scnario, afin de mettre en correspondance les donnes avec un fichier CSV ayant la structure
requise, avant d'utiliser le tLineChart pour gnrer un fichier reprsentant le graphique en lignes.
Le tMap est gnralement utilis afin d'adapter le schma d'entre, conformment la structure du schma du composant
tLineChart. Pour plus d'informations concernant le composant tMap, consultez le Guide utilisateur du Studio Talend ainsi
que le composant tMap.
2. Connectez le premier composant tFileInputDelimited au tMap l'aide d'une connexion Row > Main.
3. Reliez le tMap au premier tFileOutputDelimited l'aide d'une connexion Row > Main et appelez-la TV_A.
4. Rptez l'tape ci-dessus : connectez le tMap aux deux composants tFileOutputDelimited restants l'aide
d'une connexion Row > Main et appelez-les respectivement TV_B et TV_C.
5. Connectez le composant tFileInputDelimited au tLineChart l'aide d'une connexion Row > Main. Cliquez
sur Yes pour valider la propagation du schma partir du composant cible.
8. Renommez les composants comme vous le souhaitez afin qu'ils dcrivent au mieux leur fonction.
2. Renseignez le chemin d'accs au fichier traiter dans le champ File name en parcourant votre rpertoire et
en slectionnant le fichier d'entre.
3. Spcifiez dans le champ Header le nombre de lignes d'en-tte, une dans ce scnario. Laissez les autres
paramtres tels qu'ils sont.
4. Cliquez sur Edit schema pour dcrire la structure des donnes du fichier d'entre. Dans ce scnario, le schma
d'entre est compos de quatre colonnes : Week, Mins_TVA, Mins_TVB, et Mins_TVC. Une fois le nom des
colonnes et les types de donnes dfinis, cliquez sur OK pour fermer la bote de dialogue du schma.
Le panneau de sortie contient une table d'entre, ici row1, et le panneau de sortie contient trois tables vides
nommes TV_A, TV_B et TV_C.
2. Utilisez l'diteur Schema editor pour ajouter trois colonnes chacune des tables de sortie : series (type
String), x (type Integer) et y (type Integer).
3. Dans le champ Expression de chaque table de sortie, saisissez les noms des series, comme indiqu ci-dessus.
Ces noms apparatront dans la lgende du graphique en lignes.
4. Dposez la colonne Week de la table d'entre dans la colonne x de chaque table de sortie.
8. Cliquez sur OK pour sauvegarder le mapping, fermer l'diteur et propager le schma de sortie au composant
de sortie.
2. Dans le champ File Name, dfinissez un fichier CSV dans lequel les flux de donnes mapps seront envoys.
Dans cet exemple, nommez le fichier de sortie crer Temp.csv. Ce fichier sera utilis comme fichier d'entre
pour le composant tLineChart.
4. Dfinissez les paramtres des deux autres composants tFileOutputDelimited exactement de la mme
manire que dans le premier tFileOutputDelimited.
Notez que l'ordre des flux de donnes sortant du composant tMap n'est pas ncessairement l'ordre dans lequel les
donnes seront crites dans le composant cible. Pour vous assurer que le fichier est correctement gnr, supprimez,
s'il existe, le fichier portant le mme nom avant d'excuter le Job. Vrifiez que la case Append est coche dans tous
les composants tFileOutputDelimited afin que tous les flux de donnes mapps aillent dans le mme fichier, sans
craser les donnes existantes.
Configurer le tLineChart
1. Double-cliquez sur le second composant tFileInputDelimited afin d'afficher son onglet Basic settings.
2. Saisissez, dans le champ File name, le chemin d'accs au fichier, ainsi que son nom, le mme que celui
dfini dans chaque composant tFileOutputDelimited. Dans cet exemple, le fichier d'entre du tLineChart
est Temp.csv.
5. Le schma d'entre et de sortie doivent tre synchroniss. Si besoin est, copiez toutes les colonnes du schma
de sortie dans le schma d'entre en cliquant sur la double-flche pointant vers la gauche. Cliquez sur OK
pour fermer la bote de dialogue du schma.
6. Dans le champ Generated image path, dfinissez le chemin d'accs du fichier image gnrer.
7. Dans le champ Chart title, saisissez un titre pour le graphique en lignes. Dans ce scnario, son titre
est Average Weekly Viewing (per person).
8. Saisissez un nom pour les axes (X) et (Y). Dans ce scnario, le nom des axes est respectivement Week
et Minutes.
9. Dfinissez comme vous le souhaitez la taille de l'image (dans les champs Image width pour la largeur et
Image height pour la hauteur), la priode dans laquelle est calcule la moyenne mobile (dans le champ Period
une fois la case Moving average coche), les limites infrieures et suprieures (respectivement dans les
champs Lower bound et Upper bound), ainsi que la couleur de fond du graphique et du plan (respectivement
dans les champs Chart background et Plot background).
Dans ce scnario, dfinissez la taille de l'image 450 by 450, paramtrez le champ Lower bound 210 et
Upper bound 340, slectionnez Light_gray dans la liste Chart background et laissez les autres paramtres
tels qu'ils sont.
2. Dans le champ File name, renseignez le chemin d'accs du fichier d'entre et dcochez la case Fail on error
pour permettre au Job principal d'tre excut si le fichier supprimer n'existe pas.
Excuter le Job
1. Appuyez sur Ctrl+S pour sauvegarder votre Job.
Un graphique en lignes est gnr selon les critres dfinis. Il affiche une comparaison du temps de visionnage
moyen et des volutions dans le temps correspondant aux diffrentes chanes de tlvision.
tMondrianInput
Proprits du tMondrianInput
Famille du composant Business Intelligence/OLAP
Cube
Fonction Le composant tMondrianInput lit des donnes partir de bases relationnelles et produit des
groupes de donnes multidimensionnels reposant sur une requte MDX.
Objectif Le tMondrianInput excute une expression multi-dimensionnelle (MDX) correspondant la
structure du groupe de donnes et au schma dfini. Puis il passe les donnes multidimensionnelles
obtenues au composant suivant l'aide d'un lien de type Row Main.
Basic settings Mondrian Version Slectionnez la version de Mondrian que vous utilisez.
DB type Slectionnez le type de relation appropri pour relier les bases de
donnes.
Property type Peut tre Built-in ou Repository.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes
collectes.
Datasource Chemin d'accs et nom du fichier contenant les donnes.
Username et Password Informations d'authentification de l'utilisateur de la base de donnes.
MDX Query Saisissez votre requte MDX en faisant attention ce que l'ordre des
champs corresponde celui dfini dans le schma et dans la structure
de l'entrept de donnes.
Encoding Slectionnez le type d'encodage partir de la liste ou choisissez
l'option Custom pour le dfinir manuellement. Ce champ doit
obligatoirement tre renseign.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie.
Cette variable est une variable Flow et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits des requtes MDX pour des groupes de donnes
multidimensionnels.
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation
de ces fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend,
dans le Guide d'installation et de migration Talend.
Configurer le Job
1. A partir de la Palette, cliquez-dposez un composant tMondrianInput (famille Business Intelligence) ainsi
qu'un composant de sortie tLogRow (famille Logs & Errors).
2. Reliez le tMondrianInput au composant de sortie l'aide d'un lien de type Row Main.
1. Dans le champ DB Type, slectionnez la base de donnes relationnelle utiliser avec Mondrian.
2. Slectionnez l'entre du Repository correspondante dans le champ Property type, dans le cas o vous
stockez les dtails de connexion vos bases de donnes de manire centralise. Dans cet exemple, les
proprits sont en mode Built-in.
3. Remplissez les dtails de connexion votre base de donnes : Host, Port, Database, User Name et
Password.
4. Dans le champ Schema, slectionnez le schma correspondant partir du Repository dans le cas o il est
stock de manire centralise. Dans cet exemple, le schma doit reste dfinir (mode Built-in).
2. La requte doit permettre de rcuprer le contenu de unit_sales, store_cost et de store_sales pour les
diffrentes valeur de media / drink en utilisant une requte MDX comme dans l'exemple ci-dessous :
1. A partir de l'onglet Basic settings du composant tMondrianInput, renseignez le chemin d'accs au catalogue
de l'entrept de donnes dans le champ Catalog. Ce catalogue dcrit la structure de l'entrept.
"select
{[Measures].[Unit Sales], [Measures].[Store Cost], [Measures].[Store
Sales]} on columns,
CrossJoin(
{ [Promotion Media].[All Media].[Radio],
[Promotion Media].[All Media].[TV],
[Promotion Media].[All Media].[Sunday Paper],
[Promotion Media].[All Media].[Street Handout] },
[Product].[All Products].[Drink].children) on rows
from Sales
where ([Time].[1997])"
Excuter le Job
1. Slectionnez le composant tLogRow puis cochez l'option Print header pour afficher le nom des colonnes
sur la console.
La console affiche le rsultat de unit_sales, store_cost et store_sales pour chaque type de Drink (Beverages, Dairy,
Alcoholic beverages) crois avec chaque type de media (TV, Sunday Paper, Street handout) comme illustr ci-
dessus.
tMSSqlSCD
Proprits du tMSSqlSCD
Famille de Databases/Business
composant Intelligence/MSSQL
Server
Fonction Le composant tMSSqlSCD reflte et traque les modifications d'une table SCD MSSQL ddie.
Objectif Le tMSSqlSCD rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une
source de donnes et en rpertoriant les modifications dans une table SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants
sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis,
dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles,
puis cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Pour plus d'informations concernant les mthodes de cration, consultez Cls SCD.
Use memory saving Cochez cette case pour amliorer les performances du systme.
Mode
Source keys include Null Cochez cette case pour autoriser, dans les colonnes cls source, les valeurs Null.
Lorsque cette case est coche, assurez-vous que la valeur de(s) cl(s) source
est unique.
Die on error Cette case est dcoche par dfaut, ce qui vous permet de terminer le traitement avec les
lignes sans erreur, et ignorer les lignes en erreur.
Advanced Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes cre.
settings parameters Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing
connection dans les Basic settings.
End date time details Spcifiez la valeur de temps du paramtre de date et heure de fin du SCD au format
HH:mm:ss. La valeur par dfaut pour ce champ est 12:00:00.
Ce champ apparat uniquement lorsqu'un SCD de Type 2 est utilis et lorsque Fixed
year value est slectionn pour crer la date de fin du SCD. Pour plus d'informations
concernant le SCD de Type 2, consultez Mthodologie de gestion du SCD.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
donnes.
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy
et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide utilisateur
du Studio Talend.
Global NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est une
variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on error
est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type Row
Main en entre.
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de la
perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/display/
KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment
configurer le studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tMysqlSCD
Proprits du tMysqlSCD
Famille de Databases/Business
composant Intelligence/
MySQL
Fonction Le composant tMysqlSCD reflte et traque les modifications d'une table SCD MySQL ddie.
Objectif Le tMysqlSCD rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une
source de donnes et en rpertoriant les modifications dans une table SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Ce champ apparat uniquement lorsqu'un SCD de Type 2 est utilis et lorsque Fixed year
value est slectionn pour crer la date de fin du SCD. Pour plus d'informations concernant
le SCD de Type 2, consultez Mthodologie de gestion du SCD.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
donnes.
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type Row
> Main en entre.
Cls SCD
Vous devez slectionner une ou plusieurs colonnes qui serviront de cls permettant d'assurer l'unicit des donnes
entrantes.
Vous devez aussi slectionner une colonne sur laquelle positionner une cl de substitution (surrogate key) dans
la table SCD et la relier une des colonnes d'entre de la table source. La valeur de la cl de substitution permet
de relier les enregistrements de la table source aux enregistrements de la table SCD. L'diteur utilise ce mapping
pour localiser l'enregistrement dans la table SCD et pour dterminer si un enregistrement est nouveau ou s'il a t
modifi. La cl de substitution est gnralement la cl primaire de la table source, mais elle peut aussi correspondre
une autre cl partir du moment o elle permet d'identifier de faon unique un enregistrement et o ses valeurs
ne changent pas.
Source keys : Glissez une ou plusieurs colonnes du panneau Unused vers le panneau Source keys. Ces colonnes
seront utilises en tant que cl(s) assurant l'unicit des donnes entrantes.
Surrogate keys : Paramtrez la colonne dans laquelle la cl de substitution gnre sera stocke. Une cl de
substitution peut tre gnre en fonction de la mthode slectionne dans la liste Creation.
Lorsque cette mthode est slectionne, vous pouvez glisser le champ correspondant du panneau Unused vers
le champ complement.
Routine : partir du champ complement, vous pouvez appuyer sur Ctrl+ Espace afin d'afficher la liste d'auto-
compltion et de slectionner la routine approprie.
Table max +1 : la valeur maximum de la table SCD est incrmente pour crer une cl de substitution.
DB Sequence : partir du champ complement, vous pouvez saisir le nom de la squence de la base de donnes
(DB Sequence) existante qui va incrmenter automatiquement la colonne indique dans le champ name.
L'option DB Sequence est disponible uniquement depuis l'diteur SCD du composant tOracleSCD.
Types de SCD
Il existe quatre types de dimensions volution lente (Slowly Changing Dimensions) : du Type 0 au Type 3.
Vous pouvez, d'un simple glisser-dposer, appliquer n'importe quel type de SCD n'importe quelle colonne de
la table source.
Type 0 : ce type de SCD n'est pas beaucoup utilis. Certaines donnes dimensionnelles peuvent tre crases
et d'autres peuvent rester inchanges au cours du temps. Ce type de SCD convient lorsque aucun effort n'a t
mis en place pour grer les dimensions caractre volutif.
Type 1 : aucun historique n'est stock dans la base de donnes. Les nouvelles donnes crase les anciennes.
Utilisez ce type si vous n'avez pas besoin de traquer les changements. Ce type de SCD convient lorsque vous
corrigez certaines fautes, par exemple l'orthographe des mots.
Type2 : l'intgralit de l'historique est stocke dans la base de donnes. Ce type de SCD traque les donnes
d'historique en enregistrant un nouvel enregistrement dans la table de dimension avec une nouvelle cl chaque
fois qu'un changement est effectu. Ce type de SCD convient lorsque l'on traque les mises jour, par exemple.
Le principe du SCD Type 2 rside dans le fait qu'un nouvel enregistrement est ajout la table SCD lorsqu'un
changement est dtect dans les colonnes slectionnes. Notez que bien que plusieurs changements peuvent
tre effectus au mme enregistrement sur plusieurs colonnes paramtres en Type 2, une seule ligne traquant
ces changements est ajoute la table SCD.
Le schma du SCD Type 2 devrait inclure des colonnes spcifiques au SCD contenant les informations de log
standard, notamment :
-start : ajoute une colonne au schma de la table SCD contenant la date de dbut d'un enregistrement. Vous
pouvez slectionner une des colonnes du schma d'entre comme date de dpart pour la table SCD.
-end : ajoute une colonne au schma de la table SCD contenant la date de fin d'un enregistrement. Lorsque
l'enregistrement est en cours, la date de fin est de valeur NULL , sinon vous pouvez utiliser une anne fixe en
slectionnant Fixed Year Value dans la liste et renseignez l'anne fictive dans la cellule d' ct pour viter
d'avoir une valeur nulle dans le champ end.
-version : ajoute une colonne au schma de la table SCD contenant le numro de version de l'enregistrement.
-active : ajoute une colonne au schma de la table SCD contenant les statuts true ou false. Cette colonne permet
de reprer facilement les enregistrements actifs.
Type 3 : seules les informations sur l'ancienne valeur d'une dimension est crite dans la base de donnes. Ce
type de SCD traque les changements en utilisant des colonnes spares. Ce type de SCD convient lorsque l'on
traque les valeurs prcdentes d'une colonne qui change.
Le fichier dlimit source contient diffrentes informations personnelles : des prnoms dans la colonne firstname,
des noms dans la colonne lastname, des adresses dans la colonne address, des villes dans la colonne city,
l'entreprise de la personne dans la colonne company, son ge dans la colonne age et son statut marital dans la
colonne status. Une colonne id permet d'assurer l'unicit des donnes.
Les changements de statut marital doivent craser les anciens statuts enregistrs. Ce type de changement
correspond un changement SCD Type 1.
Un nouvel enregistrement dans la table dimensionnelle avec une cl diffrente sera insr chaque fois qu'une
personne change d'entreprise. Ce type de changement correspond un changement SCD Type 2.
Vous allez rcuprer l'ancienne ville et l'ancienne adresse d'une personne. Ce type de changement correspond
un changement SCD Type 3.
Pour raliser ce type de scnario, il est prfrable de le sparer en trois tapes principales : la dfinition du flux
principal du Job, le paramtrage de l'diteur SCD et la cration de la table de modification dans la base de donnes.
2. Connectez les composants tFileInputDelimited, le premier tLogRow et le tMysqlSCD l'aide d'un lien
Row Main. Ce sous-job correspond au flux principal du Job.
4. Connectez le tMysqlSCD au second tLogRow l'aide d'un lien Row Reject. Les colonnes errorCode et
errorMessage sont ajoutes au schma. Cette connexion collecte les informations d'erreurs.
Si vous avez dj stock les informations de connexion dans le Repository, glissez l'lment Metadata souhait
dans l'diteur graphique et les informations de connexion la base de donnes apparatront automatiquement dans les
champs correspondants. Pour plus d'informations sur les mtadonnes, consultez le Guide utilisateur du Studio Talend.
Dans ce scnario, l'objectif est de se connecter la table SCD dans laquelle toutes les modifications apportes
au fichier dlimit seront traques.
2. Dans l'diteur graphique, double-cliquez sur le composant tFileInputDelimited pour afficher la vue Basic
settings.
3. Cliquez sur le bouton [...] ct du champ File Name pour slectionner le chemin d'accs au fichier dlimit
dataset.csv source contenant les informations personnelles.
4. Dans les champs Row et Field Separator, renseignez respectivement les sparateurs de lignes et de champs
utiliss dans le fichier source.
Les champs File Name, Row separator et Field separators sont obligatoires.
Dans ce scnario, saisissez 1 dans le champ Header puisque le fichier source contient un en-tte. Laissez le
champ Footer 0 puisque le fichier source ne contient pas de pied de page et ne renseignez pas le champ
Limit dterminant le nombre de lignes devant tre traites.
6. Cliquez sur Edit schema pour dcrire la structure des donnes du fichier dlimit source.
Dans ce scnario, le schma source est compos de huit colonnes : id,firstname, lastname, address, city,
company, age et status.
7. Dans l'onglet Basic settings du premier composant tLogRow, slectionnez le mode Table afin que le contenu
du fichier source, ainsi que les attributs variants apparaissent dans les cellules du tableau dans la console
avant d'tre traites par le composant SCD.
2. Dans l'onglet Basic settings, cochez la case Use an existing connection pour rutiliser les informations de
connexion dfinies dans les proprits du composant tMysqlConnection.
3. Dans le champ Table, saisissez le nom de la table SCD dans laquelle les changements seront stocks.
4. Si ncessaire, cliquez sur Sync columns pour rcuprer toutes les colonnes du fichier dlimit.
5. Dans l'diteur graphique, double-cliquez sur le composant tMysqlCommit pour paramtrer ses proprits.
6. Dans la liste Component list, slectionnez la connexion adquate s'il y a plusieurs composants de connexion
dans le Job.
7. Dans l'onglet Basic settings du second composant tLogRow, slectionnez le mode Table afin que le contenu
du fichier source, ainsi que les attributs variants apparaissent dans les cellules d'un tableau.
Toutes les colonnes du fichier dlimit source, provenant du composant prcdent et n'ayant pas encore t
utilises, apparaissent dans le panneau Unused de l'diteur SCD. Tous les autres panneaux de l'diteur sont
vides.
2. A partir de la liste Unused, glissez la colonne id vers le panneau Source keys pour tre utilise comme cl
permettant d'assurer l'unicit des donnes entrantes.
3. Dans le panneau Surrogate keys, donnez un nom la cl de substitution (surrogate key) dans le champ
Name, SK1 pour ce scnario.
4. Dans la liste Creation, slectionnez la mthode utiliser pour gnrer la cl de substitution, Auto-increment
pour ce scnario.
5. Dans la liste Unused, glissez les colonnes firstname et lastname vers le panneau Type 0, les changements
effectus dans ces colonnes ne sont pas pertinents dans cet exemple.
6. Glissez la colonne status vers le panneau Type 1. L'ancienne valeur sera crase par la nouvelle.
7. Glissez la colonne company vers le panneau Type 2. A chaque fois qu'une personne change d'entreprise, un
nouvel enregistrement sera insr dans la table dimensionnelle avec une nouvelle cl.
-Paramtrez les colonnes start et end de votre table SCD contenant respectivement les dates de dbut et de
fin. La date de fin est nulle pour les enregistrements en cours jusqu' ce qu'un changement soit dtect. A ce
moment l, la date de fin est renseigne et un nouvel enregistrement est ajout sans date de fin.
Dans ce scnario, slectionnez Fixed Year Value dans la colonne end et saisissez une anne fictive pour
viter d'avoir une valeur nulle dans le champ de date de fin.
-cochez la case active pour ajouter la colonne Status contenant les statuts True ou False des enregistrements.
True correspond l'enregistrement en cours et False correspond l'enregistrement modifi.
8. Glissez les colonnes address et city vers le panneau Type 3 pour ne rcuprer que les informations sur les
anciennes valeurs des adresses et des villes.
Pour plus d'informations sur les types de SCD, consultez Mthodologie de gestion du SCD.
Si vous modifiez la dfinition du schma d'entre, vous devez vrifier et reconfigurer si ncessaire la dfinition du
flux de sortie dans l'diteur SCD, afin de s'assurer que la structure des donnes de sortie est correctement actualise.
2. Double-cliquez sur le composant tMysqlSCD pour afficher sa vue Basic settings et slectionnez Create
table if not exists partir de la liste Action on table pour viter d'avoir crer et dfinir manuellement la
table SCD.
Excuter le Job
Enregistrez votre Job et appuyez sur F6 pour l'excuter.
La console Run affiche le contenu du fichier dlimit d'entre et votre table SCD est cre dans votre base de
donnes, contenant l'ensemble de donnes initial.
Janet divorce, dmnage Adelanto au 355 Golf Rd et travaille maintenant chez Greenwood.
Adam s'est mari, a dmnag Belmont au 2505 Alisson ct. et travaille chez Scoop.
Mettez jour le fichier dlimit avec ces informations et appuyez sur F6 pour excuter le Job.
La console affiche les changements apports aux informations personnelles et la table SCD affiche l'historique
des changements valides, ainsi que leur statut et leur numro de version. Le nom de l'entreprise de Martin dpasse
la longueur dfinie pour la colonne company dans le schma. Ce changement est donc dirig vers le flux de rejets,
et non sauvegard dans la table SCD.
tMysqlSCDELT
Proprits du tMysqlSCDELT
Famille de Databases/Business
composant Intelligence/MySQL
Fonction Le composant tMysqlSCDELT reflte et traque les modifications d'une table MySQL SCD ddie.
Objectif Le tMysqlSCDELT rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement
une source de donnes et en rpertoriant les modifications dans une table MySQL SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
DB Version Slectionnez la version de Mysql que vous utilisez.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Start date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date
de dpart. Vous pouvez slectionner l'une des colonnes d'entre du schma comme date de
dpart (Start Date) dans la table SCD.
End Date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de
fin pour le journal. Lorsque le journal est en mode actif, la colonne End Date a une valeur
nulle ; pour viter cela, vous pouvez slectionner l'option Fixed Year value et saisir une
anne fictive.
Log Active Status : Ajoute une colonne votre schma SCD pour renseigner les valeurs de
statut true et false. Cette colonne permet de reprer facilement le journal actif.
Log versions : Ajoute une colonne votre schma SCD pour renseigner le numro de version
du journal.
Advanced Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
settings donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy
et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide utilisateur
du Studio Talend.
Global ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est une
Variables variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on error
est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie et une
connexion de type Row Main.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD, ainsi que Scnario : Traquer des modifications avec les Slowly
Changing Dimensions de type 0 3.
tNetezzaSCD
Proprits du tNetezzaSCD
Famille de Databases/
composant Netezza
Fonction Le composant tNetezzaSCD reflte et traque les modifications d'une table SCD Netezza ddie.
Objectif Le tNetezzaSCD rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement
une source de donnes et en rpertoriant les modifications dans une table SCD ddie
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Create table if not exists : si ncessaire, crer une table qui n'existe pas encore.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
SCD Editor L'diteur SCD Editor permet de construire et de configurer les donnes du flux de sortie vers
la table Slowly Changing Dimension.
Vous pouvez appuyer sur Ctrl+Espace afin d'accder une liste de variables globales
prdfinies.
End date time Spcifiez la valeur de temps du paramtre de date et heure de fin du SCD au format HH:mm:ss.
details La valeur par dfaut pour ce champ est 12:00:00.
Ce champ apparat uniquement lorsqu'un SCD de Type 2 est utilis et lorsque Fixed year value
est slectionn pour crer la date de fin du SCD. Pour plus d'informations concernant le SCD
de Type 2, consultez Mthodologie de gestion du SCD.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Debug mode Cochez cette case pour afficher chaque tape du processus d'criture dans la base de donnes.
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis comme composant de sortie. Il ncessite un composant d'entre et un composant de sortie.
Limitation Le fichier nzjdbc.jar doit tre install sparment. Pour plus d'informations, consultez la section concernant les
modules externes dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tOracleSCD
Proprits du tOracleSCD
Famille de Databases/Business
composant Intelligence/Oracle
Fonction Le composant tOracleSCD reflte et traque les modifications d'une table SCD Oracle ddie.
Objectif Le tOracleSCD rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une
source de donnes et en rpertoriant les modifications dans une table SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Oracle OCI : Slectionnez ce type de connexion pour utiliser l'interface d'appel de la base
de donnes Oracle ( Oracle Call Interface) accompagne d'un ensemble de logiciels API de
langage C qui fournissent une interface cette base de donnes Oracle.
Oracle Service Name : Slectionnez ce type de connexion pour utiliser l'alias TNS que vous
fournissez lorsque vous vous connectez la base de donnes distante.
Oracle SID : Slectionnez ce type de connexion pour identifier exclusivement une base de
donnes spcifique sur un systme.
Oracle Custom : Slectionnez ce type de connexion pour accder une base de donnes
contenant des clusters.
DB Version Slectionnez la version d'Oracle que vous utilisez.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom du schma de la base de donnes.
Username et Informations d'authentification de l'utilisateur de la base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans la
bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis cliquez
sur OK afin de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table slectionne :
Create table if not exists : si ncessaire, crer une table qui n'existe pas encore.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
schema et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Ce champ apparat uniquement lorsqu'un SCD de Type 2 est utilis et lorsque Fixed year
value est slectionn pour crer la date de fin du SCD. Pour plus d'informations concernant
le SCD de Type 2, consultez Mthodologie de gestion du SCD.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
donnes.
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy
et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type Row
Main en entre.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tOracleSCDELT
Proprits du tOracleSCDELT
Famille de Databases/
composant Business
Intelligence/
Oracle
Fonction Le composant tOracleSCDELT reflte et traque les modifications d'une table Oracle SCD ddie.
Objectif Le tOracleSCDELT rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement
une source de donnes et en rpertoriant les modifications dans une table Oracle SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Oracle OCI : Slectionnez ce type de connexion pour utiliser l'interface d'appel de la base de
donnes Oracle ( Oracle Call Interface) accompagne d'un ensemble de logiciels API de langage
C qui fournissent une interface cette base de donnes Oracle.
Oracle Service Name : Slectionnez ce type de connexion pour utiliser l'alias TNS que vous
fournissez lorsque vous vous connectez la base de donnes distante.
Oracle SID : Slectionnez ce type de connexion pour identifier exclusivement une base de
donnes spcifique sur un systme.
Oracle Custom : Slectionnez ce type de connexion pour accder une base de donnes
contenant des clusters.
DB Version Slectionnez la version d'Oracle que vous utilisez.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Username et Informations d'authentification de l'utilisateur de base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans la
bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis cliquez
sur OK afin de sauvegarder les paramtres.
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Surrogate Key Slectionnez dans la liste une colonne utiliser comme cl de substitution.
Creation Slectionnez la mthode utiliser pour gnrer la cl de substitution.
Pour plus d'informations concernant les mthodes de cration, consultez Cls SCD.
Source Keys Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer l'unicit des donnes
entrantes.
Source fields Cochez cette case pour autoriser les valeurs Nulls dans les colonnes source.
value include
Null Les colonnes source font rfrence aux champs dfinis dans les tables SCD type 1
fields et SCD type 2 fields.
Use SCD Type 1 Utilisez le type 1 si vous n'avez pas besoin de traquer les modifications, pour des corrections
fields typographiques par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour
les modifications.
Use SCD Type 2 Utilisez le type 2 si vous avez besoin de traquer les modifications, pour garder une trace
fields des mises jour effectues par exemple. Slectionnez les colonnes du schma qui servira de
rfrence pour les modifications.
Start date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de
dpart. Vous pouvez slectionner l'une des colonnes d'entre du schma comme date de dpart
(Start Date) dans la table SCD.
End Date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de fin
pour le journal. Lorsque le journal est en mode actif, la colonne End Date a une valeur nulle ;
pour viter cela, vous pouvez slectionner l'option Fixed Year value et saisir une anne fictive.
Log Active Status : Ajoute une colonne votre schma SCD pour renseigner les valeurs de
statut true et false . Cette colonne permet de reprer facilement le journal actif.
Log versions : Ajoute une colonne votre schma SCD pour renseigner le numro de version
du journal.
Advanced Additional Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette
settings JDBC option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les
parameters Basic settings.
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
Variables une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie et une
connexion de type Row Main.
Scnario associ
Pour un scnario associ, consultez tOracleSCD, ainsi que tMysqlSCD.
tPaloCheckElements
Proprits du tPaloCheckElements
Famille de composant Business Intelligence/Cube
OLAP/Palo
Fonction Le composant tPaloCheckElements vrifie l'existence d'lments du flux de donnes d'entre
dans un cube donn.
Objectif Ce composant peut tre utilis avec le tPaloOutputMulti. Il vrifie si les lments du flux d'entre
existent dans le cube donn, avant de les crire. Il peut galement dfinir une valeur par dfaut
qui peut tre utilise si les lments n'existent pas.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion
adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Indisponible lors de
l'utilisation d'une
connexion existante
Server Port Saisissez le numro du port d'coute du serveur Palo.
Username et Password Informations d'authentification de l'utilisateur de Palo.
Pour plus d'informations concernant les connexions, consultez le Guide utilisateur du Studio
Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient.
Cette variable est une variable After et retourne une chane de caractres. Cette variable
fonctionne uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant fonctionne uniquement avec des cubes Palo de type "Normal".
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez Scnario 2 : Refuser un flux de donnes d'entre lorsque les lments crire
n'existent pas dans un cube donn.
tPaloClose
Proprits du tPaloClose
Famille de composant Business Intelligence/
Cube OLAP/Palo
Fonction Ce composant ferme une connexion active au serveur Palo.
Objectif Ce composant est utilis pour dsactiver une connexion un serveur Palo afin de librer des ressources
occupes.
Basic settings Component List Slectionnez un composant tPaloConnection dans la liste droulante si
plusieurs connexions sont utilises dans le Job.
Advanced settings tStatCatcher Statistics Cochez cette case afin de collecter les donnes au niveau du composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues
dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes
ayant la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Palo, notamment avec le
tPaloConnection.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tPaloConnection
Proprits du tPaloConnection
Famille de composant Business Intelligence/Cube
OLAP/Palo
Fonction Le composant tPaloConnection ouvre une connexion vers un serveur Palo et la laisse ouverte
durant le temps de traitement. Chaque autre composant Palo du processus peut utiliser cette
connexion.
Objectif Ce composant permet le partage d'une connexion un serveur Palo durant le processus complet.
Basic settings Host Name Saisissez le nom de l'hte ou l'adresse IP du serveur hte.
Server Port Saisissez le numro du port d'coute du serveur Palo.
Username et Password Informations d'authentification de l'utilisateur de Palo.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis avec les composants Palo afin de partager une connexion un serveur Palo.
Connections Liens de sortie (de ce composant un autre) :
Row : Iterate
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
Scnario associ
Pour un scnario associ, consultez Scnario : Crer une dimension avec des lments.
tPaloCube
Proprits du tPaloCube
Famille de composant Business Intelligence/Cube
OLAP/Palo
Fonction Le composant tPaloCube cre, supprime ou vide des cubes Palo partir de dimensions existantes
dans une base de donnes Palo.
Objectif Ce composant effectue des oprations sur un cube Palo donn.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion
adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Indisponible lors de
l'utilisation d'une
connexion existante.
Server Port Saisissez le numro du port d'coute du serveur Palo.
Username et Password Informations d'authentification de l'utilisateur de Palo.
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.
Row : Iterate
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.
Pour plus d'informations concernant les connexions, consultez la section relative aux diffrents
types de connexions, dans le Guide utilisateur du Studio Talend.
Global Variables CUBENAME : nom du cube. Cette variable est une variable After et retourne une chane de
caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Le cube crant un processus ne cre pas les dimensions partir de rien. Les dimensions utilises
dans le cube ont t cres prcdemment.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
3. Dans le champ Host name, saisissez le nom de l'hte ou l'adresse IP du serveur hte, localhost dans cet
exemple.
4. Dans le champ Server Port, saisissez le numro du port d'coute du serveur Palo. Dans ce scnario, le numro
est 7777.
5. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations
d'authentification. Dans cet exemple, les deux sont admin.
6. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle vous souhaitez crer le
cube, Biker dans cet exemple.
7. Dans le champ Cube, saisissez le nom que vous souhaitez utiliser afin de crer le cube, bikerTalend, par
exemple.
8. Dans le champ Cube type, slectionnez le type Normal dans la liste droulante pour le cube crer, ce qui
signifie que ce cube sera de type "Normal", le type par dfaut.
9. Dans le champ Action on cube, slectionnez l'action effectuer. Dans ce scnario, slectionnez Create cube.
10. Sous le tableau Dimensionlist, cliquez deux fois sur le bouton [+] afin d'ajouter deux lignes.
11. Dans le tableau Dimensionlist, saisissez le nom de chaque nouvelle ligne afin de remplacer le nom par dfaut.
Dans ce scnario, saisissez Months pour la premire ligne et Products pour la seconde. Ces deux dimensions
existent dj dans la base de donnes Biker dans laquelle le nouveau cube sera cr.
Excuter le Job
Appuyez sur F6 afin d'excuter le Job.
Un nouveau cube a t cr dans la base de donnes Biker et les deux dimensions sont ajoutes dans ce cube.
tPaloCubeList
Proprits du tPaloCubeList
Famille de composant Business Intelligence/Cube
OLAP/Palo
Fonction Le composant tPaloCubeList rcupre les informations d'une liste de cubes dans la base de
donnes Palo dtermine.
Objectif Ce composant liste le nom des cubes, leur types, le nombre de dimensions assignes, le nombre
de cellules remplies dans la base de donnes dtermine.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion
adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Indisponible lors de
l'utilisation d'une
connexion existante.
Server Port Saisissez le numro du port d'coute du serveur Palo.
Username et Password Informations d'authentification de l'utilisateur de Palo.
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.
Row : Iterate
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.
Pour plus d'informations concernant les connexions, consultez le Guide utilisateur du Studio
Talend.
Global Variables NB_CUBES : nombre de cubes. Cette variable est une variable After et retourne un nombre entier.
CUBEID : ID du cube. Cette variable est une variable Flow et retourne un nombre entier.
CUBENAME : nom du cube. Cette variable est une variable Flow et retourne une chane de
caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Le schma de sortie est fixe et en lecture seule.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
- 0 : non charg
- 1 : charg
- 2 : chang
Cube_type int Type du cube. Il peut tre :
- 0 : normal
- 1 : system
- 2 : attribute
- 3 : user info
- 4 : gpu type
Configurer le Job
1. Dposez un composant tPaloCubeList et un tLogRow de la Palette dans l'espace de modlisation graphique.
3. Dans ce menu, slectionnez Row > Main pour relier les deux composants.
2. Dans le champ Host name, saisissez le nom de l'hte ou l'adresse IP du serveur hte, localhost dans cet
exemple.
3. Dans le champ Server Port, saisissez le numro du port d'coute du serveur Palo. Dans ce scnario, le numro
est 7777.
4. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations
d'authentification. Dans cet exemple, les deux sont admin.
5. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle vous souhaitez crer le
cube, Biker dans cet exemple.
Excuter le Job
Appuyez sur F6 pour excuter le Job.
Les informations du cube sont rcupres de la base de donnes Biker et sont affiches dans la console de la vue
Run.
Pour plus d'informations concernant l'interprtation des informations sur le cube, consultez la Dcouvrir le schma
de sortie en lecture seule du tPaloCubeList.
tPaloDatabase
Proprits du tPaloDatabase
Famille de composant Business Intelligence/Cube
OLAP/Palo
Fonction Le composant tPaloDatabase cre, supprime ou recre des bases de donnes sur un serveur Palo
donn.
Objectif Ce composant gre les bases de donnes dans un serveur Palo.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion
adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Indisponible lors de
l'utilisation d'une
connexion existante.
Server Port Saisissez le numro du port d'coute du serveur Palo.
Username et Password Informations d'authentification de l'utilisateur de Palo.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Connections Liens de sortie (de ce composant un autre) :
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.
Row : Iterate
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error
Pour plus d'informations concernant les connexions, consultez la section relative aux diffrents
types de connexions dans le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone lors d'oprations de gestion de bases de donnes
dans un serveur Palo.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
3. Dans le champ Host name, saisissez le nom de l'hte ou l'adresse IP du serveur hte, localhost dans cet
exemple.
4. Dans le champ Server Port, saisissez le numro du port d'coute du serveur Palo. Dans ce scnario, le numro
est 7777.
5. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations
d'authentification. Dans cet exemple, les deux sont admin.
6. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle vous souhaitez crer le cube,
talenddatabase dans cet exemple.
7. Dans le champ Action on database, slectionnez l'action effectuer. Dans ce scnario, slectionnez Create
database puisque la base de donnes crer n'existe pas.
Une nouvelle base de donnes est cre sur le serveur Palo donn.
tPaloDatabaseList
Proprits du tPaloDatabaseList
Famille de composant Business Intelligence/Cube
OLAP/Palo
Fonction Le composant tPaloDatabaseList rcupre les informations d'une liste de bases de donnes dans
un serveur Palo donn.
Objectif Ce composant liste les noms des bases de donnes, leur type, le nombre de cubes, le nombre de
dimensions, le statut et l'ID des bases de donnes d'un serveur Palo donn.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion
adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Indisponible lors de
l'utilisation d'une
connexion existante.
Server Port Saisissez le numro du port d'coute du serveur Palo.
Username et Password Informations d'authentification de l'utilisateur de Palo.
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.
Row : Iterate
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.
Pour plus d'informations concernant les connexions, consultez la section relative aux types de
connexions dans le Guide utilisateur du Studio Talend.
Global Variables NB_DATABASES : nombre de bases de donnes. Cette variable est une variable After et
retourne un nombre entier.
DATABASEID : ID de la base de donnes. Cette variable est une variable Flow et retourne un
long.
DATABASENAME : nom de la base de donnes. Cette variable est une variable Flow et retourne
une chane de caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Le schma de sortie est fixe et en lecture seule.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
- 0 = non charge
- 1 = charge
- 2 = change
Database_types int Type de la base de donnes.
- 0 = normal
- 1 = system
- 3 = user info
Configurer le Job
1. Dposez un composant tPaloDatabaseList et un tLogRow de la Palette dans l'espace de modlisation
graphique.
3. Dans ce menu, slectionnez Row > Main pour relier les deux composants.
2. Dans le champ Host name, saisissez le nom de l'hte ou l'adresse IP du serveur hte, localhost dans cet
exemple.
3. Dans le champ Server Port, saisissez le numro du port d'coute du serveur Palo. Dans ce scnario, le numro
est 7777.
4. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations
d'authentification. Dans cet exemple, les deux sont admin.
Excuter le Job
Appuyez sur F6 pour excuter le Job.
Les informations de toutes les bases de donnes du serveur Palo sont rcupres et affiches dans la console de
la vue Run.
Pour plus d'informations concernant le schma de sortie, consultez Dcouvrir le schma de sortie en lecture seule
du tPaloDatabaseList.
tPaloDimension
Proprits du tPaloDimension
Famille de composant Business Intelligence/Cube
OLAP/Palo
Fonction Le composant tPaloDimension cre, supprime ou recre des dimensions avec ou sans lments
de dimension dans une base de donnes Palo.
Objectif Ce composant gre les dimensions Palo, ainsi que les lments dans une base de donnes.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion
adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Indisponible lors de
l'utilisation d'une
connexion existante.
Server Port Saisissez le numro du port d'coute du serveur Palo.
Username et Password Informations d'authentification de l'utilisateur de Palo.
- Numeric
- Text
Creation mode : Slectionnez le mode de cration pour les
lments traiter. Ce mode peut tre :
Consolidation type - Normal Slectionnez ce bouton pour crer des lments et les consolider
dans la dimension donne. Cette consolidation structure les
Cette option lments crs diffrents niveaux.
active les champs
des paramtres
correspondants
devant tre
renseigns.
Input Column: slectionnez une colonne dans la liste droulante.
Les colonnes de la liste droulante sont celles que vous avez
dfinies dans le schma. Les valeurs de la colonne slectionne
seront prises en compte lors du traitement d'lments de
dimension.
Element type : Slectionnez le type d'lments. Il peut tre :
- Numeric
- Text
Creation mode : Slectionnez le mode de cration pour les
lments crer. Ce mode peut tre :
- Numeric
- Text
Creation mode Slectionnez le mode de cration pour les lments crer. Ce
mode peut tre :
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error
Pour plus d'informations concernant les connexions, consultez la section relatives aux diffrents
types de connexions, dans le Guide utilisateur du Studio Talend.
Global Variables DIMENSIONNAME : nom de la dimension. Cette variable est une variable After et retourne
une chane de caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation La suppression d'lments de dimension est possible uniquement avec le type de consolidation
None. Seul le type de consolidation Self-Referenced permet le placement d'un facteur dans
cette consolidation.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Construire le Job
1. Dposez un composant tPaloConnection, un tRowGenerator, un tMap, et un tPaloDimension de la Palette
dans l'espace de modlisation graphique.
2. Cliquez-droit sur le tPaloConnection afin d'ouvrir le menu contextuel et slectionnez Trigger > On Subjob
Ok pour le relier au tRowGenerator.
3. Cliquez-droit sur le tRowGenerator afin d'ouvrir le menu contextuel et slectionnez Row > Main pour le
relier au tMap.
Le tRowGenerator est utilis pour gnrer des lignes au hasard afin de simplifier ce processus. Dans un cas rel
d'utilisation, vous pouvez utiliser un autre composant d'entre afin de charger vos donnes.
4. Cliquez-droit sur le tMap pour ouvrir le menu contextuel et slectionnez Row > *New output* pour le relier
au tPaloDimension. Nommez ce lien out1 dans la bote de dialogue qui s'ouvre.
2. Dans le champ Host name, saisissez le nom de l'hte ou l'adresse IP du serveur hte, localhost dans cet
exemple.
3. Dans le champ Server Port, saisissez le numro du port d'coute du serveur Palo. Dans ce scnario, le numro
est 7777.
4. Dans les champs Username (identifiant) et Password (mot de passe), saisissez les informations
d'authentification. Dans cet exemple, les deux sont admin.
2. Dans la partie suprieure de l'diteur, cliquez sur le bouton [+] pour ajouter une colonne, et renommez-la
random_date dans la colonne Column.
3. Dans la ligne nouvellement ajoute, slectionnez Date pour la colonne Type, et getRandomDate dans la
colonne Functions.
4. Dans la vue Function parameters de la partie infrieure de l'diteur, saisissez les nouvelles valeurs des dates
minimum et maximum de la colonne Value. Dans cet exemple, le minimum est 2010-01-01, le maximum
est 2010-12-31.
6. Dans la bote de dialogue qui s'ouvre, cliquez sur OK pour propager les modifications.
2. Dans la vue Schema editor de la partie infrieure de la fentre, sous la table out1, cliquez sur le bouton [+]
afin d'ajouter trois lignes.
3. Dans la colonne Column de la table out1 saisissez de nouveaux noms pour les trois lignes ajoutes, Year,
Month et Date (anne, mois et date). Ces lignes sont ajoutes automatiquement la table out1 dans la partie
infrieure du tMap editor.
4. Dans la table out1 de la partie suprieure de l'diteur, cliquez sur la colonne Expression de la ligne Year.
6. Double-cliquez sur TalendDate.formatDate pour la slectionner. L'expression pour obtenir la date s'affiche
dans la ligne Year. L'expression est la suivante :
TalendDate.formatDate("yyyy-MM-dd HH:mm:ss",myDate).
8. Rptez l'opration pour les lignes Month et Date pour ajouter l'expression par dfaut
et remplacez-la respectivement par TalendDate.formatDate("MM",row1.random_date)et par
TalendDate.formatDate("dd-MM-yyyy", row1.random_date).
9. Cliquez sur OK afin de valider cette modification et acceptez la propagation des modifications en cliquant
sur OK dans la bote de dialogue qui s'ouvre.
2. Cochez la case Use an existing connection. Le tPaloConnection_1 s'affiche automatiquement dans le champ
Connection configuration.
3. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle la nouvelle dimension est
cre, talendDatabase dans cet exemple.
4. Dans le champ Dimension, saisissez le nom que vous souhaitez utiliser pour la dimension crer, Date, par
exemple.
5. Dans le champ Action on dimension, slectionnez l'action effectuer. Dans ce scnario, slectionnez Create
dimension if not exist.
8. Sous le tableau de la hirarchie des lments, cliquez trois fois sur le bouton [+] pour ajouter trois lignes
au tableau.
9. Dans la colonne Input column du tableau, slectionnez Year dans la liste droulante de la premire ligne,
Month dans la deuxime et Date dans la troisime. Cela dtermine le niveau des lments des diffrentes
colonnes du schma d'entre.
Excuter le Job
Appuyez sur F6 pour excuter le Job.
tPaloDimensionList
Proprits du tPaloDimensionList
Famille de composant Business Intelligence/Cube
OLAP/Palo
Fonction Le composant tPaloDimensionList rcupre les informations d'une liste de dimensions de la base
de donnes Palo dtermine.
Objectif Ce composant affiche le nom des dimensions, leur type, le nombre d'lments de dimension, le
maximum d'indentation des dimensions, le maximum de profondeur des dimensions, le maximum
des niveaux des dimensions, l'ID des dimensions dans un serveur Palo donn.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Indisponible lors de
l'utilisation d'une
connexion existante.
Server Port Saisissez le numro du port d'coute du serveur Palo.
Username et Password Informations d'authentification de l'utilisateur de Palo.
Row : Iterate.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Le schma de sortie est fixe et en lecture seule.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
- 0 = normal
- 1 = system
- 2 = attribute
- 3 = user info
Construire le Job
1. Dposez un composant tPaloDimensionList et un tLogRow de la Palette dans l'espace de modlisation
graphique.
3. Dans le menu, slectionnez Row > Main pour relier les deux composants.
2. Dans le champ Host name, saisissez le nom de l'hte ou l'adresse ID du serveur hte, localhost dans cet
exemple.
3. Dans le champ Server Port, saisissez le numro du port d'coute du serveur Palo. Dans ce scnario, le numro
est 7777.
4. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations
d'authentification. Dans cet exemple, les deux sont admin.
5. Dans le champ Database, saisissez le nom de la base de donnes contenant les dimensions qui vous
intressent, Biker dans cet exemple.
Excuter le Job
Appuyez sur F6 pour excuter le Job.
Les informations concernant les dimensions de la base de donnes Biker sont rcupres et affiches dans la
console de la vue Run.
Pour plus d'informations concernant le schma de sortie, consultez Dcouvrir le schma de sortie en lecture seule
du tPaloDimensionList.
tPaloInputMulti
Proprits du tPaloInputMulti
Famille de composant Business Intelligence/Cube
OLAP/Palo
Fonction Le composant tPaloInputMulti rcupre des donnes (des lments et des valeurs) d'un cube Palo.
Objectif Ce composant rcupre les valeurs stockes ou calcules ainsi que les enregistrements l'extrieur
d'un cube.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Indisponible lors de
l'utilisation d'une
connexion existante.
Server Port Saisissez le numro du port d'coute du serveur Palo.
Username et Password Informations d'authentification de l'utilisateur de Palo.
Row : Main
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.
Row : Iterate.
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.
Pour plus d'informations concernant les connexions, consultez le Guide utilisateur du Studio
Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Selon l'architecture des systmes OLAP, une seule valeur (texte ou numrique) peut tre rcupre
du cube. Les colonnes MEASURE et TEXT sont fixes et en lecture seule.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Construire le Job
1. Dposez un composant tPaloInputMulti et un tLogRow de la Palette dans l'espace de modlisation
graphique.
3. Dans le menu, slectionnez Row > Main afin de relier le tPaloInputMulti au tLogRow.
2. Dans le champ Host name, saisissez le nom de l'hte ou l'adresse IP du serveur hte, localhost dans cet
exemple.
3. Dans le champ Server Port, saisissez le numro du port d'coute du serveur Palo. Dans ce scnario, le numro
est 7777.
4. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations
d'authentification. Dans cet exemple, l'identifiant et le mot de passe sont admin.
2. Dans le champ Cube, saisissez le nom du cube dans lequel sont stockes les dimensions qui vous intressent
Dans ce scnario, le cube est celui de dmo, Sales.
3. Dans le champ Cube type, slectionnez le type du cube crer. Choisissez Normal, ce qui signifie que le
cube sera de type "Normal", le type par dfaut.
4. A ct du champ Edit Schema, cliquez sur le bouton [...] pour ouvrir l'diteur de schma.
5. Dans l'diteur du schma, cliquez sur le bouton [+] pour ajouter les lignes ncessaires. Dans cet exemple,
ajoutez les lignes correspondant toutes les dimensions stockes dans le cube Sales : Products, Regions,
Months, Years, Datatypes, Measures. Saisissez les noms dans l'ordre donn de ce cube.
6. Cliquez sur OK pour valider les modifications et acceptez la propagation du changement au composant
suivant. Ces colonnes sont ajoutes automatiquement dans la colonne Column du tableau Cube Query dans
la vue Component. Si l'ordre n'est pas cohrent par rapport celui du cube Sales, dplacez les colonnes
l'aide des flches montante et descendante.
7. Dans la colonne Dimensions du tableau Cube Query, saisissez le nom de chaque dimension stocke dans
le cube Sales selon l'ordre des lignes dans la colonne Column. Dans le cube Sales, le nom des dimensions
est : Products, Regions, Months, Years, Datatypes, Measures.
8. Dans la colonne Elements du tableau Cube Query, saisissez le nom des lments de dimensions que vous
souhaitez rcuprer selon la dimension laquelle ils appartiennent. Dans cet exemple, les lments rcuprer
sont All products, Germany, Austria, Jan, 2009, Actual, Turnover (Germany et Austria appartenant la mme
dimension Regions, ils doivent tre saisis dans la mme ligne et spars par une virgule).
Excuter le Job
1. Cliquez sur le tLogRow afin d'ouvrir sa vue Component.
2. Dans la zone Mode, slectionnez l'option Table (print values in cell of a table) pour afficher les rsultats
de l'excution sous forme de tableau.
Les lments de dimensions et la valeur Measure correspondant s'affichent dans la console de la vue Run.
tPaloOutput
Proprits du tPaloOutput
Famille de composant Business Intelligence/Cube
OLAP/Palo
Fonction Le composant tPaloOutput crit une ligne de donnes (des lments ainsi que des valeurs) dans
un cube Palo donn.
Objectif Ce composant prend le flux d'entre et l'crit dans un Cube Palo donn.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Indisponible lors de
l'utilisation d'une
connexion existante.
Server Port Saisissez le numro du port d'coute du serveur Palo.
Username et Password Informations d'authentification de l'utilisateur de Palo.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Connections Liens de sortie (de ce composant un autre) :
Row : Iterate.
Pour plus d'informations concernant les connexions, consultez le Guide utilisateur du Studio
Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant ne peut crire qu'une seule ligne de donnes dans un cube.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez Scnario 1 : Ecrire des donnes dans un cube donn.
tPaloOutputMulti
Proprits du tPaloOutputMulti
Famille de composant Business Intelligence/Cube
OLAP/Palo
Fonction Le composant tPaloOutputMulti crit des donnes (des lments et des valeurs) dans un cube
Palo.
Objectif Ce composant prend le flux d'entre et l'crit dans un cube Palo donn.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Indisponible lors de
l'utilisation d'une
connexion existante.
Server Port Saisissez le numro du port d'coute du serveur Palo.
Username et Password Informations d'authentification de l'utilisateur de Palo.
Row : Main
Pour plus d'informations concernant les connexions, consultez le Guide utilisateur du Studio
Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Les mesures numriques doivent tre de type Double ou String. Lorsque le type String est utilis,
saisissez entre guillemets la valeur devant tre traite.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Construire le Job
1. Dposez un tFixedFlowInput et un tPaloOutputMulti de la Palette dans l'espace de modlisation
graphique.
3. Dans ce menu, slectionnez Row > Main pour relier ce composant au tPaloOutputMulti.
3. Dans l'diteur de schma, cliquez sept fois sur le bouton [+] afin d'ajouter sept lignes. Renommez-les
respectivement Products, Regions, Months, Years, Datatypes, Measures et Values. L'ordre de ces lignes doit
tre cohrent avec celui des dimensions correspondantes dans le cube Sales et le type de la colonne Value,
qui comprend la valeur de la mesure, est dfini comme double/Double.
4. Cliquez sur OK afin de valider la modification et acceptez la propagation propose par la bote de dialogue
qui s'ouvre. Les libells des colonnes du schma s'affichent automatiquement dans le tableau Value sous la
case Use single table de la zone Mode.
5. Dans le tableau Value, saisissez la valeur de chaque ligne dans la colonne Value. Ces valeurs sont : Desktop
L, Germany, Jan, 2009, Actual, turnover, 1234.56.
2. Dans le champ Server Port, saisissez le numro du port d'coute du serveur Palo. Dans ce scnario, le numro
est 7777.
3. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations
d'authentification. Dans cet exemple, les deux sont admin.
4. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle vous souhaitez crer le
cube, Biker dans cet exemple.
5. Dans le champ Cube, saisissez le nom que vous souhaitez utiliser pour le cube crer, bikerTalend, par
exemple.
6. Dans le champ Cube type, slectionnez le type Normal dans la liste droulante. Cela signifie que le cube
crer sera de type "Normal", le type par dfaut.
Excuter le Job
Appuyez sur F6 pour excuter le Job.
Construire le Job
1. Dposez les composants tFixedFlowInput, tPaloCheckElements, tPaloOutputMulti et tLogRow de la
Palette dans l'espace de modlisation graphique.
3. Dans ce menu, slectionnez Row > Main afin de connecter ce composant au tPaloCheckElements.
3. Dans l'diteur de schma, cliquez sept fois sur le bouton [+] afin d'ajouter sept lignes que vous allez nommer
respectivement Products, Regions, Months, Years, Datatypes, Measures et Values. L'ordre de ces lignes doit
tre cohrent avec celui des dimensions correspondantes dans le cube Sales et le type de la colonne Value,
qui comprend la valeur de la mesure et qui est dfini comme double/Double.
4. Cliquez sur OK afin de valider la modification et acceptez la propagation propose par la bote de dialogue
qui s'ouvre. Les libells des colonnes du schma s'affichent automatiquement dans le tableau Value sous la
case Use single table de la zone Mode.
5. Dans le tableau Value, saisissez la valeur de chaque ligne dans la colonne Value. Ces valeurs sont : Desktop
L, Germany, Jan, 2009, Actual, turnover, 1234.56.
3. Dans le champ Server Port, saisissez le numro du port d'coute du serveur Palo. Dans ce scnario, le numro
est 7777.
4. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations
d'authentification. Dans cet exemple, les deux sont admin.
5. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle vous souhaitez crer le
cube, Demo dans cet exemple.
6. Dans le champ Cube, saisissez le nom du cube dans lequel vous souhaitez crire les donnes, Sales, par
exemple.
8. Dans le tableau contenant les lments en bas de la vue Basic settings, cliquez sur la cellule au croisement
de la ligne Value et de la colonne Element type. Slectionnez Measure dans la liste droulante.
2. Dans le champ Server Port, saisissez le numro du port d'coute du serveur Palo. Dans ce scnario, le numro
est 7777.
3. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations
d'authentification. Dans cet exemple, les deux sont admin.
4. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle vous souhaitez crer le
cube, Demo dans cet exemple.
5. Dans le champ Cube, saisissez le nom du cube dans lequel vous souhaitez crire les donnes, Sales, par
exemple.
6. Dans le champ Cube type, slectionnez le type Normal dans la liste droulante. Cela signifie que le cube
crer sera de type "Normal", le type par dfaut.
Excuter le Job
Appuyez sur F6 pour excuter votre Job.
Les donnes crire sont rejetes et affiches dans la console de la vue Run. Vous pouvez voir que le message
d'erreur est Smart Products.
tPaloRule
Proprits du tPaloRule
Famille de composant Business Intelligence/Cube
OLAP/Palo
Fonction Le composant tPaloRule cre ou modifie des rgles dans un cube Palo donn.
Objectif Ce composant vous permet de grer des rgles dans un cube Palo donn.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion
adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Indisponible lors de
l'utilisation d'une
connexion existante.
Server Port Saisissez le numro du port d'coute du serveur Palo.
Username et Password Informations d'authentification de l'utilisateur de Palo.
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.
Row : Iterate
Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.
Pour plus d'informations concernant les connexions, consultez le Guide utilisateur du Studio
Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient.
Cette variable est une variable After et retourne une chane de caractres. Cette variable
fonctionne uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation La mise jour et la suppression d'une rgle ne sont disponibles uniquement lorsque la rgle a t
cre avec un ID externe.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
3. Dans le champ Host name, saisissez le nom de l'hte ou l'adresse IP du serveur hte, localhost dans cet
exemple.
4. Dans le champ Server Port, saisissez le numro du port d'coute du serveur Palo. Dans ce scnario, le numro
est 7777.
5. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations
d'authentification. Dans cet exemple, les deux sont admin.
6. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle se trouvent les dimensions
appliquant les rgles, Biker dans cet exemple.
7. Dans le champ Cube, saisissez le nom du cube auquel appartiennent les dimensions appliquant les
rgles, Orders dans cet exemple.
2. Dans le tableau Cube rules, saisissez ['2009'] = 123 dans la colonneDefinition, OrderRule1dans la
colonne External Id et Palo Demo Rules dans la colonne Comment.
Excuter le Job
Appuyez sur F6 afin d'excuter le Job.
tPaloRuleList
Proprits du tPaloRuleList
Famille de composant Business Intelligence/Cube
OLAP/Palo
Fonction Le composant tPaloRuleList rcupre les informations d'une liste de rgles d'une base de donnes
Palo spcifie.
Objectif Ce composant liste toutes les rgles, les formules, les commentaires, les statuts d'activation, les
IDs externes d'un cube donn.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion
adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Indisponible lors de
l'utilisation d'une
connexion existante.
Server Port Saisissez le numro du port d'coute du serveur Palo.
Username et Password Informations d'authentification de l'utilisateur de Palo.
Row : Iterate
EXTERNAL_RULEID : ID externe de la rgle. Cette variable est une variable Flow et retourne
une chane de caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Le schma de sortie est fixe et en lecture seule.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Construire le Job
1. Dposez un composant tPaloRuleList et un tLogRow de la Palette dans l'espace de modlisation graphique.
3. Dans ce menu, slectionnez Row > Main afin de lier les deux composants.
2. Dans le champ Host name, saisissez le nom de l'hte ou l'adresse IP du serveur hte, localhost dans cet
exemple.
3. Dans le champ Server Port, saisissez le numro du port d'coute du serveur Palo, 7777 dans cet exemple.
4. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations
d'authentification. Dans cet exemple, les deux sont admin.
5. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle se trouvent les dimensions
appliquant les rgles qui vous intressent, Biker dans cet exemple.
6. Dans le champ Cube, saisissez le nom du cube auquel les rgles qui vous intressent appartiennent.
Excuter le Job
Appuyez sur F6 pour excuter le Job.
Les informations de toutes les rgles du cubeOrders sont rcupres et affiches dans la console de la vue Run.
Pour plus d'informations concernant le schma de sortie, consultez Dcouvrir le schma de sortie en lecture seule
du tPaloRuleList.
tParAccelSCD
Proprits du tParAccelSCD
Famille du Databases/
composant Business
Intelligence/
ParAccel
Fonction Le composant tParAccelSCD reflte et traque les modifications d'une table ParAccel SCD ddie.
Objectif Le tParAccelSCD rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement
une source de donnes et en rpertoriant les modifications dans une table SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
SCD Editor L'diteur SCD Editor permet de construire et de configurer les donnes du flux de sortie vers
la table Slowly Changing Dimension.
Ce champ apparat uniquement lorsqu'un SCD de Type 2 est utilis et lorsque Fixed year
value est slectionn pour crer la date de fin du SCD. Pour plus d'informations concernant
le SCD de Type 2, consultez Mthodologie de gestion du SCD.
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type
Row Main en entre.
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tPostgresPlusSCD
Proprits du tPostgresPlusSCD
Famille de Databases/Business
composant Intelligence/Postgresplus
Server
Fonction Le composant tPostgresPlusSCD reflte et traque les modifications d'une table SCD PostgresPlus ddie.
Objectif Le tPostgresPlusSCD rpond des besoins en transformation Slowly Changing Dimension, en lisant
rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat partir de la
liste Component list pour rutiliser les paramtres d'une connexion que vous avez
dj dfinie.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants
sont alors pr-remplis l'aide des donnes collectes.
DB Version Liste des versions de la base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom du schma de la base de donnes.
Username et Password Informations d'authentification de l'utilisateur de la base de donnes.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets
doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans
le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Lorsque cette option est coche, vous devez faire attention l'unicit des
cl(s) source.
Die on error Cette case est dcoche par dfaut, ce qui vous permet de terminer le traitement avec
les lignes sans erreur, et ignorer les lignes en erreur.
Advanced End date time details Spcifiez la valeur de temps du paramtre de date et heure de fin du SCD au format
settings HH:mm:ss. La valeur par dfaut pour ce champ est 12:00:00.
Ce champ apparat uniquement lorsqu'un SCD de Type 2 est utilis et lorsque Fixed
year value est slectionn pour crer la date de fin du SCD. Pour plus d'informations
concernant le SCD de Type 2, consultez Mthodologie de gestion du SCD.
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base
de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy
et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type Row
Main en entre.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tPostgresPlusSCDELT
Proprits du tPostgresPlusSCDELT
Famille de Databases/Business
composant Intelligence/
PostgresPlus
Fonction Le composant tPostgresPlusSCDELT reflte et traque les modifications d'une table PostgresPlus SCD ddie.
Objectif Le tPostgresPlusSCDELT rpond des besoins en transformation Slowly Changing Dimension, en lisant
rgulirement une source de donnes et en rpertoriant les modifications dans une table PostgresPlus SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Pour plus d'informations concernant les mthodes de cration, consultez Cls SCD.
Source Keys Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer l'unicit des
donnes entrantes.
Use SCD Type 1 Utilisez le type 1 si vous n'avez pas besoin de traquer les modifications, pour des corrections
fields typographiques par exemple. Slectionnez les colonnes du schma qui servira de rfrence
pour les modifications.
Use SCD Type 2 Utilisez le type 2 si vous avez besoin de traquer les modifications, pour garder une trace
fields des mises jour effectues par exemple. Slectionnez les colonnes du schma qui servira
de rfrence pour les modifications.
Start date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date
de dpart. Vous pouvez slectionner l'une des colonnes d'entre du schma comme date de
dpart (Start Date) dans la table SCD.
End Date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de
fin pour le journal. Lorsque le journal est en mode actif, la colonne End Date a une valeur
nulle ; pour viter cela, vous pouvez slectionner l'option Fixed Year value et saisir une
anne fictive.
Log Active Status : Ajoute une colonne votre schma SCD pour renseigner les valeurs
de statut true et false . Cette colonne permet de reprer facilement le journal actif.
Log versions : Ajoute une colonne votre schma SCD pour renseigner le numro de
version du journal.
Advanced Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
settings donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
Variables une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie et une
connexion de type Row Main.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tPostgresqlSCD
Proprits du tPostgresqlSCD
Famille de Databases/Business
composant Intelligence/Postgresql
Server
Fonction Le composant tPostgresqlSCD reflte et traque les modifications d'une table SCD Postgresql ddie.
Objectif Le tPostgresqlSCD rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement
une source de donnes et en rpertoriant les modifications dans une table SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis,
dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles,
puis cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Lorsque cette option est coche, vous devez faire attention l'unicit des cl(s)
source.
Die on error Cette case est dcoche par dfaut, ce qui vous permet de terminer le traitement avec les
lignes sans erreur, et ignorer les lignes en erreur.
Advanced End date time details Spcifiez la valeur de temps du paramtre de date et heure de fin du SCD au format
settings HH:mm:ss. La valeur par dfaut pour ce champ est 12:00:00.
Ce champ apparat uniquement lorsqu'un SCD de Type 2 est utilis et lorsque Fixed
year value est slectionn pour crer la date de fin du SCD. Pour plus d'informations
concernant le SCD de Type 2, consultez Mthodologie de gestion du SCD.
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy
et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide utilisateur
du Studio Talend.
Global NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est une
variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on error
est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type Row
Main en entre.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tPostgresqlSCDELT
Proprits du tPostgresqlSCDELT
Famille de Databases/Business
composant Intelligence/
Postgresql
Fonction Le composant tPostgresqlSCDELT reflte et traque les modifications d'une table Postgresql SCD ddie.
Objectif Le tPostgresqlSCDELT rpond des besoins en transformation Slowly Changing Dimension, en lisant
rgulirement une source de donnes et en rpertoriant les modifications dans une table Postgresql SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Pour plus d'informations concernant les mthodes de cration, consultez Cls SCD.
Source Keys Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer l'unicit des
donnes entrantes.
Use SCD Type 1 fields Utilisez le type 1 si vous n'avez pas besoin de traquer les modifications, pour des corrections
typographiques par exemple. Slectionnez les colonnes du schma qui servira de rfrence
pour les modifications.
Use SCD Type 2 fields Utilisez le type 2 si vous avez besoin de traquer les modifications, pour garder une trace
des mises jour effectues par exemple. Slectionnez les colonnes du schma qui servira
de rfrence pour les modifications.
Start date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date
de dpart. Vous pouvez slectionner l'une des colonnes d'entre du schma comme date de
dpart (Start Date) dans la table SCD.
End Date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de
fin pour le journal. Lorsque le journal est en mode actif, la colonne End Date a une valeur
nulle ; pour viter cela, vous pouvez slectionner l'option Fixed Year value et saisir une
anne fictive.
Log Active Status : Ajoute une colonne votre schma SCD pour renseigner les valeurs de
statut true et false . Cette colonne permet de reprer facilement le journal actif.
Log versions : Ajoute une colonne votre schma SCD pour renseigner le numro de version
du journal.
Advanced Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
settings donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy
et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide utilisateur
du Studio Talend.
Global ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est une
Variables variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on error
est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie et une
connexion de type Row Main.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tSPSSInput
Proprits du tSPSSInput
Famille du composant Business Intelligence
Fonction Le composant tSPSSInput lit les donnes de fichiers SPSS (.sav).
Objectif Le tSPSSInput envoie des donnes SPSS pour les crire, dans un autre fichier par exemple.
Basic settings Sync schema Cliquez sur ce bouton pour synchroniser le schma avec les colonnes
du fichier SPSS d'entre.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Vous pouvez cliquer sur Edit schema pour voir les mtadonnes qui
ont t rcupres.
File name Indiquez le nom ou le chemin d'accs au fichier SPPS lire.
Translate labels Cochez cette case pour traduire les tiquettes (labels) des valeurs
stockes.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis comme composant de dbut. Il requiert un composant de sortie.
Avant de pouvoir utiliser toutes les fonctionnalits des composants SPSS, assurez-vous
de suivre les tapes suivantes : -Si vous avez dj install SPSS, ajoutez le chemin du
rpertoire SPSS, qui se prsente comme suit : SET PATH=%PATH%;<DR>:\program
\SPSS. -Si vous n'avez pas encore install SPSS, copiez le lib SPSS IO "spssio32.dll"
partir du CD d'installation et copiez-le dans votre rpertoire "system32".
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Oracle fournit deux types de plateformes JVM (32 bits et 64 bits). Par dfaut, la JVM utilise
dans un systme d'exploitation 64 bits est la version 64 bits de cette JVM. Le fichier JSPSS.dll
utilis par ce composant est compil dans la version 32 bits de la JVM. Il est donc ncessaire de
configurer la JVM 32 bits pour excuter un Job dans un Studio Talend, install sous un systme
d'exploitation 64 bits.
3. Cochez la case Use specific JVM arguments et cliquez sur le bouton New....
4. Dans le champ Set the VM argument, saisissez -d32 et cliquez sur OK afin de valider.
Construire le Job
1. A partir de la Palette, dposez les composants tSPSSInput et tLogRow dans l'espace graphique.
2. Cliquez-droit sur le composant tPSSInput et connectez-le au tLogRow l'aide d'un lien de type Main Row.
2. Cliquez sur le bouton [...] ct du champ Filename pour parcourir vos dossiers jusqu'au fichier SPSS que
vous voulez lire.
3. Cliquez sur le bouton [...] ct du champ Sync schema. Un message apparat l'cran pour vous inviter
rcuprer le schma du fichier SPSS slectionn.
5. Si ncessaire, cliquez sur le bouton [...] ct du champ Edit schema pour visualiser la structure de donnes
prdfinie dans le fichier SPSS source.
Excuter du Job
Sauvegardez votre Job, et appuyez sur F6 afin de l'excuter.
Le fichier SPSS est lu ligne par ligne, et les champs extraits sont affichs dans la console.
1. Dans la vue Basic settings, cochez la case Translate label si vous voulez traduire les tiquettes (labels) des
valeurs stockes.
2. Cliquez nouveau sur le bouton Sync Schema, afin de rcuprer le schma aprs traduction.
Un message apparat, vous demandant si vous souhaitez rcuprer le schma du fichier SPSS dfini.
3. Cliquez sur Yes (Oui) pour fermer le message et procder l'tape suivante.
Un second message s'ouvre et vous demande si vous souhaitez propager les modifications.
4. Cliquez sur Yes (Oui) afin de fermer le message et passer l'tape suivante.
Le fichier SPSS est lu ligne par ligne et les champs extraits sont affichs sur la console de log de la vue Run,
aprs conversion des valeurs stockes.
tSPSSOutput
Proprits du tSPSSOutput
Famille du composant Business Intelligence
Fonction Le composant tSPSSOutput crit des donnes dans un fichier SPSS (.sav).
Objectif Le tSPSSOutput crit ou ajoute des donnes un fichier SPSS. Il cre les fichiers SPSS
directement ou crase ceux qui existent dj.
Basic settings Sync schema Cliquez sur ce bouton pour synchroniser le schma avec les colonnes
du fichier SPSS d'entre.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant ne peut tre utilis comme composant de dbut. Il ncessite un flux d'entre.
Avant de pouvoir utiliser toutes les fonctionnalits des composants SPSS, assurez-vous
de suivre les tapes suivantes : -Si vous avez dj install SPSS, ajoutez le chemin du
rpertoire SPSS, qui se prsente comme suit : SET PATH=%PATH%;<DR>:\program
\SPSS. -Si vous n'avez pas encore install SPSS, copiez le lib SPSS IO "spssio32.dll"
partir du CD d'installation et copiez-le dans votre rpertoire "system32".
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Oracle fournit deux types de plateformes JVM (32 bits et 64 bits). Par dfaut, la JVM utilise
dans un systme d'exploitation 64 bits est la version 64 bits de cette JVM. Le fichier JSPSS.dll
utilis par ce composant est compil dans la version 32 bits de la JVM. Il est donc ncessaire de
configurer la JVM 32 bits pour excuter un Job dans un Studio Talend, install sous un systme
d'exploitation 64 bits.
3. Cochez la case Use specific JVM arguments et cliquez sur le bouton New....
4. Dans le champ Set the VM argument, saisissez -d32 et cliquez sur OK afin de valider.
Construire le Job
1. Glissez-dposez de la Palette dans l'espace de modlisation graphique un tRowGenerator et un
tSPSSOutput.
2. Cliquez-droit sur le tRowGenerator, et connectez-le au tSPSSOutput, l'aide d'un lien Row Main.
2. Cliquez sur le bouton [+] afin d'ajouter les colonnes que vous voulez crire dans le fichier .sav.
Vrifiez que vous avez dfini la longueur de vos colonnes. Dans le cas contraire, un message d'erreur s'affichera lors
de la construction du Job.
2. Cliquez sur le bouton [...] ct du champ Filename, et parcourez votre rpertoire jusqu'au fichier SPSS .sav
dans lequel vous souhaitez crire les donnes.
3. Cliquez sur le bouton [...] ct du bouton Sync columns, afin de synchroniser les colonnes avec celles du
composant prcdent. Dans cet exemple, le schma devant tre insr dans le fichier .sav est compos de
deux colonnes : id et country.
4. Si ncessaire, cliquez sur le bouton Edit schema pour voir/diter le schma dfini.
5. Dans la liste Write Type, slectionnez Write (crire) ou Append (crire la suite), pour simplement crire
les donnes d'entre dans le fichier .sav, ou bien les crire la fin de ce mme fichier.
Excuter le Job
Sauvegardez votre Job et appuyez sur F6 pour l'excuter.
Les donnes gnres par le tRowGenerator sont crites dans le fichier .sav dfini.
tSPSSProperties
Proprits du tSPSSProperties
Famille du composant Business Intelligence
Fonction Le composant tSPSSProperties dcrit les proprits d'un fichier SPSS (.sav) dfini.
Objectif Le tSPSSProperties permet d'obtenir des informations sur les proprits principales d'un fichier
SPSS dfini.
Basic settings Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis comme composant de dbut. Il requiert un composant de sortie.
Pour pouvoir utiliser toutes les fonctionnalits des composants SPSS, assurez-vous de
suivre les tapes suivantes : -Si vous avez dj install SPSS, ajoutez le chemin du
rpertoire SPSS, qui se prsente comme suit : SET PATH=%PATH%;<DR>:\program
\SPSS. -Si vous n'avez pas encore install SPSS, copiez le lib SPSS IO "spssio32.dll"
partir du CD d'installation et copiez-le dans votre rpertoire "system32".
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Oracle fournit deux types de plateformes JVM (32 bits et 64 bits). Par dfaut, la JVM utilise
dans un systme d'exploitation 64 bits est la version 64 bits de cette JVM. Le fichier JSPSS.dll
utilis par ce composant est compil dans la version 32 bits de la JVM. Il est donc ncessaire de
configurer la JVM 32 bits pour excuter un Job dans un Studio Talend, install sous un systme
d'exploitation 64 bits.
3. Cochez la case Use specific JVM arguments et cliquez sur le bouton New....
4. Dans le champ Set the VM argument, saisissez -d32 et cliquez sur OK afin de valider.
Scnario associ
Pour des scnarios associs, consultez :
tSPSSStructure
Proprits du tSPSSStructure
Famille du composant Business Intelligence
Fonction Le composant tSPSSStructure rcupre les informations sur les variables contenues dans le
fichier SPSS (.sav).
Objectif Le tSPSSStructure traite les variables contenues dans des fichiers SPSS. Vous pouvez utiliser
ce composant avec le tFileList pour rcuprer les informations des fichiers *.sav existant et les
utiliser pour analyser de manire plus approfondie ou pour vrifier vos rsultats.
Basic settings Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis comme composant de dbut. Il requiert un composant de sortie.
Avant de pouvoir utiliser toutes les fonctionnalits des composants SPSS, assurez-vous
de suivre les tapes suivantes : -Si vous avez dj install SPSS, ajoutez le chemin du
rpertoire SPSS, qui se prsente comme suit : SET PATH=%PATH%;<DR>:\program
\SPSS. -Si vous n'avez pas encore install SPSS, copiez le lib SPSS IO "spssio32.dll"
partir du CD d'installation et copiez-le dans votre rpertoire "system32".
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Oracle fournit deux types de plateformes JVM (32 bits et 64 bits). Par dfaut, la JVM utilise
dans un systme d'exploitation 64 bits est la version 64 bits de cette JVM. Le fichier JSPSS.dll
utilis par ce composant est compil dans la version 32 bits de la JVM. Il est donc ncessaire de
configurer la JVM 32 bits pour excuter un Job dans un Studio Talend, install sous un systme
d'exploitation 64 bits.
3. Cochez la case Use specific JVM arguments et cliquez sur le bouton New....
4. Dans le champ Set the VM argument, saisissez -d32 et cliquez sur OK afin de valider.
Scnario associ
Pour des scnarios associs, consultez :
tSybaseSCD
Proprits du tSybaseSCD
Famille du Databases/Business
composant Intelligence/Sybase
Fonction Le composant tSybaseSCD reflte et traque les modifications d'une table SCD Sybase ddie.
Objectif Le tSybaseSCD rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une
source de donnes et en rpertoriant les modifications dans une table SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants
sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis,
dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles,
puis cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Ce champ apparat uniquement lorsqu'un SCD de Type 2 est utilis et lorsque Fixed
year value est slectionn pour crer la date de fin du SCD. Pour plus d'informations
concernant le SCD de Type 2, consultez Mthodologie de gestion du SCD.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
donnes.
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy
et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide utilisateur
du Studio Talend.
Global NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est une
variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on error
est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type Row
Main en entre.
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces fichiers .jar
manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide d'installation et de
migration Talend.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tSybaseSCDELT
Proprits du tSybaseSCDELT
Famille du Databases/
composant Business
Intelligence/
Sybase
Fonction Le composant tSybaseSCDELT reflte et traque les modifications d'une table Sybase SCD ddie.
Objectif Le tSybaselSCDELT rpond des besoins en transformation Slowly Changing Dimension, en lisant
rgulirement une source de donnes et en rpertoriant les modifications dans une table Sybase SCD ddie.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement le Guide
utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Surrogate Key Slectionnez dans la liste une colonne utiliser comme cl de substitution.
Creation Slectionnez la mthode utiliser pour gnrer la cl de substitution.
Pour plus d'informations concernant les mthodes de cration, consultez Cls SCD.
Source Key Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer l'unicit des donnes
entrantes.
Use SCD Type Utilisez le type 1 si vous n'avez pas besoin de traquer les modifications, pour des corrections
1 fields typographiques par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour
les modifications.
Use SCD Type Utilisez le type 2 si vous avez besoin de traquer les modifications, pour garder une trace des mises
2 fields jour effectues par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour
les modifications.
Start date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de
dpart. Vous pouvez slectionner l'une des colonnes d'entre du schma comme date de dpart
(Start Date) dans la table SCD.
End Date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de fin
pour le journal. Lorsque le journal est en mode actif, la colonne End Date a une valeur nulle ;
pour viter cela, vous pouvez slectionner l'option Fixed Year value et saisir une anne fictive.
Log Active Status : Ajoute une colonne votre schma SCD pour renseigner les valeurs de statut
true et false. Cette colonne permet de reprer facilement le journal actif.
Log versions : Ajoute une colonne votre schma SCD pour renseigner le numro de version
du journal.
Advanced Additional Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option
settings JDBC n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic
parameters settings.
Debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie et une
connexion de type Row Main.
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
tVerticaSCD
Proprits du tVerticaSCD
Famille de Databases/
composant Vertica
Fonction Le composant tVerticaSCD reflte et traque les modifications d'une table Vertica SCD ddie.
Objectif Le tVerticaSCD rpond des besoins en transformation Slowly Changing Dimension, en lisant rgulirement
une source de donnes et en rpertoriant les modifications dans une table SCD ddie.
Basic settings Property Peut tre Built-in ou Repository.
type
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste Component
existing list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion cre
par le Job parent avec le Job enfant, vous devez :
Create a table if not exists : la table est cre si elle n'existe pas.
Schema et Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs au
Edit schema composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock dans
le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si vous souhaitez
propager les modifications uniquement au Job courant, slectionnez No et slectionnez nouveau
la mtadonne du schma dans la fentre [Repository Content].
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement le Guide
utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir
galement le Guide utilisateur du Studio Talend.
SCD Editor L'diteur SCD Editor permet de construire et de configurer les donnes du flux de sortie vers la table
Slowly Changing Dimension.
Ce champ apparat uniquement lorsqu'un SCD de Type 2 est utilis et lorsque Fixed year value est
slectionn pour crer la date de fin du SCD. Pour plus d'informations concernant le SCD de Type
2, consultez Mthodologie de gestion du SCD.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau des composants.
Statistics
Debug Cochez cette case pour afficher chaque tape durant le traitement des entres dans une base de
mode donnes.
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de sortie. Il ncessite un composant d'entre et un lien Row > Main en entre.
Conseils et techniques
Utiliss ensemble, le Studio Talend et la base de donnes Vertica permettent de crer des applications d'entrept de
donnes et de datamart trs rapides et abordables. Pour plus d'informations sur la manire de configurer le Studio
Talend pour se connecter Vertica, consultez Talend and HP Vertica Tips and Techniques (en anglais).
Scnario associ
Pour un scnario associ, consultez tMysqlSCD.
Les bases de donnes, les services de donnes et les applications bases SaaS (CRM, HR, ERP, etc.) hbergs
dans des clouds privs et publics se multiplient, accompagns d'applications et de bases de donnes sur site
qui constituent le fondement de l'informatique d'entreprise
La famille Cloud regroupe les connecteurs de bases de donnes les plus populaires. Ces connecteurs couvrent
divers besoins : ouverture de connexion, lecture et criture de tables, commit de transactions, ainsi que des
rollbacks pour le traitement des erreurs.
tAmazonAuroraClose
Proprits du tAmazonAuroraClose
Famille de composant Cloud/AmazonRDS/
Aurora
Fonction Le composant tAmazonAuroraClose ferme une connexion active une instance de la base de donnes
Amazon Aurora.
Objectif Ce composant vous permet de fermer une connexion active une instance d'une base de donnes Amazon
Aurora afin de librer des ressources.
Basic settings Component List Slectionnez dans la liste le composant tAmazonAuroraConnection ouvrant
la connexion fermer.
Advanced settings tStatCatcher Statistics Cochez cette case afin de collecter les donnes de log au niveau du Job ainsi
qu'au niveau de chaque composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues
dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes
ayant la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Amazon Aurora, notamment avec le
tAmazonAuroraConnection et le tAmazonAuroraCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
La base de donnes Aurora est compatible avec MySQL v5.6. Pour un scnario similaire, consultez :
Scnario 3 : Lire des donnes dans des bases de donnes MySQL l'aide de connexions dynamiques bases
sur les variables de contexte.
tAmazonAuroraCommit
Proprits du tAmazonAuroraCommit
Famille de composant Cloud/AmazonRDS/
Aurora
Fonction Le composant tAmazonAuroraCommit valide les donnes traites par le Job dans la base de donnes
connecte Amazon Aurora.
Objectif A l'aide d'une connexion unique, ce composant commite en une fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous devez
utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component List Slectionnez le composant tAmazonAuroraConnection pour lequel vous
souhaitez commiter l'action effectuer.
Close Connection Cette option est coche par dfaut. Elle permet de fermer la connexion la base
de donnes une fois le commit effectu. Dcochez cette case pour continuer
utiliser la connexion une fois que le composant a excut sa tche.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Amazon Aurora, notamment avec le
tAmazonAuroraConnection et le tAmazonAuroraRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
La base de donnes Aurora est compatible avec MySQL v5.6. Pour un scnario similaire, consultez :
tAmazonAuroraConnection
Proprits du tAmazonAuroraConnection
Famille de composant Cloud/AmazonRDS/
Aurora
Fonction Le composant tAmazonAuroraConnection ouvre une connexion une instance de la base de donnes
Amazon Aurora.
Objectif Ce composant vous permet d'ouvrir une connexion une instance de la base de donnes pouvant tre
rutilise par d'autres composants Amazon Aurora.
Basic settings Property Type Peut tre Built-In ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits
du composant. Les champs suivants sont alors pr-remplis l'aide des donnes
collectes.
Host Saisissez l'adresse IP ou le nom de l'hte de la base de donnes Amazon Aurora.
Port Saisissez le numro du port d'coute de la base de donnes Amazon Aurora.
Database Saisissez le nom de la base de donnes utiliser.
Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes
parameters cre.
Username et Password Saisissez les informations d'authentification de l'utilisateur de base de donnes.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Use or register a shared Cochez cette case pour partager votre connexion ou rcuprer une connexion
DB Connection mise en partage dans un Job pre ou un Job fils. Cette option vous permet de
partager une seule connexion une base de donnes dans plusieurs composants
de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui
peuvent tre des Jobs parent ou enfant.
Cette option est incompatible avec les options Use dynamic job et
Use an independent process to run subjob du composant tRunJob.
Utiliser une connexion partage avec un tRunJob ayant l'une de ces
options active fera chouer votre Job.
Cette case est indisponible lorsque la case Specify a data source alias est
coche.
Shared DB Connection Saisissez le nom de la connexion partage.
Name
Ce champ s'affiche uniquement lorsque la case Use or register a shared DB
Connection est coche.
Specify a data source Cochez cette case et spcifiez l'alias de la source de donnes cre dans
alias Talend Runtime pour utiliser le pool de connexions partages dfini dans
la configuration des donnes source. Cette option fonctionne lorsque vous
dployez et excutez votre Job dans Talend Runtime.
Ce champ s'affiche lorsque la case Specify a data source alias est coche.
Advanced settings Auto Commit Cochez cette case afin de commiter automatiquement toute modification dans
la base de donnes lorsque la transaction est termine.
Lorsque cette case est coche, vous ne pouvez utiliser les composants de
commit correspondant pour commiter les modifications dans la base de
donnes. De la mme manire, lorsque vous utilisez un composant de commit,
cette case doit tre dcoche. Par dfaut, la fonctionnalit d'auto-commit est
dsactive et les modifications doivent tre commites de manire explicite
l'aide du composant correspondant de commit.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Amazon Aurora, notamment avec le
tAmazonAuroraCommit et le tAmazonAuroraRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
La base de donnes Aurora est compatible avec MySQL v5.6. Pour un scnario similaire, consultez :
Scnario 2 : Partager une connexion de base de donnes entre un Job pre et un Job fils.
tAmazonAuroraInput
Proprits du tAmazonAuroraInput
Famille de composant Cloud/AmazonRDS/
Aurora
Fonction Le composant tAmazonAuroraInput lit une base de donnes Amazon Aurora et en extrait des champs
l'aide de requtes.
Objectif Ce composant excute une requte en base de donnes selon un ordre strict qui doit correspondre celui
dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une
connexion de flux Row > Main.
Basic settings Property Type Peut tre Built-In ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits
du composant. Les champs suivants sont alors pr-remplis l'aide des donnes
collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir
connection de la liste Component list pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (Built-in),
soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Cette case est indisponible lorsque la case Use an existing connection est
coche.
Data source alias Saisissez l'alias de la source de donnes cre du ct Talend Runtime.
Ce champ s'affiche uniquement lorsque la case Specify a data source alias est
coche.
Advanced settings Additional JDBC Spcifiez des informations supplmentaires de connexion la
parameters base de donnes cre. Lorsque vous devez grer des donnes
de type 0000-00-00 00:00:00 l'aide de ce composant,
configurez le paramtre noDatetimeStringSync=true&zeroDa-
teTimeBehavior=convertToNull.
L'option est indisponible lorsque la case Trim all the String/Char columns
est coche.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi qu'au
niveau de chaque composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues
dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes
ayant la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette
variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de dbut dans un Job ou sous-job et ncessite
un lien de sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
La base de donnes Aurora est compatible avec MySQL v5.6. Pour un scnario similaire, consultez :
Scnario 1 : Ecrire des colonnes d'une base de donnes MySQL dans un fichier de sortie.
Scnario 3 : Lire des donnes dans des bases de donnes MySQL l'aide de connexions dynamiques bases
sur les variables de contexte.
tAmazonAuroraOutput
Proprits du tAmazonAuroraOutput
Famille de Cloud/AmazonRDS/Aurora
composant
Fonction Le composant tAmazonAuroraOutput crit, met jour, modifie ou supprime des entres dans une base de
donnes Amazon Aurora.
Objectif Ce composant exctue l'action dfinie sur la table et/ou sur les donnes contenues dans la table, en fonction du
flux entrant du composant prcdent dans le Job.
Basic settings Property Type Peut tre Built-In ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat partir de
la liste Component list pour rutiliser les paramtres d'une connexion que vous
avez dj dfinie.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets
doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Table Saisissez le nom de la table crire. Notez qu'une table peut tre crite la fois.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en
crer une nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il
peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des
entiers (integer) ou des fonctions (function), assurez-vous que les valeurs par
dfaut ne sont pas entoures de guillemets. Si c'est le cas, vous devez supprimer
manuellement les guillemets.
Cette case est indisponible lorsque la case Use an existing connection est coche.
Data source alias Saisissez l'alias de la source de donnes cre du ct Talend Runtime.
Ce champ s'affiche uniquement lorsque la case Specify a data source alias est
coche.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette
case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en
erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela,
utilisez un lien Row > Rejects.
Advanced Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes
settings parameters cre. Cette option est disponible lorsque la case Use an existing connection est
dcoche dans les Basic settings.
Cette case est disponible lorsque l'option Insert est slectionne dans la liste
Action on data, dans l'onglet Basic settings.
Cette option n'est pas compatible avec le lien Reject. Vous devez donc
la dcocher si vous utilisez un lien Reject en sortie du composant.
Number of rows per insert Saisissez le nombre de lignes insrer par opration. Notez que, plus haute est
la valeur spcifie, plus la performance est basse, cause de la consommation de
mmoire.
Cette case est disponible uniquement si vous avez choisi l'option Update ou Delete
dans la liste Action on data de la vue Basic settings.
Batch Size Saisissez le nombre de lignes traiter dans chaque lot.
Ce champ est disponible lorsque la case Use Batch Size est coche.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base.
Cette option garantit la qualit de la transaction (cependant pas de rollback) et
surtout une meilleure performance d'excution.
Additional columns Cette option n'est pas disponible si vous venez de crer la table de donnes (que
vous l'ayez pralablement supprime ou non). Cette option vous permet d'effectuer
des actions sur les colonnes, l'exclusion des actions d'insertion, de mise jour, de
suppression ou qui ncessitent un prtraitement particulier. Cliquez sur le bouton
[+] sous la table pour ajouter des colonnes et configurez les paramtres suivants
pour chaque colonne.
Reference column : saisissez une colonne de rfrence pouvant tre utilise par
le tAmazonAuroraOutput pour localiser ou remplacer la nouvelle colonne ou
la colonne modifier.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs
actions sur les donnes.
Cette case est disponible lorsque l'option Insert est slectionne dans la liste
Action on data de la vue Basic settings.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi qu'au
niveau de chaque composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette variable
est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de sortie. Il vous permet d'effectuer des actions sur
les donnes d'une table dans une base de donnes Amazon Aurora. Il permet galement de crer un flux de
rejet, l'aide d'un lien Row > Rejects afin de filtrer les donnes en erreur. Pour un scnario similaire, consultez
Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
La base de donnes Aurora est compatible avec MySQL v5.6. Pour des scnarios associs, consultez :
tAmazonAuroraRollback
Proprits du tAmazonAuroraRollback
Famille de composant Cloud/AmazonRDS/
Aurora
Fonction Le composant tAmazonAuroraRollback annule la transaction dans une base de donnes connecte
Amazon Aurora.
Objectif Ce composant vous permet d'annuler des modifications apportes la base de donnes Amazon Aurora
pour viter le commit de transaction involontaire si une erreur survient.
Basic settings Component List Slectionnez le composant tAmazonAuroraConnection pour lequel effectuer
l'action de rollback.
Close Connection Cette case est coche par dfaut est vous permet de fermer la connexion la base
de donnes une fois le rollback effectu. Dcochez cette case pour continuer
utiliser la connexion slectionne une fois sa tche termine.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi qu'au
niveau de chaque composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues
dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes
ayant la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Amazon Aurora, notamment avec le
tAmazonAuroraConnection et le tAmazonAuroraCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
La base de donnes Aurora est compatible avec MySQL v5.6. Pour un scnario similaire, consultez :
tAmazonMysqlClose
Proprits du tAmazonMysqlClose
Fonction Le composant tAmazonMysqlClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tAmazonMysqlConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant doit tre utilis avec des composants AmazonMysql, notamment avec le
tAmazonMysqlCommit et le tAmazonMysqlConnection.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tAmazonMysqlConnection et tAmazonMysqlRollback. Il est
gnralement utilis avec un composant tAmazonMysqlConnection car il permet de fermer une connexion pour
la transaction en cours.
tAmazonMysqlCommit
Proprits du tAmazonMysqlCommit
Famille de composant Cloud/AmazonRDS/
MySQL
Fonction Le composant AmazontMysqlCommit valide les donnes traites dans un Job partir d'une base
de donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tAmazonMysqlConnection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants AmazonMysql et notamment avec les
composants tAmazonMysqlConnection et tAmazonMysqlRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tAmazonMysqlCommit, consultez Scnario 1 : Insrer des donnes dans
des tables mre/fille.
tAmazonMysqlConnection
Proprits du tAmazonMysqlConnection
Famille de composant Cloud/AmazonRDS/
MySQL
Fonction Le composant tAmazonMysqlConnection ouvre une connexion vers une base de donnes afin
d'effectuer une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants AmazonMysql, notamment avec les
composants tAmazonMysqlCommit et tAmazonMysqlRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario utilisant ce composant, consultez Scnario 1 : Insrer des donnes dans des tables mre/fille
tAmazonMysqlInput
Proprits du tAmazonMysqlInput
Famille de composant Cloud/AmazonRDS/
MySQL
Fonction Le composant tAmazonMysqlInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tAmazonMysqlInput excute une requte en base de donnes selon un ordre strict qui doit
correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au
composant suivant via une connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits
du composant. Les champs suivants sont alors pr-remplis l'aide des donnes
collectes.
DB Version MySQL 5 est disponible.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de
connection la liste Component list pour rutiliser les paramtres d'une connexion que vous
avez dj dfinie.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui sont
traits et passs au composant suivant. Le schma est soit local (Built-in) , soit
distant dans le Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
noDatetimeStringSync=true&zero-
DateTimeBehavior=convertToNull.
Enable stream Cochez cette case pour dterminer avec quelles lignes vous souhaitez travailler.
Cette option permet d'amliorer les performances.
Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans
columns toutes les colonnes contenant des chanes de caractres.
Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes
slectionnes.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette
variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes MySQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour des scnarios associs, consultez tMysqlInput.
tAmazonMysqlOutput
Proprits du tAmazonMysqlOutput
Famille de composant Cloud/AmazonRDS/
MySQL
Fonction Le composant tAmazonMysqlOutput crit, met jour, modifie ou supprime les donnes d'une base de
donnes.
Objectif Le tAmazonMysqlOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en
fonction du flux entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
DB Version MySQL 5 est disponible.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir
connection de la liste Component list pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis
en crer une nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des
entiers (integer) ou des fonctions (function), assurez-vous que les valeurs par
dfaut ne sont pas entoures de guillemets. Si c'est le cas, vous devez supprimer
manuellement les guillemets.
Cette option n'est pas compatible avec le lien Reject. Vous devez
donc la dcocher si vous utilisez un lien Reject en sortie du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues
dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes
ayant la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette
variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne
un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un
entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne
un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne
un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits
des requtes SQL.
Ce composant doit tre utilis en tant que composant de sortie. Il permet de faire des actions sur une table
ou les donnes d'une table d'une base de donnes MySQL. Il permet aussi de crer un flux de rejet avec un
lien Row > Reject filtrant les donnes en erreur. Pour un exemple d'utilisation du tAmazonMysqlOutput,
consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour des scnarios associs, consultez tMysqlSCD.
tAmazonMysqlRollback
Proprits du tAmazonMysqlRollback
Famille de composant Cloud/AmazonRDS/Mysql
Fonction Le composant tAmazonMysqlRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant tAmazonMysqlConnection dans la liste
s'il y a plus d'une connexion dans votre Job.
Close connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants AmazonMySQL, notamment les
composants tAmazonMysqlConnection et tAmazonMysqlCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Scnario : Annuler l'insertion de donnes dans des tables mre/fille.
tAmazonMysqlRow
Proprits du tAmazonMysqlRow
Famille de composant Cloud/Amazon/MySQL
Fonction Le composant tAmazonMysqlRow est le composant spcifique ce type de base de donnes. Il excute
des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant
met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, le tAmazonMysqlRow agit sur la structure mme
de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider
rapidement et aisment crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
DB Version MySQL 5 est disponible.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir
connection de la liste Component list pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (built-in)
soit distant dans le Repository.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi,
il peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des
entiers (integer) ou des fonctions (function), assurez-vous que les valeurs par
dfaut ne sont pas entoures de guillemets. Si c'est le cas, vous devez supprimer
manuellement les guillemets.
Cette option est trs utile si vous devez effectuer de nombreuses fois
la mme requte. Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans
la base. Cette option garantit la qualit de la transaction (cependant pas de
rollback) et surtout une meilleure performance d'excution.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues
dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes
ayant la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits
de requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez :
tAmazonOracleClose
Proprits du tAmazonOracleClose
Fonction Le composant tAmazonOracleClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes AmazonOracle.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tAmazonOracleConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants AmazonOracle, notamment
tAmazonOracleConnection et tAmazonOracleCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tAmazonOracleConnection et tAmazonOracleRollback. Il
est gnralement utilis avec un composant tAmazonOracleConnection car il permet de fermer une connexion
pour la transaction en cours.
tAmazonOracleCommit
Proprits du tAmazonOracleCommit
Famille de composant Cloud/AmazonRDS/Oracle
Fonction Le composant tAmazonOracleCommit valide les donnes traites dans un Job partir d'une base
de donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tAmazonOracleConnection dans la liste.
Close Connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants AmazonOracle et notamment
tAmazonOracleConnection et tAmazonOracleRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tAmazonOracleCommit, consultez Scnario 1 : Insrer des donnes dans
des tables mre/fille.
tAmazonOracleConnection
Proprits du tAmazonOracleConnection
Famille de composant Cloud/AmazonRDS/Oracle
Fonction Le composant tAmazonOracleConnection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir la
rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits
du composant. Les champs suivants sont alors pr-remplis l'aide des
donnes collectes.
Connection type Liste droulante des pilotes disponibles :
Select a DB Connection in Tns File : Cliquez sur le bouton [...] pour afficher
tous les contextes du fichier Tns et slectionner celui utiliser.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom du schma
Username et Password Informations d'authentification de l'utilisateur de base de donnes.
Use or register a shared DB Cochez cette case pour partager votre connexion ou rcuprer une connexion
Connection mise en partage dans un Job pre ou un Job fils. Cette option vous permet
de partager une seule connexion une base de donnes dans plusieurs
composants de connexion des bases de donnes, dans diffrents niveaux de
Jobs, qui peuvent tre des Jobs parent ou enfant.
Cette option est incompatible avec les options Use dynamic job et
Use an independent process to run subjob du composant tRunJob.
Utiliser une connexion partage avec un tRunJob ayant l'une de
ces options active fera chouer votre Job.
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la base
de donnes. De la mme manire, lorsque vous utilisez un composant de
commit, cette case doit tre dcoche. Par dfaut, la fonctionnalit d'auto-
commit est dsactive et les modifications doivent tre commites de manire
explicite l'aide du composant correspondant de commit.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants AmazonOracle, notamment les composants
tAmazonOracleCommit et tAmazonOracleRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tAmazonOracleConnection, consultez tMysqlConnection.
tAmazonOracleInput
Proprits du tAmazonOracleInput
Famille de composant Cloud/AmazonRDS/
Oracle
Fonction Le composant tAmazonOracleInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tAmazonOracleInput excute une requte de base de donnes dans laquelle l'ordre doit strictement
correspondre l'ordre dfini dans le schma. Puis la liste des champs est transmise au composant via une
connexion Main Row.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionne le fichier dans lequel sont stockes les proprits du
composant. Les champs suivants sont alors pr-remplis l'aide des donnes
collectes.
Connection type Liste droulante des pilotes disponibles :
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (Built-in),
soit distant dans le Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette
variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes AmazonOracle.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont
pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton
Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans
l'onglet Modules de la perspective Integration de votre studio. Pour plus d'informations, consultez
la page https://help.talend.com/display/KB/How+to+install+external+modules+in+the+Talend+products
(en anglais) ou la section dcrivant comment configurer le studio, dans le Guide d'installation et de
migration Talend.
Scnarios associs
Pour des scnarios associs, consultez :
Le premier scnario du composant tDBInput, dans Scnario 1 : Afficher les donnes slectionnes partir
d'une table.
Le scnario du composant tContextLoad, dans Scnario : Lire des donnes partir de diffrentes bases de
donnes MySQL l'aide de paramtres de connexion chargs dynamiquement.
tAmazonOracleOutput
Proprits du tAmazonOracleOutput
Famille de composant Cloud/AmazonRDS/
Oracle
Fonction Le composant tAmazonOracleOutput crit, met jour, modifie ou supprime les donnes d'une base de
donnes.
Objectif Le tAmazonOracleOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en
fonction du flux entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits
du composant. Les champs suivants sont alors pr-remplis l'aide des donnes
collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir
connection de la liste Component list pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Oracle schema Nom du schma Oracle.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Action on table La liste Action on table n'est pas disponible si vous cochez la case
Enable parallel execution dans la vue Advanced settings.
Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table
slectionne :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis
en crer une nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des
entiers (integer) ou des fonctions (function), assurez-vous que les valeurs par
dfaut ne sont pas entoures de guillemets. Si c'est le cas, vous devez supprimer
manuellement les guillemets.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette
case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes
en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour
cela, utilisez un lien Row > Rejects.
Advanced settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes
parameters cre. Cette option est disponible lorsque la case Use an existing connection
est dcoche dans les Basic settings.
- HINT : spcifiez l'hint dont vous avez besoin, l'aide de la syntaxe /*+ */.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits
des requtes SQL.
Ce composant doit tre utilis en tant que composant de sortie. Il permet de faire des actions sur une
table ou les donnes d'une table d'une base de donnes AmazonOracle. Il permet aussi de crer un flux
de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple d'utilisation, consultez
Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject du composant tMysqlOutput.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette
variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne
un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un
entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne
un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne
un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont
pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton
Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans
l'onglet Modules de la perspective Integration de votre studio. Pour plus d'informations, consultez
la page https://help.talend.com/display/KB/How+to+install+external+modules+in+the+Talend+products
(en anglais) ou la section dcrivant comment configurer le studio, dans le Guide d'installation et de
migration Talend.
Scnarios associs
Pour des scnarios associs au composant tAmazonOracleOutput, consultez :
tDBOutput : dans Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion
ODBC.
tAmazonOracleRollback
Proprits du tAmazonOracleRollback
Famille de composant Cloud/AmazonRDS/Oracle
Fonction Le composant tAmazonOracleRollback annule la transaction dans une base de donnes
connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant AmazontOracleConnection dans la liste
s'il y a plus d'une connexion dans votre Job.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants AmazonOracle, notamment les
composants tAmazonOracleConnection et tAmazonOracleCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tAmazonOracleRollback, consultez tMysqlRollback.
tAmazonOracleRow
Proprits du tAmazonOracleRow
Famille de composant Cloud/AmazonRDS/
Oracle
Fonction Le composant tAmazonOracleRow est le composant spcifique ce type de base de donnes. Il excute
des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant
met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, le tAmazonOracleRow agit sur la structure mme
de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider
rapidement et aisment crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir
connection de la liste Component list pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (Built-in),
soit distant dans le Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de
SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ
Query est renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des
champs afin qu'ils correspondent la dfinition du schma.
Use NB_LINE_ Cette option vous permet d'alimenter la variable afin de passer au sous-job ou
au composant suivant le nombre de lignes mises jour/supprimes/insres. Ce
champ s'applique uniquement si la requte saisie dans le champ Query est une
requte INSERT, UPDATE ou DELETE.
Cette option est trs utile si vous devez effectuer de nombreuses fois
la mme requte. Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans
la base. Cette option garantit la qualit de la transaction (cependant pas de
rollback) et surtout une meilleure performance d'excution.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues
dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes
ayant la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne
un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un
entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne
un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits
de requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour des scnarios associs, consultez :
tBoxConnection
Proprits du tBoxConnection
Famille de composant Cloud/Box
Fonction Ce composant cre une connexion un compte Box donn.
Objectif Le composant tBoxConnection cre une connexion Box que les autre composants Box peuvent
rutiliser.
Basic settings Client Key Saisissez la cl client requise par Box afin d'accder l'API de Box.
Afin d'obtenir la cl client et le Secret du client, vous devez crer
un compte sur https://developers.box.com/ puis crer une application
Box sous le compte Box utilis. La cl client et le Secret du
client peuvent tre obtenus depuis les paramtres de l'application du
compte.
Client Secret Saisissez le Secret du client requis par Box afin d'accder l'API
de Box. Afin d'obtenir la cl client et le Secret du client, vous
devez crer un compte sur https://developers.box.com/ puis crer une
application Box sous le compte Box utilis. La cl client et le Secret
du client peuvent tre obtenus depuis les paramtres de l'application
du compte.
Access token Renseignez le jeton d'accs requis par Box afin d'accder au compte
Box et le faire fonctionner. Pour plus d'informations concernant
l'obtention du jeton d'accs et du jeton de rafrachissement, consultez
l'exemple disponible sur https://github.com/box/box-java-sdk-v2/
wiki/HelloWorld.
Refresh Token Renseignez le jeton de rafrachissement requis par Box afin
de rafrachir automatiquement le jeton d'accs. Pour plus
d'informations concernant l'obtention du jeton d'accs et du jeton
de rafrachissement, consultez l'exemple disponible sur https://
github.com/box/box-java-sdk-v2/wiki/HelloWorld.
Use HTTP proxy Si vous utilisez un proxy, cochez cette case et saisissez les
informations d'hte et de port dans les champs correspondants qui
s'affichent.
Advanced settings tStatCatcher Statistics Cochez cette case afin de collecter les informations de log au niveau
du composant.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis en standalone en tant que sous-job afin de crer la connexion Box utilise.
Dans un Job, il est souvent reli aux autres composants Box l'aide de liens Trigger tel que le
lien OnSubjobOk.
Limitation n/a
Scnario associ
Pour un scnario associ, consultez Scnario : Charger et tlcharger des fichiers depuis Box.
tBoxCopy
Proprits du tBoxCopy
Famille de composant Cloud/Box
Fonction Ce composant se connecte un compte Box et copie ou dplace un fichier ou un dossier donn.
Objectif Le composant tBoxCopy copie ou dplace un dossier ou un fichier donn au sein de Box.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Connection/Client Key Saisissez la cl client requise par Box afin d'accder l'API de Box.
Afin d'obtenir la cl client et le Secret du client, vous devez crer
un compte sur https://developers.box.com/ puis crer une application
Box sous le compte Box utilis. La cl client et le Secret du
client peuvent tre obtenus depuis les paramtres de l'application du
compte.
Connection/Client Secret Saisissez le Secret du client requis par Box afin d'accder l'API
de Box. Afin d'obtenir la cl client et le Secret du client, vous
devez crer un compte sur https://developers.box.com/ puis crer une
application Box sous le compte Box utilis. La cl client et le Secret
du client peuvent tre obtenus depuis les paramtres de l'application
du compte.
Connection/Access Token Renseignez le jeton d'accs requis par Box afin d'accder au compte
Box et le faire fonctionner. Pour plus d'informations concernant
l'obtention du jeton d'accs et du jeton de rafrachissement, consultez
l'exemple disponible sur https://github.com/box/box-java-sdk-v2/
wiki/HelloWorld.
Connection/Refresh Token Renseignez le jeton de rafrachissement requis par Box afin
de rafrachir automatiquement le jeton d'accs. Pour plus
d'informations concernant l'obtention du jeton d'accs et du jeton
de rafrachissement, consultez l'exemple disponible sur https://
github.com/box/box-java-sdk-v2/wiki/HelloWorld.
Connection/Use HTTP Si vous utilisez un proxy, cochez cette case et saisissez les
proxy informations d'hte et de port dans les champs correspondants qui
s'affichent.
Move Directory Cochez cette case afin de dplacer un dossier au sein de Box.
Copy Directory Cochez cette case afin de copier un dossier au sein de Box.
File Name Saisissez le nom du fichier que vous souhaitez copier ainsi que son
chemin dans Box.
Source Directory Cette option n'est disponible que si vous avez coch la case Move
Directory ou la case Copy Directory. Saisissez le nom du rpertoire
source dans Box copier ou dplacer.
Destination Directory Saisissez le nom du dossier cible dans Box dans lequel vous
souhaitez copier ou dplacer le fichier ou le dossier spcifi.
Rename Cochez cette case afin de renommer le fichier ou le dossier copi.
Lorsque vous copiez un fichier, saisissez le nouveau nom du fichier
dans le champ Destination File Name. Lorsque vous copiez un
dossier, saisissez le nouveau nom du dossier dans le champ New
Directory Name.
Remove Source File Cochez cette case afin de supprimer le fichier source pendant l'action
de copie.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
DESTINATION_FILENAME : nom du fichier cible. Cette variable est une variable After et
retourne une chane de caractres.
DESTINATION_FILEPATH : chemin d'accs au fichier cible. Cette variable est une variable
After et retourne une chane de caractres.
SOURCE_DIRECTORY : rpertoire source. Cette variable est une variable After et retourne une
chane de caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en standalone dans un sous-job afin de copier ou dplacer
des donnes au sein de Box.
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tBoxDelete
Proprits du tBoxDelete
Famille de composant Cloud/Box
Fonction Ce composant se connecte un compte Box et supprime un fichier ou un dossier dfini.
Objectif Le composant tBoxDelete supprime un fichier ou dossier depuis Box.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Connection/Client Key Saisissez la cl client requise par Box afin d'accder l'API de Box.
Afin d'obtenir la cl client et le Secret du client, vous devez crer
un compte sur https://developers.box.com/ puis crer une application
Box sous le compte Box utilis. La cl client et le Secret du
client peuvent tre obtenus depuis les paramtres de l'application du
compte.
Connection/Client Secret Saisissez le Secret du client requis par Box afin d'accder l'API
de Box. Afin d'obtenir la cl client et le Secret du client, vous
devez crer un compte sur https://developers.box.com/ puis crer une
application Box sous le compte Box utilis. La cl client et le Secret
du client peuvent tre obtenus depuis les paramtres de l'application
du compte.
Connection/Access Token Renseignez le jeton d'accs requis par Box afin d'accder au compte
Box et le faire fonctionner. Pour plus d'informations concernant
l'obtention du jeton d'accs et du jeton de rafrachissement, consultez
l'exemple disponible sur https://github.com/box/box-java-sdk-v2/
wiki/HelloWorld.
Connection/Refresh Token Renseignez le jeton de rafrachissement requis par Box afin
de rafrachir automatiquement le jeton d'accs. Pour plus
d'informations concernant l'obtention du jeton d'accs et du jeton
de rafrachissement, consultez l'exemple disponible sur https://
github.com/box/box-java-sdk-v2/wiki/HelloWorld.
Connection/Use HTTP Si vous utilisez un proxy, cochez cette case et saisissez les
proxy informations d'hte et de port dans les champs correspondants qui
s'affichent.
Path Saisissez le chemin sur Box pointant vers le dossier ou le fichier que
vous souhaitez supprimer.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
REMOVED_PATH : chemin d'accs au dossier ou fichier supprim sur Box. Cette variable est
une variable Flow et retourne une chane de caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en standalone dans un sous-job afin de supprimer des
donnes depuis Box.
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tBoxGet
Proprits du tBoxGet
Famille de composant Cloud/Box
Fonction Ce composant se connecte un compte Box donn et tlcharge des fichiers vers un rpertoire
local dfini.
Objectif Le composant tBoxGet tlcharge un fichier depuis un compte Box.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Connection/Client Key Saisissez la cl client requise par Box afin d'accder l'API de Box.
Afin d'obtenir la cl client et le Secret du client, vous devez crer
un compte sur https://developers.box.com/ puis crer une application
Box sous le compte Box utilis. La cl client et le Secret du
client peuvent tre obtenus depuis les paramtres de l'application du
compte.
Connection/Client Secret Saisissez le Secret du client requis par Box afin d'accder l'API
de Box. Afin d'obtenir la cl client et le Secret du client, vous
devez crer un compte sur https://developers.box.com/ puis crer une
application Box sous le compte Box utilis. La cl client et le Secret
du client peuvent tre obtenus depuis les paramtres de l'application
du compte.
Connection/Access Token Renseignez le jeton d'accs requis par Box afin d'accder au compte
Box et le faire fonctionner. Pour plus d'informations concernant
l'obtention du jeton d'accs et du jeton de rafrachissement, consultez
l'exemple disponible sur https://github.com/box/box-java-sdk-v2/
wiki/HelloWorld.
Connection/Refresh Token Renseignez le jeton de rafrachissement requis par Box afin
de rafrachir automatiquement le jeton d'accs. Pour plus
d'informations concernant l'obtention du jeton d'accs et du jeton
de rafrachissement, consultez l'exemple disponible sur https://
github.com/box/box-java-sdk-v2/wiki/HelloWorld.
Connection/Use HTTP Si vous utilisez un proxy, cochez cette case et saisissez les
proxy informations d'hte et de port dans les champs correspondants qui
s'affichent.
Path Saisissez le chemin d'accs Box pointant vers le fichier
tlcharger.
Save as file Cochez cette case pour afficher le champ Save To et parcourez
votre systme, ou saisissez le chemin d'accs au rpertoire local
dans lequel stocker le fichier tlcharg. Si le fichier existe, il est
remplac.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
FILE_NAME : nom du fichier trait. Cette variable est une variable Flow et retourne une chane
de caractres.
INPUT_STREAM : le contenu du fichier rcupr. Cette variable est une variable Flow et retourne
une classe InputStream.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis seul ou avec d'autres composants via un lien Iterate ou un lien
Trigger tel que OnSubjobOk.
Limitation n/a
Scnario associ
Pour un scnario associ, consultez Scnario : Charger et tlcharger des fichiers depuis Box.
tBoxList
Proprits du tBoxList
Famille de composant Cloud/Box
Fonction Ce composant lit un (des) fichier(s) sur Box dans le rpertoire dfini et liste les mtadonnes et
les contenus de ce (ces) fichier(s).
Objectif Le composant tBoxList liste des fichiers stocks dans un rpertoire dfini sur Box.
Connection/Client Key Saisissez la cl client requise par Box afin d'accder l'API de Box.
Afin d'obtenir la cl client et le Secret du client, vous devez crer
un compte sur https://developers.box.com/ puis crer une application
Box sous le compte Box utilis. La cl client et le Secret du
client peuvent tre obtenus depuis les paramtres de l'application du
compte.
Connection/Client Secret Saisissez le Secret du client requis par Box afin d'accder l'API
de Box. Afin d'obtenir la cl client et le Secret du client, vous
devez crer un compte sur https://developers.box.com/ puis crer une
application Box sous le compte Box utilis. La cl client et le Secret
du client peuvent tre obtenus depuis les paramtres de l'application
du compte.
Connection/Access Token Renseignez le jeton d'accs requis par Box afin d'accder au compte
Box et le faire fonctionner. Pour plus d'informations concernant
l'obtention du jeton d'accs et du jeton de rafrachissement, consultez
l'exemple disponible sur https://github.com/box/box-java-sdk-v2/
wiki/HelloWorld.
Connection/Refresh Token Renseignez le jeton de rafrachissement requis par Box afin
de rafrachir automatiquement le jeton d'accs. Pour plus
d'informations concernant l'obtention du jeton d'accs et du jeton
de rafrachissement, consultez l'exemple disponible sur https://
github.com/box/box-java-sdk-v2/wiki/HelloWorld.
Connection/Use HTTP Si vous utilisez un proxy, cochez cette case et saisissez les
proxy informations d'hte et de port dans les champs correspondants qui
s'affichent.
Path Saisissez le chemin pointant vers le dossier contenant les fichiers
lister ou saisissez le chemin vers le fichier que vous souhaitez lire.
List type Slectionnez le type de donnes que vous souhaitez lister dans le
chemin dfini : Files, Folders ou Both.
Include subdirectories Cochez cette case afin de lister des fichiers contenus dans les sous-
dossiers en plus de ceux contenus dans le dossier dfini dans le
champ Path.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
NAME : le nom du fichier distant trait. Cette variable est une variable Flow et retourne une chane
de caractres.
FILE_PATH : chemin d'accs au dossier ou fichier traiter sur Box. Cette variable est une variable
Flow et retourne une chane de caractres.
FILE_DIRECTORY : rpertoire du dossier ou fichier traiter sur Box. Cette variable est une
variable Flow et retourne une chane de caractres.
SIZE : le volume du fichier trait. Cette variable est une variable Flow et retourne un long.
ID : ID du dossier ou fichier traiter sur Box. Cette variable est une variable Flow et retourne
une chane de caractres.
TYPE : type des objets traiter sur Box, fichier ou dossier. Cette variable est une variable Flow
et retourne une chane de caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en standalone.
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tBoxPut
Proprits du tBoxPut
Famille de composant Cloud/Box
Fonction Ce composant charge des donnes sur Box partir d'un fichier local ou partir d'un flux de donnes.
Objectif Le composant tBoxPut charge des fichiers sur un compte Box.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Connection/Client Key Saisissez la cl client requise par Box afin d'accder l'API de Box.
Afin d'obtenir la cl client et le Secret du client, vous devez crer
un compte sur https://developers.box.com/ puis crer une application
Box sous le compte Box utilis. La cl client et le Secret du client
peuvent tre obtenus depuis les paramtres de l'application du compte.
Connection/Client Secret Saisissez le Secret du client requis par Box afin d'accder l'API de
Box. Afin d'obtenir la cl client et le Secret du client, vous devez crer
un compte sur https://developers.box.com/ puis crer une application
Box sous le compte Box utilis. La cl client et le Secret du client
peuvent tre obtenus depuis les paramtres de l'application du compte.
Connection/Access Token Renseignez le jeton d'accs requis par Box afin d'accder au compte
Box et le faire fonctionner. Pour plus d'informations concernant
l'obtention du jeton d'accs et du jeton de rafrachissement, consultez
l'exemple disponible sur https://github.com/box/box-java-sdk-v2/
wiki/HelloWorld.
Connection/Refresh Token Renseignez le jeton de rafrachissement requis par Box afin de
rafrachir automatiquement le jeton d'accs. Pour plus d'informations
concernant l'obtention du jeton d'accs et du jeton de rafrachissement,
consultez l'exemple disponible sur https://github.com/box/box-java-
sdk-v2/wiki/HelloWorld.
Connection/Use HTTP Si vous utilisez un proxy, cochez cette case et saisissez les
proxy informations d'hte et de port dans les champs correspondants qui
s'affichent.
Remote Path Saisissez le chemin pointant vers le fichier dans lequel vous souhaitez
crire des donnes. Si le fichier n'existe pas, il est cr la vole.
Replace if Existing Cochez cette case afin de remplacer le fichier existant par le fichier
charg.
Upload mode Slectionnez le mode de chargement utilis :
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma est
soit local (Built-in), soit distant dans le Repository.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis soit en standalone dans un sous-job, afin de charger un fichier local
directement sur Box, ou en tant que composant de fin du flux d'un Job afin de charger des donnes
traites par ce flux.
Limitation n/a
Avant de reproduire ce scnario, vous devez crer un compte sur https://developers.box.com/ puis crer une
application Box sous le compte Box utilis. Pour plus d'informations sur l'application Box, consultez https://
app.box.com/developers/services/edit/. La cl client et le Secret du client peuvent tre obtenus depuis les
paramtres de l'application du compte. Pour plus d'informations concernant l'obtention du jeton d'accs et du
jeton de rafrachissement, consultez l'exemple d'application disponible sur https://github.com/box/box-java-sdk-
v2/wiki/HelloWorld.
Pour plus d'informations sur la cration d'un Job, consultez le Guide utilisateur du Studio Talend.
2. Renseignez la cl client, le Secret du client, le jeton d'accs et le jeton de rafrachissement entre guillemets
doubles dans les champs correspondants afin d'accder au compte Box.
4. Cochez la case Use Existing Connection afin de rutiliser la connexion cre par le composant
tBoxConnection.
Dans le champ Remote Path, saisissez le chemin vers lequel vous souhaitez charger le fichier.
Dans la zone Upload mode, slectionnez Upload Local File Dans le champ File, saisissez le chemin ou
parcourez votre systme vers le fichier que vous souhaitez charger.
6. Cochez la case Use Existing Connection afin de rutiliser la connexion cre par le tBoxConnection.
Dans le champ Path, saisissez le chemin du fichier que vous souhaitez tlcharger.
Cochez la case Save As File. Dans le champ Save To, saisissez le chemin vers lequel vous souhaitez
sauvegarder le fichier dans votre systme local.
7. Sauvegardez le Job.
Excuter le Job
Excutez le Job en appuyant sur F6 ou en cliquant sur le bouton Run dans l'onglet Run.
Le fichier local, hello.txt dans cet exemple, est charg sur votre Box.
Le fichier box.txt est tlcharg depuis Box vers votre systme de fichiers local.
tCloudStart
Proprits du tCloudStart
Famille de composant Cloud
Fonction Le composant tCloudStart accde au fournisseur Cloud utiliser (Amazon EC2) et lance des
instances, qui sont des serveurs virtuels dans ce Cloud. Si une instance lancer n'existe pas, le
tCloudStart la cre.
Objectif Ce composant dmarre des instances sur Amazon EC2 (Amazon Elastic Compute Cloud).
Basic settings Access key et Secret key Saisissez ou collez la cl d'accs et la cl secrte requises par
Amazon pour authentifier vos requtes dans ses services Web.
Ces informations d'accs sont gnres dans l'onglet Security
Credential de la page de votre compte Amazon.
NODES : instances en cours d'excution. Cette variable est une variable After et retourne un
object.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant peut tre utilis en standalone afin de lancer une instance de Amazon EC2. Vous
pouvez utiliser ce composant pour dmarrer l'instance sur laquelle dployer des Jobs.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tCloudStop
Proprits du tCloudStop
Famille de composant Cloud
Fonction Le composant tCloudStart accde au fournisseur Cloud utiliser (Amazon EC2) et suspend,
reprend ou termine une ou des instance(s) donnes(s).
Objectif Ce composant vous permet de modifier le statut d'une instance lance sur Amazon EC2 (Amazon
Elastic Compute Cloud).
Basic settings Access key et Secret key Saisissez ou collez la cl d'accs et la cl secrte requises par
Amazon pour authentifier vos requtes dans ses services Web.
Ces informations d'accs sont gnres dans l'onglet Security
Credential de la page de votre compte Amazon.
Suspend
Resume
Terminate
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant fonctionne en standalone pour changer le statut d'instances donnes d'Amazon
EC2. Vous pouvez utiliser ce composant afin de suspendre, reprendre ou terminer une ou des
instance(s) o sont dploys des Jobs.
Ce composant est gnralement utilis avec le tCloudStart afin de changer le statut des
instances lances par celui-ci.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tDropboxConnection
Proprits du tDropboxConnection
Famille de composant Cloud/Dropbox
Fonction Ce composant cre une connexion vers un compte Dropbox donn.
Objectif Le composant tDropboxConnection cre une connexion Dropbox que les autres composants
Dropbox peuvent rutiliser.
Basic settings Access token Renseignez le jeton d'accs requis par le compte Dropbox auquel
vous souhaitez vous connecter. Ce jeton d'accs permet au Studio
d'appeler l'API Dropbox pour ce compte Dropbox.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis en standalone en tant que sous-job pour crer une connexion Dropbox.
Dans un Job, ce composant est gnralement connect aux autres composants Dropbox l'aide de
liens de type Trigger, tel que le lien On Subjob Ok.
Limitation n/a
Scnario associ
Pour un scnario associ, consultez Scnario : Tlcharger des fichiers dans Dropbox
tDropboxDelete
Proprits du tDropboxDelete
Famille de composant Cloud/Dropbox
Fonction Ce composant se connecte un compte Dropbox donn et supprime un fichier ou un dossier
spcifi.
Objectif Le composant tDropboxDelete supprime un dossier ou un fichier donn de Dropbox.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access token Renseignez le jeton d'accs requis par le compte Dropbox auquel
vous souhaitez vous connecter. Ce jeton d'accs permet au Studio
d'appeler l'API Dropbox pour ce compte Dropbox.
Notez que le nom du chemin d'accs doit commencer par une barre
oblique (/). Il s'agit du dossier racine de l'application Dropbox pour
laquelle vous utilisez le jeton d'accs.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau des
composants.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis en standalone dans un sous-job pour supprimer des donnes de Dropbox.
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tDropboxGet
Proprits du tDropboxGet
Famille de composant Cloud/Dropbox
Fonction Ce composant se connecte un compte Dropbox et tlcharge des fichiers dans un rpertoire local
spcifi.
Objectif Le composant tDropboxGet tlcharge un fichier slectionn d'un compte Dropbox.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access token Renseignez le jeton d'accs requis par le compte Dropbox auquel
vous souhaitez vous connecter. Ce jeton d'accs permet au Studio
d'appeler l'API Dropbox pour ce compte Dropbox.
Notez que le nom du chemin d'accs doit commencer par une barre
oblique (/). Il s'agit du dossier racine de l'application Dropbox pour
laquelle vous utilisez le jeton d'accs.
Save as file Cochez cette case pour afficher le champ File et parcourez votre
systme ou saisissez le chemin d'accs au rpertoire local dans lequel
vous souhaitez que soit stock le fichier tlcharg. Le fichier est
remplac s'il existe dj.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau des
composants.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
FILE_NAME : nom du fichier trait. Cette variable est une variable Flow et retourne une chane
de caractres.
OUTPUT_PATH : le rpertoire dans lequel les fichiers de sortie sont stocks. Cette variable est
une variable Flow et retourne une chane de caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone ou avec d'autres composants l'aide d'un lien de type
Iterate ou d'un lien de type Trigger tel que OnSubjobOK.
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tDropboxList
Proprits du tDropboxList
Famille de composant Cloud/Dropbox
Fonction Ce composant lit le ou les fichier(s) dans Dropbox contenu(s) dans le rpertoire que vous spcifiez
et liste les mtadonnes ainsi que le contenu de ce ou ces fichier(s).
Objectif Le composant tDropboxList liste les fichiers stocks dans un rpertoire spcifi dans Dropbox.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access token Renseignez le jeton d'accs requis par le compte Dropbox auquel
vous souhaitez vous connecter. Ce jeton d'accs permet au Studio
d'appeler l'API Dropbox pour ce compte Dropbox.
Notez que le nom du chemin d'accs doit commencer par une barre
oblique (/). Il s'agit du dossier racine de l'application Dropbox pour
laquelle vous utilisez le jeton d'accs.
List type Slectionnez, dans le chemin d'accs spcifi, le type de donnes que
vous souhaitez lister.
Include subdirectories Cochez cette case pour lister les fichiers de n'importe quel sous-
dossier existant en plus des fichiers dans le rpertoire dfini dans le
champ Path.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau des
composants.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
NAME : le nom du fichier distant trait. Cette variable est une variable Flow et retourne une chane
de caractres.
PATH : le chemin vers le dossier ou le fichier trait dans Dropbox. Cette variable est une variable
Flow et retourne une chane de caractres.
SIZE : le volume du fichier trait. Cette variable est une variable Flow et retourne un long.
IS_FILE : le rsultat boolen de la liste de fichiers. Cette variable est une variable Flow et retourne
un boolen. Le rsultat Yes indique que les donnes listes sont de type File. Sinon, le type est
Folder.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en standalone.
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tDropboxPut
Proprits du tDropboxPut
Famille de composant Cloud/Dropbox
Fonction Ce composant tlcharge des donnes dans Dropbox partir d'un fichier local ou d'un flux de
donnes.
Objectif Le composant tDropboxPut tlcharge des fichiers dans un compte Dropbox.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access token Renseignez le jeton d'accs requis par le compte Dropbox auquel vous
souhaitez vous connecter. Ce jeton d'accs permet au Studio d'appeler
l'API Dropbox pour ce compte Dropbox.
Notez que le nom du chemin d'accs doit commencer par une barre
oblique (/). Il s'agit du dossier racine de l'application Dropbox pour
laquelle vous utilisez le jeton d'accs.
Upload mode Slectionnez le mode de tlchargement utiliser :
OUTPUTSTREAM : le contenu du fichier mis en ligne. Cette variable est une variable Flow et
retourne un object.
Notez que cette variable OUTPUTSTREAM est disponible uniquement lorsque la case Expose
as OutputStream est coche.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est soit utilis en standalone dans un sous-job pour tlcharger un fichier local
directement dans Dropbox, soit utilis en tant que composant de sortie d'un flux de Job pour
tlcharger des donnes manipules dans ce flux.
Limitation n/a
Avant de reproduire ce scnario, vous devez crer une application Dropbox sous le compte Dropbox utilis. Dans
ce scnario, l'application Dropbox utilise est appele talenddrop. Le fichier racine dans lequel les fichiers sont
tlchargs est appel talenddropgalement. En outre, le jeton d'accs ce fichier a t gnr partir de la console
de l'application fournie par Dropbox.
Pour plus d'informations concernant la cration d'un Job, consultez le Guide utilisateur du Studio Talend.
Dans ce scnario, le composant tFixedFlowInput gnre des donnes tlcharger dans Dropbox. Dans
des cas rels, vous pouvez utiliser d'autres composants tels que le tMysqlInput ou le tMap la place du
tFixedFlowInput, afin de concevoir un processus plus labor pour prparer le traitement de vos donnes.
3. Reliez le tFixedFlowInput au tFileOutputDelimited l'aide d'un lien de type Row > Main.
4. Faites de mme pour relier le tFileOutputDelimited l'un des deux composants tDropboxPut et reliez le
tFileInputRaw l'autre composant tDropboxPut.
5. Reliez le tDropboxConnection au tFixedFlowInput l'aide d'un lien de type Trigger > OnSubjobOk, puis
reliez le tFixedFlowInput au tFileInputRaw l'aide d'un lien de mme type.
Se connecter Dropbox
1. Double-cliquez sur le tDropboxConnection pour ouvrir sa vue Component.
2. Dans le champ Access token, collez le jeton que vous avez gnr via la console de l'application de Dropbox
afin d'accder au dossier de l'application Dropbox utiliser.
Dans ce scnario, seules trois lignes de donnes sont cres pour indiquer trois pays et leurs indicatifs
tlphoniques.
33;France
86;China
81;Japan
2. Cliquez sur le bouton [...] ct de Edit schema pour ouvrir l'diteur de schma.
3. Cliquez deux fois sur le bouton [+] pour ajouter deux lignes et, dans la colonne Column, renommez-les code
et country.
4. Cliquez sur OK pour valider ces changements et accepter la propagation demande par la bote de dialogue
qui s'ouvre.
5. Dans la zone Mode, slectionnez le bouton radio Use Inline Table. Les colonnes code et country sont
automatiquement cres dans cette table.
2. Cochez la case Use output stream pour crire les donnes dans un flux de sortie donn.
3. Dans le champ Output stream, renseignez le code pour dfinir le flux de sortie dans lequel vous souhaitez
crire les donnes. Dans ce scnario, il s'agit du flux de sortie du composant tDropboxPut_1 reli au
composant actuel. Le code utilis pour crire les donnes se prsente de la manire suivante :
((java.io.OutputStream)globalMap.get("tDropboxPut_1_OUTPUTSTREAM"))
Notez que dans cet exemple de code, le composant tDropboxPut a le chiffre 1 comme affixe. Il correspond
son ID de composant automatiquement attribu dans ce Job. Si le composant tDropboxPut que vous utilisez
a un ID diffrent, vous devez adapter le code en fonction de cet ID.
4. Cliquez sur Edit schema pour vrifier que le schma de ce composant est identique celui du composant
tFixedFlowInput qui prcde. Si ce n'est pas le cas, cliquez sur le bouton Sync columns pour rendre les
deux schmas identiques.
2. Cochez la case Use existing connection pour rutiliser la connexion cre par le tDropboxConnection.
3. Dans le champ Path, saisissez le chemin d'accs au fichier dans lequel vous souhaitez crire les donnes en
le faisant prcder d'une barre oblique (/) . Par exemple, saisissez /calling_code.csv.
5. Slectionnez le bouton radio Expose As OutputStream pour exposer le flux de sortie de ce composant afin
que l'autre composant, tFileOutputDelimited dans ce scnario, puisse crire des donnes dans le flux.
Ce composant est utilis pour lire une image appele esb_architecture.png dans le flux de donnes. Dans des
cas rels, ce fichier peut avoir de nombreux autres formats tels que PDF, XLS, PPT ou MP3.
2. Dans le champ Filename, saisissez le chemin d'accs ou parcourez votre systme jusqu'au fichier que vous
souhaitez tlcharger.
3. Dans la zone Mode, slectionnez le bouton radio Read the file as a bytes array.
2. Cochez la case Use existing connection pour rutiliser la connexion cre par le tDropboxConnection.
3. Dans le champ Path, saisissez le chemin d'accs vers le fichier dans lequel vous souhaitez crire les donnes
en le faisant prcder d'une barre oblique (/) . Par exemple, saisissez /architecture.png.
5. Slectionnez le bouton Upload incoming content as file. Cela fait apparatre le bouton Edit schema pour
vous permettre de voir le schma en lecture seule de ce composant.
Excuter le Job
Appuyez sur F6 pour excuter ce Job.
Lorsque vous avez termin, vrifiez les fichiers tlchargs dans le dossier spcifi de votre application Dropbox.
Dans ce scnario, il s'agit du dossier talenddrop.
tGoogleDriveConnection
Proprits du tGoogleDriveConnection
Famille de composant Cloud / Google Drive
Fonction Le composant tGoogleDriveConnection ouvre une connexion afin d'accder un compte Google Drive.
Objectif Ce composant vous permet d'ouvrir une connexion Google Drive pouvant tre rutilise par d'autres
composants Google Drive.
Basic settings Application Name Saisissez le nom de l'application requis par Google Drive pour accder son
APIs.
Access Token Saisissez le jeton d'accs requis par Google Drive pour accder un compte
Google Drive. Pour plus d'informations concernant la rcupration du jeton
d'accs, consultez Obtenir un jeton d'accs Google Drive.
Use HTTP Proxy Cochez cette case si vous travaillez derrire un proxy HTTP.
Proxy Host Saisissez l'adresse IP du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Proxy Port Saisissez le numro du port du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Use SSL Cochez cette case si une connexion SSL est utilise pour accder Google
Drive.
Algorithm Saisissez le nom de l'algorithme de cryptographie SSL.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
TrustStore File Parcourez votre systme ou saisissez le chemin d'accs au fichier du certificat
TrustStore contenant la liste des certificats accepts par l'utilisateur.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
Password Saisissez le mot de passe utilis pour vrifier l'intgrit des donnes TrustStore.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi qu'au
niveau de chaque composant.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Google Drive. Dans un Job, il est
gnralement utilis pour ouvrir une connexion Google Drive pouvant tre rutilise par d'autres
composants.
Limitation n/a
1. Allez la page Google Developers Console et slectionnez un projet existant ou crez-en un nouveau. Dans
cet exemple, crez un nouveau projet TalendProject.
2. Slectionnez le nouveau projet, cliquez sur APIs sous APIs & auth et activez les API Drive API et Drive
SDK en changeant leur statut ON.
3. Cliquez sur Consent screen sous APIs & auth et crez un nouveau projet. Dans cet exemple, nommez-le
TalendProduct.
4. Cliquez sur Credentials sous APIs & auth, crez un nouvel ID client et slectionnez, dans la zone
APPLICATION TYPE le type Installed application. Dans la zone INSTALLED APPLICATION TYPE,
slectionnez Other.
Les CLIENT ID, CLIENT SECRET et REDIRECT URIS sont utiliss pour obtenir le jeton d'accs.
5. Gnrez le code d'authentification en excutant une requte HTTP GET l'aide d'un navigateur Web. Pour
ce faire, copiez-collez l'URL de la requte https://accounts.google.com/o/oauth2/auth avec les paramtres
suivants dans la barre d'adresse de votre navigateur, appuyez sur la touche Entre et acceptez la demande
d'accs.
scope : permissions que vous demandez l'utilisateur d'accepter pour votre application. Pour plus
d'informations, consultez https://developers.google.com/drive/web/scopes (en anglais).
Notez que l'URL de la requte et les paramtres de la chane de caractres sont concatns par un ? et les
paramtres de la requte sont concatns avec un &. Une URL d'exemple est affiche ci-dessous, avec des
retours la ligne pour des questions de lisibilit. Vous devez regrouper ces lignes en une seule avant de
copier-coller l'URL dans la barre d'adresse de votre navigateur. Les permissions dans cet exemple fournissent
un accs total tous les fichiers de l'utilisateur. Demandez ces permissions uniquement lorsque c'est vraiment
ncessaire.
https://accounts.google.com/o/oauth2/auth?
client_id=1061335238805-gmctuidvid0lsrdf66nvit0g7j5gnrck.apps.googleusercontent.com&
redirect_uri=urn:ietf:wg:oauth:2.0:oob&
response_type=code&
scope=https://www.googleapis.com/auth/drive&
access_type=online
La rponse retourne contient un code d'autorisation utiliser pour gnrer le jeton d'accs dans l'tape
suivante.
6. Gnrez le jeton d'accs en excutant une requte HTTP POST l'aide de Google REST Console. Pour ce
faire, copiez-collez l'URL de la requte https://www.googleapis.com/oauth2/v3/token avec les paramtres
suivants de la requte dans le champ Request URI de la zone Target, cochez la case Content-Type et
configurez sa valeur application/x-www-form-urlencoded, puis cliquez sur le bouton POST.
Notez que l'URL de la requte et les paramtres de la chane de caractres sont concatns par un ? et les
paramtres de la requte sont concatns avec un &. Une URL d'exemple est affiche ci-dessous, avec des
retours la ligne pour des questions de lisibilit. Vous devez regrouper ces lignes en une seule avant de
copier-coller l'URL dans le champ Request URI.
https://www.googleapis.com/oauth2/v3/token?
code=4/fwRIPH2a8XQRCs2JicTs4zWTprKjyJ7KbwkY46fE1O0.sj6y9PmBGe8ZeFc0ZRONyF4NK_eblwI&
client_id=1061335238805-gmctuidvid0lsrdf66nvit0g7j5gnrck.apps.googleusercontent.com&
client_secret=x6Jis-fzAzBfCfrLlokuPopn&
redirect_uri=urn:ietf:wg:oauth:2.0:oob&
grant_type=authorization_code
La rponse retourne contient le jeton d'accs. Notez que le jeton d'accs expire au bout de 3600 secondes.
Scnario associ
Pour un scnario associ, consultez Gestion des fichiers avec Google Drive.
tGoogleDriveCopy
Proprits du tGoogleDriveCopy
Famille de composant Cloud / Google Drive
Fonction Le composant tGoogleDriveCopy copie ou dplace un fichier ou un dossier spcifi dans Google Drive.
Objectif Ce composant vous permet de copier ou dplacer un fichier/dossier dans Google Drive.
Basic settings Use Existing Connection Cochez cette case et, dans la liste qui s'affiche, slectionnez le composant
de connexion permettant de rutiliser les informations de connexion
prcdemment dfinies.
Application Name Saisissez le nom de l'application requis par Google Drive pour accder son
APIs.
Access Token Saisissez le jeton d'accs requis par Google Drive pour accder un compte
Google Drive. Pour plus d'informations concernant la rcupration du jeton
d'accs, consultez Obtenir un jeton d'accs Google Drive.
Use HTTP Proxy Cochez cette case si vous travaillez derrire un proxy HTTP.
Proxy Host Saisissez l'adresse IP du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Proxy Port Saisissez le numro du port du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Use SSL Cochez cette case si une connexion SSL est utilise pour accder Google
Drive.
Algorithm Saisissez le nom de l'algorithme de cryptographie SSL.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
TrustStore File Parcourez votre systme ou saisissez le chemin d'accs au fichier du certificat
TrustStore contenant la liste des certificats accepts par l'utilisateur.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
Password Saisissez le mot de passe utilis pour vrifier l'intgrit des donnes TrustStore.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
File Slectionnez cette option lorsque vous devez copier ou dplacer un fichier.
Folder Slectionnez cette option lorsque vous devez copier un dossier.
File Name Saisissez le nom du fichier source copier ou dplacer.
Ce champ est disponible uniquement lorsque la case Rename (set new title)
est coche.
Remove Source File Cochez cette case afin de supprimer le fichier source une fois copi dans le
dossier de destination.
DESTINATION_FILEID : ID du fichier/dossier cible. Cette variable est une variable After et retourne
une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de dbut, dans un Job ou un sous-job et
ncessite un lien de sortie.
Limitation n/a
Scnario associ
Pour un scnario associ, consultez Gestion des fichiers avec Google Drive.
tGoogleDriveCreate
Proprits du tGoogleDriveCreate
Famille de composant Cloud / Google Drive
Fonction Le composant tGoogleDriveCreate cre un nouveau dossier dans un dossier parent, dans Google Drive.
Objectif Ce composant vous permet de crer un nouveau dossier dans Google Drive.
Basic settings Use Existing Connection Cochez cette case et, dans la liste qui s'affiche, slectionnez le composant
de connexion permettant de rutiliser les informations de connexion
prcdemment dfinies.
Application Name Saisissez le nom de l'application requis par Google Drive pour accder son
APIs.
Access Token Saisissez le jeton d'accs requis par Google Drive pour accder un compte
Google Drive. Pour plus d'informations concernant la rcupration du jeton
d'accs, consultez Obtenir un jeton d'accs Google Drive.
Use HTTP Proxy Cochez cette case si vous travaillez derrire un proxy HTTP.
Proxy Host Saisissez l'adresse IP du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Proxy Port Saisissez le numro du port du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Use SSL Cochez cette case si une connexion SSL est utilise pour accder Google
Drive.
Algorithm Saisissez le nom de l'algorithme de cryptographie SSL.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
TrustStore File Parcourez votre systme ou saisissez le chemin d'accs au fichier du certificat
TrustStore contenant la liste des certificats accepts par l'utilisateur.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
Password Saisissez le mot de passe utilis pour vrifier l'intgrit des donnes TrustStore.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
Parent Folder Name Saisissez le nom du dossier pre dans lequel crer le nouveau dossier.
New Folder Name Saisissez le nom du nouveau dossier crer.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant.
NEWFOLDERID : ID du nouveau dossier crer. Cette variable est une variable After et retourne une
chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de dvit dans un Job ou un sous-job et
ncessite un lien de sortie.
Limitation n/a
Scnario associ
Pour un scnario associ, consultez Gestion des fichiers avec Google Drive.
tGoogleDriveDelete
Proprits du tGoogleDriveDelete
Famille de composant Cloud / Google Drive
Fonction Le composant tGoogleDriveDelete supprime un fichier ou un dossier dans Google Drive.
Objectif Ce composant vous permet de supprimer un fichier ou un dossier dans Google Drive.
Basic settings Use Existing Connection Cochez cette case et, dans la liste qui s'affiche, slectionnez le composant
de connexion permettant de rutiliser les informations de connexion
prcdemment dfinies.
Application Name Saisissez le nom de l'application requis par Google Drive pour accder son
APIs.
Access Token Saisissez le jeton d'accs requis par Google Drive pour accder un compte
Google Drive. Pour plus d'informations concernant la rcupration du jeton
d'accs, consultez Obtenir un jeton d'accs Google Drive.
Use HTTP Proxy Cochez cette case si vous travaillez derrire un proxy HTTP.
Proxy Host Saisissez l'adresse IP du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Proxy Port Saisissez le numro du port du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Use SSL Cochez cette case si une connexion SSL est utilise pour accder Google
Drive.
Algorithm Saisissez le nom de l'algorithme de cryptographie SSL.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
TrustStore File Parcourez votre systme ou saisissez le chemin d'accs au fichier du certificat
TrustStore contenant la liste des certificats accepts par l'utilisateur.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
Password Saisissez le mot de passe utilis pour vrifier l'intgrit des donnes TrustStore.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
Name of File/Folder To Saisissez le nom du fichier/dossier supprimer.
Delete
Use Trash Cochez cette case afin de dplacer le fichier/dossier supprimer dans la
corbeille.
Advanced settings tStatCatcher Statistics Cochez cette case afin de collecter les informations de log au niveau du Job,
ainsi qu'au niveau de chaque composant.
Global Variables FILEID : ID du champ/dossier supprimer. Cette variable est une variable After et retourne une chane
de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone.
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tGoogleDriveGet
Proprits du tGoogleDriveGet
Famille de composant Cloud / Google Drive
Fonction Le composant tGoogleDriveGet permet de tlcharger un fichier stock dans Google Drive.
Objectif Ce composant vous permet de tlcharger un fichier dans Google Drive.
Basic settings Use Existing Connection Cochez cette case et, dans la liste qui s'affiche, slectionnez le composant
de connexion permettant de rutiliser les informations de connexion
prcdemment dfinies.
Application Name Saisissez le nom de l'application requis par Google Drive pour accder son
APIs.
Access Token Saisissez le jeton d'accs requis par Google Drive pour accder un compte
Google Drive. Pour plus d'informations concernant la rcupration du jeton
d'accs, consultez Obtenir un jeton d'accs Google Drive.
Use HTTP Proxy Cochez cette case si vous travaillez derrire un proxy HTTP.
Proxy Host Saisissez l'adresse IP du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Proxy Port Saisissez le numro du port du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Use SSL Cochez cette case si une connexion SSL est utilise pour accder Google
Drive.
Algorithm Saisissez le nom de l'algorithme de cryptographie SSL.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
TrustStore File Parcourez votre systme ou saisissez le chemin d'accs au fichier du certificat
TrustStore contenant la liste des certificats accepts par l'utilisateur.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
Password Saisissez le mot de passe utilis pour vrifier l'intgrit des donnes TrustStore.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
Name of File Saisissez le nom du fichier tlcharger.
Save As File Cochez cette case afin de sauvegarder le fichier tlcharger dans un rpertoire
local.
Save To Parcourez votre systme ou saisissez le chemin de l'emplacement o
sauvegarder le fichier tlcharger.
Ce champ est disponible uniquement lorsque la case Save As File est coche.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en tant que composant de dbut dans un Job ou un sous-job et
ncessite un lien de sortie.
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tGoogleDriveList
Proprits du tGoogleDriveList
Famille de composant Cloud / Google Drive
Fonction Le composant tGoogleDriveList effectue une itration sur le dossier spcifi dans Google Drive.
Objectif Ce composant vous permet de lister les fichiers et/ou les sous-dossiers dans un dossier spcifique dans
Google Drive.
Basic settings Use Existing Connection Cochez cette case et, dans la liste qui s'affiche, slectionnez le composant
de connexion permettant de rutiliser les informations de connexion
prcdemment dfinies.
Application Name Saisissez le nom de l'application requis par Google Drive pour accder son
APIs.
Access Token Saisissez le jeton d'accs requis par Google Drive pour accder un compte
Google Drive. Pour plus d'informations concernant la rcupration du jeton
d'accs, consultez Obtenir un jeton d'accs Google Drive.
Use HTTP Proxy Cochez cette case si vous travaillez derrire un proxy HTTP.
Proxy Host Saisissez l'adresse IP du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Proxy Port Saisissez le numro du port du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Use SSL Cochez cette case si une connexion SSL est utilise pour accder Google
Drive.
Algorithm Saisissez le nom de l'algorithme de cryptographie SSL.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
TrustStore File Parcourez votre systme ou saisissez le chemin d'accs au fichier du certificat
TrustStore contenant la liste des certificats accepts par l'utilisateur.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
Password Saisissez le mot de passe utilis pour vrifier l'intgrit des donnes TrustStore.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
Folder Name Saisissez le nom du dossier itrer.
FileList Type Slectionnez le type de donnes lister.
TITLE : titre du fichier/dossier en cours de traitement. Cette variable est une variable Flow et retourne
une chane de caractres.
MIME_TYPE : type MIME du fichier/dossier en cours de traitement. Cette variable est une variable Flow
et retourne une chane de caractres. Pour plus d'informations concernant les types MIME supports dans
Google Drive, consultez Supported MIME Types (en anglais).
SIZE : taille du fichier en octets. Cette variable est une variable Flow et retourne un long lorsqu'un fichier
est en cours de traitement et un null lorsqu'un dossier est en cours de traitement.
SELF_LINK : lien vers le fichier/dossier en cours de traitement. Cette variable est une variable Flow et
retourne une chane de caractres.
PARENTS : proprits du dossier pre du fichier/dossier en cours de traitement. Cette variable est une
variable Flow et retourne une liste.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone ou en tant que composant de dbut dans un Job ou un sous-job.
Limitation n/a
Scnario associ
Pour un scnario associ, consultez Gestion des fichiers avec Google Drive.
tGoogleDrivePut
Proprits du tGoogleDrivePut
Famille de composant Cloud / Google Drive
Fonction Le composant tGoogleDrivePut charge des donnes d'un flux de donnes d'entre ou d'un fichier local,
dans Google Drive.
Objectif Ce composant vous permet de charger des donnes dansGoogle Drive.
Basic settings Use Existing Connection Cochez cette case et, dans la liste qui s'affiche, slectionnez le composant
de connexion permettant de rutiliser les informations de connexion
prcdemment dfinies.
Application Name Saisissez le nom de l'application requis par Google Drive pour accder son
APIs.
Access Token Saisissez le jeton d'accs requis par Google Drive pour accder un compte
Google Drive. Pour plus d'informations concernant la rcupration du jeton
d'accs, consultez Obtenir un jeton d'accs Google Drive.
Use HTTP Proxy Cochez cette case si vous travaillez derrire un proxy HTTP.
Proxy Host Saisissez l'adresse IP du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Proxy Port Saisissez le numro du port du serveur du proxy HTTP.
Ce champ est disponible uniquement lorsque la case Use HTTP Proxy est
coche.
Use SSL Cochez cette case si une connexion SSL est utilise pour accder Google
Drive.
Algorithm Saisissez le nom de l'algorithme de cryptographie SSL.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
TrustStore File Parcourez votre systme ou saisissez le chemin d'accs au fichier du certificat
TrustStore contenant la liste des certificats accepts par l'utilisateur.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
Password Saisissez le mot de passe utilis pour vrifier l'intgrit des donnes TrustStore.
Ce champ est disponible uniquement lorsque la case Use SSL est coche.
File Title Saisissez le nom du fichier aprs chargement.
Destination Folder Name Saisissez le nom du dossier dans lequel le fichier sera stock.
Replace if Existing Cochez cette case pour craser tout fichier existant par le fichier nouvellement
charg.
Upload Incoming content Slectionnez cette option si vous chargez des donnes provenant d'un flux
as File d'entre du composant prcdent.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant.
Upload Local File Slectionnez cette option lorsque vous chargez des donnes d'un fichier local.
File Parcourez votre systme ou saisissez le chemin d'accs du fichier charger.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone, pour charger un fichier local dans Google Drive ou encore
comme composant de sortie pour charger des donnes dans Google Drive provenant du flux d'entre d'un
composant prcdent.
Limitation n/a
Prrequis :
1. Un compte Google a t cr et le jeton d'accs permettant l'authentification pour votre requte a t gnr.
Pour plus d'informations concernant l'obtention de jetons d'accs, consultez Obtenir un jeton d'accs Google
Drive.
un composant tGoogleDriveConnection,
deux tGoogleDrivePut,
un tGoogleDriveCreate,
un tGoogleDriveCopy,
un tGoogleDriveList,
un tIterateToFlow et
trois tLogRow.
2. Reliez le tGoogleDriveCreate au premier tLogRow l'aide d'un lien Row > Main.
3. Reliez le tGoogleDriveCopy au deuxime tLogRow l'aide d'un lien Row > Main.
5. Reliez le tIterateToFlow au troisime tLogRow l'aide d'un lien Row > Main.
6. Reliez le tGoogleDriveConnection au premier tGoogleDrivePut l'aide d'un lien Trigger > On Subjob Ok.
7. Rptez l'opration afin de relier le premier tGoogleDrivePut au second tGoogleDrivePut, reliez le second
tGoogleDrivePut au tGoogleDriveCreate, reliez le tGoogleDriveCreate au tGoogleDriveCopy et le
tGoogleDriveCopy au tGoogleDriveList.
2. Dans le champ Application Name, saisissez le nom de l'application requis par Google Drive pour accder
son API. Dans cet exemple, saisissez TalendProduct.
3. Dans le champ Access Token, saisissez le jeton d'accs requis par Google Drive pour accder au compte
Google Drive.
2. Cochez la case Use Existing Connection et, dans la liste qui s'affiche, slectionnez le composant configur
afin d'ouvrir votre connexion Google Drive. Dans cet exemple, saisissez tGoogleDriveConnection_1.
3. Slectionnez l'option Upload Local File et, dans le champ File, parcourez votre systme ou saisissez le
chemin d'accs au fichier charger. Dans cet exemple, le chemin est le suivant : C:/Talend/Talend Release
Plan.csv.
4. Dans le champ File Title, saisissez le nom du fichier aprs chargement. Dans cet exemple, saisissez Talend
Release Plan.csv.
5. Dans le champ Destination Folder Name, saisissez le nom du dossier dans lequel le fichier sera stock dans
Google Drive. Dans cet exemple, saisissez Talend.
7. Rptez les tapes de tape 2 tape 5 pour charger un autre fichier local dans le dossier Talend de Google
Drive. Dans cet exemple, saisissez Talend Products.txt.
2. Cochez la case Use Existing Connection et, dans la liste qui s'affiche, slectionnez le composant configur
pour ouvrir votre connexion Google Drive.
3. Dans le champ Parent Folder Name, saisissez le nom du dossier dans lequel crer un nouveau dossier. Dans
cet exemple, saisissez Talend.
4. Dans le champ New Folder Name, saisissez le nom du dossier crer. Dans cet exemple, saisissez Backup.
5. Cliquez sur le bouton [...] ct de Edit schema pour voir le schma prdfini du tGoogleDriveCreate.
7. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un affichage optimal des
rsultats.
2. Cochez la case Use Existing Connection et, dans la liste qui s'affiche, slectionnez le composant configur
pour ouvrir votre connexion Google Drive.
3. Dans le champ File Name, saisissez le nom du fichier copier. Dans cet exemple, saisissez Talend Release
Plan.csv.
4. Dans le champ Destination Folder Name, saisissez le nom du dossier dans lequel copier le fichier. Dans
cet exemple, saisissez Backup.
5. Cochez la case Rename (set new title) et, dans le champ Destination Name qui s'affiche, saisissez un
nouveau nom pour le fichier aprs copie dans le dossier de destination. Dans cet exemple, saisissez Talend
Release Plan v1.0.csv.
6. Cliquez sur le bouton [...] ct de Edit schema pour voir le schma prdfini du tGoogleDriveCopy.
8. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un affichage optimal des
rsultats.
2. Cochez la case Use Existing Connection et, dans la liste qui s'affiche, slectionnez le composant configur
pour ouvrir votre connexion Google Drive.
3. Dans le champ Folder Name, saisissez le nom du dossier itrer. Dans cet exemple, utilisez le dossier racine
de Google Drive. Vous pouvez utiliser l'alias root pour y faire rfrence.
4. Slectionnez Both dans la liste FileList Type afin de lister les fichiers et dossier dans le rpertoire racine.
Cochez la case Includes subdirectories afin d'itrer galement sur les sous-rpertoires du rpertoire racine.
6. Cliquez sur le bouton [...] ct de Edit schema pour ouvrir l'diteur du schma.
Cliquez quatre fois sur le bouton [+] pour ajouter quatre colonnes : ID, Title et MimeType de type String
et Size de type Long.
Cliquez sur OK afin de valider les modifications et acceptez la propagation propose par la bote de dialogue.
7. Dans la table Mapping, renseignez la valeur pour chaque colonne en slectionnant la cellule correspondante
dans la colonne Value et en appuyant sur les touches Ctrl+Espace. Dans la liste des variables qui
s'affiche, slectionnez la variable globale correspondant au composant tGoogleDriveList. Dans cet exemple,
slectionnez :
9. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un affichage optimal des
rsultats.
2. Excutez le Job en appuyant sur F6 ou en cliquant sur l'onglet Run dans l'onglet Run.
Comme affich dans la capture d'cran ci-dessus, deux fichiers Talend Products.txt et Talend Release
Plan.csv ont t chargs dans le dossier Talend. Un nouveau dossier Backup a t cr dans le dossier Talend
et le fichier Talend Release Plan.csv a t copi dans le nouveau dossier et renomm Talend Release Plan
v1.0.csv. Finalement, les fichiers et dossiers sont lists et affichs dans la console.
tGSBucketCreate
Le composant tGSBucketCreate appartient deux familles : Big Data et Cloud. Pour plus d'informations,
consultez tGSBucketCreate.
tGSBucketDelete
Le composant tGSBucketDelete appartient deux familles : Big Data et Cloud. Pour plus d'informations,
consultez tGSBucketDelete.
tGSBucketExist
Le composant tGSBucketExist appartient deux familles : Big Data et Cloud. Pour plus d'informations, consultez
tGSBucketExist.
tGSBucketList
Le composant tGSBucketList appartient deux familles : Big Data et Cloud. Pour plus d'informations, consultez
tGSBucketList.
tGSClose
Le composant tGSClose appartient deux familles : Big Data et Cloud. Pour plus d'informations, consultez
tGSClose.
tGSConnection
Le composant tGSConnection appartient deux familles : Big Data et Cloud. Pour plus d'informations, consultez
tGSConnection.
tGSCopy
Le composant tGSCopy appartient deux familles : Big Data et Cloud. Pour plus d'informations, consultez
tGSCopy.
tGSDelete
Le composant tGSDelete appartient deux familles : Big Data et Cloud. Pour plus d'informations, consultez
tGSDelete.
tGSGet
Le composant tGSGet appartient deux familles diffrentes : Big Data et Cloud. Pour plus d'informations,
consultez tGSGet.
tGSList
Le composant tGSList appartient deux familles diffrentes : Big Data et Cloud. Pour plus d'informations,
consultez tGSList.
tGSPut
Le composant tGSPut appartient deux familles diffrentes : Big Data et Cloud. Pour plus d'informations,
consultez tGSPut.
tMarketoInput
Le composant tMarketoInput appartient deux familles diffrentes : Business et Cloud. Pour plus d'informations,
consultez tMarketoInput.
tMarketoListOperation
Le composant tMarketoListOperation appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tMarketoListOperation.
tMarketoOutput
Le composant tMarketoOutput appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tMarketoOutput.
tNetsuiteInput
Le composant tNetsuiteInput appartient deux familles diffrentes : Business et Cloud. Pour plus d'informations
concernant ce composant, tNetsuiteInput.
tNetsuiteOutput
Le composant tNetsuiteOutput appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations concernant ce composant, consultez tNetsuiteOutput.
tS3BucketCreate
Proprits du tS3BucketCreate
Famille de composant Cloud/AmazonS3
Fonction Le composant tS3BucketCreate cre un bucket dans Amazon S3.
Objectif Le tS3BucketCreate est conu pour crer un bucket dans Amazon S3.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key L'ID de la cl d'accs (Access Key) identifie uniquement un compte
AWS. Pour plus d'informations concernant la cl d'accs et sa
scurit, consultez le site Getting Your AWS Access Keys (en
anglais).
Access Secret La Secret Access Key, combine la cl d'accs, constitue votre
accs scuris Amazon S3.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone ou avec d'autres composants S3, par exemple le
tS3BucketExist.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au tS3BucketCreate, consultez Scnario : Vrifier l'absence d'un bucket, le crer et
lister tous les buckets S3 .
tS3BucketDelete
tS3BucketDelete properties
Famille de composant Cloud/AmazonS3
Fonction Le composant tS3BucketDelete supprime un bucket vide d'Amazon S3.
Objectif Le composant tS3BucketDelete est conu pour supprimer un bucket vide d'Amazon S3.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key L'ID de la cl d'accs (Access Key) identifie uniquement un compte
AWS. Pour plus d'informations concernant la cl d'accs et sa
scurit, consultez le site Getting Your AWS Access Keys (en
anglais).
Access Secret La Secret Access Key, combine la cl d'accs, constitue votre
accs scuris Amazon S3.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone ou avec d'autres composants S3, par exemple le
tS3BucketList.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au tS3BucketDelete, consultez Scnario : Vrifier l'absence d'un bucket, le crer et
lister tous les buckets S3 .
tS3BucketExist
Proprits du tS3BucketExist
Famille de composant Cloud/AmazonS3
Fonction Le composant tS3BucketExist vrifie qu'un bucket existe dans Amazon S3.
Objectif Le composant tS3BucketExist est conu pour vrifier que le bucket spcifi existe dans Amazon
S3.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key L'ID de la cl d'accs (Access Key) identifie uniquement un compte
AWS. Pour plus d'informations concernant la cl d'accs et sa
scurit, consultez le site Getting Your AWS Access Keys (en
anglais).
Access Secret La Secret Access Key, combine la cl d'accs, constitue votre
accs scuris Amazon S3.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables BUCKET_EXIST : prsence ou non d'un bucket spcifi. Cette variable est une variable Flow
et retourne un boolen.
BUCKET_NAME : nom d'un bucket spcifi. Cette variable est une variable After et retourne
une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants S3, comme le tS3BucketCreate.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont
pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton
Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter
dans l'onglet Modules de la perspective Integration de votre studio. Pour plus d'informations,
consultez la page https://help.talend.com/display/KB/How+to+install+external+modules+in+the
+Talend+products (en anglais) ou la section dcrivant comment configurer le studio, dans le Guide
d'installation et de migration Talend.
Construire le Job
1. Dposez un tS3Connection, un tS3BucketExist, un tS3BucketCreate, un tS3BucketList, un
tIterateToFlow et un tLogRow dans l'espace de modlisation graphique.
2. Dans les champ Access Key et Secret Key, saisissez vos informations d'authentification.
4. Cochez la case Use existing connection afin de rutiliser la connexion dfinie dans le composant prcdent.
5. Dans le champ Bucket, saisissez le nom du bucket afin de vrifier son existence.
!((Boolean)globalMap.get("tS3BucketExist_1_BUCKET_EXIST"))
11. Cliquez sur le bouton Edit schema pour ouvrir l'diteur de schma.
Cliquez sur le bouton [+] pour ajouter une colonne. Nommez-la bucket_list et dfinissez son type String.
12. Dans la zone Mapping, appuyez sur les touches Ctrl+Espace dans le champ Value afin de slectionner la
variable tS3BucketList_1_CURRENT_BUCKET_NAME.
Slectionnez l'option Table (print values in cells of a table) pour un affichage optimal des rsultats.
Excuter le Job
1. Appuyez sur les touches Ctrl + S afin de sauvegarder le Job.
Comme affich ci-dessus, le bucket est cr et tous les buckets sont lists.
La capture d'cran ci-dessus vous montre que l'action S3 Create s'est droule avec succs.
tS3BucketList
Proprits du tS3BucketList
Famille de composant Cloud/AmazonS3
Fonction Le composant tS3BucketList liste tous les buckets dans Amazon S3.
Objectif Le tS3BucketList est conu pour lister tous les buckets dans Amazon S3.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key L'ID de la cl d'accs (Access Key) identifie uniquement un compte
AWS. Pour plus d'informations concernant la cl d'accs et sa
scurit, consultez le site Getting Your AWS Access Keys (en
anglais).
Access Secret La Secret Access Key, combine la cl d'accs, constitue votre
accs scuris Amazon S3.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables CURRENT_BUCKET_NAME : nom du bucket courant. Cette variable est une variable Flow et
retourne une chane de caractres.
NB_BUCKET : nombre de buckets. Cette variable est une variable After et retourne un nombre
entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone ou avec d'autres composants S3, comme le
tS3BucketDelete.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au tS3BucketList, consultez Scnario : Vrifier l'absence d'un bucket, le crer et lister
tous les buckets S3 .
tS3Close
Proprits du tS3Close
Famille de composant Cloud/AmazonS3
Fonction Le composant tS3Close permet de fermer une connexion Amazon S3.
Objectif Le tS3Close est conu pour fermer une connexion Amazon S3, librant ainsi les ressources
rseau.
Basic settings Component List Slectionnez dans la liste le composant de connexion.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau des
composants.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation En tant que composant de sortie, ce composant doit tre utilis avec d'autres composants S3, par
exemple le tS3Connection.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au tS3Close, consultez Scnario : Lister les fichiers d'un bucket ayant le mme prfixe.
tS3Connection
Proprits du tS3Connection
Famille de composant Cloud/AmazonS3
Fonction Le composant tS3Connection permet de vous connecter Amazon S3.
Objectif Le composant tS3Connection est conu pour vous connecter Amazon S3 afin de stocker et de
rcuprer des donnes.
Basic settings Access Key L'ID de la cl d'accs (Access Key) identifie uniquement un compte
AWS. Pour plus d'informations concernant la cl d'accs et sa
scurit, consultez le site Getting Your AWS Access Keys (en
anglais).
Access Secret La Secret Access Key, combine la cl d'accs, constitue votre
accs scuris Amazon S3.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant de dbut, il doit tre utilis avec d'autres composants S3.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ contenant un composant tS3Connection, consultez Scnario : Echange de fichiers avec
Amazon S3 .
tS3Delete
Proprits du tS3Delete
Famille de composant Cloud/AmazonS3
Fonction Le composant tS3Delete permet de supprimer un fichier dans Amazon S3.
Objectif Le tS3Delete est conu pour supprimer un fichier dans Amazon S3.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key L'ID de la cl d'accs (Access Key) identifie uniquement un compte
AWS. Pour plus d'informations concernant la cl d'accs et sa
scurit, consultez le site Getting Your AWS Access Keys (en
anglais).
Access Secret La Secret Access Key, combine la cl d'accs, constitue votre
accs scuris Amazon S3.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone ou avec d'autres composants S3, par exemple le
tS3BucketList.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au composant tS3Delete, consultez Scnario : Vrifier l'absence d'un bucket, le crer
et lister tous les buckets S3 .
tS3Get
Proprits du tS3Get
Famille de composant Cloud/AmazonS3
Fonction Ce composant rcupre un fichier d'Amazon S3.
Objectif Le composant tS3Get est conu pour rcuprer un fichier d'Amazon S3.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key L'ID de la cl d'accs (Access Key) identifie uniquement un compte
AWS. Pour plus d'informations concernant la cl d'accs et sa
scurit, consultez le site Getting Your AWS Access Keys (en
anglais).
Access Secret La Secret Access Key, combine la cl d'accs, constitue votre
accs scuris Amazon S3.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone ou avec d'autres composants S3, comme le
tS3Connection.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ utilisant le composant tS3Get, consultez Scnario : Echange de fichiers avec Amazon S3 .
tS3List
Proprits du tS3List
Famille de composant Cloud/AmazonS3
Fonction Le composant tS3List permet de lister les fichiers dans Amazon S3 selon les paramtres de prfixe
du bucket ou du fichier.
Objectif Le tS3List est conu pour lister les fichiers dans Amazon S3 selon les paramtres de filtre sur le
bucket ou le fichier dfinis.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key L'ID de la cl d'accs (Access Key) identifie uniquement un compte
AWS. Pour plus d'informations concernant la cl d'accs et sa
scurit, consultez le site Getting Your AWS Access Keys (en
anglais).
Access Secret La Secret Access Key, combine la cl d'accs, constitue votre
accs scuris Amazon S3.
Key prefix : saisissez le prfixe des fichiers lister. Ainsi, seuls les
fichiers contenant ce prfixe seront lists.
Bucket Cliquez sur le bouton [+] pour ajouter une ou plusieurs lignes afin
de dfinir les prfixes des buckets et fichiers.
Cette option est indisponible lorsque la case List all bucket objects
est coche.
Die on error Cette case est dcoche par dfaut et permet de terminer le traitement
avec les lignes sans erreur, et ignorer les lignes en erreur.
Advanced settings Config client Cochez cette case pour configurer des paramtres client.
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables CURRENT_BUCKET : nom du bucket courant. Cette variable est une variable Flow et retourne
une chane de caractres.
CURRENT_KEY : cl courante. Cette variable est une variable Flow et retourne une chane de
caractres.
NB_BUCKET : nombre de buckets. Cette variable est une variable After et retourne un nombre
entier.
NB_BUCKET_OBJECT : nombre d'objets dans tous les buckets. Cette variable est une variable
After et retourne un nombre entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone ou avec d'autres composants S3, comme le tS3Delete.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Pour plus d'informations concernant la cration d'un bucket et comment y mettre des fichiers, consultez Scnario :
Vrifier l'absence d'un bucket, le crer et lister tous les buckets S3 et Scnario : Echange de fichiers avec Amazon
S3 .
Construire le Job
1. De la Palette, dposez un composant tS3Connection, un tS3List, un tIterateToFlow, un tLogRow et un
tS3Close dans l'espace de modlisation graphique.
2. Dans les champs Access Key et Secret Key, saisissez les informations d'authentification.
4. Cochez la case Use existing connection afin de rutiliser la connexion dfinie prcdemment.
5. Dans la table Bucket, cliquez sur le bouton [+] pour ajouter une ligne.
6. Dans les champs Bucket name et Key prefix, saisissez le nom du bucket et le prfixe du fichier.
Cliquez sur le bouton [+] pour ajouter une colonne. Nommez-la file_list et dfinissez son type String.
9. Dans la table Mapping, appuyez sur les touches Ctrl+Espace dans la colonne Value afin de slectionner
la variable tS3List_1_CURRENT_KEY.
Slectionnez l'option Table (print values in cells of a table) pour un affichage optimal des rsultats.
11. Double-cliquez sur le composant tS3Close afin d'ouvrir sa vue Basic settings.
Comme un seul composant de connexion est utilis dans ce Job, vous n'avez pas besoin de le slectionner
dans la liste Component List, il est slectionn par dfaut.
Excuter le Job
1. Appuyez sur les touches Ctrl+S afin de sauvegarder votre Job.
Comme affich ci-dessus, seuls les fichiers ayant le prfixe "in" sont lists.
tS3Put
Proprits du tS3Put
Famille de composant Cloud/AmazonS3
Fonction Met un fichier dans Amazon S3.
Objectif Le composant tS3Put est conu pour mettre un fichier dans Amazon S3 afin d'y stocker les donnes.
Basic settings Use existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Access Key L'ID de la cl d'accs (Access Key) identifie uniquement un compte
AWS. Pour plus d'informations concernant la cl d'accs et sa
scurit, consultez le site Getting Your AWS Access Keys (en
anglais).
Access Secret La Secret Access Key, combine la cl d'accs, constitue votre
accs scuris Amazon S3.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut tre utilis en standalone ou avec d'autres composants S3, par exemple le
tS3Connection.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Construire le Job
1. Dposez un tS3Connection, un tS3Put et un tS3Get de la Palette dans l'espace de modlisation graphique.
2. Dans les champs Access Key et Secret Key, saisissez les informations d'authentification.
6. Dans le champ Key, saisissez le nom du fichier sauvegarder sur le serveur S3.
7. Dans le champ File, saisissez le nom du fichier charger dans le serveur S3.
11. Dans le champ Key, saisissez le nom du fichier rcuprer du serveur S3.
Excuter le Job
1. Appuyez sur les touches Ctrl + S pour sauvegarder le Job.
Comme affich ci-dessus, cela montre galement l'action russie du composant S3 Put.
Comme affich ci-dessus, le fichier distant est rcupr dans le disque local, ce qui prouve que l'action Get
S3 s'est bien droule.
tSalesforceBulkExec
Le composant tSalesforceBulkExec appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceBulkExec.
tSalesforceConnection
Le composant tSalesforceConnection appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceConnection.
tSalesforceGetDeleted
Le composant tSalesforceGetDeleted appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceGetDeleted.
tSalesforceGetServerTimestamp
tSalesforceGetUpdated
Le composant tSalesforceGetUpdated appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceGetUpdated.
tSalesforceInput
Le composant tSalesforceInput appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceInput.
tSalesforceOutput
Le composant tSalesforceOutput appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceOutput.
tSalesforceOutputBulk
Le composant tSalesforceOutputBulk appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceOutputBulk.
tSalesforceOutputBulkExec
Le composant tSalesforceOutputBulkExec appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceOutputBulkExec.
tSalesforceWaveBulkExec
Le SalesforceWaveBulkExec appartient deux familles : Business et Cloud. Pour plus d'informations, consultez
tSalesforceWaveBulkExec.
tSalesforceWaveOutputBulkExec
tSugarCRMInput
Le composant tSugarCRMInput appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSugarCRMInput.
tSugarCRMOutput
Le composant tSugarCRMOutput appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSugarCRMOutput.
La famille Custom Code regroupe tous les composants rpondant un besoin spcifique de cration de code
la vole.
tGroovy
Proprits du tGroovy
Famille de composant Custom Code
Fonction Le tGroovy permet de saisir du code personnalis afin de l'intgrer dans le programme Talend.
Ce code est excut une seule fois.
Objectif Le tGroovy permet d'tendre les fonctionnalits du Job Talend grce au langage Groovy, qui
est une syntaxe simplifie du Java.
Basic settings Groovy Script Saisissez le code Groovy que vous souhaitez excuter.
Variables Ce tableau comprend deux colonnes :
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant peut tre utilis en standalone, ou en tant que sous-job un seul composant.
Limitation Il est ncessaire de connatre le langage Groovy.
Scnarios associs
Pour un scnario utilisant du Code Groovy, consultez Scnario : Appeler du code Groovy contenu dans un
fichier.
Pour un exemple d'utilisation proche dans le mode de fonctionnement, consultez Scnario : Imprimer le contenu
d'une variable du composant tJava.
tGroovyFile
Proprits du tGroovyFile
Famille de composant Custom Code
Fonction Le tGroovyFile permet d'appeler un script existant dvelopp en Groovy.
Objectif Le tGroovyFile permet d'tendre les fonctionnalits du Job Talend grce au langage Groovy,
qui est une syntaxe simplifie du Java.
Basic settings Groovy File Nom et chemin d'accs au fichier contenant votre code Groovy.
Variables Ce tableau comprend deux colonnes :
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant peut tre utilis en standalone, ou en tant que sous-job un seul composant.
Limitation Il est ncessaire de connatre le langage Groovy.
Construire le Job
Dveloppez le dossier Custom_Code de la Palette et dposez un composant tGroovyFile dans l'espace de
modlisation graphique.
2. Dans le champ Groovy File, saisissez le chemin d'accs au fichier contenant le code Groovy, ou parcourez
votre systme jusqu' ce fichier. Dans cet exemple, le chemin est : D:/Input/Ageducapitaine.txt. Le fichier
contient le code Groovy suivant :
3. Dans la table Variables, ajoutez une ligne en cliquant sur le bouton [+].
4. Dans la colonne Name, saisissez "age" puis, dans la colonne Value, saisissez 50.
Excuter le Job
1. Appuyez sur les touches Ctrl+S afin de sauvegarder votre Job.
2. Appuyez sur F6 ou cliquez sur le bouton Run de la vue Run pour excuter le Job.
La Console affiche les informations contenues dans le fichier d'entre, auxquelles est ajout le rsultat de
la variable.
tJava
Proprits du tJava
Famille de composant Custom Code
Fonction Le tJava permet de saisir du code personnalis afin de l'intgrer dans le programme Talend. Ce
code est excut une seule fois.
Objectif Le tJava permet d'tendre les fonctionnalits du Job Talend grce au langage Java.
Basic settings Code Saisissez le code Java que vous souhaitez excuter. Pour
plus d'informations concernant la syntaxe des fonctions Java
spcifiques Talend, consultez l'aide en ligne du Studio Talend
dans le menu Help Contents > Developer Guide > API Reference.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis en tant que sous-job un seul composant.
Limitation Il est ncessaire de connatre le langage Java.
Construire le Job
1. Cliquez et dposez les composants dans l'espace de modlisation : tFileInputDelimited, tFileOutputExcel,
tJava.
3. Ensuite, connectez le composant tFileInputDelimited au composant tJava l'aide d'un lien de type Trigger
> On Subjob Ok. Ce lien met en place un squenage ordonnant au tJava de se lancer la fin du processus
principal.
2. Pour cet exemple, le schma n'a pas t centralis dans le rfrentiel, vous devez donc configurer
manuellement le schma de ces deux colonnes.
4. Une bote de dialogue vous demandant si vous souhaitez propager les modifications apportes apparat,
cliquez sur OK pour accepter la propagation. Ainsi, le schma du composant tFileOutputExcel est
automatiquement renseign partir du schma du composant prcdent. Vous n'aurez donc pas dfinir le
schma de nouveau.
Dans cet exemple, dans le champ Sheet name, indiquez le nom de la feuille Excel, ici Email et la case Header
est coche pour indiquer que le fichier contient un en-tte.
Dans cet exemple prcis, utilisez la variable NB_Line. Pour accder la liste des variables globales, appuyez sur
Ctrl + Espace de votre clavier et slectionnez la variable globale correspondante.
Excuter le Job
1. Enregistrez le Job en appuyant sur Ctrl+S.
Le contenu est donc transmis au fichier Excel spcifi et le nombre de lignes traites est affich dans la console
Run.
tJavaFlex
Proprits du tJavaFlex
Famille de composant Custom Code
Fonction Le tJavaFlex permet de saisir du code personnalis afin de l'intgrer dans le programme Talend.
Avec le tJavaFlex, vous pouvez saisir les trois diffrentes parties du code Java (start, main et
end) constituant un composant qui permet d'excuter une opration souhaite et non disponible
dans les actuels composants Talend.
Objectif Le tJavaFlex vous permet d'ajouter du code Java dans ses sections de code Start/Main/End.
Basic settings Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant peut tre utilis en tant que composant de dbut, de milieu et de fin de Job, ainsi
qu'en tant que sous-job un seul composant.
Limitation Il est ncessaire de connatre le langage Java.
Construire le Job
1. Cliquez-glissez un composant tJavaFlex de la famille Custom Code et un composant tLogRow de la famille
Logs & Errors dans le Job Designer.
2. Dans la liste Schema, slectionnez le mode Built-in et cliquez sur le bouton [...] ct du champ Edit schema
pour dcrire manuellement la structure des donnes passer au composant suivant.
3. Cliquez sur le bouton [+] pour ajouter deux colonnes : key de type Integer et value de type String.
5. Dans les proprits du tJavaFlex, cochez la case Data Auto Propagate pour propager automatiquement les
donnes au composant suivant.
Dans cet exemple, n'effectuez pas de transformation sur les donnes rcupres.
6. Dans le champ Start code, saisissez le code qui sera excut lors de la phase d'initialisation.
Ici, le code indique l'initialisation du composant tJavaFlex en affichant le message START et met en place
la boucle et les variables utilises par la suite dans le code Java :
System.out.println("## START\n#");
String [] valueArray = {"Miss", "Mrs", "Mr"};
7. Dans le champ Main code, saisissez le code qui sera appliqu pour chaque ligne de donnes. Ici, l'objectif
est de retourner chaque cl (key) avec sa valeur :
row1.key = i;
row1.value = valueArray[i];
Dans le champ Main code, "row1" correspond au nom du lien qui sort du tJavaFlex. Si vous renommez ce lien, vous
devez modifier le code de ce champ.
8. Dans le champ End code, saisissez le code qui sera excut lors de la phase de clture. Ici, l'accolade ferme
la boucle et le code indique la fin de l'excution du tJavaFlex en affichant le message END :
}
System.out.println("#\n## END");
2. Excutez le Job en appuyant sur la touche F6 ou en cliquant sur le bouton Run, dans l'onglet Run.
La console affiche les trois civilits, ainsi que leur cls correspondantes.
Construire le Job
1. Cliquez-glissez un composant tRowGenerator de la famille Misc et un composant tJavaFlex de la famille
Custom Code dans le Job Designer.
2. Dans l'diteur, cliquez sur le bouton [+] pour ajouter quatre colonnes : number, txt, date et flag.
3. Dfinissez le schma en paramtrant ces quatre colonnes conformment la capture d'cran prcdente.
4. Dans la colonne Functions, slectionnez la fonction [...] dans la liste de chaque colonne.
5. Dans la colonne Parameters, saisissez 10 paramtres diffrents pour chaque colonne. Ces 10 paramtres
correspondent aux donnes qui seront retournes de manire alatoire lors de l'excution du tRowGenerator.
2. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent.
3. Dans le champ Start code, saisissez le code qui sera excut lors de la phase d'initialisation. Ici, le code
indique l'initialisation du composant tJavaFlex en affichant le message START et dfinit une variable qui
sera utilise par la suite dans le code Java :
System.out.println("## START\n#");
int i = 0;
4. Dans le champ Main code, saisissez le code qui sera appliqu pour chaque ligne de donnes. Ici, l'objectif est
d'indiquer le numro de la ligne en partant de 0, puis afficher le numro et le texte alatoire que vous mettez
en majuscules et la date alatoire dfinis dans le tRowGenerator. Ensuite, crez une condition affichant si
le statut est true (vrai) ou false (faux) et incrmentez le numro de la ligne :
i++;
Dans le champ Main code, "row1" correspond au nom du lien qui sort du tJavaFlex. Si vous renommez ce lien, il
faut penser modifier le code de ce champ.
5. Dans le champ End code, saisissez le code qui sera excut lors de la phase de clture. Ici, le code indique
la fin de l'excution du composant tJavaFlex en affichant le message END :
System.out.println("#\n## END");
2. Appuyez sur F6 ou cliquez sur Run dans l'onglet Run pour l'excuter.
La console affiche les donnes gnres alatoirement et modifies l'aide du code Java dans le tJavaFlex.
tJavaRow
Proprits du tJavaRow
Famille de composant Custom Code
Fonction Le tJavaRow permet de saisir du code personnalis afin de l'intgrer dans le programme Talend.
Avec le tJavaRow, vous pouvez saisir le code Java qui va tre appliqu pour chaque ligne du
flux.
Objectif Le tJavaRow permet d'tendre les fonctionnalits du Job Talend grce au langage Java.
Basic settings Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Pour saisir une variable globale (par exemple COUNT dans le tFileRowCount)
dans le champ Code, vous devez saisir manuellement le code complet, c'est--dire
((Integer)globalMap.get("tFileRowCount_COUNT")).
Utilisation Ce composant est utilis en tant que composant de milieu de Job, et doit tre reli un composant
de dbut et un composant de sortie.
Limitation Il est ncessaire de connatre le langage Java.
Construire le Job
1. Dposez un composant tFileInputDelimited et un tJavaRow de la Palette dans l'espace de modlisation
graphique et renommez-les afin d'identifier leur rle dans le Job.
2. Connectez les deux composant l'aide d'un lien Row > Main.
2. Dans le champ File name/Stream, saisissez le chemin d'accs au fichier d'entre, entre guillemets doubles,
ou parcourez votre systme en cliquant sur le bouton [...] et saisissez 1 dans le champ Header.
City;Population;LandArea;PopDensity
Beijing;10233000;1418;7620
Moscow;10452000;1081;9644
Seoul;10422000;605;17215
Tokyo;8731000;617;14151
New York;8310000;789;10452
3. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir la bote de dialogue [Schema] et
dfinissez la structure des donnes du fichier d'entre. Cliquez sur OK pour valider le schma et fermer la
bote de dialogue.
5. Cliquez sur Sync columns afin de vous assurer que le schma est bien rcupr du composant prcdent.
Dans cet exemple, vous allez mettre des majuscules aux noms des villes, regrouper les nombres suprieurs
1000 l'aide de sparateurs de milliers pour une meilleure lecture et afficher les donnes dans la console :
2. Appuyez sur F6 ou cliquez sur le bouton Run dans la vue Run pour excuter le Job.
Les informations relatives aux villes sont transformes par le code Java dfini dans le tJavaRow et affiches
dans la console.
tLibraryLoad
Proprits du tLibraryLoad
Famille de composant Custom Code
Fonction Le tLibraryLoad permet d'importer une librairie.
Objectif Le tLibraryLoad permet de charger des librairies Java utilisables dans un Job.
Basic settings Library Slectionnez dans la liste la librairie importer, ou cliquez sur le
bouton [...] afin de parcourir votre rpertoire et choisir la librairie
que vous souhaitez importer.
Advanced settings Dynamic Libs Lib Paths : Saisissez entre guillemets le chemin d'accs votre
librairie.
Import Saisissez le code Java permettant d'importer, si ncessaire, la
librairie externe utilise dans le champ d'dition de code de l'onglet
Basic settings des composants tels que le tJava et le tJavaFlex,
ou encore le tJavaMR dans un Job Map/Reduce.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient.
Cette variable est une variable After et retourne une chane de caractres. Cette variable
fonctionne uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant peut tre utilis en standalone, mais il est plus logique de l'utiliser dans un Job.
Utilisation dans les Jobs Map/ Si vous avez souscrit l'une des solutions Big Data de Talend, vous pouvez utiliser ce composant
Reduce en tant que composant Map/Reduce. Dans un Job Talend Map/Reduce, ce composant est utilis
en standalone. Il gnre du code Map/Reduce natif qui peut tre excut directement dans
Hadoop.
Vous devez utiliser l'onglet Hadoop Configuration de la vue Run afin de dfinir la connexion
une distribution Hadoop donne pour le Job complet.
Cette connexion fonctionne uniquement pour le Job dans lequel vous l'avez dfinie.
Pour plus d'informations concernant les Jobs Talend Map/Reduce, consultez les sections
dcrivant comment crer, convertir et configurer un Job Talend Map/Reduce, dans le Guide de
prise en main de Talend Open Studio for Big Data.
Notez que, dans cette documentation, sauf mention contraire, un scnario prsente uniquement
des Jobs Standard, c'est--dire des Jobs Talend traditionnels d'intgration de donnes et non
des Jobs Map/Reduce.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Construire le Job
1. Dans la Palette, ouvrez le dossier Custom_Code, puis glissez-dposez les composants tLibraryLoad et
tJava dans l'espace de modlisation graphique.
2. Dans l'onglet des Basic settings, saisissez votre code, comme dans la capture d'cran. Ce code permet de
vrifier si une chane de caractres correspond une adresse e-mail, en se basant sur l'expression rgulire
suivante : "^[\\w_.-]+@[\\w_.-]+\\.[\\w]+$".
Excuter le Job
Appuyez sur F6 afin d'enregistrer et d'excuter votre Job.
La Console affiche false, c'est--dire que l'adresse e-mail n'est pas valide. En effet, son format n'est pas correct.
tSetGlobalVar
Proprits du tSetGlobalVar
Famille de composant Custom Code
Fonction Le composant tSetGlobalVar vous permet de dfinir et de configurer les variables globales dans
l'interface graphique.
Objectif Le composant tSetGlobalVar simplifie le processus de dfinition des variables globales.
Basic settings Variables Ce tableau contient deux colonnes.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis comme un sous-job un composant.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation La connaissance du langage Java est ncessaire.
Construire le Job
1. Dposez les composants suivants de la Palette dans l'espace de modlisation graphique : tSetGlobalVar et
tJava.
2. Cliquez sur le bouton [+] pour ajouter une ligne dans la table Variables, puis renseignez les colonnes Key
et Value en saisissant respectivement K1 et 20.
3. Double-cliquez ensuite sur le composant tJava afin d'afficher sa vue Basic settings.
Dans ce scnario, utilisez la variable Result. Pour accder la liste des variables globales, appuyez sur les
touches Ctrl + Espace de votre clavier et slectionnez les paramtres correspondants.
Excuter le Job
Sauvegardez votre Job et appuyez sur F6 pour l'excuter.
La famille Data Quality regroupe les composants vous permettant d'amliorer la qualit de vos donnes. Ces
composants couvrent divers besoin dont la comparaison de colonnes afin d'en extraire des donnes spcifiques.
tAddCRCRow
Proprits du tAddCRCRow
Famille de composant Data Quality
Fonction Ce composant calcule une cl de substitution base sur une ou plusieurs colonne(s) et l'ajoute
au schma dfini.
Objectif Fournir un ID unique afin d'amliorer la qualit des donnes traites.
Basic settings Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Peut tre
Built-in ou Repository
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est une tape intermdiaire. Il requiert un flux entrant et une sortie.
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Construire le Job
1. Glissez les composants suivants dans l'espace de modlisation : tFileInputDelimited, tAddCRCRow et
tLogRow.
2. Crez le schma en cliquant sur le bouton Edit Schema, si le schma n'est pas encore stock dans le
Repository. Vrifiez la colonne du type de donnes, et pour remplir le modle de date (Date pattern), visitez
http://docs.oracle.com/javase/6/docs/api/index.html (en anglais).
2. Notez qu'une colonne CRC (en lecture seule) a t ajoute la fin du schma.
3. Dans l'onglet Advanced settings, slectionnez CRC32 comme CRC Type pour avoir une cl de substitution
plus longue.
4. Dans la vue Basic settings du tLogRow, slectionnez l'option Table (print values in cells of a table) pour
afficher les donnes de sortie sous forme de tableau dans la Console.
Excuter le Job
Sauvegardez votre Job et appuyer sur F6 pour l'excuter.
Une colonne CRC supplmentaire a t ajoute au schma, calcule d'aprs toutes les colonnes prcdemment
slectionnes (dans ce cas toutes les colonnes du schma).
tChangeFileEncoding
Le tChangeFileEncoding appartient deux familles : Data Quality et File. Pour plus d'informations concernant
le composant tChangeFileEncoding, consultez tChangeFileEncoding.
tExtractRegexFields
Le tExtractRegexFields appartient deux familles : Data Quality et Processing. Pour plus d'informations
concernant le composant tExtractRegexFields, consultez tExtractRegexFields.
tFuzzyMatch
Proprits du tFuzzyMatch
Famille de composant Data Quality
Fonction Le composant tFuzzyMatch compare une colonne du flux principal avec une colonne du flux
de rfrence et extrait les donnes du flux principal en affichant la distance.
Objectif Le tFuzzyMatch permet d'assurer la qualit des donnes de n'importe quelle source de donnes
en la comparant avec une source de donnes de rfrence.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (built-in) soit distant dans le Repository.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant n'est pas un composant de dbut (fond vert) et il ncessite deux composants
d'entre et un composant de sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Construire le Job
1. Cliquez et dposez les composants suivants de la Palette dans l'espace de modlisation : deux
tFileInputDelimited, un tFuzzyMatch et un tLogRow.
2. Reliez le premier tFileInputDelimited au composant tFuzzyMatch l'aide d'un lien Row > Main.
3. Connectez le second tFileInputDelimited au tFuzzyMatch l'aide d'une connexion de type Row > Main
(qui apparat comme Lookup dans l'espace de modlisation graphique).
4. Reliez le tFuzzyMatch au composant de sortie tLogRow, l'aide d'un lien Row > Main.
2. Dfinissez le schma du composant. Dans cet exemple, le schma d'entre possde deux colonnes, firstname
et gender.
Assurez-vous que la colonne de rfrence a bien t dfinie comme colonne cl dans le schma du flux de rfrence
(lookup).
4. Double-cliquez sur le tFuzzyMatch pour ouvrir sa vue Basic settings et vrifiez son schma.
Le schma doit correspondre celui du flux d'entre principal (Main) afin que le flux principal soit compar
au flux de rfrence.
Notez que deux colonnes : Value et Matching sont ajoutes au schma de sortie. Elles correspondent des
informations standard de correspondance et sont en lecture seule.
5. Slectionnez la mthode utiliser pour la vrification des donnes entrantes. Dans ce scnario, la
correspondance slectionner dans le champ Matching type est de type Levenshtein.
6. Ensuite dfinissez la distance. Dans cette mthode, la distance est le nombre de caractres modifis (insertion,
suppression ou substitution) pour que l'entre principale corresponde exactement l'entre de rfrence.
Dans ce scnario, configurez la distance 0 au minimum et au maximum dans les champs Min. distance et
Max. distance. Ce qui signifie que seule une correspondance exacte sera redirige en flux de sortie.
Excuter le Job
Enregistrez le Job et appuyez sur la touche F6 pour excuter le Job.
Comme la distance d'dition dfinie est de 0 (min. et max.), la sortie correspond une jointure entre le flux principal
et le flux de rfrence (lookup), ainsi seules les correspondances totales avec une valeur gale 0 sont affiches.
Pour un exemple plus vident avec une distance minimum de 1 et une distance maximum de 2, consultez
Scnario 2 : Distance de Levenshtein de 1 ou 2 pour les prnoms
1. Dans la vue Component du tFuzzyMatch, modifiez la distance minimum de 0 1. Ceci exclut directement
les correspondances exactes (qui ont une distance de 0).
2. Maintenant mettez une distance maximum de 2. La sortie correspond toutes les donnes mises en
correspondance contenant une diffrence de 2 caractres au plus.
3. Assurez-vous que le sparateur de champs (Matching item separator) est bien dfini, vu que plusieurs
entres de rfrence peuvent correspondre l'entre du flux principal.
Etant donn que la distance d'dition a t dfinie 2, certaines entres du flux principal correspondent plusieurs
entres de rfrence (lookup).
Vous pouvez utiliser une autre mthode, Mtaphone, pour valuer la distance entre le flux principal et le flux de
rfrence, dcrite dans le scnario suivant.
1. Modifiez le champ Matching type avec l'option Metaphone. Aucune distance minimum et aucune distance
maximum ne sont dfinir puisque cette mthode est base sur les diffrences de phontique avec la rfrence.
2. Enregistrez le Job et appuyez sur F6. La valeur phontique est affiche avec les correspondances possibles.
tIntervalMatch
Proprits du tIntervalMatch
Famille de composant Data Quality
Fonction Le composant tIntervalMatch permet d'tablir une jointure entre un flux principal et un flux
de rfrence. Il classe une valeur spcifie du flux principal dans la fourchette de valeurs
correspondante dfinie dans le flux de rfrence et retourne les informations correspondantes.
Objectif Il aide retourner une valeur l'aide d'une jointure.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant manipule un flux de donnes, il requiert donc un Input et un Output, et ncessite
la dfinition d'une tape intermdiaire.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Construire le Job
1. Dans l'espace de modlisation, glissez deux composants tFileInputDelimited, un tIntervalMatch et un
tLogRow.
2. Parcourez votre systme jusqu'au fichier d'entre principal, contenant une liste des serveurs et de leur adresse
IP.
Server;IP
Server1;057.010.010.010
Server2;001.010.010.100
Server3;057.030.030.030
Server4;053.010.010.100
3. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir la bote de dialogue [Schema] et
configurer le schma d'entre. Selon la structure du fichier d'entre, le schma se compose de deux colonnes,
Server et IP, de type String. Cliquez sur OK pour fermer la bote de dialogue.
4. Dans le champ Header, saisissez le nombre de lignes d'en-tte ignorer et laissez les autres champs tels
qu'ils sont.
Le fichier utiliser en entre pour le flux de rfrence liste, dans cet exemple, des intervalles d'adresses IP
et le pays correspondant.
StartIP;EndIP;Country
001.000.000.000;001.255.255.255;USA
002.006.190.056;002.006.190.063;UK
011.000.000.000;011.255.255.255;USA
057.000.000.000;057.255.255.255;France
012.063.178.060;012.063.178.063;Canada
053.000.000.000;053.255.255.255;Germany
7. Dans la liste Search Column, slectionnez le flux d'entre principal contenant les valeurs mettre en
correspondance avec les intervalles de valeurs. Dans cet exemple, les adresses IP des serveurs doivent
correspondre aux intervalles de valeurs du flux de rfrence.
8. Dans la liste Column (LOOKUP), slectionnez la colonne de rfrence contenant les valeurs retourner.
Dans cet exemple, il s'agit du nom des pays o se trouvent les serveurs.
9. Configurez les colonnes de rfrence minimale et maximale correspondant aux limites de l'intervalle dfini
dans le schma de rfrence, StartIP et EndIP, respectivement.
Excuter le Job
Appuyez sur les touches Ctrl+S pour sauvegarder votre Job et appuyez sur F6 pour l'excuter.
Le nom du pays o est hberg chaque serveur s'affiche ct de l'adresse IP correspondante, dans la console.
tReplaceList
Proprits du tReplaceList
Famille de composant Data Quality
Fonction Le tReplaceList effectue un rechercher/remplacer dans les colonnes d'entre spcifies en
fonction des donnes de rfrence (lookup).
Objectif Ce composant permet de nettoyer tous les fichiers avant un traitement futur.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (built-in) soit distant dans le Repository.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est un composant intermdiaire, il ncessite un composant d'entre et un
composant de sortie.
Construire le Job
1. Dposez les composants suivants de la Palette dans l'espace de modlisation graphique : deux
tFileInputDelimited, un tReplaceList et un tLogRow.
2. Reliez les deux tFileInputDelimited au tReplaceList l'aide de liens Row > Main. Notez que le lien entre
le composant de rfrence (le second tFileInputDelimited) et le tReplaceList apparat comme lien Lookup.
3. Reliez le composant tReplaceList au tLogRow l'aide d'un lien Row > Main.
Dans cet exemple, le fichier principal d'entre fournit une liste de personnes et d'tats des Etats-Unis. Voici
un extrait du fichier :
name;state
Andrew Kennedy;Mississippi
Benjamin Carter;Louisiana
Benjamin Monroe;West Virginia
Bill Harrison;Tennessee
Calvin Grant;Virginia
Chester Harrison;Rhode Island
Chester Hoover;Kansas
Chester Kennedy;Maryland
Chester Polk;Indiana
Dwight Nixon;Nevada
Dwight Roosevelt;Mississippi
Franklin Grant;Nebraska
2. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir la bote de dialogue [Schema] et
configurer le schma d'entre.
Selon la structure du fichier d'entre principal, le schma d'entre doit contenir deux colonnes : name et state.
Cliquez sur OK pour fermer la bote de dialogue et propager les modifications au composant suivant.
Dans cet exemple, le fichier de rfrence fournit une liste d'tats ainsi que leur code deux lettres. Le schma
de rfrence doit donc comprendre deux colonnes : state et code.
4. Double-cliquez sur le tReplaceList pour ouvrir sa vue Basic settings et paramtrer l'opration effectuer.
5. Dans la liste Lookup search column, slectionnez la colonne rechercher. Dans ce scnario, recherchez
la colonne state.
6. Dans la liste Lookup replacement column, slectionnez la colonne contenant les valeurs de remplacement,
code pour les codes deux lettres des tats, dans cet exemple.
7. Dans la table Column options, cochez la case Replace pour la colonne states, afin de remplacer le nom des
tats par le code correspondant.
8. Dans le composant tLogRow, slectionnez l'option Table pour une meilleure lisibilit de la sortie.
Excuter le Job
Sauvegardez le Job et appuyez sur F6 pour l'excuter.
tSchemaComplianceCheck
Proprits du tSchemaComplianceCheck
Famille de composant Data Quality
Fonction Ce composant valide toutes les lignes d'entre en fonction du schma de rfrence ou vrifie les types,
la nullabilit, la longueur de la ligne en fonction des valeurs de rfrence. Cette validation peut tre
applique l'ensemble des lignes ou une partie seulement.
Objectif Le tSchemaComplianceCheck permet d'assurer la qualit des donnes de n'importe quelle source de
donnes en les comparant aux donnes de rfrence.
Basic settings Base Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs
qui sont traits et passs au composant suivant. Le schma est soit local
(Built-in) soit distant dans le Repository.
Pour effectuer cette vrification sur toutes les colonnes, cochez la case
d'en-tte du tableau.
Date pattern : Dfinissez le format de date souhait sur chaque colonne
avec le type de donnes Date.
Nullable : Cochez la case de la colonne que vous souhaitez dfinir
comme colonne nullable, afin de permettre aux lignes vide dans cette
colonne de se diriger vers le flux de sortie sans tenir compte du schma
de base dfini. Pour dfinir toutes les colonnes comme nullables, cochez
la case d'en-tte du tableau.
Undefined or empty : Cochez la case de la colonne dont vous souhaitez
rejeter les lignes vides, alors que la colonne n'est pas nullable dans la
dfinition du schma de base. Pour effectuer cette vrification sur toutes
les colonnes, cochez la case au niveau de l'en-tte de la table.
Max length : Cochez la case de la colonne dont vous souhaitez vrifier
la longueur des donnes en fonction de la longueur dfinie dans le
schma de base. Pour effectuer cette vrification sur toutes les colonnes,
cochez la case d'en-tte du tableau.
Use another schema for Dfinissez un schma de rfrence en donnant aux donnes les
compliance check proprits qu'elles sont censes avoir. Ainsi, les donnes non conformes
seront rejetes.
Cette case n'est pas disponible lorsque le mode Check all columns
from schema est slectionn.
Treat all empty string as Cochez cette case afin de traiter tous les champs vides de chaque
NULL colonne comme des valeurs nulles, plutt que comme des chanes de
caractres vides.
Cette case est coche par dfaut. Lorsqu'elle est dcoche, le tableau
Choose Column(s) s'affiche pour vous permettre de slectionner les
colonnes que vous souhaitez.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant. Notez que cette case n'est pas disponible dans la version
Map/Reduce de ce composant.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant intermdiaire permettant d'exclure les donnes non conformes du
flux principal. Ce composant ne peut tre utilis comme composant de dbut puisqu'il requiert un
flux d'entre. Il ncessite aussi au moins un composant de sortie afin de regrouper les flux valids et
ventuellement un deuxime pour les donnes rejetes via un lien Rejects. Pour plus d'informations,
consultez le Guide utilisateur du Studio Talend.
Utilisation dans des Jobs Si vous avez souscrit l'une des solutions Big Data de Talend, ce composant est galement disponible
Map/Reduce en tant que composant Map/Reduce. Dans un Job Talend Map/Reduce, il est utilis comme tape
intermdiaire, avec d'autres composants Map/Reduce. Ils gnrent nativement du code Map/Reduce
pouvant tre excut directement dans Hadoop.
Pour plus d'informations concernant les Jobs Talend Map/Reduce, consultez les sections dcrivant
comment crer, convertir et configurer un Job Talend Map/Reduce, dans le Guide de prise en main
de Talend Open Studio for Big Data.
Notez que, dans cette documentation, sauf mention contraire, un scnario prsente uniquement des
Jobs Standard, c'est--dire des Jobs Talend traditionnels d'intgration de donnes et non des Jobs
Map/Reduce.
Le flux d'entre provient d'un fichier csv simple contenant des donnes dont les proprits ont un mauvais type,
un mauvais id, dont les donnes sont suprieures la longueur maximum, ou contenant des valeurs nulles dans
les colonnes alors que celles-ci sont dfinies comme non nullables.
ID;Name;BirthDate;State;City
1;Dwight;06-04-2008;Delaware;Concord
2;Warren;25-10-2008;Montana
3;Benjamin;17-08-2008;Washington;Austin
4;Harry;14-04-2008;Kansas;Annapolis
5;Ulysses;2007-04-12;Michigan;Raleigh
6;James;19-08-2007;Delaware;Charleston
.7;Bill;20-04-2007;Illinois;Bismarck
8;Ulysses;04-12-2008;;Saint Paul
9;Thomas;09-05-2008;Maryland;Albany
10;Ronald;11-02-2008;Florida;Hartford
Construire le Job
1. A partir de la Palette, cliquez et dposez les composants suivants dans l'espace de modlisation graphique :
tFileInputDelimited, tSchemaComplianceCheck, ainsi que deux composants tLogRow.
3. Cliquez-droit sur le composant tSchemaComplianceCheck et slectionnez Row > Main pour le connecter
au premier composant tLogRow. Ce flux de sortie ne contiendra que les donnes valides.
4. Cliquez-droit une deuxime fois sur le composant tSchemaComplianceCheck et cette fois slectionnez
Row > Rejects pour le connecter au second composant tLogRow. Cette deuxime sortie regroupera toutes
les donnes non conformes. Il passe deux colonnes supplmentaires au composant suivant : ErrorCode et
ErrorMessage. Ces deux colonnes en lecture seule fournissent des informations concernant les donnes
rejetes afin de simplifier la gestion d'erreurs et la rsolution de problmes, si ncessaire.
2. Cliquez sur le bouton [...] ct du champ Edit Schema pour dcrire la structure de donnes de ce fichier
d'entre. Dans ce scnario, le schma est compos de cinq colonnes : ID, Name, BirthDate, State et City.
3. Renseignez le champ Length des colonnes Name, State et City : respectivement 7, 10 et 10, puis cliquez sur
OK pour fermer la bote de dialogue et propager le schma.
5. Cochez l'option Custom defined dans la zone Mode pour effectuer des validations personnalises. Dans cet
exemple, le tableau Checked columns permet de configurer les paramtres de validations.
Cependant, vous pouvez aussi cocher la case Check all columns from schema si vous souhaitez vrifier tous
les paramtres de toutes les colonnes (type, valeurs nulles et longueur), en fonction du schma de base dfini,
ou encore cocher l'option Use another schema for compliance check et dfinir le schma de la structure
des donnes souhait.
6. Dans le tableau Checked Columns, dfinissez les vrifications effectuer. Pour ce scnario :
- Cochez la case Length afin que les longueurs des colonnes Name, State et City soient vrifies.
- Slectionnez Date comme Type de donnes de la colonne BirthDate et dd-MM-yyyy comme Date pattern.
- Dcochez la case Nullable afin que les valeurs nulles de toutes les colonnes soient vrifies.
Pour rejeter les champs dont les donnes sont suprieures la longueur maximum dfinie, assurez-vous que la case
Trim the excess content of column when length checking chosen and the length is greater than defined length
est dcoche.
7. Dans la vue Advanced settings du composant tSchemaComplianceCheck, cochez la case Treat all empty
string as NULL afin de rejeter toutes les lignes contenant des champs vides.
8. Pour visualiser le rsultat du processus de validation sous forme de tableau dans la console Run, double-
cliquez sur chaque composant tLogRow et cochez la case Table dans leur vue Basic settings.
Excuter le Job
Enregistrez votre Job et appuyez sur F6 pour l'excuter.
Deux tableaux s'affichent dans la console, qui montrent respectivement les donnes valides et les donnes rejetes.
tUniqRow
Proprits du tUniqRow
Famille de composant Data Quality
Fonction Le composant tUniqRow compare les entres et supprime les doublons du flux d'entre.
Objectif Ce composant assure une qualit de donnes des flux d'entre et de sortie du Job.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (built-in) soit distant dans le Repository.
NB_DUPLICATES : nombre de lignes en doublon. Cette variable est une variable After et
retourne un nombre entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est un composant intermdiaire puisqu'il sert traiter un flux de donnes. Ainsi,
il ncessite un composant d'entre et un composant de sortie.
Utilisation dans des Jobs Map/ Si vous avez souscrit l'une des solutions Big Data de Talend, ce composant est galement
Reduce disponible en tant que composant Map/Reduce. Dans un Job Talend Map/Reduce, il est utilis
comme tape intermdiaire, avec d'autres composants Map/Reduce. Ils gnrent nativement du
code Map/Reduce pouvant tre excut directement dans Hadoop.
Pour plus d'informations concernant les Jobs Talend Map/Reduce, consultez les sections
dcrivant comment crer, convertir et configurer un Job Talend Map/Reduce, dans le Guide de
prise en main de Talend Open Studio for Big Data.
Notez que, dans cette documentation, sauf mention contraire, un scnario prsente uniquement
des Jobs Standard, c'est--dire des Jobs Talend traditionnels d'intgration de donnes et non
des Jobs Map/Reduce.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Construire le Job
1. A partir de la Palette, cliquez et dposez les composants suivants dans l'espace de modlisation graphique :
un tFileInputDelimited, un tSortRow, un tUniqRow, ainsi que deux composants tLogRow, et nommez-
les comme illustr ci-dessus.
2. Connectez les composants tFileInputDelimited, tSortRow, et tUniqRow l'aide de liens Row > Main.
3. Connectez le tUniqRow au premier tLogRow l'aide d'un lien Main > Uniques.
4. Connectez le composant tUniqRow au second tLogRow via une connexion de type Main > Duplicates.
2. Cliquez sur le bouton [...] ct du champ File Name pour slectionner le fichier contenant les donnes
d'entre.
3. Dfinissez l'en-tte (Header) et le pied de page (Footer). Dans ce scnario, la ligne d'en-tte est la premire
ligne du fichier d'entre.
4. Cliquez sur Edit schema pour dfinir le schma de ce composant. Dans ce scnario, le fichier d'entre
comprend cinq colonnes : Id, FirstName, LastName, Age, et City. Cliquez ensuite sur OK pour propager le
schma et fermer l'diteur de schma.
6. Afin de disposer les entres en fonction de l'ordre alphabtique des noms, ajoutez deux lignes au tableau
Criteria en cliquant sur le bouton [+], slectionnez les colonnes FirstName et LastName sous Schema
column, slectionnez le type de tri alphabtique (alpha), puis slectionnez l'ordre ascendant (asc).
7. Double-cliquez sur le composant tUniqRow afin d'afficher l'onglet Basic settings de sa vue Component.
8. Dans la zone Unique key, slectionnez les colonnes sur lesquelles vous souhaitez effectuer le ddoublonnage.
Dans ce scnario, les noms en doublon seront tris.
9. Dans l'onglet Basic settings de la vue Component des deux composants tLogRow, cochez l'option Table
afin de visualiser le rsultat de l'excution du Job en mode tableau.
2. Excutez le Job en appuyant sur la touche F6 ou en cliquant sur le bouton Run de l'onglet Run.
Dans la console Run, les noms uniques et les noms en doublon sont affichs dans des tableaux diffrents.
Notez que les composants Talend Map/Reduce ne sont disponibles que si vous avez souscrit l'une des solutions
Big Data de Talend et que ce scnario ne peut tre reproduit qu'avec des composants Map/Reduce.
1;Harry;Ford;68;Albany
2;Franklin;Wilson;79;Juneau
3;Ulysses;Roosevelt;25;Harrisburg
4;Harry;Ford;48;Olympia
5;Martin;Reagan;75;Columbia
6;Woodrow;Roosevelt;63;Harrisburg
7;Grover;McKinley;98;Atlanta
8;John;Taft;93;Montpelier
9;Herbert;Johnson;85;Lincoln
10;Grover;McKinley;33;Lansing
Etant donn que le Studio Talend vous permet de convertir un Job Map/Reduce en Job Standard (non Map/
Reduce) et vice-versa, vous pouvez convertir le scnario prsent prcdemment afin de crer ce Job Map/Reduce.
Ainsi, la plupart des composants utiliss peuvent garder leurs paramtres d'origine afin de rduire votre charge
de travail pour la cration de ce Job.
Avant de commencer ce scnario, assurez-vous de disposer des droits d'accs Hadoop ncessaires pour accder
la distribution Hadoop utilise. Procdez ensuite comme suit :
Convertir le Job
1. Dans le Repository de la perspective Integration du Studio Talend, cliquez-droit sur le Job que vous avez
cr dans le scnario prcdent afin d'ouvrir son menu contextuel. Slectionnez ensuite Edit properties.
L'assistant [Edit properties] s'ouvre alors. Notez que le Job doit tre ferm avant que vous ne puissiez
effectuer des changements dans cet assistant.
Notez que vous pouvez changer le nom du Job ainsi que les autres informations de description du Job partir
de cet assistant.
2. Cliquez sur Convert to Map/Reduce Job. Un Job Map/Reduce portant le mme nom apparat sous le sous-
nud Map/Reduce Jobs du nud Job Design.
Si vous devez partir d'un Job Map/Reduce Job vierge, cliquez-droit sur le nud Job Design ou sur le sous-nud
Map/Reduce Jobs et slectionnez Create Map/Reduce Job dans le menu contextuel. Un Job vierge s'ouvre dans
l'espace de modlisation graphique. Pour plus d'informations, consultez la section dcrivant comment crer un Job
Map/Reduce dans le Guide de prise en main de Talend Open Studio for Big Data.
2. Cliquez-droit sur chacun des composants en question et slectionnez Delete afin de les supprimer.
4. Connectez le tHDFSInput au tSortRow l'aide d'un lien Row > Main et acceptez le schma provenant
du tSortRow.
5. Connectez le tUniqRow au tHDFSOutput l'aide d'un lien Row > Uniques et au tJDBCOutput l'aide
d'un lien Row > Duplicates.
2. Dans la liste Property type, slectionnez Built-in. Si vous avez cr une connexion afin qu'elle soit utilisable
depuis le Repository, slectionnez alors Repository afin que le Studio Talend rutilise les informations de
connexion pour ce Job.
Pour plus d'informations concernant la cration d'une connexion Hadoop dans le Repository, consultez le
chapitre dcrivant le nud Hadoop cluster du Guide de prise en main de Talend Open Studio for Big Data.
3. Dans la zone Version, slectionnez la distribution Hadoop utiliser et sa version. Si vous ne trouvez pas
la distribution correspondant la votre dans la liste, slectionnez Custom afin de vous connecter une
distribution Hadoop non officiellement supporte par le Studio Talend.
Pour un exemple d'utilisation tape par tape de cette option Custom, consultez Connexion une distribution
Hadoop personnalise.
Si vous utilisez Hortonworks Data Platform V2.2, les fichiers de configuration de votre cluster peuvent
utiliser des variables d'environnement comme ${hdp.version}. Si vous tes dans cette situation, vous devez
configurer la proprit mapreduce.application.framework.path dans la table Hadoop properties, avec la
valeur du chemin d'accs pointant explicitement vers l'archive du framework MapReduce de votre cluster.
Par exemple :
mapreduce.application.framework.path=/hdp/apps/2.2.0.0-2041/mapreduce/
mapreduce.tar.gz#mr-framework
Si vous utilisez Hortonworks Data Platform V2.0.0, le type de systme d'exploitation utilis pour la
distribution Hadoop et pour le Job Talend doit tre identique, par exemple Windows ou Linux. Sinon, vous
devez utiliser le Jobserver de Talend afin d'excuter un Job dans le mme type de systme d'exploitation
que celui dans lequel la distribution Hortonworks Data Platform V2.0.0 utilise est excute. Pour plus
d'informations concernant le Jobserver de Talend, consultez le Guide d'installation et de migration Talend.
4. Dans le champ Name node, saisissez l'emplacement du nud matre, le NameNode, de la distribution utilise.
Par exemple, hdfs://tal-qa113.talend.lan:8020.
Si vous utilisez une distribution MapR, vous pouvez simplement laisser maprfs:/// dans ce champ. Le client
MapR se charge de crer la connexion au moment de l'excution. Notez que le client doit tre correctement
install. Pour plus d'informations concernant la configuration d'un client MapR, consultez la page suivante
sur le site de la documentation de MapR : http://doc.mapr.com/display/MapR/Setting+Up+the+Client (en
anglais).
5. Dans le champ Job tracker, saisissez l'emplacement du JobTracker de votre distribution. Par exemple, tal-
qa114.talend.lan:8050.
Notez que le mot "Job" dans le terme "JobTracker" dsigne les Jobs MR ou Map/Reduce dcrits dans la
documentation Apache disponible sur le site Internet d'Apache http://hadoop.apache.org/ (en anglais).
Si vous utilisez YARN dans votre cluster Hadoop, comme Hortonworks Data Platform V2.0.0 ou Cloudera
CDH4.3 + (mode YARN), vous devez spcifier l'emplacement du Resource Manager et non celui du
Jobtracker. Vous pouvez continuer configurer les paramtres suivants selon la configuration du cluster
Hadoop utiliser :
Cochez la case Set jobhistory address et saisissez l'emplacement du serveur JobHistory du cluster Hadoop
utiliser. Cela permet de stocker les informations relatives aux mtriques du Job courant sur le serveur
JobHistory.
Cochez la case Set staging directory et saisissez le chemin d'accs au rpertoire dfini dans votre cluster
Hadoop pour les fichiers temporaires crs par l'excution de programmes. Ce rpertoire se trouve sous
la proprit yarn.app.mapreduce.am.staging-dir dans les fichiers de configuration, notamment les fichiers
yarn-site.xml et mapred-site.xml de votre distribution.
Cochez la case Use datanode hostname pour permettre au Job d'accder aux nuds de donnes via
leurs hbergeurs. Cela configure la proprit dfs.client.use.datanode.hostname true. Lorsque vous vous
connectez un systme de fichiers S3N, vous devez cocher cette case.
6. Si la distribution utilise ncessite une authentification Kerberos, cochez la case Use Kerberos
authentication et saisissez les dtails d'authentification. Sinon, laissez cette case dcoche.
Si vous accdez au cluster Hadoop fonctionnant avec la scurit de Kerberos, cochez cette case, puis saisissez
le "principal name" de Kerberos pour le NameNode dans le champ affich. Cela vous permet d'utiliser votre
identifiant pour vous authentifier, en le comparant aux identifiants stocks dans Kerberos.
De plus, comme ce composant effectue des calculs Map/Reduce, vous devez galement authentifier les
services associs, comme le serveur de l'historique des Jobs et le gestionnaire de ressources ou le JobTracker,
selon votre distribution, dans le champ correspondant. Ces principaux se trouvent dans les fichiers de
configuration de votre distribution. Par exemple, dans une distribution CDH4, le principal du gestionnaire
de ressource est configur dans le fichier yarn-site.xml et le principal de l'historique des Job dans le fichier
mapred-site.xml.
Si vous souhaitez utiliser un fichier Kerberos keytab pour vous identifier, cochez la case Use a keytab to
authenticate. Un fichier keytab contient des paires de principaux et cls cryptes Kerberos. Vous devez saisir
le principal utiliser dans le champ Principal et le chemin d'accs au fichier keytab dans le champ Keytab.
Notez que l'utilisateur qui excute un Job utilisant un keytab n'est pas forcment celui dsign par le principal
mais qu'il doit avoir le droit de lecture pour le fichier keytab utilis. Par exemple, le nom d'utilisateur que
vous utilisez pour excuter le Job est user1 et le principal utiliser est guest. Dans cette situation, assurez-
vous que user1 a les droits de lecture pour le fichier keytab utiliser.
7. Dans le champ User name, saisissez votre nom d'utilisateur pour votre distribution. Si vous laissez ce champ
vierge, le nom d'utilisateur de la machine hbergeant le Studio Talend est utilis.
8. Dans le champ Temp folder, saisissez le chemin d'accs au dossier HDFS dans lequel sont stocks les fichiers
temporaires gnrs pendant les oprations de Map/Reduce.
9. Laissez le champ Path separator in server tel quel, sauf si vous changez le sparateur utilis par la machine
hte de votre distribution Hadoop pour sa variable PATH. En d'autres termes, changez le sparateur si celui-
ci n'est pas le signe deux points (:). Dans ce cas, vous devez remplacer cette valeur par celle utilise dans
votre hte.
10. Laissez la case Clear temporary folder (Effacer le contenu du dossier temporaire) coche, sauf si vous
souhaitez garder ces fichiers temporaires.
11. Laissez la case Compress intermediate map output to reduce network traffic coche, afin de rduire le
temps de transfert des partitions du Mapper aux diffrents Reducers.
Cependant, si le transfert des donnes dans le Job est ngligeable, il est recommand de dcocher cette case
afin de dsactiver l'tape de compression, car la compression consomme des ressources supplmentaires du
CPU.
12. Si vous souhaitez utiliser des proprits Hadoop personnalises, renseignez la table Hadoop properties
avec la ou les proprit(s) personnaliser. Lors de l'excution, ces modifications crasent les proprits
correspondantes par dfaut utilises par le Studio pour son moteur Hadoop.
Pour plus d'informations concernant les proprits requises par Hadoop, consultez la documentation Apache
Hadoop sur le site http://hadoop.apache.org (en anglais), ou la documentation de la distribution Hadoop que
vous utilisez.
13. Si le systme Hadoop utilis est Hortonworks Data Platform V1.2 ou Hortonworks Data Platform V1.3,
vous devez dfinir des allocations de mmoire suffisantes pour que les oprations de map et reduce soient
effectues par le systme Hadoop.
Dans ce cas, vous devez saisir les valeurs que vous souhaitez utiliser pour la mmoire alloue aux oprations
map et reduce dans les champs Mapred job map memory mb et Mapred job reduce memory mb,
respectivement. Par dfaut, les valeurs sont toutes les deux 1000, ce qui est normalement adapt pour
l'excution de ces oprations.
Si la distribution utilise est YARN, les paramtres de mmoire dfinir sont alors Map (in Mb), Reduce
(in Mb) et ApplicationMaster (in Mb), respectivement. Ces champs permettent d'allouer dynamiquement
de la mmoire aux oprations map et reduce et l'ApplicationMaster de YARN.
Pour plus d'informations sur l'onglet Hadoop Configuration, consultez la section dcrivant comment configurer
la connexion Hadoop pour un Job Talend Map/Reduce dans le Guide de prise en main de Talend Open Studio
for Big Data.
Pour plus d'informations sur le Resource Manager, son ordonnanceur et l'ApplicationMaster, consultez la
documentation de YARN sur le site http://hortonworks.com/blog/apache-hadoop-yarn-concepts-and-applications/
(en anglais).
Configurer le tHDFSInput
2.
Cliquez sur le bouton situ ct du champ Edit schema afin de vrifier si le schma reu dans les
tapes prcdentes a t correctement dfini.
Notez que si vous avez cr ce Job partir d'un Job vierge, vous devez cliquer sur le bouton afin
d'ajouter manuellement ces colonnes au schma. Si le schma a t dfini dans le Repository, vous pouvez
slectionner l'option Repository dans la liste Schema de la vue Basic settings afin de le rutiliser. Pour plus
d'informations sur comment dfinir un schma dans le Repository, consultez le chapitre dcrivant la gestion
des mtadonnes dans le Guide utilisateur deStudio Talend ou le chapitre dcrivant le nud Hadoop cluster
du Repository dans le Guide de prise en main de Talend Open Studio for Big Data.
3. Si vous effectuez des changements dans le schma, cliquez sur OK afin de valider ces changements et
acceptez la propagation propose par la bote de dialogue qui s'affiche.
4. Dans le champ Folder/File, saisissez le chemin d'accs au fichier source que vous souhaitez que le Job lise.
Vous pouvez galement parcourir votre systme de fichiers afin de dfinir ce chemin.
Si le fichier ne se trouve pas dans le systme HDFS utilis, vous devez le placer dans le systme HDFS. Pour
cela, vous pouvez par exemple utiliser le tFileInputDelimited et le tHDFSOutput dans un Job Standard.
Ce composant garde la configuration utilise dans le Job d'origine. Il trie les donnes d'entre par ordre
alphabtique partir des colonnes FirstName et LastName.
Le composant garde galement la configuration utilise dans le Job d'origine. Il spare les donnes d'entres
en un flux Uniques et un flux Duplicates (Doublons), puis envoie les donnes uniques dans le tHDFSOutput
et les doublons dans le tJDBCOutput.
Configurer le tHDFSOutput
3. Dans le champ Folder, saisissez le chemin d'accs au dossier dans lequel vous souhaitez crire les donnes
uniques. Vous pouvez galement parcourir votre systme de fichiers afin de dfinir ce chemin.
4. Dans la liste Action, slectionnez l'opration que vous souhaitez excuter sur le dossier en question. Si le
dossier existe dj, slectionnez Overwrite. Sinon, slectionnez Create.
Configurer le tJDBCOutput
2. Dans le champ JDBC URL, saisissez l'URL de la base de donnes dans laquelle vous souhaitez crire les
doublons. Dans cet exemple, l'URL est jdbc:mysql://10.42.10.13:3306/Talend, une base de donnes MySQL
appele Talend.
3.
Dans le tableau Drive JAR, ajoutez une nouvelle ligne au tableau en cliquant sur le bouton .
4.
Cliquez sur cette nouvelle ligne, puis cliquez sur le bouton afin d'ouvrir la bote de dialogue [Select
Module]. Cette bote de dialogue vous permet d'importer le fichier Jar requis par la base de donnes MySQL.
5. Dans le champ Class name, saisissez la classe de fichier appeler. Dans cet exemple, saisissez
org.gjt.mm.mysql.Driver.
6. Dans les champs User name et Password, saisissez les informations d'authentification relatives cette base
de donnes.
7. Dans le champ Table name, saisissez le nom de la table dans laquelle vous souhaitez crire les donnes, par
exemple Namelist. Cette table doit exister.
Excuter le Job
Appuyez sur la touche F6 pour excuter le Job.
Une fois le Job excut, vous pouvez visualiser les rsultats d'excution dans la console Web de HDFS et dans
la base de donnes MySQL.
Dans HDFS, les entres uniques sont crites dans des fichiers spars.
Si vous souhaitez plus d'informations concernant le Job et son excution, utilisez la console Web fournie par la
distribution Hadoop que vous utilisez.
tUniservBTGeneric
Proprits du tUniservBTGeneric
Famille de composant Data Quality
Fonction Le composant tUniservBTGeneric permet l'excution d'un processus (Job) cr avec le produit
Uniserv DQ Batch Suite.
Objectif Le tUniservBTGeneric envoie les donnes DQ Batch Suite et lance le processus spcifi dans
DQ Batch Suite. Quand l'excution du processus est termine, les rsultats sont renvoys Data
Quality Service Hub Studio pour d'autres oprations.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Cliquez sur Retrieve Schema pour crer un schma qui pour les
composants qui correspondra aux champs d'entre et de sortie du
processus de DQ Batch Suite.
Host name Nom du serveur matre sur lequel est lanc DQ Batch Suite, entre
guillemets doubles.
Port Numro du port sur lequel le serveur de DQ Batch Suite est lanc,
entre guillemets doubles.
Client Server Nom du serveur client de DQ Batch Suite, entre guillemets doubles.
User name Nom d'utilisateur enregistr pour le serveur de DQ Batch Suite.
L'utilisateur doit avoir les droits pour excuter le Job dans DQ Batch
Suite.
Password Mot de passe de l'utilisateur.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Le composant tUniservBTGeneric envoie des donnes DQ Batch Suite et lance le Job spcifi.
Quand l'excution du Job est termine, les donnes de sortie sont renvoyes Data Quality
Service Hub Studio pour d'autres oprations.
Limitation Pour utiliser le composant tUniservBTGeneric, le logiciel Uniserv DQ Batch Suite doit tre
install.
le processus DQ Batch Suite ne doit tre compos que d'une seule ligne,
les fichiers dfinis dans les fonctions Input et Output doivent possder
l'enregistrement du format dlimiteur,
les donnes d'entre et de sortie doivent tre fournies selon le jeu de caractres
UTF-8.
Le processus a t totalement dfini dans DQ Batch Suite et sauvegard sous le nom "BTGeneric_Sample". Dans
la fonction Input, le fichier "btinput.csv" a t spcifi comme fichier d'entre sauvegard dans le rpertoire du
Job et tous ses champs ont t renseigns. Le fichier n'est pas encore cr, car il sera fourni par Data Quality
Service Hub Studio. Le processus n'est donc pas encore excutable.
Dans Data Quality Service Hub Studio, la source d'entre (dans cet exemple une table d'une base de donnes
Oracle) de ce scnario est dj enregistre dans le Repository, de manire ce que tous les schmas de
mtadonnes soient disponibles.
1. Dans la vue Repository, dveloppez le nud Metadata et le rpertoire dans lequel vous avez sauvegard la
source. Glissez-la ensuite dans l'espace de modlisation graphique.
Le composant s'affiche dans l'espace de modlisation graphique. La table utilise dans ce scnario s'appelle
LOCATIONS.
3. Glissez les composants suivants de la Palette dans l'espace de modlisation graphique : deux tMap, un
tOracleOutput et un tUniservBTGeneric.
7. Saisissez les informations de connexion. Assurez-vous que le chemin d'accs que vous saisissez dans le
champ Job File Path est absolu.
8. Cliquez sur Retrieve Schema pour crer automatiquement un schma pour le tUniservBTGeneric partir
des dfinitions d'entre et de sortie du processus et de renseigner automatiquement les champs de la vue
Advanced settings.
9. Vrifiez que les informations de la vue Advanced settings soient correctes. Les dfinitions d'entre et de
sortie doivent tre exactement identiques celles du processus DQ Batch Suite. Si ncessaire, adaptez le
chemin d'accs aux fichiers temporaires.
10. Double-cliquez sur le tMap_1 pour ouvrir la fentre de mapping du schma. gauche se trouve la structure
de la source d'entre et droite se trouve le schma du tUniservBTGeneric (et donc l'entre du processus).
En bas se trouve le Schema editor, o vous pouvez trouver et diter les attributs de chaque colonne.
11. Mappez les colonnes de la source d'entre leurs colonnes du tUnivservBTGeneric respectives. Pour ce
faire, slectionnez une colonne de la source d'entre et glissez-la dans la colonne du mme nom du ct droit.
12. Dfinissez comment traiter les rsultats d'excution du processus et quels composants vont tre utiliss.
13. Avant d'excuter le processus, assurez-vous que les chemins d'accs sont corrects, que le serveur de DQ Batch
Suite fonctionne et que vous pouvez accder au processus.
tUniservRTConvertName
Proprits du tUniservRTConvertName
Famille de composant Data Quality
Fonction tUniservRTConvertName analyse un nom complet par rapport au contexte. S'il s'agit de
personnes, il divise le nom en segments (nom, prnom, civilit, prfixes, suffixes etc.) et crer
une cl d'adresse.
Allemagne "cname_d"
Italie "cname_i"
Autriche "cname_a"
Pays-Bas "cname_nl"
Suisse "cname_ch"
Belgique "cname_b"
France "cname_f"
Espagne "cname_e"
Use rejects Cochez cette case pour crire sparment en sortie les ensembles
de donnes sparment d'une certaine classe de rsultats lors de
l'analyse des noms. Saisissez la classe respective des rsultats dans
le champ if result class is greater or equal to.
Si cette case n'est pas coche, les ensembles sont tout de mme
crits en sortie via la connexion Main, mme si l'analyse a chou.
Si cette case est coche mais que la connexion Rejects n'a pas
t tablie, les ensembles sont simplement tris quand l'analyse
choue.
Advanced settings Analysis Configuration Pour plus d'informations, veuillez consulter le manuel utilisateur
d'Uniserv convert-name.
Output Configuration Pour plus d'nformations, veuillez consulter le manuel utilisateur
d'Uniserv convert-name.
Configuration of not Pour plus d'informations, veuillez consulter le manuel utilisateur
recognized input d'Uniserv convert-name.
Configuration of free fields Pour plus d'informations, veuillez consulter le manuel utilisateur
d'Uniserv convert-name.
Cache Configuration Pour plus d'informations, veuillez consulter le manuel utilisateur
d'Uniserv convert-name.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de
sortie. Cette variable est une variable After et retourne un entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Le composant tUniservRTConvertName fournit une base pour une structure et une population
uniformes de noms de personnes et d'entreprises dans la base de donnes, ainsi que des titres
personnaliss.
Limitation Pour utiliser le tUniservRTConvertName, le logiciel Uniserv doit tre install.
Le fichier d'entre de ce scnario est dj sauvegard dans le Repository, toutes les mtadonnes du schma sont
donc disponibles.
Veuillez noter que les donnes d'une source d'entre doivent toutes tre lies au mme pays.
1. Dans la vue Repository, droulez le nud Metadata et le rpertoire dans lequel est sauvegard le fichier.
Glissez ce fichier dans l'espace de modlisation graphique.
Le composant s'affiche dans l'espace de modlisation graphique. Le fichier utilis dans ce scnario est appel
SampleAddresses..
3. Glissez les composants suivants de la Palette l'espace de modlisation graphique : deux composants tMap,
un tUniservRTConvertName, et untFileOutputDelimited.
6. Double-cliquez sur le tMap_1 pour ouvrir la fentre de mapping. gauche se trouve la structure de la source
d'entre et droite se trouve le schma du tUniservRTConvertName (et donc l'entre du Job). En bas se
trouve le Schema editor, o vous pouvez trouver et diter les attributs de chaque colonne.
11. Double-cliquez sur le tMap_3 pour ouvrir la fentre de mapping. gauche se trouve le schma du
tUniservRTConvertName (et donc la sortie du Job) et droite le schma du fichier de sortie.
tUniservRTMailBulk
Proprits du tUniservRTMailBulk
Famille de composant Data Quality
Fonction Le tUniservRTMailBulk cr un pool d'index pour mailRetrieval avec des donnes d'entre
prdfinies.
Objectif Le tUniservRTMailBulk prpare le pool d'index pour la recherche de doublons.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in) soit distant dans le Repository.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Usage Le tUniservRTMailBulk prpare le pool d'index pour une recherche de doublons.
Limitation Pour utiliser le composant tUniservRTMailBulk, le logiciel Uniserv doit tre install.
Vous aurez besoin d'un composant d'entre et d'un composant de mapping pour lire l'adresse
provenant d'une base de donnes ou d'un fichier. Le composant ne possde pas de connexion
de sortie.
La base de donnes de ce scnario est dj sauvegarde dans le Repository, toutes les mtadonnes de schma
sont donc dj disponibles.
1. Dans la vue Repository, dveloppez le nud Metadata et le rpertoire dans lequel est sauvegard le fichier.
Glissez ce fichier dans l'espace de modlisation graphique.
3. Glissez les composants suivants de la Palette dans l'espace de modlisation graphique: tMap et
tUniservRTMailBulk.
6. Double-cliquez sur le tMap_1 pour ouvrir la fentre de mapping. gauche se trouve le schma du fichier
de la base de donnes et droite se trouve le schma du tUniservRTMailBulk (et donc l'entre du Job). En
bas se trouve le Schema editor, o vous pouvez trouver et diter les attributs de chaque colonne.
7. Assignez les colonnes de la source d'entre leurs colonnes du tUniservRTMailBulk respectives. Pour ce
faire, slectionnez une colonne de la source d'entre et glissez-la dans la colonne du mme nom du ct droit.
La signification de chaque argument est dcrite dans le manuel utilisateur Uniserv mailRetrieval.
tUniservRTMailOutput
Proprits du tUniservRTMailOutput
Famille de composant Data Quality
Fonction Le tUniservRTMailOutput met jour le pool d'index utilis pour les recherches de doublons.
Objectif La tUniservRTMailOutput garde le pool d'index synchronis.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
tStatCatcher Statistics Cochez cette case pour collecter les donnes d'identification au
niveau du Job et du composant.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient.
Cette variable est une variable After et retourne une chane de caractres. Cette variable
fonctionne uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Le tUniservRTMailOutput met jour les pool d'index et passe l'ensemble d'entre. La sortie
contient le statut de l'opration. Si l'opration choue, un message d'erreur message s'affiche.
Limitation Pour utiliser le tUniservRTMailOutput, le logiciel Uniserv mailRetrieval doit tre install.
Scnario associ
Pour un scnario associ, consultez Scnario : Ajouter des contacts au pool d'index de mailRetrieval.
tUniservRTMailSearch
Proprits du tUniservRTMailSearch
Famille de composant Data Quality
Fonction Le composant tUniservRTMailSearch recherche des donnes similaires dans l'enregistrement
d'entre donn.
Objectif Le tUniservRTMailSearch cherche les valeurs dupliques et ajoute de nouvelles donnes
chaque enregistrement.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Le tUniservRTMailSearch requiert un composant d'entre et un ou plusieurs composant(s) de
sortie.
Limitation Pour utiliser le composant tUniservRTMailSearch, le logiciel Uniserv mailRetrieval doit tre
install.
Le fichier d'entre de ce scnario est sauvegard dans le Repository, ce qui rend disponible le schma des
mtadonnes.
3. Glissez les composants suivants de la Palette dans l'espace de modlisation graphique : deux composants
tMap, un tUniservRTMailSearch et un tUniservRTMailOutput.
1. Double-cliquez sur le composant tMap_1 pour ouvrir la fentre de mapping de son schma. Sur la gauche se
trouve la structure du fichier d'entre et sur la droite le schma du tUniservRTMailSearch. En bas se trouve
le Schema Editor, o vous pouvez trouver et diter les attributs de chaque colonne.
2. Mappez les colonnes du fichier d'entre leurs colonnes respectives dans le tUniservRTMailSearch. Pour
ce faire, slectionnez une colonne de la source d'entre et glissez-la sur la colonne approprie du ct droit.
3. Quand une liste d'entre contient un ID de rfrence, il est conseill de l'accepter. Pour ce faire, crez une
nouvelle colonne appele IN_DBREF depuis le Schema Editor et connectez-la votre ID de rfrence.
5. Dans la case Maximum of displayed "duplicates", saisissez 0 pour afficher tous les doublons.
6. Cliquez sur le bouton [+] pour insrer une ligne dans la fentre. Slectionnez Duplicate count dans la colonne
Elements, > dans la colonne Operator et 0 dans la colonne Value. De cette faon, tous les contacts existants
sont carts et seuls les nouveaux contacts sont ajouts au pool d'index.
7. Cliquez sur l'onglet Advanced settings et vrifiez les paramtres. Des paramtres par dfaut ont t dfinis.
Rfrez-vous au manuel de mailRetrieval pour plus de prcisions.
8. Double-cliquez sur le second composant tMap pour ouvrir la fentre de mapping de son schma. Sur la
gauche se trouve le schma du tUniservRTMailSearch et sur la droite celui du tUniservRTMailOutput.
10. Le seul champ devant tre mapp manuellement est l'ID de rfrence. Pour ce faire, glissez OUT-DBREF
vers le champ IN_DBREF du ct droit.
11. Double-cliquez sur le composant tUniservRTMailOutput pour afficher sa vue Basic settings.
12. Dans la liste Action on Data, slectionnez Insert or update pour que tous les nouveaux contacts soient ajouts
au pool d'index.
tUniservRTPost
Proprits du tUniservRTPost
Famille de composant Data Quality
Fonction Le composant tUniservRTPost fournit un service de validation postale et de correction
d'adresses, critique pour amliorer la qualit des adresses. Grce ce composant, vous serez
plus efficace dans le marketing individualis, rduisant les cots et augmentant l'efficacit de la
gestion des adresses dans toutes les applications.
Objectif Le composant tUniservRTPost est conu pour amliorer la qualit des adresses, ce qui est
extrmement important pour la GRC et le e-commerce : cela est directement li aux cots du
courrier et de la publicit.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Si cette case n'est pas coche, les adresses incorrectes sont crites
en sortie via la connexion Main.
Si cette case est coche mais que la connexion rejects n'est pas
cre, les adresses incorrectes sont simplement rejetes.
Use File for ambiguous Cochez cette case pour dfinir un fichier qui servira crire la
results liste des rsultats ambigus.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Le composant tUniservRTPost requiert une liste d'adresses en entre. Les donnes concernant
les adresses sont ensuite vrifies. Si la liste ne contient que des rsultats non ambigus, elle est
crite en sortie via la connexion Main. Si l'adresse est ambige, les candidats potentiels sont
crits en sortie via la connexion Ambiguity. Si une adresse n'a pas pu tre trouve, elle sera
transfre via la connexion Reject.
Limitation Pour utiliser le composant tUniservRTPost, le logiciel Uniserv International Postal Framework
et les serveurs ddis doivent tre installs.
Le fichier d'entre de ce scnario est dj sauvegard dans le Repository, les schmas de mtadonnes sont donc
disponibles.
1. Dans la vue Repository, dveloppez le nud Metadata et le rpertoire dans lequel le fichier est sauvegard.
Glissez ce fichier dans l'espace de modlisation graphique.
Le composant s'affiche dans l'espace de modlisation graphique. Le fichier utilis dans ce scnario se nomme
SampleAddresses. Il contient des adresses comprenant un code pays. La rue et le numro sont sauvegards
ensemble dans le champ Street et le code postal et la ville sont sauvegards dans des champs spars.
3. Glissez les composants suivants de la Palette dans l'espace de modlisation graphique : deux composants
tMap, un composant tUniservRTPost et un tFileOutputDelimited.
Acceptez le schma du tUniservRTPost en cliquant sur Yes dans la fentre proposant la propagation.
6. Double-cliquez sur le tMap_1 pour ouvrir la fentre de mapping du schma. Sur la gauche se trouve la
structure du fichier d'entre et sur la droite le schma du tUniservRTPost. En bas se trouve le Schema
Editor, o vous pouvez trouver et diter les attributs de chaque colonne.
7. Mappez les colonnes du fichier d'entre leurs colonnes respectives dans le tUniservRTPost. Pour ce faire,
slectionnez une colonne de la source et glissez-la sur la colonne approprie du ct droit. Si des champs
du fichier d'entre doivent tre passs au fichier de sortie, comme les noms ou les IDs, de nouveaux champs
doivent tre dfinis.
Au moment de mapper les champs, notez que la rue et le numro peuvent tre enregistrs soit ensemble dans la colonne
Street, soit dans des champs spars. Si votre liste d'adresses ne comporte pas de code pays mais que les adresses
proviennent d'un mme pays, vous devrez saisir manuellement le code ISO du pays correspondant entre guillemets
doubles dans la colonne IN_COUNTRY. Dans le cas d'une liste d'adresses internationales sans code pays, laissez la
colonne IN_COUNTRY vide. Pour plus d'informations, veuillez vous rfrer au guide utilisateur Uniserv International
Postal Framework.
10. Changez les paramtres et les longueurs de champs si ncessaire et slectionnez les champs de sortie.
Assurez-vous d'avoir dfini une longueur suffisante de champ. Pour plus de prcisions, veuillez vous rfrer au Guide
utilisateur Uniserv International Postal Framework.
11. Double-cliquez sur le second composant tMap pour ouvrir la fentre de mapping du schma. Sur la gauche
se trouve le schma du tUniservRTPost et sur la droite le schma du fichier de sortie.
13. Double-cliquez sur le composant tFileOutputDelimited pour saisir les dtails du fichier de sortie.
2. Glissez les composants suivants de la Palette dans l'espace de modlisation graphique : un tMap et un
tFileOutputDelimited.
4. Cochez la case Use rejects et saisissez "5" dans le champ if result class greater or equals to. Il s'agit de
la classe de rsultat de la vrification des codes postaux dans les adresses contenant des donnes incorrectes
ou insuffisantes.
5. Connectez le composant tUniservRTPost au tMap_5 l'aide d'un lien Row > Rejects.
D'autres types de connecteurs de bases de donnes, tels que les connecteurs d'appliance, de datawarehouse et de
gestion de bases de donnes, sont documents dans le Databases - Composants d'appliance et de datawarehouse
et le Databases - Autres composants.
tAccessBulkExec
Proprits du tAccessBulkExec
Les composants tAccessOutputBulk et tAccessBulkExec sont gnralement utiliss ensemble pour crire des
donnes dans un fichier dlimit puis effectuer diffrentes actions sur le fichier dans une base de donnes Access,
processus en deux tapes. Ces deux tapes sont regroupes dans le composant tAccessOutputBulkExec, dtaill
dans une section spare. L'intrt d'utiliser un processus en deux tapes rside dans le fait que cela permet de
procder des transformations avant le chargement des donnes dans la base de donnes.
Famille de Databases/
composant Access
Fonction Le composant tAccessBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tAccessBulkExec est un composant ddi qui permet un gain de performance pendant les oprations d'Insert
dans une base de donnes Access
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement
le Guide utilisateur de Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur de Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec le composant tAccessOutputBulk. Ensemble, ils offrent un gain
de performance important pour l'alimentation d'une base de donns Access.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Si vous utilisez la version 64 bits du Studio, vous devez utiliser la version 32 bits du pilote ODBC et de
l'environnement Java.
Scnarios associs
Pour plus d'informations relatives au fonctionnement du composant tAccess BulkExec, consultez les scnarios
suivants :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
Scnario : Insrer des donnes dans une base MySQL du composant tMysqlOutputBulkExec.
tAccessClose
Proprits du tAccessClose
Famille de composant Databases/Access
Fonction Le composant tAccessClose ferme une connexion active une base de donnes.
Objectif Le tAccessClose est utilis pour arrter une connexion Access afin de librer des ressources
occupes.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tAccessConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job
ainsi qu'au niveau des composants.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants Access, notamment avec le
tAccessConnection et le tAccessCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Si vous utilisez la version 64 bits du Studio, vous devez utiliser la version 32 bits du pilote ODBC
et de l'environnement Java.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tAccessCommit
Proprits du tAccessCommit
Famille de composant Databases/Access
Fonction Le composant tAccessCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tAccessConnection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants Access et notamment avec les
composants tAccesConnection et tAccessRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Si vous utilisez la version 64 bits du Studio, vous devez utiliser la version 32 bits du pilote ODBC
et de l'environnement Java.
Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tAccessCommit, consultez Scnario 1 :
Insrer des donnes dans des tables mre/fille
tAccessConnection
Proprits du tAccessConnection
Famille de composant Databases/Access
Fonction Le composant tAccessConnection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Si vous utilisez la version 64 bits du Studio, vous devez utiliser la version 32 bits du pilote ODBC
et de l'environnement Java.
Crez une base de donnes connecte Access 2007 que vous appellerez Database1.
Une fois la base de donnes Access cre, crez une table appele Table1 avec les deux en-ttes de colonne
suivants : Name et Birthday.
Dans la perspective Integration de votre Studio Talend, le Job est constitu de douze composants, parmi lesquels
des composants tAccessConnection, tAccessCommit, tAccessInput, tAccessOutput et tAccessClose.
A partir de la Palette, cliquez et dposez les composants suivants dans l'espace de modlisation graphique : un
tFileList, un tFileInputDelimited, un tMap, deux tAccessOutput, deux tAccessInput, un tAccessCommit,
un tAccessClose et deux tLogRow.
Connectez le composant tFileList au composant d'entre tFileInputDelimited l'aide d'une connexion de type
Iterate. Ainsi, le nom du fichier traiter sera automatiquement renseign partir de la liste de fichiers du
tFileList en utilisant une variable globale.
Connectez le composant tFileInputDelimited au tMap et sparez le flux vers les deux composants de sortie
tAccessOutput. Utilisez des connexions de type Row pour chacune de ces connexions reprsentant un flux de
donnes principal.
Dfinissez les proprits du composant tFileList, notamment le rpertoire dans lequel sont stocks les fichiers.
Ajoutez le composant tAccessConnection et connectez-le au composant de dpart de ce Job (dans cet exemple,
le composant tFileList), l'aide d'une connexion OnComponentOk afin de dfinir l'ordre d'excution.
Dans l'onglet Basic settings du composant tFileInputDelimited, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. Dfinissez le champ File Name avec la variable globale :
tFileList_1.CURRENT_FILEPATH. Pour plus d'informations concernant l'utilisation des variables, consultez le
Guide utilisateur du Studio Talend.
Paramtrez les autres champs comme vous le souhaitez, dfinissez les sparateurs de lignes et de champs (Row
et Field Separator) en fonction de la structure de votre document.
Puis dfinissez manuellement le schma du fichier l'aide du bouton Edit schema ou slectionnez le schma
dans le Repository. Assurez-vous que le type de donnes est correctement dfini, conformment la nature
des donnes traites.
Dans la zone Output du tMap, ajoutez deux tables de sortie, une que vous nommerez Name pour la table Name,
et une deuxime que vous nommerez Birthday, pour la table Birthday. Pour plus d'informations concernant le
composant tMap, consultez le Guide utilisateur du Studio Talend.
Cliquez sur la colonne Name de la zone Input, et glissez-la dans la table Name.
Cliquez sur la colonne Birthday de la zone Input, et glissez-la dans la table Birthday.
Puis slectionnez une connexion de sortie de type Row pour acheminer correctement le flux vers les composants
Database de sortie correspondants.
Dans l'onglet Basic settings des deux composants tAccessOutput, cochez la case Use an existing connection
pour rcuprer les informations du composant tAccessConnection.
Ignorez le champ Commit every puisque cette commande sera annule par le composant tAccessCommit.
Nommez votre table dans le champ Table en vous assurant que vous saisissez la bonne table. Dans cet exemple,
la table est soit Name, soit Birthday.
Ne dfinissez aucune action dans le champ Action on table puisque les tables ont dj t cres.
Slectionnez Insert dans le champ Action on data pour les deux composants de sortie (tAccessOutput).
Cliquez sur le bouton Sync columns pour rcuprer le schma dfini dans le tMap.
Connectez ensuite le premier composant tAccessOutput au premier composant tAccessInput l'aide d'une
connexion OnComponentOk.
Dans l'onglet Basic settings des deux composants tAccessInput, cochez la case Use an existing connection
pour rcuprer le flux de donnes distribu. Puis dfinissez manuellement le schma du fichier l'aide du bouton
Edit schema.
Nommez ensuite votre table dans le champ Table Name. Le nom du tAccessInput_1 sera Name.
Connectez les deux composants tAccessInput au composant tLogRow l'aide d'une connexion de type Row >
Main. Dans l'onglet Basic settings des deux composants tLogRow, slectionnez Table dans le champ Mode.
Ajoutez le composant tAccessConnection sous le composant tFileList et connectez-les l'aide d'une connexion
OnComponentOk afin d'arrter le Job avec les commits de transaction.
A partir de l'onglet Basic settings du composant tAccessCommit, slectionnez dans la liste droulante
Component list la connexion utiliser, tAccessConnection_1 dans ce scnario.
La table parent Table1 est utilise la fois pour gnrer la table Name et la table Birthday.
tAccessInput
Proprits du tAccessInput
Famille de Databases/Access
composant
Fonction Le composant tAccessInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tAccessInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini
dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de
flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez la section expliquant comment configurer une connexion une base de
donnes dans le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Query type et Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des champs
Query corresponde celui dfini dans le schma.
Advanced Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base
settings parameters de donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Trim all the String/ Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les
Char columns colonnes contenant des chanes de caractres.
Trim column Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Si vous utilisez la version 64 bits du Studio, vous devez utiliser la version 32 bits du pilote ODBC et de
l'environnement Java.
Scnarios associs
Pour un scnario associ, consultez les scnarios tDBInput dans :
Pour plus d'informations sur les contextes dynamiques dans le cadre d'une utilisation de base de donnes, consultez
tContextLoad.
tAccessOutput
Proprits du tAccessOutput
Famille de Databases/Access
composant
Fonction Le composant tAccessOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tAccessOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux entrant
provenant du composant prcdent.
Basic Property type Peut tre Built-in ou Repository
settings
Depuis la version 5.6, les modes Built-in et Repository sont
disponibles dans n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les
proprits du composant. Les champs suivants sont alors pr-remplis
l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de
connexion la base de donnes et enregistrer les paramtres de
connexion que vous avez dfinis dans la vue Basic settings du
composant.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes
de la table slectionne :
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide utilisateur
du Studio Talend.
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est une
variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on error est
dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution d'un
composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour accder
la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes
SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes Access. Il permet
aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple d'utilisation,
consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Si vous utilisez la version 64 bits du Studio, vous devez utiliser la version 32 bits du pilote ODBC et de l'environnement
Java.
Scnarios associs
Pour un scnario associ, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
tDBOutput.
tAccessOutputBulk
Proprits du tAccessOutputBulk
Les composants tAccessOutputBulk et tAccessBulkExec sont gnralement utiliss ensemble pour crire des
donnes dans un fichier dlimit puis effectuer diffrentes actions sur le fichier dans une base de donnes Access,
processus en deux tapes. Ces deux tapes sont regroupes dans le composant tAccessOutputBulkExec, dtaill
dans une section spare. L'intrt d'utiliser un processus en deux tapes rside dans le fait que cela permet de
procder des transformations avant le chargement des donnes dans la base de donnes.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis avec le composant tAccessBulkExec. Ensemble, ils
offrent un gain de performance important pour l'alimentation d'une base de donnes Access.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Limitation Si vous utilisez la version 64 bits du Studio, vous devez utiliser la version 32 bits du pilote
ODBC et de l'environnement Java.
Scnarios associs
Pour un scnario associ au tAccessOutputBulk, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
tAccessOutputBulkExec
Proprits du tAccessOutputBulkExec
Les composants tAccessOutputBulk et tAccessBulkExec sont gnralement utiliss ensemble afin d'crire des
donnes dans un fichier dlimit, puis d'effectuer diffrentes actions sur le fichier dans une base de donnes Access,
processus en deux tapes. Ces deux tapes sont regroupes dans le tAccessOutputBulkExec.
Famille de Databases/Access
composant
Fonction Le tAccessOutputBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tAccessOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations
d'Insert dans une base de donnes Access.
Basic settings Property Type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois et la table doit dj
exister pour que l'opration d'insert soit autorise.
File Name Nom du fichier traiter.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Vous pouvez appuyer sur Ctrl+Espace afin d'accder une liste de variables
globales prdfinies.
Include header Cochez cette case pour inclure l'en-tte des colonnes dans le fichier.
Encoding Slectionnez l'encodage partir de la liste ou slectionnez Custom et dfinissez-le
manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de
donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy
et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide utilisateur
du Studio Talend.
Utilisation Ce composant est principalement utilis lorsqu'aucune transformation particulire n'est requise sur les donnes
charger dans la base de donnes.
Limitation Si vous utilisez la version 64 bits du Studio, vous devez utiliser la version 32 bits du pilote ODBC et de
l'environnement Java.
Scnarios associs
Pour un scnario associ au tAccessOutputBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
tAccessRollback
Proprits du tAccessRollback
Famille de composant Databases/Access
Fonction Le tAccessRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant de connexion tAccessConnection dans
la liste si vous prvoyez d'ajouter plus d'une connexion votre Job
en cours.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant est gnralement utilis en association avec des composants Access, notamment
avec le tAccessConnection et le tAccessCommit.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Si vous utilisez la version 64 bits du Studio, vous devez utiliser la version 32 bits du pilote ODBC
et de l'environnement Java.
Scnario associ
Pour un scnario associ au tAccessRollback, consultez Scnario : Annuler l'insertion de donnes dans des tables
mre/fille du composant tMysqlRollback.
tAccessRow
Proprits du tAccessRow
Famille de Databases/Access
composant
Fonction tAccessRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares
sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job
bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tAccessRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced settings Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
QUERY's Slectionnez cette colonne dans la liste use column.
recordset
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatement de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des
paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query de
l'onglet Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une
meilleure performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de
requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Si vous utilisez la version 64 bits du Studio, vous devez utiliser la version 32 bits du pilote ODBC et de
l'environnement Java.
Scnarios associs
Pour un scnario associ, consultez :
tAS400Close
Proprits du tAS400Close
Famille de composant Databases/AS/400
Fonction Le composant tAS400Close ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes AS/400.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tAS400Connection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tAS400Connection et tAS400Rollback. Il est gnralement
utilis avec un composant tAS400Connection car il permet de fermer une connexion pour la transaction en cours.
tAS400Commit
Proprits du tAS400Commit
Famille de composant Databases/AS/400
Fonction Le composant tAS400Commit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tAS400Connection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants AS/400 et notamment avec les
composants tAS400Connection et tAS400Rollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tAS400Commit, consultez Scnario 1 : Insrer des donnes dans des
tables mre/fille.
tAS400Connection
Proprits du tAS400Connection
Famille de composant Databases/AS/400
Fonction Le composant tAS400Connection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tAS400Connection, consultez
tMysqlConnection.
tAS400Input
Proprits du tAS400Input
Famille de Databases/AS/400
composant
Fonction Le composant tAS400Input lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tAS400SInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui
dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une
connexion de flux (Main row).
Basic settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de
base de donnes, consultez le Guide utilisateur du Studio Talend.
DB Version Slectionnez la version d'AS/400 que vous utilisez.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur.
Database Nom de la base de donnes.
Username et Informations d'authentification de l'utilisateur de base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis,
dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles,
puis cliquez sur OK afin de sauvegarder les paramtres.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
Schema et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInput dans :
Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.
tAS400LastInsertId
Proprits du tAS400LastInsertId
Famille de composant Databases/AS/400
Fonction Le tAS400LastInsertId affiche les derniers ID ajouts une table partir d'une connexion AS/400
spcifie.
Objectif Le composant tAS400LastInsertId permet de rcuprer les cls primaires des entres
dernirement ajoutes par un utilisateur une table AS/400.
Basic settings Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant intermdiaire.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Scnario : Rcuprer les ID des dernires entres ajoutes du composant
tMysqlLastInsertId.
tAS400Output
Proprits du tAS400Output
Famille de Databases/AS/400
composant
Fonction Le composant tAS400Output crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tAS400Output excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de
base de donnes, consultez le Guide utilisateur du Studio Talend.
DB Version Slectionnez la version d'AS/400 que vous utilisez.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette
parameters option est disponible lorsque la case Use an existing connection est dcoche dans les Basic
settings.
Vous pouvez appuyer sur Ctrl+Espace afin d'accder une liste de variables
globales prdfinies.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous
Columns l'ayez pralablement supprime ou non). Cette option vous permet d'effectuer des actions
sur les colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui
ncessitent un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les
donnes dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur la
colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant tAS400Output
peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur
les donnes.
Enable debug Cochez cette case pour afficher chaque tape du processus d'criture dans la base de donnes.
mode
Use batch size Cochez cette case pour activer le mode Batch (par lots) pour le traitement des donnes. Dans
le champ Batch Size, saisissez le nombre de lignes traiter dans chaque lot.
Cette case est disponible uniquement lorsque vous avez slectionn l'option
Insert, Update ou Delete dans le champ Action on data.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
AS/400. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour
un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject du
composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour des scnarios associs, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput
tAS400Rollback
Proprits du tAS400Rollback
Famille de composant Databases/AS/400
Fonction Le tAS400Rollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant de connexion tAS400Connection dans
la liste si vous prvoyez d'ajouter plus d'une connexion votre Job
en cours.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en association avec des composants AS/400, notamment
avec le tAS400Connection et le tAS400Commit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au tAS400Rollback, consultez Scnario : Annuler l'insertion de donnes dans des tables
mre/fille du composant tMySQLRollback.
tAS400Row
Proprits du tAS400Row
Famille de Databases/
composant AS/400
Fonction Le tAS400Row est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares
sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien
que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tAS400Row agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
DB Version Slectionnez la version d'AS/400 que vous utilisez.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur.
Database Nom de la base de donnes.
Username et Informations d'authentification de l'utilisateur de base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans la
bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis cliquez
sur OK afin de sauvegarder les paramtres.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
Schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement le Guide
utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Table Name Nom de la table traiter.
Query type La requte peut tre Built-in ou distante dans le Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Additional Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette
settings JDBC option est disponible lorsque la case Use an existing connection est dcoche dans les Basic
Parameters settings.
Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
QUERY's Slectionnez cette colonne dans la liste use column.
recordset
Cette option permet au composant d'avoir un schma diffrent de celui du composant
prcdent. De plus, la colonne contenant le rsultat de la requte doit tre de type
Object. Ce composant est gnralement suivi du tParseRecordSet.
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatement
de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des
paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query de
l'onglet Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte.
Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log lors du traitement du Job, aussi bien au
Statistics niveau du Job qu'au niveau de chaque composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour un scnario associ, consultez :
tDB2BulkExec
Proprits du tDB2BulkExec
Famille de Databases/DB2
composant
Fonction Le composant tDB2BulkExec excute des oprations d'Insert sur les donnes fournies.
Objectif Le tDB2BulkExec est un composant ddi qui permet un gain de performance pendant les oprations d'Insert
dans une base de donnes DB2.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du
composant. Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer
une nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Le fichier est situ sur la machine spcifie par l'URI dans le champ Host et
doit tre sur la mme machine que le serveur de la base de donnes.
Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne :
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des
doublons.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un
entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un
entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes DB2.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au composant tDB2BulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulkExec.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tDB2Close
Proprits du tDB2Close
Famille de composant Databases/DB2
Fonction Le composant tDB2Close ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes DB2.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tDB2Connection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tDB2Connection et tDB2Rollback. Il est gnralement utilis
avec un composant tDB2Connection car il permet de fermer une connexion pour la transaction en cours.
tDB2Commit
Proprits du tDB2Commit
Famille de composant Databases/DB2
Fonction Le composant tDB2Commit valide les donnes traites dans un Job partir d'une base de donnes
connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tDB2Connection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants DB2, notamment le tDB2Connection
et le tDB2Rollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tDB2Commit, consultez Scnario 1 : Insrer des donnes dans des tables
mre/fille.
tDB2Connection
Proprits du tDB2Connection
Famille de composant Databases/DB2
Fonction Le composant tDB2Connection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository.
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation
de ces fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend,
dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tDB2Connection, consultez Scnario 1 : Insrer des donnes dans des
tables mre/fille.
tDB2Input
Proprits du tDB2Input
Famille de Databases/
composant DB2
Fonction Le composant tDB2Input lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tDB2Input excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini
dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion
de flux (Main row).
Si des guillemets doubles existent dans le nom des colonnes d'une table, les guillemets doubles ne
peuvent tre rcuprs avec les colonnes. Il est donc recommand de ne pas utiliser de guillemet
double dans le nom des colonnes dans les tables de la base de donnes DB2.
Basic settings Property Peut tre Built-in ou Repository
type
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de donnes
et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du
composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base de
donnes, consultez le Guide utilisateur du Studio Talend.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Table Name Nom de la table source dans laquelle capturer les changements apports aux donnes.
Query type Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des champs
et Query corresponde celui dfini dans le schma.
Advanced settings Additional Spcifiez des proprits de connexion supplmentaires pour la connexion la base de donnes
JDBC que vous crez.
parameters
Vous pouvez configurer les paramtres d'encodage dans ce champ.
Trim all Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes
the String/ contenant des chanes de caractres.
Char
columns
Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die
on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes DB2.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInput dans :
Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.
tDB2Output
Proprits du tDB2Output
Famille de Databases/DB2
composant
Fonction Le composant tDB2Output crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tDB2Output excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux entrant
provenant du composant prcdent.
Basic settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur.
Database Nom de la base de donnes.
Username et Informations d'authentification de l'utilisateur de base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans la
bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis cliquez
sur OK afin de sauvegarder les paramtres.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois.
Action on table La liste Action on table n'est pas disponible si vous cochez la case Enable parallel
execution dans la vue Advanced settings.
Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table slectionne :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Truncate table with reuse storage : supprimer le contenu de la table. Il n'y a pas de possibilit
de rollback. Cependant, vous pouvez rutiliser le stockage allou la table, mme si le stockage
est considr comme vide.
Si vous cochez la case Use an existing connection et que vous slectionnez Truncate
table ou Truncate table with reuse storage dans la liste Action on table, une
instruction de commit est invoque avant l'opration TRUNCATE, car l'instruction
TRUNCATE doit tre la premire instruction dans une transaction.
Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne :
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de transaction (cependant pas de rollback) et surtout une meilleure
performance des excutions.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous l'ayez
Columns pralablement supprime ou non). Cette option vous permet d'effectuer des actions sur les
colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui ncessitent
un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes
dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur la
colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant tDB2Output peut
utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur les
donnes.
Convert Cochez cette case pour mettre le nom des colonnes et celui de la table en majuscules.
columns and
table names to
uppercase
Enable debug Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de donnes.
mode
Support null in Cochez cette case pour prendre en compte les valeurs Null d'une table de base de donnes.
"SQL WHERE"
statement Assurez-vous que la case Nullable est bien coche pour les colonnes du schma
correspondantes.
Use Batch size Cochez cette case afin d'activer le mode batch pour le traitement des donnes. Dans le champ
Batch Size qui apparat, vous pouvez saisir le nombre de lignes par lot charger.
Cette case est disponible uniquement si vous avez choisi l'option Insert, Update,
Single Insert Query ou Delete dans le champ Action on data.
tStat Catcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
DB2. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour
un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject du
composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tDB2Output, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
tDBOutput.
tDB2Rollback
Proprits du tDB2Rollback
Famille de composant Databases/DB2
Fonction Le tDB2Rollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant de connexion tDB2Connection dans la
liste si vous prvoyez d'ajouter plus d'une connexion votre Job en
cours.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en association avec des composants DB2, notamment avec
le tDB2Connection et le tDB2Commit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au tDB2Rollback, consultez Scnario : Annuler l'insertion de donnes dans des tables
mre/fille du composant tMySQLRollback.
tDB2Row
Proprits du tDB2Row
Famille de composant Databases/
DB2
Fonction tDB2Row est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares
sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le
Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tDB2Row agit sur la structure mme de la base
de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement
et aisment crire vos requtes.
Basic settings Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur.
Database Nom de la base de donnes.
Username et Informations d'authentification de l'utilisateur de base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis,
dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles,
puis cliquez sur OK afin de sauvegarder les paramtres.
Schema et Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
Edit Schema et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous
pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row
> Rejects.
Advanced settings Additional Spcifiez des proprits de connexion supplmentaires pour la connexion la base de
JDBC donnes que vous crez.
parameters
Vous pouvez configurer les paramtres d'encodage dans ce champ.
Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
QUERY's Slectionnez cette colonne dans la liste use column.
recordset
Cette option permet au composant d'avoir un schma diffrent de celui du
composant prcdent. De plus, la colonne contenant le rsultat de la requte doit
tre de type Object. Ce composant est gnralement suivi du tParseRecordSet.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une
meilleure performance d'excution.
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatement
de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs
des paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query
de l'onglet Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues
dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes
ayant la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits
de requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tDB2Row, consultez :
tDB2SCD
Le composant tDB2SCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus
d'informations, consultez tDB2SCD.
tDB2SCDELT
Le composant tDB2SCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tDB2SCDELT.
tDB2SP
Proprits du tDB2SP
Famille de Databases/DB2
composant
Fonction Le composant tDB2SP appelle une procdure stocke de base de donnes.
Objectif Le tDB2SP permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les
appeler plus facilement.
Basic settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier des proprits du composant. Les champs suivants sont
alors pr-remplis.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Username et Informations d'authentification sur l'utilisateur de base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans
la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis
cliquez sur OK afin de sauvegarder les paramtres.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
Schema et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est
rutilisable. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
IN OUT : les paramtres d'entre doivent tre retournes sous forme de valeur, mme aprs
modifications via la procdure (fonction).
RECORDSET : les paramtres d'entre doivent tre retournes sous forme d'ensemble de
valeurs, au lieu d'une valeur unique.
Consultez Scnario 1 : Insrer des donnes dans des tables mre/fille si vous
voulez analyser un ensemble d'enregistrements d'une table de donnes ou d'une
requte SQL.
Advanced settings Additional Spcifiez des proprits de connexion supplmentaires pour la connexion la base de
JDBC donnes que vous crez.
parameters
Vous pouvez configurer les paramtres d'encodage dans ce champ.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas,
seuls les paramtres d'entre sont autoriss.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez
Consultez galement Scnario 1 : Insrer des donnes dans des tables mre/fille si vous voulez analyser un
ensemble d'enregistrements d'une table de donnes ou d'une requte SQL.
tInformixBulkExec
Proprits du tInformixBulkExec
Les composants tInformixOutputBulk et tInformixBulkExec sont gnralement utiliss ensemble pour d'une
part gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tInformixOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le changement des donnes dans la base de donnes.
Famille de Databases/Informix
composant
Fonction Le composant tInformixBulkExec excute des oprations d'Insert sur les donnes fournies.
Objectif Le tInformixBulkExec est un composant ddi qui permet un gain de performance pendant les oprations
d'Insert dans une base de donnes Informix.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du
composant. Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Execution Platform Slectionnez le type de systme d'exploitation que vous utilisez.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis,
dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles,
puis cliquez sur OK afin de sauvegarder les paramtres.
Instance Nom de l'instance Informix utiliser. Cette information se trouve gnralement dans
le fichier SQL hosts.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer
une nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut
tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers
(integer) ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont
pas entoures de guillemets. Si c'est le cas, vous devez supprimer manuellement les
guillemets.
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des
doublons.
Advanced Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes cre.
settings parameters Cette option est disponible lorsque la case Use an existing connection est dcoche
dans les Basic settings.
Field terminated by Caractre, chane ou expression rgulire sparant les champs.
Set DBMONEY Quand vous cochez cette case, vous pouvez dfinir votre sparateur dcimal dans le
champ Decimal separator.
Set DBDATE Slectionnez le format de date que vous souhaitez appliquer.
Rows Before Commit Saisissez le nombre de lignes traiter avant commit.
Bad Rows Before Abort Saisissez le nombre de lignes d'erreur avant arrt du Job.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Output Slectionnez l'emplacement de la sortie.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un
entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes DB2.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Le serveur/client de la base de donnes doit tre install sur la mme machine que le Studio Talend ou que le
Job contenant un tInformixBulkExec, afin que le Job fonctionne correctement.
Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au composant tInformixBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulkExec.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tInformixClose
Proprits du tInformixClose
Famille de composant Databases/Informix
Fonction Le composant tInformixClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes Informix.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tInformixConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tInformixConnection et tInformixRollback. Ils sont
gnralement utiliss avec un composant tInformixConnection car il permet d'ouvrir une connexion pour la
transaction en cours.
tInformixCommit
Proprits du tInformixCommit
Ce composant est troitement li aux composants tInformixConnection et tInformixRollback. Ils sont
gnralement utiliss ensemble lors de transactions.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tInformixConnection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants Informix et notamment
tInformixConnection et tInformixRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tInformixConnection et tInformixRollback. Ils sont
gnralement utiliss avec un composant tInformixConnection car il permet d'ouvrir une connexion pour la
transaction en cours.
Pour un scnario associ au composant tInformixCommit, consultez Scnario 1 : Insrer des donnes dans des
tables mre/fille.
tInformixConnection
Proprits du tInformixConnection
Ce composant est troitement li aux composants tInformixCommit et tInformixRollback. Ils sont gnralement
utiliss avec un composant tInformixConnection car il permet d'ouvrir une connexion pour la transaction en
cours.
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation
de ces fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend,
dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tInformixConnection, consultez Scnario 1 : Insrer des donnes dans
des tables mre/fille.
tInformixInput
Proprits du tInformixInput
Famille de composant Databases/Informix
Fonction Le composant tInformixInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tInformixInput excute une requte en base de donnes selon un ordre strict qui doit
correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au
composant suivant via une connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Informix.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation
de ces fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend,
dans le Guide d'installation et de migration Talend.
Scnarios associs
Consultez les scnarios associs aux composants tDBInput dans :
Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.
tInformixOutput
Proprits du tInformixOutput
Famille de Databases/
composant Informix
Fonction Le composant tInformixOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tInformixOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de
base de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne :
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures
de guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced settings Additional Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette
JDBC option est disponible lorsque la case Use an existing connection est dcoche dans les
parameters Basic settings.
Vous pouvez appuyer sur Ctrl+Espace afin d'accder une liste de variables
globales prdfinies.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une
meilleure performance d'excution.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous
Columns l'ayez pralablement supprime ou non). Cette option vous permet d'effectuer des actions
sur les colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui
ncessitent un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les
donnes dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur
la colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant
tInformixOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle
modifier.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur
les donnes.
Enable debug Cochez cette case pour afficher chaque tape du processus d'criture dans la base de
mode donnes.
Use Batch Size Nombre de lignes dans chaque lot de traitement de donnes.
Optimize the Cocher cette case optimise l'insertion de donnes par lots.
batch insertion
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue Basic
settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne
un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un
entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un
entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un
entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
Informix. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur.
Pour un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject
du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tInformixOutput, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tInformixOutputBulk
Proprits du tInformixOutputBulk
Les composants tInformixOutputBulk et tInformixBulkExec sont gnralement utiliss ensemble pour d'une
part gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tInformixOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le chargement des donnes dans la base de donnes.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte,
consultez le Guide utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un
entier.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis avec le composant tInformixBulkExec. Ensemble, ils
offrent un gain de performance important pour l'alimentation d'une base de donnes Informix.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer
le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au tInformixOutputBulk, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
tInformixOutputBulkExec
Proprits du tInformixOutputBulkExec
Les composants tInformixOutputBulk et tInformixBulkExec sont gnralement utiliss ensemble comme deux
parties d'un processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime
tape, ce fichier est utilis lors de l'opration d'INSERT afin de peupler une base de donnes. Cette excution en
deux tapes est unifie dans le composant tInformixOutputBulkExec.
Famille de Databases/
composant Informix
Fonction Le tInformixOutputBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tInformixOutputBulkExec est un composant ddi qui permet un gain de performance pendant les
oprations d'Insert dans une base de donnes Informix.
Basic settings Property Type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Execution Slectionnez le type de systme d'exploitation que vous utilisez.
platform
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures
de guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Bulk insert ou Bulk update. Les informations demandes seront diffrentes en fonction
de l'action choisie.
Advanced settings Additional Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette
JDBC option est disponible lorsque la case Use an existing connection est dcoche dans les Basic
parameters settings.
Vous pouvez appuyer sur Ctrl+Espace afin d'accder une liste de variables
globales prdfinies.
Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
Fields Caractre, chane ou expression rgulire sparant les champs.
terminated by
Set DBMONEY Quand vous cochez cette case, vous pouvez dfinir votre sparateur dcimal dans le champ
Decimal separator.
Set DBDATE Slectionnez le format de date que vous souhaitez appliquer.
Rows Before Saisissez le nombre de lignes traiter avant commit.
Commit
Bad Rows Saisissez le nombre de lignes d'erreur avant arrt du Job.
Before Abort
Create Cette case est coche par dfaut. Cette option permet de crer le dossier contenant le fichier
directory if not de sortie s'il n'existe pas dj.
exists
Custom the Cochez cette case pour personnaliser la taille de la mmoire utilise pour stocker
flush buffer size temporairement les donnes, et dans le champ Row number, saisissez le nombre de lignes
aprs lesquelles la mmoire est nouveau libre.
Encoding Slectionnez l'encodage partir de la liste ou slectionnez Custom et dfinissez-le
manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de
donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Output Slectionnez l'emplacement de la sortie.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant
la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez
dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple
lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant est principalement utilis lorsqu'aucune transformation particulire n'est requise sur les
donnes charger dans la base de donnes.
Limitation Le serveur/client de la base de donnes doit tre install sur la mme machine que le Studio Talend ou le Job
contenant un tInformixOutputBulkExec, afin que le composant fonctionne correctement.
Scnarios associs
Pour un scnario associ au tInformixOutputBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
tInformixRollback
Proprits du tInformixRollback
Ce composant est troitement li aux composants tInformixCommit et tInformixConnection. Ils sont
gnralement utiliss ensemble lors de transactions.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Il faut utiliser ce composant en association avec des composants Informix, notamment avec le
tInformixConnection et le tInformixCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au tInformixRollback, consultez Scnario : Annuler l'insertion de donnes dans des
tables mre/fille du composant tMysqlRollback.
tInformixRow
Proprits du tInformixRow
Famille de Databases/
composant Informix
Fonction tInformixRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL
dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux
dans le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tInformixRow agit sur la structure mme de la base
de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et
aisment crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Guess Query Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de
votre table dans le champ Query.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous
pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row
> Rejects.
Use Transaction Dcochez cette case lorsque la base de donnes est configure en mode NO_LOG.
Advanced settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette
parameters option est disponible lorsque la case Use an existing connection est dcoche dans les
Basic settings.
Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en
QUERY's cours. Slectionnez cette colonne dans la liste use column.
recordset
Cette option permet au composant d'avoir un schma diffrent de celui du
composant prcdent. De plus, la colonne contenant le rsultat de la requte doit
tre de type Object. Ce composant est gnralement suivi du tParseRecordSet.
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatementde donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs
des paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query
de l'onglet Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une
meilleure performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant
la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez
dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple
lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de
requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
tInformixSCD
Le composant tInformixSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tInformixSCD.
tInformixSP
Proprits du tInformixSP
Famille de composant Databases/
Informix
Fonction Le composant tInformixSP appelle une procdure stocke de base de donnes.
Objectif Le tInformixSP permet de centraliser des requtes multiples ou complexes dans une base de donnes et
de les appeler plus facilement.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est
rutilisable. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
IN OUT : les paramtres d'entre doivent tre retournes sous forme de valeur, mme aprs
modifications via la procdure (fonction).
RECORDSET : les paramtres d'entre doivent tre retournes sous forme d'ensemble de
valeurs, au lieu d'une valeur unique.
Consultez Scnario 1 : Insrer des donnes dans des tables mre/fille si vous
voulez analyser un ensemble d'enregistrements d'une table de donnes ou d'une
requte SQL.
Use Dcochez cette case lorsque la base de donnes est configure en mode NO_LOG.
Transaction
Advanced settings Additional Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette
JDBC option est disponible lorsque la case Use an existing connection est dcoche dans les
parameters Basic settings.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues
dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes
ayant la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas,
seuls les paramtres d'entre sont autoriss.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.
Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
Consultez galement Scnario 1 : Insrer des donnes dans des tables mre/fille si vous voulez analyser un
ensemble d'enregistrements d'une table de donnes ou d'une requte SQL.
tMSSqlBulkExec
Proprits du tMSSqlBulkExec
Les composants tMSSqlOutputBulk et tMSSqlBulkExec sont gnralement utiliss ensemble pour d'une part
gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tMSSqlOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le changement des donnes dans la base de donnes.
Famille de composant Databases/MSSql
Fonction Effectue une action d'Insert sur les donnes fournies.
Objectif Le composant tMSSqlBulkExec est un composant ddi qui permet un gain de performance
pendant les oprations d'Insert dans une base de donnes MSSql.
Basic settings Property type Peut tre Built-in ou Repository.
Drop and create the table : supprimer la table puis en crer une
nouvelle.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec un composant tMSSqlOutputBulk. Ensemble, ils
offrent un gain de performance important pour l'alimentation d'une base de donnes MSSql.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tMSSqlBulkExec, consultez les scnarios suivants :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.
tMSSqlColumnList
Proprits du tMSSqlColumnList
Famille de composant Databases/MS SQL
Fonction Le composant tMSSqlColumList effectue une opration d'itration dans toutes les colonnes d'une
table donne, grce une connexion MS SQL dfinie.
Objectif Le tMSSqlColumList permet de faire une liste des libells des colonnes d'une table MS SQL
donne.
Basic settings Component list Slectionnez le composant tMSSqlConnection dans la liste si vous
prvoyez d'ajouter plus d'une connexion votre Job en cours.
Table name Saisissez le nom de la table.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables COLUMN_NAME : nom de la colonne sur laquelle se fait l'itration. Cette variable est une
variable Flow et retourne une chane de caractres.
COLUMN_DEFAULT : valeur par dfaut de la colonne sur laquelle se fait l'itration. Cette
variable est une variable Flow et retourne une chane de caractres.
IS_NULLABLE : nullabilit de la colonne sur laquelle se fait l'itration. Cette variable est une
variable Flow et retourne YES si la colonne autorise les valeurs NULL. Sinon, elle retourne NO.
DATA_TYPE : type de donnes de la colonne sur laquelle se fait l'itration. Cette variable est une
variable Flow et retourne une chane de caractres.
pour les donnes numriques approximatives, exactes, les entiers, les donnes montaires et
retourne NULL pour les autres types de donnes.
COLUMN_KEY : indicateur cl de la colonne sur laquelle se fait l'itration. Cette variable est
une variable Flow et retourne une chane de caractres si la colonne est configure Key. Sinon,
elle ne retourne rien.
NB_COLUMN : nombre de colonnes itres jusqu' prsent. Cette variable est une variable After
et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Il faut utiliser ce composant en association avec les autres composants MS SQL, notamment avec
le tMSSqlConnection.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Scnario : Itrer une table de base de donnes et lister le nom des colonnes
de la table.
tMSSqlClose
Proprits du tMSSqlClose
Famille de composant Databases/MSSql
Fonction Le composant tMSSqlClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes MSSql.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tMSSqlConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tMSSqlConnection et tMSSqlRollback. Il est gnralement
utilis avec un composant tMSSqlConnection car il permet de fermer une connexion pour la transaction en cours.
tMSSqlCommit
Proprits du tMSSqlCommit
Famille de composant Databases/MSSql
Fonction Le composant tMSSqlCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tMSSqlConnection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants MSSql et notamment avec les
composants tMSSqlConnection et tMSSqlRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tMSSqlCommit, consultez Scnario 1 : Insrer des donnes dans des
tables mre/fille.
tMSSqlConnection
Proprits du tMSSqlConnection
Famille de composant Databases/MSSQL
Fonction Le composant tMSSqlConnection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
un tFileInputDelimited : lit le fichier d'entre, dfinit la structure des donnes et les envoie au composant
suivant.
un tMSSqlOutput : crit les donnes qu'il reoit du composant prcdent dans une table d'une base de donnes
MSSQL.
Construire le Job
1. Dposez les composants suivants de la Palette dans l'espace de modlisation graphique : un
tMSSqlConnection, un tFileInputDelimited, un tMSSqlOutput, un tMSSqlInput, un tLogRow et un
tMSSqlCommit.
2. Dans le champ Host, saisissez l'adresse IP ou le nom de l'hte du serveur MSSQL, 192.168.30.47 dans cet
exemple.
3. Dans le champ Port, saisissez le numro du port du serveur de la base de donnes, 1433 dans ce scnario.
4. Dans le champ Schema, saisissez le nom du schma, dbo dans cet exemple.
5. Dans le champ Database, saisissez le nom de la base de donnes, talend dans ce scnario.
6. Dans les champs Username et Password, saisissez respectivement votre identifiant et votre mot de passe
de connexion MSSQL.
2. Cliquez sur le bouton [...] ct du champ File Name/Stream afin de parcourir votre systme jusqu'au fichier
d'entre, par exemple D:/Input/Employee_Wage.txt. Ce fichier texte contient trois colonnes : id, name et wage.
id;name;wage
51;Harry;2300
40;Ronald;3796
17;Theodore;2174
21;James;1986
2;George;2591
89;Calvin;2362
84;Ulysses;3383
4;Lyndon;2264
17;Franklin;1780
86;Lyndon;3999
3. Dans le champ Header, saisissez 1 pour ignorer la premire ligne du fichier d'entre.
4. Cliquez sur Edit schema pour dfinir les donnes passer au composant tMSSqlOutput. Dans cet exemple,
dfinissez id comme la cl (cochez la case Key) et spcifiez la longueur (Length) et la prcision (Precision)
pour chaque colonne.
Cliquez sur OK pour fermer l'diteur de schma. Une bote de dialogue s'ouvre, dans laquelle vous pouvez
choisir de propager le schma au composant suivant.
2. Saisissez les informations requises pour la connexion ou utilisez une connexion existante prcdemment
configure. Dans cet exemple, cochez la case Use an existing connection. Si plusieurs connexions sont
disponibles, slectionnez celle que vous souhaitez utiliser, dans la liste droulante Component List.
3. Dans le champ Table, saisissez le nom de la table dans laquelle vous souhaitez crire les donnes : Wage_Info
dans ce scnario. Vous pouvez galement cliquer sur le bouton [...] ct du champ Table pour ouvrir une
bote de dialogue et slectionner une autre table.
4. Slectionnez Create table if not exists dans la liste droulante Action on table.
2. Cochez la case Use an existing connection. Si plusieurs connexions sont disponibles, slectionnez celle que
vous souhaitez utiliser, dans la liste droulante Component List.
3. Cliquez sur Edit schema pour dfinir la structure des donnes lire depuis la table. Dans cet exemple, vous
devez lire les trois colonnes de la table.
4. Dans le champ Table Name, saisissez le nom de la table de laquelle vous souhaitez lire les donnes :
Wage_Info dans ce scnario.
5. Dans le champ Query, renseignez la requte SQL excuter sur la table spcifie. Pour obtenir les donnes
relatives aux employs dont le salaire est suprieur la moyenne et les classer par ID, saisissez la requte
SQL comme suit :
SELECT *
FROM Wage_Info
WHERE wage >
(SELECT avg(wage)
FROM Wage_Info)
ORDER BY id
2. Excutez le Job en appuyant sur la touche F6 ou en cliquant sur le bouton Run de la vue Run.
La console affiche l'ID des employs dont le salaire est suprieur la moyenne, leur nom et leur salaire. Les
employs sont classs par ID.
tMSSqlInput
Proprits du tMSSqlInput
Famille de composant Databases/MSSql
Fonction Le composant tMSSqlInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tMSSqlInput excute une requte en base de donnes selon un ordre strict qui doit correspondre
celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant
suivant via une connexion de flux (Main row).
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes MS SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez les scnarios des composants tDBInput dans :
tMSSqlConnection.
Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du tContextLoad.
tMSSqlLastInsertId
Proprits du tMSSqlLastInsertId
Famille de composant Databases/MS SQL server
Fonction tMSSqlLastInsertId affiche les derniers ID ajouts une table partir d'une connexion MSSql
spcifie.
Objectif tMSSqlLastInsertId permet de rcuprer les cls primaires des entres dernirement ajoutes par
un utilisateur une table MSSql.
Basic settings Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les
possibilits des requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au composant tMSSqlLastInsertId, consultez Scnario : Rcuprer les ID des dernires
entres ajoutes.
tMSSqlOutput
Proprits du tMSSqlOutput
Famille de composant Databases/MSSql
Fonction Le composant tMSSqlOutput crit, met jour, modifie ou supprime les donnes d'une base de
donnes.
Objectif Le tMSSqlOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction
du flux entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table
la fois.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes
de la table slectionne :
Advanced settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base
parameters de donnes cre. Cette option est disponible lorsque la case Use an
existing connection est dcoche dans les Basic settings.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les
possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table
d'une base de donnes MSSql. Il permet aussi de crer un flux de rejet avec un lien Row > Reject
filtrant les donnes en erreur. Pour un exemple d'utilisation, consultez Scnario 3 : Rcuprer les
donnes errones l'aide d'un lien Reject du composant tMysqlOutput.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et
retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et
retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et
retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et
retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de
caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Lorsque l'option Single Insert Query est slectionne dans la liste Action on data, une Instruction
Prpare SQL est gnre, par exemple, INSERT INTO table (col1, col2, col3) VALUES
(?,?,?) , (?,?,?) , (?,?,?) ,(?,?,?). Entre les parenthses se trouvent les groupes
de paramtres, dont le nombre ne peut en gnral pas dpasser 2000, selon le pilote JBDC. La
taille des lots doit tre configure de manire respecter cette limite, c'est--dire qu'elle ne doit
pas dpasser 2000.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tMSSqlOutput, consultez :
tMSSqlConnection.
tMSSqlOutputBulk
Proprits du tMSSqlOutputBulk
Les composants tMSSqlOutputBulk et tMSSqlBulkExec sont gnralement utiliss ensemble pour d'une part
gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tMSSqlOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le chargement des donnes dans la base de donnes.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis avec le composant tMSSQLBulkExec. Ensemble, ils
offrent un gain de performance important pour l'alimentation d'une base de donnes MSSQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Scnarios associs
Pour un scnario associ au tMSSqlOutputBulk, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
tMSSqlOutputBulkExec
Proprits du tMSSqlOutputBulkExec
Les composants tMSSqlOutputBulk et tMSSqlBulkExec sont gnralement utiliss ensemble comme deux
parties d'un processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime
tape, ce fichier est utilis lors de l'opration d'INSERT afin de peupler une base de donnes. Cette excution en
deux tapes est unifie dans le composant tMSSqlOutputBulkExec.
Drop and create the table : supprimer la table puis en crer une
nouvelle.
Le fichier est gnr sur la machine spcifie par l'URI dans le champ
Host et doit tre sur la mme machine que le serveur de la base de
donnes.
Append Cochez cette option pour ajouter des nouvelles lignes la fin du
fichier.
Advanced settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base
parameters de donnes cre. Cette option est disponible lorsque la case Use an
existing connection est dcoche dans les Basic settings.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est principalement utilis lorsqu'aucune transformation particulire n'est requise sur
les donnes charger dans la base de donnes.
Limitation Le serveur de la base de donnes doit tre install sur la mme machine que le Studio Talend ou le
Job contenant un tMSSqlOutputBulkExec, afin que le composant fonctionne correctement.
Scnarios associs
Pour un scnario associ au tMSSqlOutputBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
tMSSqlRollback
Proprits du tMSSqlRollback
Famille de composant Databases
Fonction Le tMSSqlRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant tMSSqlConnection dans la liste s'il y a
plus d'une connexion dans votre Job.
Close connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants MSSql, notamment les
composants tMSSqlConnection et tMSSqlCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Scnario : Annuler l'insertion de donnes dans des tables mre/fille.
tMSSqlRow
Proprits du tMSSqlRow
Famille de composant Databases/DB2
Fonction tMSSqlRow est le composant spcifique ce type de base de donnes. Il excute des requtes
SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en
place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tMSSqlRow agit sur la structure mme de
la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider
rapidement et aisment crire vos requtes.
Basic settings Use an existing connection Cochez cette case et slectionnez le composant de connexion adquat
partir de la liste Component list pour rutiliser les paramtres d'une
connexion que vous avez dj dfinie.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les
possibilits de requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
tMSSqlSCD
Le composant tMSSqlSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus
d'informations, consultez tMSSqlSCD.
tMSSqlSP
Proprits du tMSSqlSP
Famille de composant Databases/MSSql
Fonction Le composant tMSSqlSP appelle une procdure stocke de base de donnes.
Objectif Le tMSSqlSP permet de centraliser des requtes multiples ou complexes dans une base de donnes
et de les appeler plus facilement.
Basic settings Property type Peut tre Built-in ou Repository.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut.
Dans ce cas, seuls les paramtres d'entre sont autoriss.
Limitation La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Dans ce scnario, la table de laquelle vous souhaitez rcuprer des donnes contient des informations personnelles.
Pour reproduire ce scnario, vous pouvez crire les donnes dans une table partir d'un fichier CSV, comme suit.
Pour plus d'informations concernant l'criture de donnes dans une table MS SQL, consultez Scnario : Insrer
des donnes dans une table de base de donnes et en extraire des informations.
id;name;sex;age
1;Ford;Male;25
2;Rose;Female;30
3;Sabrina;Female;28
4;Teddy;Male;32
5;Kate;Male;35
Dans ce scnario, la procdure stocke utilise pour rcuprer les informations personnelles se prsente comme
suit :
Construire le Job
1. Crez un nouveau Job et ajoutez les composants suivants en saisissant leur nom dans l'espace de modlisation
graphique ou en les dposant partir de la Palette : un tFixedFlowInput, un tMSSqlSP, un tParseRecordSet
et deux composants tLogRow.
2. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir l'diteur du schma.
Cliquez deux fois sur le bouton [+] pour ajouter deux colonnes : id de type Integer et name de type String.
3. Dans la zone Mode, renseignez chaque colonne avec sa valeur respective. Dans cet exemple, la valeur de la
colonne id est 4 et celle de la colonne name est null car elle n'est pas utilise dans l'instruction SQL SELECT
dans la procdure stocke.
2. Dans les champs Host, Port, Schema, Database, Username et Password, renseignez vos informations de
connexion au serveur MS SQL.
3. Dans le champ SP Name, saisissez le nom de la procdure stocke utiliser. Par exemple, saisissez
QueryPerson.
4. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir l'diteur du schma.
Cliquez sur le bouton pour copier toutes les colonnes du schma d'entre dans le schma de sortie.
Cliquez sur le bouton [+] du panneau de droite afin d'ajouter une nouvelle colonne person de type Object
qui contiendra les informations personnelles rcuprer de la base de donnes.
Cliquez sur OK pour fermer l'diteur du schma et acceptez la propagation propose par la bote de dialogue.
5. Dans la zone Parameters, cliquez trois fois sur le bouton [+] pour ajouter trois lignes et slectionnez une
colonne de schma ainsi que son type pour chaque ligne. Dans cet exemple, les colonnes id et name sont de
type IN, et la colonne person est de type RECORD SET.
Configurer le tParseRecordSet
2. Dans la liste Prev. Comp. Column list, slectionnez la colonne contenant les informations personnelles
parser. Dans cet exemple, slectionnez person.
3. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir l'diteur du schma.
Cliquez quatre fois sur le bouton [+] dans le panneau de droite pour ajouter quatre colonnes : id et age de
type Integer, et name et sex de type String.
Cliquez sur OK pour fermer l'diteur du schma et acceptez la propagation propose par la bote de dialogue.
4. Dans la table Attribute table, renseignez chaque colonne Value avec le nom de colonne correspondant dans
la table du serveur MS SQL contenant les informations personnelles.
Dans la zone Mode, slectionnez Vertical (each row is a key/value list) pour un affichage optimal des
rsultats.
Les informations personnelles contenant l'ID 4 dans la table MS SQL sont affiches dans la table infrieure de
la console. Notez que les valeurs des colonnes id et name affiches dans la table suprieure sont les donnes
d'entre.
Scnarios associs
Pour des scnarios associs, consultez :
Consultez galement Scnario 1 : Insrer des donnes dans des tables mre/fille si vous voulez analyser un
ensemble d'enregistrements d'une table de donnes ou d'une requte SQL.
tMSSqlTableList
Proprits du tMSSqlTableList
Famille de composant Databases/MS SQL
Fonction Le composant tMSSqlTableList effectue une opration d'itration sur toutes les tables d'une base
de donnes, grce une connexion MS SQL dfinie.
Objectif Le composant tMSSqlTableList permet de lister les noms des tables MS SQL grce aux
commandes SELECT et WHERE.
Basic settings Component list Slectionnez le composant tMSSqlConnection dans la liste si vous
prvoyez d'ajouter plus d'une connexion votre Job en cours.
Where clause for table name Saisissez la commande WHERE permettant d'identifier les tables sur
selection lesquelles effectuer l'opration d'itration.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables CURRENT_TABLE : nom de la table sur laquelle se fait l'itration. Cette variable est une variable
Flow et retourne une chane de caractres.
NB_TABLE : nombre de tables itres jusqu' prsent. Cette variable est une variable Flow et
retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Il faut utiliser ce composant en association avec les autres composants MS SQL, notamment avec
le tMSSqlConnection.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Scnario : Itrer une table de base de donnes et lister le nom des colonnes
de la table.
tMysqlBulkExec
Proprits du tMysqlBulkExec
Les composants tMysqlOutputBulk et tMysqlBulkExec sont gnralement utiliss ensemble pour d'une part
gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tMysqlOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le changement des donnes dans la base de donnes.
Famille de Databases/Mysql
composant
Fonction Le composant tMysqlBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tMysqlBulkExec est un composant ddi qui permet un gain de performance pendant les oprations d'Insert
dans une base de donnes MySQL.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants
sont alors pr-remplis l'aide des donnes collectes.
DB Version Slectionnez la version de MySQL que vous utilisez.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez
dj dfinie.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets
doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en crer
un nouvelle.
Une seule table peut tre crite la fois et cette table doit dj exister pour
que l'opration d'Insert soit autorise.
Local file Name Nom du fichier charger.
Ce fichier doit se situer sur la mme machine que le Studio Talend ou que le Job
contenant un tMysqlBulkExec, afin que le composant fonctionne correctement.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui sont
traits et passs au composant suivant. Le schma peut tre Built-in ou distant dans
le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers
(integer) ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont
pas entoures de guillemets. Si c'est le cas, vous devez supprimer manuellement les
guillemets.
Ignore records in table : Ignore les enregistrements existants ou insre les nouveaux.
Records contain NULL Cochez cette case si vous souhaitez rcuprer les valeurs nulles du flux d'entre. Si
value vous ne cochez pas cette case, les valeurs nulles en entre seront considres comme
des champs vides dans le flux de sortie.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec un composant tMysqlOutputBulk. Ensemble, ils offrent un gain
de performance important pour l'alimentation d'une base de donnes MySQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour plus d'informations relatives au fonctionnement de tMysqlBulkExec, consultez les scnarios suivants dans :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
Scnario : Insrer des donnes dans une base MySQL du composant tMysqlOutputBulkExec.
Scnario : Supprimer et insrer des donnes dans une base Oracle du composant tOracleBulkExec.
tMysqlClose
Proprits du tMysqlClose
Famille de composant Databases/Mysql
Fonction Le composant tMysqlClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes Mysql.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tMysqlConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant doit tre utilis avec des composants MySQL, notamment avec le tMysqlCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tMysqlConnection et tMysqlRollback. Il est gnralement
utilis avec un composant tMysqlConnection car il permet de fermer une connexion pour la transaction en cours.
tMysqlColumnList
Proprits du tMysqlColumnList
Famille de composant Databases/MySQL
Fonction Le composant tMysqlColumList effectue une opration d'itration dans toutes les colonnes d'une
table donne, grce une connexion MySQL dfinie.
Objectif Le tMysqlColumList permet de faire une liste des libells des colonnes d'une table MySQL
donne.
Basic settings Component list Slectionnez le composant tMysqlConnection dans la liste si vous
prvoyez d'ajouter plus d'une connexion votre Job en cours.
Table name Saisissez le nom de la table.
Global Variables COLUMN_NAME : nom de la colonne sur laquelle se fait l'itration. Cette variable est une
variable Flow et retourne une chane de caractres.
DATA_TYPE : type de donnes de la colonne sur laquelle se fait l'itration. Cette variable est une
variable Flow et retourne une chane de caractres.
COLUMN_DEFAULT : valeur par dfaut de la colonne sur laquelle se fait l'itration. Cette
variable est une variable Flow et retourne une chane de caractres.
IS_NULLABLE : nullabilit de la colonne sur laquelle se fait l'itration. Cette variable est une
variable Flow et retourne YES si la colonne autorise les valeurs NULL. Sinon, elle retourne NO.
COLUMN_KEY : indicateur cl de la colonne sur laquelle se fait l'itration. Cette variable est
une variable Flow et retourne une chane de caractres si la colonne est configure Key. Sinon,
elle ne retourne rien.
NB_COLUMN : nombre de colonnes itres jusqu' prsent. Cette variable est une variable After
et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Il faut utiliser ce composant en association avec les autres composants MySQL, notamment avec
le tMysqlConnection.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Dans la Palette, cliquez sur chacun des composants suivants et dposez-les dans l'espace de modlisation :
tMysqlConnection, tMysqlTableList, tMysqlColumnList, tFixedFlowInput et tLogRow.
Dans l'espace de modlisation, slectionnez le composant tMysqlConnection et cliquez sur la vue Component
pour dfinir les paramtres de base.
Dans l'onglet Basic settings, entrez manuellement les proprits de connexion la base de donnes ou
slectionnez-les partir de la liste des variables de contexte : appuyez simultanment sur les touches Ctrl
+Espace puis cliquez sur le champ correspondant si vous avez stock les informations en local sous le nud
DB Connections du rpertoire Metadata.
Pour plus d'informations sur les mtadonnes, veuillez consulter le Guide utilisateur du Studio Talend.
Dans cet exemple, connectez-vous une base de donnes MySQL appele customers.
Dans l'espace de modlisation, slectionnez le composant tMysqlTableList et cliquez sur la vue Component
pour dfinir ses paramtres de base.
Dans le champ Component list, slectionnez le composant de connexion MySQL adquat si vous utilisez plus
d'une connexion.
Renseignez la clause Where en utilisant la bonne syntaxe dans le champ correspondant pour itrer les noms de
la ou des tables que vous voulez lister dans la console.
Dans l'espace de modlisation, slectionnez le composant tMysqlColumnList et cliquez sur la vue Component
pour paramtrer ses proprits de base.
Dans le champ Component list, slectionnez le composant de connexion MySQL adquat si vous utilisez plus
d'une connexion.
Dans le champ Table name, saisissez le nom de la table dont vous souhaitez lister les libells de colonnes.
Dans ce scnario, l'objectif est de lister les libells des colonnes de la table customer.
Dans l'espace de modlisation, slectionnez le composant tFixedFlowInput et cliquez sur la vue Component
pour paramtrer ses proprits de base.
Dans le champ Schema, slectionnez l'option Built-In et cliquez sur le bouton [...] ct du champ Edit Schema
pour dfinir les donnes que vous souhaitez utiliser en entre. Dans ce scnario, le schma est compos de
deux colonnes : la premire TableName correspond au nom de la table MySQL et la deuxime ColumnName
correspond aux libells des colonnes.
Cliquez sur OK pour fermer la bote de dialogue et une nouvelle bote de dialogue apparat vous demandant
si vous souhaitez propager ces modifications, acceptez en cliquant sur Yes. Les colonnes dfinies apparaissent
dans le champ Values de la vue Basic settings.
Dans le champ Values, cliquez sur chacune des cellules de la colonne Value pour dfinir le contenu des colonnes
de la table MySQL et appuyez sur Ctrl+Espace pour accder la liste des variables globales.
Cliquez sur la vue Component et paramtrez les proprits de base du tLogRow en fonction de vos besoins.
Le nom de la table MySQL et le libell de ses colonnes sont affichs dans la console.
tMysqlCommit
Proprits du tMysqlCommit
Famille de composant Databases/MySQL
Fonction Le composant tMysqlCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tMysqlConnection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants MySQL et notamment avec les
composants tMysqlConnection et tMysqlRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tMysqlCommit, consultez Scnario 1 : Insrer des donnes dans des
tables mre/fille.
tMysqlConnection
Proprits du tMysqlConnection
Famille de composant Databases/MySQL
Fonction Le composant tMysqlConnection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository.
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Avant de crer ce Job, suivez les tapes dcrites ci-dessous pour crer les tables ncessaires, l'aide d'un
gestionnaire de table tel que innodb.
2. Une fois connect la base de donnes correspondante, saisissez la commande suivante afin de crer la table
parent :
create table f1090_mum(id int not null auto_increment, name varchar(10), primary
key(id)) engine=innodb;
Dans le Studio Talend, le Job est constitu de sept composants, notamment un tMysqlConnection et un
tMysqlCommit.
Construire le Job
1. Cliquez et dposez les composants suivants de la Palette : un tFileList, un tFileInputDelimited, un tMap,
un tMysqlConnection, un tMysqlCommit et deux tMysqlOutput.
4. Reliez le tFileList au tFileInputDelimited l'aide d'un lien Iterate. Le nom du fichier traiter est
automatiquement renseign depuis le rpertoire du tFileList, grce une variable globale.
5. Reliez le composant tFileInputDelimited au tMap et divisez le flux entre les deux composants Mysql de
sortie. Utilisez un lien Row > Main pour chaque connexion, reprsentant le flux de donnes principal.
3. Dans l'onglet Basic settings du composant tFileInputDelimited, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. Renseignez le champ File Name avec la variable globale :
tFileList_1.CURRENT_FILEPATH
4. Paramtrez les autres champs comme vous le souhaitez, dfinissez les sparateurs de lignes et de champs
(Row et Field Separator) en fonction de la structure de votre document.
5. Dfinissez manuellement le schma du fichier l'aide du bouton Edit schema ou slectionnez le schma dans
le Repository. En version Java, assurez-vous que le type de donnes est correctement dfini, conformment
la nature des donnes traites.
6. Dans la zone Output du tMap, ajoutez deux tables de sortie, une que vous nommerez mum pour la table
parent et une deuxime que vous nommerez baby pour la table enfant.
Cliquez sur la colonne Name de la zone Input et glissez-la dans la table mum.
Cliquez sur la colonne Years de la zone Input et glissez-la dans la table baby.
7.
8. Assurez-vous que la table mum est bien au dessus de la table baby car l'ordre des tables dtermine la squence
des flux et ainsi l'insertion de base de donnes est excute correctement.
Slectionnez une connexion de sortie de type Row pour acheminer correctement le flux vers le composant
de sortie correspondant.
9. Dans l'onglet Basic settings des deux composants tMysqlOutput, cochez la case Use an existing connection
pour rcuprer les informations du composant tMysqlConnection.
10. Nommez votre table dans le champ Table en vous assurant que vous saisissez un nom pour la bonne table.
Dans cet exemple, la table est soit f1090_mum, soit f1090_baby.
Slectionnez Insert dans le champ Action on data pour les deux composants de sortie (tMysqlOutput).
Cliquez sur le bouton Sync columns pour rcuprer le schma dfini dans le tMap.
11. Dans la zone Additional columns de l'onglet Advanced settings du composant tMysqlOutput
correspondant la table enfant (f1090_baby), dfinissez la colonne id_baby de manire ce que l'id de la
table parent soit rutilis.
Dans la colonne Position, slectionnez l'option Before et dans Reference column, l'option years.
Excuter le Job
1. Appuyez sur les touches Ctrl+S pour enregistrer votre Job.
1. Ajoutez les composants suivants en saisissant leur nom dans l'espace de modlisation graphique ou en les
dposant depuis la Palette :
2. Dans la liste Property Type, slectionnez Built-In puis configurez les dtails de connexion dans les champs
appropris, dont :
le nom d'utilisateur (Username) et le mot de passe (Password) pour l'identification la base de donnes.
Si vous avez stock les informations de connexion sous le nud Metadata du Repository, vous pouvez
dposer ces mtadonnes centralises sur le composant tMysqlConnection. Pour plus d'informations
concernant la centralisation d'une connexion une base de donnes, consultez le chapitre sur la gestion des
mtadonnes dans le Guide utilisateur du Studio Talend.
3. Cochez la case Use or register a shared DB Connection afin que la connexion la base de
donnes ouverte par ce composant puisse tre partage entre les diffrents Jobs. Ensuite, dans le champ
Shared DB Connection Name, saisissez un nom pour la connexion partage, entre guillemets doubles,
shared_mysql_connection dans cet exemple.
2. Cliquez sur le bouton [+] afin d'ajouter quatre colonnes puis dfinissez leurs proprits comme suit :
Pour la colonne id, slectionnez Numeric.sequence dans la liste Function afin de gnrer des squences
de nombres.
Pour la colonne city, slectionnez TalendDataGenerator.getUsCity dans la liste Function pour gnrer
des noms de ville de manire alatoire.
4. Dans le champ Number of Rows for RowGenerator, prcisez le nombre de colonnes de donnes que vous
souhaitez gnrer, 10 dans cet exemple.
5. Cliquez sur le bouton Preview de l'onglet Preview afin de valider les paramtres du gnrateur.
6. Une fois les paramtres valids, cliquez sur OK afin de fermer l'diteur. Dans la bote de dialogue qui s'affiche,
cliquez sur Yes afin de propager les changements au composant suivant.
2. Cochez la case Use an existing connection et, si vous avez plus d'un composant de connexion dans ce Job,
slectionnez le composant de connexion utiliser dans la liste Component List.
3. Dans le champ Table, saisissez le nom de la table de base de donnes dans laquelle les donnes sont crites,
customers dans cet exemple.
4. Dans la liste Action on table, slectionnez l'option Drop table if exists and create afin de vous assurer de
la cration d'une table vide.
6. Cliquez sur le bouton [...] ct du champ Edit schema afin de vrifier la propagation du schma de sortie.
Si besoin, cliquez sur Sync columns afin de rcuprer le schma depuis le composant prcdent.
1. Ajoutez les composants suivants en saisissant leur nom dans l'espace de modlisation graphique ou en les
dposant depuis la Palette :
un tMysqlInput, afin de lire les donnes crites dans la base de donnes MySQL par le Job fils,
un tMysqlCommit, afin de commiter les donnes lors de la transaction et fermer la connexion la base
de donnes.
Si un Job fils a dj t dfini pour le composant, vous pouvez cliquer-droit sur le composant et slectionner
Settings dans le menu contextuel afin d'ouvrir la vue Basic settings. Vous pouvez galement cliquer sur le
composant et slectionner l'onglet Component.
2. Cliquez sur le bouton [...] ct du champ Job et slectionnez le Job fils dans la bote de dialogue [Repository
Content]. Laissez tous les autres paramtres tels qu'ils sont.
3. Dans la vue Basic settings du composant tMysqlConnection, cochez la case Use or register a shared
DB Connection. Ensuite, dans le champ Shared DB Connection Name, saisissez le nom de la connexion
partage dfinie dans le Job fils, shared_mysql_connection dans cet exemple.
5. Cochez la case Use an existing connection et, dans le cas o vous avez plus d'un composant de connexion
dans ce Job, slectionnez le composant de connexion utiliser dans la liste Component List.
6. Cliquez sur le bouton [...] ct du champ Edit schema afin d'ouvrir l'diteur [Schema] et dfinissez la
mme structure de donnes que dans le Job fils.
Une fois la structure de donnes dfinie, cliquez sur OK afin de fermer l'diteur de schma. Dans la bote de
dialogue qui s'affiche, cliquez sur Yes afin de propager les changements au composant suivant.
7. Prcisez le nom de la tche dans la liste Table Name et cliquez sur Guess Query afin de renseigner
automatiquement le champ Query avec la requte approprie.
8. Dans la vue Basic settings du tLogRow, slectionnez le mode Table afin d'afficher le rsultat de l'excution
sous forme de tableau.
Excuter le Job
2. Appuyez sur F6 ou cliquez sur le bouton Run de la console Run afin d'excuter votre Job.
Le Job pre appelle le Job fils afin d'crire des donnes dans la base de donnes. Il lit ensuite les donnes
depuis la base de donnes puis les affiche dans la console.
tMysqlInput
Proprits du tMysqlInput
Famille de Databases/MySQL
composant
Fonction Le composant tMysqlInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tMysqlInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui
dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une
connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits
du composant. Les champs suivants sont alors pr-remplis l'aide des donnes
collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base
de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la
vue Basic settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion
de base de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez
dj dfinie.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets
doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui sont
traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant
dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Cette option est indisponible lorsque la case Use an existing connection est coche.
Advanced settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes cre.
parameters Cette option est disponible lorsque la case Use an existing connection est dcoche
dans les Basic settings.
noDatetimeStringSync=true&zero-
DateTimeBehavior=convertToNull.
Enable stream Cochez cette case pour dterminer avec quelles lignes vous souhaitez travailler. Cette
option permet d'amliorer les performances.
Trim all the String/ Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes
Char columns les colonnes contenant des chanes de caractres.
Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Dcochez Trim all the String/Char columns pour activer le tableau Trim
column.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes MySQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
2. Dans la liste Property Type, slectionnez Repository, si vous avez dj stock la connexion la base de
donnes dans le nud Metadata du Repository. Les informations de connexion sont alors automatiquement
renseignes.
Pour plus d'informations concernant le stockage des mtadonnes dans le Repository, consultez le Guide
utilisateur du Studio Talend.
Si vous n'avez pas stock localement la connexion dans le Repository, slectionnez Built-In dans la liste
Property Type puis renseignez manuellement les informations.
3. Dans la liste Schema, slectionnez Built-In puis cliquez sur Edit schema pour configurer le schma.
4.
Cliquez quatre fois sur le bouton pour ajouter quatre lignes au schma.
Dans les colonnes Column et Db Column, cliquez dans les champs afin de saisir le nom des colonnes
correspondantes, id, first_name, city et salary, respectivement.
Cliquez sur les champs de la colonne Type pour dfinir le type de donnes.
5. A ct du champ Table Name, cliquez sur le bouton [...] pour slectionner la table de la base de donnes
souhaite.
Une bote de dialogue affiche une arborescence de toutes les tables dans la base de donnes slectionne :
6. Cliquez sur la table qui vous intresse puis sur OK pour fermer la bote de dialogue.
8. Dans le champ Query, saisissez la requte permettant de rcuprer les colonnes souhaites de la table.
10. A ct du champ File Name, cliquez sur le bouton [...] afin de parcourir votre systme jusqu' l'emplacement
o vous souhaitez sauvegarder le fichier de sortie, puis saisissez un nom pour le fichier.
Cochez la case Include Header afin de rcuprer le nom des colonnes du schma ainsi que les donnes.
Excuter le Job
Appuyez sur F6 pour excuter votre Job.
Dans le fichier de sortie est crit le nom des colonnes souhaites et les donnes correspondantes, rcuprs de
la base de donnes :
Le Job peut galement tre excut en mode Traces Debug, ce qui vous permet de voir les lignes pendant leur criture dans
le fichier de sortie, dans l'espace de modlisation graphique.
2. Dans la liste Property Type, slectionnez Repository si vous avez dj stock la connexion la base
de donnes dans le nud Metadata du Repository. Les champs des proprits sont automatiquement
renseigns.
Pour plus d'informations concernant le stockage d'une connexion une base de donnes, consultez le Guide
utilisateur du Studio Talend.
Si vous n'avez pas configur de connexion une base de donnes dans le Repository, renseignez
manuellement les informations aprs avoir slectionn Built-in dans la liste Property Type.
3. Configurez le Schema en Built-In, puis cliquez sur Edit schema pour dfinir le schma comme vous le
souhaitez.
4.
Cliquez sur le bouton pour ajouter les sept colonnes utiliser pour configurer le schma et renommez-
les respectivement : id, first_name, last_name, city, state, date_of_birth et salary.
Cliquez sur les lignes de la colonne Type pour dfinir le type des donnes.
5. Placez votre souris sur le champ Table Name et appuyez sur F5 pour configurer les paramtres de contexte.
Pour plus d'informations concernant les paramtres de contexte, consultez le Guide utilisateur du Studio
Talend.
6. Laissez les paramtres par dfaut dans le champ Name et saisissez le nom de la table de la base de donnes
dans le champ Default value, employees dans ce cas.
8. Dans la liste Query type, slectionnez Built-In puis cliquez sur Guess Query pour obtenir l'instruction de
la requte.
Dans ce scnario, lisez les enregistrements contenant un salaire suprieur 8000. Ajoutez une clause Where.
L'instruction finale s'affiche comme suit :
"SELECT
"+context.TABLE+".`id`,
"+context.TABLE+".`first_name`,
"+context.TABLE+".`last_name`,
"+context.TABLE+".`city`,
"+context.TABLE+".`state`,
"+context.TABLE+".`date_of_birth`,
"+context.TABLE+".`salary`
FROM "+context.TABLE+"
WHERE
"+context.TABLE+".`salary` > 8000"
9. Double-cliquez sur le tLogRow pour configurer ses proprits de base dans l'onglet Basic settings.
10. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un meilleur affichage des
rsultats.
Excuter le Job
Appuyez sur F6 pour excuter votre Job. Les rsultats s'affichent dans la console.
Comme vous pouvez le constater ci-dessus, les enregistrements comportant un salaire suprieur 8000 sont
rcuprs.
4. Reliez le tMysqlInput au tMysqlClose l'aide d'un lien Trigger > On Subjob Ok.
1. Dans la vue Contexts, cliquez sur le bouton [+] afin d'ajouter une ligne la table, puis cliquez dans le champ
Name et saisissez un nom pour la variable, myConnection dans cet exemple.
3. Cliquez dans le champ Value, puis cliquez sur le bouton qui apparat dans ce champ pour ouvrir la bote de
dialogue [Configure value of list].
4. Dans la bote de dialogue [Configure value of list], cliquez sur le bouton New... pour ouvrir la bote de
dialogue [New Value] et saisissez le nom de l'un des composants de connexion dans le champ de texte,
tMysqlConnection_1 dans cet exemple. Cliquez ensuite sur OK pour fermer la bote de dialogue.
Rptez cette tape pour spcifier le nom de l'autre composant de connexion comme autre lment de liste,
tMysqlConnection_2 dans cet exemple.
Lorsque vous avez termin, cliquez sur OK pour fermer la bote de dialogue [Configure Values].
5. Cochez la case ct du champ de valeur de la variable et saisissez, dans le champ Prompt, le message que
vous souhaitez afficher l'excution, Select a connection component: dans cet exemple.
Notez que ce composant sert ouvrir une connexion une base de donnes MySQL nomme project_q1.
2. Configurez le second composant tMysqlConnection de la mme faon mais en saisissant project_q2 dans le
champ Database. En effet, ce composant sert ouvrir une connexion une autre base de donnes MySQL,
project_q2.
4. Cochez la case Use an existing connection et laissez la case Component List comme elle est.
5. Cliquez sur le bouton [...] situ ct du champ Edit schema afin d'ouvrir la bote de dialogue [Schema].
Dfinissez la structure de la table de la base de donnes partir de laquelle les donnes sont lues.
Dans cet exemple, la structure de la table de la base de donnes est compose de quatre colonnes : id (de type
Integer et d'une longueur de 2 caractres), firstName (de type String et d'une longueur de 15 caractres),
lastName (de type String et d'une longueur de 15 caractres) et city (de type String et d'une longueur de 15
caractres). Cliquez sur OK pour fermer la bote de dialogue et propager le schma au composant suivant.
6. Dans le champ Table, saisissez le nom de la table de la base de donnes, customers dans cet exemple. Cliquez
sur Guess Query afin de gnrer l'instruction de la requte correspondant au schma de votre table dans le
champ Query.
7. Dans la vue Dynamic settings, cliquez sur le bouton [+] afin d'ajouter une ligne votre table. Dans
le champ Code, saisissez le code du script de la variable de contexte que vous venez de crer, " +
context.myConnection + " dans cet exemple.
8. Dans la vue Basic settings du tLogRow, slectionnez l'option Table pour un meilleur affichage des rsultats
d'excution du Job.
9. Dans la vue Dynamic settings du tMysqlClose, procdez de la mme manire que dans la vue Dynamic
settings du tMysqlInput.
Une bote de dialogue s'affiche vous demander de spcifier le composant de connexion que vous souhaitez
utiliser.
Les donnes lues depuis la base de donnes project_q1 s'affichent dans la console Run.
3. Appuyez sur F6 ou cliquez sur Run afin d'excuter le Job nouveau. Quand la bote de dialogue s'affiche,
slectionnez l'autre composant de connexion, savoir tMysqlConnection_2, afin de lire les donnes depuis
l'autre base de donnes, project_q2.
Les donnes lues depuis la base de donnes project_q2 s'affichent dans la console Run.
tMysqlLastInsertId
Proprits du tMysqlLastInsertId
Famille de composant Databases/MySQL
Fonction tMysqlLastInsertId affiche les derniers ID ajouts une table partir d'une connexion MySQL
spcifie.
Objectif tMysqlLastInsertId permet de rcuprer les cls primaires des entres dernirement ajoutes par
un utilisateur une table MySQL.
Basic settings Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant intermdiaire.
Si vous utilisez ce composant avec un tMysqlOutput, vrifiez que la case Extend Insert
de l'onglet Advanced settings est bien dcoche. En effet, Extend Insert permet de faire
un chargement par lot, ainsi seul l'ID de la dernire ligne du dernier lot sera retourn.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Cliquez sur chacun des composants suivants et dposez-les dans l'diteur graphique : tMysqlConnection,
tMysqlCommit, tFileInputDelimited, tMysqlOutput, tMysqlLastInsertId, et tLogRow.
Reliez les trois derniers composants au tFileInputDelimited et entre eux l'aide de liens Row Main, comme
suit :
Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
Dans l'onglet Basic settings, entrez les paramtres de connexion manuellement ou slectionnez-les partir d'une
liste de variables de contexte, si vous les avez stockes localement sous le nud DB connections de la partie
Metadata (Mtadonnes) du Repository. Vous accderez cette liste en cliquant dans le champ renseigner
puis en appuyant sur Ctrl+Espace. Pour plus d'informations sur les Mtadonnes, consultez le Guide utilisateur
du Studio Talend.
Slectionnez le tMysqlCommit en cliquant dessus partir de l'diteur graphique, puis cliquez sur la vue
Component pour en dfinir la configuration de base (Basic settings).
Dans le champ Component list, slectionnez le composant tMysqlConnection appropri si vous effectuez un
Job plusieurs connexions.
Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
Renseignez le chemin d'accs au fichier traiter dans le champ File Name. Dans cet exemple, le nom du fichier
est Customers.
Dans le champ Row separator, dfinissez le sparateur de lignes permettant d'identifier les fins de ligne. De
mme, pour Field separator, dfinissez le sparateur de champs permettant de dlimiter les diffrents champs
pour chaque ligne.
Dfinissez, si ncessaire, le nombre de lignes d'en-tte et de pied-de-page ignorer, ainsi que le nombre
maximum de lignes que vous souhaitez traiter. Dans cet exemple, le fichier comporte une ligne d'en-tte.
Cliquez sur le bouton [...] ct de la mention Edit Schema pour dfinir les donnes passer au composant
suivant.
Dans ce scnario, le schma se compose de deux colonnes, name et age. La premire colonne comprend le nom
des employs et la seconde comporte leurs ges respectifs.
Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
Dans le champ Table, renseignez le nom de la table dans laquelle vous voulez crire la liste des employs. Dans
cet exemple, il s'agit de la table employee.
Slectionnez les actions effectuer dans les champs Action on table et Action on data, partir des listes
proposes. Dans cet exemple, n'effectuez aucune action sur la table elle-mme mais excutez une action Insert
sur les donnes.
Cliquez sur le bouton Sync columns pour synchroniser les colonnes par rapport au composant prcdent. Dans
cet exemple, le schma reproduire dans la table de la base de donnes MySQL se compose des deux colonnes
name et age.
Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
Dans le champ Component list, slectionnez le composant tMysqlConnection appropri si vous effectuez un
Job plusieurs connexions.
Cliquez sur le bouton Sync columns pour synchroniser les colonnes par rapport au composant prcdent. Dans
le schma de sortie du tMysqlLastInsertId, vous pouvez voir la colonne last_insert_id qui indique les dernires
ID ajoutes la connexion existante.
Vous pouvez slectionner le type de donnes Long dans la liste droulante Type, dans le cas de nombreuses entres.
Slectionnez le tLogRow en cliquant dessus partir de l'diteur graphique, puis cliquez sur la vue Component
pour en dfinir la configuration de base (Basic settings). Pour plus d'informations, consultez le tLogRow.
Le composant tMysqlLastInsertId affiche les dernires ID ajoutes pour chaque ligne de la connexion existante.
tMysqlOutput
Proprits du tMysqlOutput
Famille de Databases/MySQL
composant
Fonction Le composant tMysqlOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tMysqlOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux entrant
provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
DB Version Slectionnez la version de MySQL que vous utilisez.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.
Insert or update on duplicate key or unique index : Ajouter des entres si la valeur insre
n'existe pas ou mettre jour les entres si la valeur insre existe dj et qu'un risque de
violation d'une cl unique se prsente.
Insert ignore : Ajouter uniquement de nouvelles lignes afin d'empcher les erreurs de
doublons de cls.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
Cette option est indisponible lorsque la case Use an existing connection est coche.
Advanced Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette
settings parameters option est disponible lorsque la case Use an existing connection est dcoche dans les Basic
settings.
Vous pouvez appuyer sur Ctrl+Espace afin d'accder une liste de variables
globales prdfinies.
Extend Insert Cochez cette case pour insrer un ensemble de lignes dfinies au lieu d'insrer les lignes une
par une. Cette option permet un important gain de performance.
Number of rows per insert : saisissez le nombre de lignes insrer en un bloc. Notez que si
vous slectionnez un nombre important de lignes, cela peut augmenter la quantit de mmoire
utilise et donc diminuer les performances.
Cette option n'est pas compatible avec le lien Reject. Vous devez donc la dcocher
si vous utilisez un lien Reject en sortie du composant.
Use Batch size Cochez cette case afin d'activer le mode batch pour le traitement des donnes. Dans le champ
Batch Size qui apparat, vous pouvez saisir le nombre de lignes par lot charger.
Cette case est disponible uniquement si vous avez choisi l'option Insert, Update,
Single Insert Query ou Delete dans le champ Action on data.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
Additional Columns Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous l'ayez
pralablement supprime ou non). Cette option vous permet d'effectuer des actions sur les
colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui ncessitent
un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les
donnes dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur la
colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant tMysqlOutput
peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur
les donnes.
Use Hint Options Cochez cette case pour activer la zone de configuration des indicateurs (ou Hints) permettant
d'optimiser l'excution d'une requte. Dans cette zone, les paramtres sont :
- HINT : spcifiez l'indicateur dont vous avez besoin, en utilisant la syntaxe /*+ */.
Pour utiliser cette option, vous devez pralablement slectionner le mode Insert
dans la liste Action on data de la vue Basic settings.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job. Cette
fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure mais
se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement dans
lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et
excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide utilisateur
du Studio Talend.
Global NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette variable
Variables est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes
SQL.
Ce composant doit tre utilis en tant que composant de sortie. Il permet de faire des actions sur une table ou les
donnes d'une table d'une base de donnes MySQL. Il permet aussi de crer un flux de rejet avec un lien Row > Reject
filtrant les donnes en erreur. Pour un exemple d'utilisation du tMysqlOutput, consultez Scnario 3 : Rcuprer les
donnes errones l'aide d'un lien Reject.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Cliquez et dposez les composants suivants dans l'diteur graphique : tRowGenerator, tMap et tMysqlOutput.
Dans l'diteur graphique, double-cliquez sur le tRowGenerator pour afficher l'onglet Basic settings.
Cliquez sur le bouton [...] ct du champ Edit schema pour dfinir les donnes transmettre au composant
tMap, dans ce scnario, les deux colonnes name et random_date.
Cliquez sur le bouton [...] ct du champ RowGenerator Editor pour ouvrir l'diteur du tRowGenerator
pour paramtrer les donnes gnrer.
Cliquez dans le champ Functions correspondant et slectionnez une fonction pour chacune des deux colonnes,
getFirstName pour la colonne name et getrandomDate pour la colonne random_date.
Dans le champ Number of Rows for Rowgenerator, saisissez 10 pour ne gnrer que dix lignes de prnoms
et cliquez sur Ok pour fermer l'diteur.
Double-cliquez sur le composant tMap pour ouvrir l'diteur du tMap. L'diteur s'ouvre et affiche les donnes
d'entre du composant tRowGenerator.
Dans le panneau Schema editor de l'diteur du tMap, cliquez sur le bouton [+] de la table de sortie pour ajouter
deux lignes et nommez la premire colonne random_date et la deuxime random_date1.
Dans ce scnario, l'objectif est de dupliquer la colonne random_date et adapter le schma afin de modifier les
donnes transfrer dans le composant de sortie.
Dans l'diteur du tMap, glissez la ligne random_date de la table d'entre vers les lignes random_date et
random_date1 de la table de sortie.
Dans l'diteur graphique, double-cliquez sur le composant tMysqlOutput pour afficher l'onglet Basic settings
et paramtrer ses proprits.
Dans la liste Property Type, slectionnez l'option Repository et cliquez sur le bouton [...] pour ouvrir la bote
de dialogue [Repository content] et slectionnez la connexion la base de donnes adquate. Les informations
de connexion sont renseignes automatiquement.
Configurez les informations de connexion la base de donnes dans les champs correspondants.
Si vous n'avez pas stock de connexion votre base de donnes sous le nud DB connections sous le nud Metadata
du Repository, slectionnez l'option Built-in dans la liste Property Type et renseignez les informations de connexion
manuellement.
Cliquez sur le bouton [...] ct du champ Table et slectionnez la table modifier : la table Dates dans ce
scnario.
Dans la liste Action on table, slectionnez l'option Drop table if exists and create et slectionnez Insert dans
la liste Action on data.
Si ncessaire, cliquez sur Sync columns pour rcuprer le schma de colonnes du composant tMap.
Cliquez sur l'onglet Advanced settings pour afficher la vue correspondante et dfinir les paramtres avancs
du composant.
Dans la zone Additional Columns, paramtrez les modifications appliquer aux colonnes.
Dans ce scnario, la colonne One_month_later remplace la colonne random_date_1 et les donnes aussi
sont modifies l'aide d'une requte SQL ajoutant un mois la date gnre alatoirement dans la colonne
random_date_1. Par exemple : 2007-08-12 devient 2007-09-12.
-Dans la cellule SQL expression, saisissez la requte SQL ajoutant un mois, dans ce scnario :
"adddate(Random_date, interval 1 month)".
La nouvelle colonne One_month_later remplace la colonne random_date1 dans la base de donnes et ajoute un
mois chaque date gnre alatoirement.
Voir galement Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion
ODBC du composant tDBOutput.
A partir de la Palette, cliquez et dposez les composants tFileInputDelimited et tMysqlOutput dans l'diteur
graphique puis connectez-les l'aide d'un lien Row Main.
Dans l'diteur graphique, double-cliquez sur le tFileInputDelimited pour afficher l'onglet Basic settings.
Dans le champ Property Type, slectionnez le mode Repository si vous avez stock les informations du fichier
dlimit sous le nud Metadata du Repository ou slectionnez le mode Built-In pour les dfinir manuellement.
Dans ce scnario, utilisez le mode Built-In.
Dans le champ File Name, renseignez manuellement le chemin d'accs au fichier contenant les mises jour
propager dans la base de donnes ou cliquez sur le bouton [...] pour parcourir vos dossiers jusqu' ce fichier.
Dans cet exemple, utilisez le fichier customer_update, qui comporte quatre colonnes, id, CustomerName,
CustomerAddress et idState.
Dfinissez si ncessaire les sparateurs de lignes (Row separator) et de champs (Field separator), l'en-tte
(Header) et le pied-de-page (Footer), ainsi que le nombre de lignes traiter (Limit). La premire ligne, qui
porte le nom des colonnes, est ignore dans cet exemple, c'est pourquoi le champ Header est dfini "1".
Cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes passer au composant suivant.
Dans cet exemple, le schma est constitu de quatre colonnes, id, CustomerName, CustomerAddress et idState.
Devant le nom de chaque colonne se trouve une case Key. Cochez cette case pour la ou les colonne(s) que vous
voulez dfinir comme cl.
Vous devez obligatoirement dfinir au moins une cl pour que le Job s'excute. Dans le cas contraire, le Job s'arrte
automatiquement et un message d'erreur s'affiche dans la console de log.
Dans l'diteur graphique, double-cliquez sur le composant tMysqlOutput pour paramtrer ses proprits dans
l'onglet Basic settings de la vue Component :
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer
sur le bouton [...] ct du champ Edit schema pour consulter le schma et vrifier qu'au moins une colonne
a t dfinie comme cl.
Dans le champ Property Type, slectionnez Repository si vous avez stock les informations de connexion
la base de donnes sous le nud Metadata du Repository ou slectionnez le mode Built-In, puis renseignez
manuellement les champs suivants : Host, Port, Database, Username et Password.
Dans le champ Action on table, slectionnez l'opration que vous souhaitez effectuer sur la table. Pour ce
scnario, slectionnez Default car la table existe dj.
Dans le champ Action on data, slectionnez l'opration que vous souhaitez effectuer sur les donnes. Pour ce
scnario, slectionnez l'option Update pour mettre la table jour.
A partir de votre explorateur de base de donnes, vous pouvez vrifier que la table customers a bien t mise
jour. Comme avant sa mise jour, elle se prsente sous la forme des quatre colonnes id, CustomerName,
CustomerAddress et idState, mais certains champs ont t modifis selon les donnes du fichier dlimit
customer_update.
Dans le Repository, slectionnez la mtadonne correspondant au fichier client que vous souhaitez
migrer et glissez-la dans l'espace de modlisation. Dans la bote de dialogue [Components], slectionnez
tFileInputDelimited et cliquez sur OK. Les proprits du composant seront automatiquement renseignes.
Si vous n'avez pas enregistr les informations concernant votre fichier client sous le nud Metadata du
Repository. Glissez un composant tFileInputDelimited de la famille File > Input de la Palette et renseignez
ses proprits manuellement dans la vue Component.
A partir de la Palette, glissez un composant tMap de la famille Processing dans l'espace de modlisation.
Si vous n'avez pas enregistr les informations de connexion votre base de donnes sous le nud Db
Connections du Repository, glissez un composant tMysqlOutput de la famille Databases de la Palette et
renseignez ses proprits manuellement dans la vue Component.
A partir de la Palette, slectionnez un composant tFileOutputDelimited de la famille File > Output et glissez-
le dans l'espace de modlisation.
Reliez les composant customers et tMap, et les composants tMap et Localhost l'aide d'un lien de type Row
Main. Vous nommerez ce deuxime lien out.
Reliez le composant Localhost au tFileOutputDelimited l'aide d'un lien de type Row > Reject.
Dans la liste Property Type, slectionnez le mode Repository puis cliquez sur le bouton [...] correspondant
pour slectionner la mtadonne contenant la connexion votre fichier. Sinon, slectionnez le mode Built-in
et paramtrez manuellement les champs suivants.
Cliquez sur le bouton [...] ct du champ File Name, et indiquez le chemin d'accs et le nom du fichier
utiliser.
Dans les champs Row et Field Separator, saisissez entre guillemets les sparateurs de lignes et de champs
utiliss dans le fichier.
Dans les champs Header, Footer et Limit, saisissez le nombre de ligne d'en-tte et de pied-de-page ignorer,
ainsi que le nombre de ligne limite traiter.
Dans la liste Schema, slectionnez Repository et cliquez sur le bouton [...] correspondant pour slectionner le
schma de votre fichier, s'il est stock sous le nud Metadata du Repository. Vous pouvez aussi cliquer sur
le bouton [...] correspondant au champ Edit schema et dfinir manuellement le schma de votre fichier.
Slectionnez les colonnes id, CustomerName, CustomerAddress, idSate, id2, RegTime, RegisterTime de la zone
de gauche et glissez-les dans la table out de la zone de droite.
Dans la zone Schema editor en bas de l'diteur du tMap, dans le tableau droite, changez la longueur de la
colonne CustomerName en 28 afin de crer une erreur. Ainsi, les donnes dont la longueur est suprieure 28
creront des erreurs qui pourront tre rcupres grce au lien Reject.
Dans l'espace de modlisation, double-cliquez sur le composant de sortie Localhost pour afficher la vue
Component correspondante.
Dans la liste Property Type, slectionnez le mode Repository puis cliquez sur le bouton [...] correspondant pour
slectionner la mtadonne de connexion la base de donnes. Les informations de connexion sont renseignes
automatiquement. Sinon, slectionnez le mode Built-in et paramtrez ces champs manuellement.
Dans le champ Table, saisissez le nom de la table crer. Dans ce scnario, vous l'appelez customers_data.
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent.
Assurez-vous que la case Die on error est bien dcoche, afin que le Job s'excute malgr l'erreur que vous
venez de crer.
Cliquez sur l'onglet Advanced settings de la vue Component pour paramtrer les paramtres avancs du
composant.
Dcochez la case Extend Insert permettant d'insrer des lignes par bloc car cette option n'est pas compatible
avec le lien Reject.
Double-cliquez sur le composant tFileOutputDelimited pour paramtrer ses proprits dans la vue
Component.
Cliquez sur le bouton [...] ct du champ File Name pour indiquer le rpertoire de destination et le nom du
fichier de sortie.
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent.
Les donnes en erreur sont envoyes dans le fichier dlimit, ainsi que le type d'erreur rencontre. Ici, vous avez
affaire des donnes tronques : Data truncation.
tMysqlOutputBulk
Proprits du tMysqlOutputBulk
Les composants tMysqlOutputBulk et tMysqlBulkExec sont gnralement utiliss ensemble pour d'une part
gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tMysqlOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le chargement des donnes dans la base de donnes.
Famille de composant Databases/MySQL
Fonction Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards MySQL.
Objectif Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base
de donnes MySQL.
Basic settings Property type Peut tre Built-in ou Repository.
Ce fichier est gnr sur la mme machine que le Studio Talend ou que
le Job contenant un tMysqlOutputBulk.
Append Cochez cette option pour ajouter des nouvelles lignes la fin du fichier.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs
qui sont traits et passs au composant suivant. Le schma est soit local
(Built-in), soit distant dans le Repository.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont
des entiers (integer) ou des fonctions (function), assurez-vous que les
valeurs par dfaut ne sont pas entoures de guillemets. Si c'est le cas,
vous devez supprimer manuellement les guillemets.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec le composant tMysqlBulkExec. Ensemble, ils offrent
un gain de performance important pour l'alimentation d'une base de donnes MySQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont
pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton
Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter
dans l'onglet Modules de la perspective Integration de votre studio. Pour plus d'informations,
consultez la page https://help.talend.com/display/KB/How+to+install+external+modules+in+the
+Talend+products (en anglais) ou la section dcrivant comment configurer le studio, dans le Guide
d'installation et de migration Talend.
le fichier paramtres qui sera utilis dans un second temps. La premire tape inclut une phase de transformation
des donnes contenues dans le fichier.
2. Dfinissez le schma des lignes gnrer et la nature des donnes gnrer. Dans cet exemple, le fichier
clients crer contient les colonnes suivantes : ID, First Name, Last name, Address, City qui sont toutes de
type chane de caractres (string) l'exception de l'ID qui est de type entier (integer).
Certaines informations du schma n'ont pas ncessairement besoin d'tre affiches. Pour les dissimuler,
cliquez sur le bouton Columns dans la barre d'outils et dcochez les colonnes cacher, par exemple :
Precision ou Parameters.
Utilisez le bouton [+] pour ajouter autant de colonnes que possible votre schma.
Cliquez sur le bouton Refresh en haut droite de l'diteur pour visualiser un aperu des lignes gnres en
sortie dans l'onglet Preview en bas de l'diteur.
3. Dans l'espace de modlisation, double-cliquez sur le composant tMap pour ouvrir son diteur et paramtrer
la transformation.
4. Faites glisser toutes les colonnes de la table d'entre (row1) vers la table de sortie (clients).
5. Appliquez la transformation sur la colonne LastName en ajoutant .toUpperCase() la fin. Cela mettra les
noms des clients en majuscule.
6. Dans l'espace de modlisation, double-cliquez sur le composant tMysqlOutputBulk pour afficher sa vue
Component et paramtrer ses proprits.
7. Dfinissez le chemin d'accs et le nom du fichier produire dans le champ File Name. Si les proprits
du fichier dlimit sont conserves dans le Repository, slectionnez l'entre correspondante dans le champ
Property type afin de les rcuprer. Dans cet exemple, le nom de fichier est clients.txt.
Le schma est propag partir du composant tMap, si vous cliquez sur Yes lorsque la bote de dialogue vous
demande de confirmer la propagation. Sinon, cliquez sur le bouton Sync columns pour rcuprer le schma.
8. Dans cet exemple, n'incluez pas les informations d'en-tte, puisque la table doit dj les contenir.
10. Double-cliquez sur le composant tMysqlBulkExec pour paramtrer la requte INSERT excuter.
11. Paramtrez les informations de connexion. Il est recommand de stocker ce type d'informations dans le
Repository, afin de pouvoir les rcuprer tout moment pour tout Job.
12. Dans le champ Table, saisissez le nom de la table alimenter, ici, clients.
13. Dans l'onglet Advanced settings, saisissez le sparateur de colonnes, dans le champ Fields terminated by.
14. Vrifiez que l'encodage dfini dans le champ Encoding correspond celui de vos donnes.
2. Appuyez sur F6 ou cliquez sur le bouton Run de la vue Run pour excuter le Job.
La table de la base clients est alimente avec les donnes du fichier notamment les donnes transformes dans
la colonne Last name.
Pour une simple opration d'Insert ne ncessitant pas de transformation, l'utilisation du composant
tMysqlOutputBulkExec permet d'conomiser une tape dans le processus et ainsi de gagner en performance.
tMysqlOutputBulkExec
Proprits du tMysqlOutputBulkExec
Les composants tMysqlOutputBulk et tMysqlBulkExec sont gnralement utiliss ensemble comme deux
parties d'un processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime
tape, ce fichier est utilis lors de l'opration d'INSERT afin de peupler une base de donnes. Cette excution en
deux tapes est unifie dans le composant tMysqlOutputBulkExec.
Famille de composant Databases/MySQL
Fonction Le tMysqlOutputBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tMysqlOutputBulkExec est un composant ddi qui permet un gain de performance pendant
les oprations d'Insert dans une base de donnes MySQL.
Basic settings Property type Peut tre Built-in ou Repository.
Drop and create table : supprime la table puis en crer une nouvelle.
Une seule table peut tre crite la fois et cette table doit
dj exister pour que l'opration d'Insert soit autorise.
Local FileName Nom du fichier gnrer et traiter.
Records contain NULL Cette case est coche par dfaut. Elle permet de prendre les champs
value de valeur NULL en compte. Si vous la dcochez, les valeurs NULL
seront remplaces par des valeurs vides.
Encoding Slectionnez l'encodage partir de la liste ou slectionnez Custom
et dfinissez-le manuellement. Ce champ est obligatoire pour la
manipulation des donnes de base de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant est principalement utilis lorsqu'aucune transformation particulire n'est requise sur
les donnes charger dans la base de donnes.
Paramtrez le tRowGenerator de la mme manire que dans Scnario : Insrer des donnes transformes
dans une base MySQL. Le schma est constitu de plusieurs colonnes notamment : ID, First Name, Last Name,
Address et City.
Paramtrez la connexion la base de donnes si ncessaire, en suivant les recommandations dans Scnario :
Insrer des donnes transformes dans une base MySQL, concernant la conservation des informations de
connexion dans la partie Metadata du Repository. Pour cela, slectionnez Repository dans le champ Property
Type et slectionnez la connexion adquate dans le champ adjacent. Les champs suivants seront renseigns
automatiquement.
Dans le champ Action on table, slectionnez l'option None puisque vous souhaitez insrer les donnes dans
une table dj existante.
Dans le champ Local filename, indiquez le chemin d'accs et le nom du fichier contenant les donnes charger
dans la table, ici, clients.txt.
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent.
Cliquez sur l'onglet Advanced settings pour paramtrer les proprits avances du composant.
Dans la liste Action on data, slectionnez l'option Insert records in table pour insrer ces nouvelles donnes
dans la table.
Le rsultat devrait tre relativement identique celui obtenu dans Scnario : Insrer des donnes transformes
dans une base MySQL. Cependant les donnes elles-mmes peuvent diffrer lgrement puisque les donnes sont
regnres de faon alatoire chaque excution.
tMysqlRollback
Proprits du tMysqlRollback
Famille de composant Databases/MySQL
Fonction Le tMysqlRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant tMysqlConnection dans la liste s'il y a
plus d'une connexion dans votre Job.
Close connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants MySQL, notamment les
composants tMysqlConnection et tMysqlCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
tMysqlRow
Proprits du tMysqlRow
Famille de Databases/MySQL
composant
Fonction Le tMysqlRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares
sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job
bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tMysqlRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants
sont alors pr-remplis l'aide des donnes collectes.
DB Version Slectionnez la version de MySQL que vous utilisez.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query
est renseign automatiquement.
Guess Query Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma
de votre table dans le champ Query.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin
qu'ils correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case
pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur.
Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un
lien Row > Rejects.
Specify a data source Cochez cette case et spcifiez l'alias de la source de donnes cre dans Talend Runtime
alias pour utiliser le pool de connexions partages dfini dans la configuration des donnes
source. Cette option fonctionne lorsque vous dployez et excutez votre Job dans Talend
Runtime.
Cette option est indisponible lorsque la case Use an existing connection est coche.
Advanced settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes cre.
parameters Cette option est disponible lorsque la case Use an existing connection est dcoche dans
les Basic settings.
Propagate QUERY's Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en
recordset cours. Slectionnez cette colonne dans la liste use column.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte.
Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une
meilleure performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die
on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de
requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
2. Dans les champs Property type et Schema, slectionnez la base de donnes approprie dans la liste.
Les dtails de connexion la base de donnes ainsi que le schma de la table sont renseigns automatiquement.
La requte tant conserve dans les Metadata du Repository, vous pouvez galement slectionner
Repository dans le champ Query type et cliquer sur la requte correspondante.
4. Si vous ne conservez pas vos requtes dans le Repository, saisissez la dclaration SQL suivante : drop index
<index_name> on <table_name>
6. Puis saisissez la dclaration SQL permettant de recrer un index l'aide de la formulation suivante : create
index <index_name> on <table_name> (<column_name>);
Le composant tRowGenerator permet de gnrer automatiquement les colonnes ajouter la table de sortie
dfinie.
8. Le schma est automatiquement hrit du flux de donnes du tLogRow. Editez le schma et vrifiez que sa
structure correspond au schma attendu par la table de base de donnes spcifie.
Dans le champ Action on table, slectionnez None et dans le champ Action on data, slectionnez Insert.
Excuter le Job
1. Appuyez sur les touches Ctrl+S pour sauvegardez le Job.
Si vous avez la possibilit d'observer l'action sur la base de donnes, remarquez que l'index a t supprim
en dbut de Job puis recr la fin de l'action d'Insert.
Pour ce scnario, utilisez un fichier et une base de donnes dont vous avez pralablement stock la connexion
et les proprits dans des mtadonnes dans le Repository. Pour plus d'informations concernant la cration de
mtadonnes de fichiers dlimits, la cration de mtadonnes de connexion une base de donnes et l'utilisation
de ces mtadonnes, consultez le Guide utilisateur du Studio Talend.
Slectionnez la mtadonne correspondant au fichier clients que vous souhaitez utiliser dans ce Job. Ici, vous
utilisez la mtadonne customers.
Glissez cette mtadonne dans l'espace de modlisation et double-cliquez sur tFileInputDelimited dans la bote
de dialogue [Components] afin de crer un composant tFileInputDelimited dj paramtr.
Dans la liste Schema, slectionnez Built-in afin de modifier le schma de votre composant. Puis, cliquez sur
le bouton [...] ct du champ Edit schema pour ajouter la colonne dans laquelle insrer le nom de l'Etat.
Cliquez sur le bouton [+] pour ajouter une colonne au schma. Renommez cette colonne LabelStateRecordSet,
et elle est de type objet, donc slectionnez Object dans la liste Type. Cliquez sur OK pour enregistrer vos
modifications.
Reliez les quatre composants via des liens de type Row > Main.
Double-cliquez sur le composant tMysqlRow pour paramtrer ses proprits dans l'onglet Basic settings de
la vue Component.
Dans la liste Property Type, slectionnez Repository et cliquez sur le bouton [...] pour slectionner la
connexion la base de donnes centralise dans les mtadonnes du Repository. Les champs DB Version,
Host, Port, Database, Username et Password sont renseigns automatiquement. Si vous tes en mode Built-
in, renseignez ces champs manuellement.
Dans la liste Schema, slectionnez Built-in pour paramtrer le schma manuellement et ajouter la colonne
LabelStateRecordSet, ou cliquez directement sur le bouton Sync columns pour rcuprer le schma du
composant prcdent.
Dans le champ Query, saisissez la requte SQL utiliser. Ici, vous souhaitez rcuprer les noms des Etats
amricains contenus dans la colonne LabelState de la table MySQL us_state : "SELECT LabelState FROM
us_state WHERE idState=?". Le point d'interrogation "?" reprsente le paramtre dfinir dans l'onglet
Advanced settings.
Cliquez sur l'onglet Advanced settings pour paramtrer les proprits avances du composant.
Cochez la case Propagate QUERY's recordset et slectionnez la colonne LabelStateRecordSet dans la liste
use column pour insrer le rsultat de la requte dans cette colonne.
Cochez la case Use PreparedStatement et dfinissez le paramtre utilis dans la requte dans le tableau Set
PreparedStatement Parameters.
Dans la cellule Parameter Index, saisissez la position du paramtre dans l'instruction SQL. Saisissez "1" tant
donn que vous n'utilisez qu'un seul paramtre dans l'exemple.
Dans la cellule Parameter Type, saisissez le type du paramtre. Ici, le paramtre est de type entier, donc
slectionnez Int dans la liste.
Dans la cellule Parameter Value, saisissez la valeur du paramtre. Ici, vous souhaitez rcuprer le nom de
l'Etat en fonction de leur ID pour chaque client du fichier d'entre, saisissez donc "row1.idState".
Double-cliquez sur le composant tParseRecordSet pour paramtrer ses proprits dans l'onglet Basic settings
de la vue Component.
Dans la liste Prev. Comp. Column list, slectionnez la colonne du composant prcdent analyser. Dans cet
exemple, slectionnez la colonne LabelStateRecordSet.
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent et le tableau Attribute
table est automatiquement renseign avec les colonnes du schma.
Dans le tableau Attribute table, dans le champ Value correspondant la colonne LabelStateRecordSet,
saisissez entre guillemets le nom de la colonne contenant le nom des Etats rcuprer et mettre en
correspondance avec chaque client. Dans cet exemple, saisissez "LabelState".
Double-cliquez sur le composant tFileOutputDelimited pour paramtrer ses proprits dans l'onglet Basic
settings de la vue Component.
Dans le champ File Name, renseignez le chemin d'accs et le nom du fichier de sortie.
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent.
Une colonne contenant le nom de l'Etat amricain correspondant chaque client a t ajoute au fichier.
2. Slectionnez l'option Use Inline Content (delimited file) dans la zone Mode.
1;30
2;20
3. Double-cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir l'diteur du schma.
Cliquez sur le bouton [+] pour ajouter deux colonnes, nommes id et age, de type Integer.
Dans le champ Query, saisissez la requte SQL permettant de rcuprer les donnes de id et name dans la
table MySQL employee : "select id, name from employee WHERE id=?".
6. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir l'diteur du schma.
7. Cliquez sur le bouton [+] pour ajouter deux colonnes, droite, nommes recordset et age, de type Object
et Integer. Notez que recordset doit contenir les rsultats de la requte de la table MySQL, c'est--dire les
champs id et name.
8. Cliquez sur l'onglet Advanced settings afin de configurer les paramtres avancs.
9. Cochez la case Propagate QUERY's recordset et slectionnez recordset dans la liste use column afin
d'insrer les rsultats de la requte dans cette colonne.
Cochez la case Use PreparedStatement et dfinissez les paramtres utiliss dans la requte, dans la table
Set PreparedStatement Parameters.
Dans la cellule Parameter Index, saisissez la position du paramtre dans l'instruction SQL. Saisissez "1"
puisque vous utilisez un paramtre dans cet exemple.
Dans la cellule Parameter Type, saisissez le type de paramtre. Le paramtre est de type Integer.
Slectionnez Int dans la liste.
Dans la cellule Parameter Value, saisissez la valeur du paramtre. Ici, vous allez rcuprer les colonnes id
et name de la table employee selon la valeur de id du flux source. Saisissez row3.id.
11. Double-cliquez sur le composant tParseRecordSet pour ouvrir sa vue Basic settings.
Dans la liste Prev. Comp. Column list, slectionnez la colonne analyser, recordset.
12. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir l'diteur du schma.
Cliquez trois fois sur le bouton [+] pour ajouter trois colonnes, droite, nommes id, name et age,
respectivement de type Integer, String et Integer. Les colonnes id et name doivent contenir les donnes
analyses de recordset.
Dans la table Attribute table, dans les champs Value correspondants aux colonnes id et name, saisissez le
nom des colonnes de la table MySQL rcuprer, "id" et "name".
Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un affichage sous forme de
tableau.
Excuter le Job
1. Appuyez sur les touches Ctrl+S pour sauvegarder votre Job.
tMysqlSCD
Le composant tMysqlSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus
d'informations, consultez tMysqlSCD.
tMysqlSCDELT
Le composant tMysqlSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tMysqlSCDELT.
tMysqlSP
Proprits du tMysqlSP
Familles de composant Databases/Mysql
Fonction Le composant tMysqlSP appelle une procdure stocke de base de donnes.
Objectif Le tMysqlSP permet de centraliser des requtes multiples ou complexes dans une base de donnes
et de les appeler plus facilement.
Basic settings Property type Peut tre Built-in ou Repository.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant intermdiaire. Il peut galement tre utilis comme composant de
dbut. Dans ce cas, seuls les paramtres d'entre sont autoriss.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.
Cliquez et dposez les composants suivants dans l'espace de modlisation : tRowGenerator, tMysqlSP et
tLogRow.
Le tRowGenerator est utilis pour gnrer des ID impairs. Double-cliquez sur le composant pour lancer
l'diteur.
Cliquez sur le bouton [+] pour ajouter une colonne au schma gnrer.
Cochez la case Key pour dfinir l'entre comme tant une cl primaire et dfinissez le Type en Int (entier).
Utilisez la fonction prtablie appele sequence mais modifiez les paramtres dans la partie infrieure de la
fentre.
Modifiez la valeur (Value) de step : de 1 2 pour cet exemple. Mais la valeur de dpart (start value) reste 1.
Dans le champ Number of generated rows, dfinissez le nombre de lignes gnrer 25, afin que tous les
ID impairs de State (il y a 50 Etats) soient gnrs.
Dans le champ Property type, slectionnez l'option Repository puis slectionnez l'entre correspondante dans
la liste. Les informations de connexion sont remplies automatiquement.
Cliquez sur Sync Column pour rcuprer le schma gnr du composant prcdent.
Puis cliquez sur Edit Schema et ajoutez une colonne supplmentaire contenant les libells des Etats (State)
obtenir en sortie, en plus de l'ID.
Dans le champ SP Name, saisissez le nom de la procdure comme il a t dfini dans la base de donnes (ici,
getstate). La procdure excuter correspond :
DROP PROCEDURE
IF EXISTS `talend`.`getstate` $$
CREATE DEFINER=`root`@`localhost` PROCEDURE `getstate`(IN pid INT, OUT
pstate VARCHAR(50))
BEGIN
SELECT LabelState INTO pstate FROM us_states WHERE idState = pid;
END $$
Dans la zone Parameters, cliquez sur le bouton [+] pour ajouter une ligne la table.
Dfinissez le champ Column en ID, et le champ Type en IN, ainsi il sera considr comme paramtre d'entre
dans la procdure.
Ajoutez une deuxime ligne et dfinissez le champ Column en State et le champ Type en Out, ainsi il sera
considr comme le paramtre de sortie a retourne.
Synchronisez le schma avec celui du composant prcdent en cliquant sur le bouton Sync columns.
Et cochez la case Print values in cells of a table pour un meilleur confort de lecture.
La sortie affiche les diffrents Etats (State) avec leur ID impair comme dfini dans la procdure.
Consultez galement Scnario 1 : Insrer des donnes dans des tables mre/fille si vous voulez analyser un
ensemble d'enregistrements d'une table de donnes ou d'une requte SQL.
Scnarios associs
Pour des scnarios associs, consultez :
tMysqlTableList
Proprits du tMysqlTableList
Famille de composant Databases/MySQL
Fonction Le composant tMysqlTableList effectue une opration d'itration sur toutes les tables d'une base
de donnes, grce une connexion MySQL dfinie.
Objectif Le composant tMysqlTableList permet de lister les noms des tables MySQL grce aux commandes
SELECT et WHERE.
Basic settings Component list Slectionnez le composant tMysqlConnection dans la liste si vous
prvoyez d'ajouter plus d'une connexion votre Job en cours.
Where clause for table name Saisissez la commande WHERE permettant d'identifier les tables sur
selection lesquelles effectuer l'opration d'itration.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables CURRENT_TABLE : nom de la table sur laquelle se fait l'itration. Cette variable est une variable
Flow et retourne une chane de caractres.
NB_TABLE : nombre de tables itres jusqu' prsent. Cette variable est une variable Flow et
retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Vous pouvez utiliser ce composant en association avec les autres composants MySQL, notamment
avec le tMysqlConnection.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Pour une utilisation avance, commencez par crer une connexion la base de donnes qui contient les tables que
vous voulez vider de leur contenu.
Dans la vue en arborescence du Repository, dveloppez le nud Metadata puis cliquez-droit sur DB
Connections pour crer une connexion la base de donnes de travail et stocker les informations de connexion
en local.
Pour plus d'informations sur les mtadonnes (metadata), consultez le Guide utilisateur du Studio Talend.
Sinon, dposez un composant tMysqlConnection dans l'diteur graphique et renseignez les paramtres de
connexion manuellement.
A partir du Repository, dposez dans l'diteur graphique la connexion que vous venez de crer.
Le composant tMysqlConnection apparait alors dans l'diteur graphique et les paramtres de connexion,
accessibles depuis la vue Basic settings, sont automatiquement renseigns.
A partir de la Palette, cliquez-dposez les composants tMysqlTableList et tELT dans l'diteur graphique.
Reliez les composants tMysqlConnection et tMysqlTableList l'aide d'un lien Trigger de type OnSubjobOk.
Reliez les composants tMysqlTableList et tELT l'aide d'un lien de type Iterate.
Double-cliquez sur le tMysqlConnection pour afficher la vue Basic settings du composant si vous voulez en
vrifier les paramtres de connexion.
Dans cet exemple, connectez-vous une base de donnes MySQL appele examples.
Dans l'diteur graphique, double-cliquez sur le composant tMysqlTableList pour en afficher les paramtres de
base et les dfinir (vue Basic settings).
Slectionnez la connexion MySQL approprie partir de la liste droulante Component list, dans le cas o
vous utilisez plus d'une connexion.
Renseignez la clause de type WHERE dans le champ appropri, en veillant utiliser la bonne syntaxe, pour
effectuer une itration sur la ou les tables dont vous voulez effacer le contenu.
Dans ce scnario, oprez l'itration sur toutes les tables dont le nom commence par "ex".
Dans l'diteur graphique, double-cliquez sur le composant tELT pour en afficher les paramtres de base et les
dfinir (vue Basic settings).
Dans le champ Database Name, renseignez le nom de la base de donnes o se trouvent les tables sur lesquelles
vous voulez travailler.
Slectionnez la connexion MySQL approprie partir de la liste droulante Component list, dans le cas o
vous utilisez plus d'une connexion.
Cliquez dans le champ Table name et appuyez sur Ctrl+Espace pour atteindre la liste gnrale des variables.
Dans la vue en arborescence du Repository, dveloppez successivement les nuds SQL Templates et MySQL.
Cliquez-droit sur le nud UserDefined et slectionnez l'option Create SQLTemplate partir de la liste.
Saisissez un nom pour le nouveau modle (SQL template) et remplissez les autres champs si ncessaire, puis
cliquez sur Finish pour fermer l'assistant.
Supprimez le code existant et saisissez le code permettant d'excuter l'action voulue, c'est--dire, ici, effacer le
contenu de toutes les tables dont les noms commencent par "ex".
Dans un code SQL template, il est impratif d'utiliser le nom exact de la variable, en association avec le paramtre dsignant
le nom de la table ("__TABLE-NAME__" dans cet exemple). Pour afficher le nom de la variable utilise, positionnez votre
curseur sur le champ Table Name de la vue Basic settings du composant tELT.
Appuyez sur Ctrl+S pour sauvegarder le nouveau modle que vous venez de dfinir.
La prochaine tape consiste ajouter ce nouveau modle SQL template la liste de modles du mme type dans
le composant tELT.
Comment ajouter votre propre modle SQL la liste de modles du mme type :
Dans la vue Component du composant tELT, cliquez sur l'onglet SQL Templates pour afficher la liste de
modles SQLTemplate List.
Cliquez sur le bouton Add et ajoutez deux lignes de modles SQL template.
Cliquez sur la premire ligne pour afficher un menu droulante puis cliquez sur la flche de ce menu pour
drouler la liste des modles.
Dans la liste, slectionnez le modle SQL template que vous venez de crer.
Toutes les tables de la base de donnes MySQL examples dont le nom commence par "ex" sont alors vides de
leur contenu.
Scnario associ
Pour un scnario associ, consultez Scnario : Itrer une table de base de donnes et lister le nom des colonnes
de la table.
tOleDbInput
Proprits du tOleDbInput
Famille de composant Databases/OleDb
Fonction Ce composant lit une base de donnes et en extrait des champs l'aide de requtes. Il offre la flexibilit
de la requte en base de donnes et couvre toutes les possibilits de requte SQL.
Objectif Le tMysqlInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui
dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une
connexion de flux (Main row).
Basic settings Connection URL Renseignez la chane de connexion utilise pour ouvrir la base de
donnes. Pour plus de dtails, consultez http://msdn.microsoft.com/fr-fr/
library/system.data.oledb.oledbconnection.connectionstring.aspx.
Schema and Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (Built-in),
soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi,
il peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de
SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ
Query est renseign automatiquement.
Guess Query Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au
schma de la table dfinie dans le champ Query.
Guess schema Cliquez sur le bouton Guess schema pour rcuprer le schma de la table.
Query Spcifiez la requte de base de donnes en faisant attention ce que l'ordre des
champs corresponde celui dfini dans le schma.
Advanced settings Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans
columns toutes les colonnes contenant des chanes de caractres.
Trim column Cochez cette case dans la colonne Trim pour supprimer les espaces en dbut
et en fin de champ dans les colonnes correspondantes.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis en tant que composant d'entre d'un Job et ncessite un lien de sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario similaire, consultez le tMysqlInput.
tOleDbOutput
Proprits du tOleDbOutput
Famille de composant Databases/OleDb
Fonction Ce composant crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Ce composant excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Database Renseignez la chane de connexion utilise pour ouvrir la base de
donnes. Pour plus de dtails, consultez http://msdn.microsoft.com/fr-fr/
library/system.data.oledb.oledbconnection.connectionstring.aspx.
Table Spcifiez le nom de la table crer. Vous ne pouvez crer qu'une seule table
la fois.
Action on data Dans la liste droulante, slectionnez parmi les oprations suivantes celle que
vous souhaitez effectuer sur les donnes.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi,
il peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Cette option n'est pas disponible si vous venez de crer la table de base de
donnes (mme si vous la supprimez avant).
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs
actions sur les donnes.
Field options Cochez cette ou ces case(s) dans la table si vous souhaitez utiliser la ou les
colonne(s) de schma correspondantes en tant que base pour votre opration.
Ce champ apparat uniquement lorsque la case Use field options est coche.
Enable debug mode Cochez cette case pour afficher chaque tape du processus d'criture dans la
base de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne
un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un
entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne
un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne
un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est normalement utilis en tant que composant de sortie d'un Job et ncessite un lien d'entre.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario similaire, consultez le tMysqlOutput.
tOleDbRow
Proprits du tOleDbRow
Famille de composant Databases/OleDb
Fonction tOleDbRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares
sur la base de donnes spcifie.
Objectif Selon la nature de la requte et de la base de donnes, le tOleDbRow agit sur la structure mme de la base
de donnes ou sur les donnes.
Basic settings Database Saisissez la chane de caractres permettant d'ouvrir la base de donnes. Pour
plus d'informations, consultez la page http://msdn.microsoft.com/fr-fr/library/
system.data.oledb.oledbconnection.connectionstring.aspx.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui sont
traits et passs au composant suivant. Le schma est soit local (Built-in), soit
distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il
peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de
SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ
Query est renseign automatiquement.
Guess Query Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au
schma de votre table dans le champ Query.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs
afin qu'ils correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette
case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes
en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour
cela, utilisez un lien Row > Rejects.
Advanced settings Propagate QUERY's Cochez cette case pour insrer les rsultats de la requte dans une colonne du
recordset flux en cours. Slectionnez cette colonne dans la liste use column.
Cette option est trs utile si vous devez effectuer de nombreuses fois
la mme requte. Elle permet un gain de performance.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues
dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes
ayant la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de
requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario similaire, consultez tMysqlRow.
tOracleBulkExec
Proprits du tOracleBulkExec
Les composants tOracleOutputBulk et tOracleBulkExec sont gnralement utiliss ensemble pour d'une part
gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tOracleOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le changement des donnes dans la base de donnes.
Famille de Databases/Oracle
composant
Fonction Le composant tOracleBulkExec insre, ajoute, remplace ou supprime les donnes d'une base de donnes Oracle.
Objectif Le tOracleBulkExec est un composant ddi, il permet un gain de performance lors du traitement des donnes de
la base de donnes Oracle.
Basic Property type Peut tre Built-in ou Repository.
settings
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Oracle OCI : Slectionnez ce type de connexion pour utiliser l'interface d'appel de la base
de donnes Oracle ( Oracle Call Interface) accompagne d'un ensemble de logiciels API de
langage C qui fournissent une interface cette base de donnes Oracle.
Oracle Service Name : Slectionnez ce type de connexion pour utiliser l'alias TNS que
vous fournissez lorsque vous vous connectez la base de donnes distante.
Oracle SID : Slectionnez ce type de connexion pour identifier exclusivement une base de
donnes spcifique sur un systme.
Oracle Custom : Slectionnez ce type de connexion pour accder une base de donnes
contenant des clusters.
DB Version Slectionnez la version d'Oracle que vous utilisez.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans
la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis
cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Ce fichier doit tre situ sur la mme machine que le serveur de base de donnes.
Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne :
Insert : Insrer des lignes dans une table vide. Le Job s'arrte en cas de doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures
de guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
EOF (used for loading LOBs from lobfile) : la sparation est constitue d'un caractre de
fin de fichier (End Of File).
Other terminator : la sparation est constitue d'un caractre autre que ceux prcdemment
noncs.
Use fields enclosure Cochez cette case si vous voulez utiliser des caractres pour entourer le texte :
Fields enclosure (left part) : caractre dlimitant les champs sur la gauche.
Field enclosure (right part) : caractre dlimitant les champs sur la droite.
Use schema's Date Cochez cette case pour utiliser le modle de date contenu dans le schma pour remplir le
Pattern to load Date champ concernant la date.
field
Specify field condition Cochez cette case pour dfinir une condition de chargement des donnes.
Preserve blanks Cochez cette case pour conserver les espaces vides.
Trailing null columns Cochez cette case pour charger des donnes avec des colonnes vides.
Load options Cliquez sur le bouton [+] afin d'ajouter des options de chargement des donnes :
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide utilisateur
du Studio Talend.
Global NB_LINE_DATA : nombre de lignes lues. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_BAD : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
RETURN_CODE : code retour indiquant le rsultat du traitement. Cette variable est une variable After et retourne
un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est une
variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on error est
dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour accder
la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant ddi offre performance et flexibilit lors de requtes sur les bases de donnes Oracle.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Le serveur/client de la base de donnes doit tre install sur la mme machine que le Studio Talend ou que le Job
contenant un tOracleBulkExec afin que le composant fonctionne correctement.
Construire le Job
1. Cliquez et dposez les composants suivants de la Palette dans l'espace de modlisation graphique :
tOracleInput, tFileOutputDelimited et tOracleBulkExec.
2. Connectez le composant tOracleInput au tFileOutputDelimited l'aide d'un lien Row > Main.
2. Paramtrez le schma, s'il n'est pas conserv dans le Repository. Dans cet exemple, le schma contient les
quatre colonnes suivantes : ID_Contract, ID_Client, Contract_type et Contract_Value.
3. Dans la liste Encoding, slectionnez l'option Custom et dfinissez AL32UTF8 comme encodage.
4. Dans la vue Basic settings du composant tFileOutputDelimited, paramtrez ses proprits, notamment les
champs File Name, Row separator et Field separator avec respectivement le chemin d'accs et le nom du
fichier, le sparateur de lignes et de champs.
5. Double-cliquez ensuite sur le composant tOracleBulkExec pour dfinir les proprits d'alimentation de la
base de donnes.
6. Dans la liste Property Type, slectionnez le mode Repository si vous avez stock les informations de
connexion la base de donnes sous le nud Metadata du Repository ou slectionnez le mode Built-In
pour les dfinir manuellement. Dans ce scnario, utilisez le mode Built-In.
7. Configurez si ncessaire les paramtres de connexion dans les champs Host, Port, Database, Schema,
Username et Password.
8. Dans le champ Table, renseignez le nom de la table alimenter et dans le champ Action on data, slectionnez
l'action effectuer, ici, Insert.
9. Dans la liste Schema, slectionnez le mode Built-In puis cliquez sur le bouton [...] ct du champ Edit
Schema pour dfinir les donnes passer au composant suivant.
10. Cliquez sur l'onglet Advanced settings pour configurer les paramtres avancs du composant.
11. Cochez la case Use an existing control file si vous avez stock les informations relatives l'tat de la
base de donnes dans un fichier de contrle (.ctl). Sinon, renseignez, si ncessaire, les champs suivants
manuellement : Record format, Specify .ctl file's INTO TABLE clause manually, Field terminated by,
Use field enclosure, Use schema's Date Pattern to load Date field, Specify field condition, Preserve
blanks, Trailing null columns, Load options, NLS Language et Set Parameter NLS_TERRITORY en
fonction de votre base de donnes.
12. Dans la liste Encoding, slectionnez le type d'encodage ou saisissez-le entre guillemets doubles s'il n'est pas
dans la liste.
13. Dans la liste Output, slectionnez l'option to console, pour afficher la sortie standard de la base dans la
console.
Excuter le Job
1. Appuyez sur les touches Ctrl+S pour sauvegarder votre Job.
2. Appuyez sur F6 pour excuter le Job. Le log s'affiche dans la console de la vue Run et la table est alimente
par les donnes du fichier paramtr.
Voir galement : Scnario : Insrer des donnes dans une base MySQL.
tOracleClose
Proprits du tOracleClose
Famille de composant Databases/Oracle
Fonction Le composant tOracleClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes Oracle.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tOracleConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Oracle, notamment
tOracleConnection et tOracleCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tOracleConnection et tOracleRollback. Il est gnralement
utilis avec un composant tOracleConnection car il permet de fermer une connexion pour la transaction en cours.
tOracleCommit
Proprits du tOracleCommit
Famille de composant Databases/Oracle
Fonction Le composant tOracleCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tOracleConnection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants Oracle et notamment
tOracleConnection et tOracleRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tOracleCommit, consultez Scnario 1 : Insrer des donnes dans des
tables mre/fille.
tOracleConnection
Proprits du tOracleConnection
Famille de composant Databases/Oracle
Fonction Le composant tOracleConnection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tOracleConnection, consultez tMysqlConnection.
tOracleInput
Proprits du tOracleInput
Famille de Databases/
composant Oracle
Fonction Le composant tOracleInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tOracleInput excute une requte de base de donnes dans laquelle l'ordre doit strictement correspondre
l'ordre dfini dans le schma. Puis la liste des champs est transmise au composant via une connexion Main Row.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionne le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de donnes
et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du
composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Oracle OCI : Slectionnez ce type de connexion pour utiliser l'interface d'appel de la base de
donnes Oracle ( Oracle Call Interface) accompagne d'un ensemble de logiciels API de langage
C qui fournissent une interface cette base de donnes Oracle.
Oracle Service Name : Slectionnez ce type de connexion pour utiliser l'alias TNS que vous
fournissez lorsque vous vous connectez la base de donnes distante.
Oracle SID : Slectionnez ce type de connexion pour identifier exclusivement une base de
donnes spcifique sur un systme.
Oracle Custom : Slectionnez ce type de connexion pour accder une base de donnes
contenant des clusters.
DB Version Slectionnez la version d'Oracle que vous utilisez.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Table name Nom de la table de base de donnes.
Query type et Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des champs
Query corresponde celui dfini dans le schma.
Specify a data Cochez cette case et spcifiez l'alias de la source de donnes cre dans Talend Runtime pour
source alias utiliser le pool de connexions partages dfini dans la configuration des donnes source. Cette
option fonctionne lorsque vous dployez et excutez votre Job dans Talend Runtime.
Cette option est indisponible lorsque la case Use an existing connection est coche.
Advanced tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
settings Statistics
Use cursor Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en
une fois. Cette option permet d'optimiser les performances.
Trim all the Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les
String/Char colonnes contenant des chanes de caractres.
columns
Trim column Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
No null values Cochez cette case pour optimiser les performances s'il n'y a pas de valeur nulle.
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Oracle.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
2. Slectionnez une connexion dans la liste droulante Connection Type. Dans cet exemple, saisissez
OracleSID.
Slectionnez la version de la base de donnes Oracle utiliser dans la liste droulante DB Version. Dans
cet exemple, saisissez Oracle 12-7.
Dans le champ Host, saisissez l'adresse IP du serveur de la base de donnes Oracle, "192.168.31.32".
Dans le champ Database, saisissez le nom de la base de donnes, "TALEND" dans cet exemple.
Dans le champ Oracle schema, saisissez le nom du schma Oracle, "TALEND" dans cet exemple.
3. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir l'diteur du schma.
4.
Cliquez sur le bouton pour ajouter quatre colonnes : ID et AGE de type Integer et NAME et SEX, de
type String.
Cliquez sur OK pour fermer l'diteur du schma et acceptez la propagation propose par la bote de dialogue
qui s'ouvre.
5. Placez votre souris sur le champ Table Name et appuyez sur F5 pour configurer les paramtres de contexte.
La bote de dialogue [New Context Parameter] s'ouvre.
Pour plus d'informations concernant les paramtres de contexte, consultez le Guide utilisateur du Studio
Talend.
6. Dans le champ Name, laissez le nom du paramtre de contexte, TABLE dans cet exemple.
Dans le champ Default value, saisissez le nom de la table de base de donnes Oracle interroger. Dans cet
exemple, saisissez PERSON.
8. Dans la liste Query Type, slectionnez Built-In. Cliquez sur Guess Query pour obtenir l'instruction de la
requte.
"SELECT
"+context.TABLE+".\"ID\",
"+context.TABLE+".NAME,
"+context.TABLE+".SEX,
"+context.TABLE+".AGE
FROM "+context.TABLE
10. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un meilleur affichage des
rsultats.
Comme affich dans la capture d'cran, les donnes dans la table de la base de donnes Oracle PERSON sont
affiches dans la console.
Scnarios associs
Consultez les scnarios associs :
Scnario 1 : Afficher les donnes slectionnes partir d'une table du composant tDBInput.
Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de paramtres de connexion
chargs dynamiquement du composant tContextLoad.
tOracleOutput
Proprits du tOracleOutput
Famille de composant Databases/Oracle
Fonction Le composant tOracleOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tOracleOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du
flux entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion
la base de donnes et enregistrer les paramtres de connexion que vous avez
dfinis dans la vue Basic settings du composant.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Action on table La liste Action on table n'est pas disponible si vous cochez la case
Enable parallel execution dans la vue Advanced settings.
Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en
crer une nouvelle.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma peut tre Built-in ou
distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des
entiers (integer) ou des fonctions (function), assurez-vous que les valeurs par
dfaut ne sont pas entoures de guillemets. Si c'est le cas, vous devez supprimer
manuellement les guillemets.
Cette option est indisponible lorsque la case Use an existing connection est
coche.
Advanced settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes
parameters cre. Cette option est disponible lorsque la case Use an existing connection
est dcoche dans les Basic settings.
d'effectuer des actions sur les colonnes, l'exclusion des actions d'insertion, de
mise jour, de suppression ou qui ncessitent un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou
insrer les donnes dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action
effectuer sur la colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant
tOracleOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou
celle modifier.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs
actions sur les donnes.
Use Hint Options Cochez cette case pour ajouter des indicateurs (ou Hints) permettant d'optimiser
le plan d'excution de la requte afin d'obtenir les meilleurs performances
possibles.
- HINT : spcifiez le hint dont vous avez besoin, l'aide de la syntaxe /*+ */.
Ce champ est disponible uniquement lorsque la case Use Batch est coche.
Support null in "SQL Cochez cette case pour prendre en compte les valeurs Null lors d'une instruction
WHERE" statement WHERE.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues
dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes
ayant la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette
variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne
un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un
entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne
un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne
un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits
des requtes SQL.
Ce composant doit tre utilis en tant que composant de sortie. Il permet de faire des actions sur une table
ou les donnes d'une table d'une base de donnes Oracle. Il permet aussi de crer un flux de rejet avec
un lien Row > Reject filtrant les donnes en erreur. Pour un exemple d'utilisation, consultez Scnario 3 :
Rcuprer les donnes errones l'aide d'un lien Reject du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont
pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton
Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans
l'onglet Modules de la perspective Integration de votre studio. Pour plus d'informations, consultez
la page https://help.talend.com/display/KB/How+to+install+external+modules+in+the+Talend+products
(en anglais) ou la section dcrivant comment configurer le studio, dans le Guide d'installation et de
migration Talend.
Scnarios associs
Pour un scnario associ au composant tOracleOutput, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tOracleOutputBulk
Proprits du tOracleOutputBulk
Les composants tOracleOutputBulk et tOracleBulkExec sont gnralement utiliss ensemble pour d'une part
gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tOracleOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le chargement des donnes dans la base de donnes.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis avec le composant tOracleBulkExec. Ensemble ils
offrent un gain de performance important pour l'alimentation d'une base de donnes Oracle.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Scnarios associs
Pour des scnarios associs au composant tOracleOutputBulk, consultez les scnarios suivants :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tOracleOutputBulkExec
Proprits du tOracleOutputBulkExec
Les composants tOracleOutputBulk et tOracleBulkExec sont gnralement utiliss ensemble comme deux
parties d'un processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime
tape, ce fichier est utilis lors de l'opration d'INSERT afin de peupler une base de donnes. Cette excution en
deux tapes est unifie dans le composant tOracleOutputBulkExec.
Famille de composant Databases/Oracle
Fonction Le tOracleOutputBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Ce composant est un composant ddi qui permet un gain de performance pendant les oprations d'Insert
dans une base de donnes Oracle.
Basic settings Property type Peut tre Built-in ou Repository..
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir
connection de la liste Component list pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois et la
table doit dj exister pour que l'opration d'Insert soit autorise.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en
crer une nouvelle.
Ce fichier est gnr sur la machine spcifie par l'URI dans le champ
Host et doit tre sur la mme machine que le serveur de la base de
donnes.
Create directory if not Cette case est coche par dfaut. Cette option permet de crer un rpertoire o
exists stocker la table de sortie si elle n'existe pas.
Append Cochez cette case afin d'ajouter de nouvelles lignes la fin de l'enregistrement.
Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la table
slectionne :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des
entiers (integer) ou des fonctions (function), assurez-vous que les valeurs par
dfaut ne sont pas entoures de guillemets. Si c'est le cas, vous devez supprimer
manuellement les guillemets.
EOF (used for loading LOBs from lobfile) : la sparation est constitue d'un
caractre de fin de fichier (End Of File).
Other terminator : la sparation est constitue d'un caractre autre que ceux
prcdemment noncs.
Use fields enclosure Cochez cette case si vous voulez utiliser des caractres pour entourer le texte :
Fields enclosure (left part) : caractre dlimitant les champs sur la gauche.
Field enclosure (right part) : caractre dlimitant les champs sur la droite.
Use schema's Date Cochez cette case pour utiliser le modle de date contenu dans le schma pour
Pattern to load Date field remplir le champ concernant la date.
Specify field condition Cochez cette case pour dfinir une condition de chargement des donnes.
Preserve blanks Cochez cette case pour conserver les espaces vides.
Trailing null columns Cochez cette case pour charger des donnes avec des colonnes vides.
Load options Cliquez sur le bouton [+] afin d'ajouter des options de chargement des donnes :
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant est principalement utilis lorsqu'aucune transformation particulire n'est requise sur les
donnes charger dans la base de donnes.
Limitation Le serveur/client de la base de donnes doit tre install sur la mme machine que le Studio Talend ou que
le Job contenant un tOracleOutputBulkExec, afin que le composant fonctionne correctement.
Scnarios associs
Pour des scnarios associs au composant tOracleOutputBulkExec, consultez les scnarios suivants :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tOracleRollback
Proprits du tOracleRollback
Famille de composant Databases
Fonction Le tOracleRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant tOracleConnection dans la liste s'il y a
plus d'une connexion dans votre Job.
Close connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Oracle, notamment les
composants tOracleConnection et tOracleCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tOracleRollback, consultez tMysqlRollback.
tOracleRow
Proprits du tOracleRow
Famille de composant Databases/Oracle
Fonction Le tOracleRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL
dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux
dans le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tOracleRow agit sur la structure mme de la base
de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement
et aisment crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir
connection de la liste Component list pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (Built-in),
soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de
SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ
Query est renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des
champs afin qu'ils correspondent la dfinition du schma.
Use NB_LINE_ Cette option vous permet d'alimenter la variable afin de passer au sous-job ou
au composant suivant le nombre de lignes mises jour/supprimes/insres. Ce
champ s'applique uniquement si la requte saisie dans le champ Query est une
requte INSERT, UPDATE ou DELETE.
Cette option est indisponible lorsque la case Use an existing connection est
coche.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette
case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes
en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour
cela, utilisez un lien Row > Rejects.
Advanced settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes
parameters cre. Cette option est disponible lorsque la case Use an existing connection
est dcoche dans les Basic settings.
Propagate QUERY's Cochez cette case pour insrer les rsultats de la requte dans une colonne du
recordset flux en cours. Slectionnez cette colonne dans la liste use column.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne
un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un
entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne
un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits
de requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez :
Scnario 2 : Utiliser l'instance PreparedStatement pour faire une requte sur des donnes du tMysqlRow.
tOracleSCD
Le composant tOracleSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus
d'informations, consultez tOracleSCD.
tOracleSCDELT
Le composant tOracleSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tOracleSCDELT.
tOracleSP
Proprits du tOracleSP
Famille de composant Databases/Oracle
Fonction Le composant tOracleSP appelle une procdure stocke de base de donnes.
Objectif Ce composant permet de centraliser des requtes multiples ou complexes dans une base de donnes et de
les appeler plus facilement.
Basic settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir
connection de la liste Component list pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier des proprits du composant. Les champs
suivants sont alors pr-remplis.
DB Version Slectionnez la version d'Oracle que vous utilisez.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom du schma.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Schema et Edit schema Dans une procdure stocke, le schma est un paramtre d'entre.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
IN OUT : les paramtres d'entre doivent tre retournes sous forme de valeur,
mme aprs modifications via la procdure (fonction).
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce
cas, seuls les paramtres d'entre sont autoriss.
Limitation La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes. Quand le paramtre
dfini dans ce composant est personnalis (Custom Type), les composants de la famille tJava doivent
tre placs avant le tOracleSP, afin que les utilisateurs puissent dfinir des valeurs pour les paramtres
personnaliss, ou bien aprs le tOracleSP, pour lire et crire les paramtres personnaliss de type OUT.
Reliez le composant tOracleConnection au tOracleInput l'aide d'un lien Then Run puisqu'aucune donne
n'est traite ici.
Connectez les autres composants l'aide de liens Row Main puisque des lignes sont transmises comme
paramtres au composant SP et la console.
Dans l'onglet Basic settings du composant tOracleConnection, paramtrez les informations de connexion
la base de donnes correspondante. Vous pourrez donc rutiliser cette information dans tout autre composant
li aux bases de donnes.
Cochez la case Use an existing connection et slectionnez le composant tOracleConnection dans la liste pour
rutiliser les informations de connexion dj paramtres.
Slectionnez l'option Repository dans le champ Property type puisque le schma Oracle est dfini dans une
mtadonne du dossier Db Connections du Repository. Si vous n'avez pas enregistr de mtadonne contenant
les informations de connexion la base de donnes Oracle dans le Repository, renseignez le nom du schma
manuellement.
Puis slectionnez l'option Repository dans le champ Schema, et rcuprez le schma correspondant la table
de la base de donnes Oracle.
Dans cet exemple, la table contenant le numro de scurit social contient un schma quatre colonnes dont :
ID, NAME, CITY et SSNUMBER.
Dans le champ Query, saisissez la requte Select suivante ou slectionnez-la dans la liste si vous l'aviez stocke
dans le Repository.
Puis slectionnez le tOracleSP et paramtrez ses proprits dans l'onglet Basic settings.
Comme pour le composant tOracleInput, slectionnez l'option Repository dans le champ Property type et
cochez la case Use an existing connection, puis slectionnez l'entre adquate dans la liste Component List.
Le schma utilis pour le composant tOracleSP diffre lgrement du schma d'entre. En effet, une colonne
supplmentaire (SSN_Valid) est ajoute au schma d'entre. Cette colonne contiendra le statut de validit (1 ou
0) gnr par la procdure.
Dans le champ SP Name, saisissez le nom exact de la procdure stocke (ou de la fonction) telle qu'elle est
appele dans la base de donnes. Dans cet exemple, le nom de la procdure stocke est is_ssn.
Comme un valeur retourne est attendue dans cet exemple, la procdure agit comme une fonction, ainsi cochez
la case Is function.
La seule valeur retourne attendue est base sur la colonne ssn_valid. Ainsi, slectionnez l'entre correspondante
dans la liste.
Dans la zone Parameters, dfinissez les paramtres d'entre et de sortie utiliss dans la procdure. Dans cet
exemple, seule la colonne SSNumber du schma est utilise dans la procdure.
Cliquez sur le signe [+] pour ajouter un nouvelle ligne la table et slectionnez la colonne adquate (SSNumber)
et son type (IN).
Puis slectionnez le composant tLogRow et cliquez sur Sync Column pour rcuprer le schma du composant
prcdent (tOracleSP).
Cochez la case Print values in cells of a table pour faciliter la lecture de la sortie.
Dans la console, vous pouvez lire les rsultats en sortie. Toutes les colonnes du schma d'entre sont affiches
mme si elles ne sont pas utilises comme paramtres dans la procdure stocke.
La colonne finale affiche la valeur retourne attendue, c'est--dire que le numro de scurit sociale vrifi soit
valide ou non.
Consultez galement Scnario 1 : Insrer des donnes dans des tables mre/fille si vous voulez analyser un
ensemble d'enregistrements d'une table de donnes ou d'une requte SQL.
Scnarios associs
Pour des scnarios associs, consultez :
tOracleTableList
Proprits du tOracleTableList
Famille de composant Databases/Oracle
Fonction Le composant tOracleTableList effectue une opration d'itration sur toutes les tables d'une base
de donnes, grce une connexion Oracle dfinie.
Objectif Le composant tOracleTableList permet de lister les noms des tables Oracle grce aux commandes
SELECT et WHERE.
Basic settings Component list Slectionnez le composant de connexion tOracleConnection dans
la liste si vous prvoyez d'ajouter plus d'une connexion votre Job
en cours.
Where clause for table name Saisissez la commande WHERE permettant d'identifier les tables sur
selection lesquelles effectuer l'opration d'itration.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables CURRENT_TABLE : nom de la table sur laquelle se fait l'itration. Cette variable est une variable
Flow et retourne une chane de caractres.
NB_TABLE : nombre de tables itres jusqu' prsent. Cette variable est une variable Flow et
retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Il faut utiliser ce composant en association avec les autres composants Oracle, notamment avec
le tOracleConnection.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Scnario : Itrer une table de base de donnes et lister le nom des colonnes
de la table.
tPostgresqlBulkExec
Proprits du tPostgresqlBulkExec
Les composants tPostgresqlOutputBulk et tPostgresqlBulkExec sont gnralement utiliss ensemble pour d'une
part gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tPostgresqlOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le chargement des donnes dans la base de donnes.
Famille de Databases/
composant Postgresql
Fonction Le composant tPostgresqlBulkExec permet d'insrer les donnes d'une base de donnes Postgresql.
Objectif Le tPostgresqlBulkExec est un composant ddi, il permet un gain de performance lors du traitement des donnes
de la base de donnes Postgresql.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle.
Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback.
File Name Nom du fichier charger.
Le fichier est situ sur la machine spcifie par l'URI dans le champ Host et doit tre
sur la mme machine que le serveur de la base de donnes.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
Schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer) ou des
fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de guillemets.
Si c'est le cas, vous devez supprimer manuellement les guillemets.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant doit tre utilis en association avec le composant tPostgresqlOutputBulk. Ensemble, ils permettent
d'obtenir des gains de performances dans une base de donnes Postgresql.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour d'autres exemples d'utilisation du composant tPostgresqlBulkExec, consultez les scnarios suivants dans :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk,
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tPostgresqlCommit
Proprits du tPostgresqlCommit
Famille de composant Databases/Postgresql
Fonction Le composant tPostgresqlCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Basic settings Component list Slectionnez le composant tPostgresqlConnection dans la liste s'il
y a plus d'une connexion dans votre Job.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants Postgresql, notamment les composants
tPostgresqlConnection et tPostgresqlRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tPostgresqlCommit, consultez Scnario 1 :
Insrer des donnes dans des tables mre/fille.
tPostgresqlClose
Proprits du tPostgresqlClose
Famille de composant Databases/Postgresql
Fonction Le composant tPostgresqlClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes Postgresql.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tPostgresqlConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tPostgresqlConnection et tPostgresqlRollback. Il est
gnralement utilis avec un composant tPostgresqlConnection car il permet de fermer une connexion pour la
transaction en cours.
tPostgresqlConnection
Proprits du tPostgresqlConnection
Famille de composant Databases/Postgresql
Fonction Le composant tPostgresqlConnection ouvre une connexion vers une base de donnes afin
d'effectuer une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository.
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tPostgresqlConnection, consultez tMysqlConnection.
tPostgresqlInput
Proprits du tPostgresqlInput
Famille de Databases/
composant Postgresql
Fonction Le composant tPostgresqlInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tPostgresqlInput excute une requte en base de donnes selon un ordre strict qui doit correspondre
celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une
connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de
base de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette
variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Postgresql.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tPostgresqlInput :
tPostgresqlOutput
Proprits du tPostgresqlOutput
Famille de Databases/
composant Postgresql
Fonction Le composant tPostgresqlOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tPostgresqlOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Cochez cette case pour utiliser la base de donnes PostgreSQL en tant que base de donnes
spatiale pour un systme d'informations gographique (SIG). Lorsque cette case est coche,
deux autres cases s'affichent :
Create Spatial index: cochez cette case pour crer un index spatial.
Create geometry columns reference : cochez cette case pour crer la rfrence des
colonnes de type Geometry.
cochez la case Use an existing connection dans la vue Basic settings et que le mode Auto
Commit est activ dans le composant de connexion la base de donnes.
Use field Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur
options les donnes.
Enable debug Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de donnes.
mode
Support null in Cochez cette case pour prendre en compte les valeurs Null d'une table de base de donnes.
"SQL WHERE"
statement Assurez-vous que la case Nullable est bien coche pour les colonnes du schma
correspondantes.
Use Batch Size Cochez cette case pour activer le mode Batch (par lots) pour le traitement des donnes. Dans
le champ Batch Size qui apparat lorsque la case est coche, saisissez la taille du lot traiter.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un
entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
Postgresql. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur.
Pour un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject
du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tPostgresqlOutput consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
tDBOutput.
tPostgresqlOutputBulk
Proprits du tPostgresqlOutputBulk
Les composants tPostgresqlOutputBulk et tPostgresqlBulkExec sont gnralement utiliss ensemble pour d'une
part gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tPostgresqlOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le chargement des donnes dans la base de donnes.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis avec le composant tPostgresqlBulkExec. Ensemble ils
offrent un gain de performance important pour l'alimentation d'une base de donnes Postgresql.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Scnarios associs
Pour un scnario associ au composant tPostgresqlOutputBulk, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tPostgresqlOutputBulkExec
Proprits du tPostgresqlOutputBulkExec
Les composants tPostgresqlOutputBulk et tPostgresqlBulkExec sont gnralement utiliss ensemble comme
deux parties d'un processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la
deuxime tape, ce fichier est utilis lors de l'opration d'INSERT afin de peupler une base de donnes. Cette
excution en deux tapes est unifie dans le composant tPostgresqlOutputBulkExec.
Drop table if exists and create: supprimer la table si elle existe dj,
puis en crer une nouvelle.
Scnarios associs
Pour un scnario associ au composant tPostgresqlOutputBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tPostgresqlRollback
Proprits du tPostgresqlRollback
Famille de composant Databases/Postgresql
Fonction Le tPostgresqlRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant tPostgresqlConnection dans la liste s'il
y a plus d'une connexion dans votre Job.
Close connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Postgresql, notamment les
composants tPostgresqlConnection et tPostgresqlCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tPostgresqlRollback, consultez tMysqlRollback.
tPostgresqlRow
Proprits du tPostgresqlRow
Famille de Databases/
composant Postgresql
Fonction Le tPostgresqlRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL
dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans
le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tPostgresqlRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced settings Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
QUERY's Slectionnez cette colonne dans la liste use column.
recordset
Cette option permet au composant d'avoir un schma diffrent de celui du
composant prcdent. De plus, la colonne contenant le rsultat de la requte doit
tre de type Object. Ce composant est gnralement suivi du tParseRecordSet.
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatement de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des
paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query de
l'onglet Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une
meilleure performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour un scnario associ, consultez :
tPostgresqlSCD
Le composant tPostgresqlSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tPostgresqlSCD.
tPostgresqlSCDELT
tSybaseBulkExec
Proprits du tSybaseBulkExec
Les composants tSybaseOutputBulk et tSybaseBulkExec sont gnralement utiliss ensemble pour d'une part
gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tSybaseOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le chargement des donnes dans la base de donnes.
Famille de Databases
composant
Fonction Le composant tSybaseBulkExec permet d'insrer les donnes d'une base de donnes Sybase.
Objectif Le tSybaseBulkExec est un composant ddi, il permet un gain de performance lors du traitement des donnes
de la base de donnes Sybase.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Cette option est disponible lorsque vous slectionnez Bulk Update dans la liste Action on
data, dans la vue Advanced settings du tSybaseBulkExec.
Port Numro du port d'coute du serveur de base de donnes.
Cette option est disponible lorsque vous slectionnez Bulk Update dans la liste Action on
data, dans la vue Advanced settings du tSybaseBulkExec.
Database Nom de la base de donnes.
Username et Informations d'authentification de l'utilisateur de base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans la
bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis cliquez
sur OK afin de sauvegarder les paramtres.
Sybase Schema Nom du schma de la base de donnes que vous souhaitez utiliser.
Server Adresse IP du serveur de base de donnes pour la connexion de l'utilitaire Bcp.
Bcp Utility Nom de l'utilitaire bcp utiliser pour copier les donnes sur le serveur Sybase.
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Ce fichier doit se situer sur la mme machine que le serveur de la base de donnes.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
Schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Advanced Use an interface Cochez cette case afin de spcifier un fichier interface dans le champ Interface file.
settings file
Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de
parameters donnes, afin de supporter des caractres spcifiques. Exemple : CHARSET=KANJISIS_OS
pour supporter les caractres japonais.
Action on data Vous pouvez effectuer les actions suivantes sur la table dfinie :
Bulk Insert : ajoute des entres multiples la table. Le Job s'arrte lorsque des doublons sont
trouvs.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE_DATA : nombre de lignes lues. Cette variable est une variable After et retourne un entier.
NB_LINE_BAD : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis lorsque les donnes charger dans la base n'exigent aucune transformation
particulire.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Le serveur/client de la base de donnes doit tre install sur la mme machine que le Studio Talend ou le Job
contenant un tSybaseBulkExec, afin que le composant fonctionne correctement.
Contrairement au composant Oracle ddi, ce composant Sybase ne permet aucune action directe sur les donnes.
Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tSybaseBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulkExec.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tSybaseClose
Proprits du tSybaseClose
Famille de composant Databases/Sybase
Fonction Le composant tSybaseClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes Sybase.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tSybaseConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tSybaseConnection et tSybaseRollback. Il est gnralement
utilis avec un composant tSybaseConnection car il permet de fermer une connexion pour la transaction en cours.
tSybaseCommit
Proprits du tSybaseCommit
Famille de composant Databases/Sybase
Fonction Le composant tSybaseCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list Slectionnez le composant tSybaseCommit dans la liste s'il y a plus
d'une connexion dans votre Job.
Close Connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants Sybase, notamment les composants
tSybaseConnection et tSybaseRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tSybaseCommit, consultez Scnario 1 :
Insrer des donnes dans des tables mre/fille.
tSybaseConnection
Proprits du tSybaseConnection
Famille de composant Databases/Sybase
Fonction Le composant tSybaseConnection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository.
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation
de ces fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend,
dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tSybaseConnection, consultez Scnario 1 : Insrer des donnes dans des
tables mre/fille.
tSybaseInput
Proprits du tSybaseInput
Famille de Databases/
composant Sybase
Fonction Le composant tSybaseInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tSybaseInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui
dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une
connexion de flux (Main row).
Basic settings Property Peut tre Built-in ou Repository.
type
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de donnes
et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du
composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base de
donnes, consultez le Guide utilisateur du Studio Talend.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Table Name Nom de la table lire.
Query type et Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des champs
Query corresponde celui dfini dans le schma.
Advanced settings Trim all Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes
the String/ contenant des chanes de caractres.
Char
columns
Trim column Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Sybase.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez les scnarios du composant tDBInput dans :
Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du tContextLoad.
tSybaseIQBulkExec
Proprits du tSybaseIQBulkExec
Famille de Databases/SybaseIQ
composant
Fonction Le composant tSybaseIQBulkExec permet de charger un fichier bulk dans une base de donnes Sybase IQ.
Objectif Le tSybaseIQBulkExec est un composant ddi, il permet un gain de performance lors du traitement des
donnes de la base de donnes Sybase IQ.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
DB Version Les versions disponibles de Sybase sont :
- Sybase IQ 12,
- Sybase IQ15.
Sybase IQ 12
uniquement.
Port Numro du port d'coute du serveur de base de donnes.
Sybase IQ 12
uniquement.
Data Source Slectionnez le type de source de donnes utiliser et renseignez les informations
de DSN dans les champs correspondants. Les types disponibles sont :
Sybase IQ 15
uniquement. - DSN,
- FILEDSN.
Lorsque le type FILEDSN est utilis, un bouton [...] apparat prs du champ Data
Source et vous permet de parcourir le fichier source de donnes qui vous intresse.
Database Nom de la base de donnes.
Username et Password Informations d'authentification de l'utilisateur de base de donnes.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets
doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois et la table
doit dj exister pour que l'opration d'Insert soit autorise.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en crer
une nouvelle.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Use fixed length Cochez cette case pour dterminer une longueur fixe pour les lignes de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes Sybase IQ.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Contrairement au composant Oracle ddi, ce composant Sybase ne permet aucune action directe sur les donnes.
Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Le fichier jodbc.jar doit tre install sparment dans la vue Modules de la perspective Integration de votre
Studio Talend.Pour plus d'informations, consultez la section concernant les modules externes dans le Guide
d'installation et de migration Talend.
Pour Sybase IQ 12, le serveur/client de la base de donnes doit tre install sur la mme machine que
le Studio Talend ou que le Job contenant un tSybaseIQOutputBulkExec.
Pour Sybase IQ 15, vous pouvez installer uniquement le client de la base de donnes sur la mme
machine que le Studio Talend ou que le Job contenant un tSybaseIQOutputBulkExec. Cependant, cela
ncessite une certaine configuration du serveur de Sybase IQ 15. Pour plus d'informations, consultez
Sybase IQ client-side load support enhancements (en anglais).
Scnario associ
Pour un scnario associ au tSybaseIQBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulkExec.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tSybaseIQOutputBulkExec
Proprits du tSybaseIQOutputBulkExec
Famille de Databases/SybaseIQ
composant
Fonction Le tSybaseIQOutputBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tSybaseIQOutputBulkExec est un composant ddi, il permet un gain de performance lors du traitement
des donnes de la base de donnes Sybase IQ.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
DB Version Les versions disponibles de Sybase sont :
- Sybase IQ 12,
- Sybase IQ15.
Sybase IQ 12
uniquement.
Port Numro du port d'coute du serveur de base de donnes.
Sybase IQ 12
uniquement.
Data Source Slectionnez le type de source de donnes utiliser et renseignez les informations
de DSN dans les champs correspondants. Les types disponibles sont :
Sybase IQ 15
uniquement. - DSN,
- FILEDSN.
Lorsque le type FILEDSN est utilis, un bouton [...] apparat prs du champ Data
Source et vous permet de parcourir le fichier source de donnes qui vous intresse.
Database Nom de la base de donnes.
Username et Password Informations d'authentification de l'utilisateur de base de donnes.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets
doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois et la table
doit dj exister pour que l'opration d'Insert soit autorise.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en crer
une nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il
peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers
(integer) ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont
pas entoures de guillemets. Si c'est le cas, vous devez supprimer manuellement
les guillemets.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant est principalement utilis lorsqu'aucune transformation particulire n'est requise sur les donnes
charger dans la base de donnes.
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Le fichier jodbc.jar doit tre install sparment dans la vue Modules de la perspective Integration de votre
Studio Talend.Pour plus d'informations, consultez la section concernant les modules externes dans le Guide
d'installation et de migration Talend.
Pour Sybase IQ 12, le serveur/client de la base de donnes doit tre install sur la mme machine
que le Studio Talend ou que le Job contenant un tSybaseIQOutputBulkExec.
Pour Sybase IQ 15, vous pouvez installer uniquement le client de la base de donnes sur la mme
machine que le Studio Talend ou que le Job contenant un tSybaseIQOutputBulkExec. Cependant,
cela ncessite une certaine configuration du serveur de Sybase IQ 15. Pour plus d'informations,
consultez Sybase IQ client-side load support enhancements (en anglais).
2. Cliquez sur le bouton [+] pour ajouter deux colonnes et nommez-les id et name.
6. Cliquez sur OK pour fermer l'diteur et cliquez sur Yes sur propager les modifications :
10. Dans les champs Username et Password, saisissez les informations d'authentification.
12. Dans la liste Action on table, slectionnez Create table if not exists.
13. Dans le champ Filename, saisissez le chemin d'accs complet au fichier contenant les donnes.
Excuter le Job
1. Appuyez sur Ctrl+S pour sauvegarder le Job.
3. Dans la console Sybase Central, ouvrez la table staff afin de vrifier les donnes :
Comme montr ci-dessus, la table est cre et les donnes sont insres.
Scnarios associs
Pour un scnario associ au composant tSybaseIQOutputBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tSybaseOutput
tSybaseOutput Properties
Famille de Databases/
composant Sybase
Fonction Le composant tSybaseOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tSybaseOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de
base de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Drop and create table : supprimer la table puis en crer une nouvelle.
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des
doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures
de guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous
pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row
> Rejects.
Advanced settings Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une
meilleure performance d'excution.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous
Columns l'ayez pralablement supprime ou non). Cette option vous permet d'effectuer des actions
sur les colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou
qui ncessitent un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les
donnes dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur
la colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant tSybaseOutput
peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions
sur les donnes.
Enable debug Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
mode donnes.
Use Batch size Cochez cette case afin d'activer le mode batch pour le traitement des donnes. Dans le
champ Batch Size qui apparat, vous pouvez saisir le nombre de lignes par lot charger.
Cette case est disponible uniquement si vous avez choisi l'option Insert,
Update, Single Insert Query ou Delete dans le champ Action on data.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne
un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un
entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un
entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un
entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
Sybase. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur.
Pour un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject
du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au composant tSybaseOutput, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
tDBOutput.
tSybaseOutputBulk
Proprits du tSybaseOutputBulk
Les composants tSybaseOutputBulk et tSybaseBulkExec sont gnralement utiliss ensemble pour d'une part
gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tSybaseOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le chargement des donnes dans la base de donnes.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis avec le composant tSybaseBulkExec. Ensemble ils
offrent un gain de performance important pour l'alimentation d'une base de donnes Sybase.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur
l'installation de ces fichiers .jar manquants, consultez la section dcrivant comment configurer
le Studio Talend, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au composant tSybaseOutputBulk, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tSybaseOutputBulkExec
Proprits du tSybaseOutputBulkExec
Les composants tSybaseOutputBulk et tSybaseBulkExec sont gnralement utiliss ensemble comme deux
parties d'un processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime
tape, ce fichier est utilis lors de l'opration d'INSERT afin de peupler une base de donnes. Cette excution en
deux tapes est unifie dans le composant tSybaseOutputBulkExec.
Famille de Databases/Sybase
composant
Fonction Le tSybaseOutputBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tSybaseOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations
d'Insert dans une base de donnes Sybase.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Ce fichier est gnr sur la machine spcifie par l'URI dans le champ Server et doit
tre sur la mme machine que le serveur de la base de donnes.
Append Cochez cette option pour ajouter des nouvelles lignes la fin du fichier.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
Schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Advanced Use an interface Cochez cette case afin de spcifier un fichier interface dans le champ Interface file.
settings file
Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de
parameters donnes, afin de supporter des caractres spcifiques. Exemple : CHARSET=KANJISIS_OS
pour supporter les caractres japonais.
Action on data Vous pouvez effectuer les actions suivantes sur la table dfinie :
Bulk Insert : ajoute des entres multiples la table. Le Job s'arrte lorsque des doublons sont
trouvs.
FILE Row Caractre, chane ou expression rgulire sparant les lignes dans le fichier.
Terminator
Include Head Cochez cette case pour inclure l'en-tte des colonnes dans le fichier.
Encoding Slectionnez l'encodage partir de la liste ou slectionnez Custom et dfinissez-le
manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
Sybase encoding Slectionnez le type d'encodage spcifique Sybase pour le traitement des donnes. Ce type
type d'encodage permet au tSybaseOutputBulkExec de gnrer correctement la commande Sybase
de masse.
Output to console : l'information est charge.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant est principalement utilis lorsqu'aucune transformation particulire n'est requise sur les donnes
charger dans la base de donnes.
Limitation Le serveur/client de la base de donnes doit tre install sur la mme machine que le Studio Talend ou que le Job
contenant un tSybaseOutputBulkExec, afin que le composant fonctionne correctement.
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tSybaseOutputBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tSybaseRollback
Proprits du tSybaseRollback
Famille de composant Databases/Sybase
Fonction Le tSybaseRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant tSybaseConnection dans la liste s'il y a
plus d'une connexion dans votre Job.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Sybase, notamment les
composants tSybaseConnection et tSybaseCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tSybaseRollback, consultez Scnario : Annuler l'insertion de donnes
dans des tables mre/fille.
tSybaseRow
Proprits du tSybaseRow
Famille de Databases/
composant Sybase
Fonction Le tSybaseRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL
dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux
dans le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tSybaseRow agit sur la structure mme de la base
de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et
aisment crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
Schema et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une
meilleure performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de
requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au composant tSybaseRow, consultez :
tSybaseSCD
Le composant tSybaseSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus
d'informations, consultez tSybaseSCD.
tSybaseSCDELT
Le composant tSybaseSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tSybaseSCDELT.
tSybaseSP
Proprits du tSybaseSP
Famille de Databases/
composant Sybase
Fonction Le composant tSybaseSP appelle une procdure stocke de base de donnes.
Objectif Ce composant permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les
appeler plus facilement.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier des proprits du composant. Les champs suivants sont
alors pr-remplis.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
SP Name Saisissez le nom exact de la Procdure Stocke (SP).
Is Function / Cochez cette case, si une seule valeur doit tre retourne.
Return result in
Slectionnez dans la liste la colonne du schma sur laquelle est base la valeur obtenir.
Timeout Dure maximale d'attente des rsultats de la procdure stocke.
Interval
Parameters Cliquez sur le bouton [+] et slectionnez dans le champ Schema Columns les diffrentes
colonnes ncessaires la procdure. Notez que le schma de la SP peut contenir plus de colonnes
qu'il n'y a de paramtres utiliss dans la procdure.
IN OUT : les paramtres d'entre doivent tre retournes sous forme de valeur, mme aprs
modifications via la procdure (fonction).
RECORDSET : les paramtres d'entre doivent tre retournes sous forme d'ensemble de
valeurs, au lieu d'une valeur unique.
Consultez Scnario 1 : Insrer des donnes dans des tables mre/fille si vous voulez
analyser un ensemble d'enregistrements d'une table de donnes ou d'une requte SQL.
Advanced Additional Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette
settings JDBC option est disponible lorsque la case Use an existing connection est dcoche dans les Basic
parameters settings.
Use Multiple Cochez cette case pour utiliser des procdures contenant plusieurs instructions SELECT.
SELECT
Procedure
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls
les paramtres d'entre sont autoriss.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.
Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez:
Consultez galement Scnario 1 : Insrer des donnes dans des tables mre/fille si vous voulez analyser un
ensemble d'enregistrements d'une table de donnes ou d'une requte SQL.
tVerticaSCD
Le composant tVerticaSCD appartient deux familles de composants : Business Intelligence et Databases. Pour
plus d'informations, consultez tVerticaSCD.
tGreenplumBulkExec
Proprits du tGreenplumBulkExec
Les composants tGreenplumOutputBulk et tGreenplumBulkExec sont gnralement utiliss ensemble pour
d'une part gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte
SQL nonce. Cette excution en deux tapes est unifie dans le composant tGreenplumOutputBulkExec,
dtaill dans une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet
de procder des transformations avant le changement des donnes dans la base de donnes.
Famille de Databases/
composant Greenplum
Fonction Le composant tGreenplumBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tGreenplumBulkExec est un composant ddi qui permet un gain de performance pendant les oprations
d'Insert dans une base de donnes Greenplum.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Le fichier est situ sur la machine spcifie par l'URI dans le champ Host et doit tre
sur la mme machine que le serveur de la base de donnes.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
Schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Advanced Action on data Slectionnez l'opration que vous voulez effectuer :
settings
Bulk insert ou Bulk update. Les informations demandes seront diffrentes en fonction de
l'action choisie.
Copy the OID Rcupre les identifiants d'objet pour chaque ligne.
for each row
Contains a Spcifiez que la table contient des lignes d'en-tte.
header line with
the names of
each column in
the file
File type Slectionnez le type de fichiers traiter.
Null string Chane de caractres affiche pour signifier que la valeur est nulle.
Fields Caractre, chane ou expression rgulire sparant les champs.
terminated by
Escaped char Caractre d'chappement de la ligne.
Text enclosure Caractres utiliss pour entourer le texte.
Force not null Dfinissez la nullabilit des colonnes.
for columns
Force not null : Cochez la case correspondant la colonne (Column) que vous souhaitez dfinir
comme n'tant pas nulle.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec un composant tGreenplumOutputBulk. Ensemble, ils offrent un
gain de performance important pour l'alimentation d'une base de donnes Greenplum.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour plus d'informations relatives au fonctionnement de tGreenplumBulkExec, consultez les scnarios suivants,
dans :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
Scnario : Insrer des donnes dans une base MySQL du composant tMysqlOutputBulkExec.
Scnario : Supprimer et insrer des donnes dans une base Oracle du composant tOracleBulkExec.
tGreenplumClose
Proprits du tGreenplumClose
Famille de composant Databases/Greenplum
Fonction Le composant tGreenplumClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes Greenplum.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tGreenplumConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tGreenplumConnection et tGreenplumRollback. Il est
gnralement utilis avec un composant tGreenplumConnection car il permet de fermer une connexion pour la
transaction en cours.
tGreenplumCommit
Proprits du tGreenplumCommit
Famille de composant Databases/Greenplum
Fonction Le composant tGreenplumCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tGreenplumConnection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants Greenplum et notamment avec les
composants tGreenplumConnection et tGreenplumRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour consulter des scnarios associs au composant tGreenplumCommit, consultez :
tGreenplumConnection
Proprits du tGreenplumConnection
Famille de composant Databases/Greenplum
Fonction Le composant tGreenplumConnection ouvre une connexion vers une base de donnes afin
d'effectuer une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository.
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour un scnario associ au composant tGreenplumConnection, consultez :
tMysqlConnection.
tGreenplumGPLoad
Ce composant invoque l'utilitaire gpload de Greenplum afin d'insrer des enregistrements dans une base de donnes
Greenplum. Ce composant peut tre utilis soit en mode standalone, il chargera alors les donnes partir d'un
fichier de donnes existant, soit connect un flux d'entre, afin de charger des donnes partir du composant
connect.
Proprits du tGreenplumGPLoad
Famille de composant Databases/Greenplum
Fonction Le composant tGreenplumGPLoad insre des donnes dans la table d'une base de donnes
Greenplum via l'utilitaire gpload de Greenplum.
Objectif Ce composant permet de charger en masse des donnes dans une table Greenplum soit partir d'un
fichier, soit partir d'un flux d'entre, soit partir d'un tube nomm.
Basic settings Property type Peut tre Built-in ou Repository
Drop and create the table : supprimer la table puis en crer une
nouvelle.
Si le nombre limite d'erreurs est atteint, les lignes d'entre ayant des
erreurs de format arrtent l'opration de chargement.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est principalement utilis lorsque des transformations particulires ne sont pas
requises sur les donnes charger dans la base de donnes.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez Scnario : Insrer des donnes dans une base MySQL du composant
tMysqlOutputBulkExec.
tGreenplumInput
Proprits du tGreenplumInput
Famille de composant Databases/ Greenplum
Fonction Le composant tGreenplumInput lit une base de donnes et en extrait des champs l'aide de
requtes.
Objectif Le tGreenplumInput excute une requte en base de donnes selon un ordre strict qui doit
correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au
composant suivant via une connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Greenplum.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour un scnario associ, consultez les scnarios des composants tDBInput dans :
Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.
tGreenplumOutput
Proprits du tGreenplumOutput
Famille de Databases/
composant Greenplum
Fonction Le composant tGreenplumOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tGreenplumOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de donnes
et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du
composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base de
donnes, consultez le Guide utilisateur du Studio Talend.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle.
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.
Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle
baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du
champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s)
que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance,
cliquez sur l'onglet Advanced settings pour dfinir simultanment les cls primaires
sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete).
Pour cela, cochez la case Use field options et slectionnez la case Key in update
correspondant la colonne sur laquelle baser votre opration de mise jour (Update).
Procdez de la mme manire avec les cases Key in delete pour les oprations de
suppression (Delete).
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
Schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer) ou des
fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de guillemets.
Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour terminer
le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer
les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
settings option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous l'ayez
Columns pralablement supprime ou non). Cette option vous permet d'effectuer des actions sur les
colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui ncessitent
un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes
dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur la
colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant tPostgresqlOutput
peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur les
options donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
Greenplum. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur.
Pour un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject
du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour un scnario associ au composant tGreenplumOutput consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
tDBOutput.
tGreenplumOutputBulk
Proprits du tGreenplumOutputBulk
Les composants tGreenplumOutputBulk et tGreenplumBulkExec sont gnralement utiliss ensemble pour
d'une part gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte
SQL nonce. Cette excution en deux tapes est unifie dans le composant tGreenplumOutputBulkExec,
dtaill dans une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet
de procder des transformations avant le chargement des donnes dans la base de donnes.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis avec le composant tGreenplumBulkExec. Ensemble,
ils offrent un gain de performance important pour l'alimentation d'une base de donnes
Greenplum.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Scnarios associs
Pour un scnario associ au tGreenplumOutputBulk, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
tGreenplumOutputBulkExec
Proprits du tGreenplumOutputBulkExec
Les composants tGreenplumOutputBulk et tGreenplumBulkExec sont gnralement utiliss ensemble comme
deux parties d'un processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la
deuxime tape, ce fichier est utilis lors de l'opration d'INSERT afin de peupler une base de donnes. Cette
excution en deux tapes est unifie dans le composant tGreenplumOutputBulkExec.
Drop and create the table : supprimer la table puis en crer une
nouvelle.
Limitation Le serveur de la base de donnes doit tre install sur la mme machine que le Studio Talend
ou que le Job contenant un tGreenplumOutputBulkExec, afin que le composant fonctionne
correctement.
Scnarios associs
Pour un scnario associ au tGreenplumOutputBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
tGreenplumRollback
Proprits du tGreenplumRollback
Famille de composant Databases/Greenplum
Fonction Le tGreenplumRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant de connexion tGreenplumConnection
dans la liste si vous prvoyez d'ajouter plus d'une connexion votre
Job en cours.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en association avec des composants Greenplum, notamment
avec le tGreenplumConnection et le tGreenplumCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au tGreenplumRollback, consultez Scnario : Annuler l'insertion de donnes dans des
tables mre/fille du composant tMysqlRollback.
tGreenplumRow
Proprits du tGreenplumRow
Famille de Databases/
composant Greenplum
Fonction Le tGreenplumRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL
dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans
le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tGreenplumRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste Component
existing list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion cre
par le Job parent avec le Job enfant, vous devez :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si vous
souhaitez propager les modifications uniquement au Job courant, slectionnez No et slectionnez
nouveau la mtadonne du schma dans la fentre [Repository Content].
Table Name Nom de la table lire.
Query type Peut tre Built-in ou Repository.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign
automatiquement.
Guess Query Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table
dans le champ Query.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour terminer
le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les
lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
settings QUERY's Slectionnez cette colonne dans la liste use column.
recordset
Cette option permet au composant d'avoir un schma diffrent de celui du composant
prcdent. De plus, la colonne contenant le rsultat de la requte doit tre de type Object.
Ce composant est gnralement suivi du tParseRecordSet.
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatement
de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des
paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query de l'onglet
Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte.
Elle permet un gain de performance.
Commit Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette option
every garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance
d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
Variables
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour un scnario associ, consultez :
tGreenplumSCD
Le composant tGreenplumSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tGreenplumSCD.
tIngresBulkExec
Proprits du tIngresBulkExec
Les composants tIngresOutputBulk et tIngresBulkExec sont gnralement utiliss ensemble pour d'une part
gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tIngresOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le changement des donnes dans la base de donnes.
Row Estimate Spcifiez le nombre estim de lignes copier d'un fichier une
table durant l'opration de copie de masse.
Trailing WhiteSpace Coche par dfaut, cette case est conue pour supprimer les espaces
en fin de champ et s'applique uniquement aux types de donnes
VARCHAR, NVARCHAR et TEXT.
Output Emplacement o crire le message d'erreur :
NB_LINE_BAD : nombre de lignes rejetes. Cette variable est une variable After et retourne un
entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Le composant tIngresBulkExec est gnralement utilis avec le tIngresConnection et le
tIngresRow. Il permet d'alimenter en masse une base de donnes Ingres, afin d'optimiser les
performances.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Le serveur/client de la base de donnes doit tre install sur la mme machine que le Studio Talend
ou que le Job contenant un tIngresBulkExec, afin que le composant fonctionne correctement.
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont
pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton
Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter
dans l'onglet Modules de la perspective Integration de votre studio. Pour plus d'informations,
consultez la page https://help.talend.com/display/KB/How+to+install+external+modules+in+the
+Talend+products (en anglais) ou la section dcrivant comment configurer le studio, dans le Guide
d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez :
tIngresClose
Proprits du tIngresClose
Famille de composant Databases/Ingres
Fonction Le composant tIngresClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes Ingres.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tIngresConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tIngresConnection et tIngresRollback. Ils sont gnralement
utiliss avec un composant tIngresConnection car il permet d'ouvrir une connexion pour la transaction en cours.
tIngresCommit
Proprits du tIngresCommit
Famille de composant Databases/Ingres
Fonction Le composant tIngresCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list Slectionnez le composant tIngresConnection dans la liste si vous
prvoyez d'ajouter plus d'une connexion votre Job en cours.
Close Connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants JDBC et notamment avec les
composants tIngresConnection et tIngresRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au tIngresCommit, consultez Scnario 1 : Insrer des donnes dans des tables mre/fille.
tIngresConnection
Proprits du tIngresConnection
Famille de composant Databases/Ingres
Fonction Le composant tIngresConnection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository.
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au tIngresConnection, consultez Scnario : Charger des donnes dans une table du
SGBD Ingres.
tIngresInput
Proprits du tIngresInput
Famille de Databases/
composant Ingres
Fonction Le composant tIngresInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tIngresInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini
dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion
de flux (Main row).
Basic settings Property Peut tre Built-in ou Repository.
type
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de donnes
et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du
composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base de
donnes, consultez le Guide utilisateur du Studio Talend.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion cre
par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement le Guide
utilisateur de Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur de Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si vous
souhaitez propager les modifications uniquement au Job courant, slectionnez No et slectionnez
nouveau la mtadonne du schma dans la fentre [Repository Content].
Query type et Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des champs
Query corresponde celui dfini dans le schma.
Advanced Trim all Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes
settings the String/ contenant des chanes de caractres.
Char
columns
Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Ingres.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Consultez les scnarios associs au composant tDBInput dans :
Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.
tIngresOutput
Proprits du tIngresOutput
Famille de Databases/Ingres
composant
Fonction Le composant tIngresOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tIngresOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de
base de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures
de guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
sur les colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui
ncessitent un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les
donnes dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur
la colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant tIngresOutput
peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur
les donnes.
Enable debug Cochez cette case pour afficher chaque tape du processus d'criture dans la base de
mode donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un
entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
Ingres. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour
un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject du
composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tIngresOutputBulk
Proprits du tIngresOutputBulk
Les composants tIngresOutputBulk et tIngresBulkExec sont gnralement utiliss ensemble pour d'une part
gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tIngresOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le chargement des donnes dans la base de donnes.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Le composant tIngresOutputBulk est gnralement utilis avec le tIngresBulkExec, afin de
sauvegarder des donnes entrantes dans un fichier. Ces donnes sont ensuite insres en masse dans
une base de donnes Ingres tIngresBulkExec afin d'optimiser les performances.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont
pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton
Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter
dans l'onglet Modules de la perspective Integration de votre studio. Pour plus d'informations,
consultez la page https://help.talend.com/display/KB/How+to+install+external+modules+in+the
+Talend+products (en anglais) ou la section dcrivant comment configurer le studio, dans le Guide
d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez :
tIngresOutputBulkExec
tIngresOutputBulkExec
Les composants tIngresOutputBulk et tIngresBulkExec sont gnralement utiliss ensemble comme deux
parties d'un processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime
tape, ce fichier est utilis lors de l'opration d'INSERT afin de peupler une base de donnes. Cette excution en
deux tapes est unifie dans le composant tIngresOutputBulkExec.
Famille de composant Databases/Ingres
Fonction Le composant tIngresOutputBulkExec prpare un fichier de sortie et l'utilise pour alimenter une
table dans le SGBD Ingres.
Objectif Le tIngresOutputBulkExec insre des donnes en masse dans le SGBD Ingres afin d'optimiser
les performances.
Basic settings Property type Peut tre Built-in ou Repository
copie. Cette clause peut tre utilise uniquement sur des tables ayant
une structure de stockage B-tree.
Row Estimate Spcifiez le nombre estim de lignes copier d'un fichier une table
durant l'opration de copie de masse.
Trailing WhiteSpace Coche par dfaut, cette case est conue pour supprimer les espaces
en fin de champ et s'applique uniquement aux types de donnes
VARCHAR, NVARCHAR et TEXT.
Encoding Slectionnez l'encodage partir de la liste ou slectionnez Custom
et dfinissez-le manuellement. Ce champ est obligatoire pour la
manipulation des donnes des bases de donnes.
Output Emplacement o crire le message d'erreur :
Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont
pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton
Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter
dans l'onglet Modules de la perspective Integration de votre studio. Pour plus d'informations,
consultez la page https://help.talend.com/display/KB/How+to+install+external+modules+in+the
+Talend+products (en anglais) ou la section dcrivant comment configurer le studio, dans le Guide
d'installation et de migration Talend.
2. Dans le champ Server, saisissez l'adresse du serveur o se trouve le SGBD Ingres, par exemple "localhost".
3. Dans le champ Database, saisissez le nom de la base de donnes Ingres, par exemple "research".
Une variable de contexte est utilise pour le mot de passe. Pour plus d'informations concernant les variables
de contexte, consultez le Guide utilisateur du Studio Talend.
6. Slectionnez le fichier source en cliquant sur le bouton [...] ct du champ File name/Stream et en
parcourant votre systme.
7. Cliquez sur le bouton [...] ct du champ Edit schema afin d'ouvrir l'diteur de schma.
8. Cliquez quatre fois sur le bouton [+] pour ajouter quatre colonnes, par exemple name, age, job et dept, dont
le type de donnes est respectivement string, Integer, string et string.
Cliquez sur Yes dans la fentre qui s'ouvre afin d'accepter la propagation des modifications au composant
suivant.
10. Dans le champ Table, saisissez le nom de la table pour l'insertion de donnes.
11. Dans les champs VNode et Database, saisissez le nom du nud virtuel et de la base de donnes.
12. Dans le champ File Name, saisissez le chemin d'accs complet au fichier qui contiendra les donnes du
fichier source.
Excuter le Job
1. Appuyez sur les touches Ctrl+S afin de sauvegarder votre Job.
Comme affich ci-dessus, les donnes concernant les employs sont crites dans la table employee dans la
base de donnes research, sur le nud talendbj. Le fichier de sortie employee_research.csv a t gnr
l'emplacement spcifi, C:/Users/talend/Desktop.
Scnarios associs
Pour des scnarios associs, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC,
tIngresRollback
Proprits du tIngresRollback
Famille de composant Databases/Ingres
Fonction Le tIngresRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant de connexion tIngresConnection dans
la liste si vous prvoyez d'ajouter plus d'une connexion votre Job
en cours.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en association avec des composants Ingres, notamment avec
le tIngresConnection et le tIngresCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au tIngresRollback, consultez Scnario : Annuler l'insertion de donnes dans des tables
mre/fille du composant tMysqlRollback.
tIngresRow
Proprits du tIngresRow
Famille de Databases/
composant Ingres
Fonction tIngresRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares
sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien
que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tIngresRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property Peut tre Built-in ou Repository.
type
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion cre
par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement le Guide
utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si vous
souhaitez propager les modifications uniquement au Job courant, slectionnez No et slectionnez
nouveau la mtadonne du schma dans la fentre [Repository Content].
Table Name Nom de la table traiter.
Query type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour terminer
le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les
lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
settings QUERY's Slectionnez cette colonne dans la liste use column.
recordset
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatement
de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des
paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query de l'onglet
Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte.
Elle permet un gain de performance.
Commit Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette option
every garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance
d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
tIngresSCD
Le composant tIngresSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus
d'informations, consultez tIngresSCD.
tNetezzaBulkExec
Proprits du tNetezzaBulkExec
Famille de Databases/Netezza
composant
Fonction Le composant tNetezzaBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tNetezzaBulkExec est un composant ddi qui permet un gain de performance pendant les oprations d'Insert
dans une base de donnes Netezza.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants
sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Ce fichier doit se situer sur la mme machine que le Studio Talend ou le Job contenant
un tNetezzaBulkExec, afin que le composant fonctionne correctement.
Advanced Field Separator Caractre, chane ou expression rgulire sparant les champs.
settings
Escape character Caractre d'chappement de la ligne.
Date format / Date Date format: Utilisez ce champ pour reprsenter l'ordre des mois, des jours et des annes
delimiter sous forme de chane de caractres.
Date delimiter : Utilisez ce champ pour dfinir l'lment sparateur entre les valeurs.
Time format/ Time Time format : Utilisez ce champ pour reprsenter le format de l'heure sous forme de
delimiter chane de caractres.
Time delimiter : Utilisez ce champ pour dfinir l'lment sparateur entre les valeurs.
Encoding Slectionnez l'encodage partir de la liste ou slectionnez Custom et dfinissez-le
manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de
donnes.
Max Errors Saisissez le nombre maximal d'erreurs possibles avant que le processus ne s'arrte.
Skip Rows Renseignez le nombre de lignes ignorer.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est principalement utilis lorsque des transformations non particulires sont requises sur les
donnes charger dans la base de donnes Netezza.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour des scnarios associs au composant tNetezzaBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tNetezzaClose
Proprits du tNetezzaClose
Famille de composant Databases/Netezza
Fonction Le composant tNetezzaClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes Netezza.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tNetezzaConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tNetezzaConnection et tNetezzaRollback. Il est gnralement
utilis avec un composant tNetezzaConnection car il permet de fermer une connexion pour la transaction en cours.
tNetezzaCommit
Proprits du tNetezzaCommit
Famille de composant Databases/Netezza
Fonction Le composant tNetezzaCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tNetezzaConnection dans la liste.
Close Connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants Netezza et notamment avec les
composants tNetezzaConnection et tNetezzaRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tNetezzaCommit, consultez Scnario 1 :
Insrer des donnes dans des tables mre/fille.
tNetezzaConnection
Proprits du tNetezzaConnection
Famille de composant Databases/Netezza
Fonction Le composant tNetezzaConnection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au composant tNetezzaConnection, consultez Scnario 1 : Insrer des donnes dans
des tables mre/fille.
tNetezzaInput
Proprits du tNetezzaInput
Famille de Databases/
composant Netezza
Fonction Le composant tNetezzaInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tNetezzaInput excute une requte de base de donnes dans laquelle l'ordre doit strictement correspondre
l'ordre dfini dans le schma. Puis la liste des champs est transmise au composant via une connexion Main row.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionne le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de donnes
et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du
composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base de
donnes, consultez le Guide utilisateur du Studio Talend.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste Component
existing list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion cre
par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le Guide
utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si vous
souhaitez propager les modifications uniquement au Job courant, slectionnez No et slectionnez
nouveau la mtadonne du schma dans la fentre [Repository Content].
Table name Nom de la table de base de donnes.
Query type et Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des champs
Query corresponde celui dfini dans le schma.
Advanced Use cursor Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en une
settings fois. Cette option permet d'optimiser les performances.
Trim all Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes
the String/ contenant des chanes de caractres.
Char
columns
Trim column Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Netezza.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Consultez les scnarios du composant tNetezzaInput dans :
Pour un scnario associ, consultez Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL
l'aide de paramtres de connexion chargs dynamiquement du composant tContextLoad.
tNetezzaNzLoad
Ce composant invoque l'utilitaire nzload de Netezza afin d'insrer des enregistrements dans une base de donnes
Netezza. Ce composant peut tre utilis soit en mode standalone, il chargera alors les donnes partir d'un fichier
de donnes existant, soit connect un flux d'entre, afin de charger des donnes partir du composant connect.
Proprits du tNetezzaNzLoad
Famille de composant Databases/Netezza
Fonction Le composant tNetezzaNzLoad insre des donnes dans la table d'une base de donnes Netezza
via l'utilitaire nzload de Netezza.
Objectif Ce composant permet de charger en masse des donnes dans une table Netezza soit partir d'un
fichier, soit partir d'un flux d'entre, soit partir d'un tube nomm.
Basic settings Property type Peut tre Built-in ou Repository
Drop and create the table : supprimer la table puis en crer une
nouvelle.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est principalement utilis lorsque des transformations particulires ne sont pas
requises sur les donnes charger dans la base de donnes.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Type de donnes Format de date dans le schma -dateStyle -dateDelim -timeStyle -timeDelim
DATE "yyyy-MM-dd" "YMD" "-" n/a n/a
TIME "HH:mm:ss" n/a n/a "24HOUR" ":"
TIMESTAMP "yyyy-MM-dd HH:mm:ss" "YMD" "-" "24HOUR" ":"
Scnario associ
Pour un scnario associ, consultez Scnario : Insrer des donnes dans une base MySQL du composant
tMysqlOutputBulkExec.
tNetezzaOutput
Proprits du tNetezzaOutput
Famille de Databases/Netezza
composant
Fonction Le composant tNetezzaOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tNetezzaOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants
sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base
de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue
Basic settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de
base de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer
une nouvelle.
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des
doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers
(integer) ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont
pas entoures de guillemets. Si c'est le cas, vous devez supprimer manuellement les
guillemets.
Advanced settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes cre.
parameters Cette option est disponible lorsque la case Use an existing connection est dcoche dans
les Basic settings.
Vous pouvez appuyer sur Ctrl+Espace afin d'accder une liste de variables
globales prdfinies.
Use Batch size Cochez cette case afin d'activer le mode batch pour le traitement des donnes. Dans le
champ Batch Size qui apparat, vous pouvez saisir le nombre de lignes par lot charger.
Cette case est disponible uniquement si vous avez slectionn l'option Insert,
Update ou Delete dans la liste Action on data.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une
meilleure performance d'excution.
Additional Columns Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous
l'ayez pralablement supprime ou non). Cette option vous permet d'effectuer des actions
sur les colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou
qui ncessitent un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les
donnes dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur
la colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant
tNetezzaOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle
modifier.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions
sur les donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un
entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
Netezza. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour
un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject du
composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas fournis.
Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans l'onglet
Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de la
perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tNetezzaOutput, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tNetezzaRollback
Proprits du tNetezzaRollback
Famille de composant Databases/Netezza
Fonction Le tNetezzaRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant permet d'viter le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant tNetezzaConnection dans la liste s'il y a
plus d'une connexion dans votre Job.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Netezza, notamment les
composants tNetezzaConnection et tNetezzaCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tNetezzaRollback, consultez Scnario : Annuler l'insertion de donnes
dans des tables mre/fille.
tNetezzaRow
Proprits du tNetezzaRow
Famille de Databases/
composant Netezza
Fonction tNetezzaRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares
sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien
que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tNetezzaRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette
settings parameters option est disponible lorsque la case Use an existing connection est dcoche dans les Basic
settings.
Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
QUERY's Slectionnez cette colonne dans la liste use column.
recordset
Cette option permet au composant d'avoir un schma diffrent de celui du
composant prcdent. De plus, la colonne contenant le rsultat de la requte doit
tre de type Object. Ce composant est gnralement suivi du tParseRecordSet.
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatement de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des
paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query de
l'onglet Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
Variables
NB_EFFECTED : nombre de lignes tablies. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au composant tNetezzaRow, consultez :
tNetezzaSCD
Le composant tNetezzaSCD appartient deux familles de composants : Business Intelligence et Databases. Pour
plus d'informations sur ce composant, consultez tNetezzaSCD.
tParAccelBulkExec
Proprits du tParAccelBulkExec
Les composants tParAccelOutputBulk et tParAccelBulkExec sont gnralement utiliss ensemble pour d'une
part gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tParAccelOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le changement des donnes dans la base de donnes.
Famille de Databases/ParAccel
composant
Fonction Le composant tParAccelBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tParAccelBulkExec est un composant ddi qui permet un gain de performance pendant les oprations
d'Insert dans une base de donnes ParAccel.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants
sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en crer
une nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut
tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers
(integer) ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont
pas entoures de guillemets. Si c'est le cas, vous devez supprimer manuellement les
guillemets.
Parallel : Mode permettant d'utiliser plusieurs API internes ParAccel, afin d'amliorer
les performances de chargement.
Filename Nom du fichier charger.
Ce fichier est situ sur la machine spcifie par l'URI dans le champ Host et
doit tre sur la mme machine que le serveur de la base de donnes.
File Type Slectionnez dans la liste le type de fichier.
Field Layout Slectionnez dans la liste la disposition du fichier.
Field separator Caractre, chane ou expression rgulire sparant les champs (si vous chargez un fichier
dlimit).
Explicit IDs L'ID sera assign directement par la base de donnes ou est dj prsent dans le fichier
charger.
Remove Quotes Cochez cette case afin de retirer les guillemets de votre fichier charger.
Max. Errors Saisissez le nombre maximal d'erreurs avant que votre Job ne s'arrte.
Date Format Saisissez le format de date qui sera utilis.
Time/Timestamp Saisissez le format de date et heure qui sera utilis.
Format
Additional COPY Saisissez l'option spcifique ParAccel et personnalise que vous souhaitez utiliser.
Options
Log file Saisissez le chemin d'accs votre fichier de log, ou parcourez votre rpertoire.
Logging level Slectionnez le niveau de verbose retourner.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec un composant tParAccelOutputBulk. Ensemble, ils offrent un
gain de performance important pour l'alimentation d'une base de donnes ParAccel.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour plus d'informations relatives au fonctionnement de tParAccelBulkExec, consultez les scnarios suivants
dans :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
Scnario : Insrer des donnes dans une base MySQL du composant tMysqlOutputBulkExec.
Scnario : Supprimer et insrer des donnes dans une base Oracle du composant tOracleBulkExec.
tParAccelClose
Proprits du tParAccelClose
Famille de composant Databases/ParAccel
Fonction Le composant tParAccelClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes ParAccel.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tParAccelConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tParAccelConnection et tParAccelRollback. Il est
gnralement utilis avec un composant tParAccelConnection car il permet de fermer une connexion pour la
transaction en cours.
tParAccelCommit
Proprits du tParAccelCommit
Famille de composant Databases/ParAccel
Fonction Le composant tParAccelCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tParAccelConnection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants ParAccel et notamment
tParAccelConnection et tParAccelRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tParAccelCommit, consultez Scnario 1 : Insrer des donnes dans des
tables mre/fille.
tParAccelConnection
Proprits du tParAccelConnection
Famille de composant Databases/ParAccel
Fonction Le composant tParAccelConnection ouvre une connexion vers une base de donnes afin
d'effectuer une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au composant tParAccelConnection, consultez tMysqlConnection.
tParAccelInput
Proprits du tParAccelInput
Famille de Databases/
composant ParAccel
Fonction Le composant tParAccelInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tParAccelInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui
dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion
de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes ParAccel.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tParAccelInput :
tParAccelOutput
Proprits du tParAccelOutput
Famille de Databases/
composant ParAccel
Fonction Le composant tParAccelOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tParAccelOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
settings option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous l'ayez
Columns pralablement supprime ou non). Cette option vous permet d'effectuer des actions sur les
colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui ncessitent
un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes
dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur la
colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant tParAccelOutput
peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur
les donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
ParAccel. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur.
Pour un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject
du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tParAccelOutput consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
tDBOutput.
tParAccelOutputBulk
Proprits du tParAccelOutputBulk
Les composants tParAccelOutputBulk et tParAccelBulkExec sont gnralement utiliss ensemble pour d'une
part gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tParAccelOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le chargement des donnes dans la base de donnes.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis avec le composant tParAccelBulkExec. Ensemble ils
offrent un gain de performance important pour l'alimentation d'une base de donnes ParAccel.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Scnarios associs
Pour un scnario associ au composant tParAccelOutputBulk, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tParAccelOutputBulkExec
Proprits du tParAccelOutputBulkExec
Les composants tParAccelOutputBulk et tParAccelBulkExec sont gnralement utiliss ensemble comme deux
parties d'un processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime
tape, ce fichier est utilis lors de l'opration d'INSERT afin de peupler une base de donnes. Cette excution en
deux tapes est unifie dans le composant tParAccelOutputBulkExec.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Log file Saisissez le chemin d'accs votre fichier de log, ou parcourez votre
rpertoire.
Logging level Slectionnez le niveau de verbose retourner.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant est principalement utilis lorsqu'aucune transformation particulire n'est requise sur
les donnes charger dans la base de donnes.
Limitation Le serveur de la base de donnes doit tre install sur la mme machine que le Studio Talend ou que
le Job contenant un tParAccelOutputBulkExec, afin que le composant fonctionne correctement.
Scnarios associs
Pour un scnario associ au composant tParAccelOutputBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tParAccelRollback
Proprits du tParAccelRollback
Famille de composant Databases/ParAccel
Fonction Le tParAccelRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant permet d'viter le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant tParAccelConnection dans la liste s'il y
a plus d'une connexion dans votre Job.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants ParAccel, notamment les
composants tParAccelConnection et tParAccelCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tParAccelRollback, consultez Scnario : Annuler l'insertion de donnes
dans des tables mre/fille.
tParAccelRow
Proprits du tParAccelRow
Famille de Databases/
composant ParAccel
Fonction Le tParAccelRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL
dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans
le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tParAccelRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
settings QUERY's Slectionnez cette colonne dans la liste use column.
recordset
Cette option permet au composant d'avoir un schma diffrent de celui du
composant prcdent. De plus, la colonne contenant le rsultat de la requte doit
tre de type Object. Ce composant est gnralement suivi du tParseRecordSet.
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatement de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des
paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query de
l'onglet Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
tParAccelSCD
Le composant tParAccelSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tParAccelSCD.
tRedshiftBulkExec
Proprits du tRedshiftBulkExec
Les composants tRedshiftOutputBulk et tRedshiftBulkExec sont gnralement utiliss ensemble comme deux
parties d'un processus pour charger des donnes dans Amazon Redshift partir d'un fichier CSV/dlimit dans
Amazon S3. Au cours de la premire tape, un fichier dlimlit/CSV est gnr. Au cours de la seconde tape, le
fichier est utilis dans une instruction INSERT utilise pour alimenter. Cette excution en deux tapes est unifie
dans le composant tRedshiftOutputBulkExec. L'intrt de proposer deux composants spars rside dans le fait
que cela permet de procder des transformations avant le changement des donnes dans Amazon Redshift.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Proprit utilise ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
Database settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir
connection de la liste Component list pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Host Saisissez l'adresse IP ou le nom de l'hte du serveur de la base de donnes.
Port Saisissez le numro du port d'coute du serveur de la base de donnes.
Database Saisissez le nom de la base de donnes.
Schema Saisissez le nom du schma.
Username et Password Saisissez les donnes d'authentification de l'utilisateur de la base de donnes.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Table Name Spcifiez le nom de la table crire. Notez que seule une table peut tre crite
la fois.
Action on table Sur la table dfinie, vous pouvez effectuer l'une des oprations suivantes :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis
en crer une nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi,
il peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Cette liste est disponible uniquement lorsque l'option Delimited file or CSV
est slectionne dans la liste File type.
JSON mapping Spcifiez comment mapper les lments de donnes dans le fichier JSON
source dans Amazon S3 vers les colonnes dans la table cible d'Amazon
Redshift. Les valeurs valides sont :
auto : mappe les donnes en faisant correspondre les cls ou noms des objets
dans les paires source nom/valeur vers les noms de colonnes dans la table
cible. L'argument est sensible la casse et doit tre entour de guillemets
doubles.
ColumnLabel1:ColumnWidth1,ColumnLabel2:ColumnWidth2,....
Notez que le libell de la colonne dans la chane de caractres n'a aucun lien
avec le nom de la colonne de la table et peut tre une chane de caractres ou
un entier. L'ordre des paires libell/largeur doit correspondre l'ordre exact des
colonnes de la table.
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Le composant tRedshiftBulkExec supporte le chargement des donnes dans Amazon Redshift depuis un
fichier dlimit/CSV, JSON, ou taille fixe, dans Amazon S3, mais le composant tRedshiftOutputBulk
supporte uniquement la gnration et le chargement d'un fichier dlimit/CSV dans Amazon S3. Lorsque
vous devez charger des donnes depuis un fichier JSON ou taille fixe, vous pouvez utiliser le
composant tFileOutputJSON ou tFileOutputpositional avec le tS3Put au lieu d'utiliser le composant
tRedshiftOutputBulk pour gnrer et charger le fichier dans Amazon S3.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Prrequis :
Les variables de contexte sont cres et sauvegardes dans la vue Repository. Pour plus d'informations concernant
les variables de contexte, consultez le Guide utilisateur du Studio Talend.
Notez que toutes les valeurs de contexte dans la capture d'cran ci-dessus ont pour seul objectif la dmonstration.
2. Ajoutez les composants suivants en saisissant leur nom dans l'espace de modlisation graphique ou
en les dposant depuis la Palette : un composant tRowGenerator, un tRedshiftOutputBulk, un
tRedshiftBulkExec, un tRedshiftInput, un tLogRow, un tRedshiftUnload, un tS3List et un tS3Get.
6. Reliez le tRowGenerator au tRedshiftBulkExec l'aide d'un lien Trigger > On Subjob Ok.
2. Cliquez deux fois sur le bouton [+] afin d'ajouter deux colonnes : ID, de type Integer et Name, de type String.
3. Cliquez dans la cellule de la colonne Functions et slectionnez dans la liste une fonction pour chaque colonne.
Dans cet exemple, slectionnez Numeric.sequence pour gnrer des nombres en squence pour la colonne ID
et slectionnez TalendDataGenerator.getFirstName afin de gnrer des prnoms alatoires pour la colonne
Name.
4. Dans le champ Number of Rows for RowGenerator, saisissez le nombre de lignes de donnes gnrer.
Dans cet exemple, saisissez 20.
5. Cliquez sur OK pour fermer l'diteur de schma et acceptez la propagation propose par la bote de dialogue
qui s'ouvre.
7. Dans le champ Data file path at local, spcifiez le chemin local pour le fichier gnrer. Dans cet exemple,
le chemin est E:/Redshift/redshift_bulk.txt.
8. Dans le champ Access Key, appuyez sur les touches Ctrl + Espace et, dans la liste, slectionnez
context.s3_accesskey afin de renseigner ce champ.
Rptez l'opration dans le champ Secret Key avec la valeur context.s3_accesskey et dans le champ Bucket
avec la valeur context.s3_bucket.
9. Dans le champ Key, saisissez un nouveau nom pour le fichier gnrer aprs chargement dans Amazon S3.
Dans cet exemple, saisissez person_load.
2. Dans le champ Host, appuyez sur les touches Ctrl + Espace et, dans la liste, slectionnez
context.redshift_host afin de renseigner ce champ.
3. Dan le champ Table Name, saisissez le nom de la table crire. Dans cet exemple, saisissez person.
4. Dans la liste Action on table, slectionnez Drop table if exists and create.
5. Dans le champ Key, saisissez le nom du fichier de Amazon S3 charger. Dans cet exemple, saisissez
person_load.
6. Cliquez sur le bouton [...] ct du champ Edit schema et, dans la fentre qui s'ouvre, dfinissez le schma
en ajoutant deux colonnes : ID de type Integer et Name, de type String.
2. Renseignez les champs Host, Port, Database, Schema, Username et Password avec les variables de
contexte correspondantes.
3. Dans le champ Table Name, saisissez le nom de la table lire. Dans cet exemple, saisissez person.
4. Cliquez sur le bouton [...] ct du champ Edit schema et, dans la fentre qui s'ouvre, dfinissez le schma
en ajoutant deux colonnes : ID de type Integer et Name, de type String.
5. Dans le champ Query, saisissez l'instruction SQL suivante permettant de rcuprer les donnes.
7. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un affichage optimal des
rsultats.
2. Renseignez les champs Host, Port, Database, Schema, Username et Password avec les variables de
contexte correspondantes.
Renseignez les champs Access Key, Secret Key et Bucket avec les variables de contexte correspondantes.
3. Dans le champ Table Name, saisissez le nom de la table de laquelle lire les donnes. Dans cet exemple,
saisissez person.
4. Cliquez sur le bouton [...] ct du champ Edit schema et, dans la fentre qui s'ouvre, dfinissez le schma
en ajoutant deux colonnes : ID, de type Integer et Name, de type String.
5. Dans le champ Query, saisissez l'instruction SQL suivante partir de laquelle les rsultats seront retirs.
"SELECT * FROM person"
6. Dans le champ Key prefix, saisissez le prfixe du nom pour les fichiers retirer. Dans cet exemple, saisissez
person_unload_.
2. Renseignez les champs Access Key et Secret Key avec les variables de contexte correspondantes.
3. Dans la liste Region, slectionnez la rgion AWS pour laquelle les fichiers retirs sont crs. Dans cet
exemple, saisissez US Standard.
4. Dcochez la case List all buckets objects et cliquez sur le bouton [+] sous la table pour ajouter une ligne.
Renseignez la colonne Bucket name avec le nom du bucket dans lequel les fichiers retirs sont crs. Dans
cet exemple, saisissez la variable de contexte context.s3_bucket.
Renseignez la colonne Key prefix avec le prfixe du nom des fichiers retirs. Dans cet exemple, saisissez
person_unload_.
6. Renseignez les champs Access Key et Secret Key avec les variables de contexte correspondantes.
7. Dans la liste Region, slectionnez la rgion AWS dans laquelle les fichiers retirs sont crs. Dans cet
exemple, slectionnez US Standard.
8. Dans le champ Bucket, saisissez le nom du bucket dans lequel les fichiers retirs sont crs. Dans cet exemple,
saisissez la variable de contexte context.s3_bucket.
Dans le champ Key, saisissez le nom des fichiers retirs, en appuyant sur les touches Ctrl+Espace et, dans
la liste, slectionnez la variable globale ((String)globalMap.get("tS3List_1_CURRENT_KEY")).
9. Dans le champ File, saisissez le chemin d'accs local l'emplacement o les fichiers retirs sont sauvegards.
Dans cet exemple, saisissez "E:/Redshift/" + ((String)globalMap.get("tS3List_1_CURRENT_KEY")).
2. Excutez le Job en appuyant sur F6 ou en appuyant sur le bouton Run de la vue Run.
Comme affich ci-dessus, les donnes gnres sont crites dans le fichier local redshift_bulk.txt. Le fichier
est charg dans S3 avec un nouveau nom, person_load. Les donnes sont charges du fichier S3 dans la
table person de Redshift et affiches dans la console. Les donnes sont ensuite retires de la table personn
de Redshift et ajoutes deux fichiers person_unload_0000_part_00 et person_unload_0001_part_00 dans
S3, par slice du cluster Redshift, puis les fichiers retirs de S3 sont lists et rcuprs dans le dossier local.
tRedshiftClose
Proprits du tRedshiftClose
Famille de composant Databases/Amazon Redshift
Fonction Le composant tRedshiftClose ferme la connexion une base de donnes connecte.
Objectif Ce composant est utilis avec le tRedShiftConnection et le tRedshiftCommit pour assurer
l'intgrit de la transaction effectue dans la base de donnes.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez
le composant tRedshiftConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau
du composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec les composants Amazon Redshift, notamment le
tRedshiftConnection et le tRedshiftCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Scnario : Manipuler des donnes avec Redshift.
tRedshiftCommit
Proprits du tRedshiftCommit
Famille de composant Databases/Amazon Redshift
Fonction Le composant tRedshiftCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours,
slectionnez le composant tRedshiftConnection dans la
liste.
Close Connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion
une fois que le composant a excut sa tche.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants Amazon Redshift, notamment le
tRedshiftConnection et le tRedshiftRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario du mme type, consultez Scnario 1 : Insrer des donnes dans des tables mre/fille.
tRedshiftConnection
Proprits du tRedshiftConnection
Famille de composant Databases/Amazon
Redshift
Fonction Le composant tRedshiftConnection ouvre une connexion vers une base de donnes afin d'effectuer une
transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir la
rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits
du composant. Les champs suivants sont alors pr-remplis l'aide des donnes
collectes.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom du schma.
Username et Password Informations d'authentification de l'utilisateur de base de donnes.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Use or register a shared Cochez cette case pour partager votre connexion ou rcuprer une connexion
DB Connection mise en partage dans un Job pre ou un Job fils. Cette option vous permet de
partager une seule connexion une base de donnes dans plusieurs composants
de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui
peuvent tre des Jobs parent ou enfant.
Cette option est incompatible avec les options Use dynamic job et
Use an independent process to run subjob du composant tRunJob.
Utiliser une connexion partage avec un tRunJob ayant l'une de ces
options active fera chouer votre Job.
Lorsque cette case est coche, vous ne pouvez utiliser les composants de commit
correspondant pour commiter les modifications dans la base de donnes. De
la mme manire, lorsque vous utilisez un composant de commit, cette case
doit tre dcoche. Par dfaut, la fonctionnalit d'auto-commit est dsactive
et les modifications doivent tre commites de manire explicite l'aide du
composant correspondant de commit.
despace pour grer vos transactions dans un Job, il est recommand d'utiliser
un composant Commit.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job
qu'au niveau de chaque composant.
Utilisation Ce composant est gnralement utilis avec des composants Amazon Redshift, notamment les composants
tRedshiftCommit et tRedshiftRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont
pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton
Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans
l'onglet Modules de la perspective Integration de votre studio. Pour plus d'informations, consultez
la page https://help.talend.com/display/KB/How+to+install+external+modules+in+the+Talend+products
(en anglais) ou la section dcrivant comment configurer le studio, dans le Guide d'installation et de
migration Talend.
Scnario associ
Pour un scnario associ, consultez Scnario : Manipuler des donnes avec Redshift.
tRedshiftInput
Proprits du tRedshiftInput
Famille de Databases/Amazon
composant Redshift
Fonction Le composant tRedshiftInput excute une requte en base de donnes selon un ordre strict qui doit correspondre
celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une
connexion de flux (Main row).
Objectif Le tRedshiftInput lit une base de donnes et en extrait des champs l'aide de requtes.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de
base de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Amazon Redshift.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
un tFixedFlowInput, qui dfinit la structure des informations personnelles et envoie ces donnes au composant
suivant.
un tRedshiftOutput, qui crit les donnes reues par le composant prcdent dans Redshift.
un tLogRow, qui affiche les donnes reues par le composant prcdent dans la console.
Dans les champs Host, Port, Database, Schema, Username et Password, saisissez les informations
ncessaires pour se connecter Redshift.
3. Dans la vue Advanced settings, cochez la case Auto Commit afin de commiter tous les changements vers
Redshift chaque transaction.
2. Cliquez sur le bouton [...] ct du champ Edit schema afin d'ouvrir l'diteur de schma.
3. Dans l'diteur de schma, cliquez sur le bouton [+] pour ajouter trois colonnes : id de type Integer, name
de type String et age de type Integer.
4. Cliquez sur OK pour valider les modifications puis acceptez la propagation propose par la fentre pop-up
[Propagate] en appuyant sur le bouton Yes.
5. Dans la zone Mode, slectionnez Use Inline Content (delimited file) et saisissez les informations
personnelles dans le champ Content.
1;Arthur;16
2;Ford;18
3;Jackson;17
2. Cochez la case Use an existing connection puis slectionnez la connexion prcdemment configure dans
le tRedshiftConnection, dans la liste droulante Component List.
3. Dans le champ Table, parcourez ou saisissez le chemin d'accs la table dans laquelle crire les donnes,
redshiftexample dans ce scnario.
4. Slectionnez Drop table if exists and create dans la liste Action on table et slectionnez Insert dans la
liste Action on data.
2. Cochez la case Use an existing connection et slectionnez la connexion prcdemment configure dans le
tRedshiftConnection, dans la liste Component List.
3. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir l'diteur de schma.
4. Dans l'diteur de schma, cliquez trois fois sur le bouton [+] pour ajouter trois colonnes, respectivement :
id, de type Integer, name, de type String et age, de type Integer. La structure des donnes est la mme que
celle dfinie dans le tFixedFlowInput.
5. Cliquez sur OK afin de valider les modifications, puis acceptez la propagation propose par la fentre
[Propagate] qui s'ouvre.
6. Dans le champ Table Name, parcourez ou saisissez le chemin d'accs la table dans laquelle vous souhaitez
crire les donnes, redshiftexample dans cet exemple.
7. Cliquez sur le bouton Guess Query pour gnrer la requte. Le champ Query contient automatiquement la
requte gnre.
2. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un meilleur affichage des
rsultats.
Les informations personnelles sont crites dans la base de donnes cible Redshift et les donnes sont
rcupres de la base de donnes et affiches dans la console.
tRedshiftOutput
Proprits du tRedshiftOutput
Famille de Databases/Amazon
composant Redshift
Fonction Le composant tRedshiftOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction
du flux entrant provenant du composant prcdent.
Objectif Le tRedshiftOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de
base de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des
doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures
de guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Number of rows per insert : saisissez le nombre de lignes insrer par opration.
Notez que, plus la valeur spcifie est grande, plus la performance est faible, cause de
l'augmentation de la sollicitation de la mmoire.
Cette option est incompatible avec le lien Reject. Vous devez dcochez la case
si vous utilisez un lien Row > Rejects avec ce composant.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une
meilleure performance d'excution.
Additional Columns Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous l'ayez
pralablement supprime ou non). Cette option vous permet d'effectuer des actions sur
les colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui
ncessitent un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les
donnes dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur
la colonne de rfrence.
Reference column: Saisissez une colonne de rfrence que le composant tDBOutput peut
utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions
sur les donnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes
SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes Amazon
Redshift. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour
un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez Scnario : Manipuler des donnes avec Redshift.
tRedshiftOutputBulk
Proprits du tRedshiftOutputBulk
Les composants tRedshiftOutputBulk et tRedshiftBulkExec sont gnralement utiliss ensemble comme deux
parties d'un processus pour charger des donnes dans Amazon Redshift partir d'un fichier CSV/dlimit dans
Amazon S3. Au cours de la premire tape, un fichier dlimlit/CSV est gnr. Au cours de la seconde tape, le
fichier est utilis dans une instruction INSERT utilise pour alimenter. Cette excution en deux tapes est unifie
dans le composant tRedshiftOutputBulkExec. L'intrt de proposer deux composants spars rside dans le fait
que cela permet de procder des transformations avant le changement des donnes dans Amazon Redshift.
Notez que ce fichier est gnr sur la machine o est install le Studio ou sur
laquelle le Job utilisant ce composant est dploy.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (Built-in),
soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi,
il peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Cette case est indisponible lorsque la case Append the local file est coche.
S3 Setting Access Key Spcifiez l'ID de la cl d'accs identifiant de manire unique un compte AWS.
Pour plus d'informations concernant l'obtention de votre cl d'accs et cl
secrte, consultez Getting Your AWS Access Keys (en anglais).
Secret Key Spcifiez la cl secrte d'accs, constituant les informations de scurit, ainsi
que la cl d'accs.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec le composant tRedshiftBulkExec pour alimenter Amazon
Redshift avec un fichier dlimit/CSV. Utiliss ensemble, ils permettent de maximiser les performances
lorsqu'ils alimentent Amazon Redshift.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Charger/retirer des donnes dans/de Amazon S3.
tRedshiftOutputBulkExec
Proprits du tRedshiftOutputBulkExec
Les composants tRedshiftOutputBulk et tRedshiftBulkExec sont gnralement utiliss ensemble comme deux
parties d'un processus pour charger des donnes dans Amazon Redshift partir d'un fichier CSV/dlimit dans
Amazon S3. Au cours de la premire tape, un fichier dlimlit/CSV est gnr. Au cours de la seconde tape, le
fichier est utilis dans une instruction INSERT utilise pour alimenter. Cette excution en deux tapes est unifie
dans le composant tRedshiftOutputBulkExec. L'intrt de proposer deux composants spars rside dans le fait
que cela permet de procder des transformations avant le changement des donnes dans Amazon Redshift.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
Database settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir
connection de la liste Component list pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Host Saisissez l'adresse IP ou le nom de l'hte du serveur de la base de donnes.
Port Saisissez le numro du port d'coute du serveur de la base de donnes.
Database Saisissez le nom de la base de donnes.
Schema Saisissez le nom du schma.
Username et Password Saisissez les donnes d'authentification de l'utilisateur de la base de donnes.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Table Name Spcifiez le nom de la table crire. Note que seule une table peut tre crite
la fois.
Action on table Sur la table dfinie, vous pouvez effectuer l'une des oprations suivantes :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis
en crer une nouvelle.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (Built-in),
soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi,
il peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Notez que le fichier est gnr sur la machine o est install le Studio ou sur
celle o le Job utilisant ce composant est dploy.
Append the local file Cochez cette case pour crire la suite les donnes dans le fichier local spcifi
s'il existe dj, au lieu de l'craser.
Create directory if not Cochez cette case pour crer le rpertoire spcifi dans le champ Data file path
exists at local s'il n'existe pas. Par dfaut, cette case est coche.
S3 Setting Access Key Spcifiez l'ID de la cl d'accs identifiant de manire unique un compte AWS.
Pour plus d'informations concernant l'obtention de votre cl d'accs et cl
secrte, consultez Getting Your AWS Access Keys (en anglais).
Secret Key Spcifiez la cl secrte d'accs, constituant les informations de scurit, ainsi
que la cl d'accs.
Cette case est indisponible lorsque la case Append the local file est coche.
Encoding Slectionnez un type d'encodage pour les donnes dans le fichier gnrer.
Delete local file after Cochez cette case pour supprimer le fichier local aprs son chargement dans
putting it to s3 Amazon S3. Par dfaut, cette case est coche.
Date format Slectionnez l'un des lments suivants afin de spcifier le format de date dans
les donnes source :
Time format Slectionnez l'un des lments suivants dans la liste, afin de spcifier le format
de l'heure dans les donnes source :
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis lorsqu'aucune transformation particulire n'est requise sur les
donnes charger dans Amazon Redshift.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Charger/retirer des donnes dans/de Amazon S3.
tRedshiftRollback
Proprits du tRedshiftRollback
Famille de composant Databases/Amazon Redshift
Fonction Le tRedshiftRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant permet d'viter le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant tRedshiftConnection dans la liste
s'il y a plus d'une connexion dans votre Job.
Close Connection Dcochez cette case pour continuer utiliser la connexion une
fois que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau
du composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Amazon Redshift, notamment les
composants tRedshiftConnection et tRedshiftCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario du mme type, consultez Scnario : Annuler l'insertion de donnes dans des tables mre/fille.
tRedshiftRow
Proprits du tRedshiftRow
Famille de Databases/Amazon
composant Redshift
Fonction Le tRedshiftRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares
sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien
que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tRedshiftRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants
sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis,
dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles,
puis cliquez sur OK afin de sauvegarder les paramtres.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Guess Query Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de
votre table dans le champ Query.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin
qu'ils correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous
pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row
> Rejects.
Advanced Propagate QUERY's Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en
settings recordset cours. Slectionnez cette colonne dans la liste use column.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une
meilleure performance d'excution.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
Variables
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour des scnarios du mme type, consultez :
tRedshiftUnload
Proprits du tRedshiftUnload
Famille de composant Databases/Amazon
Redshift
Fonction Le composant tRedshiftUnload excute une requte spcifie dans Amazon Redshift et retire le rsultat
de la requte pour l'ajouter un ou plusieurs fichiers dans Amazon S3.
Objectif Ce composant vous permet de retirer des donnes dans Amazon Redshift et les ajouter dans des fichiers
dans Amazon S3.
Basic settings Property Type Peut tre Built-In ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Proprit utilise ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
Database settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir
connection de la liste Component list pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Host Saisissez l'adresse IP ou le nom de l'hte du serveur de la base de donnes.
Port Saisissez le numro du port d'coute du serveur de la base de donnes.
Database Saisissez le nom de la base de donnes.
Schema Saisissez le nom du schma.
Username et Password Saisissez les donnes d'authentification de l'utilisateur de la base de donnes.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Table Name Saisissez le nom de la table de laquelle lire les donnes.
Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (Built-in),
soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi,
il peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Query Type et Query Saisissez votre requte de base de donnes en faisant attention ce que l'ordre
des champs corresponde celui dfini dans le schma.
Guess Query Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au
schma de votre table dans le champ Query.
S3 Setting Access Key Spcifiez l'ID de la cl d'accs identifiant de manire unique un compte AWS.
Pour plus d'informations concernant l'obtention de votre cl d'accs et cl
secrte, consultez Getting Your AWS Access Keys (en anglais).
Secret Key Spcifiez la cl secrte d'accs, constituant les informations de scurit, ainsi
que la cl d'accs.
Cette liste est disponible uniquement lorsque l'option Delimited file or CSV
est slectionne dans la liste File type.
Fixed width mapping Saisissez une chane de caractres spcifiant un libell et une largeur de colonne
personnaliss entre guillemets doubles. Le format de la chane de caractres est :
ColumnLabel1:ColumnWidth1,ColumnLabel2:ColumnWidth2,....
Notez que le libell de colonne dans la chane de caractres n'a aucune relation
avec la nom de la colonne de la table et peut tre une chane de caractres ou un
entier. L'ordre des paires libell/largeur doit correspondre l'ordre des colonnes
des tables.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi qu'au
niveau de chaque composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues
dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes
ayant la mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous
travaillez dans un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par
exemple lorsque votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement
si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous
souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les requtes SQL possibles pour la base de donnes Amazon Redshift.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Charger/retirer des donnes dans/de Amazon S3.
tTeradataClose
Proprits du tTeradataClose
Famille de composant Databases/Teradata
Fonction Le composant tTeradataClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes Teradata.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tTeradataConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tTeradataConnection et tTeradataRollback. Il est
gnralement utilis avec un composant tTeradataConnection car il permet de fermer une connexion pour la
transaction en cours.
tTeradataCommit
Proprits du tTeradataCommit
Famille de composant Databases/Teradata
Fonction Le composant tTeradataCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list Slectionnez le composant tTeradataConnection dans la liste s'il y
a plus d'une connexion dans votre Job.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant est gnralement utilis avec des composants Teradata, notamment les composants
tTeradataConnection et tTeradataRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tTeradataCommit, consultez Scnario 1 :
Insrer des donnes dans des tables mre/fille.
tTeradataConnection
Proprits du tTeradataConnection
Famille de composant Databases/Teradata
Fonction Le composant tTeradataConnection ouvre une connexion vers une base de donnes afin
d'effectuer une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au composant tTeradataConnection, consultez tMysqlConnection.
tTeradataFastExport
Proprits du tTeradataFastExport
Famille de composant Databases/Teradata
Fonction Le composant tTeradataFastExport exporte trs rapidement des lots de donnes volumineux
d'une table ou d'une vue Teradata.
Objectif Le tTeradataFastExport exporte des lots de donnes d'une table Teradata vers un systme client
ou vers une base de donnes plus petite.
Basic settings Use Commandline Cochez cette case pour activer le mode invite de commande.
Use Java API Cochez cette case pour activer le mode Java API.
Property type Peut tre Built-in ou Repository.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Si vous avez slectionn le mode Use Commandline, vous devez installer le client Teradata sur
la machine o se trouve le Job comprenant un tTeradataFastExport.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tTeradataFastLoad
Proprits du tTeradataFastLoad
Famille de composant Databases/Teradata
Fonction Le composant tTeradataFastLoad lit une base de donnes et en extrait des champs l'aide de
requtes.
Objectif Le tTeradataFastLoad excute une requte en base de donnes selon un ordre strict qui doit
correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au
composant suivant via une connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et
retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Teradata.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tTeradataFastLoadUtility
Proprits du tTeradataFastLoadUtility
Famille de composant Databases/Teradata
Fonction Le composant tTeradataFastLoadUtility lit une base de donnes et en extrait des champs l'aide
de requtes.
Objectif Le tTeradataFastLoadUtility excute une requte en base de donnes selon un ordre strict qui
doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise
au composant suivant via une connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Scnario : Insrer des donnes dans une table d'une base de donnes Teradata.
tTeradataInput
Proprits du tTeradataInput
Famille de Databases/
composant Teradata
Fonction Le composant tTeradataInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tTeradataInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui
dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion
de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion cre
par le Job parent avec le Job enfant, vous devez :
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base de
donnes, consultez le Guide utilisateur du Studio Talend.
Host Adresse IP du serveur de base de donnes.
Database Nom de la base de donnes.
Username et Informations d'authentification de l'utilisateur de base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans la
bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis cliquez sur
OK afin de sauvegarder les paramtres.
Schema et Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
Edit Schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Query type et Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des champs
Query corresponde celui dfini dans le schma.
Advanced Additional Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de
settings JDBC donnes, afin de supporter des caractres spcifiques. Exemple : CHARSET=KANJISIS_OS pour
parameters supporter les caractres japonais. Cette option est disponible lorsque la case Use an existing
connection est dcoche dans les Basic settings.
Trim all Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes
the String/ contenant des chanes de caractres.
Char columns
Trim column Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans les colonnes
slectionnes.
Query band Cochez cette case pour utiliser la fonctionnalit Teradata Query Banding afin d'ajouter les
mtadonnes la requte traiter, comme le nom de l'utilisateur excutant la requte. Cela peut
vous permettre, par exemple, d'identifier l'origine de la requte.
Une fois la case coche, la table Query Band parameters s'affiche, dans laquelle vous pouvez
saisir les informations des mtadonnes ajouter. Cette information prend la forme de paires cl/
valeur, par exemple, DpID dans la colonne Key et Finance dans la colonne Value.
Cette case permet de gnrer l'instruction SET QUERY_BAND FOR SESSION avec les paires
cl/valeur dclares dans la table Query Band parameters. Pour plus d'informations concernant
cette instruction, consultez http://www.info.teradata.com/HTMLPubs/DB_TTU_14_00/
index.html#page/SQL_Reference/B035_1144_111A/End_Logging-Syntax.027.143.html (en
anglais).
Cette case est indisponible lorsque vous avez coch la case Using an existing connection. Dans
ce cas, si vous devez utiliser la fonctionnalit Query band, configurez-la dans l'onglet Advanced
settings du composant de connexion Teradata utiliser.
tStat Catcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez :
Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de paramtres de connexion
chargs dynamiquement.
tTeradataMultiLoad
Proprits du tTeradataMultiLoad
Famille de composant Databases/Teradata
Fonction Le composant tTeradataMultiLoad lit une base de donnes et en extrait des champs l'aide de
requtes.
Objectif Le tTeradataMultiLoad excute une requte en base de donnes selon un ordre strict qui doit
correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au
composant suivant via une connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Teradata.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Scnario : Insrer des donnes dans une table d'une base de donnes Teradata.
tTeradataOutput
Proprits du tTeradataOutput
Famille de Databases/
composant Teradata
Fonction Le composant tTeradataOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tTeradataOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
Host Adresse IP du serveur de base de donnes.
Database Nom de la base de donnes.
Username et Informations d'authentification de l'utilisateur de base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans la
bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis cliquez
sur OK afin de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Action on table La liste Action on table est indisponible si vous cochez la case Enable parallel
executiondans la vue Advanced settings.
Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table slectionne :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced settings Additional Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de
JDBC donnes, afin de supporter des caractres spcifiques. Exemple : CHARSET=KANJISIS_OS
parameters pour supporter les caractres japonais. Cette option est disponible lorsque la case Use an
existing connection est dcoche dans les Basic settings.
Vous pouvez appuyer sur Ctrl+Espace afin d'accder une liste de variables
globales prdfinies.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
Cette option n'est pas disponible si vous avez coch la case Use an existing connection dans
la vue Basic settings.
Si vous avez slectionn Drop and create table, Create table, Create table if does
not exist ou Drop table if exists and create dans la liste Action on table, dans la vue
Basic settings, saisissez 0 dans le champ afin d'assurer la validit des instructions
SQL. Pour plus d'informations concernant la validit des instructions SQL dans une
base de donnes Teradata, consultez info.teradata.com (en anglais).
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous l'ayez
Columns pralablement supprime ou non). Cette option vous permet d'effectuer des actions sur les
colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui ncessitent
un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes
dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur la
colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant tTeradataOutput
peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Query band Cochez cette case pour utiliser la fonctionnalit Teradata Query Banding afin d'ajouter les
mtadonnes la requte traiter, comme le nom de l'utilisateur excutant la requte. Cela
peut vous permettre, par exemple, d'identifier l'origine de la requte.
Une fois la case coche, la table Query Band parameters s'affiche, dans laquelle vous pouvez
saisir les informations des mtadonnes ajouter. Cette information prend la forme de paires
cl/valeur, par exemple, DpID dans la colonne Key et Finance dans la colonne Value.
Cette case est indisponible lorsque vous avez coch la case Using an existing connection.
Dans ce cas, si vous devez utiliser la fonctionnalit Query band, configurez-la dans l'onglet
Advanced settings du composant de connexion Teradata utiliser.
Use field Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur
options les donnes.
Enable debug Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
mode donnes.
Use Batch Cochez cette case pour activer le mode de traitement par lots pour le traitement des donnes.
Batch Size Spcifiez le nombre d'enregistrements traiter dans chaque lot. La valeur par dfaut de ce
champ est 10000.
Ce champ est disponible uniquement lorsque la case Use Batch est coche.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un
entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
Teradata. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur.
Pour un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject
du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tTeradataRollback
Proprits du tTeradataRollback
Famille de composant Databases/Teradata
Fonction Le tTeradataRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant tTeradataConnection dans la liste s'il y
a plus d'une connexion dans votre Job.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Teradata, notamment les
composants tTeradataConnection et tTeradataCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tTeradataRollback, consultez Scnario : Annuler l'insertion de donnes
dans des tables mre/fille.
tTeradataRow
Proprits du tTeradataRow
Famille de Databases/
composant Teradata
Fonction Le tTeradataRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares
sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien
que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tTeradataRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Table Name Nom de la table traiter.
Query type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Query Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des champs
corresponde celui dfini dans le schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour terminer
le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les
lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Additional Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de
settings JDBC donnes, afin de supporter des caractres spcifiques. Exemple : CHARSET=KANJISIS_OS pour
parameters supporter les caractres japonais. Cette option est disponible lorsque la case Use an existing
connection est dcoche dans les Basic settings.
Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
QUERY's Slectionnez cette colonne dans la liste use column.
recordset
Cette option permet au composant d'avoir un schma diffrent de celui du composant
prcdent. De plus, la colonne contenant le rsultat de la requte doit tre de type Object.
Ce composant est gnralement suivi du tParseRecordSet.
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatement
de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des
paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query de l'onglet
Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte.
Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
Query band Cochez cette case pour utiliser la fonctionnalit Teradata Query Banding afin d'ajouter les
mtadonnes la requte traiter, comme le nom de l'utilisateur excutant la requte. Cela peut
vous permettre, par exemple, d'identifier l'origine de la requte.
Une fois la case coche, la table Query Band parameters s'affiche, dans laquelle vous pouvez
saisir les informations des mtadonnes ajouter. Cette information prend la forme de paires cl/
valeur, par exemple, DpID dans la colonne Key et Finance dans la colonne Value.
Cette case permet de gnrer l'instruction SET QUERY_BAND FOR SESSION avec les paires
cl/valeur dclares dans la table Query Band parameters. Pour plus d'informations concernant
cette instruction, consultez http://www.info.teradata.com/HTMLPubs/DB_TTU_14_00/
index.html#page/SQL_Reference/B035_1144_111A/End_Logging-Syntax.027.143.html (en
anglais).
Cette case est indisponible lorsque vous avez coch la case Using an existing connection. Dans
ce cas, si vous devez utiliser la fonctionnalit Query band, configurez-la dans l'onglet Advanced
settings du composant de connexion Teradata utiliser.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
Variables
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez :
tTeradataTPTExec
Proprits du tTeradataTPTExec
Famille de composant Databases/Teradata
Fonction Le composant tTeradataTPTExec est une combinaison du tTeradataFastLoad, du
tTeradataMultiLoad, du tTeradataTPump et du tTeradataFastExport. Il charge les donnes
d'un fichier existant dans une base de donnes Teradata.
Objectif Le tTeradataTPTExec offre de hautes performances lors de l'insertion des donnes d'un fichier
existant dans une table d'une base de donnes Teradata.
Basic settings Property Type Peut tre Built-In ou Repository.
Inserter : insre les donnes dans une table dfinie dans la base
de donnes Teradata.
Advanced settings Field separator Caractre, chane ou expression rgulire sparant les champs.
Define Log table Cochez cette case pour spcifiez le nom de table de log.
Set Script Parameters Cochez cette case pour spcifier la valeur des paramtres Load
Operator, Data Connector, Job Name, and Layout Name
(schema) qui seront utiliss lors de la gnration d'un script durant
l'excution du Job. Si vous ne les spcifiez pas manuellement, le
systme utilisera leurs valeurs par dfaut.
Load Operator Spcifiez l'oprateur de chargement.
Global Variables EXIT_VALUE : code de sortie du processus. Cette variable est une variable After et retourne un
nombre entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant peut s'utiliser en standalone dans un Job ou un sous-job. Il offre de
hautes performances lors de l'insertion de donnes d'un fichier existant dans une table
d'une base de donnes Teradata. Pour plus d'informations concernant l'utilisation de
ce composant, consultez http://developer.teradata.com/sites/all/files/documentation/linked_docs/
html/online/B035-2436-088A/wwhelp/wwhimpl/js/html/wwhelp.htm (en anglais).
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Il est ncessaire d'installer l'outil de client Teradata avec les fonctionnalits Teradata Parallel
Transporter Base et Teradata Parallel Transporter Stream sur la machine o les Jobs utilisant ce
composant sont excuts.
Construire le Job
1. Crez un Job et ajoutez les composants suivants en saisissant leur nom dans l'espace de modlisation
graphique ou bien en les glissant-dposant de la Palette dans l'espace de modlisation graphique :
un tTeradataRow, un tFixedFlowInput, un tFileOutputDelimited, un TeradataTPTExec, un
tTeradataInput et un tLogRow.
2. Renseignez les champs Host, Database, Username et Password en saisissant respectivement le nom de
l'hte, le nom de la base de donnes, l'identifiant et le mot de passe de l'utilisateur, pour la connexion.
3. Dans le champ Query, saisissez l'instruction SQL suivante afin de crer une table nomme person contenant
ces trois colonnes :id, name, sex.
2. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir l'diteur du schma.
3. Cliquez trois fois sur le bouton [+] pour ajouter trois colonnes : id de Type Integer, name et sex, de Type
String.
4. Cliquez sur OK pour fermer l'diteur et acceptez la propagation lorsqu'une fentre vous propose de propager
le schma.
5. Dans la zone Mode, slectionnez Use Inline Content (delimited file) et saisissez les donnes d'entre dans
le champ Content.
1;Ford;Male
2;Rose;Female
3;Sabrina;Female
4;Teddy;Male
5;Kate;Male
7. Dans le champ File Name, spcifiez le fichier dans lequel crire les donnes d'entre. Dans cet exemple,
saisissez E:/person.csv.
2. Dans les champs TDPID, Database name, Username et Password, saisissez vos informations de connexion
la base de donnes Teradata.
3. Dans le champ Table, saisissez le nom de la table dans laquelle les donnes source seront charges. Dans
cet exemple, saisissez person.
4. Dans le champ Script generated folder, parcourez votre systme jusqu'au rpertoire sous lequel crer le
fichier du script Teradata Parallel Transporter durant l'excution du Job. Dans cet exemple, le chemin est E:/.
5. Dans le champ Load file, parcourez votre systme jusqu'au fichier contenant les donnes source. Dans cet
exemple, le chemin est E:/person.csv.
6. Dans le champ Error file, spcifiez le fichier dans lequel enregistrer les messages de log. Dans cet exemple,
le chemin est E:/error.log.
7. Cliquez sur le bouton [...] ct du champ Edit schema to open the schema editor.
Cliquez trois fois sur le bouton [+] pour ajouter trois colonnes : id de Type Integer, name et sex, de Type
String. Le nom des colonnes id et name dans la colonne Db Column sont entours par \", car ce sont des
mots-cls de la base de donnes Teradata.
8. Cliquez sur l'onglet Advanced settings pour ouvrir sa vue. Cochez la case Apply TPT consumer operator
optional attributes et cliquez quatre fois sur le bouton [+] sous la table Optional attributes pour ajouter les
attributs ncessaires suivants : ErrorLimit, ErrorTable1, QueryBandSessInfo et TraceLevel.
Pour les attributs de type VARCHAR, saisissez les valeurs entre guillemets doubles.
2. Dans le champ Table Name, saisissez le nom de la table de laquelle lire les donnes. Dans cet exemple,
saisissez person.
3. Dans le champ Query, saisissez l'instruction SQL suivante pour rcuprer les donnes de la table person.
SELECT * FROM samples.person ORDER BY id
4. Cliquez sur le [...] ct du champ Edit schema pour ouvrir l'diteur du schma.
5. Cliquez trois fois sur le bouton [+] pour ajouter trois colonnes : id de Type Integer, name et sex, de Type
String. Le nom des colonnes id et name dans la colonne Db Column sont entours par \", car ce sont des
mots-cls de la base de donnes Teradata.
6. Cliquez sur OK pour fermer l'diteur de schma et acceptez la propagation propose par la fentre qui s'ouvre.
8. Dans la zone Mode, slectionnez l'option Table (print values in cells of a table) pour un affichage optimal
des rsultats.
Les donnes crites dans la table de la bases de donnes Teradata spcifie sont affiches dans la console.
tTeradataTPTUtility
Proprits du tTeradataTPTUtility
Famille de composant Databases/Teradata
Fonction Le composant tTeradataTPTUtility combine les utilitaires des composants tTeradataFastLoad,
tTeradataMultiLoad, tTeradataTPump et tTeradataFastExport et permet d'crire des donnes
entrantes dans un fichier puis de charger les donnes du fichier dans une base de donnes Teradata.
Objectif Le tTeradataTPTUtility permet d'crire les donnes entrantes dans un fichier puis de charger les
donnes du fichier dans une base de donnes Teradata.
Basic settings Property Type Peut tre Built-In ou Repository.
Data file Depuis la version 5.6, les modes Built-in et Repository sont
disponibles dans n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les
proprits du composant. Le champ Filename est alors pr-rempli
l'aide des donnes collectes.
Filename Spcifiez le fichier dans lequel sauvegarder vos donnes de sortie.
Append Cochez cette case pour ajouter les donnes entrantes dans le fichier
dfini dans le champ Filename.
Connection Property Type Peut-tre Built-In ou Repository.
Inserter : Insre les donnes dans une table dfinie dans la base de
donnes Teradata.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Prcd par un composant d'entre, le tTeradataTPTUtility crit les donnes entrantes dans
un fichier puis les charge du fichier dans la base de donnes Teradata. Ce traitement
se fait avec de hautes performances. Pour plus d'informations concernant l'utilisation de
ce composant, consultez http://developer.teradata.com/sites/all/files/documentation/linked_docs/
html/online/B035-2436-088A/wwhelp/wwhimpl/js/html/wwhelp.htm (en anglais).
Limitation Il est ncessaire d'installer l'outil de client Teradata avec les fonctionnalits Teradata Parallel
Transporter Base et Teradata Parallel Transporter Stream sur la machine o les Jobs utilisant ce
composant sont excuts.
Scnario associ
Pour un scnario associ, consultez Scnario : Charger des donnes dans une base de donnes Teradata.
tTeradataTPump
Proprits du tTeradataTPump
Famille de composant Databases/Teradata
Fonction Ce composant insre, met jour ou supprime des donnes dans la base de donnes Teradata l'aide
de l'utilitaire de chargement TPump qui permet d'obtenir des donnes en temps quasi rel dans un
entrept de donnes.
Objectif Utilisez ce composant pour insrer, mettre jour ou supprimer des donnes dans la base de
donnes Teradata, en particulier dans les environnements o les fentres de lot sont rduites et o
la maintenance des entrepts concident avec les heures normales de travail.
Basic settings Property type Peut tre Built-in ou Repository
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Teradata.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
tRowGenerator : gnre autant de lignes que ncessaire, en utilisant au hasard des donnes clients prises dans
une liste.
tTeradataTPump : insre les donnes clients dans la table de la base de donnes Teradata en mode Tpump.
Dans la fentre [RowGenerator Editor], dfinissez les donnes gnrer. Pour ce Job, le schma se compose
de deux colonnes : ID et Name.
Dans le champ Number of Rows for RowGenerator, saisissez le nombre de lignes gnrer.
2. Double-cliquez sur le tFileOutputDelimited afin d'afficher sa vue Component et dfinir ses proprits.
3. A ct du champ File Name, parcourez votre rpertoire jusqu'au fichier de sortie, ou saisissez un nom pour
le fichier crer.
4. Entre guillemets doubles, saisissez les sparateurs utiliser, ct des champs Row Separator et Field
Separator, par exemple \n et un point-virgule.
Cliquez sur Edit schema et vrifiez que le schma est retrouv partir du schma d'entre. Au besoin, cliquez
sur Sync Columns.
Dans l'onglet Basic settings de la vue Component, dfinissez les paramtres du composant
tTeradataTPump.
6. Saisissez le nom de la base de donnes dans le champ Database name, votre identifiant de connexion la
base de donnes dans le champ User name, et votre mot de passe dans le champ Password.
7. Spcifiez la table dans laquelle insrer les donnes clients. Dans ce scnario, la table est mytable.
8. Dans les champs Script generated folder, Load file et Error file, spcifiez le rpertoire respectivement au
dossier dans lequel vous stockez les fichiers de scripts gnrs.
9. Dans le champ Load File, spcifiez le fichier contenant les donnes clients insrer.
10. Dans le champ Error file, spcifiez le fichier contenant les informations concernant les erreurs.
Excuter le Job
1. Appuyez sur F6 pour excuter le Job.
4. Dans l'onglet Advanced settings, cochez la case Return tpump error et saisissez le code de retour partir
duquel retourner une erreur dans la console. Dans cet exemple, saisissez le chiffre 4 et utilisez les valeurs
par dfaut pour les autres paramtres.
Une erreur se produit et le TPump retourne le code de retour, de 12. Si vous avez besoin d'informations dtailles
concernant les informations dtailles de l'erreur, vous pouvez ouvrir le fichier de log stock dans le rpertoire
spcifi dans le champ Error file et dans l'onglet Basic settings de la vue Component.
tVectorWiseCommit
Proprits du tVectorWiseCommit
Famille de composant Databases/VectorWise
Fonction Le composant tVectorWiseCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tVectorWiseConnection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants VectorWise et notamment avec les
composants tVectorWiseConnection et tVectorWiseRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tVectorWiseCommit, consultez Scnario 1 :
Insrer des donnes dans des tables mre/fille.
tVectorWiseConnection
Proprits du tVectorWiseConnection
Famille de composant Databases/VectorWise
Fonction Le composant tVectorWiseConnection ouvre une connexion vers une base de donnes afin
d'effectuer une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au composant tVectorWiseConnection, consultez tMysqlConnection.
tVectorWiseInput
Proprits du tVectorWiseInput
Famille de Databases/
composant VectorWise
Fonction Le composant tVectorWiseInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tVectorWiseInput excute une requte en base de donnes selon un ordre strict qui doit correspondre
celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une
connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants
sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base
de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue
Basic settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de
base de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes VectorWise.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez les scnarios du composant gnrique tDBInput :
Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du tContextLoad.
tVectorWiseOutput
Proprits du tVectorWiseOutput
Famille de Databases/
composant VectorWise
Fonction Le composant tVectorWiseOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tVectorWiseOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de donnes
et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du
composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base de
donnes, consultez le Guide utilisateur du Studio Talend.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion cre
par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement n'existe
pas, un nouvel enregistrement est insr.
Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle
baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du
champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s)
que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance,
cliquez sur l'onglet Advanced settings pour dfinir simultanment les cls primaires
sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete).
Pour cela, cochez la case Use field options et slectionnez la case Key in update
correspondant la colonne sur laquelle baser votre opration de mise jour (Update).
Procdez de la mme manire avec les cases Key in delete pour les oprations de
suppression (Delete).
Schema et Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
Edit Schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer) ou des
fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de guillemets.
Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si vous
souhaitez propager les modifications uniquement au Job courant, slectionnez No et slectionnez
nouveau la mtadonne du schma dans la fentre [Repository Content].
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour terminer
le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les
lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette option
settings garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance
d'excution.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous l'ayez
Columns pralablement supprime ou non). Cette option vous permet d'effectuer des actions sur les
colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui ncessitent
un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes
dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur la colonne
de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant tTeradataOutput peut
utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur les
options donnes.
Enable debug Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de donnes.
mode
Support null Cochez cette case pour prendre en compte les valeurs Null d'une table de base de donnes.
in "SQL
WHERE" Assurez-vous que la case Nullable est bien coche pour les colonnes du schma
statement correspondantes.
Use Batch Cochez cette case pour activer le mode batch (par lots) afin d'amliorer les performances du
Size traitement de donnes lorsque vous avez besoin d'insrer un grand nombre d'enregistrements.
Cette option n'est supporte que sur la version 2.5 et plus de Vectorwise, et n'est disponible que si
vous slectionnez Insert dans la liste droulante Action on data dans l'onglet Basic settings.
Batch Size Spcifiez le nombre d'enregistrements envoyer la base de donnes par lot.
Ce champ apparat uniquement lorsque la case Use Batch Size est coche.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes VectorWise.
Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un
exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject du composant
tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tVectorWiseRollback
Proprits du tVectorWiseRollback
Famille de composant Databases/VectorWise
Fonction Le tVectorWiseRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant tVectorWiseConnection dans la liste s'il
y a plus d'une connexion dans votre Job.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants VectorWise, notamment les
composants tVectorWiseConnection et tVectorWiseCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tVectorWiseRollback, consultez Scnario : Annuler l'insertion de donnes
dans des tables mre/fille.
tVectorWiseRow
Proprits du tVectorWiseRow
Famille de Databases/
composant VectorWise
Fonction Le tVectorWiseRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL
dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le
Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tVectorWiseRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Table Name Nom de la table traiter.
Query type La requte peut tre Built-in ou distante dans le Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Guess Query Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre
table dans le champ Query.
Query Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des champs
corresponde celui dfini dans le schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
settings QUERY's Slectionnez cette colonne dans la liste use column.
recordset
Cette option permet au composant d'avoir un schma diffrent de celui du
composant prcdent. De plus, la colonne contenant le rsultat de la requte doit
tre de type Object. Ce composant est gnralement suivi du tParseRecordSet.
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatement de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des
paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query de
l'onglet Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Global QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
Variables
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ, consultez :
tVerticaBulkExec
Proprits du tVerticaBulkExec
Les composants tVerticaOutputBulk et tVerticaBulkExec sont gnralement utiliss ensemble pour d'une part
gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tVerticaOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le changement des donnes dans la base de donnes.
Famille de Databases/
composant Vertica
Fonction Le composant tVerticaBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tVerticaBulkExec est un composant ddi qui permet un gain de performance pendant les oprations d'Insert
dans une base de donnes Vertica.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
DB Version Slectionnez dans la liste la version de Vertica que vous utilisez.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer) ou des
fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de guillemets.
Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
File Name Nom du fichier charger.
Ce fichier doit se situer sur la mme machine que le Studio Talend ou que le Job contenant un
tVerticaBulkExec, afin que le composant fonctionne correctement.
Advanced Additional Ajoutez des paramtres JDBC supplmentaires ncessaires la connexion la base de donnes.
settings JDBC
Parameters Cette option n'est pas disponible lorsque vous cochez la case Use an existing connection dans
la vue Basic settings.
Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes :
Bulk insert : Ajouter plusieurs entres la table. Si des doublons sont trouvs, le Job s'arrte.
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global ACCEPTED_ROW_NUMBER : le nombre de lignes charges dans la base de donnes.
Variables
REJECTED_ROW_NUMBER : le nombre de lignes rejetes.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec un composant tVerticaOutputBulk. Ensemble, ils offrent un gain
de performance important pour l'alimentation d'une base de donnes Vertica.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Conseils et techniques
Utiliss ensemble, le Studio Talend et la base de donnes Vertica permettent de crer des applications d'entrept de
donnes et de datamart trs rapides et abordables. Pour plus d'informations sur la manire de configurer le Studio
Talend pour se connecter Vertica, consultez Talend and HP Vertica Tips and Techniques (en anglais).
Scnarios associs
Pour un scnario associ au composant tVerticaBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
Scnario : Insrer des donnes dans une base MySQL du composant tMysqlOutputBulkExec.
Scnario : Supprimer et insrer des donnes dans une base Oracle du composant tOracleBulkExec.
tVerticaClose
Proprits du tVerticaClose
Famille de composant Databases/Vertica
Fonction Le composant tVerticaClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes Vertica.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tVerticaConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Conseils et techniques
Utiliss ensemble, le Studio Talend et la base de donnes Vertica permettent de crer des applications d'entrept de
donnes et de datamart trs rapides et abordables. Pour plus d'informations sur la manire de configurer le Studio
Talend pour se connecter Vertica, consultez Talend and HP Vertica Tips and Techniques (en anglais).
Scnario associ
Ce composant est troitement li aux composants tVerticaConnection et tVerticaRollback. Il est gnralement
utilis avec un composant tVerticaConnection car il permet de fermer une connexion pour la transaction en cours.
tVerticaCommit
Proprits du tVerticaCommit
Famille de composant Databases/Vertica
Fonction Le composant tVerticaCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tVerticaConnection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants Vertica et notamment avec les
composants tVerticaConnection et tVerticaRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Conseils et techniques
Utiliss ensemble, le Studio Talend et la base de donnes Vertica permettent de crer des applications d'entrept de
donnes et de datamart trs rapides et abordables. Pour plus d'informations sur la manire de configurer le Studio
Talend pour se connecter Vertica, consultez Talend and HP Vertica Tips and Techniques (en anglais).
Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tVerticaCommit, consultez Scnario 1 :
Insrer des donnes dans des tables mre/fille.
tVerticaConnection
Proprits du tVerticaConnection
Famille de composant Databases/Vertica
Fonction Le composant tVerticaConnection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Conseils et techniques
Utiliss ensemble, le Studio Talend et la base de donnes Vertica permettent de crer des applications d'entrept de
donnes et de datamart trs rapides et abordables. Pour plus d'informations sur la manire de configurer le Studio
Talend pour se connecter Vertica, consultez Talend and HP Vertica Tips and Techniques (en anglais).
Scnario associ
Pour un scnario associ au composant tVerticaConnection, consultez tMysqlConnection.
tVerticaInput
Proprits du tVerticaInput
Famille de Databases/
composant Vertica
Fonction Le composant tVerticaInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tVerticaInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini
dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de
flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de donnes
et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du
composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
DB Version Slectionnez dans la liste la version de Vertica que vous utilisez.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Table Name Nom de la table lire.
Query type et Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des champs
Query corresponde celui dfini dans le schma.
Advanced Additional Ajoutez des paramtres JDBC supplmentaires ncessaires la connexion la base de donnes.
settings JDBC
Parameters Cette option n'est pas disponible lorsque vous cochez la case Use an existing connection dans
la vue Basic settings.
Trim all the Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les
String/Char colonnes contenant des chanes de caractres.
columns
Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Vertica.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Conseils et techniques
Utiliss ensemble, le Studio Talend et la base de donnes Vertica permettent de crer des applications d'entrept de
donnes et de datamart trs rapides et abordables. Pour plus d'informations sur la manire de configurer le Studio
Talend pour se connecter Vertica, consultez Talend and HP Vertica Tips and Techniques (en anglais).
Scnarios associs
Voir galement les scnarios du tDBInput dans :
Voir galement le scnario du tContextLoad,, consultez Scnario : Lire des donnes partir de diffrentes bases
de donnes MySQL l'aide de paramtres de connexion chargs dynamiquement.
tVerticaOutput
Proprits du tVerticaOutput
Famille de Databases/
composant Vertica
Fonction Le composant tVerticaOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tVerticaOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property Peut tre Built-in ou Repository
type
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de donnes
et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du
composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base de
donnes, consultez le Guide utilisateur du Studio Talend.
DB Slectionnez dans la liste la version de Vertica que vous utilisez.
Version
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table slectionne :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle.
Cochez cette case pour supprimer tous les objets lis la table qui va tre supprime.
Action on Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne :
data
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.
Copy : Lire des donnes d'un fichier texte et insrer des tuples dans le systme de stockage
optimis en criture (Write Optimized Store) ou directement dans le systme de stockage
optimis en lecture (Read Optimized Store). Cette option est idale pour le chargement de masse.
Pour plus d'informations, consultez votre manuel Vertica SQL.
Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle
baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du
champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s)
que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance,
cliquez sur l'onglet Advanced settings pour dfinir simultanment les cls primaires
sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete).
Pour cela, cochez la case Use field options et slectionnez la case Key in update
correspondant la colonne sur laquelle baser votre opration de mise jour (Update).
Procdez de la mme manire avec les cases Key in delete pour les oprations de
suppression (Delete).
Schema et Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
Edit au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
schema
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer) ou des
fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de guillemets.
Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
Cette case est disponible uniquement si vous avez choisi l'option Insert, Update,
Single Insert Query ou Delete dans le champ Action on data.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous l'ayez
Columns pralablement supprime ou non). Cette option vous permet d'effectuer des actions sur les
colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui ncessitent
un prtraitement particulier.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne
un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un
entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un
entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un
entier.
NB_LINE_COPIED : nombre de lignes copies. Cette variable est une variable After et retourne un nombre
entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
Vertica. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur.
Pour un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject
du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont
pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install
dans l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet
Modules de la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://
help.talend.com/display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la
section dcrivant comment configurer le studio, dans le Guide d'installation et de migration Talend.
Conseils et techniques
Utiliss ensemble, le Studio Talend et la base de donnes Vertica permettent de crer des applications d'entrept de
donnes et de datamart trs rapides et abordables. Pour plus d'informations sur la manire de configurer le Studio
Talend pour se connecter Vertica, consultez Talend and HP Vertica Tips and Techniques (en anglais).
Scnarios associs
Pour un scnario associ au composant tVerticaOutput, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tVerticaOutputBulk
Proprits du tVerticaOutputBulk
Les composants tVerticaOutputBulk et tVerticaBulkExec sont gnralement utiliss ensemble pour d'une part
gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte SQL
nonce. Cette excution en deux tapes est unifie dans le composant tVerticaOutputBulkExec, dtaill dans
une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet de procder
des transformations avant le chargement des donnes dans la base de donnes.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs
suivants sont alors pr-remplis l'aide des donnes collectes.
File Name Nom du fichier gnrer.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi,
il peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des
entiers (integer) ou des fonctions (function), assurez-vous que les valeurs par
dfaut ne sont pas entoures de guillemets. Si c'est le cas, vous devez supprimer
manuellement les guillemets.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec le composant tVerticaBulkExec. Ensemble, ils offrent
un gain de performance important pour l'alimentation d'une base de donnes Vertica.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations
sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Conseils et techniques
Utiliss ensemble, le Studio Talend et la base de donnes Vertica permettent de crer des applications d'entrept de
donnes et de datamart trs rapides et abordables. Pour plus d'informations sur la manire de configurer le Studio
Talend pour se connecter Vertica, consultez Talend and HP Vertica Tips and Techniques (en anglais).
Scnarios associs
Pour un scnario associ au tVerticaOutputBulk, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
tVerticaOutputBulkExec
Proprits du tVerticaOutputBulkExec
Les composants tVerticaOutputBulk et tVerticaBulkExec sont gnralement utiliss ensemble comme deux
parties d'un processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime
tape, ce fichier est utilis lors de l'opration d'INSERT afin de peupler une base de donnes. Cette excution en
deux tapes est unifie dans le composant tVerticaOutputBulkExec.
Schema and Edit Schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Cette option n'est pas disponible lorsque vous cochez la case Use an
existing connection dans la vue Basic settings.
Write to ROS (Read Cochez cette case pour stocker les donnes dans une mmoire
Optimized Store) physique, et ainsi optimiser la lecture de ces donnes, puisqu'elles
seront compresses et pr-tries.
Exit job if no row was loaded Le Job s'arrte automatiquement si aucune ligne n'a t charge.
Field Separator Caractre, chane ou expression rgulire sparant les champs.
Null string Chane de caractres affiche pour signifier que la valeur est nulle.
Include header Cochez cette case pour inclure l'en-tte des colonnes dans le fichier.
Encoding Slectionnez l'encodage partir de la liste ou slectionnez Custom
et dfinissez-le manuellement. Ce champ est obligatoire pour la
manipulation des donnes de base de donnes.
Rejected data file Spcifiez le fichier dans lequel vous souhaitez que soient crites les
lignes rejetes.
Exception log file Spcifiez le fichier dans lequel vous souhaitez que soit crite une
explication pour chaque ligne rejete.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables ACCEPTED_ROW_NUMBER : le nombre de lignes charges dans la base de donnes.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est principalement utilis lorsqu'aucune transformation particulire n'est requise sur
les donnes charger dans la base de donnes.
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Conseils et techniques
Utiliss ensemble, le Studio Talend et la base de donnes Vertica permettent de crer des applications d'entrept de
donnes et de datamart trs rapides et abordables. Pour plus d'informations sur la manire de configurer le Studio
Talend pour se connecter Vertica, consultez Talend and HP Vertica Tips and Techniques (en anglais).
Scnarios associs
Pour un scnario associ au tVerticaOutputBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk.
tVerticaRollback
Proprits du tVerticaRollback
Famille de composant Databases/Vertica
Fonction Le tVerticaRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant tVerticaConnection dans la liste s'il y a
plus d'une connexion dans votre Job.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants Vertica, notamment les
composants tVerticaConnection et tVerticaCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Conseils et techniques
Utiliss ensemble, le Studio Talend et la base de donnes Vertica permettent de crer des applications d'entrept de
donnes et de datamart trs rapides et abordables. Pour plus d'informations sur la manire de configurer le Studio
Talend pour se connecter Vertica, consultez Talend and HP Vertica Tips and Techniques (en anglais).
Scnario associ
Pour un scnario associ au composant tVerticaRollback, consultez Scnario : Annuler l'insertion de donnes
dans des tables mre/fille.
tVerticaRow
Proprits du tVerticaRow
Famille de Databases/
composant Vertica
Fonction Le tVerticaRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares
sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job
bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tVerticaRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors
pr-remplis l'aide des donnes collectes.
DB version Slectionnez la version de Vertica que vous utilisez.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Table name Nom de la table lire.
Query type Peut tre Built-in ou Repository.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Query Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced settings Additional Ajoutez des paramtres JDBC supplmentaires ncessaires la connexion la base de donnes.
JDBC
Parameters Cette option n'est pas disponible lorsque vous cochez la case Use an existing connection dans
la vue Basic settings.
Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
QUERY's Slectionnez cette colonne dans la liste use column.
recordset
Cette option permet au composant d'avoir un schma diffrent de celui du composant
prcdent. De plus, la colonne contenant le rsultat de la requte doit tre de type
Object. Ce composant est gnralement suivi du tParseRecordSet.
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatement
de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des
paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query de
l'onglet Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte.
Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de
requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Conseils et techniques
Utiliss ensemble, le Studio Talend et la base de donnes Vertica permettent de crer des applications d'entrept de
donnes et de datamart trs rapides et abordables. Pour plus d'informations sur la manire de configurer le Studio
Talend pour se connecter Vertica, consultez Talend and HP Vertica Tips and Techniques (en anglais).
Scnario associ
Pour un scnario associ au composant tVerticaRow, consultez :
D'autres types de connecteurs de bases de donnes, tels que les connecteurs de bases de donnes traditionnelles
et de bases de donnes d'appliance, de datawarehouse, de bases de donnes verticales, sont documents dans le
Databases - Composants traditionnels et le Databases - Composants d'appliance et de datawarehouse.
tCreateTable
Proprits du tCreateTable
Ce composant se trouve la racine de la famille Databases de la Palette du Studio Talend. Le composant
tCreateTable couvre des besoins indirectement lis l'utilisation des bases de donnes de tout type.
Famille de Databases
composant
Fonction Le tCreateTable cre, supprime ou supprime et recre une table spcifique.
Objectif Ce composant permet de crer ou de supprimer n'importe quelle table d'une base de donnes
Basic settings Property Peut tre Built-in ou Repository
type
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Database Slectionnez le type de SGBD dans la liste propose. Les proprits peuvent diffrer lgrement
Type en fonction du type de base de donnes slectionn. Les champs additionnels sont dfinis dans ce
tableau, la suite des proprits gnrales.
DB Slectionnez la version de la base de donnes que vous utilisez.
Version
Table Slectionnez l'action effectuer sur la base de donnes :
Action
Create table : lorsque vous savez que la table n'existe pas dj.
Create table when not exists : lorsque vous ne savez pas si la table existe dj.
Drop and create table : lorsque vous savez que la table existe dj et que vous souhaitez la
remplacer.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste Component
existing list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion cre
par le Job parent avec le Job enfant, vous devez :
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans la bote
de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis cliquez sur OK
afin de sauvegarder les paramtres.
Table Saisissez entre guillemets un nom pour la table nouvellement cre.
name
Schema et Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
Edit au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Schema
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma est cr et conserv pour ce composant uniquement. Voir galement le Guide
utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer) ou des
fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de guillemets.
Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock dans
le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si vous souhaitez
propager les modifications uniquement au Job courant, slectionnez No et slectionnez nouveau
la mtadonne du schma dans la fentre [Repository Content].
Advanced tStatCatcher Cochez cette case pour collecter les donnes de log lors du traitement du Job, aussi bien au niveau
settings Statistics du Job qu'au niveau de chaque composant.
Additional Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de
JDBC donnes. Cette option n'est pas disponible si vous avez coch la case Use an existing connection
Parameters dans la vue Basic settings (AS/400, MSSQL Server).
Create Cochez cette case pour crer une projection (Vertica).
projection
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes de base de donnes et couvre toutes les possibilits des requtes
SQL. Plus de scnarios sont disponibles pour chaque composant d'entre de type base de donnes.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
2. Dans la liste Database type de l'onglet Basic settings de la vue Component, slectionnez Mysql.
4. Ne cochez la case Use Existing Connection uniquement si vous utilisez un composant avec une connexion
ddie (pour plus d'informations, consultez tMysqlConnection). Vous n'utiliserez pas cette option pour cet
exemple.
5. Dans la liste droulante Property type, slectionnez Repository pour que tous les champs de connexion la
base de donnes soient renseigns automatiquement. Si vous n'avez pas configur de connexion aux bases de
donnes dans le dossier Metadata du rpertoire DB connection, renseignez manuellement ces informations
de connexion aprs avoir slectionn Built-in.
7. Si vous souhaitez rcuprer le schma d'une mtadonne (sans que celle-ci ne soit une connexion une base
de donnes), slectionnez Repository puis la mtadonne souhaite.
8. Dans tous les cas (Built-in ou Repository), cliquez sur Edit Schema pour vrifier le type de donnes dans
la colonne DB Type. Cliquez sur Edit schema pour dfinir la structure des donnes.
9. Cliquez sur le bouton Reset DB Types si la colonne DB type est vide ou affiche des marques de diffrence
(couleur orange). Cela permet de donner n'importe quel type de donnes le type de donnes adquat. Cliquez
sur OK pour valider vos modifications et fermer la bote de dialogue.
La table cre est vide mais elle contient toutes les colonnes dfinies dans le schma.
tDBInput
Proprits du tDBInput
Famille de composant Databases/DB Generic
Fonction Le composant tDBInput lit une base de donnes et en extrait des champs l'aide de requtes.
Pour utiliser ce composant, les pilotes ODBC du SGBD doivent tre installs et les
connexions ODBC doivent tre configures via l'assistant de configuration de connexion
une base de donnes.
Objectif Le tDBInput excute une requte en base de donnes selon un ordre strict qui doit correspondre
celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant
suivant via une connexion de flux (Main row).
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les
possibilits des requtes SQL grce une connexion gnrique ODBC.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Avant de reproduire ce Job, le pilote ODBC de MySQL doit avoir t install et la connexion ODBC correspondante doit
avoir t configure.
1. Cliquez et dposez les composants tDBInput et tLogRow dans l'espace de modlisation graphique.
2. Cliquez-droit sur le tDBInput et, en gardant le bouton droit enfonc, glissez jusqu'au tLogRow pour crer
une connexion de type Main Row.
3. Double-cliquez sur le tDBInput pour ouvrir sa vue Component et renseignez les proprits du composant :
4.
5. Renseignez les informations de connexion la base de donnes dans les champs Database, Username et
Password.
6. Cliquez sur le bouton Edit Schema et rpertoriez les codes des magasins dans une colonne et les ventes
dans une autre.
8. Saisissez la requte excuter en veillant ce que l'ordre des colonnes correspondent celui fourni dans
le schma. Dans cet exemple, comme toutes les colonnes du schma ont t slectionnes, il est possible
d'utiliser l'astrisque.
11. Passez sur la vue Run et cliquez sur le bouton Run pour excuter le Job.
La base de donnes est alors analyse. Les donnes recherches sont extraites et sont affiches directement
sur la console (vue Run), o vous pouvez les voir.
2. Reliez les composants tDBInput et tJava via une connexion Trigger de type OnComponentOk. Dans le
cas prsent, faites en sorte que la commande du tDBInput s'excute avant la commande du tJava.
3. Configurez les composants tDBInput et tLogRow comme dans le scnario 1 dcrit plus haut.
5. Crez un nouveau paramtre que vous appellerez StoreSQLQuery et donnez-lui une valeur de 1 par dfaut.
Cette valeur indique que StoreSQLQuery est valide (true) et pourra tre utilis par la variable globale
QUERY.
8. La requte associe au composant tDBInput s'affiche dans la console (vue Run), la fin des rsultats du Job :
tDBOutput
Proprits du tDBOutput
Famille de composant Databases
Fonction Le composant tDBOutput crit, met jour, modifie ou supprime les donnes d'une base de
donnes.
Pour utiliser ce composant, les pilotes ODBC du SGBD doivent tre installs et les
connexions ODBC doivent tre configures via l'assistant de configuration de connexion
une base de donnes.
Objectif Le tDBOutput excute l'action dfinie sur les donnes d'une table, en fonction du flux entrant
provenant du composant prcdent.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et
retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et
retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et
retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et
retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les
possibilits des requtes SQL.
Il doit tre utilis en tant que composant de sortie. Il permet d'effectuer des actions sur les donnes
d'une table d'une base de donnes. Il permet aussi de crer un flux de rejet avec un lien Row > Reject
filtrant les donnes en erreur. Pour un exemple d'utilisation, consultez Scnario 3 : Rcuprer les
donnes errones l'aide d'un lien Reject du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
La table, nomme Date, contient une colonne nomme date, de type date.
Avant de reproduire ce Job, le pilote ODBC de MySQL doit avoir t install et la connexion ODBC correspondante doit
avoir t configure.
Saisissez 1 dans le champ Number of Rows for RowGenerator, une seule ligne sera ajoute la table.
6. Dans le champ Database, saisissez le nom de la source de donnes dfinie durant la configuration de la
connexion ODBC MySQL.
Pour configurer une connexion ODBC, cliquez sur le bouton pour ouvrir l'assistant de configuration de
la connexion la base de donnes.
7. Dans les champs Username et Password, saisissez les informations d'authentification la base de donnes.
8. Dans le champ Table, saisissez le nom de la table, Date dans cet exemple.
9. Dans le champ Action on data, slectionnez Insert afin d'insrer une ligne dans la table.
10. Cochez la case Clear data in table afin de vider la table avant l'insertion.
Comme affich ci-dessus, la table ne contient plus qu'une ligne concernant la date et l'heure courantes.
tDBSQLRow
Proprits du tDBSQLRow
Famille de composant Databases / DB Generic
Fonction tDBSQLRow est le composant gnrique tout type de base de donnes. Il excute des requtes
SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en
place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie.
Pour utiliser ce composant, les pilotes ODBC du SGBD doivent tre installs et les
connexions ODBC doivent tre configures via l'assistant de configuration de connexion
une base de donnes.
Basic settings Property type Peut tre Built-in ou Repository
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les
possibilits de requtes SQL.
Utilisez le composant DBRow correspondant au type de base de donnes dont vous vous servez.
La plupart des bases de donnes ont leur propre composant DBRow spcifique.
Prrequis ODBC (Open DataBase Connectivity) est un protocole standard permettant d'accder aux
informations de serveurs de bases de donnes. Vous devez pralablement crer une source de
donnes (datasource) ODBC et la relier votre base de donnes pour en lire les informations.
Pour crer une source ODBC sous Windows, par exemple, allez Panneau de configuration
> Outils d'administration > Sources de donnes (OBCD) puis renseignez les proprits de la
source partir de l'assistant.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Avant de reproduire ce Job, le pilote ODBC du SGBD correspondant doit avoir t install et la connexion ODBC
correspondante doit avoir t configure.
3. Dans le champ Property Type, slectionnez Repository puisque la connexion ODBC a t configure et
sauvegarde dans le Repository. Les champs suivants sont automatiquement renseigns.
Pour plus d'informations concernant le stockage des connexions aux bases de donnes dans le Repository,
consultez le Guide utilisateur du Studio Talend.
4. Le champ Schema est sur Built-in pour ce Job et n'est pas vraiment important dans cet exemple particulier
puisque l'action se fait sur l'auto-incrmentation de la table et non sur les donnes.
5. Dans la liste Query type, slectionnez l'option Built-in. Cliquez sur le bouton [...] ct du champ Query
pour ouvrir le SQLbuilder. Sinon, saisissez le code suivant : Alter table <TableName> auto_increment
= 1 directement dans le champ Query.
6. Enregistrez le Job en appuyant sur les touches Ctrl+S et appuyez sur F6 pour l'excuter.
tEXAInput
Proprits du tEXAInput
Famille de composant Databases/EXA
Fonction Le composant tEXAInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tEXAInput excute une requte en base de donnes selon un ordre strict qui doit correspondre
celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant
suivant via une connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes EXA.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Consultez les scnarios associs au composant tDBInput dans :
tEXAOutput
Proprits du tEXAOutput
Famille de composant Databases/EXA
Fonction Le composant tEXAOutput crit, met jour, modifie ou supprime les donnes d'une base de
donnes.
Objectif Le tEXAOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction
du flux entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository
Drop and create the table : supprimer la table puis en crer une
nouvelle.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et
retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et
retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et
retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et
retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de
caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les
possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table
d'une base de donnes EXA. Il permet aussi de crer un flux de rejet avec un lien Row > Rejects
filtrant les donnes en erreur. Pour un exemple d'utilisation, consultez Scnario 3 : Rcuprer les
donnes errones l'aide d'un lien Reject du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tEXARow
Proprits du tEXARow
Famille de composant Databases/EXA
Fonction tEXARow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL
dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place
un flux dans le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tEXARow agit sur la structure mme de la
base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider
rapidement et aisment crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les
possibilits de requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
tEXistConnection
Proprits du tEXistConnection
Famille de composant Databases/eXist
Fonction Le tEXistConnection ouvre une connexion une base de donnes eXist afin d'effectuer une
transaction.
Objectif Ouvrir une connexion une base de donnes eXist afin d'effectuer une transaction.
Basic settings URI URI de la base de donnes laquelle vous souhaitez vous connecter.
Collection Saisissez le chemin d'accs la collection laquelle vous souhaitez
accder, sur le serveur de la base de donnes.
Driver Ce champ est automatiquement rempli. Par dfaut, le nom du pilote
standard s'affiche.
La base de donnes eXist est un systme de gestion de base de donnes open source,
construit l'aide de la technologie XML. Elle stocke des donnes XML selon le modle de
donnes XML et offre une fonction efficace de traitement de la requte XQuery, base sur
l'index. Pour plus d'informations concernant XQuery, consultez : http://exist-db.org/exist/apps/doc/
documentation.xml (en anglais). Pour plus d'informations concernant les extensions de XQuery
Update, consultez : http://exist-db.org/exist/apps/doc/update_ext.xml#
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au tEXistConnection, consultez Scnario 1 : Insrer des donnes dans des tables mre/
fille du composant tMysqlConnection.
tEXistDelete
Proprits du tEXistDelete
Famille de composant Databases/eXist
Fonction Ce composant supprime des ressources d'une base de donnes eXist.
Objectif Le tEXistDelete supprime des ressources spcifies dans une base de donnes eXist distante.
Basic settings Use an existing connection/ Cochez cette case et slectionnez le composant de connexion
Component List adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis en tant que sous-job ou comme composant de sortie. La base
de donnes eXist est un systme de gestion de base de donnes open source, construit
l'aide de la technologie XML. Elle stocke des donnes XML selon le modle de donnes
XML et offre une fonction efficace de traitement de la requte XQuery, base sur l'index.
Pour plus d'informations concernant XQuery, consultez : http://exist-db.org/exist/apps/doc/
documentation.xml (en anglais). Pour plus d'informations concernant les extensions de XQuery
Update, consultez : http://exist-db.org/exist/apps/doc/update_ext.xml
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tEXistGet
Proprits du tEXistGet
Famille de composant Databases/eXist
Fonction Le composant tEXistGet rcupre des ressources partir d'un serveur distant de base de donnes
eXist.
Objectif Le tEXistGet tlcharge les ressources slectionnes partir d'un serveur distant de base de
donnes dans un rpertoire local.
Basic settings Use an existing connection/ Cochez cette case et slectionnez le composant de connexion
Component List adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis en tant que sous-job ou comme composant de sortie. La base de
donnes eXist est un systme de gestion de base de donnes open source, construit l'aide de la
technologie XML. Elle stocke des donnes XML selon le modle de donnes XML et offre une
fonction efficace de traitement de la requte XQuery, base sur l'index. Pour plus d'informations
concernant XQuery, consultez : XQuery (en anglais). Pour plus d'informations concernant les
extensions de XQuery Update, consultez : XQuery update extension
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
2. Double-cliquez sur le composant tEXistGet pour dfinir ses proprits dans l'onglet Basic settings de sa
vue Component.
3. Renseignez le champ URI en saisissant l'adresse URI de la base de donnes eXist laquelle vous souhaitez
vous connecter.
Dans ce scnario, l'URI est xmldb:exist://192.168.0.165:8080/exist/xmlrpc. Notez que cette adresse URI est
destine essentiellement la dmonstration et que ce n'est pas une adresse valide.
4. Remplissez le champ Collection avec le chemin d'accs la collection souhaite sur le serveur de la base
de donnes, /db/talend dans ce scnario.
6. Remplissez les champs Username et Password avec admin et talend respectivement pour ce scnario.
7. Cliquez sur le bouton [...] ct du champ Local directory pour dfinir le chemin d'accs au rpertoire dans
lequel le fichier XML tlcharg partir du serveur de la base de donnes sera sauvegard.
Dans ce scnario, faites pointer ce chemin vers votre bureau, par exemple :
8. Dans le champ Files, cliquez sur le bouton [+] afin d'ajouter une nouvelle ligne dans la zone Filemask et
remplissez-la avec un nom de fichier complet pour rcuprer les donnes partir d'un fichier spcifique sur
le serveur, ou avec un masque de fichier (filemask) pour rcuprer les donnes partir d'un ensemble de
fichiers. Dans ce scnario, saisissez dictionary_en.xml.
Le fichier XML dictionary_en.xml est rcupr et tlcharg dans le rpertoire local dfini pralablement.
tEXistList
Proprits du tEXistList
Famille de composant Databases/eXist
Fonction Ce composant liste les ressources stockes sur un serveur distant de base de donnes.
Objectif Le tEXistList liste les ressources stockes sur un serveur distant de base de donnes.
Basic settings Use an existing connection/ Cochez cette case et slectionnez le composant de connexion
Component List adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
CURRENT_FILE : nom du fichier courant. Cette variable est une variable Flow et retourne
une chane de caractres.
CURRENT_FILEPATH : nom du fichier courant ainsi que son chemin d'accs. Cette variable
est une variable Flow et retourne une chane de caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est gnralement utilis avec un tEXistGet afin de rcuprer les fichiers lists,
par exemple. La base de donnes eXist est un systme de gestion de base de donnes open
source, construit l'aide de la technologie XML. Elle stocke des donnes XML selon le modle
de donnes XML et offre une fonction efficace de traitement de la requte XQuery, base sur
l'index. Pour plus d'informations concernant XQuery, consultez : XQuery (en anglais). Pour
plus d'informations concernant les extensions de XQuery Update, consultez : http://exist-db.org/
exist/apps/doc/update_ext.xml
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au tEXistList , consultez Scnario : Itration sur un rpertoire distant.
tEXistPut
Proprits du tEXistPut
Famille de composant Databases/eXist
Fonction Ce composant charge des ressources dans un serveur de base de donnes.
Objectif Le tEXistPut charge des fichiers spcifis d'un rpertoire local dfini sur un serveur distant de
base de donnes.
Basic settings Use an existing connection/ Cochez cette case et slectionnez le composant de connexion
Component List adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis en tant que sous-job ou comme composant de sortie. La base de
donnes eXist est un systme de gestion de base de donnes open source, construit l'aide de la
technologie XML. Elle stocke des donnes XML selon le modle de donnes XML et offre une
fonction efficace de traitement de la requte XQuery, base sur l'index. Pour plus d'informations
concernant XQuery, consultez : XQuery (en anglais). Pour plus d'informations concernant les
extensions de XQuery Update, consultez : http://exist-db.org/exist/apps/doc/update_ext.xml
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tEXistXQuery
Proprits du tEXistXQuery
Famille de composant Databases/eXist
Fonction Ce composant utilise des fichiers locaux contenant des requtes XPath afin d'interroger des
fichiers XML stocks dans une base de donnes distante.
Objectif Le tEXistXQuery excute une requte sur des fichiers XML stocks sur une base de donnes
distante, et crit les rsultats dans un fichier XML stock localement.
Basic settings Use an existing connection/ Cochez cette case et slectionnez le composant de connexion
Component List adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis en tant que composant unique d'un Job mais peut galement tre utilis
dans un Job plus complexe. La base de donnes eXist est un systme de gestion de base de
donnes open source, construit l'aide de la technologie XML. Elle stocke des donnes XML
selon le modle de donnes XML et offre une fonction efficace de traitement de la requte
XQuery, base sur l'index. Pour plus d'informations concernant XQuery, consultez : XQuery
(en anglais). Pour plus d'informations concernant les extensions de XQuery Update, consultez :
XQuery update extension
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tEXistXUpdate
Proprits du tEXistXUpdate
Famille de composant Databases/eXist
Fonction Ce composant traite des fichiers XML et met jour les enregistrements sur un serveur de base de
donnes.
Objectif Le tEXistXUpdate traite des fichiers XML et met jour les enregistrements existants sur un serveur
de base de donnes.
Basic settings Use an existing connection/ Cochez cette case et slectionnez le composant de connexion
Component List adquat partir de la liste Component list pour rutiliser les
paramtres d'une connexion que vous avez dj dfinie.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis en tant que composant unique d'un Job mais peut galement tre utilis
dans un Job plus complexe. La base de donnes eXist est un systme de gestion de base de donnes
open source, construit l'aide de la technologie XML. Elle stocke des donnes XML selon le modle
de donnes XML et offre une fonction efficace de traitement de la requte XQuery, base sur
l'index. Pour plus d'informations concernant XQuery, consultez : XQuery (en anglais). Pour plus
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour
plus d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le studio,
dans le Guide d'installation et de migration Talend.
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tFirebirdClose
Proprits du tFirebirdClose
Famille de composant Databases/Firebird
Fonction Le composant tFirebirdClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes Firebird.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tFirebirdConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tFirebirdConnection et tFirebirdRollback. Il est gnralement
utilis avec un composant tFirebirdConnection car il permet de fermer une connexion pour la transaction en
cours.
tFirebirdCommit
Proprits du tFirebirdCommit
Famille de composant Databases/Firebird
Fonction Le composant tFirebirdCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tFirebirdConnection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants Firebird et notamment avec les
composants tFirebirdConnection et tFirebirdRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tFirebirdCommit, consultez Scnario 1 : Insrer des donnes dans des
tables mre/fille.
tFirebirdConnection
Proprits du tFirebirdConnection
Famille de composant Databases/Firebird
Fonction Le composant tFirebirdConnection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnario associ
Pour un scnario associ au composant tFirebirdConnection, consultez Scnario 1 : Insrer des donnes dans
des tables mre/fille.
tFirebirdInput
Proprits du tFirebirdInput
Famille de Databases/
composant Firebird
Fonction Le composant tFirebirdInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tFirebirdInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui
dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une
connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Firebird.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez les scnarios associs au composant gnrique tDBInput dans :
Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.
tFirebirdOutput
Proprits du tFirebirdOutput
Famille de Databases/
composant Firebird
Fonction Le composant tFirebirdOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tFirebirdOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property Peut tre Built-in ou Repository
type
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste Component
existing list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion cre
par le Job parent avec le Job enfant, vous devez :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle.
Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement n'existe
pas, un nouvel enregistrement est insr.
Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle
baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du
champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que
vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur
l'onglet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles
baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez
la case Use field options et slectionnez la case Key in update correspondant la colonne
sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire
avec les cases Key in delete pour les oprations de suppression (Delete).
Schema et Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
Edit schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer) ou des
fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de guillemets.
Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock dans
le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si vous souhaitez
propager les modifications uniquement au Job courant, slectionnez No et slectionnez nouveau
la mtadonne du schma dans la fentre [Repository Content].
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour terminer
le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les
lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Commit Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette option
settings every garantit la qualit de transaction (cependant pas de rollback) et surtout une meilleure performance
des excutions.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous l'ayez
Columns pralablement supprime ou non). Cette option vous permet d'effectuer des actions sur les
colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui ncessitent un
prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes
dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur la colonne
de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant tFirebirdOutput peut
utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur les
options donnes.
Enable Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de donnes.
debug mode
Support null Cochez cette case pour prendre en compte les valeurs Null d'une table de base de donnes.
in "SQL
WHERE" Assurez-vous que la case Nullable est bien coche pour les colonnes du schma
statement correspondantes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes
SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes Firebird.
Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un
exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject du composant
tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tFirebirdRollback
Proprits du tFirebirdRollback
Famille de composant Databases/Firebird
Fonction Le tFirebirdRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant de connexion tFirebirdConnection dans
la liste si vous prvoyez d'ajouter plus d'une connexion votre Job
en cours.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en association avec des composants Firebird, notamment
avec le tFirebirdConnection et le tFirebirdCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au tFirebirdRollback, consultez Scnario : Annuler l'insertion de donnes dans des
tables mre/fille du composant tMysqlRollback.
tFirebirdRow
Proprits du tFirebirdRow
Famille de Databases/Firebird
composant
Fonction tFirebirdRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares
sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien
que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tFirebirdRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous
pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row
> Rejects.
Advanced settings Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
QUERY's recordset Slectionnez cette colonne dans la liste use column.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une
meilleure performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
tHiveClose
Le composant tHiveClose appartient deux familles diffrentes : Big Data et Databases. Pour plus d'informations,
consultez tHiveClose.
tHiveConnection
Le composant tHiveConnection appartient deux familles diffrentes : Big Data et Databases. Pour plus
d'informations, consultez tHiveConnection.
tHiveRow
Le composant tHiveRow appartient deux familles diffrentes : Big Data et Databases. Pour plus d'informations,
consultez tHiveRow.
tHSQLDbInput
Proprits du tHSQLDbInput
Famille de composant Databases/HSQLDb
Fonction Le composant tHSQLDbInput lit les donnes d'une base de donnes et extrait les champs selon
la requte excute.
Objectif Le tHSQLDbInput excute une requte DB dans un ordre strictement dfini devant correspondre
la dfinition du schma. Il passe ensuite la liste des champs au composant suivant l'aide d'un
lien Main row.
Basic settings Property type Peut tre Built-in ou Repository
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant dans le Repository.
Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error.
Row : Iterate.
Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error.
Pour plus d'informations concernant les connexions, consultez la section relatives aux types de
connexions, dans le Guide utilisateur du Studio Talend.
Global Variables NB_LINE: Indicates the number of lines processed. This is an After variable and it returns an
integer.
QUERY: Indicates the query to be processed. This is a Flow variable and it returns a string.
For further information about variables, see Studio Talend User Guide.
A Flow variable means it functions during the execution of a component while an After
variable means it functions after the execution of a component.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour des scnarios associs, consultez :
tHSQLDbOutput
Proprits du tHSQLDbOutput
Famille de composant Databases/HSQLDb
Fonction Le composant tHSQLDbOutput crit, met jour, modifie ou supprime les donnes d'une base
de donnes.
Objectif Le tHSQLDbOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en
fonction du flux entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table
la fois.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes
de la table slectionne :
Drop and create the table : supprimer la table puis en crer une
nouvelle.
Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error.
Row : Main.
Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error.
Pour plus d'informations concernant les connexions, consultez la section relative aux types de
connexions, dans le Guide utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie.
Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et
retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et
retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et
retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et
retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de
caractres.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tHSQLDbRow
Proprits du tHSQLDbRow
Famille de composant Databases/HSQLDb
Fonction tHSQLDbRow est le composant spcifique ce type de base de donnes. Il excute des requtes
SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en
place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tHSQLDbRow agit sur la structure mme
de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider
rapidement et aisment crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les
possibilits de requtes SQL.
Connections Liens de sortie (de ce composant un autre) :
Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error.
Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error.
Pour plus d'informations concernant les connexions, consultez la section relative aux types de
connexions, dans le Guide utilisateur du Studio Talend.
Global Variables QUERY : indique le nombre de requtes traites. Cette variable est une variable Flow et retourne
une chane de caractres.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Une variable Flow signifie qu'elle fonctionne durant l'excution d'un composant. Une
variable After signifie qu'elle fonctionne aprs l'excution d'un composant.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour des scnarios associs, consultez :
tInterbaseClose
Proprits du tInterbaseClose
Famille de composant Databases/Interbase
Fonction Le composant tInterbaseClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes Interbase.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tInterbaseConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tInterbaseConnection et tInterbaseRollback. Ils sont
gnralement utiliss avec un composant tInterbaseConnection car il permet d'ouvrir une connexion pour la
transaction en cours.
tInterbaseCommit
Proprits du tInterbaseCommit
Famille de composant Databases/Interbase
Fonction Le composant tInterbaseCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list Slectionnez le composant tInterbaseConnection dans la liste si
vous prvoyez d'ajouter plus d'une connexion votre Job en cours.
Close Connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants Interbase et notamment avec les
composants tInterbaseConnection et tInterbaseRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au tInterbaseCommit, consultez Scnario 1 : Insrer des donnes dans des tables mre/
fille.
tInterbaseConnection
Proprits du tInterbaseConnection
Famille de composant Databases/Interbase
Fonction Le composant tInterbaseConnection ouvre une connexion vers une base de donnes afin
d'effectuer une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation
de ces fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend,
dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au composant tInterbaseConnection, consultez Scnario 1 : Insrer des donnes dans
des tables mre/fille.
tInterbaseInput
Proprits du tInterbaseInput
Famille de Databases/
composant Interbase
Fonction Le composant tInterbaseInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tInterbaseInput excute une requte en base de donnes selon un ordre strict qui doit correspondre
celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une
connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Interbase.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnarios associs
Consultez les scnarios associs au composant tDBInput dans :
Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.
tInterbaseOutput
Proprits du tInterbaseOutput
Famille de Databases/
composant Interbase
Fonction Le composant tInterbaseOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tInterbaseOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property Peut tre Built-in ou Repository
type
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de donnes
et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du
composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base de
donnes, consultez le Guide utilisateur du Studio Talend.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste Component
existing list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion cre
par le Job parent avec le Job enfant, vous devez :
Pour plus d'informations concernant le partage d'une connexion travers diffrents niveaux
de Jobs, consultez le Guide utilisateur du Studio Talend.
Host Adresse IP du serveur de base de donnes.
Database Nom de la base de donnes.
Username et Informations d'authentification de l'utilisateur de base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans la bote
de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis cliquez sur OK afin
de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Action on Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table slectionne :
table
None : n'effectuer aucune opration de table.
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle.
Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement n'existe
pas, un nouvel enregistrement est insr.
Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle
baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du
champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que
vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur
l'onglet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles
baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez
la case Use field options et slectionnez la case Key in update correspondant la colonne
sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire
avec les cases Key in delete pour les oprations de suppression (Delete).
Clear data in Cochez cette case pour que les donnes soient supprimes de la table slectionne avant toute action.
table
Schema et Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs au
Edit schema composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer) ou des
fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de guillemets. Si
c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-In
et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock dans
le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si vous souhaitez
propager les modifications uniquement au Job courant, slectionnez No et slectionnez nouveau
la mtadonne du schma dans la fentre [Repository Content].
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour terminer
le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les
lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Commit Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette option
settings every garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance
d'excution.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous l'ayez
Columns pralablement supprime ou non). Cette option vous permet d'effectuer des actions sur les colonnes,
l'exclusion des actions d'insertion, de mise jour, de suppression ou qui ncessitent un prtraitement
particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans
les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur la colonne
de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant tInterbaseOutput peut
utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur les
options donnes.
Enable Cochez cette case pour afficher chaque tape du processus d'criture dans la base de donnes.
debug mode
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy
et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide utilisateur
du Studio Talend.
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est une
variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on error
est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes
SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes Interbase. Il permet
aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple d'utilisation,
consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces fichiers .jar
manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide d'installation et de
migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC associ
au composant tDBOutput.
Scnario 1 : Ajouter une colonne et modifier les donnes associ au composant tMysqlOutput.
tInterbaseRollback
Proprits du tInterbaseRollback
Famille de composant Databases/Interbase
Fonction Le tInterbaseRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant de connexion tInterbaseConnection
dans la liste si vous prvoyez d'ajouter plus d'une connexion votre
Job en cours.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en association avec des composants Interbase, notamment
avec le tInterbaseConnection et le tInterbaseCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au tInterbaseRollback, consultez Scnario : Annuler l'insertion de donnes dans des
tables mre/fille du composant tMySQLRollback.
tInterbaseRow
Proprits du tInterbaseRow
Famille de Databases/
composant Interbase
Fonction tInterbaseRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares
sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien
que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tInterbaseRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion cre
par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement le Guide
utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Query type La requte peut tre Built-in ou distante dans le Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour terminer
le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les
lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
settings QUERY's Slectionnez cette colonne dans la liste use column.
recordset
Cette option permet au composant d'avoir un schma diffrent de celui du composant
prcdent. De plus, la colonne contenant le rsultat de la requte doit tre de type Object.
Ce composant est gnralement suivi du tParseRecordSet.
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatement
de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des
paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query de l'onglet
Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte.
Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy
et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide utilisateur
du Studio Talend.
Global QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
Variables
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est une
variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on error
est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces fichiers .jar
manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide d'installation et de
migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
tJavaDBInput
Proprits du tJavaDBInput
Famille de composant Databases/JavaDB
Fonction Le composant tJavaDBInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tJavaDBInput excute une requte en base de donnes selon un ordre strict qui doit
correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au
composant suivant via une connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes JavaDB.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInputdans :
Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.
tJavaDBOutput
Proprits du tJavaDBOutput
Famille de composant Databases/JavaDB
Fonction Le composant tJavaDBOutput crit, met jour, modifie ou supprime les donnes d'une base de
donnes.
Objectif Le tJavaDBOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en
fonction du flux entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository
Drop and create the table : supprimer la table puis en crer une
nouvelle.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et
retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et
retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et
retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et
retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les
possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table
d'une base de donnes JavaDB. Il permet aussi de crer un flux de rejet avec un lien Row > Reject
filtrant les donnes en erreur. Pour un exemple d'utilisation, consultez Scnario 3 : Rcuprer les
donnes errones l'aide d'un lien Reject du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tJavaDBRow
Proprits du tJavaDBRow
Famille de composant Databases/JavaDB
Fonction tJavaDBRow est le composant spcifique ce type de base de donnes. Il excute des requtes
SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en
place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tJavaDBRow agit sur la structure mme de
la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider
rapidement et aisment crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les
possibilits de requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
tJDBCColumnList
Proprits du tJDBCColumnList
Famille de composants Databases/JDBC
Fonction Le composant tJDBCColumList effectue une opration d'itration dans toutes les colonnes d'une
table donne, grce une connexion JDBC dfinie.
Objectif Le tJDBCColumList permet de faire une liste des libells des colonnes d'une table JDBC donne.
Basic settings Database Type Slectionnez le type de base de donnes laquelle vous souhaitez
vous connecter.
Component list Slectionnez le composant tJDBCConnection dans la liste si vous
prvoyez d'ajouter plus d'une connexion votre Job en cours.
Table name Nom de la table lire.
Die on error Cochez cette case pour arrter l'excution du Job lorsqu'une erreur
survient.
NB_COLUMN : nombre de colonnes itres jusqu' prsent. Cette variable est une variable After
et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Il faut utiliser ce composant en association avec les autres composants JDBC, notamment avec le
tJDBCConnection.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Scnario : Itrer une table de base de donnes et lister le nom des colonnes
de la table.
tJDBCClose
Proprits du tJDBCClose
Famille de composant Databases/JDBC
Fonction Le composant tJDBCClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes JDBC.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tJDBCConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tJDBCConnection et tJDBCRollback. Il est gnralement
utilis avec un composant tJDBCConnection car il permet de fermer une connexion pour la transaction en cours.
tJDBCCommit
Proprits du tJDBCCommit
Famille de composant Databases/JDBC
Fonction Le composant tJDBCCommit valide les donnes traites dans un Job partir d'une base de donnes
connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list Slectionnez le composant tJDBCConnection dans la liste si vous
prvoyez d'ajouter plus d'une connexion votre Job en cours.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants JDBC et notamment avec les
composants tJDBCConnection et tJDBCRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tJDBCCommit, consultez Scnario 1 : Insrer des donnes dans des
tables mre/fille.
tJDBCConnection
Proprits du tJDBCConnection
Famille de composant Databases/JDBC
Fonction Le composant tJDBCConnection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings JDBC URL Saisissez l'URL JDBC dans le champ associ pour vous connecter
la base de donnes. Par exemple, entrez jdbc:mysql://IP address/
database name pour vous connecter une base de donnes MySQL.
Driver JAR Cliquez sur le bouton [+] sous le tableau afin d'ajouter autant de
lignes que ncessaire pour charger diffrents JARs. Dans chaque
ligne, cliquez ensuite sur le bouton [...] pour ouvrir l'assistant [Select
Module], dans lequel vous pouvez slectionner le pilote JAR de
votre choix pour chaque ligne.
Driver Class Renseignez la classe du driver dans le champ Driver
Class en fonction de votre connexion. Par exemple, entrez
com.mysql.jdbc.Driver dans ce champ pour vous connecter une
base de donnes MySQL.
Username et Password Saisissez les informations d'authentification de l'utilisateur de base
de donnes.
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tJDBCConnection, consultez
tMysqlConnection.
tJDBCInput
Proprits du tJDBCInput
Famille de Databases/JDBC
composant
Fonction Le composant tJDBCInput lit toute base de donnes via une API JDBC et en extrait des champs l'aide de
requtes.
Si vous avez souscrit l'une des solutions Big Data de Talend, vous pouvez utiliser ce composant dans un
Job Talend Map/Reduce afin de gnrer du code Map/Reduce. Dans le cas prsent, le composant tJDBCInput
appartient la famille de composants Map/Reduce. Pour plus d'informations, consultez Le composant tJDBCInput
dans les Jobs Talend Map/Reduce.
Objectif Le tJDBCInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini
dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de
flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
JDBC URL Entrez le chemin d'accs la base de donnes.
Driver JAR Cliquez sur le bouton [+] sous le tableau afin d'ajouter autant de lignes que ncessaire pour
charger diffrents JAR. Dans chaque ligne, cliquez ensuite sur le bouton [...] pour ouvrir
l'assistant [Select Module], dans lequel vous pouvez slectionner le pilote JAR de votre choix
pour chaque ligne.
Class Name Dans le champ Class name, renseignez le nom de la classe pour qu'elle soit indique dans le
driver.
Username et Informations d'authentification de l'utilisateur de base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans la
bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis cliquez
sur OK afin de sauvegarder les paramtres.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
Schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Table Name Nom de la table lire.
Query type et Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des champs
Query corresponde celui dfini dans le schma.
Specify a data Cochez cette case et spcifiez l'alias de la source de donnes cre dans Talend Runtime pour
source alias utiliser le pool de connexions partages dfini dans la configuration des donnes source. Cette
option fonctionne lorsque vous dployez et excutez votre Job dans Talend Runtime.
Cette option est indisponible lorsque la case Use an existing connection est coche.
Advanced Use cursor Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en
settings une fois. Cette option permet d'optimiser les performances.
Trim all the Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les
String/Char colonnes contenant des chanes de caractres.
columns
Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Enable Mapping Cochez cette case pour utiliser le fichier de mappage de mtadonnes spcifi lors de la lecture
File for Dynamic de donnes d'une colonne de type dynamique. Cette case est dcoche par dfaut.
Ce champ apparat uniquement lorsque la case Enable Mapping File for Dynamic est coche.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes utilisant une connexion
JDBC.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Dans un Job Talend Map/Reduce, le composant tJDBCInput, ainsi que les autres composants Map/Reduce qui le
prcdent, gnrent du code Map/Reduce natif. Cette section prsente les proprits spcifiques du tJDBCInput
lorsqu'il est utilis dans le cas prsent. Pour plus d'informations sur les Jobs Talend Map/Reduce Job, consultez
le Guide de prise en main.
Pour plus d'informations concernant les Jobs Talend Map/Reduce, consultez les sections dcrivant
comment crer, convertir et configurer un Job Talend Map/Reduce, dans le Guide de prise en main
de Talend Open Studio for Big Data.
Notez que, dans cette documentation, sauf mention contraire, un scnario prsente uniquement des
Jobs Standard, c'est--dire des Jobs Talend traditionnels d'intgration de donnes et non des Jobs
Map/Reduce.
Hadoop Connection Vous devez utiliser l'onglet Hadoop Configuration de la vue Run afin de dfinir la connexion
une distribution Hadoop donne pour le Job complet.
Cette connexion fonctionne uniquement pour le Job dans lequel vous l'avez dfinie.
Limitation Il est recommand d'utiliser les bases de donnes suivantes avec la version Map/Reduce du
composant : DB2, Informix, MSSQL, MySQL, Netezza, Oracle, Postgres, Teradata et Vertica.
Ce composant peut galement fonctionner avec d'autres bases de donnes. Cependant, ces dernires
n'ont pas ncessairement t testes.
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInput dans :
Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.
tJDBCOutput
Proprits du tJDBCOutput
Famille de Databases/
composant JDBC
Fonction Le composant tJDBCOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Si vous avez souscrit l'une des solutions Big Data de Talend, vous pouvez utiliser ce composant dans un Job
Talend Map/Reduce ou Storm : afin de gnrer du code Map/Reduce.
Dans un Job Map/Reduce, ce composant gnre du code MapReduce et peut crire des donnes uniquement
dans une base de donnes.Pour plus d'informations, consultez Le composant tJDBCOutput dans les Jobs
Talend Map/Reduce.
Dans un Job Storm, ce composant gnre du code Storm. Pour plus d'informations, consultez Le tJDBCOutput
dans des Jobs Storm Talend.
Objectif Le tJDBCOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
JDBC URL Entrez le chemin d'accs la base de donnes.
Driver JAR Cliquez sur le bouton [+] sous le tableau afin d'ajouter autant de lignes que ncessaire pour
charger diffrents JAR. Dans chaque ligne, cliquez ensuite sur le bouton [...] pour ouvrir
l'assistant [Select Module], dans lequel vous pouvez slectionner le pilote JAR de votre choix
pour chaque ligne.
Class Name Dans le champ Class name, renseignez le nom de la classe pour qu'elle soit indique dans
le driver.
Username et Informations d'authentification de l'utilisateur de base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans la
bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis cliquez
sur OK afin de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne :
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Specify a data Cochez cette case et spcifiez l'alias de la source de donnes cre dans Talend Runtime pour
source alias utiliser le pool de connexions partages dfini dans la configuration des donnes source. Cette
option fonctionne lorsque vous dployez et excutez votre Job dans Talend Runtime.
Cette option est indisponible lorsque la case Use an existing connection est coche.
Advanced settings Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous l'ayez
Columns pralablement supprime ou non). Cette option vous permet d'effectuer des actions sur les
colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui ncessitent
un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes
dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur la
colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant tJDBCOutput
peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur
options les donnes.
Enable debug Cochez cette case pour afficher chaque tape du processus d'criture dans la base de donnes.
mode
Use Batch Cochez cette case pour activer le mode de traitement par lots pour le traitement des donnes.
Batch Size Spcifiez le nombre d'enregistrements traiter dans chaque lot. La valeur par dfaut de ce
champ est 10000.
Ce champ est disponible uniquement lorsque la case Use Batch est coche.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un
entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
JDBC. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour
un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject du
composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Dans un Job Talend Map/Reduce, le composant tJDBCOutput, ainsi que les autres composants Map/Reduce qui
le prcdent, gnrent du code Map/Reduce natif. Cette section prsente les proprits spcifiques du tJDBCInput
lorsqu'il est utilis dans le cas prsent. Pour plus d'informations sur les Jobs Talend Map/Reduce Job, consultez
le Guide de prise en main de Talend Open Studio for Big Data.
Une fois que le Job Map/Reduce est ouvert dans l'espace de modlisation, le tJDBCOutput ainsi
que la famille de composant apparat dans la Palette du Studio Talend.
Notez que, dans cette documentation, sauf mention contraire, un scnario prsente uniquement des
Jobs Standard, c'est--dire des Jobs Talend traditionnels d'intgration de donnes et non des Jobs
Map/Reduce.
Hadoop Connection Vous devez utiliser l'onglet Hadoop Configuration de la vue Run afin de dfinir la connexion
une distribution Hadoop donne pour le Job complet.
Cette connexion fonctionne uniquement pour le Job dans lequel vous l'avez dfinie.
Limitation Il est recommand d'utiliser les bases de donnes suivantes avec la version Map/Reduce du
composant : DB2, Informix, MSSQL, MySQL, Netezza, Oracle, Postgres, Teradata et Vertica.
Ce composant peut galement fonctionner avec d'autres bases de donnes. Cependant, ces dernires
n'ont pas ncessairement t testes.
Dans un Job Storm Talend, le tJDBCOutput, ainsi que les autres composants Storm le prcdent, gnrent
nativement du code Storm pour construire un Topology Storm utiliser dans votre cosystme Storm. Cette section
prsente les proprits spcifiques du tJDBCOutput dans cette situation. Pour plus d'informations concernant les
Jobs Storm Talend, consultez Guide de prise en main de Talend Open Studio for Big Data.
Driver JAR Cliquez sur le bouton [+] situ sous le tableau afin d'ajouter autant
de lignes que ncessaire pour charger diffrents JAR. Dans chaque
ligne, cliquez ensuite sur le bouton [...] pour ouvrir l'assistant [Select
Module] dans lequel vous pouvez slectionner le pilote JAR de votre
choix pour chaque ligne.
Class Name Saisissez le nom de la Classe vers laquelle pointer dans le pilote.
Par exemple, pour le pilote mysql-connector-java-5.1.2.jar, le nom
saisir est org.gjt.mm.mysql.Driver.
Username et Password Donnes d'authentification de l'utilisateur la base de donnes.
Notez que, dans cette documentation, sauf lorsqu'explicitement indiqu, un scnario prsente
uniquement des Jobs de type Standard, c'est--dire des Jobs Talend traditionnels d'intgration
de donnes.
Storm Connection Vous devez utiliser l'onglet Storm Configuration dans la vue Run pour dfinir la connexion
un systme Storm donn pour le Job complet.
Cette connexion fonctionne uniquement pour le Job dans lequel vous l'avez dfinie.
Limitation n/a
Scnarios associs
Pour un scnario associ au tJDBCOutput, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
Si vous avez souscrit l'une des solutions Big Data de Talend, vous pouvez galement consulter un Job Talend
Map/Reduce utilisant une version Map/Reduce du tJDBCOutput :
tJDBCRollback
Proprits du tJDBCRollback
Famille de composant Databases/JDBC
Fonction Le tJDBCRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant de connexion tJDBCConnection dans la
liste si vous prvoyez d'ajouter plus d'une connexion votre Job en
cours.
Close connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en association avec des composants JDBC, notamment avec
le tJDBCConnection et le tJDBCCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tJDBCRollback, consultez
tMysqlConnection.
tJDBCRow
Proprits du tJDBCRow
Famille de Databases/JDBC
composant
Fonction tJDBCRow est le composant gnrique pour tout type de base de donnes utilisant une API JDBC. Il excute
des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en
place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tJDBCRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant.
Les champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Cette option est indisponible lorsque la case Use an existing connection est coche.
Advanced Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
settings QUERY's Slectionnez cette colonne dans la liste use column.
recordset
Cette option permet au composant d'avoir un schma diffrent de celui du
composant prcdent. De plus, la colonne contenant le rsultat de la requte doit
tre de type Object. Ce composant est gnralement suivi du tParseRecordSet.
Use Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base
PreparedStatement de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des
paramtres reprsents par des "?" dans l'instruction SQL dfinie dans le champ Query de
l'onglet Basic settings.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur toute base de donnes utilisant une connexion JDBC et couvre
toutes les possibilits de requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour un scnario associ, consultez :
tJDBCSP
Proprits du tJDBCSP
Famille de composant Databases/JDBC
Fonction Le composant tJDBCSP appelle une procdure stocke de base de donnes.
Objectif Le tJDBCSP permet de centraliser des requtes multiples ou complexes dans une base de donnes
et de les appeler plus facilement.
Basic settings JDBC URL Entrez le chemin d'accs la base de donnes.
Driver JAR Cliquez sur le bouton [+] sous le tableau afin d'ajouter autant de
lignes que ncessaire pour charger diffrents JARs. Dans chaque
ligne, cliquez ensuite sur le bouton [...] pour ouvrir l'assistant [Select
Module], dans lequel vous pouvez slectionner le pilote JAR de
votre choix pour chaque ligne.
Class Name Dans le champ Class name, renseignez le nom de la classe pour
qu'elle soit indique dans le driver.
Username et Password Informations d'authentification de l'utilisateur de base de donnes.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut.
Dans ce cas, seuls les paramtres d'entre sont autoriss.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.
Scnarios associs
Pour un scnario associ, consultez :
Scnario : Excuter une procdure stocke dans le hub MDM du composant tMysqlSP.
Scnario : Vrifier le format de numros l'aide d'une procdure stocke du composant tOracleSP.
Consultez galement Scnario 1 : Insrer des donnes dans des tables mre/fille si vous voulez analyser un
ensemble d'enregistrements d'une table de donnes ou d'une requte SQL.
tJDBCTableList
Proprits du tJDBCTableList
Famille de composant Databases/JDBC
Fonction Le composant tJDBCTableList effectue une opration d'itration sur toutes les tables d'une base
de donnes, grce une connexion JDBC dfinie.
Objectif Le composant tJDBCTableList permet de lister les noms des tables JDBC grce aux commandes
SELECT et WHERE.
Basic settings Database type Slectionnez dans la liste la base de donnes que vous utilisez.
Component list Slectionnez le composant de connexion tJDBCConnection ou le
composant de connexion de la base de donnes slectionne dans la
liste Database type.
Advanced settings Use filter Cochez cette case afin de filtrer les tables sur lesquelles effectuer une
itration.
Regular expression for Saisissez l'expression rgulire permettant d'identifier le nom des
tables name tables.
Include : effectue une itration sur les noms de tables identifis par
l'expression rgulire uniquement.
Exclude : effectue une itration sur les noms de tables non identifis
par l'expression rgulire.
Cette liste est disponible lorsque la case Use filter est coche.
tStatCatcher statistics Cochez cette case afin de collecter les donnes de log au niveau des
composants.
Global Variables CURRENT_TABLE : nom de la table sur laquelle se fait l'itration. Cette variable est une variable
Flow et retourne une chane de caractres.
NB_TABLE : nombre de tables itres jusqu' prsent. Cette variable est une variable Flow et
retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis en association avec les autres composants JDBC, notamment avec le
tJDBCConnection.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ, consultez Scnario : Itrer une table de base de donnes et lister le nom des colonnes
de la table.
tLDAPAttributesInput
Proprits du tLDAPAttributesInput
Famille de composant Databases/LDAP
Fonction Le composant tLDAPAttributesInput analyse chaque lment trouv via une requte LDAP et
liste une srie d'attributs associs l'objet.
Objectif Le tLDAPAttributesInput excute une LDAP base sur un filtre prdfini et correspondant au
schma dfini. Puis la liste de champ est transmise au composant suivant via une connexion Main
row.
Basic settings Property type Peut tre Built-in ou Repository
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
RESULT_NAME : nom de l'entre LDAP correspondant au filtre de recherche. Cette variable est
une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les requtes LDAP possibles.
Note : Appuyez sur Ctrl + Espace pour accder la liste des variables globales, notamment la
variable GetResultName permettant de rcuprer automatiquement la base correspondante.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Le composant tLDAPAttributesInput fonctionne de manire similaire au tLDAPInput. Vous pouvez donc
consulter Scnario : Afficher le contenu filtr d'un annuaire LDAP.
tLDAPClose
Proprits du tLDAPClose
Famille de composant Databases/LDAP
Fonction Le composant tLDAPClose ferme la connexion au serveur d'un annuaire connect.
Objectif Le tLDAPClose est utilis pour arrter une connexion un serveur d'un annuaire afin de librer
des ressources occupes.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tLDAPConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job
ainsi qu'au niveau des composants.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants LDAP, notamment avec le
tLDAPConnection.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tLDAPConnection
Proprits du tLDAPConnection
Famille de composant Databases/LDAP
Fonction Le composant tLDAPConnection ouvre une connexion au serveur d'un annuaire pour effectuer
des transactions de donnes.
Objectif Le tLDAPConnection cre une connexion au serveur d'un annuaire LDAP. Cette connexion
peut tre invoque par d'autres composants devant accder l'annuaire LDAP, c'est--dire les
composants tLDAPInput, tLDAPOutput, etc.
Basic settings Property type Peut tre Built-in ou Repository
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li au tLDAPInput et au tLDAPOutput, puisqu'il vous permet de ne pas avoir
toujours saisir les informations de connexion lors de l'utilisation de diffrents tLDAPInput ou tLDAPOutput.
Pour un scnario associ au tLDAPConnection, consultez Scnario 1 : Insrer des donnes dans des tables mre/
fille.
tLDAPInput
Proprits du tLDAPInput
Famille de composant Databases/LDAP
Fonction Le composant tLDAPInput lit un rpertoire et extrait les donnes en fonction d'un filtre dfini.
Objectif Le tLDAPInput excute une LDAP base sur un filtre prdfini et correspondant au schma dfini.
Puis la liste de champ est transmise au composant suivant via une connexion Main row.
Basic settings Property type Peut tre Built-in ou Repository
RESULT_NAME : nom de l'entre LDAP correspondant au filtre de recherche. Cette variable est
une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les requtes LDAP possibles.
Note : Appuyez sur Ctrl + Espace pour accder la liste des variables globales, inclus la variable
GetResultName permettant de rcuprer automatiquement la base correspondante.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations
sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
3. Slectionnez Repository dans le champ Property type si vous avez stock les informations de connexion
LDAP dans le Metadata Manager du Repository. Puis slectionnez l'entre adquate dans la liste.
4. En mode Built-In, renseignez manuellement les champs Host et Port. Host peut tre l'adresse IP du serveur
de l'annuaire LDAP ou son nom DNS.
6. Puis dans le champ Protocol, slectionnez le protocole adquat dans la liste. Dans cet exemple : un protocole
LDAP simple est utilis.
7. Cochez la case Authentication et renseignez les informations de connexion pour lire l'annuaire, si ncessaire.
Dans ce scnario, aucune authentification n'est ncessaire.
8. Dans la zone Filter, saisissez la commande sur laquelle est base la slection de donnes. Dans cet exemple,
le filtre est : (&(objectClass=inetorgperson)&(uid=PIERRE DUPONT)).
9. Renseignez le champ Multi-valued field separator avec une virgule, puisque certains champs contiennent
plus d'une valeur spare par une virgule.
10.Comme vous ne savez pas si des alias sont utiliss dans l'annuaire LDAP, slectionnez Always dans la liste.
13.Dfinissez le Schma tel qu'il est requis par l'annuaire LDAP. Dans cet exemple, le schma est compos de
six colonnes dont les colonnes objectClass et uid qui seront filtres.
Seule une entre de l'annuaire correspond aux critres du filtre dfini dans le composant tLDAPInput.
tLDAPOutput
Proprits du tLDAPOutput
Famille de composant Databases/LDAP
Fonction Le composant tLDAPOutput crit dans un annuaire LDAP.
Objectif Le tLDAPOutput excute une requte LDAP base sur un filtre prdfini et correspondant un
schma dfini. Puis la liste de champ est transmise au composant suivant via une connexion Main
row.
Basic settings Property type Peut tre Built-in ou Repository.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et
retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les requtes LDAP possibles.
Note : Appuyez sur Ctrl + Espace pour accder la liste des variables globales, inclus la variable
GetResultName permettant de rcuprer automatiquement la base correspondante. Ce composant
permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes. Il permet
aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un
exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien
Reject du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
La sortie prsente les champs suivants : dn, uid et mail, comme dfini dans le Job.
2. Connectez le composant tLDAPInput au tMap l'aide d'un lien Row > Main.
Glissez et dposez la colonne uid de la table d'entre (input) la table de sortie (output) puisque aucune
modification n'est ncessaire pour cette colonne.
3. Dans le champ Expression de la colonne dn de la table de sortie (output), saisissez l'expression exacte
attendue par le serveur LDAP afin qu'il atteigne l'arborescence souhaite et permette d'crire dans l'annuaire,
condition que vous n'ayez pas dj renseign le champ Base DN du composant tLDAPOutput.
4. Dans cet exemple, la variable globale GetResultName est utilise pour rcuprer automatiquement
le chemin d'accs. Appuyez sur Ctrl+Espace pour accder la liste de variable et slectionnez
tLDAPInput_1_RESULT_NAME.
5. Dans le champ Expression de la colonne mail, saisissez l'adresse e-mail qui remplacera celle obsolte dans
l'annuaire LDAP. Dans cet exemple, le nouvel e-mail est : Pierre.Dupont@talend.com.
6. Slectionnez le composant tLDAPOutput pour dfinir les proprits d'criture dans l'annuaire.
7. Dfinissez manuellement les champs Port et Host si ces informations ne sont pas stockes dans le
Repository.
8. Dans le champ Base DN, dfinissez la plus haute arborescence laquelle vous avez accs. Si vous n'avez
pas dfini le chemin complet et exact au DN cible, dfinissez-le ici. Dans cet exemple, le DN complet est
fournit par la sortie dn du composant tMap, Ainsi, seule la plus haute arborescence accessible est fournie :
o=directoryRoot.
Puis renseignez les champs User et Password attendus par l'annuaire LDAP.
Dans le champ Multi-valued field separator, saisissez une virgule afin de sparer les champs contenant
plusieurs valeurs spares par des virgules.
10. Laissez les paramtres par dfaut des champs Alias Dereferencing et Referral Handling, c'est--dire
respectivement Always et Ignore.
Dans le champ Insert mode, slectionnez l'option Update pour cet exemple (l'adresse e-mail).
11. Dans la vue Advanced settings, cochez la case Use Attributes Options (for update mode) pour afficher
la table Attribute Options.
Slectionnez l'attribut mail dans la colonne Attribute Name et slectionnez Replace dans la colonne Option.
Excuter le Job
1. Appuyez sur les touches Ctrl+S pour sauvegarder le Job.
tLDAPRenameEntry
Proprits du tLDAPRenameEntry
Famille de composant Databases/LDAP
Fonction Le composant tLDAPRenameEntry renomme des entres dans un annuaire LDAP.
Objectif Le tLDAPRenameEntry permet de renommer une ou des entre(s) dans un annuaire LDAP
slectionn.
Basic settings Property type Peut tre Built-in ou Repository
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les requtes LDAP possibles. Il est gnralement utilis comme sous-
Job un seul composant mais il peut aussi tre utilis en association avec d'autres composants.
Note : Appuyez sur Ctrl + Espace pour accder la liste des variables globales, inclus la variable
GetResultName permettant de rcuprer automatiquement la base correspondante.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour un scnario associ au composant tLDAPRenameEntry, consultez :
tMaxDBInput
Proprits du tMaxDBInput
Famille de composant Databases/MaxDB
Fonction Le composant tMaxDBInput lit une table de base de donnes et en extrait des champs l'aide
de requtes.
Objectif Le tMaxDBInput excute une requte en base de donnes selon un ordre strict qui doit
correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au
composant suivant via une connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les
possibilits des requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation
de ces fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend,
dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez les scnarios dans :
tMaxDBOutput
Proprits du tMaxDBOutput
Famille de composant Databases/MaxDB
Fonction Le composant tMaxDBOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tMaxDBOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du
flux entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits
du composant. Les champs suivants sont alors pr-remplis l'aide des donnes
collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la
base de donnes et enregistrer les paramtres de connexion que vous avez dfinis
dans la vue Basic settings du composant.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :
Drop and create the table : supprimer la table puis en crer une nouvelle.
Drop a table if exists and create : supprimer la table si elle existe dj, puis
en crer une nouvelle.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il
peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des
entiers (integer) ou des fonctions (function), assurez-vous que les valeurs par
dfaut ne sont pas entoures de guillemets. Si c'est le cas, vous devez supprimer
manuellement les guillemets.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne
un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un
entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne
un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un
entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
MaxDB. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur.
Pour un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien
Reject du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation de ces
fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend, dans le Guide
d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tMaxDBRow
Proprits du tMaxDBRow
Famille de composant Databases/MaxDB
Fonction tMaxDBRow est le composant spcifique ce type de base de donnes. Il excute des requtes
SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en
place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tMaxDBRow agit sur la structure mme de
la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider
rapidement et aisment crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les
possibilits de requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant requiert l'installation des fichiers .jar lis. Pour plus d'informations sur l'installation
de ces fichiers .jar manquants, consultez la section dcrivant comment configurer le Studio Talend,
dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez :
tParseRecordSet
Proprits du tParseRecordSet
Ce composant se trouve la racine de la famille Databases de la Palette de la perspective Integration du Studio
Talend. Le composant tParseRecordSet couvre des besoins indirectement lis l'utilisation des bases de donnes
de tout type.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut.
Dans ce cas, seuls les paramtres d'entre sont autoriss.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Ce composant est principalement utilis avec la fonctionnalit Recordset d'un composant SP.
Scnario associ
Pour un exemple d'utilisation du tParseRecordSet, consultez Scnario 2 : Utiliser l'instance PreparedStatement
pour faire une requte sur des donnes.
tPostgresPlusBulkExec
Proprits du tPostgresPlusBulkExec
Les composants tPostgresPlusOutputBulk et tPostgresPlusBulkExec sont gnralement utiliss ensemble pour
d'une part gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte
SQL nonce. Cette excution en deux tapes est unifie dans le composant tPostgresPlusOutputBulkExec,
dtaill dans une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet
de procder des transformations avant le changement des donnes dans la base de donnes.
Famille de composant Databases/PostgresPlus
Fonction Le composant PostgresPlusBulkExec excute des oprations d'Insert sur les donnes fournies.
Objectif Le tPostgresPlusBulkExec est un composant ddi qui permet un gain de performance pendant les
oprations d'Insert dans une base de donnes DB2.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits
du composant. Les champs suivants sont alors pr-remplis l'aide des donnes
collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir
connection de la liste Component list pour rutiliser les paramtres d'une connexion que
vous avez dj dfinie.
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password,
puis, dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre
guillemets doubles, puis cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :
Drop and create table: supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en
crer une nouvelle.
Ce fichier est situ sur la machine spcifie par l'URI dans le champ
Host et doit tre sur la mme machine que le serveur de la base de
donnes.
Schema et Edit Schema Un schma est une description de lignes, il dfinit le nombre de champs qui
sont traits et passs au composant suivant. Le schma est soit local (Built-in),
soit distant dans le Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans
n'importe quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des
entiers (integer) ou des fonctions (function), assurez-vous que les valeurs par
dfaut ne sont pas entoures de guillemets. Si c'est le cas, vous devez supprimer
manuellement les guillemets.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans
la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient
inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits
des requtes Postgresplus.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur
cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tPostgresPlusBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulkExec.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tPostgresPlusClose
Proprits du tPostgresPlusClose
Famille de composant Databases/PostgresPlus
Fonction Le composant tPostgresPlusClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes PostgresPlus.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tPostgresPlusConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tPostgresPlusConnection et tPostgresPlusRollback. Il est
gnralement utilis avec un composant tPostgresPlusConnection car il permet de fermer une connexion pour
la transaction en cours.
tPostgresPlusCommit
Proprits du tPostgresPlusCommit
Famille de composant Databases/PostgresPlus
Fonction Le composant tPostgresPlusCommit valide les donnes traites dans un Job partir d'une base
de donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tPostgresPlusConnection dans la liste.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants PostgresPlus et notamment avec les
composants tPostgresPlusConnection et tPostgresPlusRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tPostgresPlusCommit, consultez Scnario
1 : Insrer des donnes dans des tables mre/fille.
tPostgresPlusConnection
Proprits du tPostgresPlusConnection
Famille de composant Databases/PostgresPlus
Fonction Le composant tPostgresPlusConnection ouvre une connexion vers une base de donnes afin
d'effectuer une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tPostgresPlusConnection, consultez
tMysqlConnection.
tPostgresPlusInput
Proprits du tPostgresPlusInput
Famille de Databases/
composant PostgresPlus
Fonction Le composant tPostgresPlusInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tPostgresPlusInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui
dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion
de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de donnes
et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du
composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Table name Nom de la table de base de donnes.
Query type et Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des champs
Query corresponde celui dfini dans le schma.
Advanced Use cursor Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en
settings une fois. Cette option permet d'optimiser les performances
Trim all the Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes
String/Char contenant des chanes de caractres.
columns
Trim column Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette variable
Variables est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes PostgresPlus.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tPostgresPlusInput :
tPostgresPlusOutput
Proprits du tPostgresPlusOutput
Famille de Databases/
composant PostgresPlus
Fonction Le tPostgresPlusOutput crit, met jour, effectue les changements ou supprime les entres dans une base de
donnes.
Objectif Le tPostgresPlusOutput excute l'action dfinie sur la table et/ou sur les donnes contenues dans la table,
partir du flux entrant du composant prcdent dans le Job.
Basic settings Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Cliquez sur cette icne pour ouvrir l'assistant de configuration de connexion la base de
donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic
settings du composant.
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Drop and create table : supprimer la table puis en crer une nouvelle.
Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Advanced Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
settings option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous
Columns l'ayez pralablement supprime ou non). Cette option vous permet d'effectuer des actions
sur les colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui
ncessitent un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les
donnes dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur la
colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant
tPostgresqlOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle
modifier.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur
les donnes.
Enable debug Cochez cette case pour afficher chaque tape du processus de d'criture dans la base de
mode donnes.
Support null in Cochez cette case pour prendre en compte les valeurs Null d'une table de base de donnes.
"SQL WHERE"
statement Assurez-vous que la case Nullable est bien coche pour les colonnes du schma
correspondantes.
Use Batch size Cochez cette case afin d'activer le mode batch pour le traitement des donnes. Dans le champ
Batch Size qui apparat, vous pouvez saisir le nombre de lignes par lot charger.
Cette case est disponible uniquement si vous avez choisi l'option Insert, Update,
Single Insert Query ou Delete dans le champ Action on data.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie. Cette variable
est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un
entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans
la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des
requtes SQL. Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes
PostgresPlus. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur.
Pour un exemple d'utilisation, consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject
du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour des scnarios associs, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tPostgresPlusOutputBulk
Proprits du tPostgresPlusOutputBulk
Les composants tPostgresPlusOutputBulk et tPostgresPlusBulkExec sont gnralement utiliss ensemble pour
d'une part gnrer en sortie le fichier qui sera d'autre part utilis comme paramtre dans l'excution de la requte
SQL nonce. Cette excution en deux tapes est unifie dans le composant tPostgresPlusOutputBulkExec,
dtaill dans une section spare. L'intrt de proposer deux composants spars rside dans le fait que cela permet
de procder des transformations avant le chargement des donnes dans la base de donnes.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir
la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.
Utilisation Ce composant est gnralement utilis avec le composant tPostgresPlusBulkExec. Ensemble
ils offrent un gain de performance important pour l'alimentation d'une base de donnes
PostgresPlus.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation
d'Apache : http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en
anglais).
Scnarios associs
Pour un scnario associ au composant tPostgresPlusOutputBulk, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tPostgresPlusOutputBulkExec
Proprits du tPostgresplusOutputBulkExec
Les composants tPostgresPlusOutputBulk et tPostgresPlusBulkExec sont gnralement utiliss ensemble
comme deux parties d'un processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans
la deuxime tape, ce fichier est utilis lors de l'opration d'INSERT afin de peupler une base de donnes. Cette
excution en deux tapes est unifie dans le composant tPostgresPlusOutputBulkExec.
Drop and create the table : supprimer la table puis en crer une
nouvelle.
Scnarios associs
Pour un scnario associ au composant tPostgresPlusOutputBulkExec, consultez :
Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.
Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.
tPostgresPlusRollback
Proprits du tPostgresPlusRollback
Famille de composant Databases/PostgresPlus
Fonction Le tPostgresPlusRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant permet d'viter le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant tPostgresPlusConnection dans la liste
s'il y a plus d'une connexion dans votre Job.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec d'autres composants PostgresPlus, notamment les
composants tPostgresPlusConnection et tPostgresPlusCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tPostgresPlusRollback, consultez Scnario : Annuler l'insertion de
donnes dans des tables mre/fille.
tPostgresPlusRow
Proprits du tPostgresPlusRow
Famille de Databases/
composant PostgresPlus
Fonction Le tPostgresPlusRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL
dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le
Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, tPostgresPlusRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Propagate QUERY's Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
settings recordset Slectionnez cette colonne dans la liste use column.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job. Cette
fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure mais
se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement dans
lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et
excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide utilisateur
du Studio Talend.
Global QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
Variables
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour un scnario associ, consultez :
tPostgresPlusSCD
Le composant tPostgresPlusSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tPostgresPlusSCD.
tPostgresPlusSCDELT
tSAPHanaClose
Proprits du tSAPHanaClose
Famille de composant Databases / SAP Hana
Fonction Le composant tSAPHanaClose ferme la connexion ouverte la base de donnes aprs fin de la
transaction.
Objectif Le composant ferme une connexion la base de donnes SAP Hana.
Basic settings Component list Slectionnez le composant tSAPHanaConnection dans la liste si
plus d'une connexion est dfinie dans le Job.
Advanced settings tStatCatcher Statistics Cochez cette case pour connecter les donnes de log au niveau de
chaque composant.
Utilisation Ce composant est gnralement utilis avec d'autres composants SAP Hana, notamment le
tSAPHanaConnection et le tSAPHanaCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tSAPHanaCommit
Proprits du tSAPHanaCommit
Famille de composant Databases / SAP Hana
Fonction Le composant tSAPHanaCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list Slectionnez le composant tSAPHanaConnection dans la liste si
plus d'une connexion est dfinie dans le Job.
Close Connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Pour un scnario associ ce composant, consultez Scnario 1 : Insrer des donnes dans des tables mre/fille.
tSAPHanaConnection
Proprits du tSAPHanaConnection
Famille de composant Databases / SAP Hana
Fonction Le composant tSAPHanaConnection ouvre une connexion la base de donnes SAP Hana afin
d'effectuer une transaction.
Objectif Ce composant vous permet d'tablir une connexion SAP Hana rutiliser dans d'autres
composants SAP Hana au sein du Job.
Basic settings DB Version Slectionnez la version de la base de donnes SAP Hana Database
(HDB) que vous utilisez.
Host Saisissez l'adresse IP du serveur de la base de donnes.
Port Saisissez le numro du port d'coute du serveur de la base de
donnes.
Table Schema Saisissez le nom du schma de la base de donnes.
Username et Password Saisissez vos informations d'authentification la base de donnes.
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tSAPHanaInput
Proprits du tSAPHanaInput
Famille de Databases / SAP
composant Hana
Fonction Le composant tSAPHanaInput lit une base de donnes et extrait des champs selon une requte.
Objectif Le tSAPHanaInputexcute une requte en base de donnes selon un ordre strict qui doit correspondre
celui dfini dans le schma. La liste des champs rcuprs est ensuite transmise au composant suivant via une
connexion de flux Main > Row.
Basic settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Table Name Nom de la table crire. Notez qu'une seule table peut tre crite la fois.
Query Type Peut tre Built-in ou Repository..
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Saisissez manuellement l'instruction de requte ou construisez-la graphiquement
via le SQLBuilder.
Repository : Slectionnez la requte stocke dans le Repository. Le champ Query est
automatiquement renseign.
Guess Query Cliquez sur le bouton Guess Query afin de gnrer la requte correspondant au schma de
votre table dans le champ Query.
Guess schema Cliquez sur le bouton Guess schema pour rcuprer le schma de la table.
Query Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des champs
corresponde celui dfini dans le schma.
Advanced settings Additional Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de
JDBC donnes. Cette option est indisponible lorsque la case Use an existing connection est coche
Parameters dans la vue Basic settings.
Trim all the Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans les colonnes
String/Char de type String/Char.
columns
Trim column Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Dcochez la case Trim all the String/Char columns pour activer cette option.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau de chaque composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en standalone car il comprend le moteur de SAP Hana. C'est un composant
de dbut pouvant initier un traitement de flux de donnes.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tSAPHanaOutput
Proprits du tSAPHanaOutput
Famille de Databases / SAP
composant Hana
Fonction Le composant tSAPHanaOutput crit, met jour, modifie ou supprime des entres dans une base de donnes
SAP Hana.
Objectif Le tSAPHanaOutput excute l'action dfinie sur la table et/ou sur les donnes contenues dans la table, partir
du flux entrant du composant prcdent dans le Job.
Basic settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Create table if not exists : La table est cre si elle n'existe pas.
Drop table if exists and create : La table est supprime si elle existe dj puis cre nouveau.
Row : Les donnes sont stockes sous forme de lignes. Il est prfrable d'utiliser ce type de
table si la majorit des accs la table consiste en la slection de quelques enregistrements
avec tous les attributs slectionns.
Column : Les donnes sont stockes sous forme de colonnes. Il est prfrable d'utiliser ce
type de table si la majorit des accs la table s'effectue un grand nombre de fois avec
seulement quelques attributs slectionns.
Global temporary : La dfinition de la table et les donnes peuvent tre vues par tous les
utilisateurs et toutes les connexions pendant la dure de la session en cours. La table est
supprime la fin de la session.
Local temporary : La dfinition de la table et les donnes ne peuvent tre vues que par
l'utilisateur qui a cr la table pendant la dure de la session en cours. La table est supprime
la fin de la session.
Action on data Sur les donnes de la table dfinie, vous pouvez choisir d'effectuer l'opration suivante :
Insert : Ajouter de nouvelles entres la table. Si des doublons sont trouvs, le Job s'arrte.
Il est ncessaire de spcifier au moins une colonne en tant que cl primaire sur
laquelle baser les oprations Update et Delete. Vous pouvez faire ceci en cliquant
sur Edit Schema et en cochant la case correspondant la colonne (aux colonnes)
que vous souhaitez dfinir comme cl primaire. Pour une utilisation avance,
consultez la description de l'option Use field options, dans l'onglet Advanced
settings de ce composant.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
Schema et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Die on error Cette case est dcoche par dfaut, afin d'ignorer les lignes en erreur et de terminer le
traitement avec les lignes sans erreur. Si ncessaire, vous pouvez rcuprer les lignes en erreur
via un lien Row > Rejects.
Advanced Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de
settings Parameters donnes. Cette option est indisponible lorsque la case Use an existing connection est coche
dans la vue Basic settings.
Commit every Saisissez le nombre de lignes terminer avant de commiter des lots de lignes en mme temps
dans la base de donnes. Cette option vous assure une certaine qualit de transaction (mais
pas de rollback) et, surtout, une meilleure performance l'excution.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous l'ayez
Columns pralablement supprime ou non). Cette option vous permet d'effectuer des actions sur les
colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui ncessitent
un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes
dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur la
colonne de rfrence.
Reference column : Saisissez une colonne de rfrence que le composant tSAPHanaOutput
peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y a plusieurs actions sur les
donnes. Dans cette table, vous pouvez :
Key in update : dfinir la cl primaire utiliser lors d'une opration de mise jour.
Cette option est disponible uniquement lorsque la case Use an existing connection
n'est pas coche dans la vue Basic settings.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de contexte
settings afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans votre Job.
Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la mme structure
mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans un environnement
dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre
dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue Basic
settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible dans la vue
Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant doit tre reli un composant d'entre. Il vous permet d'effectuer des actions sur une table ou sur
les donnes d'une de la base de donnes SAP Hana. Cela vous permet de crer des flux de rejet l'aide d'un lien
Row > Reject afin de filtrer les donnes en erreur.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tSAPHanaRollback
Proprits du tSAPHanaRollback
Famille de composant Databases / SAP Hana
Fonction Le composant tSAPHanaRollback annule une transaction dans la base de donnes connecte.
Objectif Ce composant permet d'viter le commit de transaction involontaire.
Basic settings Component list Slectionnez dans la liste le composant tSAPHanaConnection si
plus d'une connexion est dfinie dans le Job.
Close Connection Dcochez cette case pour continuer utiliser la connexion
slectionne une fois que le composant a termin ses tches.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant est gnralement utilis avec d'autres composants SAP Hana, notamment le
tSAPHanaConnection et tSAPHanaCommit, afin de mener bien des transactions.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation n/a
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tSAPHanaRow
Proprits du tSAPHanaRow
Famille de Databases / SAP
composant Hana
Fonction Le composant tSAPHanaRow est le composant spcifique ce type de base de donnes. Il excute des requtes
SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux
dans le Job bien que ce composant ne produise pas de donnes en sortie.
Objectif Selon la nature de la requte et de la base de donnes, le tSAPHanaRow agit sur la structure mme de la base de
donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment
crire vos requtes.
Basic settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Username et Informations d'authentification de l'utilisateur de base de donnes.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis, dans
la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles, puis
cliquez sur OK afin de sauvegarder les paramtres.
Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits
Schema et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le
Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est
renseign automatiquement.
Guess Query Cliquez sur le bouton Guess Query afin de gnrer la requte correspondant au schma de
votre table dans le champ Query.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires la connexion la
settings Parameters base de donnes. Cette option est indisponible si vous avez coch la case Use an existing
connection dans la vue Basic settings.
Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours.
QUERY's recordset Slectionnez cette colonne dans la liste use column.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes
SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Aucun scnario n'est disponible pour ce composant.
tSasInput
Proprits du tSasInput
Famille de composant Databases/SAS
Fonction Le composant tSasInput lit une base de donnes et en extrait des champs l'aide de requtes.
Objectif Le tSasInput excute une requte en base de donnes selon un ordre strict qui doit correspondre
celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant
suivant via une connexion de flux (Main row).
Basic settings Property type Peut tre Built-in ou Repository
"TpSas C:/SAS/TpSas'"
Username et Password Informations d'authentification de l'utilisateur de base de donnes.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes utilisant
une connexion SAS.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant
ne sont pas fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur
le bouton Install dans l'onglet Component. Vous pouvez galement trouver les Jar manquants
et les ajouter dans l'onglet Modules de la perspective Integration de votre studio. Pour plus
d'informations, consultez la page https://help.talend.com/display/KB/How+to+install+external
+modules+in+the+Talend+products (en anglais) ou la section dcrivant comment configurer le
studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInput :
Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.
tSasOutput
Proprits du tSasOutput
Famille de Databases/SAS
composant
Fonction Le composant tSasOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes.
Objectif Le tSasOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux entrant
provenant du composant prcdent.
Basic settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis,
dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles,
puis cliquez sur OK afin de sauvegarder les paramtres.
Table Nom de la table lire.
Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne :
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des
doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures
de guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Enable debug mode Cochez cette case pour afficher chaque tape du processus d'criture dans la base de
donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Global NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
Variables
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes utilisant une connexion SAS.
Il permet de faire des actions sur une table ou les donnes d'une table d'une base de donnes SAS. Il permet aussi
de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple d'utilisation,
consultez Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Limitation Du fait d'une incompatibilit de licence, un ou plusieurs Jar requis pour utiliser ce composant ne sont pas
fournis. Vous pouvez installer les Jar manquants pour ce composant en cliquant sur le bouton Install dans
l'onglet Component. Vous pouvez galement trouver les Jar manquants et les ajouter dans l'onglet Modules de
la perspective Integration de votre studio. Pour plus d'informations, consultez la page https://help.talend.com/
display/KB/How+to+install+external+modules+in+the+Talend+products (en anglais) ou la section dcrivant
comment configurer le studio, dans le Guide d'installation et de migration Talend.
Scnarios associs
Pour un scnario associ au tSasOutput, consultez :
Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.
tSQLiteClose
Proprits du tSQLiteClose
Famille de composant Databases/SQLite
Fonction Le composant tSQLiteClose ferme la connexion une base de donnes connecte.
Objectif Ce composant permet de fermer une connexion la base de donnes SQLite.
Basic settings Component list S'il y a plus d'une connexion dans le Job en cours, slectionnez le
composant tSQLiteConnection dans la liste.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de
sortie.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Ce composant est troitement li aux composants tSQLiteConnection et tSQLiteRollback. Il est gnralement
utilis avec un composant tSQLiteConnection car il permet de fermer une connexion pour la transaction en cours.
tSQLiteCommit
Proprits du tSQLiteCommit
Famille de composant Databases/SQLite
Fonction Le composant tSQLiteCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.
Objectif En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de
commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance.
Notez que si vous devez commiter chaque instruction en tant que transaction individuelle, vous
devez utiliser la fonction Auto Commit disponible dans le composant de connexion.
Basic settings Component list Slectionnez le composant tSQLiteConnection dans la liste s'il y a
plus d'une connexion dans votre Job.
Close connection Cette option est coche par dfaut. Elle permet de fermer la
connexion la base de donnes une fois le commit effectu.
Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis avec des composants SQLite, notamment les composants
tSQLiteConnection et tSQLiteRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tSQLiteCommit, consultez Scnario 1 :
Insrer des donnes dans des tables mre/fille.
tSQLiteConnection
Proprits du tSQLiteConnection
Famille de composant Databases/SQLite
Fonction Le composant tSQLiteConnection ouvre une connexion vers une base de donnes afin d'effectuer
une transaction.
Objectif Ce composant est utilis pour ouvrir une connexion la base de donnes spcifie afin de pouvoir
la rutiliser dans le(s) sous-job(s) suivant(s).
Basic settings Property type Peut tre Built-in ou Repository
Lorsque cette case est coche, vous ne pouvez utiliser les composants
de commit correspondant pour commiter les modifications dans la
base de donnes. De la mme manire, lorsque vous utilisez un
composant de commit, cette case doit tre dcoche. Par dfaut,
la fonctionnalit d'auto-commit est dsactive et les modifications
doivent tre commites de manire explicite l'aide du composant
correspondant de commit.
Utilisation Ce composant est gnralement utilis avec des composants SQLite, notamment les composants
tSQLiteCommit et tSQLiteRollback.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour un scnario associ au composant tSQLiteConnection, consultez tMysqlConnection.
tSQLiteInput
Proprits du tSQLiteInput
Famille de Databases/
composant SQLite
Fonction Le composant tSQLiteInput lit une base de donnes et en extrait des champs l'aide de requtes. Un petit
moteur de base de donnes SQLite lui est intgr, il n'a donc pas besoin d'tre connect un serveur de base
de donnes.
Objectif Le tSQLiteInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui
dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une
connexion de flux (Main row).
Basic settings Property Peut tre Built-in ou Repository
type
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les
champs suivants sont alors pr-remplis l'aide des donnes collectes.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base de
donnes, consultez le Guide utilisateur du Studio Talend.
Database Chemin d'accs au fichier de la base de donnes SQLite.
Schema et Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et passs
Edit Schema au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis.
Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :
Change to built-in property : slectionnez cette option pour passer le schma en mode Built-
In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Query type La requte peut tre construite manuellement (Built-in) pour un Job particulier ou stocke dans
le Repository s'il s'agit d'une requte frquemment utilise, pour en faciliter l'utilisation.
Query Si elle n'est pas stocke dans le Repository, saisissez votre requte en faisant particulirement
attention l'ordre des champs afin qu'ils correspondent la dfinition du schma.
Advanced settings Trim all Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
the String/
Char
columns
Trim column Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStat Cochez cette case pour collecter les donnes de log au niveau du composant.
Catcher
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die on
error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est tout fait autonome du fait de son moteur de base de donnes SQLite intgr. Il s'agit d'un
composant de dbut pouvant initier un traitement de flux de donnes.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Reliez le composant d'entre et de sortie l'aide d'un lien de type row Main.
Dans l'onglet Basic settings du composant tSQLiteInput, saisissez le chemin d'accs ou parcourez vos dossiers
jusqu'au fichier d'entre la base de donne SQLite.
Le fichier contient des centaines de lignes et comprend une colonne ip servant de base la requte.
Dans l'onglet Basic settings du composant tSQLiteInput, modifiez le schma afin qu'il corresponde la
structure de la table.
Dans le champ Query, renseignez la requte choisie par rapport la colonne ip.
Pour le composant tSQLiteOutput, dans le champ Database de l'onglet Basic settings, slectionnez le chemin
d'accs la base de donnes de sortie.
Dans le champ Table, renseignez le nom de la table alimenter avec les donnes slectionnes.
A partir des listes droulantes Action on table et Action on Data, slectionnez les actions effectuer sur la
table et sur les donnes. Dans le cas prsent, les actions sont, respectivement, Drop and create et Insert.
tSQLiteOutput
Proprits du tSQLiteOutput
Famille de Databases/
composant SQLite
Fonction Le composant tSQLiteOutput crit, met jour, modifie ou supprime les donnes d'une base de donnes. Un
petit moteur de base de donnes SQLite lui est intgr, il n'a donc pas besoin d'tre connect un serveur de
base de donnes.
Objectif Le tSQLiteOutput excute l'action dfinie sur la table et/ou sur les donnes d'une table, en fonction du flux
entrant provenant du composant prcdent.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Use an Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
existing Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
connection
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser une
connexion existant entre les deux niveaux, par exemple pour partager la connexion
cre par le Job parent avec le Job enfant, vous devez :
Pour plus d'informations sur comment dfinir et stocker des paramtres de connexion de base
de donnes, consultez le Guide utilisateur du Studio Talend.
Database Chemin d'accs au fichier de la base de donnes.
Table Nom de la table crer. Vous ne pouvez crer qu'une seule table la fois.
Action on Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table slectionne :
table
None : n'effectuer aucune opration de table.
Drop and create the table : supprimer la table puis en crer une nouvelle.
Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe quelle
solution de Talend.
Built-In : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir
galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Lorsque le schma rutiliser contient des valeurs par dfaut, qui sont des entiers (integer)
ou des fonctions (function), assurez-vous que les valeurs par dfaut ne sont pas entoures de
guillemets. Si c'est le cas, vous devez supprimer manuellement les guillemets.
Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.
Update repository connection : slectionnez cette option afin de modifier le schma stock
dans le rfrentiel et dcider de propager ou non les modifications tous les Jobs. Si
vous souhaitez propager les modifications uniquement au Job courant, slectionnez No et
slectionnez nouveau la mtadonne du schma dans la fentre [Repository Content].
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour
terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
Advanced settings Commit every Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
Additional Cette option n'est pas disponible si vous venez de crer la table de donnes (que vous l'ayez
Columns pralablement supprime ou non). Cette option vous permet d'effectuer des actions sur les
colonnes, l'exclusion des actions d'insertion, de mise jour, de suppression ou qui ncessitent
un prtraitement particulier.
Name : Saisissez le nom de la colonne modifier ou insrer.
SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes
dans les colonnes correspondantes.
Position : Slectionnez Before, Replace ou After, en fonction de l'action effectuer sur la
colonne de rfrence.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
NB_LINE_UPDATED : nombre de lignes mises jour. Cette variable est une variable After et retourne un
entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et retourne un entier.
NB_LINE_DELETED : nombre de lignes supprimes. Cette variable est une variable After et retourne un
entier.
NB_LINE_REJECTED : nombre de lignes rejetes. Cette variable est une variable After et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable After et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable est
une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case Die
on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant doit absolument tre reli un composant d'entre (Input). Il permet de faire des actions sur
une table ou les donnes d'une table d'une base de donnes SQLite. Il permet aussi de crer un flux de rejet
avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple d'utilisation, consultez Scnario 3 :
Rcuprer les donnes errones l'aide d'un lien Reject du composant tMysqlOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au composant tSQLiteOutput, consultez tSQLiteInput.
tSQLiteRollback
Proprits du tSQLiteRollback
Famille de composant Databases/SQLite
Fonction Le tSQLiteRollback annule la transaction dans une base de donnes connecte.
Objectif Ce composant vite le commit de transaction involontaire.
Basic settings Component list Slectionnez le composant de connexion tSQLiteConnection dans
la liste si vous prvoyez d'ajouter plus d'une connexion votre Job
en cours.
Close Connection Dcochez cette case pour continuer utiliser la connexion une fois
que le composant a excut sa tche.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une
variable de contexte afin de slectionner dynamiquement votre connexion la base de donnes
parmi celles prvues dans votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs
tables de bases de donnes ayant la mme structure mais se trouvant dans diffrentes bases de
donnes, en particulier lorsque vous travaillez dans un environnement dans lequel vous ne pouvez
pas changer les paramtres de votre Job, par exemple lorsque votre Job doit tre dploy et excut
dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche
dans la vue Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List
devient inaccessible dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez
le Guide utilisateur du Studio Talend.
Utilisation Ce composant est gnralement utilis en association avec des composants SQLite, notamment
avec le tSQLiteConnection et le tSQLiteCommit.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnario associ
Pour un scnario associ au tSQLiteRollback, consultez Scnario : Annuler l'insertion de donnes dans des tables
mre/fille du composant tMysqlRollback.
tSQLiteRow
Proprits du tSQLiteRow
Famille de Databases/SQLite
composant
Fonction Le tSQLiteRow excute une requte dfinie dans une base de donnes spcifie et utilise les paramtres de
la colonne.
Objectif Une requte prdfinie utilise le flux d'entre pour remplacer les paramtres substituables par les valeurs
dfinies pour chaque paramtre. Ce composant est trs utile quand il s'agit de faire des mises jour.
Basic settings Property type Peut tre Built-in ou Repository
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants
sont alors pr-remplis l'aide des donnes collectes.
Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement.
Voir galement le Guide utilisateur du Studio Talend.
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre
rutilis. Voir galement le Guide utilisateur du Studio Talend.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Saisissez manuellement votre requte ou construisez-la l'aide de
SQLBuilder.
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query
est renseign automatiquement.
Query Saisissez votre requte en faisant particulirement attention l'ordre des champs afin
qu'ils correspondent la dfinition du schma.
Die on error Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case
pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur.
Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un
lien Row > Rejects.
Advanced settings Propagate Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en
QUERY's recordset cours. Slectionnez cette colonne dans la liste use column.
Cette option est trs utile si vous devez effectuer de nombreuses fois la mme
requte. Elle permet un gain de performance.
Commit every Nombre de lignes avant le commit.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de caractres.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de
requtes SQL.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache : http://
logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Dans l'onglet Basic settings du composant tFileInputDelimited, parcourez les dossiers et slectionnez le fichier
d'entre utiliser pour mettre jour les lignes dans la base de donnes.
Il n'y a ni en-tte (Header) ni pied de page (Footer). Le sparateur de lignes (Row separator) est un retour
chariot et le sparateur de champs (Field separator) un point-virgule.
Dans l'espace de modlisation graphique, double-cliquez sur le composant tSQLiteRow pour afficher sa vue
Component.
Dans l'onglet Basic settings du composant tSQLiteRow, renseignez le champ Database avec le chemin d'accs
au fichier mettre jour.
Saisissez la requte ou rcuprez-la partir du Repository. Dans le cas prsent, la colonne type_os a t mise
jour en fonction de la valeur id dfinie dans le flux entrant. La requte se prsente comme suit :
Dans l'onglet Advanced settings, cochez la case Use PreparedStatement pour afficher la table des paramtres
substituables.
Dans la table des paramtres d'entre, ajoutez autant de lignes qu'il y a de paramtres substituables. Dans cet
exemple, dfinissez type_os et id.
La table download de la base de donnes SQLite est ainsi mise jour avec le nouveau code type_os, selon le
fichier dlimit d'entre.
Scnario associ
Pour un scnario associ, consultez :
La famille DotNET comprend les connecteurs les plus frquemment utiliss pour communiquer avec des
objets .NET.
tDotNETInstantiate
Proprits du tDotNETInstantiate
Famille de composant DotNET
Fonction Le composant tDotNETInstantiate instancie un objet dans .NET pour une utilisation ultrieure.
Objectif Le tDotNETInstantiate invoque le constructeur d'un objet .NET pour un usage ultrieur.
Basic settings Dll to load Saisissez dans ce champ le chemin d'accs une bibliothque
DLL contenant la (les) classe(s) qui vous intresse(nt) ou saisissez
le nom de l'Assembly ou cliquez sur le bouton [...] afin de
parcourir votre systme jusqu'au rpertoire de votre bibliothque.
Par exemple, System.Data, Version=2.0.0.0, Culture=neutral,
PublicKeyToken=b77a5c561934e089 pour une Assembly OleDb.
Fully qualified class name(i.e. Renseignez ce champ en saisissant le chemin complet de la classe
ClassLibrary1.NameSpace2.Class1) (FQN).
Value(s) to pass to the constructor Cliquez sur le bouton [+] pour ajouter une ou plusieurs valeur(s)
passer au constructeur de l'objet. Ou, laissez vide ce tableau afin
d'appeler un constructeur par dfaut pour l'objet.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis en tant que composant de dbut dans un flux ou dans un sous-job indpendant.
Pour utiliser ce composant, vous devez d'abord installer les fichiers DLLs d'excution, par exemple janet-
win32.dll, sous Windows 32 bits et janet-win64.dll sous Windows 64 bits, dans le package redistribuable
Microsoft Visual C++, afin d'viter les erreurs telles que UnsatisfiedLinkError sur les DLL dpendants.
Assurez-vous que le DLL d'excution et tous les autres DLL dont dpend le DLL appeler sont entirement
installs et que leurs versions sont en adquation.
Les DLL d'excution requis peuvent tre installs dans le dossier System32 ou dans le dossier
bin du JRE utiliser.
Si vous devez exporter un Job utilisant ce composant pour l'excuter hors du Studio Talend, vous
devez spcifier le conteneur d'excution souhait en configurant l'argument -Djava.library.path.
Scnario associ
Pour un scnario associ, consultez Scnario : Utiliser .NET dans Talend du composant tDotNETRow.
tDotNETRow
Proprits du tDotNETRow
Famille de composant DotNET
Fonction Le composant tDotNETRow envoie des donnes partir de bibliothques et vers des bibliothques et des
classes dans .NET ou d'autres fichiers DLL personnaliss.
Objectif Le tDotNETRow vous permet de faciliter la transformation de donnes l'aide de classes .NET built-in
ou personnalises.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (Built-in), soit distant (Repository).
Output value target column Dans la liste, slectionnez une colonne de la lignes de sortie afin de
lui attribuer une valeur.
Advanced settings Create a new instance at each row Cochez cette case pour crer une nouvelle instance chaque ligne
qui passe dans le composant.
Method doesn't return a value Cochez cette case afin d'invoquer une mthode sans retourner de
valeur comme rsultat du traitement.
Returns an instance of a .NET Object Cochez cette case pour retourner une instance d'un objet .NET
comme rsultat d'une mthode invoque.
Store the returned value for later use Cochez cette case afin de stocker la valeur retourne d'une
mthode pour une utilisation ultrieure dans un autre composant
tDotNETRow.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation Ce composant est utilis pour communiquer avec des objets .NET.
Pour utiliser ce composant, vous devez d'abord installer les fichiers DLLs d'excution, par exemple janet-
win32.dll, sous Windows 32 bits et janet-win64.dll sous Windows 64 bits, dans le package redistribuable
Microsoft Visual C++, afin d'viter les erreurs telles que UnsatisfiedLinkError sur les DLL dpendants.
Assurez-vous que le DLL d'excution et tous les autres DLL dont dpend le DLL appeler sont entirement
installs et que leurs versions sont en adquation.
Les DLLs d'excution requis peuvent tre installs dans le dossier System32 ou dans le dossier
bin du JRE utiliser.
Si vous devez exporter un Job utilisant ce composant pour l'excuter hors du Studio Talend, vous
devez spcifier le conteneur d'excution souhait en configurant l'argument -Djava.library.path.
Prrequis
Avant de reproduire ce scnario, vous devez d'abord construire votre environnement d'excution.
using System;
using System.Collections.Generic;
using System.Text;
namespace Test1
{
public class Class1
{
string s = null;
public Class1(string s)
{
this.s = s;
}
}
}
Cette classe lit la valeur d'entre et ajoute le texte Return Value from Class1: devant cette valeur. La classe est
compile l'aide du dernier .NET.
Installez le fichier DLL d'excution partir du dernier .NET. Dans ce scnario, utilisez janet-win32.dll sous
Windows 32 bits et placez-le dans le dossier System32.
Configurer le tDotNETInstantiate
1. Double-cliquez sur le tDotNETInstantiate pour afficher sa vue Basic settings et dfinir ses proprits de
base.
2. Cliquez sur le bouton [...] ct du champ Dll to load et parcourez votre systme jusqu'au fichier dll charger.
Vous pouvez galement renseigner le champ avec une Assembly. Dans cet exemple, utilisez :
"C:/Program Files/ClassLibrary1/bin/Debug/ClassLibrary1.dll""
3. Dans le champ Fully qualified class name, saisissez un nom de classe valide utiliser. Dans cet exemple,
saisissez :
"Test1.Class1"
4. Cliquez sur le bouton [+] sous la table Value(s) to pass to the constructor afin d'ajouter une ligne pour la
valeur passer au constructeur.
"Hello world"
3. Cochez la case Use an existing instance et slectionnez tDotNETInstantiate_1 dans la liste Existing
instance to use.
4. Renseignez le champ Method Name avec le nom de la mthode utiliser. Dans cet exemple, utilisez
"getValue".
5. Cliquez sur le bouton [...] ct du champ Edit schema pour ajouter une colonne au schma.
Cliquez sur le bouton [+] afin d'ajouter une colonne au schma et cliquez sur OK pour sauvegarder les
modifications.
Configurer le tLogRow
1. Double-cliquez sur le tLogRow afin d'afficher sa vue Basic settings et dfinir ses proprits de base.
2. Cliquez sur le bouton Sync columns afin de rcuprer le schma dfini dans le composant prcdent.
Vous pouvez constater, dans les rsultats, que le texte Return Value from Class1 est ajout devant la valeur
rcupre Hello world.
La famille ELT regroupe les connecteurs de bases de donnes les plus courants, ainsi que des composants de
traitement, tous ddis au mode ELT dans lequel les SGBD cibles deviennent des outils de transformation.
Ce mode supporte les bases de donnes les plus courantes, comme Teradata, Oracle, Vertica, Netezza, Sybase, etc.
tAccessConnection
Le composant AccessConnection appartient deux familles diffrentes : Databases et ELT. Pour plus
d'informations, consultez tAccessConnection.
tAS400Connection
Le composant tAS400Connection appartient deux familles diffrentes diffrentes : Databases et ELT. Pour plus
d'informations, consultez tAS400Connection.
tCombinedSQLAggregate
Proprits du tCombinedSQLAggregate
Famille de composant ELT/CombinedSQL
Fonction Le composant tCombinedSQLAggregate collecte les valeurs de donnes d'une ou plusieurs
colonnes d'une table dans des buts statistiques. Ce composant excute en temps rel des
transformations de donnes dans le SGBD lui-mme.
Objectif Ce composant fournit un ensemble de matrices bases sur des valeurs ou sur des calculs.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (built-in) soit distant dans le Repository.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis en tant que composant intermdiaire avec d'autres composants de bases
de donnes, en particulier les composants de connexion et de commit.
instancie en partie les schmas d'une table de base de donnes (pour filtrer les colonnes),
filtre deux colonnes dans la mme table afin de ne garder que les donnes correspondant aux deux conditions
de filtre,
collecte les donnes des colonnes filtres, regroupes par valeur(s) spcifique(s) et crit les donnes agrges
dans une table cible de base de donnes.
Dposez les composants suivants de la Palette dans l'espace de modlisation graphique : tMysqlConnection,
tCombinedSQLInput, tCombinedSQLFilter, tCombinedSQLAggregate, tCombinedSQLOutput et
tMysqlCommit.
Dans l'espace de modlisation graphique, double-cliquez sur le composant tMysqlConnection pour afficher sa
vue Component et dfinir ses proprits de base.
Dans la vue Basic settings, configurez manuellement les informations de connexion la base de donnes
ou slectionnez Repository dans la liste Property Type si votre connexion la base de donnes a dj t
configure et stocke sous le nud Metadata de la vue Repository.
Pour plus d'informations concernant le stockage des mtadonnes dans le Repository, consultez le Guide
utilisateur du Studio Talend.
Dans l'espace de modlisation graphique, double-cliquez sur le composant tCombinedSQLInput pour afficher
sa vue Component et dfinir ses proprits de base.
Dans le champ Table, saisissez le nom de la table source puis cliquez sur le bouton [...] ct du champ Edit
schema afin de dfinir la structure des donnes.
Le schma dfini dans le composant tCombinedSQLInput peut tre diffrent de celui de la table source, puisque vous
pouvez instancier uniquement les colonnes souhaites de la table source. Le tCombinedSQLInput joue galement un rle
de filtre des colonnes.
Dans ce scnario, la table de la base de donnes source contient sept colonnes : id, first_name, last_name, city, state,
date_of_birth, ainsi que salary et le composant tCombinedSQLInput instancie uniquement les quatre colonnes
ncessaires l'agrgation : id, state, date_of_birth, et salary de la table source.
Dans l'espace de modlisation graphique, double-cliquez sur le composant tCombinedSQLFilter afin d'afficher
sa vue Component et dfinir ses proprits de base.
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent, ou configurez
manuellement le schma en slectionnant Built-in dans la liste Schema et en cliquant sur le bouton [...] ct
du champ Edit schema.
Lorsque vous dfinissez la structure des donnes du composant tCombinedSQLFilter, le nom des colonnes apparat
automatiquement dans la liste Input column dans le tableau Conditions.
Dans ce scnario, le composant tCombinedSQLFilter instancie quatre colonnes : id, state, date_of_birth,
et salary.
Dans le tableau Conditions, configurez les paramtres d'entre, les oprateurs et les valeurs attendues pour
extraire les enregistrements correspondant aux critres spcifis.
Dans ce scnario, le composant tCombinedSQLFilter filtre les colonnes state et date_of_birth dans la table source
afin d'extraire uniquement les employs ns aprs le 19 octobre 1960, habitant dans les Etats Utah, Ohio et Iowa.
Slectionnez And dans la liste Logical operator between conditions afin d'appliquer les deux conditions la
fois. Vous pouvez galement personnaliser les conditions en cochant la case Use custom SQL et en ditant les
conditions dans le champ de texte.
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent, ou configurez
manuellement le schma en slectionnant Built-in dans la liste Schema et en cliquant sur le bouton [...].
Le composant tCombinedSQLAggregate instancie quatre colonnes : id, state, date_of_birth, et salary, provenant
du composant prcdent.
Le tableau Group by vous permet de dfinir les ensembles de donnes traiter partir d'une colonne dfinie, State
dans cet exemple.
Dans le tableau Group by, cliquez sur le bouton [+] pour ajouter une ligne.
Dans la liste droulante Output column, slectionnez State. Cette colonne sera utilise pour stocker les donnes
filtres de la colonne State.
Le tableau Operations vous permet de configurer le type d'agrgation effectuer. La liste disponible
dans la colonne Output column dpend du schma que vous souhaitez crire en sortie (via le composant
tCombinedSQLOutput). Dans ce scnario, le but est de regrouper les employs selon l'Etat dans lequel il vivent,
de calculer le nombre d'employs par Etat, les salaires moyen/minimum/maximum ainsi que de retourner la date
de naissance de l'employ le plus g et de l'employ de plus jeune de chaque tat.
Dans le tableau Operations, cliquez sur le bouton [+] pour ajouter une ou plusieurs ligne(s) puis cliquez dans
la liste Output column afin de slectionner la colonne de sortie qui contiendra les donnes calcules.
Dans l'espace de modlisation graphique, double-cliquez sur le tCombinedSQLOutput afin d'afficher sa vue
Component et dfinir ses proprits de base.
Dans la liste Component List, slectionnez le composant de connexion correspondant si plus d'un composant
de connexion est utilis.
Dans le champ Table, saisissez le nom de la table cible qui stockera les rsultats agrgs.
Dans cet exemple, il n'est pas ncessaire de renseigner le champ Schema, puisque la base de donnes utilise est Oracle.
Cliquez sur le bouton [...] ct du champ Edit schema pour dfinir la structure des donnes de la table cible.
Dans l'espace de modlisation graphique, double-cliquez sur le tCombinedSQLCommit afin d'afficher sa vue
Component et dfinir ses proprits de base.
Dans la liste Component list, slectionnez le composant de connexion la base de donnes correspondant si
plusieurs ont t utiliss.
Des lignes sont insres dans une table compose de sept colonnes, empl_by_state, dans la base de donnes. La
table affiche, par Etat dfini, le nombre d'employs, les salaires moyen/minimum/maximum et retourne la date de
naissance de l'employ le plus g et de l'employ le plus jeune de chaque tat.
tCombinedSQLFilter
Proprits du tCombinedSQLFilter
Famille de composant ELT/CombinedSQL
Fonction Le composant tCombinedSQLFilter vous permet de modifier le schma de la table source via
le mapping des colonnes et de dfinir un filtre sur cette table. Ce composant peut donc filtrer des
colonnes et des lignes en mme temps. Il filtre en temps rel les donnes dans le SGBD lui-mme.
Objectif Ce composant permet de filtrer des donnes en rorganisant, supprimant ou ajoutant des colonnes
partir de la table source et de filtrer la source de donnes l'aide de conditions de filtre.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits et passs au composant suivant. Le schma
est soit local (built-in) soit distant dans le Repository.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de
sortie. Cette variable est une variable Flow et retourne un entier.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis en tant que composant intermdiaire avec d'autres composants de bases
de donnes, en particulier les composants de connexion et de commit.
Scnario associ
Pour un scnario associ, consultez Scnario : Filtrer et agrger les colonnes d'une table directement dans le
SGBD.
tCombinedSQLInput
Proprits du tCombinedSQLInput
Famille de composant ELT/CombinedSQL
Fonction Le composant tCombinedSQLInput extrait des champs d'une table de base de donnes partir
de son schma. Ce composant possde galement des fonctionnalits de filtre puisque son
schma peut tre diffrent de celui de la table de la base de donnes.
Objectif Le composant tCombinedSQLInput extrait des champ d'une table de base de donnes selon la
dfinition de son schma. Il passe ensuite la liste des champs au composant suivant via un lien
de type Combine. Le schma du tCombinedSQLInput peut tre diffrent de celui de la table
source de la base de donnes mais l'ordre des colonnes doit tre le mme.
Basic settings Table Saisissez le nom de la table source de la base de donnes.
Schema Saisissez le nom du schma de la table source.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis en tant que composant intermdiaire avec d'autres composants de bases
de donnes, en particulier les composants de connexion et de commit.
Scnario associ
Pour un scnario associ, consultez Scnario : Filtrer et agrger les colonnes d'une table directement dans le
SGBD.
tCombinedSQLOutput
Proprits du tCombinedSQLOutput
Famille de composant ELT/CombinedSQL
Fonction Le composant tCombinedSQLOutput insre des enregistrements dans une table de base de
donnes existante.
Objectif Le tCombinedSQLOutput insre des enregistrements du flux entrant dans une table de base
de donnes existante.
Basic settings Database Type Slectionnez le type de base de donnes.
Component list Slectionnez le composant de connexion la base de donnes
correspondant si plus d'un est utilis dans le Job.
Table Saisissez le nom de la table cible de la base de donnes.
Schema Saisissez le nom du schma de la table cible.
QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la
variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio
Talend.
Utilisation Ce composant est utilis en tant que composant intermdiaire avec d'autres composants de bases
de donnes, en particulier les composants de connexion et de commit.
Scnario associ
Pour un scnario associ, consultez Scnario : Filtrer et agrger les colonnes d'une table directement dans le
SGBD.
tDB2Connection
Le composant tDB2Connection appartient deux familles diffrentes : Databases et ELT. Pour plus
d'informations, consultez tDB2Connection.
tELTGreenplumInput
Proprits du tELTGreenplumInput
Les trois composants ELT Greenplum sont troitement lis en ce qui concernent leurs conditions d'utilisation.
Ces composants sont conus pour prendre en charge les schmas Greenplum DB afin de gnrer des commandes
Insert, dont des clauses, qui sont excuts dans la table de sortie dfinie.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation L'utilisation du composant tELTGreenplumOutput est troitement lie celle des composants
tELTGreenplumMap et tELTGreenplumInput. Notez que le lien de sortie (output) utiliser
avec ces deux composants doit respecter strictement la syntaxe du nom de la table.
Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les
informations du schma.
Scnarios associs
Pour des exemples d'utilisation du composant tELTGreenplumInput, consultez :
tELTGreenplumMap
Proprits du tELTGreenplumMap
Les trois composants ELT Greenplum sont troitement lis en ce qui concernent leurs conditions d'utilisation.
Ces composants sont conus pour prendre en charge les schmas Greenplum DB afin de gnrer des commandes
Insert, dont des clauses, qui sont excuts dans la table de sortie dfinie.
Famille de ELT/Map/
composant Greenplum
Fonction Le composant tELTGreenplumMap permet de construire votre commande SQL graphiquement en utilisant
la table fournie en entre.
Objectif Ce composant utilise les tables fournies en entre pour alimenter les paramtres dans la commande mise en
place. L'instruction peut inclure des joints internes ou externes qui peuvent tre implments entre des tables
ou entre une table et ses alias.
Basic settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Auto : par dfaut, les liens entre les schmas d'entre et de sortie et les paramtres du
service Web sont en forme de courbe.
Bezier curve : les liens entre les schmas et les paramtres du service Web sont en forme
de ligne.
Line : les liens entre les schmas et les paramtres du service Web sont en forme de
lignes droites. Cette option vous permettra d'optimiser les performances.
Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants
sont alors pr-remplis l'aide des donnes collectes.
Host Adresse IP du serveur de base de donnes.
Port Numro de port d'coute du serveur de la base.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation L'utilisation du composant tELTGreenplumMap est troitement lie celle des composants
tELTGreenplumInput et tELTGreenplumOutput. Notez que le lien de sortie (output) utiliser avec ces
deux composants doit respecter strictement la syntaxe du nom de la table.
Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations
du schma.
Pour ajouter une restriction l'aide d'une clause WHERE, cliquez sur le bouton Add filter row et slectionnez
Add a WHERE clause dans le menu qui s'ouvre.
Pour ajouter une restriction l'aide de GROUP BY, ORDER BY, etc., cliquez sur le bouton Add filter row et
slectionnez Add an other(GROUP...) clause dans le menu qui s'ouvre.
Veillez ce que les composants d'entre soient tous lis correctement au composant ELT Map pour garantir que
les inclusions, jointures et clauses fonctionnent.
Avant l'excution du Job, les trois tables employee_by_statecode, statecode et employee_by_state ressemblent
ceci :
4. Reliez le composant tGreenplumInput au tLogRow l'aide d'une connexion Row > Main.
Dans les champs Host et Port, saisissez les variables de contexte pour le serveur Greenplum.
Dans le champ Database, saisissez la variable de contexte pour la base de donnes Greenplum.
Dans les champs Username et Password, saisissez les variables de contexte pour les paramtres
d'authentification.
Pour plus d'informations sur les variables de contexte, consultez le Guide utilisateur du Studio Talend.
2. Double-cliquez sur employee+statecode pour ouvrir sa vue Basic settings dans l'onglet Component.
Dans le champ Default table name, saisissez le nom de la table source, nomme employee_by_statecode.
Cliquez sur le bouton [...] prs du champ Edit schema pour ouvrir l'diteur de schma.
Cliquez sur le bouton [+] pour ajouter trois colonnes et appelez-les id, name et statecode, avec pour type
respectivement INT4, VARCHAR, et INT4.
3. Double-cliquez sur le statecode pour ouvrir sa vue Basic settings dans l'onglet Component.
Dans le champ Default table name, saisissez le nom de la table, ici statecode.
4. Cliquez sur le bouton [...] prs du champ Edit schema pour ouvrir l'diteur de schma.
Cliquez sur le bouton [+] pour ajouter deux colonnes et appelez-les state et statecode, avec pour type
respectivement VARCHAR et INT4.
5. Cliquez le composant tELTGreenplumMap pour ouvrir sa vue Basic settings dans l'onglet Component.
6. Cliquez sur le bouton [...] prs du champ ELT Greenplum Map Editor pour ouvrir l'diteur de mapping.
7. Cliquez sur le bouton [+] en haut gauche pour ouvrir la fentre de slection de table.
Slectionnez les tables employee_by_statecode et statecode dans la liste et cliquez sur Ok.
8. Dans le coin en haut droite, cliquez sur le bouton [+] pour ajouter la table de sortie nomme
employee_by_state.
9. Double-cliquez sur le tELTGreenplumOutput pour ouvrir sa vue Basic settings dans l'onglet Component.
Dans le champ Default table name, saisissez le nom de la table de sortie, ici employee_by_state.
10. Cliquez sur le bouton [...] prs du champ Edit schema pour ouvrir l'diteur de schma.
Cliquez sur le bouton [+] pour ajouter trois colonnes et appelez-les respectivement id, name et state, avec
pour type respectivement INT4, VARCHAR, et VARCHAR .
Dposez la colonne statecode de la table employee_by_statecode dans la colonne du mme nom, dans la table
statecode, afin de chercher les enregistrements des deux tables ayant les mmes valeurs statecode.
Dposez les colonnes id et name de la table employee_by_statecode ainsi que la colonne statecode de la table
statecode dans les colonnes de mme nom dans la table de sortie employee_by_state.
12. Double-cliquez sur le tGreenplumInput pour ouvrir sa vue Basic settings dans l'onglet Component.
Dans le champ Table name, saisissez le nom de la table source, appele employee_by_state.
13. Double-cliquez sur le composant tLogRow pour ouvrir sa vue Basic settings dans l'onglet Component.
Dans la zone Mode, slectionnez l'option Table (print values in cells of a table) pour une meilleure lisibilit.
Excuter le Job
1. Appuyez sur Ctrl+S pour sauvegarder votre Job.
Comme affich ci-dessus, les donnes sur les employs ont t crites dans la table employee_by_state, qui
prsente des informations gographiques concernant les employs.
Scnario associ
Pour des scnarios associs, consultez les scnarios :
Pour un scnario expliquant les sous-requtes, consultez Scnario : Mapper des donnes l'aide d'une sous-
requte.
tELTGreenplumOutput
Proprits du tELTGreenplumOutput
Les trois composants ELT Greenplum sont troitement lis en ce qui concernent leurs conditions d'utilisation.
Ces composants sont conus pour prendre en charge les schmas Greenplum DB afin de gnrer des commandes
Insert, dont des clauses, qui sont excuts dans la table de sortie dfinie.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie.
Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et
retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation L'utilisation du composant tELTGreenplumOutput est troitement lie celle des composants
tELTGreenplumMap et tELTGreenplumInput. Notez que le lien de sortie (output) utiliser
avec ces deux composants doit respecter strictement la syntaxe du nom de la table.
Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les
informations du schma.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour des exemples d'utilisation du composant tELTGreenplumOutput, consultez :
tELTJDBCInput
Proprits du tELTJDBCInput
Les composants tELTJDBCInput, tELTJDBCOutput, et tELTJDBCMap sont trs proches dans leurs
conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes
d'une base JDBC afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans
la table de sortie dfinie.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les
informations du schma.
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTJDBCInput, consultez les scnarios suivants du
composant tELTMysqlMap :
tELTJDBCMap
Proprits du tELTJDBCMap
Les composants tELTJDBClInput, tELTJDBCOutput, et tELTJDBCMap sont trs proches dans leurs
conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes
d'une base JDBC afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans
la table de sortie dfinie.
Famille de ELT/Map/JDBC
composant
Fonction Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre.
Objectif Utilise les tables fournies en entre pour alimenter les paramtres ncessaires l'excution de la commande
SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou
entre une table et ses alias.
Basic settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la
connection liste Component list pour rutiliser les paramtres d'une connexion que vous avez dj
dfinie.
Auto : par dfaut, les liens entre les schmas d'entre et de sortie et les paramtres du
service Web sont en forme de courbe.
Bezier curve : les liens entre les schmas et les paramtres du service Web sont en
forme de ligne.
Line : les liens entre les schmas et les paramtres du service Web sont en forme de
lignes droites. Cette option vous permettra d'optimiser les performances.
Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants
sont alors pr-remplis l'aide des donnes collectes.
Host Adresse IP du serveur de base de donnes.
Port Numro de port d'coute du serveur de la base.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation L'utilisation du composant tELTJDBCMap est troitement lie celle des composants tELTJDBCInput et
tELTJDBCOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter
strictement la syntaxe du nom de la table.
Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations
du schma.
Pour ajouter une restriction l'aide d'une clause WHERE, cliquez sur le bouton Add filter row et slectionnez
Add a WHERE clause dans le menu qui s'ouvre.
Pour ajouter une restriction l'aide de GROUP BY, ORDER BY, etc., cliquez sur le bouton Add filter row et
slectionnez Add an other(GROUP...) clause dans le menu qui s'ouvre.
Veillez ce que les composants d'entre soient tous lis correctement au composant ELT Map pour garantir que
les inclusions, jointures et clauses fonctionnent.
Scnarios associs
Pour des scnarios associs, consultez les scnarios suivants :
Pour un scnario expliquant les sous-requtes, consultez Scnario : Mapper des donnes l'aide d'une sous-
requte.
tELTJDBCOutput
Proprits du tELTJDBCOutput
Les composants tELTJDBCInput, tELTJDBCOutput, et tELTJDBCMap sont trs proches dans leurs
conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes
d'une base JDBC afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans
la table de sortie dfinie.
Use different table name Cochez cette case afin de dfinir le nom d'une table de sortie
diffrente, entre guillemets doubles, dans le champ Table name qui
apparat.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job
ainsi qu'au niveau du composant.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie.
Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et
retourne un entier.
ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette
variable est une variable After et retourne une chane de caractres. Cette variable fonctionne
uniquement si la case Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation L'utilisation du composant tELTJDBCOutput est troitement lie celle des composants
tELTJDBCInput et tELTJDBCMap. Notez que le lien de sortie (output) utiliser avec ces deux
composants doit respecter strictement la syntaxe du nom de la table.
Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les
informations du schma.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.
Pour plus d'informations sur les niveaux de logs du log4j, consultez la documentation d'Apache :
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html (en anglais).
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTJDBCOutput, consultez les scnarios suivants du
composant tELTJDBCMap :
tELTMSSqlInput
Proprits du tELTMSSqlInput
Les composants tELTMSSqlInput, tELTMSSqlOutput, et tELTMSSqlMap sont trs proches dans leurs
conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes
d'une base MSSql afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans
la table de sortie dfinie.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable
que vous souhaitez utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les
informations du schma.
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTMSSqlInput, consultez les scnarios suivants du
composant tELTMysqlMap dans :
tELTMSSqlMap
Proprits du tELTMSSqlMap
Les composants tELTMSSqlInput, tELTMSSqlOutput, et tELTMSSqlMap sont trs proches dans leurs
conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes
d'une base MSSql afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans
la table de sortie dfinie.
Famille de ELT/Map/MSSql
composant
Fonction Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre.
Objectif Utilise les tables fournies en entre pour alimenter les paramtres ncessaires l'excution de la commande
SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou
entre une table et ses alias.
Basic settings Use an existing Cochez cette case et slectionnez le composant de connexion adquat partir de la liste
connection Component list pour rutiliser les paramtres d'une connexion que vous avez dj dfinie.
Lorsqu'un Job contient un Job parent et un Job enfant, si vous souhaitez utiliser
une connexion existant entre les deux niveaux, par exemple pour partager la
connexion cre par le Job parent avec le Job enfant, vous devez :
Auto : par dfaut, les liens entre les schmas d'entre et de sortie et les paramtres du
service Web sont en forme de courbe.
Bezier curve : les liens entre les schmas et les paramtres du service Web sont en forme
de ligne.
Line : les liens entre les schmas et les paramtres du service Web sont en forme de lignes
droites. Cette option vous permettra d'optimiser les performances.
Property type Peut tre Built-in ou Repository.
Depuis la version 5.6, les modes Built-in et Repository sont disponibles dans n'importe
quelle solution de Talend.
Built-in : Proprits utilises ponctuellement.
Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont
alors pr-remplis l'aide des donnes collectes.
Host Adresse IP du serveur de base de donnes.
Port Numro de port d'coute du serveur de la base.
Database Nom de la base de donnes.
Username et Donnes d'authentification de l'utilisateur de la base.
Password
Pour saisir le mot de passe, cliquez sur le bouton [...] ct du champ Password, puis,
dans la bote de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles,
puis cliquez sur OK afin de sauvegarder les paramtres.
Advanced settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette
parameters option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans
les Basic settings.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du Job ainsi qu'au niveau
Statistics du composant.
Dynamic settings Cliquez sur le bouton [+] pour ajouter une ligne la table. Dans le champ Code, saisissez une variable de
contexte afin de slectionner dynamiquement votre connexion la base de donnes parmi celles prvues dans
votre Job. Cette fonctionnalit est utile si vous devez accder plusieurs tables de bases de donnes ayant la
mme structure mais se trouvant dans diffrentes bases de donnes, en particulier lorsque vous travaillez dans
un environnement dans lequel vous ne pouvez pas changer les paramtres de votre Job, par exemple lorsque
votre Job doit tre dploy et excut dans un Studio Talend indpendant.
La table Dynamic settings n'est disponible que si la case Use an existing connection est coche dans la vue
Basic settings. Lorsqu'un paramtre dynamique est configur, la liste Component List devient inaccessible
dans la vue Basic settings.
Pour plus d'informations concernant les Dynamic settings et les variables de contexte, consultez le Guide
utilisateur du Studio Talend.
Global Variables ERROR_MESSAGE : message d'erreur gnr par le composant lorsqu'une erreur survient. Cette variable
est une variable After et retourne une chane de caractres. Cette variable fonctionne uniquement si la case
Die on error est dcoche, si le composant a cette option.
Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.
Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez choisir la variable que vous souhaitez
utiliser.
Pour plus d'informations concernant les variables, consultez le Guide utilisateur du Studio Talend.
Utilisation L'utilisation du composant tELTMSSqlMap est troitement lie celle des composants tELTMSSqlInput
et tELTMSSqlOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter
strictement la syntaxe du nom de la table.
Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations
du schma.
Pour ajouter une restriction l'aide d'une clause WHERE, cliquez sur le bouton Add filter row et slectionnez
Add a WHERE clause dans le menu qui s'ouvre.
Pour ajouter une restriction l'aide de GROUP BY, ORDER BY, etc., cliquez sur le bouton Add filter row et
slectionnez Add an other(GROUP...) clause dans le menu qui s'ouvre.
Veillez ce que les composants d'entre soient tous lis correctement au composant ELT Map pour garantir que
les inclusions, jointures et clauses fonctionnent.
Scnarios associs
Pour des scnarios associs, consultez les scnarios suivants :
Pour un scnario expliquant les sous-requtes, consultez Scnario : Mapper des donnes l'aide d'une sous-
requte.
tELTMSSqlOutput
Proprits du tELTMSSqlOutput
Les composants tELTMSSqlInput, tELTMSSqlOutput, et tELTMSSqlMap sont trs proches dans leurs
conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes
d'une base MSSql afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans
la table de sortie dfinie.
Use different table name Cochez cette case afin de dfinir le nom d'une table de sortie
diffrente, entre guillemets doubles, dans le champ Table name qui
apparat.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables NB_LINE : nombre de lignes lues par un composant d'entre ou passes un composant de sortie.
Cette variable est une variable After et retourne un entier.
NB_LINE_INSERTED : nombre de lignes insres. Cette variable est une variable After et
retourne un entier.