Вы находитесь на странице: 1из 2672

Composants

Talend Open Studio


Guide de rfrence

5.6.2
Composants Talend Open Studio

Convient la version 5.6.2. Annule et remplace toute version antrieure de ce guide.

Date de publication : 12 mai 2015

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

Guide de rfrence des Composants de Talend Open Studio


Composants Talend Open Studio

Scnario : Utiliser un service Web Scnario 2 : Lire les donnes des


Sage X3 pour insrer des donnes diffrents schmas de la fonction
dans un systme Sage X3 donn . . . . . . . . 148 RFC_READ_TABLE . . . . . . . . . . . . . . . . . . . 237
tSalesforceBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 Scnario 3 : Rcuprer les donnes
Proprits du tSalesforceBulkExec . . . . . 152 d'un systme SAP . . . . . . . . . . . . . . . . . . . . . . . 242
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 154 tSAPOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
tSalesforceConnection . . . . . . . . . . . . . . . . . . . . . . . . . 155 Proprits du tSAPOutput . . . . . . . . . . . . . . 247
Proprits du tSalesforceConnection . . . 155 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 249
Scnario : Utiliser OAuth2 pour vous tSAPRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
connecter Salesforce.com . . . . . . . . . . . . . 157 Proprits du tSAPRollback . . . . . . . . . . . . 250
tSalesforceGetDeleted . . . . . . . . . . . . . . . . . . . . . . . . . 162 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 250
Proprits du tSalesforceGetDeleted . . . . 162 tSugarCRMInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Scnario : Rcuprer les donnes Proprits du tSugarCRMInput . . . . . . . . . 251
supprimes du serveur Salesforce . . . . . . . 164 Scnario: Extraire les donnes d'un
tSalesforceGetServerTimestamp . . . . . . . . . . . . . 167 compte partir de SugarCRM . . . . . . . . . . 252
Proprits du tSugarCRMOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
tSalesforceGetServerTimestamp . . . . . . . . 167 Proprits du tSugarCRMOutput . . . . . . . 254
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 169 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 255
tSalesforceGetUpdated . . . . . . . . . . . . . . . . . . . . . . . . 170 tVtigerCRMInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Proprits du tSalesforceGetUpdated . . . 170 Proprits du tVtigerCRMInput . . . . . . . . 256
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 172 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 257
tSalesforceInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 tVtigerCRMOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
Proprits du tSalesforceInput . . . . . . . . . . 173 Proprits du tVtigerCRMOutput . . . . . . . 258
Scnario : Utiliser des requtes pour Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 259
extraire des donnes d'une base de Composants Business Intelligence ......... 261
donnes Salesforce . . . . . . . . . . . . . . . . . . . . . . 176 tBarChart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
tSalesforceOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 Proprits du tBarChart . . . . . . . . . . . . . . . . . 262
Proprits du tSalesforceOutput . . . . . . . . 180 Scnario : Crer un diagramme en
Scnario 1 : Supprimer des donnes barres partir de donnes d'entre . . . . . . 263
de l'objet Account . . . . . . . . . . . . . . . . . . . . . . . 183 tDB2SCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Scnario 2 : Rassembler des donnes Proprits du tDB2SCD . . . . . . . . . . . . . . . . 270
en erreur tout en insrant des Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 272
donnes dans un module sur tDB2SCDELT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Salesforce.com . . . . . . . . . . . . . . . . . . . . . . . . . . 185 Proprits du tDB2SCDELT . . . . . . . . . . . . 273
Scnario 3 : Insrer des ID d'un Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 275
fichier Excel vers le Module Contact . . . 188 tGreenplumSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Scnario 4 : Effectuer un upsert du Proprits du tGreenplumSCD . . . . . . . . . . 276
module Contact selon les relations de Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 278
mapping avec les ID externes dans le tInformixSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
module Account . . . . . . . . . . . . . . . . . . . . . . . . 192 Proprits du tInformixSCD . . . . . . . . . . . . 279
tSalesforceOutputBulk . . . . . . . . . . . . . . . . . . . . . . . . 200 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 281
Proprits du tSalesforceOutputBulk . . . 200 tIngresSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
Scnario : Insrer des donnes de Proprits du tIngresSCD . . . . . . . . . . . . . . . 282
masse transformes dans votre Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 283
Salesforce.com . . . . . . . . . . . . . . . . . . . . . . . . . . 202 tJasperOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
tSalesforceOutputBulkExec . . . . . . . . . . . . . . . . . . . 207 Proprits du tJasperOutput . . . . . . . . . . . . . 284
Proprits du Scnario : Gnrer un rapport avec
tSalesforceOutputBulkExec . . . . . . . . . . . . . 207 un modle .jrxml . . . . . . . . . . . . . . . . . . . . . . . . 285
Scnario : Insrer des donnes de tJasperOutputExec . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
masse dans votre Salesforce.com . . . . . . . 210 Proprits du tJasperOutputExec . . . . . . . 288
tSalesforceWaveBulkExec . . . . . . . . . . . . . . . . . . . . 214 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 289
Proprits du tLineChart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
tSalesforceWaveBulkExec . . . . . . . . . . . . . . 214 Proprits du tLineChart . . . . . . . . . . . . . . . . 290
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 216 Scnario : Crer un graphique en
tSalesforceWaveOutputBulkExec . . . . . . . . . . . . 217 lignes afin de faciliter l'analyse des
Proprits du tendances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
tSalesforceWaveOutputBulkExec . . . . . . 217 tMondrianInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 219 Proprits du tMondrianInput . . . . . . . . . . . 299
tSAPBWInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 Scnario : Tables en jointure croise . . . 300
Proprits du tSAPBWInput . . . . . . . . . . . . 220 tMSSqlSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Scnario : Lire des donnes d'une Proprits du tMSSqlSCD . . . . . . . . . . . . . . 304
base de donnes SAP BW . . . . . . . . . . . . . . 221 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 306
tSAPCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225 tMysqlSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
Proprits du tSAPCommit . . . . . . . . . . . . . 225 Proprits du tMysqlSCD . . . . . . . . . . . . . . . 307
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 225 Scnario : Traquer des modifications
tSAPConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 avec les Slowly Changing
Proprits du tSAPConnection . . . . . . . . . . 226 Dimensions de type 0 3 . . . . . . . . . . . . . . . 311
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 227 tMysqlSCDELT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
tSAPInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 Proprits du tMysqlSCDELT . . . . . . . . . . 319
Proprits du tSAPInput . . . . . . . . . . . . . . . . 228 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 321
Scnario 1 : Rcuprer les tNetezzaSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
mtadonnes d'un systme SAP . . . . . . . . 230 Proprits du tNetezzaSCD . . . . . . . . . . . . . 322

iv Guide de rfrence des Composants de Talend Open Studio


Composants Talend Open Studio

Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 324 Dcouvrir le schma de sortie en


tOracleSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 lecture seule du tPaloRuleList . . . . . . . . . . 389
Proprits du tOracleSCD . . . . . . . . . . . . . . 325 Scnario : Rcuprer des
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 327 informations dtailles concernant
tOracleSCDELT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 des rgles d'un cube donn . . . . . . . . . . . . . 389
Proprits du tOracleSCDELT . . . . . . . . . . 328 tParAccelSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 330 Proprits du tParAccelSCD . . . . . . . . . . . . 391
tPaloCheckElements . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 393
Proprits du tPaloCheckElements . . . . . 331 tPostgresPlusSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 333 Proprits du tPostgresPlusSCD . . . . . . . . 394
tPaloClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 396
Proprits du tPaloClose . . . . . . . . . . . . . . . . 334 tPostgresPlusSCDELT . . . . . . . . . . . . . . . . . . . . . . . . 397
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 334 Proprits du tPostgresPlusSCDELT . . . 397
tPaloConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 399
Proprits du tPaloConnection . . . . . . . . . . 335 tPostgresqlSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 336 Proprits du tPostgresqlSCD . . . . . . . . . . 400
tPaloCube . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 402
Proprits du tPaloCube . . . . . . . . . . . . . . . . 337 tPostgresqlSCDELT . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
Scnario : Crer un cube dans une Proprits du tPostgresqlSCDELT . . . . . . 403
base de donnes existante . . . . . . . . . . . . . . . 338 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 405
tPaloCubeList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341 tSPSSInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
Proprits du tPaloCubeList . . . . . . . . . . . . 341 Proprits du tSPSSInput . . . . . . . . . . . . . . . 406
Dcouvrir le schma de sortie en Scnario : Afficher le contenu d'un
lecture seule du tPaloCubeList . . . . . . . . . . 342 fichier SPSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
Scnario : Rcuprer des tSPSSOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
informations dtailles d'un cube Proprits du tSPSSOutput . . . . . . . . . . . . . 410
d'une base de donnes dtermine . . . . . . 343 Scnario : Ecrire des donnes dans
tPaloDatabase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 un fichier .sav . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
Proprits du tPaloDatabase . . . . . . . . . . . . 345 tSPSSProperties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
Scnario : Crer une base de Proprits du tSPSSProperties . . . . . . . . . . 414
donnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 415
tPaloDatabaseList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348 tSPSSStructure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
Proprits du tPaloDatabaseList . . . . . . . . 348 Proprits du tSPSSStructure . . . . . . . . . . . 416
Dcouvrir le schma de sortie en Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 417
lecture seule du tPaloDatabaseList . . . . . . 349 tSybaseSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
Scnario : Rcuprer des Proprits du tSybaseSCD . . . . . . . . . . . . . . 418
informations dtailles concernant Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 420
les bases de donnes d'un serveur tSybaseSCDELT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
Palo donn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 Proprits du tSybaseSCDELT . . . . . . . . . 421
tPaloDimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 423
Proprits du tPaloDimension . . . . . . . . . . 352 tVerticaSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
Scnario : Crer une dimension avec Proprits du tVerticaSCD . . . . . . . . . . . . . . 424
des lments . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 Conseils et techniques . . . . . . . . . . . . . . . . . . 426
tPaloDimensionList . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 426
Proprits du tPaloDimensionList . . . . . . 361 Composants Cloud .............................. 427
Dcouvrir le schma de sortie en tAmazonAuroraClose . . . . . . . . . . . . . . . . . . . . . . . . . 428
lecture seule du tPaloDimensionList . . . . 363 Proprits du tAmazonAuroraClose . . . . 428
Scnario: Rcuprer des Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 428
informations dtailles concernant tAmazonAuroraCommit . . . . . . . . . . . . . . . . . . . . . . 430
les dimensions d'une base de donnes Proprits du
dtermine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 tAmazonAuroraCommit . . . . . . . . . . . . . . . . 430
tPaloInputMulti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 431
Proprits du tPaloInputMulti . . . . . . . . . . 366 tAmazonAuroraConnection . . . . . . . . . . . . . . . . . . . 432
Scnario : Rcuprer des lments de Proprits du
dimensions dans un cube donn . . . . . . . . 368 tAmazonAuroraConnection . . . . . . . . . . . . . 432
tPaloOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 433
Proprits du tPaloOutput . . . . . . . . . . . . . . 372 tAmazonAuroraInput . . . . . . . . . . . . . . . . . . . . . . . . . 434
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 373 Proprits du tAmazonAuroraInput . . . . . 434
tPaloOutputMulti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 436
Proprits du tPaloOutputMulti . . . . . . . . . 374 tAmazonAuroraOutput . . . . . . . . . . . . . . . . . . . . . . . 437
Scnario 1 : Ecrire des donnes dans Proprits du tAmazonAuroraOutput . . . 437
un cube donn . . . . . . . . . . . . . . . . . . . . . . . . . . 376 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 441
Scnario 2 : Refuser un flux de tAmazonAuroraRollback . . . . . . . . . . . . . . . . . . . . . 442
donnes d'entre lorsque les lments Proprits du
crire n'existent pas dans un cube tAmazonAuroraRollback . . . . . . . . . . . . . . . 442
donn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 442
tPaloRule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 tAmazonMysqlClose . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
Proprits du tPaloRule . . . . . . . . . . . . . . . . . 383 Proprits du tAmazonMysqlClose . . . . . 444
Scnario : Crer une rgle dans un Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 444
cube donn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384 tAmazonMysqlCommit . . . . . . . . . . . . . . . . . . . . . . . . 445
tPaloRuleList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387 Proprits du
Proprits du tPaloRuleList . . . . . . . . . . . . . 387 tAmazonMysqlCommit . . . . . . . . . . . . . . . . . 445

Guide de rfrence des Composants de Talend Open Studio v


Composants Talend Open Studio

Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 446 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 496


tAmazonMysqlConnection . . . . . . . . . . . . . . . . . . . . 447 tDropboxGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
Proprits du Proprits du tDropboxGet . . . . . . . . . . . . . 497
tAmazonMysqlConnection . . . . . . . . . . . . . 447 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 498
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 448 tDropboxList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
tAmazonMysqlInput . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 Proprits du tDropboxList . . . . . . . . . . . . . 499
Proprits du tAmazonMysqlInput . . . . . 449 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 500
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 451 tDropboxPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
tAmazonMysqlOutput . . . . . . . . . . . . . . . . . . . . . . . . . 452 Proprits du tDropboxPut . . . . . . . . . . . . . . 501
Proprits du tAmazonMysqlOutput . . . . 452 Scnario : Tlcharger des fichiers
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 455 dans Dropbox . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
tAmazonMysqlRollback . . . . . . . . . . . . . . . . . . . . . . . 456 tGoogleDriveConnection . . . . . . . . . . . . . . . . . . . . . . 508
Proprits du Proprits du
tAmazonMysqlRollback . . . . . . . . . . . . . . . . 456 tGoogleDriveConnection . . . . . . . . . . . . . . . 508
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 456 Obtenir un jeton d'accs Google
tAmazonMysqlRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457 Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
Proprits du tAmazonMysqlRow . . . . . . 457 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 514
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 459 tGoogleDriveCopy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
tAmazonOracleClose . . . . . . . . . . . . . . . . . . . . . . . . . . 460 Proprits du tGoogleDriveCopy . . . . . . . 515
Proprits du tAmazonOracleClose . . . . . 460 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 516
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 460 tGoogleDriveCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
tAmazonOracleCommit . . . . . . . . . . . . . . . . . . . . . . . 461 Proprits du tGoogleDriveCreate . . . . . . 517
Proprits du Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 518
tAmazonOracleCommit . . . . . . . . . . . . . . . . . 461 tGoogleDriveDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 462 Proprits du tGoogleDriveDelete . . . . . . 519
tAmazonOracleConnection . . . . . . . . . . . . . . . . . . . 463 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 520
Proprits du tGoogleDriveGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521
tAmazonOracleConnection . . . . . . . . . . . . . 463 Proprits du tGoogleDriveGet . . . . . . . . . 521
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 464 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 522
tAmazonOracleInput . . . . . . . . . . . . . . . . . . . . . . . . . . 465 tGoogleDriveList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
Proprits du tAmazonOracleInput . . . . . 465 Proprits du tGoogleDriveList . . . . . . . . . 523
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 467 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 524
tAmazonOracleOutput . . . . . . . . . . . . . . . . . . . . . . . . 468 tGoogleDrivePut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
Proprits du tAmazonOracleOutput . . . 468 Proprits du tGoogleDrivePut . . . . . . . . . 525
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 471 Gestion des fichiers avec Google
tAmazonOracleRollback . . . . . . . . . . . . . . . . . . . . . . 472 Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
Proprits du tGSBucketCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
tAmazonOracleRollback . . . . . . . . . . . . . . . . 472 tGSBucketDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 472 tGSBucketExist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
tAmazonOracleRow . . . . . . . . . . . . . . . . . . . . . . . . . . . 473 tGSBucketList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
Proprits du tAmazonOracleRow . . . . . . 473 tGSClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 475 tGSConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540
tBoxConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476 tGSCopy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
Proprits du tBoxConnection . . . . . . . . . . 476 tGSDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 477 tGSGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543
tBoxCopy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478 tGSList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
Proprits du tBoxCopy . . . . . . . . . . . . . . . . 478 tGSPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 479 tMarketoInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546
tBoxDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480 tMarketoListOperation . . . . . . . . . . . . . . . . . . . . . . . 547
Proprits du tBoxDelete . . . . . . . . . . . . . . . 480 tMarketoOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 481 tNetsuiteInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549
tBoxGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 tNetsuiteOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
Proprits du tBoxGet . . . . . . . . . . . . . . . . . . 482 tS3BucketCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 483 Proprits du tS3BucketCreate . . . . . . . . . 551
tBoxList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 552
Proprits du tBoxList . . . . . . . . . . . . . . . . . . 484 tS3BucketDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 485 tS3BucketDelete properties . . . . . . . . . . . . . 553
tBoxPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 554
Proprits du tBoxPut . . . . . . . . . . . . . . . . . . . 486 tS3BucketExist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
Scnario : Charger et tlcharger des Proprits du tS3BucketExist . . . . . . . . . . . 555
fichiers depuis Box . . . . . . . . . . . . . . . . . . . . . 487 Scnario : Vrifier l'absence d'un
tCloudStart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491 bucket, le crer et lister tous les
Proprits du tCloudStart . . . . . . . . . . . . . . . 491 buckets S3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 492 tS3BucketList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
tCloudStop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493 Proprits du tS3BucketList . . . . . . . . . . . . 561
Proprits du tCloudStop . . . . . . . . . . . . . . . 493 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 562
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 494 tS3Close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563
tDropboxConnection . . . . . . . . . . . . . . . . . . . . . . . . . . 495 Proprits du tS3Close . . . . . . . . . . . . . . . . . . 563
Proprits du tDropboxConnection . . . . . 495 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 564
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 495 tS3Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565
tDropboxDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496 Proprits du tS3Connection . . . . . . . . . . . . 565
Proprits du tDropboxDelete . . . . . . . . . . 496 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 566

vi Guide de rfrence des Composants de Talend Open Studio


Composants Talend Open Studio

tS3Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567 tIntervalMatch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633


Proprits du tS3Delete . . . . . . . . . . . . . . . . . 567 Proprits du tIntervalMatch . . . . . . . . . . . . 633
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 568 Scnario : Identifier l'emplacement
tS3Get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569 de serveurs partir de leur IP . . . . . . . . . . . 634
Proprits du tS3Get . . . . . . . . . . . . . . . . . . . . 569 tReplaceList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 570 Proprits du tReplaceList . . . . . . . . . . . . . . 638
tS3List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571 Scnario : Remplacement partir
Proprits du tS3List . . . . . . . . . . . . . . . . . . . . 571 d'un fichier de rfrence . . . . . . . . . . . . . . . . 639
Scnario : Lister les fichiers d'un tSchemaComplianceCheck . . . . . . . . . . . . . . . . . . . . 643
bucket ayant le mme prfixe . . . . . . . . . . . 572 Proprits du
tS3Put . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577 tSchemaComplianceCheck . . . . . . . . . . . . . 643
Proprits du tS3Put . . . . . . . . . . . . . . . . . . . . 577 Scnario : Valider les dates en
Scnario : Echange de fichiers avec fonction d'un schma . . . . . . . . . . . . . . . . . . . 645
Amazon S3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578 tUniqRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649
tSalesforceBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . 581 Proprits du tUniqRow . . . . . . . . . . . . . . . . 649
tSalesforceConnection . . . . . . . . . . . . . . . . . . . . . . . . . 582 Scnario 1 : Ddoublonner des
tSalesforceGetDeleted . . . . . . . . . . . . . . . . . . . . . . . . . 583 donnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 650
tSalesforceGetServerTimestamp . . . . . . . . . . . . . 584 Scnario 2 : Ddoublonner des
tSalesforceGetUpdated . . . . . . . . . . . . . . . . . . . . . . . . 585 entres en utilisant des composants
tSalesforceInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586 Map/Reduce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
tSalesforceOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587 tUniservBTGeneric . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665
tSalesforceOutputBulk . . . . . . . . . . . . . . . . . . . . . . . . 588 Proprits du tUniservBTGeneric . . . . . . . 665
tSalesforceOutputBulkExec . . . . . . . . . . . . . . . . . . . 589 Scnario : Excution d'un processus
tSalesforceWaveBulkExec . . . . . . . . . . . . . . . . . . . . 590 dans DQ Batch Suite . . . . . . . . . . . . . . . . . . . . 667
tSalesforceWaveOutputBulkExec . . . . . . . . . . . . 591 tUniservRTConvertName . . . . . . . . . . . . . . . . . . . . . 671
tSugarCRMInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592 Proprits du
tSugarCRMOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593 tUniservRTConvertName . . . . . . . . . . . . . . . 671
Composants Custom Code ................... 595 Scnario : Analyse d'une ligne de
tGroovy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596 nom et attribution d'un titre . . . . . . . . . . . . . 672
Proprits du tGroovy . . . . . . . . . . . . . . . . . . 596 tUniservRTMailBulk . . . . . . . . . . . . . . . . . . . . . . . . . . 676
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 596 Proprits du tUniservRTMailBulk . . . . . 676
tGroovyFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597 Scnario : Crer un pool d'index . . . . . . . . 676
Proprits du tGroovyFile . . . . . . . . . . . . . . 597 tUniservRTMailOutput . . . . . . . . . . . . . . . . . . . . . . . 680
Scnario : Appeler du code Groovy Proprits du
contenu dans un fichier . . . . . . . . . . . . . . . . . 597 tUniservRTMailOutput . . . . . . . . . . . . . . . . . 680
tJava . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 681
Proprits du tJava . . . . . . . . . . . . . . . . . . . . . . 599 tUniservRTMailSearch . . . . . . . . . . . . . . . . . . . . . . . . 682
Scnario : Imprimer le contenu d'une Proprits du tUniservRTMailSearch . . . 682
variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599 Scnario : Ajouter des contacts au
tJavaFlex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603 pool d'index de mailRetrieval . . . . . . . . . . . 683
Proprits du tJavaFlex . . . . . . . . . . . . . . . . . 603 tUniservRTPost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688
Scnario 1 : Gnrer un flux de Proprits du tUniservRTPost . . . . . . . . . . 688
donnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604 Scnario 1 : Vrifier et corriger le
Scnario 2 : Traiter des lignes de code postal, la ville et la rue . . . . . . . . . . . . 689
donnes avec le tJavaFlex . . . . . . . . . . . . . . 607 Scnario 2 : Vrifier et corriger le
tJavaRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610 code postal, la ville et la rue, tout en
Proprits du tJavaRow . . . . . . . . . . . . . . . . . 610 rejetant les donnes incorrectes . . . . . . . . . 693
Scnario : Transformer des donnes Databases - Composants
ligne par ligne avec un tJavaRow . . . . . . . 611 traditionnels ....................................... 695
tLibraryLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615 tAccessBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696
Proprits du tLibraryLoad . . . . . . . . . . . . . 615 Proprits du tAccessBulkExec . . . . . . . . . 696
Scnario : Vrifier le format d'une Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 698
adresse e-mail . . . . . . . . . . . . . . . . . . . . . . . . . . . 616 tAccessClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699
tSetGlobalVar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618 Proprits du tAccessClose . . . . . . . . . . . . . 699
Proprits du tSetGlobalVar . . . . . . . . . . . . 618 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 699
Scnario : Afficher le contenu d'une tAccessCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700
variable globale . . . . . . . . . . . . . . . . . . . . . . . . . 618 Proprits du tAccessCommit . . . . . . . . . . 700
Composants Data Quality .................... 621 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 700
tAddCRCRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622 tAccessConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701
Proprits du tAddCRCRow . . . . . . . . . . . . 622 Proprits du tAccessConnection . . . . . . . 701
Scnario : Ajouter une cl de Scnario: Insrer des donnes dans
substitution un fichier . . . . . . . . . . . . . . . . . 623 des tables parent/enfant . . . . . . . . . . . . . . . . . 702
tChangeFileEncoding . . . . . . . . . . . . . . . . . . . . . . . . . . 625 tAccessInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706
tExtractRegexFields . . . . . . . . . . . . . . . . . . . . . . . . . . . 626 Proprits du tAccessInput . . . . . . . . . . . . . 706
tFuzzyMatch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 708
Proprits du tFuzzyMatch . . . . . . . . . . . . . 627 tAccessOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 709
Scnario 1 : Distance de Levenshtein Proprits du tAccessOutput . . . . . . . . . . . . 709
de 0 pour les prnoms . . . . . . . . . . . . . . . . . . 628 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 712
Scnario 2 : Distance de Levenshtein tAccessOutputBulk . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713
de 1 ou 2 pour les prnoms . . . . . . . . . . . . . 631 Proprits du tAccessOutputBulk . . . . . . . 713
Scnario 3 : Distance mtaphonique Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 714
pour les prnoms . . . . . . . . . . . . . . . . . . . . . . . . 632 tAccessOutputBulkExec . . . . . . . . . . . . . . . . . . . . . . . 715

Guide de rfrence des Composants de Talend Open Studio vii


Composants Talend Open Studio

Proprits du Proprits du tInformixConnection . . . . . 768


tAccessOutputBulkExec . . . . . . . . . . . . . . . . 715 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 769
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 717 tInformixInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 770
tAccessRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718 Proprits du tInformixInput . . . . . . . . . . . . 770
Proprits du tAccessRollback . . . . . . . . . . 718 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 772
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 718 tInformixOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773
tAccessRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719 Proprits du tInformixOutput . . . . . . . . . . 773
Proprits du tAccessRow . . . . . . . . . . . . . . 719 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 776
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 721 tInformixOutputBulk . . . . . . . . . . . . . . . . . . . . . . . . . 777
tAS400Close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722 Proprits du tInformixOutputBulk . . . . . 777
Proprits du tAS400Close . . . . . . . . . . . . . 722 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 779
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 722 tInformixOutputBulkExec . . . . . . . . . . . . . . . . . . . . 780
tAS400Commit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723 Proprits du
Proprits du tAS400Commit . . . . . . . . . . . 723 tInformixOutputBulkExec . . . . . . . . . . . . . . 780
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 723 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 782
tAS400Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724 tInformixRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 783
Proprits du tAS400Connection . . . . . . . 724 Proprits du tInformixRollback . . . . . . . . 783
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 725 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 783
tAS400Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726 tInformixRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784
Proprits du tAS400Input . . . . . . . . . . . . . . 726 Proprits du tInformixRow . . . . . . . . . . . . 784
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 727 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 786
tAS400LastInsertId . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728 tInformixSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 787
Proprits du tAS400LastInsertId . . . . . . . 728 tInformixSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 788
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 729 Proprits du tInformixSP . . . . . . . . . . . . . . 788
tAS400Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 730 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 790
Proprits du tAS400Output . . . . . . . . . . . . 730 tMSSqlBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 732 Proprits du tMSSqlBulkExec . . . . . . . . . 791
tAS400Rollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 734 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 793
Proprits du tAS400Rollback . . . . . . . . . . 734 tMSSqlColumnList . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 734 Proprits du tMSSqlColumnList . . . . . . . 794
tAS400Row . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 795
Proprits du tAS400Row . . . . . . . . . . . . . . 735 tMSSqlClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 796
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 737 Proprits du tMSSqlClose . . . . . . . . . . . . . 796
tDB2BulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 796
Proprits du tDB2BulkExec . . . . . . . . . . . 738 tMSSqlCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 797
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 740 Proprits du tMSSqlCommit . . . . . . . . . . . 797
tDB2Close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 797
Proprits du tDB2Close . . . . . . . . . . . . . . . 741 tMSSqlConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 798
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 741 Proprits du tMSSqlConnection . . . . . . . 798
tDB2Commit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 742 Scnario : Insrer des donnes dans
Proprits du tDB2Commit . . . . . . . . . . . . . 742 une table de base de donnes et en
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 742 extraire des informations . . . . . . . . . . . . . . . 799
tDB2Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743 tMSSqlInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805
Proprits du tDB2Connection . . . . . . . . . 743 Proprits du tMSSqlInput . . . . . . . . . . . . . . 805
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 744 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 807
tDB2Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745 tMSSqlLastInsertId . . . . . . . . . . . . . . . . . . . . . . . . . . . 808
Proprits du tDB2Input . . . . . . . . . . . . . . . . 745 Proprits du tMSSqlLastInsertId . . . . . . . 808
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 747 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 809
tDB2Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748 tMSSqlOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 810
Proprits du tDB2Output . . . . . . . . . . . . . . 748 Proprits du tMSSqlOutput . . . . . . . . . . . . 810
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 751 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 814
tDB2Rollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752 tMSSqlOutputBulk . . . . . . . . . . . . . . . . . . . . . . . . . . . . 815
Proprits du tDB2Rollback . . . . . . . . . . . . 752 Proprits du tMSSqlOutputBulk . . . . . . . 815
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 752 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 816
tDB2Row . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753 tMSSqlOutputBulkExec . . . . . . . . . . . . . . . . . . . . . . . 817
Proprits du tDB2Row . . . . . . . . . . . . . . . . . 753 Proprits du
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 755 tMSSqlOutputBulkExec . . . . . . . . . . . . . . . . 817
tDB2SCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 756 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 819
tDB2SCDELT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757 tMSSqlRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 820
tDB2SP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758 Proprits du tMSSqlRollback . . . . . . . . . . 820
Proprits du tDB2SP . . . . . . . . . . . . . . . . . . . 758 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . . 820
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 760 tMSSqlRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 821
tInformixBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761 Proprits du tMSSqlRow . . . . . . . . . . . . . . 821
Proprits du tInformixBulkExec . . . . . . . 761 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 823
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 764 tMSSqlSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824
tInformixClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765 tMSSqlSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825
Proprits du tInformixClose . . . . . . . . . . . 765 Proprits du tMSSqlSP . . . . . . . . . . . . . . . . 825
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 765 Scnario : Rcuprer des
tInformixCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766 informations personnelles l'aide
Proprits du tInformixCommit . . . . . . . . . 766 d'une procdure stocke . . . . . . . . . . . . . . . . 827
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 767 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 831
tInformixConnection . . . . . . . . . . . . . . . . . . . . . . . . . . 768 tMSSqlTableList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 832

viii Guide de rfrence des Composants de Talend Open Studio


Composants Talend Open Studio

Proprits du tMSSqlTableList . . . . . . . . . 832 Proprits du tMysqlSP . . . . . . . . . . . . . . . . . 922


Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 833 Scnario : Trouver le libell State
tMysqlBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 834 l'aide d'une procdure stocke . . . . . . . . . . 923
Proprits du tMysqlBulkExec . . . . . . . . . 834 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 926
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 836 tMysqlTableList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 927
tMysqlClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 837 Proprits du tMysqlTableList . . . . . . . . . . 927
Proprits du tMysqlClose . . . . . . . . . . . . . . 837 Scnario : Effectuer une opration
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 837 d'itration sur des tables et en
tMysqlColumnList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 838 effacer le contenu grce un modle
Proprits du tMysqlColumnList . . . . . . . 838 SQL dfini par l'utilisateur (SQL
Scnario : Itrer une table de base de Template) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 928
donnes et lister le nom des colonnes Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 932
de la table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 839 tOleDbInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 933
tMysqlCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 842 Proprits du tOleDbInput . . . . . . . . . . . . . . 933
Proprits du tMysqlCommit . . . . . . . . . . . 842 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 934
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 843 tOleDbOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 935
tMysqlConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844 Proprits du tOleDbOutput . . . . . . . . . . . . 935
Proprits du tMysqlConnection . . . . . . . . 844 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 937
Scnario 1 : Insrer des donnes dans tOleDbRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 938
des tables mre/fille . . . . . . . . . . . . . . . . . . . . . 845 Proprits du tOleDbRow . . . . . . . . . . . . . . 938
Scnario 2 : Partager une connexion Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 939
de base de donnes entre un Job pre tOracleBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 940
et un Job fils . . . . . . . . . . . . . . . . . . . . . . . . . . . . 848 Proprits du tOracleBulkExec . . . . . . . . . 940
tMysqlInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 855 Scnario : Supprimer et insrer des
Proprits du tMysqlInput . . . . . . . . . . . . . . 855 donnes dans une base Oracle . . . . . . . . . . 943
Scnario 1 : Ecrire des colonnes tOracleClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 947
d'une base de donnes MySQL dans Proprits du tOracleClose . . . . . . . . . . . . . 947
un fichier de sortie . . . . . . . . . . . . . . . . . . . . . . 857 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 947
Scnario 2 : Utiliser des paramtres tOracleCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 948
de contexte lors de la lecture d'une Proprits du tOracleCommit . . . . . . . . . . . 948
table d'une base de donnes MySQL . . . 860 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 948
Scnario 3 : Lire des donnes dans tOracleConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 949
des bases de donnes MySQL l'aide Proprits du tOracleConnection . . . . . . . 949
de connexions dynamiques bases Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 950
sur les variables de contexte . . . . . . . . . . . . 863 tOracleInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 951
tMysqlLastInsertId . . . . . . . . . . . . . . . . . . . . . . . . . . . . 870 Proprits du tOracleInput . . . . . . . . . . . . . . 951
Proprits du tMysqlLastInsertId . . . . . . . 870 Scnario : Utiliser les paramtres de
Scnario : Rcuprer les ID des contexte lors de la lecture d'une table
dernires entres ajoutes . . . . . . . . . . . . . . . 871 d'une base de donnes Oracle . . . . . . . . . . . 953
tMysqlOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 876 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 957
Proprits du tMysqlOutput . . . . . . . . . . . . 876 tOracleOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 958
Scnario 1 : Ajouter une colonne et Proprits du tOracleOutput . . . . . . . . . . . . 958
modifier les donnes . . . . . . . . . . . . . . . . . . . . 879 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 962
Scnario 2 : Effectuer des mises tOracleOutputBulk . . . . . . . . . . . . . . . . . . . . . . . . . . . . 963
jour dans une base de donnes . . . . . . . . . . 884 Proprits du tOracleOutputBulk . . . . . . . 963
Scnario 3 : Rcuprer les donnes Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 964
errones l'aide d'un lien Reject . . . . . . . . 887 tOracleOutputBulkExec . . . . . . . . . . . . . . . . . . . . . . . 966
tMysqlOutputBulk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 893 Proprits du
Proprits du tMysqlOutputBulk . . . . . . . 893 tOracleOutputBulkExec . . . . . . . . . . . . . . . . . 966
Scnario : Insrer des donnes Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 969
transformes dans une base MySQL . . . . 894 tOracleRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 970
tMysqlOutputBulkExec . . . . . . . . . . . . . . . . . . . . . . . 899 Proprits du tOracleRollback . . . . . . . . . . 970
Proprits du Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 970
tMysqlOutputBulkExec . . . . . . . . . . . . . . . . . 899 tOracleRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 971
Scnario : Insrer des donnes dans Proprits du tOracleRow . . . . . . . . . . . . . . 971
une base MySQL . . . . . . . . . . . . . . . . . . . . . . . 901 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 974
tMysqlRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 903 tOracleSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 975
Proprits du tMysqlRollback . . . . . . . . . . 903 tOracleSCDELT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 976
Scnario : Annuler l'insertion de tOracleSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 977
donnes dans des tables mre/fille . . . . . . 903 Proprits du tOracleSP . . . . . . . . . . . . . . . . . 977
tMysqlRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 905 Scnario : Vrifier le format de
Proprits du tMysqlRow . . . . . . . . . . . . . . . 905 numros l'aide d'une procdure
Scnario 1 : Supprimer et re-gnrer stocke . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 979
un index de table MySQL . . . . . . . . . . . . . . 907 tOracleTableList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 984
Scnario 2 : Utiliser l'instance Proprits du tOracleTableList . . . . . . . . . 984
PreparedStatement pour faire une Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 985
requte sur des donnes . . . . . . . . . . . . . . . . . 909 tPostgresqlBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . 986
Scnario 3 : Combiner deux flux Proprits du tPostgresqlBulkExec . . . . . 986
pour une sortie slective . . . . . . . . . . . . . . . . 914 Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 988
tMysqlSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 920 tPostgresqlCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . 989
tMysqlSCDELT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 921 Proprits du tPostgresqlCommit . . . . . . . 989
tMysqlSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 922 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 989

Guide de rfrence des Composants de Talend Open Studio ix


Composants Talend Open Studio

tPostgresqlClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 990 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1048


Proprits du tPostgresqlClose . . . . . . . . . . 990 tVerticaSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1049
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 990 Databases - Composants d'appliance et
tPostgresqlConnection . . . . . . . . . . . . . . . . . . . . . . . . . 991
de datawarehouse .............................. 1051
Proprits du tPostgresqlConnection . . . 991
tGreenplumBulkExec . . . . . . . . . . . . . . . . . . . . . . . . 1052
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . . 992
Proprits du tGreenplumBulkExec . . . 1052
tPostgresqlInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 993
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1054
Proprits du tPostgresqlInput . . . . . . . . . . 993
tGreenplumClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1055
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 995
Proprits du tGreenplumClose . . . . . . . 1055
tPostgresqlOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 996
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1055
Proprits du tPostgresqlOutput . . . . . . . . 996
tGreenplumCommit . . . . . . . . . . . . . . . . . . . . . . . . . . 1056
Scnarios associs . . . . . . . . . . . . . . . . . . . . . . 999
Proprits du tGreenplumCommit . . . . . 1056
tPostgresqlOutputBulk . . . . . . . . . . . . . . . . . . . . . . . 1000
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1056
Proprits du tPostgresqlOutputBulk . . 1000
tGreenplumConnection . . . . . . . . . . . . . . . . . . . . . . 1058
Scnarios associs . . . . . . . . . . . . . . . . . . . . 1001
Proprits du
tPostgresqlOutputBulkExec . . . . . . . . . . . . . . . . . 1002
tGreenplumConnection . . . . . . . . . . . . . . . . 1058
Proprits du
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1059
tPostgresqlOutputBulkExec . . . . . . . . . . . 1002
tGreenplumGPLoad . . . . . . . . . . . . . . . . . . . . . . . . . 1060
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1004
Proprits du tGreenplumGPLoad . . . . . 1060
tPostgresqlRollback . . . . . . . . . . . . . . . . . . . . . . . . . . 1005
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1064
Proprits du tPostgresqlRollback . . . . . 1005
tGreenplumInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1065
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1005
Proprits du tGreenplumInput . . . . . . . . 1065
tPostgresqlRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1006
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1066
Proprits du tPostgresqlRow . . . . . . . . . 1006
tGreenplumOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . 1068
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1008
Proprits du tGreenplumOutput . . . . . . 1068
tPostgresqlSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1009
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1070
tPostgresqlSCDELT . . . . . . . . . . . . . . . . . . . . . . . . . . 1010
tGreenplumOutputBulk . . . . . . . . . . . . . . . . . . . . . 1072
tSybaseBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1011
Proprits du
Proprits du tSybaseBulkExec . . . . . . . 1011
tGreenplumOutputBulk . . . . . . . . . . . . . . . . 1072
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1013
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1073
tSybaseClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1015
tGreenplumOutputBulkExec . . . . . . . . . . . . . . . . 1074
Proprits du tSybaseClose . . . . . . . . . . . . 1015
Proprits du
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1015
tGreenplumOutputBulkExec . . . . . . . . . . 1074
tSybaseCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1016
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1076
Proprits du tSybaseCommit . . . . . . . . . 1016
tGreenplumRollback . . . . . . . . . . . . . . . . . . . . . . . . . 1077
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1016
Proprits du tGreenplumRollback . . . . 1077
tSybaseConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . 1017
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1077
Proprits du tSybaseConnection . . . . . . 1017
tGreenplumRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1078
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1018
Proprits du tGreenplumRow . . . . . . . . 1078
tSybaseInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1019
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1080
Proprits du tSybaseInput . . . . . . . . . . . . 1019
tGreenplumSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1081
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1021
tIngresBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1082
tSybaseIQBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . 1022
Proprits du tIngresBulkExec . . . . . . . . 1082
Proprits du tSybaseIQBulkExec . . . . . 1022
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1084
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1024
tIngresClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1085
tSybaseIQOutputBulkExec . . . . . . . . . . . . . . . . . . 1025
Proprits du tIngresClose . . . . . . . . . . . . . 1085
Proprits du
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1085
tSybaseIQOutputBulkExec . . . . . . . . . . . . 1025
tIngresCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1086
Scnario : Charger en masse de
Proprits du tIngresCommit . . . . . . . . . . 1086
donnes dans une base de donnes
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1086
Sybase IQ 12 . . . . . . . . . . . . . . . . . . . . . . . . . . 1027
tIngresConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1087
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1030
Proprits du tIngresConnection . . . . . . 1087
tSybaseOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1031
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1088
tSybaseOutput Properties . . . . . . . . . . . . . . 1031
tIngresInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1089
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1034
Proprits du tIngresInput . . . . . . . . . . . . . 1089
tSybaseOutputBulk . . . . . . . . . . . . . . . . . . . . . . . . . . . 1035
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1090
Proprits du tSybaseOutputBulk . . . . . 1035
tIngresOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1091
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1036
Proprits du tIngresOutput . . . . . . . . . . . 1091
tSybaseOutputBulkExec . . . . . . . . . . . . . . . . . . . . . 1037
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1093
Proprits du
tIngresOutputBulk . . . . . . . . . . . . . . . . . . . . . . . . . . . 1095
tSybaseOutputBulkExec . . . . . . . . . . . . . . . 1037
Proprits du tIngresOutputBulk . . . . . . 1095
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1039
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1096
tSybaseRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1040
tIngresOutputBulkExec . . . . . . . . . . . . . . . . . . . . . . 1097
Proprits du tSybaseRollback . . . . . . . . 1040
tIngresOutputBulkExec . . . . . . . . . . . . . . . . 1097
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1040
Scnario : Charger des donnes dans
tSybaseRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1041
une table du SGBD Ingres . . . . . . . . . . . . . 1099
Proprits du tSybaseRow . . . . . . . . . . . . . 1041
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1102
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1043
tIngresRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1103
tSybaseSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1044
Proprits du tIngresRollback . . . . . . . . . 1103
tSybaseSCDELT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1045
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1103
tSybaseSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1046
tIngresRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1104
Proprits du tSybaseSP . . . . . . . . . . . . . . . 1046
Proprits du tIngresRow . . . . . . . . . . . . . . 1104

x Guide de rfrence des Composants de Talend Open Studio


Composants Talend Open Studio

Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1106 tRedshiftConnection . . . . . . . . . . . . . . . . . . . . . . . . . 1172


tIngresSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1107 Proprits du tRedshiftConnection . . . . 1172
tNetezzaBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1108 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1173
Proprits du tNetezzaBulkExec . . . . . . 1108 tRedshiftInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1174
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1110 Proprits du tRedshiftInput . . . . . . . . . . . 1174
tNetezzaClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1111 Scnario : Manipuler des donnes
Proprits du tNetezzaClose . . . . . . . . . . . 1111 avec Redshift . . . . . . . . . . . . . . . . . . . . . . . . . . 1176
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1111 tRedshiftOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1181
tNetezzaCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1112 Proprits du tRedshiftOutput . . . . . . . . . 1181
Proprits du tNetezzaCommit . . . . . . . . 1112 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1184
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1112 tRedshiftOutputBulk . . . . . . . . . . . . . . . . . . . . . . . . . 1185
tNetezzaConnection . . . . . . . . . . . . . . . . . . . . . . . . . . 1113 Proprits du tRedshiftOutputBulk . . . . 1185
Proprits du tNetezzaConnection . . . . . 1113 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1186
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1114 tRedshiftOutputBulkExec . . . . . . . . . . . . . . . . . . . 1187
tNetezzaInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1115 Proprits du
Proprits du tNetezzaInput . . . . . . . . . . . 1115 tRedshiftOutputBulkExec . . . . . . . . . . . . . 1187
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1117 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1190
tNetezzaNzLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1118 tRedshiftRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1191
Proprits du tNetezzaNzLoad . . . . . . . . 1118 Proprits du tRedshiftRollback . . . . . . . 1191
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1123 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1191
tNetezzaOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1124 tRedshiftRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1192
Proprits du tNetezzaOutput . . . . . . . . . 1124 Proprits du tRedshiftRow . . . . . . . . . . . 1192
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1127 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1194
tNetezzaRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1128 tRedshiftUnload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1195
Proprits du tNetezzaRollback . . . . . . . 1128 Proprits du tRedshiftUnload . . . . . . . . . 1195
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1128 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1197
tNetezzaRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1129 tTeradataClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1198
Proprits du tNetezzaRow . . . . . . . . . . . . 1129 Proprits du tTeradataClose . . . . . . . . . . 1198
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1131 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1198
tNetezzaSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1132 tTeradataCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1199
tParAccelBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . 1133 Proprits du tTeradataCommit . . . . . . . 1199
Proprits du tParAccelBulkExec . . . . . 1133 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1199
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1135 tTeradataConnection . . . . . . . . . . . . . . . . . . . . . . . . . 1200
tParAccelClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1136 Proprits du tTeradataConnection . . . . 1200
Proprits du tParAccelClose . . . . . . . . . . 1136 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1201
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1136 tTeradataFastExport . . . . . . . . . . . . . . . . . . . . . . . . . 1202
tParAccelCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1137 Proprits du tTeradataFastExport . . . . 1202
Proprits du tParAccelCommit . . . . . . . 1137 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1203
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1137 tTeradataFastLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . 1204
tParAccelConnection . . . . . . . . . . . . . . . . . . . . . . . . . 1138 Proprits du tTeradataFastLoad . . . . . . 1204
Proprits du tParAccelConnection . . . 1138 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1205
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1139 tTeradataFastLoadUtility . . . . . . . . . . . . . . . . . . . . 1206
tParAccelInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1140 Proprits du
Proprits du tParAccelInput . . . . . . . . . . 1140 tTeradataFastLoadUtility . . . . . . . . . . . . . . 1206
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1142 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1207
tParAccelOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1143 tTeradataInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1208
Proprits du tParAccelOutput . . . . . . . . 1143 Proprits du tTeradataInput . . . . . . . . . . 1208
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1146 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1210
tParAccelOutputBulk . . . . . . . . . . . . . . . . . . . . . . . . 1147 tTeradataMultiLoad . . . . . . . . . . . . . . . . . . . . . . . . . 1211
Proprits du tParAccelOutputBulk . . . 1147 Proprits du tTeradataMultiLoad . . . . . 1211
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1148 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1213
tParAccelOutputBulkExec . . . . . . . . . . . . . . . . . . . 1149 tTeradataOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1214
Proprits du Proprits du tTeradataOutput . . . . . . . . . 1214
tParAccelOutputBulkExec . . . . . . . . . . . . . 1149 Scnario associ . . . . . . . . . . . . . . . . . . . . . . 1217
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1151 tTeradataRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . 1218
tParAccelRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1152 Proprits du tTeradataRollback . . . . . . 1218
Proprits du tParAccelRollback . . . . . . 1152 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1218
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1152 tTeradataRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1219
tParAccelRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1153 Proprits du tTeradataRow . . . . . . . . . . . 1219
Proprits du tParAccelRow . . . . . . . . . . . 1153 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1221
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1155 tTeradataTPTExec . . . . . . . . . . . . . . . . . . . . . . . . . . . 1222
tParAccelSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1156 Proprits du tTeradataTPTExec . . . . . . 1222
tRedshiftBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1157 Scnario : Charger des donnes dans
Proprits du tRedshiftBulkExec . . . . . . 1157 une base de donnes Teradata . . . . . . . . . 1226
Charger/retirer des donnes dans/de tTeradataTPTUtility . . . . . . . . . . . . . . . . . . . . . . . . . 1233
Amazon S3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1160 Proprits du tTeradataTPTUtility . . . . 1233
tRedshiftClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1170 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1236
Proprits du tRedshiftClose . . . . . . . . . . 1170 tTeradataTPump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1237
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1170 Proprits du tTeradataTPump . . . . . . . . 1237
tRedshiftCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1171 Scnario : Insrer des donnes dans
Proprits du tRedshiftCommit . . . . . . . . 1171 une table d'une base de donnes
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1171 Teradata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1239

Guide de rfrence des Composants de Talend Open Studio xi


Composants Talend Open Studio

tVectorWiseCommit . . . . . . . . . . . . . . . . . . . . . . . . . 1243 Proprits du tDBOutput . . . . . . . . . . . . . . 1294


Proprits du tVectorWiseCommit . . . . 1243 Scnario : Ecrire une ligne dans une
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1243 table d'une base de donnes MySQL
tVectorWiseConnection . . . . . . . . . . . . . . . . . . . . . . 1244 via une connexion ODBC . . . . . . . . . . . . . 1297
Proprits du tDBSQLRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1299
tVectorWiseConnection . . . . . . . . . . . . . . . 1244 Proprits du tDBSQLRow . . . . . . . . . . . . 1299
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1245 Scnario : Rinitialiser l'auto-
tVectorWiseInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1246 incrmentation d'une base de
Proprits du tVectorWiseInput . . . . . . . 1246 donnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1301
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1248 tEXAInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1303
tVectorWiseOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . 1249 Proprits du tEXAInput . . . . . . . . . . . . . . 1303
Proprits du tVectorWiseOutput . . . . . 1249 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1304
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1252 tEXAOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1305
tVectorWiseRollback . . . . . . . . . . . . . . . . . . . . . . . . . 1253 Proprits du tEXAOutput . . . . . . . . . . . . 1305
Proprits du tVectorWiseRollback . . . 1253 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1308
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1253 tEXARow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1309
tVectorWiseRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1254 Proprits du tEXARow . . . . . . . . . . . . . . . 1309
Proprits du tVectorWiseRow . . . . . . . . 1254 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1311
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1256 tEXistConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1312
tVerticaBulkExec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1257 Proprits du tEXistConnection . . . . . . . 1312
Proprits du tVerticaBulkExec . . . . . . . 1257 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1312
Conseils et techniques . . . . . . . . . . . . . . . . . 1259 tEXistDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1313
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1259 Proprits du tEXistDelete . . . . . . . . . . . . 1313
tVerticaClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1260 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1314
Proprits du tVerticaClose . . . . . . . . . . . 1260 tEXistGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1315
Conseils et techniques . . . . . . . . . . . . . . . . . 1260 Proprits du tEXistGet . . . . . . . . . . . . . . . 1315
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1260 Scnario : Rcuprer des ressources
tVerticaCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1261 partir d'un serveur distant de base de
Proprits du tVerticaCommit . . . . . . . . . 1261 donnes eXist . . . . . . . . . . . . . . . . . . . . . . . . . . 1316
Conseils et techniques . . . . . . . . . . . . . . . . . 1261 tEXistList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1319
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1262 Proprits du tEXistList . . . . . . . . . . . . . . . 1319
tVerticaConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . 1263 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1320
Proprits du tVerticaConnection . . . . . 1263 tEXistPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1321
Conseils et techniques . . . . . . . . . . . . . . . . . 1264 Proprits du tEXistPut . . . . . . . . . . . . . . . . 1321
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1264 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1322
tVerticaInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1265 tEXistXQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1323
Proprits du tVerticaInput . . . . . . . . . . . . 1265 Proprits du tEXistXQuery . . . . . . . . . . . 1323
Conseils et techniques . . . . . . . . . . . . . . . . . 1267 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1324
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1267 tEXistXUpdate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1325
tVerticaOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1268 Proprits du tEXistXUpdate . . . . . . . . . . 1325
Proprits du tVerticaOutput . . . . . . . . . . 1268 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1326
Conseils et techniques . . . . . . . . . . . . . . . . . 1272 tFirebirdClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1327
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1272 Proprits du tFirebirdClose . . . . . . . . . . . 1327
tVerticaOutputBulk . . . . . . . . . . . . . . . . . . . . . . . . . . 1273 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1327
Proprits du tVerticaOutputBulk . . . . . 1273 tFirebirdCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1328
Conseils et techniques . . . . . . . . . . . . . . . . . 1274 Proprits du tFirebirdCommit . . . . . . . . 1328
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1274 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1329
tVerticaOutputBulkExec . . . . . . . . . . . . . . . . . . . . 1275 tFirebirdConnection . . . . . . . . . . . . . . . . . . . . . . . . . 1330
Proprits du Proprits du tFirebirdConnection . . . . . 1330
tVerticaOutputBulkExec . . . . . . . . . . . . . . . 1275 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1331
Conseils et techniques . . . . . . . . . . . . . . . . . 1277 tFirebirdInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1332
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1277 Proprits du tFirebirdInput . . . . . . . . . . . 1332
tVerticaRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1278 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1333
Proprits du tVerticaRollback . . . . . . . . 1278 tFirebirdOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1335
Conseils et techniques . . . . . . . . . . . . . . . . . 1278 Proprits du tFirebirdOutput . . . . . . . . . 1335
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1278 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1338
tVerticaRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1279 tFirebirdRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1339
Proprits du tVerticaRow . . . . . . . . . . . . 1279 Proprits du tFirebirdRollback . . . . . . . 1339
Conseils et techniques . . . . . . . . . . . . . . . . . 1281 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1339
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1281 tFirebirdRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1340
Databases - Autres composants ........... 1283 Proprits du tFirebirdRow . . . . . . . . . . . . 1340
tCreateTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1284 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1342
Proprits du tCreateTable . . . . . . . . . . . . 1284 tHiveClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1343
Scnario : Crer une nouvelle table tHiveConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1344
dans une base de donnes MySQL . . . . 1287 tHiveRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1345
tDBInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1289 tHSQLDbInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1346
Proprits du tDBInput . . . . . . . . . . . . . . . . 1289 Proprits du tHSQLDbInput . . . . . . . . . . 1346
Scnario 1 : Afficher les donnes Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1348
slectionnes partir d'une table . . . . . . 1291 tHSQLDbOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1349
Scnario 2 : Utiliser la variable Proprits du tHSQLDbOutput . . . . . . . . 1349
StoreSQLQuery . . . . . . . . . . . . . . . . . . . . . . . . 1292 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1352
tDBOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1294 tHSQLDbRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1353

xii Guide de rfrence des Composants de Talend Open Studio


Composants Talend Open Studio

Proprits du tHSQLDbRow . . . . . . . . . . 1353 Proprits du tLDAPClose . . . . . . . . . . . . 1408


Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1355 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1408
tInterbaseClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1356 tLDAPConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1409
Proprits du tInterbaseClose . . . . . . . . . . 1356 Proprits du tLDAPConnection . . . . . . 1409
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1356 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1410
tInterbaseCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1357 tLDAPInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1411
Proprits du tInterbaseCommit . . . . . . . 1357 Proprits du tLDAPInput . . . . . . . . . . . . . 1411
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1357 Scnario : Afficher le contenu filtr
tInterbaseConnection . . . . . . . . . . . . . . . . . . . . . . . . 1358 d'un annuaire LDAP . . . . . . . . . . . . . . . . . . . 1413
Proprits du tInterbaseConnection . . . 1358 tLDAPOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1416
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1359 Proprits du tLDAPOutput . . . . . . . . . . . 1416
tInterbaseInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1360 Scnario : Editer des donnes dans
Proprits du tInterbaseInput . . . . . . . . . . 1360 un annuaire LDAP . . . . . . . . . . . . . . . . . . . . . 1418
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1361 tLDAPRenameEntry . . . . . . . . . . . . . . . . . . . . . . . . . 1422
tInterbaseOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1363 Proprits du tLDAPRenameEntry . . . . 1422
Proprits du tInterbaseOutput . . . . . . . . 1363 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1424
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1365 tMaxDBInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1425
tInterbaseRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . 1367 Proprits du tMaxDBInput . . . . . . . . . . . 1425
Proprits du tInterbaseRollback . . . . . . 1367 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1426
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1367 tMaxDBOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1427
tInterbaseRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1368 Proprits du tMaxDBOutput . . . . . . . . . 1427
Proprits du tInterbaseRow . . . . . . . . . . . 1368 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1429
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1370 tMaxDBRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1430
tJavaDBInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1371 Proprits du tMaxDBRow . . . . . . . . . . . . 1430
Proprits du tJavaDBInput . . . . . . . . . . . 1371 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1432
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1372 tParseRecordSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1433
tJavaDBOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1373 Proprits du tParseRecordSet . . . . . . . . . 1433
Proprits du tJavaDBOutput . . . . . . . . . . 1373 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1434
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1376 tPostgresPlusBulkExec . . . . . . . . . . . . . . . . . . . . . . . 1435
tJavaDBRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1377 Proprits du tPostgresPlusBulkExec . 1435
Proprits du tJavaDBRow . . . . . . . . . . . . 1377 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1437
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1379 tPostgresPlusClose . . . . . . . . . . . . . . . . . . . . . . . . . . . 1438
tJDBCColumnList . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1380 Proprits du tPostgresPlusClose . . . . . . 1438
Proprits du tJDBCColumnList . . . . . . 1380 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1438
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1381 tPostgresPlusCommit . . . . . . . . . . . . . . . . . . . . . . . . 1439
tJDBCClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1382 Proprits du tPostgresPlusCommit . . . 1439
Proprits du tJDBCClose . . . . . . . . . . . . . 1382 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1439
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1382 tPostgresPlusConnection . . . . . . . . . . . . . . . . . . . . . 1440
tJDBCCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1383 Proprits du
Proprits du tJDBCCommit . . . . . . . . . . 1383 tPostgresPlusConnection . . . . . . . . . . . . . . 1440
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1383 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1441
tJDBCConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1384 tPostgresPlusInput . . . . . . . . . . . . . . . . . . . . . . . . . . . 1442
Proprits du tJDBCConnection . . . . . . . 1384 Proprits du tPostgresPlusInput . . . . . . 1442
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1385 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1444
tJDBCInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1386 tPostgresPlusOutput . . . . . . . . . . . . . . . . . . . . . . . . . 1445
Proprits du tJDBCInput . . . . . . . . . . . . . 1386 Proprits du tPostgresPlusOutput . . . . 1445
Le composant tJDBCInput dans les Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1448
Jobs Talend Map/Reduce . . . . . . . . . . . . . . 1388 tPostgresPlusOutputBulk . . . . . . . . . . . . . . . . . . . . 1449
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1389 Proprits du
tJDBCOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1390 tPostgresPlusOutputBulk . . . . . . . . . . . . . . 1449
Proprits du tJDBCOutput . . . . . . . . . . . 1390 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1450
Le composant tJDBCOutput dans les tPostgresPlusOutputBulkExec . . . . . . . . . . . . . . 1451
Jobs Talend Map/Reduce . . . . . . . . . . . . . . 1393 Proprits du
Le tJDBCOutput dans des Jobs tPostgresplusOutputBulkExec . . . . . . . . . 1451
Storm Talend . . . . . . . . . . . . . . . . . . . . . . . . . . 1394 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1453
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1395 tPostgresPlusRollback . . . . . . . . . . . . . . . . . . . . . . . 1454
tJDBCRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1396 Proprits du tPostgresPlusRollback . . 1454
Proprits du tJDBCRollback . . . . . . . . . 1396 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1454
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1396 tPostgresPlusRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1455
tJDBCRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1397 Proprits du tPostgresPlusRow . . . . . . . 1455
Proprits du tJDBCRow . . . . . . . . . . . . . . 1397 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1457
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1399 tPostgresPlusSCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1458
tJDBCSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1400 tPostgresPlusSCDELT . . . . . . . . . . . . . . . . . . . . . . . 1459
Proprits du tJDBCSP . . . . . . . . . . . . . . . . 1400 tSAPHanaClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1460
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1402 Proprits du tSAPHanaClose . . . . . . . . . 1460
tJDBCTableList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1403 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1460
Proprits du tJDBCTableList . . . . . . . . . 1403 tSAPHanaCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1461
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1404 Proprits du tSAPHanaCommit . . . . . . 1461
tLDAPAttributesInput . . . . . . . . . . . . . . . . . . . . . . . 1405 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1461
Proprits du tLDAPAttributesInput . . 1405 tSAPHanaConnection . . . . . . . . . . . . . . . . . . . . . . . . 1462
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1407 Proprits du tSAPHanaConnection . . . 1462
tLDAPClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1408 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1463

Guide de rfrence des Composants de Talend Open Studio xiii


Composants Talend Open Studio

tSAPHanaInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1464 Scnario: Mapper les donnes


Proprits du tSAPHanaInput . . . . . . . . . 1464 l'aide d'une jointure implicite simple . . 1529
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1466 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1535
tSAPHanaOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1467 tELTGreenplumOutput . . . . . . . . . . . . . . . . . . . . . 1536
Proprits du tSAPHanaOutput . . . . . . . 1467 Proprits du
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1470 tELTGreenplumOutput . . . . . . . . . . . . . . . . 1536
tSAPHanaRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . 1471 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1537
Proprits du tSAPHanaRollback . . . . . 1471 tELTJDBCInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1538
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1471 Proprits du tELTJDBCInput . . . . . . . . 1538
tSAPHanaRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1472 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1539
Proprits du tSAPHanaRow . . . . . . . . . . 1472 tELTJDBCMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1540
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1474 Proprits du tELTJDBCMap . . . . . . . . . 1540
tSasInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1475 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1542
Proprits du tSasInput . . . . . . . . . . . . . . . . 1475 tELTJDBCOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1543
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1476 Proprits du tELTJDBCOutput . . . . . . . 1543
tSasOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1478 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1544
Proprits du tSasOutput . . . . . . . . . . . . . . 1478 tELTMSSqlInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1545
Scnarios associs . . . . . . . . . . . . . . . . . . . . 1480 Proprits du tELTMSSqlInput . . . . . . . 1545
tSQLiteClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1481 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1546
Proprits du tSQLiteClose . . . . . . . . . . . . 1481 tELTMSSqlMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1547
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1481 Proprits du tELTMSSqlMap . . . . . . . . 1547
tSQLiteCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1482 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1549
Proprits du tSQLiteCommit . . . . . . . . . 1482 tELTMSSqlOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . 1550
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1482 Proprits du tELTMSSqlOutput . . . . . . 1550
tSQLiteConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . 1483 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1551
Proprits du tSQLiteConnection . . . . . 1483 tELTMysqlInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1552
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1484 Proprits du tELTMysqlInput . . . . . . . . 1552
tSQLiteInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1485 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1553
Proprits du tSQLiteInput . . . . . . . . . . . . 1485 tELTMysqlMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1554
Scnario : Filtrer des donnes SQlite . . 1486 Proprits du tELTMysqlMap . . . . . . . . . 1554
tSQLiteOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1489 Scnario 1 : Agrger les colonnes
Proprits du tSQLiteOutput . . . . . . . . . . 1489 d'une table et appliquer un filtre . . . . . . . 1557
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1491 Scnario 2 : ELT utilisant une table
tSQLiteRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1492 Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1560
Proprits du tSQLiteRollback . . . . . . . . 1492 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1564
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1492 tELTMysqlOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . 1565
tSQLiteRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1493 Proprits du tELTMysqlOutput . . . . . . 1565
Proprits du tSQLiteRow . . . . . . . . . . . . . 1493 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1566
Scnario : Mettre jour des lignes tELTNetezzaInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1567
SQLite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1495 Proprits du tELTNetezzaInput . . . . . . 1567
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1497 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1568
Composants DotNET ......................... 1499 tELTNetezzaMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1569
tDotNETInstantiate . . . . . . . . . . . . . . . . . . . . . . . . . . 1500 Proprits du tELTNetezzaMap . . . . . . . 1569
Proprits du tDotNETInstantiate . . . . . 1500 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1571
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1501 tELTNetezzaOutput . . . . . . . . . . . . . . . . . . . . . . . . . . 1572
tDotNETRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1502 Proprits du tELTNetezzaOutput . . . . . 1572
Proprits du tDotNETRow . . . . . . . . . . . 1502 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1573
Scnario : Utiliser .NET dans Talend . 1503 tELTOracleInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1574
Proprits du tELTOracleInput . . . . . . . . 1574
Composants ELT .............................. 1509
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1575
tAccessConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1510
tELTOracleMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1576
tAS400Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1511
Proprits du tELTOracleMap . . . . . . . . . 1576
tCombinedSQLAggregate . . . . . . . . . . . . . . . . . . . 1512
Scnario : Mettre jour les lignes
Proprits du
d'une base Oracle . . . . . . . . . . . . . . . . . . . . . . 1578
tCombinedSQLAggregate . . . . . . . . . . . . . 1512
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1581
Scnario : Filtrer et agrger des
tELTOracleOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . 1582
colonnes d'une table directement sur
Proprits du tELTOracleOutput . . . . . . 1582
le SGBD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1513
Scnario : Utiliser la fonction
tCombinedSQLFilter . . . . . . . . . . . . . . . . . . . . . . . . . 1518
MERGE d'Oracle pour mettre
Proprits du tCombinedSQLFilter . . . . 1518
jour et insrer simultanment des
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1519
donnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1584
tCombinedSQLInput . . . . . . . . . . . . . . . . . . . . . . . . . 1520
tELTPostgresqlInput . . . . . . . . . . . . . . . . . . . . . . . . . 1589
Proprits du tCombinedSQLInput . . . . 1520
Proprits du tELTPostgresqlInput . . . . 1589
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1521
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1590
tCombinedSQLOutput . . . . . . . . . . . . . . . . . . . . . . . 1522
tELTPostgresqlMap . . . . . . . . . . . . . . . . . . . . . . . . . . 1591
Proprits du tCombinedSQLOutput . . 1522
Proprits du tELTPostgresqlMap . . . . . 1591
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1523
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1593
tDB2Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1524
tELTPostgresqlOutput . . . . . . . . . . . . . . . . . . . . . . . 1594
tELTGreenplumInput . . . . . . . . . . . . . . . . . . . . . . . 1525
Proprits du tELTPostgresqlOutput . . 1594
Proprits du tELTGreenplumInput . . . 1525
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1595
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1526
tELTSybaseInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1596
tELTGreenplumMap . . . . . . . . . . . . . . . . . . . . . . . . 1527
Proprits du tELTSybaseInput . . . . . . . 1596
Proprits du tELTGreenplumMap . . . . 1527

xiv Guide de rfrence des Composants de Talend Open Studio


Composants Talend Open Studio

Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1597 Scnario 2 : Utiliser le


tELTSybaseMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1598 tEBSConsumer avec des en-ttes
Proprits du tELTSybaseMap . . . . . . . . 1598 SOAP personnaliss . . . . . . . . . . . . . . . . . . . 1670
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1600 tESBProviderFault . . . . . . . . . . . . . . . . . . . . . . . . . . . 1677
tELTSybaseOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . 1601 Proprits du tESBProviderFault . . . . . . 1677
Proprits du tELTSybaseOutput . . . . . . 1601 Scnario : Effectuer une requte sur
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1602 les nom d'aroports partir des codes
tELTTeradataInput . . . . . . . . . . . . . . . . . . . . . . . . . . 1603 pays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1678
Proprits de tELTTeradataInput . . . . . . 1603 tESBProviderRequest . . . . . . . . . . . . . . . . . . . . . . . . 1689
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1604 Proprits du tESBProviderRequest . . . 1689
tELTTeradataMap . . . . . . . . . . . . . . . . . . . . . . . . . . . 1605 Scnario : Envoi d'un message via un
Proprits de tELTTeradataMap . . . . . . 1605 service sans attente de rponse . . . . . . . . 1690
Scnario : Mapper des donnes tESBProviderResponse . . . . . . . . . . . . . . . . . . . . . . 1700
l'aide d'une sous-requte . . . . . . . . . . . . . . . 1607 Proprits du
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1615 tESBProviderResponse . . . . . . . . . . . . . . . . 1700
tELTTeradataOutput . . . . . . . . . . . . . . . . . . . . . . . . 1616 Scnario : Retourner une rponse
Proprits de tELTTeradataOutput . . . . 1616 "Hello world" . . . . . . . . . . . . . . . . . . . . . . . . . . 1701
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1617 tRESTClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1710
tFirebirdConnection . . . . . . . . . . . . . . . . . . . . . . . . . 1618 Proprits du tRESTClient . . . . . . . . . . . . 1710
tGreenplumConnection . . . . . . . . . . . . . . . . . . . . . . 1619 Scnario 1 : Obtenir des informations
tHiveConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1620 sur un utilisateur en interagissant
tIngresConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1621 avec un service RESTful . . . . . . . . . . . . . . 1714
tInterbaseConnection . . . . . . . . . . . . . . . . . . . . . . . . 1622 Scnario 2 : Mettre jour les
tJDBCConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1623 informations des utilisateurs via une
tMSSqlConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . 1624 interaction avec un service RESTful . . 1720
tMysqlConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1625 tRESTRequest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1727
tNetezzaConnection . . . . . . . . . . . . . . . . . . . . . . . . . . 1626 Proprits du tRESTRequest . . . . . . . . . . 1727
tOracleConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . 1627 Scnario 1 : Service REST acceptant
tParAccelConnection . . . . . . . . . . . . . . . . . . . . . . . . . 1628 des requtes HTTP GET et envoyant
tPostgresPlusConnection . . . . . . . . . . . . . . . . . . . . . 1629 des rponses . . . . . . . . . . . . . . . . . . . . . . . . . . . 1729
tPostgresqlConnection . . . . . . . . . . . . . . . . . . . . . . . 1630 Scnario 2 : Utiliser les paramtres
tSAPHanaConnection . . . . . . . . . . . . . . . . . . . . . . . . 1631 URI Query pour explorer les donnes
tSQLiteConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . 1632 d'une base de donnes . . . . . . . . . . . . . . . . . 1734
tSQLTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1633 Scnario 3 : Service REST acceptant
Proprits du tSQLTemplate . . . . . . . . . . 1633 des requtes HTTP POST . . . . . . . . . . . . . 1743
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1634 tRESTResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1750
tSQLTemplateAggregate . . . . . . . . . . . . . . . . . . . . 1635 Proprits du tRESTResponse . . . . . . . . . 1750
Proprits du Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1751
tSQLTemplateAggregate . . . . . . . . . . . . . . 1635 tRouteFault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1752
Scnario : Filtrer et agrger les Proprits du tRouteFault . . . . . . . . . . . . . 1752
colonnes d'une table directement Scnario : Rcuprer des messages
dans le SGBD . . . . . . . . . . . . . . . . . . . . . . . . . 1637 du tRouteFault . . . . . . . . . . . . . . . . . . . . . . . . . 1753
tSQLTemplateCommit . . . . . . . . . . . . . . . . . . . . . . . 1641 tRouteInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1758
Proprits du tSQLTemplateCommit . . 1641 Proprits du tRouteInput . . . . . . . . . . . . . 1758
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1642 Scnario : Rcuprer des messages
tSQLTemplateFilterColumns . . . . . . . . . . . . . . . 1643 d'une Route . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1759
Proprits du tRouteOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1763
tSQLTemplateFilterColumns . . . . . . . . . . 1643 Proprits du tRouteOutput . . . . . . . . . . . . 1763
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1644 Scnario : Rcuprer des messages
tSQLTemplateFilterRows . . . . . . . . . . . . . . . . . . . 1645 du tRouteOutput . . . . . . . . . . . . . . . . . . . . . . . 1764
Proprits du Composants File ............................... 1769
tSQLTemplateFilterRows . . . . . . . . . . . . . 1645 tAdvancedFileOutputXML . . . . . . . . . . . . . . . . . . 1770
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1646 tApacheLogInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1771
tSQLTemplateMerge . . . . . . . . . . . . . . . . . . . . . . . . . 1647 Proprits du tApacheLogInput . . . . . . . 1771
Proprits du tSQLTemplateMerge . . . 1647 Scnario : Lire un fichier de log
Scnario : Effectuer des oprations d'accs Apache . . . . . . . . . . . . . . . . . . . . . . . . 1772
de MERGE directement dans le tCreateTemporaryFile . . . . . . . . . . . . . . . . . . . . . . . 1774
SGBD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1649 Proprits du tCreateTemporaryFile . . . 1774
tSQLTemplateRollback . . . . . . . . . . . . . . . . . . . . . . 1656 Scnario : Crer un fichier
Proprits du temporaire et y crire des donnes . . . . . 1775
tSQLTemplateRollback . . . . . . . . . . . . . . . . 1656 tChangeFileEncoding . . . . . . . . . . . . . . . . . . . . . . . . 1779
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1657 Proprits du tChangeFileEncoding . . . 1779
tSybaseConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . 1658 Scnario: Transformer l'encodage
tTeradataConnection . . . . . . . . . . . . . . . . . . . . . . . . . 1659 des caractres d'un fichier . . . . . . . . . . . . . 1779
tVectorWiseConnection . . . . . . . . . . . . . . . . . . . . . . 1660 tFileArchive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1781
Composants ESB .............................. 1661 Proprits du tFileArchive . . . . . . . . . . . . . 1781
tESBConsumer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1662 Scnario : Zipper des fichiers l'aide
Proprits du tESBConsumer . . . . . . . . . . 1662 d'un tFileArchive . . . . . . . . . . . . . . . . . . . . . . 1782
Scnario 1 : Utiliser le composant tFileCompare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1784
tESBConsumer . . . . . . . . . . . . . . . . . . . . . . . . 1666 Proprits du tFileCompare . . . . . . . . . . . 1784
Scnario : Comparer des fichiers
dzipps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1785

Guide de rfrence des Composants de Talend Open Studio xv


Composants Talend Open Studio

tFileCopy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1787 Scnario : Transformer un fichier


Proprits du tFileCopy . . . . . . . . . . . . . . . 1787 positionnel en fichier XML . . . . . . . . . . . . 1873
Scnario : Rcuprer un fichier de la tFileInputProperties . . . . . . . . . . . . . . . . . . . . . . . . . . 1878
corbeille . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1788 Proprits du tFileInputProperties . . . . . 1878
tFileDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1790 Scnario : Lire et mapper la cl et
Proprits du tFileDelete . . . . . . . . . . . . . . 1790 les valeurs de fichiers properties et
Scnario : Supprimer des fichiers . . . . . 1791 alimenter un glossaire . . . . . . . . . . . . . . . . . 1879
tFileExist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1793 tFileInputRaw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1883
Proprits du tFileExist . . . . . . . . . . . . . . . . 1793 Proprits du tFileInputRaw . . . . . . . . . . . 1883
Scnario : Vrifier l'existence d'un Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1884
fichier et le crer s'il n'existe pas . . . . . . 1794 tFileInputRegex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1885
tFileInputARFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1798 Proprits du tFileInputRegex . . . . . . . . . 1885
Proprits du tFileInputARFF . . . . . . . . . 1798 Scnario : Transformer en fichier
Scnario : Afficher le contenu d'un Regex en Positional . . . . . . . . . . . . . . . . . . . 1887
fichier ARFF . . . . . . . . . . . . . . . . . . . . . . . . . . . 1799 tFileInputXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1890
tFileInputDelimited . . . . . . . . . . . . . . . . . . . . . . . . . . 1803 tFileList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1891
Proprits du tFileInputDelimited . . . . . 1803 Proprits du tFileList . . . . . . . . . . . . . . . . . 1891
tFileInputDelimited in Talend Map/ Scnario 1 : Itration sur un
Reduce Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . 1805 rpertoire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1893
Scnario 1 : Afficher le contenu d'un Scnario 2 : Trouver des fichiers
fichier dlimit . . . . . . . . . . . . . . . . . . . . . . . . 1807 dupliqus entre deux dossiers . . . . . . . . . 1895
Scnario 2 : Lire les donnes d'un tFileOutputARFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1901
fichier distant en mode stream . . . . . . . . . 1809 Proprits du tFileOutputARFF . . . . . . . 1901
tFileInputEBCDIC . . . . . . . . . . . . . . . . . . . . . . . . . . . 1813 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1903
Proprits du tFileInputEBCDIC . . . . . . 1813 tFileOutputDelimited . . . . . . . . . . . . . . . . . . . . . . . . 1904
Scnario : Extraire les donnes d'un Proprits du tFileOutputDelimited . . . 1904
fichier EBCDIC . . . . . . . . . . . . . . . . . . . . . . . 1814 Le tFileOutputDelimited dans des
tFileInputExcel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1821 Jobs Map/Reduce Talend . . . . . . . . . . . . . . 1906
Proprits du tFileInputExcel . . . . . . . . . . 1821 Scnario 1 : Ecrire des donnes dans
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1824 un fichier dlimit . . . . . . . . . . . . . . . . . . . . . 1909
tFileInputFullRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1825 Scnario 2 : Utiliser un flux de sortie
Proprits du tFileInputFullRow . . . . . . 1825 pour sauvegarder des donnes dans
Le tFileInputFullRow dans des Jobs un fichier local . . . . . . . . . . . . . . . . . . . . . . . . . 1913
Map/Reduce Talend . . . . . . . . . . . . . . . . . . . 1826 tFileOutputEBCDIC . . . . . . . . . . . . . . . . . . . . . . . . . 1916
Scnario : Lire des lignes compltes Proprits du tFileOutputEBCDIC . . . . 1916
dans un fichier dlimit . . . . . . . . . . . . . . . 1828 Scnario : Crer un fichier EBCDIC
tFileInputJSON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1830 partir de deux fichiers dlimits . . . . . 1917
Proprits du tFileInputJSON . . . . . . . . . 1830 tFileOutputExcel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1919
Le tFileInputJSON dans des Jobs Proprits du tFileOutputExcel . . . . . . . . 1919
Talend Map/Reduce . . . . . . . . . . . . . . . . . . . 1832 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1921
Scnario 1 : Extraire des donnes tFileOutputJSON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1922
JSON d'un fichier . . . . . . . . . . . . . . . . . . . . . . 1834 Proprits du tFileOutputJSON . . . . . . . 1922
Scnario 2 : Extraire des donnes Le tFileOutputJSON dans des Jobs
JSON d'un fichier en utilisant XPath . . 1837 Map/Reduce Talend . . . . . . . . . . . . . . . . . . . 1923
Scnario 3 : Extraire des donnes Scnario : Ecrire un fichier JSON
JSON partir d'une URL . . . . . . . . . . . . . . 1840 structur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1925
tFileInputLDIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1845 tFileOutputLDIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1928
Proprits du tFileInputLDIF . . . . . . . . . . 1845 Proprits du tFileOutputLDIF . . . . . . . . 1928
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1846 Scnario : Ecrire des donnes dans
tFileInputMail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1847 un fichier LDIF . . . . . . . . . . . . . . . . . . . . . . . . 1929
Proprits du tFileInputMail . . . . . . . . . . . 1847 tFileOutputMSDelimited . . . . . . . . . . . . . . . . . . . . 1933
Scnario : Extraire des champs cls Proprits du
d'un e-mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1848 tFileOutputMSDelimited . . . . . . . . . . . . . . 1933
tFileInputMSDelimited . . . . . . . . . . . . . . . . . . . . . . 1851 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1934
Proprits du tFileOutputMSPositional . . . . . . . . . . . . . . . . . . . . 1935
tFileInputMSDelimited . . . . . . . . . . . . . . . . 1851 Proprits du
Scnario : Lecture d'un fichier tFileOutputMSPositional . . . . . . . . . . . . . . 1935
dlimit multi-structure . . . . . . . . . . . . . . . . 1853 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1936
tFileInputMSPositional . . . . . . . . . . . . . . . . . . . . . . 1860 tFileOutputMSXML . . . . . . . . . . . . . . . . . . . . . . . . . 1937
Proprits du Proprits du tFileOutputMSXML . . . . 1937
tFileInputMSPositional . . . . . . . . . . . . . . . . 1860 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1942
Scnario : Lire des donnes d'un tFileOutputPositional . . . . . . . . . . . . . . . . . . . . . . . . 1943
fichier positionnel . . . . . . . . . . . . . . . . . . . . . 1861 Proprits du tFileOutputPositional . . . 1943
tFileInputMSXML . . . . . . . . . . . . . . . . . . . . . . . . . . . 1865 Le tFileOutputPositional dans des
Proprits du tFileInputMSXML . . . . . . 1865 Jobs Map/Reduce Talend . . . . . . . . . . . . . . 1945
Scnario : Lecture d'un fichier XML Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1947
multi-structur . . . . . . . . . . . . . . . . . . . . . . . . . 1866 tFileOutputProperties . . . . . . . . . . . . . . . . . . . . . . . . 1948
tFileInputPositional . . . . . . . . . . . . . . . . . . . . . . . . . . 1869 Proprits du tFileOutputProperties . . . 1948
Proprits du tFileInputPositional . . . . . 1869 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1949
Le tFileInputPositional dans des Jobs tFileOutputRaw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1950
Map/Reduce Talend . . . . . . . . . . . . . . . . . . . 1871 Proprits du tFileOutputRaw . . . . . . . . . 1950
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1951

xvi Guide de rfrence des Composants de Talend Open Studio


Composants Talend Open Studio

tFileOutputXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1952 Scnario : Renommer un fichier situ


tFileProperties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1953 sur un serveur FTP . . . . . . . . . . . . . . . . . . . . 2018
Proprits du tFileProperties . . . . . . . . . . 1953 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2020
Scnario : Afficher les proprits tFTPTruncate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2021
d'un fichier trait . . . . . . . . . . . . . . . . . . . . . . 1954 Proprits du tFTPTruncate . . . . . . . . . . . 2021
tFileRowCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1956 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2022
Proprits du tFileRowCount . . . . . . . . . . 1956 tHttpRequest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2023
Scnario : Ecrire un fichier Proprits du tHttpRequest . . . . . . . . . . . . 2023
dans MySQL si le nombre Scnario 1 : Envoyer une requte
d'enregistrements correspond une HTTP au serveur et sauvegarder
valeur de rfrence . . . . . . . . . . . . . . . . . . . . 1957 localement les rponses HTTP
tFileTouch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1962 obtenues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2025
Proprits du tFileTouch . . . . . . . . . . . . . . 1962 Scnario 2 : Envoyer une requte
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1962 POST depuis un fichier local JSON . . . 2026
tFileUnarchive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1963 tJMSInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2031
Proprits du tFileUnarchive . . . . . . . . . . 1963 Proprits du tJMSInput . . . . . . . . . . . . . . . 2031
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1964 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2032
tGPGDecrypt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1965 tJMSOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2033
Proprits du tGPGDecrypt . . . . . . . . . . . 1965 Proprits du tJMSOutput . . . . . . . . . . . . . 2033
Scnario : Dcrypter un fichier Scnario : Mettre un message dans
crypt GnuPG et afficher son une file d'attente du serveur
contenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1965 ActiveMQ et le retirer de cette file . . . . 2034
tNamedPipeClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1969 tMicrosoftMQInput . . . . . . . . . . . . . . . . . . . . . . . . . . 2038
Proprits du tNamedPipeClose . . . . . . . 1969 Proprits du tMicrosoftMQInput . . . . . 2038
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1969 Scnario : Ecrire et rcuprer des
tNamedPipeOpen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1970 messages dans une file d'attente de
Proprits du tNamedPipeOpen . . . . . . . 1970 message Microsoft . . . . . . . . . . . . . . . . . . . . . 2039
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1970 tMicrosoftMQOutput . . . . . . . . . . . . . . . . . . . . . . . . 2043
tNamedPipeOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . 1971 Proprits du tMicrosoftMQOutput . . . 2043
Proprits du tNamedPipeOutput . . . . . . 1971 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2044
Scnario : Ecrire et charger des tMomCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2045
donnes via un tube nomm . . . . . . . . . . . 1972 Proprits du tMomCommit . . . . . . . . . . . 2045
tPivotToColumnsDelimited . . . . . . . . . . . . . . . . . . 1978 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2045
Proprits du tMomConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2046
tPivotToColumnsDelimited . . . . . . . . . . . 1978 Proprits du tMomConnection . . . . . . . 2046
Scnario : Utiliser une colonne pivot Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2047
pour agrger des donnes . . . . . . . . . . . . . . 1979 tMomInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2048
Composants Internet ......................... 1983 Proprits du tMomInput . . . . . . . . . . . . . . 2048
tFileFetch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1984 Scnario 1 : Communication
Proprits du tFileFetch . . . . . . . . . . . . . . . 1984 asynchrone via un serveur MOM . . . . . . 2051
Scnario 1 : Rcuprer des donnes Scnario 2 : Transmettre des fichiers
partir d'un protocole HTTP . . . . . . . . . . . . 1986 XML via un serveur MOM . . . . . . . . . . . . 2054
Scnario 2 : Rutiliser un cookie tMomMessageIdList . . . . . . . . . . . . . . . . . . . . . . . . . 2060
stock pour rcuprer des fichiers via Proprits du tMomMessageIdList . . . . 2060
un protocole HTTP . . . . . . . . . . . . . . . . . . . . 1989 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2061
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 1992 tMomOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2062
tFileInputJSON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1993 Proprits du tMomOutput . . . . . . . . . . . . 2062
tFTPConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1994 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2065
Proprits du tFTPConnection . . . . . . . . . 1994 tMomRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2066
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1995 Proprits du tMomRollback . . . . . . . . . . 2066
tFTPDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1996 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2066
Proprits du tFTPDelete . . . . . . . . . . . . . . 1996 tPOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2067
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1997 Proprits du tPOP . . . . . . . . . . . . . . . . . . . . 2067
tFTPFileExist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1998 Scnario : Rcuprer une slection
Proprits du tFTPFileExist . . . . . . . . . . . 1998 d'e-mails partir d'un compte de
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 1999 messagerie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2069
tFTPFileList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2000 tREST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2071
Proprits du tFTPFileList . . . . . . . . . . . . 2000 Proprits du tREST . . . . . . . . . . . . . . . . . . . 2071
Scnario : Itration sur un rpertoire Scnario : Crer et rcuprer des
distant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2001 donnes en invoquant un service
tFTPFileProperties . . . . . . . . . . . . . . . . . . . . . . . . . . . 2006 Web REST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2072
Proprits du tFTPFileProperties . . . . . . 2006 tRSSInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2075
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2008 Proprits du tRSSInput . . . . . . . . . . . . . . . 2075
tFTPGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2009 Scnario : Rcuprer les billets
Proprits du tFTPGet . . . . . . . . . . . . . . . . . 2009 frquemment mis jour sur un blog . . . 2076
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2011 tRSSOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2078
tFTPPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2012 Proprits du tRSSOutput . . . . . . . . . . . . . 2078
Proprits du tFTPPut . . . . . . . . . . . . . . . . . 2012 Scnario 1 : Crer un flux RSS et
Scnario : Copier des fichiers sur un stocker les fichiers sur un serveur
serveur FTP distant . . . . . . . . . . . . . . . . . . . . 2014 FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2079
tFTPRename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2017 Scnario 2 : Crer un flux RSS
Proprits du tFTPRename . . . . . . . . . . . . 2017 contenant des mtadonnes . . . . . . . . . . . . 2083

Guide de rfrence des Composants de Talend Open Studio xvii


Composants Talend Open Studio

Scnario 3 : Crer un fichier XML de Proprits du tXMLRPCInput . . . . . . . . . 2144


flux ATOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2085 Scnario : Chercher le nom d'un Etat
tSCPClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2089 via une mthode XMLRPC . . . . . . . . . . . . 2145
Proprits du tSCPClose . . . . . . . . . . . . . . 2089 Composants Logs & Errors ................ 2147
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2089 tAssert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2148
tSCPConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2090 Proprits du tAssert . . . . . . . . . . . . . . . . . . 2148
Proprits du tSCPConnection . . . . . . . . 2090 Scnario 1: Obtenir le statut
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 2090 des commandes d'un produit
tSCPDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2091 (quotidiennement) par rapport un
Proprits du tSCPDelete . . . . . . . . . . . . . . 2091 nombre fixe . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2148
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2091 Scnario 2 : Paramtrer une
tSCPFileExists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2092 condition assertive pour l'excution
Proprits du tSCPFileExists . . . . . . . . . . 2092 d'un Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2152
Grer un fichier en utilisant SCP . . . . . . 2092 tAssertCatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2158
tSCPFileList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2098 Proprits du tAssertCatcher . . . . . . . . . . 2158
Proprits du tSCPFileList . . . . . . . . . . . . 2098 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2159
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2099 tChronometerStart . . . . . . . . . . . . . . . . . . . . . . . . . . . 2160
tSCPGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2100 Proprits du tChronometerStart . . . . . . 2160
Proprits du tSCPGet . . . . . . . . . . . . . . . . . 2100 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2160
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2100 tChronometerStop . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2161
tSCPPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2101 Proprits du tChronometerStop . . . . . . 2161
Proprits du tSCPPut . . . . . . . . . . . . . . . . . 2101 Scnario : Mesurer la dure de
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2101 traitement d'un sous-Job ou d'une
tSCPRename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2102 partie d'un sous-Job . . . . . . . . . . . . . . . . . . . . 2162
Proprits du tSCPRename . . . . . . . . . . . . 2102 tDie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2166
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2102 Proprits du tDie . . . . . . . . . . . . . . . . . . . . . 2166
tSCPTruncate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2103 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 2166
Proprits du tSCPTruncate . . . . . . . . . . . 2103 tFlowMeter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2168
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2103 Proprits du tFlowMeter . . . . . . . . . . . . . 2168
tSendMail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2104 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2168
Proprits du tSendMail . . . . . . . . . . . . . . . 2104 tFlowMeterCatcher . . . . . . . . . . . . . . . . . . . . . . . . . . 2169
Scnario : Envoyer un e-mail lors Proprits du tFlowMeterCatcher . . . . . 2169
d'une erreur . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2105 Scnario : Mesurer le flux d'un Job . . . . 2170
tSetKerberosConfiguration . . . . . . . . . . . . . . . . . . 2109 tLogCatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2174
Proprits du Proprits du tLogCatcher . . . . . . . . . . . . . 2174
tSetKerberosConfiguration . . . . . . . . . . . . 2109 Scnario 1 : Avertissement & log
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2109 lors de la cration d'entres . . . . . . . . . . . . 2174
tSetKeystore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2110 Scnario 2 : Monitorer & arrter un
Proprits du tSetKeystore . . . . . . . . . . . . 2110 Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2176
Scnario : Extraire des informations tLogRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2178
client d'un fichier WSDL priv . . . . . . . . 2111 Proprits du tLogRow . . . . . . . . . . . . . . . . 2178
tSetProxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2115 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 2180
Proprits du tSetProxy . . . . . . . . . . . . . . . 2115 tStatCatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2181
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2115 Proprits du tStatCatcher . . . . . . . . . . . . . 2181
tSocketInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2116 Scnario : Afficher les statistiques
Proprits du tSocketInput . . . . . . . . . . . . 2116 d'excution du Job . . . . . . . . . . . . . . . . . . . . . 2182
Scnario : Transfrer des donnes tWarn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2185
vers un port d'coute . . . . . . . . . . . . . . . . . . 2117 Proprits du tWarn . . . . . . . . . . . . . . . . . . . 2185
tSocketOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2120 Scnarios associs . . . . . . . . . . . . . . . . . . . . . 2185
Proprits du tSocketOutput . . . . . . . . . . . 2120
Composants Misc .............................. 2187
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2121
tAddLocationFromIP . . . . . . . . . . . . . . . . . . . . . . . . 2188
tSOAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2122
Proprits du tAddLocationFromIP . . . 2188
Proprits du tSOAP . . . . . . . . . . . . . . . . . . 2122
Scnario : Identifier la localisation
Scnario : Rcuprer le nom d'un
gographique d'une adresse IP . . . . . . . . . 2189
pays en utilisant un Service Web . . . . . . 2124
tBufferInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2191
Scnario 2 : Utiliser un message
Proprits du tBufferInput . . . . . . . . . . . . . 2191
SOAP depuis un fichier XML pour
Scnario : Rcuprer les donnes
obtenir le nom d'un pays et le
mises en mmoire tampon . . . . . . . . . . . . . 2192
sauvegarder dans un fichier XML . . . . . 2125
tBufferOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2194
tSVNLogInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2129
Proprits du tBufferOutput . . . . . . . . . . . 2194
Proprits du tSVNLogInput . . . . . . . . . . 2129
Scnario 1 : Mettre des donnes en
Scnario : Rcuprer un message de
mmoire tampon . . . . . . . . . . . . . . . . . . . . . . . 2195
log depuis un rfrentiel SVN . . . . . . . . . 2130
Scnario 2 : Mettre les donnes de
tWebService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2132
sortie en mmoire tampon du serveur
Proprits du tWebService . . . . . . . . . . . . 2132
d'application Web . . . . . . . . . . . . . . . . . . . . . . 2197
Scnario : Obtenir des noms de pays
tContextDump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2205
laide dun service Web . . . . . . . . . . . . . 2134
Proprits du tContextDump . . . . . . . . . . 2205
tWebServiceInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2140
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2205
Proprits du tWebServiceInput . . . . . . . 2140
tContextLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2206
Scnario : Obtenir des noms de pays
Proprits du tContextLoad . . . . . . . . . . . 2206
laide dun Webservice . . . . . . . . . . . . . . 2142
Scnario : Lire des donnes partir
tXMLRPCInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2144
de diffrentes bases de donnes

xviii Guide de rfrence des Composants de Talend Open Studio


Composants Talend Open Studio

MySQL l'aide de paramtres de Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2273


connexion chargs dynamiquement . . . 2207 tWaitForSqlData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2274
tFixedFlowInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2214 Proprit du tWaitForSqlData . . . . . . . . . 2274
Proprits du tFixedFlowInput . . . . . . . . 2214 Scnario : Attendre l'ajout de lignes
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 2215 dans une table . . . . . . . . . . . . . . . . . . . . . . . . . 2275
tMemorizeRows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2216 Composants Processing ...................... 2279
Proprits du tMemorizeRows . . . . . . . . 2216 tAggregateRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2280
Scnario : Compter le nombre Proprits du tAggregateRow . . . . . . . . . 2280
d'occurrences de diffrents ges . . . . . . . 2217 Scnario : Agrger des valeurs et
tMsgBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2222 trier des donnes . . . . . . . . . . . . . . . . . . . . . . . 2282
Proprits du tMsgBox . . . . . . . . . . . . . . . . 2222 tAggregateSortedRow . . . . . . . . . . . . . . . . . . . . . . . . 2285
Scnario : Test de type Hello Proprits du tAggregateSortedRow . . 2285
world!' . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2222 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2286
tRowGenerator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2224 tConvertType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287
Proprits du tRowGenerator . . . . . . . . . . 2224 Proprits du tConvertType . . . . . . . . . . . 2287
Scnario : Gnration alatoire de Scnario 1 : Convertir des types de
fichiers de test . . . . . . . . . . . . . . . . . . . . . . . . . 2226 donnes Java . . . . . . . . . . . . . . . . . . . . . . . . . . . 2288
tServerAlive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2229 Scnario 2 : Convertir des types Java
Proprits du tServerAlive . . . . . . . . . . . . 2229 l'aide de composants Map/Reduce . . . 2292
Scnario : Valider le statut de la tDenormalize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2301
connexion un hte distant . . . . . . . . . . . 2229 Proprits du tDenormalize . . . . . . . . . . . . 2301
Composants Orchestration ................. 2233 Scnario 1 : Dnormaliser une
tFileList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2234 colonne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2302
tFlowToIterate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2235 Scnario 2 : Dnormaliser plusieurs
Proprits du tFlowToIterate . . . . . . . . . . 2235 colonnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2303
Scnario : Transformer un flux de tDenormalizeSortedRow . . . . . . . . . . . . . . . . . . . . . 2306
donnes en liste . . . . . . . . . . . . . . . . . . . . . . . . 2236 Proprits du
tForeach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2240 tDenormalizeSortedRow . . . . . . . . . . . . . . . 2306
Proprits du tForeach . . . . . . . . . . . . . . . . . 2240 Scnario : Regrouper des lignes
Scnario : Faire une boucle sur une tries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2307
liste et rcuprer les valeurs . . . . . . . . . . . 2240 tExternalSortRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2310
tInfiniteLoop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2243 Proprits du tExternalSortRow . . . . . . . 2310
Proprits du tInfiniteLoop . . . . . . . . . . . . 2243 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2311
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2243 tExtractDelimitedFields . . . . . . . . . . . . . . . . . . . . . . 2312
tIterateToFlow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2244 Proprits du
Proprits du tIterateToFlow . . . . . . . . . . 2244 tExtractDelimitedFields . . . . . . . . . . . . . . . 2312
Scnario : Transformer une liste de Le tExtractDelimitedFields dans des
fichiers en flux de donnes . . . . . . . . . . . . 2245 Jobs Map/Reduce Talend . . . . . . . . . . . . . . 2313
tLoop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2247 Scnario : Extraire des champs
Proprits du tLoop . . . . . . . . . . . . . . . . . . . . 2247 partir d'un fichier dlimit par des
Scnario : Excuter un Job partir virgules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2315
d'une boucle . . . . . . . . . . . . . . . . . . . . . . . . . . . 2248 tExtractEBCDICFields . . . . . . . . . . . . . . . . . . . . . . 2319
tPostjob . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2251 Proprits du tExtractEBCDICFields . 2319
Proprits du tPostjob . . . . . . . . . . . . . . . . . 2251 Scnario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2320
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2251 tExtractJSONFields . . . . . . . . . . . . . . . . . . . . . . . . . . 2321
tPrejob . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2252 Proprits du tExtractJSONFields . . . . . 2321
Proprits du tPrejob . . . . . . . . . . . . . . . . . . 2252 Scnario : Rcuprer les messages
Scnario : Grer des fichiers avant et d'erreur lors de l'extraction de
aprs l'excution d'un Job . . . . . . . . . . . . . 2252 donnes de champs JSON . . . . . . . . . . . . . 2323
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2255 Scnario 2 : Collecter des donnes de
tReplicate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2256 votre rseau social favori . . . . . . . . . . . . . . 2329
Proprits du tReplicate . . . . . . . . . . . . . . . 2256 tExtractPositionalFields . . . . . . . . . . . . . . . . . . . . . 2333
Scnario : Rpliquer un flux et trier Proprits du
deux flux identiques . . . . . . . . . . . . . . . . . . . 2257 tExtractPositionalFields . . . . . . . . . . . . . . . 2333
tRunJob . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2262 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2335
tUnite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2263 tExtractRegexFields . . . . . . . . . . . . . . . . . . . . . . . . . . 2336
Proprits du tUnite . . . . . . . . . . . . . . . . . . . 2263 Proprits du tExtractRegexFields . . . . 2336
Scnario : Itration sur des fichiers et Scnario : Extraire des noms, des
fusion de contenu . . . . . . . . . . . . . . . . . . . . . . 2264 domaines et domaines de premier
tSleep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2267 niveau partir d'adresses e-mail . . . . . . . 2338
Proprits du tSleep . . . . . . . . . . . . . . . . . . . 2267 tExtractXMLField . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2341
Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2267 tFilterColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2342
tWaitForFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2268 Proprits du tFilterColumns . . . . . . . . . . 2342
Proprits du tWaitForFile . . . . . . . . . . . . 2268 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2343
Scnario 1 : Attendre la cration d'un tFilterRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2344
fichier et arrter l'itration aprs le Proprits du tFilterRow . . . . . . . . . . . . . . 2344
dclenchement d'un message . . . . . . . . . . 2269 Scnario 1 : Filtrer une liste de noms
Scnario 2 : Attendre la cration d'un l'aide de conditions simples . . . . . . . . . . 2346
fichier et poursuivre l'itration aprs Scnario 2 : Filtrer une liste de noms
le dclenchement d'un message . . . . . . . 2271 via diffrentes oprations logiques . . . . 2349
tWaitForSocket . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2273 tJoin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2351
Proprits du tWaitForSocket . . . . . . . . . 2273 Proprits du tJoin . . . . . . . . . . . . . . . . . . . . . 2351

Guide de rfrence des Composants de Talend Open Studio xix


Composants Talend Open Studio

Scnario 1 : Faire une Proprits du tRunJob . . . . . . . . . . . . . . . . . 2470


correspondance exacte entre deux Scnario 1 : Excuter un Job fils . . . . . . 2472
colonnes et crire les donnes Scnario 2 : Excuter une liste de
rejetes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2352 Jobs fils de manire dynamique . . . . . . . 2477
tMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2357 Scnario 3 : Propager les donnes de
Proprits du tMap . . . . . . . . . . . . . . . . . . . . 2357 sortie en mmoire tampon du Job fils
Scnario 1 : Mapping simple de au Job pre . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2480
donnes avec filtre et jointure tSetEnv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485
explicite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2358 Proprits du tSetEnv . . . . . . . . . . . . . . . . . . 2485
Scnario 2 : Mapping de donnes Scnario : Modifier une variable lors
avec rejet Inner join . . . . . . . . . . . . . . . . . . . 2362 de l'excution d'un Job . . . . . . . . . . . . . . . . 2485
Scnario 3 : Mapping de jointure en tSSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489
cascade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2367 Proprits du tSSH . . . . . . . . . . . . . . . . . . . . 2489
Scnario 4 : Mapping avanc avec Scnario : Accder aux informations
filtres, jointures explicites et rejet du systme distant via SSH . . . . . . . . . . . . 2491
Inner join . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2367 tSystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2493
Scnario 5 : Mapping avanc avec Proprits du tSystem . . . . . . . . . . . . . . . . . 2493
filtres et diffrents rejets . . . . . . . . . . . . . . . 2372 Scnario : Echo Hello World!' . . . . . . . . 2495
Scnario 6 : Mapping avanc avec Composants Talend MDM ................. 2497
rechargement de la base de rfrence tMDMBulkLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2498
chaque ligne . . . . . . . . . . . . . . . . . . . . . . . . . 2375 Proprits du tMDMBulkLoad . . . . . . . . 2498
Scnario 7 : Mapping avec des tables Scnario : Charger des
de sortie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2382 enregistrements dans une entit
tNormalize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2387 mtier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2501
Proprits du tNormalize . . . . . . . . . . . . . . 2387 tMDMClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2507
Scnario 1 : Normaliser des donnes . . 2388 Proprits du tMDMClose . . . . . . . . . . . . . 2507
Scnario 2 : Normaliser des donnes Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2507
l'aide de composants Map/Reduce . . . 2391 tMDMCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2508
tReplace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2401 Proprits du tMDMCommit . . . . . . . . . . 2508
Proprits du tReplace . . . . . . . . . . . . . . . . . 2401 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2508
Scnario : Remplacement multiple et tMDMConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2509
filtrage de colonnes . . . . . . . . . . . . . . . . . . . . 2402 Proprits du tMDMConnection . . . . . . 2509
Scnario 2 : Remplacer des valeurs Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2510
et filtrer des colonnes l'aide de tMDMDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2511
composants Map/Reduce . . . . . . . . . . . . . . 2405 Proprits du tMDMDelete . . . . . . . . . . . . 2511
tSampleRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2415 Scnario : Supprimer des donnes
Proprits du tSampleRow . . . . . . . . . . . . 2415 matre d'un hub MDM . . . . . . . . . . . . . . . . . 2513
Scnario : Filtrer des lignes et des tMDMInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2520
groupes de lignes . . . . . . . . . . . . . . . . . . . . . . 2416 Proprits du tMDMInput . . . . . . . . . . . . . 2520
tSortRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2419 Scnario : Lire les donnes matre
Proprits du tSortRow . . . . . . . . . . . . . . . . 2419 d'un hub MDM . . . . . . . . . . . . . . . . . . . . . . . . 2522
Scnario : Trier des donnes . . . . . . . . . . 2420 tMDMOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2526
tSplitRow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2423 Proprits du tMDMOutput . . . . . . . . . . . 2526
Proprits du tSplitRow . . . . . . . . . . . . . . . 2423 Scnario : Ecrire des donnes matre
Scnario 1 : Sparer une ligne en dans un hub MDM . . . . . . . . . . . . . . . . . . . . 2529
plusieurs lignes . . . . . . . . . . . . . . . . . . . . . . . . 2424 tMDMReceive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2535
tWriteJSONField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2428 Proprits du tMDMReceive . . . . . . . . . . 2535
Proprits du tWriteJSONField . . . . . . . 2428 Scnario : Extraire des informations
Scnario : Ecrire des donnes plates d'un enregistrement MDM au format
dans des champs JSON . . . . . . . . . . . . . . . . 2430 XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2536
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 2434 tMDMRollback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2541
tXMLMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2435 Proprits du tMDMRollback . . . . . . . . . 2541
Proprits du tXMLMap . . . . . . . . . . . . . . 2435 Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2541
Scnario 1 : Mapper et transformer tMDMRouteRecord . . . . . . . . . . . . . . . . . . . . . . . . . . 2542
des donnes de source XML . . . . . . . . . . 2436 Proprits du tMDMRouteRecord . . . . . 2542
Scnario 2 : Crer un flux Lookup Scnario : Router un enregistrement
pour effectuer une jointure sur des vers l'Event Manager . . . . . . . . . . . . . . . . . . 2543
donnes complmentaires XML . . . . . . . 2441 tMDMSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2551
Scnario 3 : Mapper des donnes Proprits du tMDMSP . . . . . . . . . . . . . . . . 2551
l'aide d'un filtre . . . . . . . . . . . . . . . . . . . . . . . . 2446 Scnario : Excuter une procdure
Scnario 4 : Capturer les donnes stocke dans le hub MDM . . . . . . . . . . . . . 2552
rejetes par le flux Lookup et le tMDMTriggerInput . . . . . . . . . . . . . . . . . . . . . . . . . . 2557
filtre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2449 Proprits du tMDMTriggerInput . . . . . 2557
Scnario 5 : Mapper des donnes Scnario : changer des informations
l'aide d'un lment "group" . . . . . . . . . . . . 2452 concernant les vnements d'un
Scnario 6 : Classer les donnes de enregistrement MDM . . . . . . . . . . . . . . . . . . 2558
sortie avec l'lment "aggregate" . . . . . . 2456 tMDMTriggerOutput . . . . . . . . . . . . . . . . . . . . . . . . 2570
Scnario 7 : Restructurer des Proprits du tMDMTriggerOutput . . . 2570
donnes produit l'aide de diffrents Scnario associ . . . . . . . . . . . . . . . . . . . . . . . 2571
lments de boucle . . . . . . . . . . . . . . . . . . . . 2459 tMDMViewSearch . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2572
Composants System ........................... 2469 Proprits du tMDMViewSearch . . . . . . 2572
tRunJob . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2470

xx Guide de rfrence des Composants de Talend Open Studio


Composants Talend Open Studio

Scnario : Rcuprer des


enregistrements d'un hub MDM via
une vue existante . . . . . . . . . . . . . . . . . . . . . . 2574
Composants Technical ....................... 2579
tHashInput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2580
Proprits du tHashInput . . . . . . . . . . . . . . 2580
Scnario 1 : Lire des donnes
directement dans la mmoire cache
afin d'y accder rapidement . . . . . . . . . . . 2581
Scnario 2 : Vider la mmoire avant
d'y charger les donnes si une boucle
existe dans le mme sous-job . . . . . . . . . . 2584
tHashOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2589
Proprits du tHashOutput . . . . . . . . . . . . 2589
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 2590
Composants XML ............................. 2591
tAdvancedFileOutputXML . . . . . . . . . . . . . . . . . . 2592
Proprits du
tAdvancedFileOutputXML . . . . . . . . . . . . 2592
Scnario : Crer un fichier XML
l'aide d'une boucle . . . . . . . . . . . . . . . . . . . . . 2599
tDTDValidator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2604
Proprits du tDTDValidator . . . . . . . . . . 2604
Scnario : Valider un fichier XML . . . . 2604
tEDIFACTtoXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2607
Proprits du tEDIFACTtoXML . . . . . . 2607
Scnario : Passer d'EDIFACT
XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2607
tExtractXMLField . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2610
Proprits du tExtractXMLField . . . . . . 2610
Scnario 1 : Extraire les donnes
XML d'un champ d'une table de base
de donnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611
Scnario 2 : Extraire les donnes
valides et les donnes errones
partir d'un champ XML dans fichier
dlimit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2614
tFileInputXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2618
Proprits du tFileInputXML . . . . . . . . . . 2618
Le tFileInputXML dans des Jobs
Map/Reduce Talend . . . . . . . . . . . . . . . . . . . 2620
Scnario 1 : Extraire des adresses
XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2623
Scnario 2 : Extraire les donnes
XML errones dans un flux de rejet . . . 2624
tFileOutputXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2628
Proprits de tFileOutputXML . . . . . . . . 2628
Le tFileOutputXML dans des Jobs
Map/Reduce Talend . . . . . . . . . . . . . . . . . . . 2630
Scnarios associs . . . . . . . . . . . . . . . . . . . . . 2632
tWriteXMLField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2633
Proprits du tWriteXMLField . . . . . . . . 2633
Scnario : Extraire la structure d'un
fichier XML et l'insrer dans les
champs d'une base de donnes . . . . . . . . 2635
tXMLMap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2639
tXSDValidator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2640
Proprits du tXSDValidator . . . . . . . . . . 2640
Scnario : Valider des flux de
donnes par rapport un fichier
XSD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2641
tXSLT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2644
Proprits du tXSLT . . . . . . . . . . . . . . . . . . . 2644
Scnario : Transformer un fichier
XML en HTML l'aide d'une feuille
de style XSL . . . . . . . . . . . . . . . . . . . . . . . . . . . 2645

Guide de rfrence des Composants de Talend Open Studio xxi


Guide de rfrence des Composants de Talend Open Studio
Prface

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 [gras] : titre des fentres, assistants et botes de dialogue ;

texte en courier : paramtres systme renseigns par l'utilisateur ;

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.

Guide de rfrence des Composants de Talend Open Studio


Remarques et Support

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

xxiv Guide de rfrence des Composants de Talend Open Studio


Composants Big Data
Ce chapitre passe en revue les principaux composants prsents dans la famille Big Data de la Palette.

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

Guide de rfrence des Composants de Talend Open Studio


tGSBucketCreate

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.

Ces cls peuvent tre consultes dans la vue Interoperable Access,


sous l'onglet Google Cloud Storage du projet dans la console d'API de
Google.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.

Pour plus d'informations sur la cl d'accs et la cl secrte,


rendez-vous sur https://developers.google.com/storage/docs/reference/
v1/getting-startedv1?hl=en/ (en anglais) et consultez la description des
cls dveloppeur.

Les champs Access Key et Secret Key ne sont disponibles que


si la case Use an existing connection n'est pas coche.
Bucket configuration Bucket name Spcifiez le nom du bucket que vous souhaitez crer. Notez que le nom
du bucket doit tre unique au sein du systme Google Cloud Storage.

Pour plus d'informations sur les conventions de nommage


des buckets, consultez https://developers.google.com/storage/docs/
bucketnaming (en anglais).
Special configure Cochez cette case afin de fournir une configuration supplmentaire au
bucket crer.
Project ID Spcifiez l'identifiant du projet auquel le nouveau bucket appartient.
Location Slectionnez dans la liste l'emplacement du nouveau bucket.
Actuellement, Europe et US sont disponibles. Par dfaut,
l'emplacement du bucket est US.

Notez qu'une fois le bucket cr un emplacement spcifique, il ne peut


tre dplac vers un nouvel emplacement.
Acl Dans la liste, slectionnez la liste de contrle d'accs (ACL) souhaite
pour le nouveau bucket.

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.

Pour plus d'informations sur les ACL, consultez https://


developers.google.com/storage/docs/accesscontrol?hl=en (en anglais).
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.

2 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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 .

Guide de rfrence des Composants de Talend Open Studio 3


tGSBucketDelete

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.

Ces cls peuvent tre consultes dans la vue Interoperable Access,


sous l'onglet Google Cloud Storage du projet dans la console d'API de
Google.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.

Pour plus d'informations sur la cl d'accs et la cl secrte,


rendez-vous sur https://developers.google.com/storage/docs/reference/
v1/getting-startedv1?hl=en/ (en anglais) et consultez la description des
cls dveloppeur.

Les champs Access Key et Secret Key ne sont disponibles que


si la case Use an existing connection n'est pas coche.
Bucket name Spcifiez le nom du bucket que vous souhaitez supprimer. Assurez-vous
que le bucket supprimer est vide.

La suppression du bucket ne peut tre annule. Vous devez


donc vous assurer d'avoir sauvegard toutes les donnes que
vous souhaitez garder avant de continuer.
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, 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 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.

4 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Pour plus d'informations sur les niveaux 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.

Guide de rfrence des Composants de Talend Open Studio 5


tGSBucketExist

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.

Ces cls peuvent tre consultes dans la vue Interoperable Access,


sous l'onglet Google Cloud Storage du projet dans la console d'API de
Google.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.

Pour plus d'informations sur la cl d'accs et la cl secrte,


rendez-vous sur https://developers.google.com/storage/docs/reference/
v1/getting-startedv1?hl=en/ (en anglais) et consultez la description des
cls dveloppeur.

Les champs Access Key et Secret Key ne sont disponibles que


si la case Use an existing connection n'est pas coche.
Bucket name Spcifiez le nom du bucket dont vous souhaitez vrifier l'existence dans
Google Cloud Storage.
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, aussi bien au niveau
du Job qu'au niveau de chaque composant.
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 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.

6 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Pour plus d'informations sur les niveaux 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 .

Guide de rfrence des Composants de Talend Open Studio 7


tGSBucketList

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.

Ces cls peuvent tre consultes dans la vue Interoperable Access,


sous l'onglet Google Cloud Storage du projet dans la console d'API de
Google.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.

Pour plus d'informations sur la cl d'accs et la cl secrte,


rendez-vous sur https://developers.google.com/storage/docs/reference/
v1/getting-startedv1?hl=en/ (en anglais) et consultez la description des
cls dveloppeur.

Les champs Access Key et Secret Key ne sont disponibles que


si la case Use an existing connection n'est pas coche.
Specify project ID Cochez cette case et, dans le champ Project ID, spcifiez l'identifiant
du projet dont vous voulez rcuprer la liste des buckets.
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 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 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.

8 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Pour plus d'informations sur les niveaux 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 .

Guide de rfrence des Composants de Talend Open Studio 9


tGSClose

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.

10 Guide de rfrence des Composants de Talend Open Studio


tGSConnection

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.

Ces cls peuvent tre consultes dans la vue Interoperable Access,


sous l'onglet Google Cloud Storage du projet dans la console d'API de
Google.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.

Pour plus d'informations sur la cl d'accs et la cl secrte,


rendez-vous sur https://developers.google.com/storage/docs/reference/
v1/getting-startedv1?hl=en/ (en anglais) et consultez la description des
cls dveloppeur.
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
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.

Guide de rfrence des Composants de Talend Open Studio 11


tGSCopy

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.

Ces cls peuvent tre consultes dans la vue Interoperable Access,


sous l'onglet Google Cloud Storage du projet dans la console d'API de
Google.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.

Pour plus d'informations sur la cl d'accs et la cl secrte,


rendez-vous sur https://developers.google.com/storage/docs/reference/
v1/getting-startedv1?hl=en/ (en anglais) et consultez la description des
cls dveloppeur.

Les champs Access Key et Secret Key ne sont disponibles que


si la case Use an existing connection n'est pas coche.
Source bucket name Saisissez le nom du bucket partir duquel vous souhaitez copier ou
dplacer des objets.
Source object key Saisissez la cl de l'objet copier.
Source is folder Cochez cette case si l'objet source est un dossier.
Target bucket name Saisissez le nom du bucket vers lequel vous souhaitez copier ou dplacer
des objets.
Target folder Saisissez le dossier cible vers lequel les objets sont copis ou dplacs.
Action Slectionnez l'action que vous souhaitez effectuer sur les objets de la
liste.

Copy : copie les objets depuis le bucket ou le dossier source vers le


bucket ou dossier cible.

Move : dplace les objets depuis le bucket ou dossier source vers le


bucket ou dossier cible.
Rename Cochez cette case et, dans le champ New name, saisissez un nouveau
nom pour l'objet copier ou dplacer.

La case Rename n'est pas disponible si vous cochez la case


Source is folder.
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.

12 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 13


tGSDelete

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.

Ces cls peuvent tre consultes dans la vue Interoperable Access,


sous l'onglet Google Cloud Storage du projet dans la console d'API de
Google.

Pour plus d'informations sur la cl d'accs et la cl secrte,


rendez-vous sur https://developers.google.com/storage/docs/reference/
v1/getting-startedv1?hl=en/ (en anglais) et consultez la description des
cls dveloppeur.

Les champs Access Key et Secret Key ne sont disponibles que


si la case Use an existing connection n'est pas coche.
Key prefix Saisissez le prfixe de la cl des objets supprimer. Ainsi, seuls les
objets dont la cl commence par ce prfixe sont lists.
Delimiter Saisissez le sparateur afin de supprimer uniquement les objets avec des
noms jusqu' ce sparateur.
Specify project ID Cochez cette case et, dans le champ Project ID, saisissez l'identification
du projet dont vous voulez supprimer des objets.
Delete object from bucket list Cochez cette case et renseignez la table Bucket pour supprimer des
objets dans les buckets spcifis.

Bucket name : saisissez le nom du bucket dans lequel vous souhaitez


supprimer les objets.

Key prefix : saisissez le prfixe pour supprimer les objets dont les
cls commencent par la chane dfinie dans le bucket spcifi.

Delimiter : saisissez le sparateur afin de lister uniquement les objets


avec des noms jusqu' ce sparateur.

Si vous cochez la case Delete object from bucket list, les


champs Key prefix et Delimiter, ainsi que la case Specify
project ID ne sont pas disponibles.
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.

14 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 15


tGSGet

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.

Ces cls peuvent tre consultes dans la vue Interoperable Access,


sous l'onglet Google Cloud Storage du projet dans la console d'API de
Google.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.

Pour plus d'informations sur la cl d'accs et la cl secrte,


rendez-vous sur https://developers.google.com/storage/docs/reference/
v1/getting-startedv1?hl=en/ (en anglais) et consultez la description des
cls dveloppeur.

Les champs Access Key et Secret Key ne sont disponibles que


si la case Use an existing connection n'est pas coche.
Key prefix Saisissez le prfixe afin de tlcharger uniquement les objets dont les
cls commencent par le prfixe dfini.
Delimiter Saisissez le sparateur afin de tlcharger uniquement les objets avec
des noms jusqu' ce sparateur.
Specify project ID Cochez cette case et, dans le champ Project ID, saisissez l'identification
du projet dont vous voulez obtenir des objets.
Use keys Cochez cette case et renseignez la table Keys afin de dfinir les critres
pour les objets tlcharger depuis Google Cloud Storage.

Bucket name : saisissez le nom du bucket partir duquel vous


souhaitez tlcharger des objets.

Key : saisissez la cl de l'objet tlcharger.

New name : saisissez un nouveau nom pour l'objet tlcharger.

Si vous cochez la case Use keys, les champs Key prefix et


Delimiter, ainsi que les cases Specify project ID et Get files
from bucket list ne sont pas disponibles.
Get files from bucket list Cochez cette case et renseignez la table Bucket afin de dfinir les
critres pour les objets tlcharger depuis Google Cloud Storage.

Bucket name : saisissez le nom du bucket partir duquel vous


souhaitez tlcharger des objets.

Key prefix : saisissez le prfixe pour tlcharger des objets dont les
cls commencent par le prfixe spcifi dans le bucket dfini.

16 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Delimiter : saisissez le sparateur afin de tlcharger les objets avec


des noms jusqu' ce sparateur depuis 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.

Guide de rfrence des Composants de Talend Open Studio 17


tGSList

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.

Ces cls peuvent tre consultes dans la vue Interoperable Access,


sous l'onglet Google Cloud Storage du projet dans la console d'API de
Google.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.

Pour plus d'informations sur la cl d'accs et la cl secrte,


rendez-vous sur https://developers.google.com/storage/docs/reference/
v1/getting-startedv1?hl=en/ (en anglais) et consultez la description des
cls dveloppeur.

Les champs Access Key et Secret Key ne sont disponibles que


si la case Use an existing connection n'est pas coche.
Key prefix Saisissez le prfixe de la cl des objets lister. Ainsi, seuls les objets
dont la cl commence par ce prfixe sont lists.
Delimiter Saisissez le sparateur afin de lister uniquement les objets avec des
noms jusqu' ce sparateur.
Specify project ID Cochez cette case et, dans le champ Project ID, saisissez l'identification
du projet dont vous voulez rcuprer la liste des objets.
List objects in bucket list Cochez cette case et renseignez la table Bucket pour rcuprer les objets
dans les buckets spcifis.

Bucket name : saisissez le nom du bucket partir duquel vous


souhaitez rcuprer les objets.

Key prefix : saisissez le prfixe pour lister uniquement les objets dont
les cls commencent par la chane dfinie dans le bucket spcifi.

Delimiter : saisissez le sparateur afin de lister uniquement les objets


avec des noms jusqu' ce sparateur.

Si vous cochez la case List objects in bucket list, les champs


Key prefix et Delimiter, ainsi que la case Specify project ID
ne sont pas disponibles .
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 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.

18 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 19


tGSPut

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.

Ces cls peuvent tre consultes dans la vue Interoperable Access,


sous l'onglet Google Cloud Storage du projet dans la console d'API de
Google.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.

Pour plus d'informations sur la cl d'accs et la cl secrte,


rendez-vous sur https://developers.google.com/storage/docs/reference/
v1/getting-startedv1?hl=en/ (en anglais) et consultez la description des
cls dveloppeur.

Les champs Access Key et Secret Key ne sont disponibles que


si la case Use an existing connection n'est pas coche.
Bucket name Saisissez le nom du bucket dans lequel vous souhaitez charger les
fichiers.
Local directory Saisissez le chemin d'accs complet ou parcourez votre systme vers le
dossier local contenant les fichiers charger.
Google Storage directory Saisissez le nom du dossier Google Storage dans lequel vous souhaitez
charger des fichiers.
Use files list Cochez cette case et renseignez la table Files.

Filemask : saisissez un nom ou un masque de fichier l'aide de


caractres spciaux (*) ou d'expressions rgulires.

New name: saisissez le nom donner au fichier aprs le chargement.


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.

20 Guide de rfrence des Composants de Talend Open Studio


Scnario : Grer des fichiers avec Google Cloud Storage

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez 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

Scnario : Grer des fichiers avec Google Cloud


Storage
Le scnario suivant permet de crer un Job chargeant des fichiers partir d'un rpertoire local dans un bucket dans
Google Storage. Ce Job permet ensuite d'effectuer des oprations de copie, de dplacement et de suppression sur
ces fichiers, puis de lister et afficher les fichiers dans leurs buckets respectifs dans la console.

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.

Guide de rfrence des Composants de Talend Open Studio 21


Scnario : Grer des fichiers avec Google Cloud Storage

Dposer et relier les composants


Afin de crer ce Job, procdez comme suit :

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.

5. Reliez le tGSList au tIterateToFlow l'aide d'un lien Row > Iterate.

6. Reliez le tIterateToFlow au tLogRow l'aide d'un lien Row > Main.

Configurer les composants


Ouvrir une connexion Google Cloud Storage
1. Double-cliquez sur le tGSConnection afin d'ouvrir sa vue Basic settings dans l'onglet Component.

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.

22 Guide de rfrence des Composants de Talend Open Studio


Scnario : Grer des fichiers avec Google Cloud Storage

Charger les fichiers dans Google Cloud Storage


1. Double-cliquez sur le tGSPut 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 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.

La capture d'cran suivante montre les fichiers contenus dans ce dossier :

5. Laissez les autres paramtres tels qu'ils sont.

Copier tous les fichiers d'un bucket un autre


1. Double-cliquez sur le premier tGSCopy afin d'ouvrir sa vue Basic settings dans l'onglet Component.

Guide de rfrence des Composants de Talend Open Studio 23


Scnario : Grer des fichiers avec Google Cloud Storage

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.

6. Slectionnez Copy dans la liste Action.

Dplacer un fichier d'un bucket un autre et les renommer

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.

8. Laissez les autres paramtres tels qu'ils sont.

Supprimer un fichier dans un bucket

1. Double-cliquez sur le tGSDelete, afin d'ouvrir sa vue Basic settings dans l'onglet Component.

24 Guide de rfrence des Composants de Talend Open Studio


Scnario : Grer des fichiers avec Google Cloud Storage

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.

Lister les fichiers contenus dans les trois buckets

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.

Guide de rfrence des Composants de Talend Open Studio 25


Scnario : Grer des fichiers avec Google Cloud Storage

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.

6. La table Mapping est automatiquement renseigne avec les colonnes dfinies.

Dans la colonne Value, saisissez globalMap.get("tGSList_2_CURRENT_BUCKET") dans la ligne


bucketName et globalMap.get("tGSList_2_CURRENT_KEY") dans la ligne key, respectivement. Vous
pouvez galement appuyer sur Ctrl + Espace puis choisir les variables appropries.

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.

Fermer la connexion Google Cloud Storage


1. Double-cliquez sur le tGSClose afin d'ouvrir sa vue Basic settings dans l'onglet Component.

2. Dans la liste Component List, slectionnez la connexion que vous souhaitez fermer.

Sauvegarder et excuter le Job


1. Appuyez sur Ctrl+S pour sauvegarder le Job.

2. Appuyez sur F6 ou cliquez sur Run dans l'onglet Run afin d'excuter le Job.

26 Guide de rfrence des Composants de Talend Open Studio


Scnario : Grer des fichiers avec Google Cloud Storage

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.

Guide de rfrence des Composants de Talend Open Studio 27


tHiveClose

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.

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

28 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 29


tHiveConnection

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.

Si disponible dans la liste de Distribution, l'option Microsoft HD


Insight vous permet d'utiliser un cluster Microsoft HD Insight.
Dans cette optique, vous devez configurez les connexions aux
services WebHCat, HD Insight et Windows Azure Storage du
cluster dans les zones affiches. Une vido dmontrant comment
configurer cette connexion est disponible l'adresse suivante :
https://www.youtube.com/watch?v=A3QTT6VsNoM.

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 :

30 Guide de rfrence des Composants de Talend Open Studio


Proprits du tHiveConnection

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 de ce composant, 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.
Connection mode Slectionnez un mode de connexion dans la liste. Les options varient
selon la distribution que vous utilisez.
Hive server Slectionnez le serveur Hive sur lequel vous souhaitez que le Job
utilisant ce composant excute des requtes dans Hive.

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).

Pour plus d'informations concernant HiveServer2, consultez la


page https://cwiki.apache.org/confluence/display/Hive/Setting+Up
+HiveServer2 (en anglais).
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.

Ce champ n'est pas disponible lorsque vous slectionnez


Embedded dans la liste Connection mode.
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.
Authentication Use kerberos authentication Si vous accdez au Metastore de Hive avec une scurit Kerberos,
cochez cette case et saisissez ensuite les paramtres appropris dans
les champs qui s'affichent.

Les valeurs des paramtres suivants peuvent tre trouves dans le


fichier hive-site.xml du systme Hive utilis.

1. Hive principal utilise la valeur de


hive.metastore.kerberos.principal. C'est le principal du service du
Metastore de Hive.

2. Metastore URL utilise la valeur de


javax.jdo.option.ConnectionURL. C'est la chane JDBC de
connexion au Metastore de Hive.

3. Driver class utilise la valeur de


javax.jdo.option.ConnectionDriverName. C'est le nom du pilote
de la connexion JDBC.

Guide de rfrence des Composants de Talend Open Studio 31


Proprits du tHiveConnection

4. Username utilise la valeur de


javax.jdo.option.ConnectionUserName. Ce paramtre, ainsi que
le paramtre Password, sont utiliss pour les informations de
connexion de l'utilisateur au Metastore de Hive.

5. Password utilise la valeur de


javax.jdo.option.ConnectionPassword.

Cette case est disponible ou indisponible selon la distribution


d'Hadoop laquelle vous vous connectez.
Use a keytab to authenticate Cochez la case Use a keytab to authenticate pour vous connecter
un systme Hadoop 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.
Use SSL encryption Cochez cette case pour activer la connexion crypte SSL.

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 :

Hortonworks Data Platform 2.0 +

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).

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) :

32 Guide de rfrence des Composants de Talend Open Studio


Proprits du tHiveConnection

1. Cochez la case Set resourcemanager scheduler address et


saisissez l'adresse de l'ordonnanceur (Scheduler) dans le champ
qui apparat.

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.

3. 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.

4. 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.

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.

6. Cochez la case Use datanode hostname pour permettre au Job


d'accder aux nuds de donnes via leurs noms d'hte. Cela
dfinit la proprit dfs.client.use.datanode.hostname en true.

Pour plus d'informations concernant le framework Hadoop Map/


Reduce, consultez le tutoriel Map/Reduce dans la documentation de
Apache Hadoop : http://hadoop.apache.org (en anglais).
Set NameNode URI Cochez cette case pour indiquer l'emplacement du NameNode du
cluster Hadoop utiliser. Le NameNode est le nud matre d'un
systme Hadoop. Par exemple, si vous avez slectionn une machine
nomme masternode comme NameNode d'une distribution Apache
Hadoop, son emplacement est hdfs://masternode:portnumber.

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

Pour plus d'informations concernant le framework Hadoop Map/


Reduce, consultez le tutoriel Map/Reduce dans la documentation de
Apache Hadoop : http://hadoop.apache.org (en anglais).
Microsoft HD Insight properties WebHCat configuration Saisissez l'adresse et les informations d'authentification du service
WebHCat du cluster Microsoft HD Insight utiliser. Le studio utilise
ce service pour soumettre le Job au cluster HD Insight.

Dans le champ Job result folder, saisissez l'emplacement o


vous souhaitez stocker les rsultats d'excution du Job dans Azure
Storage.
HDInsight configuration Saisissez les informations d'authentification information du cluster
HD Insight utiliser.
Windows Azure Storage Saisissez l'adresse et les informations d'authentification du compte
configuration Azure Storage utiliser.

Dans le champ Container, saisissez le nom du conteneur utiliser.

Dans le champ Deployment Blob, saisissez l'emplacement o vous


souhaitez stocker le Job et ses bibliothques dpendantes dans le
compte Azure Storage.
Use or register a shared DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion mise en partage dans un Job pre ou un Job fils. Cette
option vous permet de partager une seule connexion une base de

Guide de rfrence des Composants de Talend Open Studio 33


Proprits du tHiveConnection

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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
HBase Configuration Store by HBase Cochez cette case afin d'afficher les paramtres configurer pour
permettre aux composants Hive d'accder aux tables HBase :

Une fois l'accs configur, vous pourrez utiliser, dans un


tHiveRow et un tHiveInput, les instructions Hive QL permettant
de lire et d'crire des donnes dans HBase.

Si vous utilisez l'authentification Kerberos, vous devez dfinir les


principaux relatifs HBase dans les champs correspondants qui
sont affichs.

Pour plus d'informations propos de cet accs concernant Hive


et HBase, consultez la documentation de Apache Hive concernant
l'intgration Hive/HBase.
Zookeeper quorum Saisissez le nom ou l'URL du service Zookeeper utilis pour
coordonner les transactions entre Talend et HBase. Notez que,
lorsque vous configurez Zookeeper, vous pouvez avoir besoin de
configurer la proprit zookeeper.znode.parent pour dfinir la
racine du chemin relatif d'un fichier HBase Zookeeper puis de
slectionner la case Set Zookeeper znode parent afin de dfinir
cette proprit.
Zookeeper client port Saisissez le numro du port d'coute client du service Zookeeper que
vous utilisez.
Define the jars to register for Cochez cette case pour afficher la table Register jar for HBase,
HBase dans laquelle vous pouvez enregistrer tout fichier Jar manquant,
requis pour HBase, par exemple, Hive 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 Hadoop properties Le Studio Talend utilise une configuration par dfaut pour son
moteur, afin d'effectuer 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:

Gnralement, les proprits relatives HDFS


peuvent tre trouves dans le fichier hdfs-default.xml

34 Guide de rfrence des Composants de Talend Open Studio


Proprits du tHiveConnection

correspondant votre distribution, comme par


exemple http://hadoop.apache.org/docs/r2.6.0/hadoop-project-
dist/hadoop-hdfs/hdfs-default.xml (en anglais).

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 map memory Si le systme Hadoop utilis est Hortonworks Data Platform V1.2 ou
mb et Mapred job reduce Hortonworks Data Platform V1.3, vous devez dfinir des allocations
memory mb 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.
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

Guide de rfrence des Composants de Talend Open Studio 35


Connexion une distribution Hadoop personnalise

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).

Connexion une distribution Hadoop personnalise


Comme expliqu dans le tableau des proprits, lorsque vous slectionnez l'option Custom dans la liste droulante
Distribution, vous pouvez vous connectez une distribution qui n'est pas dans la liste Distribution.

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.

36 Guide de rfrence des Composants de Talend Open Studio


Connexion une distribution Hadoop personnalise

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.

La bote de dialogue [Custom Hadoop version definition] devient active.

Guide de rfrence des Composants de Talend Open Studio 37


Connexion une distribution Hadoop personnalise

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].

5. Slectionnez l'option External libraries pour ouvrir sa vue.

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]

en cliquant sur le bouton .

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.

38 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer une table Hive partitionne

Si la distribution Hadoop personnalise laquelle vous souhaitez vous connecter contient YARN, cochez la case
Use YARN ct de la liste Distribution.

Scnario : Crer une table Hive partitionne


Ce scnario explique comment utiliser un composant tHiveConnection, un composant tHiveCreateTable et un
tHiveLoad afin de crer une table Hive partitionne et d'y crire des donnes.

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.

Procdez comme suit :

Guide de rfrence des Composants de Talend Open Studio 39


Scnario : Crer une table Hive partitionne

Relier les composants


1. Dans la perspective Integration du studio, crez un Job vide depuis le nud Job Designs du Repository.

Pour plus d'informations concernant la cration de Jobs, consultez le chapitre relatif dans le Guide utilisateur
du Studio Talend.

2. Dposez un tHiveConnection, un tHiveCreateTable et un tHiveLoad dans l'espace de modlisation


graphique.

3. Reliez-les l'aide de liens Trigger > OnSubjobOk.

Configurer la connexion Hive

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.

40 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer une table Hive partitionne

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).

Crer la table Hive

Dfinir le schma

1. Double-cliquez sur le tHiveCreateTable pour ouvrir sa vue Component.

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.

Guide de rfrence des Composants de Talend Open Studio 41


Scnario : Crer une table Hive partitionne

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.

8. Cliquez sur OK pour valider ces modifications.

Configurer les paramtres de la table


1. Dans le champ Table name, saisissez le nom de la table Hive crer. Dans ce scnario, saisissez employees.

2. Dans la liste Action on table, slectionnez Create table if not exists.

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.

Ecrire des donnes dans la table


Configurer le tHiveLoad
1. Double-cliquez sur le tHiveLoad pour ouvrir sa vue Component.

42 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer une table Hive partitionne

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.

6. Dans la liste Action on file, slectionnez APPEND.

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.

Guide de rfrence des Composants de Talend Open Studio 43


Scnario : Crer une table Hive partitionne

Si vous souhaitez plus d'informations concernant le Job, il est recommand d'utiliser la console Web du JobTracker
fournie par votre distribution Hadoop.

44 Guide de rfrence des Composants de Talend Open Studio


tHiveRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.

Si disponible dans la liste de Distribution, l'option Microsoft HD Insight vous


permet d'utiliser un cluster Microsoft HD Insight. Dans cette optique, vous devez
configurez les connexions aux services WebHCat, HD Insight et Windows Azure
Storage du cluster dans les zones affiches. Une vido dmontrant comment configurer
cette connexion est disponible l'adresse suivante : https://www.youtube.com/watch?
v=A3QTT6VsNoM.

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,

Guide de rfrence des Composants de Talend Open Studio 45


Proprits du tHiveRow

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 :

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 de ce
composant, 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.
Connection Connection Slectionnez un mode de connexion dans la liste. Les options varient selon la distribution
mode que vous utilisez.
Hive server Slectionnez le serveur Hive sur lequel vous souhaitez que le Job utilisant ce composant
excute des requtes dans Hive.

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).

Pour plus d'informations concernant HiveServer2, consultez la page https://


cwiki.apache.org/confluence/display/Hive/Setting+Up+HiveServer2 (en anglais).
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur.
Database Nom de la base de donnes.

Ce champ n'est pas disponible lorsque vous slectionnez Embedded dans la


liste Connection mode.
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.
Authentication Use kerberos Si vous accdez au Metastore de Hive avec une scurit Kerberos, cochez cette case et
authentication saisissez ensuite les paramtres appropris dans les champs qui s'affichent.

Les valeurs des paramtres suivants peuvent tre trouves dans le fichier hive-site.xml
du systme Hive utilis.

1. Hive principal utilise la valeur de hive.metastore.kerberos.principal. C'est le


principal du service du Metastore de Hive.

2. Metastore URL utilise la valeur de javax.jdo.option.ConnectionURL. C'est la chane


JDBC de connexion au Metastore de Hive.

46 Guide de rfrence des Composants de Talend Open Studio


Proprits du tHiveRow

3. Driver class utilise la valeur de javax.jdo.option.ConnectionDriverName. C'est le


nom du pilote de la connexion JDBC.

4. Username utilise la valeur de javax.jdo.option.ConnectionUserName. Ce paramtre,


ainsi que le paramtre Password, sont utiliss pour les informations de connexion de
l'utilisateur au Metastore de Hive.

5. Password utilise la valeur de javax.jdo.option.ConnectionPassword.

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 :

Hortonworks Data Platform 2.0 +

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) :

1. Cochez la case Set resourcemanager scheduler address et saisissez l'adresse de


l'ordonnanceur (Scheduler) dans le champ qui apparat.

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.

Guide de rfrence des Composants de Talend Open Studio 47


Proprits du tHiveRow

3. 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.

4. 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.

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.

6. Cochez la case Use datanode hostname pour permettre au Job d'accder


aux nuds de donnes via leurs noms d'hte. Cela dfinit la proprit
dfs.client.use.datanode.hostname en true.

Pour plus d'informations concernant le framework Hadoop Map/Reduce, consultez


le tutoriel Map/Reduce dans la documentation de Apache Hadoop : http://
hadoop.apache.org (en anglais).
Set NameNode Cochez cette case pour indiquer l'emplacement du NameNode du cluster Hadoop
URI utiliser. Le NameNode est le nud matre d'un systme Hadoop. Par exemple, si
vous avez slectionn une machine nomme masternode comme NameNode d'une
distribution Apache Hadoop, son emplacement est hdfs://masternode:portnumber.

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

Pour plus d'informations concernant le framework Hadoop Map/Reduce, consultez


le tutoriel Map/Reduce dans la documentation de Apache Hadoop : http://
hadoop.apache.org (en anglais).
Microsoft HD Insight WebHCat Saisissez l'adresse et les informations d'authentification du service WebHCat du cluster
properties configuration Microsoft HD Insight utiliser. Le studio utilise ce service pour soumettre le Job au
cluster HD Insight.

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.

Dans le champ Deployment Blob, saisissez l'emplacement o vous souhaitez stocker le


Job et ses bibliothques dpendantes dans le compte Azure Storage.
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.

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].

48 Guide de rfrence des Composants de Talend Open Studio


Proprits du tHiveRow

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.
Table Name Nom de la table traiter.
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.
This query uses Lorsqu'elle est disponible, cochez cette case pour indiquer que la table grer utilise le
Parquet objects format Parquet et permet au composant d'appeler le fichier Jar requis.

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.

Pour plus d'informations concernant le langage de requtes Hive, consultez https://


cwiki.apache.org/confluence/display/Hive/LanguageManual (en anglais).

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).

Hadoop fournit diffrents formats de compression permettant de rduire


l'espace ncessaire au stockage des fichiers et d'acclrer le transfert de
donnes. Lorsque vous lisez un fichier compress, le Studio Talend doit le
dcompresser avant de pouvoir en alimente le flux d'entre.
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.
HBase Configuration Store by HBase Cochez cette case afin d'afficher les paramtres configurer pour permettre aux
composants Hive d'accder aux tables HBase :
Disponible
uniquement Une fois l'accs configur, vous pourrez utiliser, dans un tHiveRow et un tHiveInput,
lorsque la les instructions Hive QL permettant de lire et d'crire des donnes dans HBase.
case Use
an existing Si vous utilisez l'authentification Kerberos, vous devez dfinir les principaux relatifs
connection est HBase dans les champs correspondants qui sont affichs.
dcoche.
Pour plus d'informations propos de cet accs concernant Hive et HBase, consultez la
documentation de Apache Hive concernant l'intgration Hive/HBase.
Zookeeper Saisissez le nom ou l'URL du service Zookeeper utilis pour coordonner les transactions
quorum entre Talend et HBase. Notez que, lorsque vous configurez Zookeeper, vous pouvez
avoir besoin de configurer la proprit zookeeper.znode.parent pour dfinir la racine du
chemin relatif d'un fichier HBase Zookeeper puis de slectionner la case Set Zookeeper
znode parent afin de dfinir cette proprit.
Zookeeper Saisissez le numro du port d'coute client du service Zookeeper que vous utilisez.
client port

Guide de rfrence des Composants de Talend Open Studio 49


Proprits du tHiveRow

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:

Gnralement, les proprits relatives HDFS peuvent tre trouves


dans le fichier hdfs-default.xml correspondant votre distribution, comme
par exemple http://hadoop.apache.org/docs/r2.6.0/hadoop-project-dist/hadoop-hdfs/
hdfs-default.xml (en anglais).

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.

50 Guide de rfrence des Composants de Talend Open Studio


Proprits du tHiveRow

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).

Guide de rfrence des Composants de Talend Open Studio 51


Scnarios associs

Scnarios associs
Pour un scnario associ, consultez :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

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.

52 Guide de rfrence des Composants de Talend Open Studio


Composants Business
Ce chapitre passe en revue les principaux composants prsents dans la famille Business de la Palette dans la
perspective Integration du Studio Talend.

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.

Guide de rfrence des Composants de Talend Open Studio


tAlfrescoOutput

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.

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.
Target Location Base Saisissez le chemin d'accs de l'emplacement o stocker le
document, ou

Cochez la case Map... puis choisissez, partir de la liste


droulante Column, l'emplacement d'arrive.

Lorsque vous saisissez le nom de l'emplacement,


assurez-vous de le protger par des doubles barres
obliques inverses (\\).
Create Or Update Mode Document Mode Slectionnez, partir de la liste droulante, le mode que vous
voulez utiliser pour crer votre document.

Create only : permet de crer un document s'il n'existe pas


pralablement.

Notez cependant qu'un message d'erreur apparatra si vous


essayez de crer un document qui existe dj.

Create or update : permet de crer un document qui n'existe pas


encore ou de mettre jour un document existant.
Container Mode Slectionnez, partir de la liste droulante, le mode que vous
voulez utiliser pour le dossier de destination sur le serveur
Alfresco.

Update only : permet de mettre jour un dossier de destination


dj existant.

Notez cependant qu'un message d'erreur apparatra si vous


essayez de mettre jour un document qui n'existe pas.

Create or update : permet de crer un dossier de destination s'il


n'existe pas au pralable, ou de mettre jour un dossier existant.
Define Document Type Cliquez sur les trois points [...] pour afficher l'diteur
tAlfrescoOutput. Cet diteur vous permet :

- de slectionner le fichier dans lequel vous avez dfini les


mtadonnes pour servir de cadre lors de l'enregistrement du
document sur Alfresco

- de dfinir le type du document

54 Guide de rfrence des Composants de Talend Open Studio


Proprits du tAlfrescoOutput

- de slectionner, partir de la liste droulante available aspects,


l'un des aspects du modle, puis de cliquer sur le bouton [+] pour
ajouter cet aspect la liste de gauche.
Property Mapping Affiche les paramtres renseigns dans l'diteur
tAlfrescoOutput, selon lesquels le document sera cr sur le
serveur Alfresco.

Notez que vous pouvez modifier n'importe lequel des schmas


d'entre de la zone Property Mapping.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].
Result Log File Name Permet de parcourir le fichier dans lequel vous voulez enregistrer
les logs lis l'excution du Job.
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 settings Configure Target Location Permet de configurer le type par dfaut des conteneurs.
Container
Cochez cette case pour afficher de nouveaux champs dans
lesquels vous pouvez modifier le type du conteneur et utiliser les
types que vous avez crs sur le modle pre/fils.
Permissions Configure Permissions Lorsque cette case est coche, l'option permet de configurer
manuellement les droits d'accs aux conteneurs et aux
documents.

Cochez la case Inherit Permissions pour synchroniser les droits


d'accs entre les conteneurs et les documents.

Cliquez sur le bouton [+] pour ajouter de nouvelles lignes la


liste Permissions ; vous pourrez alors assigner des rles un
utilisateur ou groupe d'utilisateurs dans les colonnes User or
group et User or group column.
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.
Association Target Permet de crer de nouveaux documents sur Alfresco qui
Mapping contiennent des liens associs des documents dj existants sur
ce serveur, pour faciliter le processus de navigation par exemple.

Pour crer des associations :

1. Ouvrez l'diteur tAlfresco.

Guide de rfrence des Composants de Talend Open Studio 55


Proprits du tAlfrescoOutput

2. Cliquez sur le bouton Add puis slectionnez un modle


pour lequel vous avez dj dfini des aspects contenant des
associations.

3. Cliquez sur la liste droulante, en haut de la fentre de


l'diteur, et slectionnez le type de document correspondant.

4. Cliquez sur OK pour fermer l'diteur et afficher l'association


ainsi cre dans la liste Association Target Mapping.
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_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 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

Commencez par excuter les oprations suivantes :

1. Tlchargez le fichier alfresco-community-tomcat-2.1.0.zip

2. Dzippez-le dans un dossier d'installation, par exemple : C:\Program Files\Java\jdk1.6.0_27

3. Installez JDK 1.6.0+

56 Guide de rfrence des Composants de Talend Open Studio


Proprits du tAlfrescoOutput

4. Effectuez une mise jour de la variable JAVA_HOME (JAVA_HOME= C:\alfresco)

5. A partir du dossier d'installation (C:\alfresco), lancez le serveur Alfresco en utilisant le script


alf_start.bat

Assurez-vous que le serveur Alfresco est bien lanc avant d'utiliser le composant tAlfrescoOutput.

Installation du module Talend Alfresco

Notez que le fichier talendalfresco_20081014.zip est propos avec le composant tAlfrescoOutput dans la
perspective Integration du Studio Talend.

Pour installer le module Talend Alfresco :

1. A partir du fichier talendalfresco_20081014.zip, dans le dossier


talendalfresco_20081014\alfresco, recherchez les fichiers JAR suivants : stax-api-1.0.1.jar,
wstx-lgpl-3.2.7.jar, talendalfresco-client_1.0.jar et talendalfresco-alfresco_1.0.jar,
puis dplacez-les vers C:\alfresco\tomcat\webapps\alfresco\WEB-INF\lib

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.

Informations utiles pour une utilisation avance du composant

Installer de nouveaux types pour Alfresco :

A partir du fichier package_jeu_test.zip , dans le dossier package_jeu_test/


fichiers_conf_alfresco2.1, recherchez les fichiers suivants : xml H76ModelCustom.xml (description
du modle), web-client-config-custom.xml (interface Web du modle) et custom-model-context.xml
(enregistrement du nouveau modle), puis collez-les dans le dossier suivant : C:/alfresco/tomcat/shared/
classes/alfresco/extension

Guide de rfrence des Composants de Talend Open Studio 57


Proprits du tAlfrescoOutput

Dates :

Les dates doivent correspondre au type Talend, java.util.Date

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.

Proprits multiples ou associations :

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.

En revanche, il est impossible de supprimer une association.

Faire des List(object)avec le composant tAggregate :

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).

group by : input name, output name.

opration : output categoryList, fonction list(object), input category. ATTENTION il s'agit d'une list
(object) et non d'une simple list !

Rfrences (documents et dossiers) :

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).

Dmatrialisation, tAlfrescoOutput et Gestion de Contenu


La dmatrialisation est le processus qui sert convertir les documents concrets au format numrique, permettant
ainsi de passer d'une utilisation de documentation physique des systmes de Gestion de Contenu lectroniques.

58 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer des documents sur un serveur Alfresco

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).

Scnario : Crer des documents sur un serveur


Alfresco
Ce scnario Java dcrit un Job deux composants permettant de crer deux fichiers de documents et leurs
mtadonnes associes sur un serveur Alfresco, le systme de Gestion de Contenu en Java.

Guide de rfrence des Composants de Talend Open Studio 59


Scnario : Crer des documents sur un serveur Alfresco

Configurer votre Job


1. A partir de la Palette, cliquez-dposez les composants tFileInputDelimited et tAlfrescoOutput sur l'diteur
graphique.

2. Reliez ces deux composant l'aide d'un lien Row Main.

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.

Le schma d'entre du fichier dlimit sera donc comme suit :

60 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer des documents sur un serveur Alfresco

Configurer la connexion au serveur Alfresco


1. Dans l'diteur graphique, double-cliquez sur le composant tAlfrescoOutput pour en afficher les paramtres
de base (Basic settings).

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.

Guide de rfrence des Composants de Talend Open Studio 61


Scnario : Crer des documents sur un serveur Alfresco

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.

62 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer des documents sur un serveur Alfresco

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).

Excuter votre Job


1. Cliquez sur Sync columns pour propager automatiquement toutes les colonnes du fichier dlimit.

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.

4. Enregistrez votre Job puis appuyez sur F6 pour l'excuter.

Les deux documents sont crs sur Alfresco grce aux mtadonnes des schmas d'entre.

Guide de rfrence des Composants de Talend Open Studio 63


Scnario : Crer des documents sur un serveur Alfresco

64 Guide de rfrence des Composants de Talend Open Studio


tBonitaDeploy

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.

Ce champ est affich uniquement lorsque vous


slectionnez la version 5.3.1 de Bonita dans la liste
Bonita version.
Bonita Runtime Home Parcourez votre systme jusqu'au rpertoire d'environnement de
Bonita Runtime, ou saisissez son chemin d'accs.

Ce champ est affich uniquement lorsque vous


slectionnez la version 5.6.1 de Bonita dans la liste
Bonita version.
Bonita Runtime Jass File Parcourez votre rpertoire, ou saisissez le chemin d'accs au
fichier jass Bonita Runtime.
Bonita Runtime logging file Parcourez votre rpertoire, ou saisissez le chemin d'accs au
fichier de log Bonita Runtime.
Login Module Saisissez le nom du module de login au moteur Bonita Runtime
dfini dans le fichier Bonita Runtime jaas.
Business Archive Parcourez votre rpertoire, ou saisissez le chemin d'accs au
fichier .bar Bonita de traitement que vous souhaitez utiliser.
User name Saisissez votre identifiant de connexion Bonita.
Password Saisissez votre mot de passe de connexion Bonita.

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.
Die on error Cette case n'est pas coche par dfaut, pour terminer le traitement
avec les lignes sans erreurs, et ignorer les lignes en erreur.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement
du Job au niveau du Job ainsi qu'au niveau de chaque composant.
Connections Liens de sortie (de ce composant un autre) :

Trigger : Run if, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError.

Liens d'entre (d'un autre composant celui-ci) :

Trigger : Run if, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError

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.

Guide de rfrence des Composants de Talend Open Studio 65


Scnario associ

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.

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.

66 Guide de rfrence des Composants de Talend Open Studio


tBonitaInstantiateProcess

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.

Depuis la version 5.6, les modes Built-in et Repository sont


disponibles dans n'importe quelle solution de Talend.

Le schma de ce composant est en lecture seule. Vous pouvez


cliquer sur Edit schema afin de visualiser le schma.

Pour ce composant, le schma dpend du Module slectionn.

La colonne ProcessInstanceUUID est prdfinie dans


le schma de ce composant et rserve l'identifiant de
l'instance du processus cre
Bonita Client Mode Slectionnez le mode client que vous souhaitez utiliser pour
instancier un processus BPM.

Pour plus d'informations concernant les modes client de Bonita,


consultez les manuels de Bonita.
URL Saisissez l'URL du serveur d'application Web Bonita auquel vous
devez accder pour l'instanciation du processus.

Ce champ est disponible uniquement en mode HTTP client.


Authorization Auth Username et Auth Saisissez les informations d'authentification pour vous connecter
Password au serveur d'application Web Bonita en tant qu'utilisateur
technique.

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.

Les informations par dfaut sont automatiquement renseignes


dans ces champ. Pour plus d'informations, consultez les manuels
de Bonita.

Ces champs sont disponibles uniquement en mode HTTP client.


Bonita version Slectionnez la version du moteur Bonita Runtime utiliser.

Ce champ est disponible uniquement en mode Java client.


Bonita Runtime Parcourez votre systme jusqu'au fichier d'environnement de
Environment File Bonita Runtime, ou saisissez son chemin d'accs.

Ce champ est disponible uniquement en mode Java client.

Ce champ est affich uniquement lorsque vous


slectionnez la version 5.3.1 de Bonita dans la liste
Bonita version.

Guide de rfrence des Composants de Talend Open Studio 67


Proprits du tBonitaInstantiateProcess

Bonita Runtime Home Parcourez votre systme jusqu'au rpertoire d'environnement de


Bonita Runtime, ou saisissez son chemin d'accs.

Ce champ est affich uniquement lorsque vous


slectionnez la version 5.6.1 de Bonita dans la liste
Bonita version.
Bonita Runtime Jass File Parcourez votre rpertoire, ou saisissez le chemin d'accs au
fichier jaas Bonita Runtime.

Ce champ est disponible uniquement en mode Java client.


Bonita Runtime logging file Parcourez votre rpertoire, ou saisissez le chemin d'accs au
fichier de log Bonita Runtime.

Ce champ est disponible uniquement en mode Java client.


Use Process ID Cochez cette case pour instancier un processus existant.

Une fois la case coche, le champ Process definition ID est


activ, et vous pouvez saisir l'ID du processus.

Ce champ est disponible uniquement en mode Java client.

L'ID du processus est cr lorsque ce processus est


dploy dans le moteur Bonita Runtime.
Process Name et Process Saisissez les informations d'ID d'un processus spcifique que
Version vous souhaitez instancier. Ces informations sont utilises pour
gnrer automatiquement l'ID du processus.

Ce champ est disponible pour les modes Java client et HTTP


client.
User name Saisissez l'identifiant utilis pour instancier ce processus.

Ce champ est disponible pour les modes Java client et HTTP


client.
Password Saisissez le mot de passe utilis pour instancier ce processus.

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.

Ce champ est disponible uniquement en mode Java client.


Die on error Cette case n'est pas coche par dfaut, pour terminer le traitement
avec les lignes sans erreurs, et ignorer les lignes en erreur.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement
du Job au niveau du Job ainsi qu'au niveau de chaque composant.
Connections Liens de sortie (de ce composant un autre) :

Row : Main (fournit les paramtres de sortie partir du processus).

Trigger : Run if, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError.

Liens d'entre (d'un autre composant celui-ci) :

Row : Main.

Trigger : Run if, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError

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.

68 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Excuter un processus Bonita via un Job Talend

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 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.

Scnario 1 : Excuter un processus Bonita via un Job


Talend
Ce scnario dcrit un Job dployant un processus Bonita dans le moteur Bonita Runtime et excutant ce processus,
dans lequel une requte sur le personnel est traite.

Ce Job utilise trois composants.

- Un tBonitaDeploy : ce composant dploie un processus Bonita dans le moteur Bonita Runtime.

- Un tFixedFlowInput : ce composant gnre le schma utilis comme paramtre d'excution du processus


dploy.

- Un tBonitaInstantiateProcess : ce composant excute le processus dploy.

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.

Guide de rfrence des Composants de Talend Open Studio 69


Scnario 1 : Excuter un processus Bonita via un Job Talend

Pour reproduire ce scnario, procdez comme suit :

Configurer le Job
1. Dposez les composants tBonitaDeploy, tFixedFlowInput et tBonitaInstantiateProcess de la Palette dans
l'espace de modlisation graphique.

2. Cliquez-droit sur le composant tBonitaDeploy pour ouvrir son menu contextuel.

3. Slectionnez Trigger > OnSubjobOk pour relier le tBonitaDeploy au tFixedFlowInput.

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.

Configurer le dploiement du processus


Pour reproduire ce scnario, procdez comme suit :

1. Double-cliquez sur le tBonitaDeploy afin d'ouvrir sa vue Basic settings.

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

70 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Excuter un processus Bonita via un Job Talend

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.

Configurer le flux d'entre


1. Double-cliquez sur le composant tFixedFlowInput afin d'ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 71


Scnario 1 : Excuter un processus Bonita via un Job Talend

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.

4. Cliquez sur OK.

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.

Configurer les paramtres du tBonitaInstantiateProcess


1. Double-cliquez sur le composant tBonitaInstantiateProcess afin d'ouvrir sa vue Basic settings.

72 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Excuter un processus Bonita via un Job Talend

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.

Guide de rfrence des Composants de Talend Open Studio 73


Scnario 2 : Ecrire en sortie l'UUID de l'instance du processus via le lien Row > Main

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.

Scnario 2 : Ecrire en sortie l'UUID de l'instance du


processus via le lien Row > Main
Ce scnario dploie un processus Bonita dans Bonita Runtime, dmarre une instance et crit en sortie l'UUID de
l'instance du processus via le lien Row > Main.

Relier les composants


1. Dposez de la Palette dans l'espace de modlisation graphique un composant tBonitaDeploy, un
tBonitaInstantiateProcess et un tLogRow.

2. Renommez le tBonitaDeploy en deploy_process, le tBonitaInstantiateProcess en start_instance et le


tLogRow en show_instance_uuid.

3. Reliez le composant tBonitaDeploy au tBonitaInstantiateProcess l'aide d'un lien OnSubjobOk.

74 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Ecrire en sortie l'UUID de l'instance du processus via le lien Row > Main

4. Reliez le tBonitaInstantiateProcess au tLogRow l'aide d'un lienRow > Main.

Configurer les composants


1. Double-cliquez sur le composant tBonitaDeploy pour ouvrir sa vue Basic settings.

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.

3. Dans les champs Username et Password, saisissez vos informations d'authentification.

4. Double-cliquez sur le tBonitaInstantiateProcess pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 75


Scnario 2 : Ecrire en sortie l'UUID de l'instance du processus via le lien Row > Main

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.

7. Dans les champs Username et Password, saisissez vos informations d'authentification.

8. Double-cliquez sur le tLogRow pour ouvrir sa vue Basic settings.

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.

2. Appuyez sur F6 pour excuter le Job.

Comme affich ci-dessus, l'instance est cre et l'UUID est crit en sortie.

76 Guide de rfrence des Composants de Talend Open Studio


tCentricCRMInput

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].

In this component the schema is related to the Module selected.


Query condition Saisissez la requte permettant de slectionner les donnes
extraire.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement
du Job 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.

Guide de rfrence des Composants de Talend Open Studio 77


Scnario associ

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez 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.

78 Guide de rfrence des Composants de Talend Open Studio


tCentricCRMOutput

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.

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 Vous pouvez effectuer l'une des oprations suivantes sur les
donnes du module CentricCRM :

Insert : insrer les donnes.

Update : mettre les donnes jour.

Delete : supprimer 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.

Cliquez sur Edit schema pour modifier le schma. Si le schma


est en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement
du Job 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.

Guide de rfrence des Composants de Talend Open Studio 79


Scnario associ

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.
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.

80 Guide de rfrence des Composants de Talend Open Studio


tHL7Input

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.

Pour plus d'informations sur comment dfinir et stocker des


paramtres de connexion de base de donnes, consultez le Guide
utilisateur du Studio Talend.
Multi Schemas Editor L'diteur [Multi Schema Editor] vous permet de construire et
de configurer le flux de donnes dans un fichier dlimit multi-
structure, pour associer un schma par sortie.
Segment Lists Connection : Les colonnes sont automatiquement rcupres
partir du fichier d'entre. Le nom de la colonne est le nom du
segment.

Column Mapping : Dans ce tableau, le mapping est rcupr de


celui que vous avez dfini dans l'diteur.
Not Validate HL7 Message Cochez cette case si vous ne souhaitez pas valider les messages
HL7.
Advanced settings Advanced separator (for Cochez cette option pour modifier les sparateurs utiliss pour
numbers) les nombres :

Thousands separator : dfinissez le sparateur utilis pour les


milliers.

Decimal separator : dfinissez le sparateur utilis pour les


dcimaux.
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.
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.

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.

Guide de rfrence des Composants de Talend Open Studio 81


Scnario : Retrouver des informations concernant les patients et les vnements partir dun fichier HL7

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, 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.

Scnario : Retrouver des informations concernant les


patients et les vnements partir dun fichier HL7
Ce scnario dcrit un Job de quatre composants, dont le but est de retrouver des informations concernant des
patients et des vnements partir dun fichier HL7.

Configurer l'diteur
1. A partir de la Palette, glissez-dposez un composant tHL7Input, et trois tLogRow dans lespace de
modlisation graphique.

2. Double-cliquez sur le composant tHL7Input afin douvrir son diteur.

82 Guide de rfrence des Composants de Talend Open Studio


Scnario : Retrouver des informations concernant les patients et les vnements partir dun fichier HL7

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.

6. Glissez-dposez les segments MSH-3(1)-1-1[IS] et MSH-7(1)-1-1[ST]] de la zone Message View dans la


zone Schema View et modifiez la valeur de la colonne User Column MSH_LABEL et MSH_DATE
respectivement.

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.

Guide de rfrence des Composants de Talend Open Studio 83


Scnario : Retrouver des informations concernant les patients et les vnements partir dun fichier HL7

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.

11. Cliquez sur OK pour fermer l'diteur.

Configurer les composants de sortie


1. Double-cliquez sur le tLogRow_1 pour afficher sa vue Basic settings et configurer ses proprits.

2. Slectionnez l'option Table (print values in cells of a table) afin d'afficher les rsultats d'excution dans
un tableau.

3. Rptez l'opration pour le tLogRow_2 et le tLogRow_3.

Excution du Job
1. Reliez le tHL7Input aux trois tLogRow, en utilisant respectivement les liens MSH, EVN et PID.

2. Sauvegardez votre Job, et appuyez sur F6 pour lexcuter.

84 Guide de rfrence des Composants de Talend Open Studio


Scnario : Retrouver des informations concernant les patients et les vnements partir dun fichier HL7

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.

Guide de rfrence des Composants de Talend Open Studio 85


tHL7Output

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.

Parent row : Flux de donnes source.


File Name/Output Stream Parcourez le rpertoire o stocker les fichiers gnrs.
Configure HL7 Tree Ouvre l'interface ddie pour vous aider mettre en place le
mapping HL7.
HL7 Version Slectionnez dans la liste votre version de HL7.
Advanced settings Create directory only if it Cette case est coche par dfaut. Cette option permet de crer le
does not exist dossier contenant le fichier de sortie s'il n'existe pas dj.
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.
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.
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.

Scnario : Gnrer un accus de rception


(Acknowledgment) HL7
Ce scnario, comprenant trois composants, permet de gnrer un accus de rception HL7, ou Acknowledgment
(ACK).

86 Guide de rfrence des Composants de Talend Open Studio


Scnario : Gnrer un accus de rception (Acknowledgment) HL7

Construire le Job
1. Dposez deux composants tFixedFlowInput et un composant tHL7Output dans l'espace de modlisation
graphique.

2. Renommez les deux tFixedFlowInput en MSH et MSA respectivement.

3. Reliez le MSH et le MSA au tHL7Output l'aide d'un lien Row > Main.

4. Double-cliquez sur le lien entre le MSH et le tHL7Output et renommez-le MSH.

5. Double-cliquez sur le lien entre le MSA et le tHL7Output et renommez-le MSA.

Configurer les composants


1. Cliquez sur le tHL7Output pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 87


Scnario : Gnrer un accus de rception (Acknowledgment) HL7

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 le bouton Open pour importer la structure de ce fichier.

88 Guide de rfrence des Composants de Talend Open Studio


Scnario : Gnrer un accus de rception (Acknowledgment) HL7

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.

Guide de rfrence des Composants de Talend Open Studio 89


Scnario : Gnrer un accus de rception (Acknowledgment) HL7

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.

6. Double-cliquez sur le composant MSH pour ouvrir sa vue Basic settings.

90 Guide de rfrence des Composants de Talend Open Studio


Scnario : Gnrer un accus de rception (Acknowledgment) HL7

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_2_1__1_1_ST_: "^~\\&", assurez-vous d'utiliser le caractre d'chappement avant \, en mode Use


Single Table ou Use Inline Table

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 "".

7. Double-cliquez sur le composant MSA pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 91


Scnario : Gnrer un accus de rception (Acknowledgment) HL7

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.

2. Appuyez sur F6 afin d'excuter le Job.

Comme montr prcdemment, le Job s'est correctement excut.

3. Ouvrez le message ACK HL7 gnr :

Comme montr prcdemment, le message gnr ne contient que les informations obligatoires et est
totalement conforme aux standards HL7.

92 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 93


tMarketoInput

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du


champ Secret key, 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.

Pour obtenir cette information, veuillez contacter le support


Marketo via <support@marketo.com>.
Client Access ID Saisissez l'identifiant utilisateur permettant d'accder au service
Web Marketo.

Pour obtenir cette information, veuillez contacter le support


Marketo via <support@marketo.com>.
Operation Les options de cette liste vous permettent de synchroniser les
donnes des prospects entre Marketo et un systme externe.

getLead : Cette option rcupre les informations des prospects et


de leur activit dans la base de donnes Marketo.

getMultipleLeads : Cette opration rcupre les enregistrements


des prospects dans des lots.

getLeadActivity : Cette opration rcupre l'historique des


enregistrements d'activit pour un prospect unique identifi par
la cl fournie.

getLeadChanges : Cette opration vrifie les changements des


donnes de prospects dans la base de donnes Marketo.
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 :

View schema : slectionnez cette option afin de voir le schma.

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

94 Guide de rfrence des Composants de Talend Open Studio


Proprits du tMarketoInput

Job courant, slectionnez No et slectionnez nouveau la


mtadonne du schma dans la fentre [Repository Content].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.
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.
Columns Mapping Vous pouvez configurer les conditions de mapping en modifiant
le schma dans Edit Schema. Par dfaut, les noms des colonnes
des champs contenus dans Column sont les mmes que ceux du
schma.

Puisque certains noms de colonnes de la base de


donnes Marketo contiennent des blancs non accepts
par le schma du composant, vous devez spcifier les
champs de colonnes correspondants dans le champ
Columns in Marketo. Si les noms de colonnes dfinis
dans le schma sont les mmes que ceux de la base de
donnes Marketo, comme par exemple "Email", alors
il n'est pas ncessaire de configurer les conditions de
mapping.
Lead Selector Slectionnez dans la liste l'un des types de slecteur de prospects :

LeadKeySelector : slectionnez ce type afin de rcuprer


les enregistrements des prospects identifis par la LeadKey
spcifie.

StaticListSelector : slectionnez ce type afin de rcuprer les


enregistrements correspondant la liste statique spcifie.

Lorsque cette option est slectionne, vous devez spcifier une


liste statique en slectionnant List Name ou List ID dans la
liste affiche et saisir la valeur dans le champ ct de la liste.

LastUpdateAtSelector : slectionnez cet type afin de


rcuprer les enregistrements des prospects ayant t mis jour
des dates spcifiques.

Cette liste s'affiche uniquement lorsque l'option


getMultipleLeads est slectionne dans la liste Operation.
LeadKey type Types de donnes de LeadKey supports par la base de donnes
Marketo.

Cette liste s'affiche lorsque :

getLead ou getLeadActivity est slectionn dans la liste


Operation, ou

getMultipleLeads est slectionn dans la liste Operation et


LeadKeySelector est slectionn dans la liste Lead Selector.
LeadKey value Valeur de LeadKey.

Le champ est disponible uniquement lorsque getLead ou


getLeadActivity est slectionn dans la liste Operation.
LeadKey values Spcifiez les valeurs de LeadKey en slectionnant une colonne
du flux d'entre contenant les valeurs LeadKey.

Cette liste s'affiche uniquement lorsque l'option


getMultipleLeads est slectionne dans la liste Operation et
LeadKeySelector dans la liste Lead Selector.
Set Include Types Cochez cette case pour inclure les types de contenu de l'activit
des prospects (LeadActivity) rcuprer. Cliquez sur le bouton
[+] sous la zone Include Types pour ajouter des types en les
slectionnant dans la liste.

Guide de rfrence des Composants de Talend Open Studio 95


Proprits du tMarketoInput

Cette case est disponible uniquement si vous avez slectionn


getLeadActivity ou getLeadChanges dans la liste Operation.
Set Exclude Types Cochez cette case pour exclure les types de contenu de l'activit
des prospects (LeadActivity) rcuprer. Cliquez sur le bouton
[+] sous la zone Exclude Types pour ajouter des types en les
slectionnant dans la liste.

Cette case est disponible uniquement si vous avez slectionn


getLeadActivity ou getLeadChanges dans la liste Operation.
Oldest Updated At Saisissez l'heure de la mise jour la plus ancienne afin de
rcuprer uniquement les prospects mis jour depuis le moment
spcifi.

Ce champ supporte le format de date et heure support


par Marketo. Pour plus d'informations concernant le format
de date support, consultez http://developers.marketo.com/
documentation/soap/getmultipleleads/ (en anglais).

Ce champ est disponible uniquement lorsque l'option


getMultipleLeads est slectionne dans la liste Operation et
LastUpdateAtSelector dans la liste Lead Selector.
Last Updated At Saisissez la date de la dernire mise jour afin de ne rcuprer
que les prospects mis jour avant le moment spcifi.

Ce champ supporte le format de date et heure support


par Marketo. Pour plus d'informations concernant le format
de date support, consultez http://developers.marketo.com/
documentation/soap/getmultipleleads/ (en anglais).

Ce champ est disponible uniquement si vous avez


slectionn getMultipleLeads dans la liste Operation et
LastUpdateAtSelector dans la liste Lead Selector.
Oldest create date Saisissez la date et l'heure de la premire cration afin de
rcuprer les donnes depuis le moment spcifi. Le format de
date est YYYY-MM-DD HH:MM:SS Z.

Ce champ est affich uniquement lorsque vous slectionnez


getLeadChanges dans la liste Operation.
Latest create date Saisissez la date et l'heure de la dernire cration afin de rcuprer
les donnes avant le moment spcifi. Le format de date est
YYYY-MM-DD HH:MM:SS Z.

Ce champ est affich uniquement lorsque vous slectionnez


getLeadChanges dans la liste Operation.

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.

Ce champ est disponible uniquement si :

vous avez slectionn la case getMultipleLeads dans la liste


Operation et StaticListSelector ou LastUpdateAtSelector
dans la liste Lead Selector.

vous avez slectionn la case getLeadActivity ou


getLeadChanges dans la liste Operation.
Timeout (milliseconds) Saisissez en millisecondes le dlai avant suspension de la requte
sur le service Web Marketo.

Le Job s'arrte lorsque l'erreur "Timeout exception" survient.


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. Au besoin, vous pouvez
rcuprer les lignes en erreur via un lien Row > Reject.

96 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

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 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.

Guide de rfrence des Composants de Talend Open Studio 97


tMarketoListOperation

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.

Depuis la version 5.6, les modes Built-in et Repository sont


disponibles dans n'importe quelle solution de Talend.

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.

Le schma de ce composant est en lecture seule. Vous pouvez


cliquer sur Edit schema afin de visualiser le schma.
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.
Endpoint address URL du service Web Marketo appel par l'API ou les APIs
SOAP.
Secret key Saisissez le code d'authentification crypt fourni par Marketo.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du


champ Secret key, 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.

Pour obtenir cette information, veuillez contacter le


support Marketo via <support@marketo.com>.
Client Access ID Saisissez l'identifiant utilisateur permettant d'accder au service
Web Marketo.

Pour obtenir cette information, veuillez contacter le


support Marketo via <support@marketo.com>.
Operation Les options de cette liste vous permettent d'effectuer un ajout/
une suppression d'un ou plusieurs prospect(s) dans une liste
d'une base de donnes Marketo. Vous pouvez galement vrifier
l'existence d'un ou plusieurs prospect(s) dans une liste de la base
de donnes Marketo.

addTo : Cette option ajoute un ou plusieurs prospect(s) dans une


liste de la base de donnes Marketo.

isMemberOf : Cette option recherche dans la base de donnes si


le(s) prospect(s) spcifique(s) existe(nt) dans la base de donnes.

98 Guide de rfrence des Composants de Talend Open Studio


Scnario : Ajouter un enregistrement de prospects dans une liste de la base de donnes Marketo

removeFrom : cette opration supprime un ou plusieurs


prospect(s) d'une liste dans la base de donnes Marketo.
Add or remove multiple Cochez cette case afin d'ajouter ou de supprimer plusieurs
leads prospect(s) d'une liste dans la base de donnes Marketo.

Cette case est disponible uniquement si vous avez


slectionn addTo ou removeFrom dans la liste
Operation.
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. Au besoin, vous pouvez
rcuprer les lignes en erreur via un lien Row > Reject.
Timeout (milliseconds) Saisissez en millisecondes le dlai avant suspension de la requte
sur le service Web Marketo.

Le Job s'arrte lorsque l'erreur "Timeout exception"


survient.
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_CALL : nombre d'appels. 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 gnralement utilis en tant que composant intermdiaire. Un composant
d'entre et un composant de sortie sont ncessaires.

Scnario : Ajouter un enregistrement de prospects


dans une liste de la base de donnes Marketo
Le scnario suivant dcrit un Job a trois composants qui ajoute un enregistrement de prospects dans une liste de
la base de donnes Marketo.

Construire le Job
1. Dposez les composants tMarketoListOperation, tFixedFlowInput et tLogRow de la Palette dans l'espace
de modlisation graphique.

2. Connectez le tFixedFlowInput au tMarketoListOperation l'aide d'un lien Row > Main.

Guide de rfrence des Composants de Talend Open Studio 99


Scnario : Ajouter un enregistrement de prospects dans une liste de la base de donnes Marketo

3. Connectez le tMarketoListOperation au tLogRow l'aide d'un lien Row > Main.

Configurer le composant d'entre


1. Double-cliquez sur le composant tFixedFlowInput afin de dfinir ses proprits dans sa vue Basic settings.

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.

4. Dans la zone Mode, slectionnez Use Inline Table.

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.

100 Guide de rfrence des Composants de Talend Open Studio


Scnario : Ajouter un enregistrement de prospects dans une liste de la base de donnes Marketo

2. Cliquez sur le bouton Sync columns afin de rcuprer le schma dfini dans le tFixedFlowInput.

3. Saisissez 1 dans le champ Number of rows.

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.

7. Dans la liste Operation, slectionnez addTo.

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.

3. Dans la zone Mode, slectionnez Table.

Guide de rfrence des Composants de Talend Open Studio 101


Scnario : Ajouter un enregistrement de prospects dans une liste de la base de donnes Marketo

4. Sauvegardez votre Job et appuyez sur F6 pour l'excuter.

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.

102 Guide de rfrence des Composants de Talend Open Studio


tMarketoOutput

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.
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.
Endpoint address URL du service Web Marketo appel par l'API ou les APIs
SOAP.
Secret key Saisissez le code d'authentification crypt fourni par Marketo.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du


champ Secret key, 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.

Pour obtenir cette information, veuillez contacter le


support Marketo via <support@marketo.com>.
Client Access ID Saisissez l'identifiant utilisateur permettant d'accder au service
Web Marketo.

Pour obtenir cette information, veuillez contacter le


support Marketo via <support@marketo.com>.
Operation Les options de cette liste vous permettent de synchroniser les
donnes des prospects entre Marketo et un systme externe.

Guide de rfrence des Composants de Talend Open Studio 103


Proprits du tMarketoOutput

syncLead : Cette option sollicite une opration d'insertion ou de


mise jour pour un enregistrement de prospect.

syncMultipleLeads : Cette option sollicite une opration


d'insertion ou de mise jour pour plusieurs enregistrements de
prospects regroups par lots.
Columns Mapping Spcifiez les colonnes correspondantes dans Marketo pour les
colonnes listes dans les champs Column. Par dfaut, les noms
de colonnes dans les champs Column sont les mmes que dans
le schma. Vous pouvez modifier les colonnes de mapping en
modifiant le schma.

Notez que les deux colonnes suivantes sont en lecture seule et


que vous ne pouvez pas les mapper vers des colonnes Marketo :

Status : statut d'excution de l'opration courante pour


l'enregistrement de donnes.

ERROR_MSG : message d'erreur gnr lorsqu'une erreur


survient.

Puisque certains noms de colonnes dans la base de


donnes Marketo contiennent des blancs non accepts
par le schma du composant, vous devez spcifier les
champs de colonnes correspondants dans le champ
Columns in Marketo. Vous n'avez pas besoin de
mapper les colonnes de schma ayant le mme nom
dans la base de donnes Marketo.
De-duplicate lead record on Cochez cette case afin de ddoublonner et de mettre jour les
email address enregistrements des prospects en utilisant l'adresse e-mail.

Dcochez cette case si vous souhaitez crer un autre


enregistrement de prospect contenant la mme adresse e-mail.

Cette case est disponible uniquement si vous


avez slectionn syncMultipleLeads dans la liste
Operation.
Batch Size Limite maximale du nombre d'enregistrements par lot
synchroniser avec les donnes de prospects.

Ce champ est disponible uniquement si vous


avez slectionn syncMultipleLeads dans la liste
Operation.
Timeout (milliseconds) Saisissez en millisecondes le dlai avant suspension de la requte
sur le service Web Marketo.

Le Job s'arrte lorsque l'erreur "Timeout exception"


survient.
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. Au besoin, vous pouvez
rcuprer les lignes en erreur via un lien Row > Reject.
Advanced settings 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.

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.

104 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer et rcuprer des donnes d'une base de donnes Marketo via un systme externe

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez 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.

Scnario : Insrer et rcuprer des donnes d'une


base de donnes Marketo via un systme externe
Le scnario suivant dcrit un Job cinq composants qui a pour but d'insrer des enregistrements de prospects dans
une base de donnes Marketo et d'crire ces enregistrements dans un fichier local. Au terme de ce processus, le
nombre d'appels d'API est affich dans la console de la vue Run.

Configurer votre Job


1. A partir de la Palette, dposez les composants tMarketoOutput, tMarketoInput, tFileInputDelimited,
tFileOutputDelimited et tJava dans l'espace de modlisation graphique.

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.

Guide de rfrence des Composants de Talend Open Studio 105


Scnario : Insrer et rcuprer des donnes d'une base de donnes Marketo via un systme externe

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.

106 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer et rcuprer des donnes d'une base de donnes Marketo via un systme externe

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.

Guide de rfrence des Composants de Talend Open Studio 107


Scnario : Insrer et rcuprer des donnes d'une base de donnes Marketo via un systme externe

2. Dans la liste Operation, slectionnez getLead.

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.

108 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer et rcuprer des donnes d'une base de donnes Marketo via un systme externe

Utiliser des scripts Java pour compter les appels d'APIs


1. Double-cliquez sur le composant tJava pour ajouter du code dans l'onglet Basic settings de sa vue
Component.

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 :

System.out.println(("The Number of API calls for inserting


data to Marketo DB is:"));
System.out.println((Integer)globalMap.get("tMarketoOutput_1_NB_CALL"));
System.out.println(("The Number of API calls for data synchronization
from Marketo DB is:"));
System.out.println((Integer)globalMap.get("tMarketoInput_1_NB_CALL"));

Excuter le Job
1. Sauvegardez votre Job.

2. Appuyez sur F6 pour l'excuter.

Les enregistrements des prospects insrs dans la base de donnes Marketo sont crits dans le fichier D:/
ReceiveData.csv.

Guide de rfrence des Composants de Talend Open Studio 109


Scnario : Insrer et rcuprer des donnes d'une base de donnes Marketo via un systme externe

Le nombre total d'appels d'APIs durant les oprations sur les donnes est affich dans la console de la vue
Run.

110 Guide de rfrence des Composants de Talend Open Studio


tMicrosoftCrmInput

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.

ON_PREMISE : Le CRM est install de manire


personnalise sur les serveurs des clients et la licence est
achete avec les infrastructures ncessaires.

ONLINE : Les clients accdent un CRM faisant partie d'un


service de souscription bas Cloud, hberg par Microsoft,
dans leurs centres de donnes.
Microsoft WebService URL Saisissez l'URL du service Web d'un serveur Microsoft CRM sur
site.

Ce champ apparat uniquement lorsque l'option ON_PREMISE


est slectionne dans la liste Authentication Type. Dans ce
cas, la version supporte de l'API Microsoft CRM est v2007
et le champ peut tre renseign par l'URL comme suit : http://
ServerAddress/MSCrmServices/2007/CrmService.asmx.
API Version Slectionnez une version de l'API Microsoft CRM dans la liste
droulante. La version peut tre v2007 ou v2011.

Ce champ apparat uniquement lorsque l'option ONLINE est


slectionne dans la liste droulante Authentication Type.
OrganizeName Renseignez le nom de l'utilisateur ou de l'organisme, dfini
par un administrateur, voulant accder la base de donnes
MicrosoftCRM.
Username et Password Saisissez les informations d'authentification de l'utilisateur au
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.
Domain Saisissez le nom de domaine du serveur sur lequel est hberge
la base MicrosoftCRM.

Ce champ apparat uniquement lorsque l'option ON_PREMISE


est slectionne dans la liste Authentication Type.
Host Saisissez l'adresse IP du serveur de base de donnes Microsoft
CRM.

Ce champ apparat uniquement lorsque l'option ON_PREMISE


est slectionne dans la liste Authentication Type.
Port Saisissez le numro du port d'coute du serveur.

Ce champ apparat uniquement lorsque l'option ON_PREMISE


est slectionne dans la liste Authentication Type.

Guide de rfrence des Composants de Talend Open Studio 111


Proprits du tMicrosoftCrmInput

Discovery service endpoint Spcifiez l'endpoint du service de dcouverte de CRM Online.

Ce champ apparat uniquement lorsque l'option ONLINE est


slectionne dans la liste Authentication Type.
Time out (second) Spcifiez le nombre de secondes d'attente d'un message de
rponse du serveur du CRM avant fermeture de la connexion.
Entity Slectionnez l'entit adquate partir de la liste droulante.

Si ncessaire, slectionnez CustomEntity dans la liste, puis


spcifiez un nom d'entit dans le champ Custom Entity Name
et dfinissez le schma de l'entit personnalise.
Custom Entity Name Spcifiez le nom de l'entit personnalise.

Ce champ apparat uniquement lorsque l'option CustomEntity


est slectionne dans la liste Entity.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.

Pour ce composant, le schma correspond l'entit


slectionne.
Logical operator used to Slectionnez l'oprateur logique utilis pour combiner les
combine conditions conditions dfinies dans la table Conditions. Deux oprateurs
sont disponibles :

And : l'enregistrement est inclus dans l'ensemble des rsultats


lorsque toutes les conditions sont respectes.

Or : l'enregistrement est inclus dans l'ensemble des rsultats


lorsqu'une des conditions est respecte.
Conditions Cliquez sur le bouton [+] pour ajouter autant de conditions que
ncessaire. Les paramtres suivants doivent tre configurs pour
chaque condition.

Input column : Cliquez dans la cellule et slectionnez la


colonne du schma d'entre laquelle attribuer la condition.

Operator : Cliquez dans la cellule et slectionnez l'oprateur


utilis pour comparer la valeur de la colonne d'entre
la valeur dfinie dans la colonne Value. La valeur de
ce paramtre peut tre Equal, NotEqual, GreaterThan,
LessThan, GreaterEqual, LessEqual et Like.

Value : Saisissez la valeur entre guillemets, si ncessaire.

112 Guide de rfrence des Composants de Talend Open Studio


Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes
spcifiques

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.

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.
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 : Ecrire des donnes dans une base de


donnes Microsoft CRM et attribuer des conditions
aux colonnes pour extraire des lignes spcifiques
Le scnario suivant dcrit un Job quatre composants qui a pour but l'criture des donnes d'un fichier dlimit
en entre dans une entit personnalise d'une base de donnes MicrosoftCRM. Le Job permet ensuite d'extraire
des lignes spcifiques jusque dans un fichier de sortie, en utilisant les conditions dfinies sur certaines colonnes
d'entre.
Si vous voulez crire dans une Entit Personnalise d'une base de donnes MicrosoftCRM, assurez-vous de nommer les
colonnes conformment aux rgles de syntaxe Microsoft, savoir "name_columnname" en minuscules.

Configurer le Job
1. A partir de la Palette, dposez les composants suivants dans l'diteur graphique : tFileInputDelimited,
tFileOutputDelimited, tMicrosoftCrmInput, et tMicrosoftCrmOutput.

Guide de rfrence des Composants de Talend Open Studio 113


Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes
spcifiques

2. Connectez le composant tFileInputDelimited au tMicrosoftCrmOutput l'aide d'un lien de type Row


Main.

3. Connectez le composant tMicrosoftCrmIntput au tFileOutputDelimited l'aide d'un lien de type Row


Main.

4. Connectez le composant tFileInputDelimited au tMicrosoftCrmInput l'aide d'un lien de type


OnSubjobOk.

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.

114 Guide de rfrence des Composants de Talend Open Studio


Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes
spcifiques

7.

8. Cliquez sur OK pour fermer la bote de dialogue.

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.

Guide de rfrence des Composants de Talend Open Studio 115


Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes
spcifiques

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.

116 Guide de rfrence des Composants de Talend Open Studio


Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes
spcifiques

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.

Guide de rfrence des Composants de Talend Open Studio 117


Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes
spcifiques

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.

118 Guide de rfrence des Composants de Talend Open Studio


Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes
spcifiques

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.

3. Dfinissez les sparateurs de lignes (Row separator) et de champs (Field separator).

4. Cochez la case Append pour ajouter des lignes la fin des entres de la base de donnes.

5. Cochez la case Include Header si le fichier de sortie comprend un en-tte.

6. Cliquez sur le bouton Sync columns pour rcuprer le schma partir du composant prcdent.

Excuter votre Job


Enregistrez votre Job puis cliquez sur F6 pour l'excuter.

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.

Guide de rfrence des Composants de Talend Open Studio 119


tMicrosoftCrmOutput

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.

ON_PREMISE : Le CRM est install de manire


personnalise sur les serveurs des clients et la licence est
achete avec les infrastructures ncessaires.

ONLINE : Les clients accdent un CRM faisant partie d'un


service de souscription bas Cloud, hberg par Microsoft,
dans leurs centres de donnes.
Microsoft WebService URL Saisissez l'URL du service Web d'un serveur Microsoft CRM sur
site.

Ce champ apparat uniquement lorsque l'option ON_PREMISE


est slectionne dans la liste Authentication Type. Dans ce
cas, la version supporte de l'API Microsoft CRM est v2007
et le champ peut tre renseign par l'URL comme suit : http://
ServerAddress/MSCrmServices/2007/CrmService.asmx.
API Version Slectionnez une version de l'API Microsoft CRM dans la liste
droulante. La version peut tre v2007 ou v2011.

Ce champ apparat uniquement lorsque l'option ONLINE est


slectionne dans la liste droulante Authentication Type.
OrganizeName Renseignez le nom de l'organisme qui veut accder la base de
donnes MicrosoftCRM.
Username et Password Saisissez les informations d'authentification de l'utilisateur au
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.
Domain Saisissez le nom de domaine du serveur sur lequel est hberge
la base MicrosoftCRM.

Ce champ apparat uniquement lorsque l'option ON_PREMISE


est slectionne dans la liste Authentication Type.
Host Saisissez l'adresse IP du serveur de base de donnes Microsoft
CRM.

Ce champ apparat uniquement lorsque l'option ON_PREMISE


est slectionne dans la liste Authentication Type.
Port Saisissez le numro du port d'coute du serveur.

Ce champ apparat uniquement lorsque l'option ON_PREMISE


est slectionne dans la liste Authentication Type.
Discovery service endpoint Spcifiez l'endpoint du service de dcouverte de CRM Online.

120 Guide de rfrence des Composants de Talend Open Studio


Proprits du tMicrosoftCrmOutput

Ce champ apparat uniquement lorsque l'option ONLINE est


slectionne dans la liste Authentication Type.
Action Vous pouvez effectuer l'une des oprations suivantes sur les
donnes MicrosoftCRM :

Insert : insrer les donnes.

Update : mettre les donnes jour.

Delete : supprimer les donnes.


Time out (second) Spcifiez le nombre de secondes d'attente d'un message de
rponse du serveur du CRM avant fermeture de la connexion.
Entity Slectionnez l'entit adquate partir de la liste droulante.

Si ncessaire, slectionnez CustomEntity dans la liste, puis


spcifiez un nom d'entit dans le champ Custom Entity Name
et dfinissez le schma de l'entit personnalise.
Custom Entity Name Spcifiez le nom de l'entit personnalise.

Ce champ apparat uniquement lorsque l'option CustomEntity


est slectionne dans la liste Entity.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.

Pour ce composant, le schma correspond l'entit


slectionne.
Lookup Type Mapping Cliquez sur le bouton [+] pour ajouter autant de lignes que
ncessaire afin d'tablir le mapping entre les tables source et
cible. Slectionnez un objet de rfrence dans la liste droulante
Input column et saisissez le mot-cl des tables source dans le
champ Type.
Advanced settings Reuse Http Client Cochez cette case afin de conserver la connexion courante ou
dcochez la case afin de librer la connexion.
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.

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.

Guide de rfrence des Composants de Talend Open Studio 121


Scnario associ

Une variable Flow fonctionne durant l'excution d'un composant. Une variable After
fonctionne aprs l'excution d'un composant.

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez 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.

122 Guide de rfrence des Composants de Talend Open Studio


tMSAXInput

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.

Lorsque vous utilisez le connecteur mtier .NET, le


Job correspondant doit tre excut sur le serveur o
est hberg votre serveur Dynamics AX. Si l'dition de
votre Studio Talend vous permet d'utiliser un JobServer
pour excuter ce Job, vous devez dployer ce JobServer
sur le serveur de l'hte de votre serveur Dynamics AX.
Type Dynamics AX 2012 Port Saisissez le numro du port du connecteur .NET utiliser.
uniquement.
Type Dynamics AX 2012 AOS Server Instance Saisissez le nom de l'ordinateur excutant l'instance de
uniquement. l'Application Object Server (AOS) laquelle vous devez vous
connecter.
Domain Saisissez le nom de domaine sur lequel est hberg le serveur
MicrosoftAX.
Username et Password Saisissez les informations d'authentification de l'utilisateur.

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.
Type Dynamics AX 2012 Company Saisissez le nom de votre entreprise.
uniquement.
Type Dynamics AX 2012 Language Saisissez la langue que vous souhaitez utiliser.
uniquement.
Type Dynamics AX 2012 Configuration File Spcifiez l'emplacement du fichier fournissant les paramtres
uniquement. utiliser.
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.

Guide de rfrence des Composants de Talend Open Studio 123


Scnario associ

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 :

View schema : slectionnez cette option afin de voir le schma.

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 Saisissez votre requte SQL en faisant attention ce que l'ordre
des champs corresponde celui dfini dans le schma.
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.

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.

Scnario associ
Aucun scnario n'est disponible pour ce composant.

124 Guide de rfrence des Composants de Talend Open Studio


tMSAXOutput

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.

Lorsque vous utilisez le connecteur mtier .NET, le


Job correspondant doit tre excut sur le serveur o
est hberg votre serveur Dynamics AX. Si l'dition de
votre Studio Talend vous permet d'utiliser un JobServer
pour excuter ce Job, vous devez dployer ce JobServer
sur le serveur de l'hte de votre serveur Dynamics AX.
Type Dynamics AX 2012 Port Saisissez le numro du port du connecteur .NET utiliser.
uniquement.
Type Dynamics AX 2012 AOS Server Instance Saisissez le nom de l'ordinateur excutant l'instance de
uniquement. l'Application Object Server (AOS) laquelle vous devez vous
connecter.
Domain Saisissez le nom de domaine sur lequel est hberg le serveur
MicrosoftAX.
Username et Password Saisissez les informations d'authentification de l'utilisateur.

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.
Type Dynamics AX 2012 Company Saisissez le nom de votre entreprise.
uniquement.
Type Dynamics AX 2012 Language Saisissez la langue que vous souhaitez utiliser.
uniquement.
Type Dynamics AX 2012 Configuration File Spcifiez l'emplacement du fichier fournissant les paramtres
uniquement. utiliser.
Table Name Nom de la table crire.
Action on data Vous pouvez effectuer n'importe quelle opration sur les donnes
d'un serveur MicrosoftAX.

Insert : Ajouter de nouvelles entres la table. Le Job s'arrte


lorsqu'il dtecte des doublons.

Guide de rfrence des Composants de Talend Open Studio 125


Proprits du tMSAXOutput

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si


l'enregistrement avec la rfrence donne existe dj, une mise
jour est effectue.

Update or insert : met jour l'enregistrement avec la


rfrence donne. Si l'enregistrement n'existe pas, un nouvel
enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

Il est ncessaire de spcifier au minimum une cl de


recherche sur laquelle baser les oprations Update
et Delete. Il est possible de dfinir les colonnes qui
agiront comme cl de recherche partir du schma,
pour une utilisation de base, ou partir des options
avances (Advanced settings) pour une utilisation
optimise de ces oprations.
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 :

View schema : slectionnez cette option afin de voir le schma.

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 erreurs, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela,
utilisez un lien Row > Rejects.
Additional columns Cette option vous permet d'utiliser des expressions locales afin
d'effectuer des actions sur les colonnes. Par exemple, vous
pouvez modifier les valeurs dans la table slectionne :

Quand vous mettez jour ou que vous effacez des donnes


dans une colonne, cette option vous fournit d'autres possibilits
concernant les clauses WHERE en utilisant diffrents oprateurs
de la colonne Operator.

Name : nom de la colonne du schma devant tre modifie ou


insre comme nouvelle colonne.

Operator : slectionnez dans la liste l'oprateur que vous


souhaitez utiliser avec la clause WHERE.

Cette colonne n'est pas disponible quand vous utilisez


Insert comme action sur les donnes.

Data type : type de donnes.

Local expression : type d'expression locale qui sera excut afin


de modifier ou insrer la colonne de donnes correspondante, par

126 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes dans une table dfinie sur le serveur Microsoft AX

exemple row1.[row name]. Ou bien appuyez sur Ctrl+Espace et


slectionnez une variable de contexte dans la liste.

Position : slectionnez dans la liste Before, After ou Replace,


suivant l'action que vous voulez excuter dans la colonne de
rfrence.

Reference column : type, dans une colonne de rfrence, que


le composant peut utiliser pour insrer/remplacer la nouvelle
colonne ou la colonne modifie.
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_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 en tant que composant de sortie. Un composant de dbut
est ncessaire.

Scnario : Insrer des donnes dans une table dfinie


sur le serveur Microsoft AX
Avant de pouvoir utiliser ce composant, vrifiez que vous avez install et lanc le serveur Microsoft AX correctement.

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.

Guide de rfrence des Composants de Talend Open Studio 127


Scnario : Insrer des donnes dans une table dfinie sur le serveur Microsoft AX

Configurer le Job
1. Glissez le composant tFixedFlowInput ainsi que le tMSAXOutput de la Palette dans l'espace de
modlisation.

2. Connectez les composants l'aide d'un lien Row de type Main.

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.

128 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes dans une table dfinie sur le serveur Microsoft AX

2. Slectionnez le mode Built-In dans le champ Property Type.

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.

6. Cliquez sur Sync columns pour retrouver le schma du composant prcdent.

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.

Guide de rfrence des Composants de Talend Open Studio 129


Scnario 2 : Effacer des donnes d'une table prcise sur le serveur MicrosoftAX.

Scnario 2 : Effacer des donnes d'une table prcise


sur le serveur MicrosoftAX.
Avant de pouvoir utiliser ce composant, vrifiez que vous avez install et lanc correctement le serveur MicrosoftAX.

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.

130 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Effacer des donnes d'une table prcise sur le serveur MicrosoftAX.

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.

Configurer la connexion au serveur MicrosoftAX


1. Double-cliquez sur le tMSAXOutput pour ouvrir sa vue Component et dfinir ses proprits.

2. Slectionnez le mode Built-In dans le champ Property Type.

3. Dans le champ Host, saisissez l'adresse IP du serveur MicrosoftAX.

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.

Dfinir l'action sur les donnes


1. Dans la liste Action on data, slectionnez l'action que vos souhaitez excuter, Delete 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.

Guide de rfrence des Composants de Talend Open Studio 131


Scnario 2 : Effacer des donnes d'une table prcise sur le serveur MicrosoftAX.

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.

132 Guide de rfrence des Composants de Talend Open Studio


tNetsuiteInput

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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Le schma de ce composant est pr-renseign avec des colonnes


correspondant aux champs des services NetSuite, qui varient selon
le type d'enregistrement (Record Type) slectionn. Vous pouvez
supprimer les colonnes ne concernant pas votre opration, mais
ne renommez pas de colonne du schma, cela pourrait causer des
erreurs d'excution.
Search Criteria Dfinissez les conditions de recherche afin de faire correspondre les champs
pour rcuprer les donnes. Cliquez sur le bouton [+] pour ajouter autant de
lignes que ncessaire, chaque ligne pour une condition et dfinir chacune de
vos conditions :

Field Name : slectionnez un champ dans lequel rechercher selon la


condition spcifie.

Operator : slectionnez un oprateur pour la condition de recherche.

Guide de rfrence des Composants de Talend Open Studio 133


Scnario associ

Value : saisissez la valeur pour la condition de recherche.

Value2 : saisissez la seconde valeur de la condition de la recherche, si


appropri, selon l'oprateur slectionn.
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 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 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.

134 Guide de rfrence des Composants de Talend Open Studio


tNetsuiteOutput

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.

Insert : ajouter un nouvel enregistrement vos donnes. Si un doublon est


trouv et que la case Die on error est coche, le Job s'arrte. Si la case Die
on error est dcoche, le doublon est ignor et le Job continue.

Update : apporter des modifications un enregistrement existant.

Si l'enregistrement correspondant l'ID interne (Internal ID) spcifi n'existe


pas et que la case Die on error est coche, le Job s'arrte.

Pour utiliser cette option, la colonne InternalId doit exister dans le schma
et tre dfinie comme Key.

Delete : supprimer un enregistrement existant.

Si l'enregistrement correspondant l'ID interne (Internal ID) spcifi n'existe


pas et que la case Die on error est coche, le Job s'arrte.

Pour utiliser cette option, la colonne InternalId doit exister dans le schma
et tre dfinie comme Key.

Upsert : mettre jour l'enregistrement correspondant l'ID interne spcifi


ou insrer un nouvel enregistrement s'il n'existe pas.

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.

Guide de rfrence des Composants de Talend Open Studio 135


Proprits du tNetsuiteOutput

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/


Verifying+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma du composant


prcdent.

Le schma de ce composant est pr-renseign avec des colonnes


correspondant aux champs des services NetSuite, qui varient selon
le type d'enregistrement (Record Type) slectionn. Vous pouvez
supprimer les colonnes ne concernant pas votre opration, mais
ne renommez pas de colonne du schma, cela pourrait causer des
erreurs d'excution.
Die on error Cette case est coche par dfaut. Dcochez cette case pour terminer le traitement
avec les lignes sans erreurs, 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 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.

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).

136 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Scnario associ
Aucun scnario n'est disponible pour ce composant.

Guide de rfrence des Composants de Talend Open Studio 137


tOpenbravoERPInput

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.

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.
Entity Slectionnez l'entit adquate partir de la liste droulante.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.

Pour ce composant, le schma correspond l'entit


slectionne.
WHERE Clause Saisissez votre clause WHERE.
Order by Cochez cette case afin de slectionner comment ordonner les
rsultats (les lments de la liste droulante dpendent de l'entit
slectionne).

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.

138 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Max result Saisissez le nombre maximal de rsultats que vous souhaitez


rcuprer.
Advanced settings Advanced separator (for Cochez cette option pour modifier les sparateurs utiliss pour
numbers) les nombres :

Thousands separator : dfinissez le sparateur utilis pour les


milliers.

Decimal separator : dfinissez le sparateur utilis pour les


dcimaux.
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.

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.

Scnario associ
Pour un scnario associ, consultez le composant tMicrosoftCrmInput.

Guide de rfrence des Composants de Talend Open Studio 139


tOpenbravoERPOutput

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.

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 data Slectionnez dans la liste si vous souhaitez mettre jour ou crer
des donnes (Update/Create), ou si vous prfrez en supprimer
(Remove).
Use existing data file Cochez cette case afin de slectionner votre fichier en parcourant
votre rpertoire.
Entity Slectionnez l'entit adquate partir de la liste droulante.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.
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_UPDATED : nombre de lignes mises jour. Cette variable est une variable After
et retourne un entier.

140 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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_UNAUTHORIZED : nombre de lignes non autorises. 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.

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.

Scnario associ
Pour un scnario associ, consultez le composant tMicrosoftCrmInput.

Guide de rfrence des Composants de Talend Open Studio 141


tSageX3Input

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 :

View schema : slectionnez cette option afin de voir le schma.

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 : 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.
Endpoint address Saisissez l'adresse du Service Web fourni par le serveur Web Sage X3 donn.
Username et Saisissez les informations d'authentification pour le Service Web, dfinies lors de la
Password configuration du Serveur Web Sage X3.

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";

Un outil tiers est ncessaire pour rcuprer ce type d'informations.

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.

142 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser les cls des requtes pour extraire des donnes d'un systme Sage X3 donn

Action Slectionnez dans la liste l'action effectuer.

getAllDetails : retourne les dtails de tous les enregistrements.

getSummary : retourne le rsum de chaque enregistrement.

getDetail : retourne les dtails des enregistrements rpondant aux conditions


configures dans la table Query condition.
Mapping Remplissez ce tableau pour mapper les lments variables de l'objet, le sous-programme
ou la liste dfini(e)(s) dans le serveur Web Sage X3 donn. Les colonnes complter
incluent :

Column : les colonnes dfinies dans l'diteur de schma de ce composant.

Group ID : l'identifiant de chaque groupe d'lments variables. Par exemple, un groupe


d'lments variables peut reprsenter l'un des attributs d'un objet.

Field name : le nom de chaque lment variable.


Conditions Renseignez cette table afin de configurer la (les) condition(s) de requte. Les colonnes
renseigner comprennent :

Key : les noms des lments de variables utiliss comme cl pour l'extraction de
donnes.

Value : la valeur du champ de cl donn utilis pour extraire les donnes


correspondantes.

Disponible lorsque l'option getDetail est slectionne dans la liste Action.


Query condition Cochez cette case pour paramtrer la (les) condition(s) de la requte. Les colonnes
complter incluent :

Key : le nom des lments variables utiliss comme cl de l'extraction de donnes.

Value : la valeur du champ cl donn utilis pour extraire les donnes correspondantes.

Indisponible lorsque l'option getDetail est slectionne dans la liste Action.


Limit Saisissez un chiffre ou un nombre indiquant le maximum de lignes de donnes extraire.

Indisponible lorsque l'option getDetail est slectionne dans la liste Action.


Advanced settings tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du Job ainsi qu'au niveau
Statistics 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 Gnralement utilis comme composant de dbut. Un composant de sortie est ncessaire.

Scnario : Utiliser les cls des requtes pour extraire


des donnes d'un systme Sage X3 donn
Ce scnario dcrit un Job deux composants utilis pour extraire une ligne ou des donnes d'un systme Sage
X3 donn. La mthode des objets est appele, les lments variables de cet objet sont des attributs. Les donnes
utilises dans ce scnario proviennent de l'exemple fourni par Sage X3.

Guide de rfrence des Composants de Talend Open Studio 143


Scnario : Utiliser les cls des requtes pour extraire des donnes d'un systme Sage X3 donn

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.

Configurer le schma du tSageX3Input


1. Double-cliquez sur le tSageX3Input afin de configurer ses Basic settings dans la vue Component.

2. Dans la liste Schema, slectionnez Built-In puis cliquez sur le bouton [...] ct du champ Edit schema
pour ouvrir l'diteur du schma.

144 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser les cls des requtes pour extraire des donnes d'un systme Sage X3 donn

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.

Configurer la connexion au serveur Web Sage X3


1. Dans le champ Endpoint address, saisissez l'URL du service Web fournie par le serveur Web Sage X3. Dans
cet exemple, l'URL est : http://10.42.20.168:28880/adxwsvc/services/CAdxWebServiceXmlCC.

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.

Paramtrer le mapping et configurer la condition de la requte


1. Dans les colonnes Group ID et Field name de la table Mapping, saisissez les valeurs correspondant l'ID
du groupe d'attributs et au nom de publication dfinis dans le serveur Web Sage X3. Dans cet exemple, les
valeurs sont prsentes comme suit :

Guide de rfrence des Composants de Talend Open Studio 145


Scnario : Utiliser les cls des requtes pour extraire des donnes d'un systme Sage X3 donn

Dans la table Mapping, la colonne Column a t automatiquement renseigne avec les colonnes que vous avez cres
dans l'diteur du schma.

2. Cochez la case Query condition pour activer le tableau Conditions.

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.

2. Appuyez sur F6 pour excuter le Job.

Les rsultats sont affichs dans la vue Run :

146 Guide de rfrence des Composants de Talend Open Studio


tSageX3Output

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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma du composant


prcdent.
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.
Endpoint address Saisissez l'adresse du Service Web fourni par le serveur Web Sage X3 donn.
Username et Saisissez les informations d'authentification pour le Service Web, dfinies lors de la
Password configuration du Serveur Web Sage X3.

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";

Guide de rfrence des Composants de Talend Open Studio 147


Scnario : Utiliser un service Web Sage X3 pour insrer des donnes dans un systme Sage X3 donn

Un outil tiers est ncessaire pour rcuprer ce type d'informations.

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:

Insert : insrer des donnes,

Update : mettre jour des donnes,

Delete : supprimer des donnes.


Mapping Remplissez ce tableau pour mapper les lments variables de l'objet, le sous-
programme ou la liste dfini(e)(s) dans le serveur Web Sage X3 donn au(x)quel(s)/
laquelle votre Studio Talend accde. Seuls les lments sur lesquels vous souhaitez
effectuer l'action sont slectionns et saisis dans le but de raliser le mapping. Les
colonnes complter incluent :

Column : les colonnes dfinies dans l'diteur du schma de ce composant.

Key : l'lment variable utilis comme cl de l'insertion, de la mise jour ou de


la suppression de donnes. Cochez la case correspondante si la cl est un lment
variable.

Group ID : l'identifiant de chaque groupe d'lments variables. Par exemple, un


groupe d'lments variables peut reprsenter l'un des attributs d'un objet.

Field name : le nom du champ de chaque lment variable slectionn.


Advanced settings tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du Job ainsi qu'au niveau
Statistics 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 comme composant de sortie et requiert un composant d'entre.

Scnario : Utiliser un service Web Sage X3 pour


insrer des donnes dans un systme Sage X3 donn
Ce scnario dcrit un Job deux composants, utilis pour gnrer une ligne de donnes et insrer ces donnes dans
un systme Sage X3 donn. Vous pouvez trouver les donnes utilises dans ce scnario dans l'exemple fourni par
Sage X3. Le service Web Sage X3 est utilis pour accder un objet.

148 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser un service Web Sage X3 pour insrer des donnes dans un systme Sage X3 donn

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.

Configurer le schma des donnes d'entre


1. Double-cliquez sur le tFixedFlowInput afin d'afficher sa vue Component et dfinir ses proprits.

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.

Guide de rfrence des Composants de Talend Open Studio 149


Scnario : Utiliser un service Web Sage X3 pour insrer des donnes dans un systme Sage X3 donn

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.

Configurer la connexion au serveur Web Sage X3


1. Double-cliquez sur le composant tSageX3Output afin d'afficher sa vue Component et dfinir ses proprits.

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.

7. Dans le champ Action, slectionnez insert dans la liste droulante.

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.

150 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser un service Web Sage X3 pour insrer des donnes dans un systme Sage X3 donn

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.

Guide de rfrence des Composants de Talend Open Studio 151


tSalesforceBulkExec

tSalesforceBulkExec

Les composants tSalesforceOutputBulk et tSalesforceBulkExec sont gnralement utiliss ensemble pour


gnrer en sortie le fichier dfini et excuter ensuite les actions souhaites sur votre fichier, dans votre
Salesforce.com. Cette excution en deux tapes est unifie dans le composant tSalesforceOutputBulkExec,
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.

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement
les composants de connexion du Job du mme niveau.
Login Type Deux options sont disponibles :

Basic : slectionnez cette option afin de vous connecter


Salesforce.com en saisissant vos identifiants (nom d'utilisateur et
mot de passe) dans le tSalesforceConnection.

OAuth2 : slectionnez cette option pour accder


Salesforce.com en saisissant votre Consumer key/Consumer
Secret dans le tSalesforceConnection. Ainsi, vos identifiants ne
sont pas visibles dans le tSalesforceConnection, mais un effort
supplmentaire est requis :

Dfinissez une application connecte (Connected App) sur


Salesforce.com pour obtenir votre Consumer key/Consumer
Secret. Pour plus d'informations concernant les applications
connectes, consultez Connected Apps (en anglais). Pour
plus d'informations concernant la cration d'une application
connecte, consultez Defining Remote Access Applications
(en anglais).

Lors de l'excution d'un Job, la console du Studio affiche


l'URL traiter via OAuth. Pour plus d'informations,
consultez Scnario : Utiliser OAuth2 pour vous connecter
Salesforce.com.
Salesforce Webservice URL Saisissez l'URL du service Web permettant de se connecter la
base de donnes Salesforce.
Salesforce Version Saisissez la version de Salesforce que vous utilisez.
Username et Password Saisissez les informations d'authentification de l'utilisateur au
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.

152 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSalesforceBulkExec

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.

Pour saisir le Secret du consumer, cliquez sur le bouton [...] ct


du champ Consumer Secret, puis, dans la bote de dialogue qui
s'ouvre, saisissez le Secret du consumer entre guillemets doubles
puis cliquez sur OK afin de sauvegarder les paramtres.

Pour comprendre ce qu'est une application connecte, consultez


Connected Apps (en anglais). Pour plus d'informations
concernant la cration d'une application connecte, consultez
Defining Remote Access Applications (en anglais).
Callback Host et Callback Saisissez l'URL de votre fonction de rappel pour l'authentification
Port OAuth. Cette URL (contenant l'hte et le port) est dfinie durant
la cration d'une application connecte et apparat dans la zone
OAuth Settings de l'application connecte.
Token File Saisissez le nom du jeton de fichier. Il stocke le jeton de
rafrachissement utilis pour rcuprer le jeton d'accs sans
autorisation.
Salesforce Version Saisissez la version de Salesforce que vous utilisez.
Bulk file path Rpertoire o sont stockes les donnes de masse que vous devez
traiter.
Action Vous pouvez effectuer les oprations suivantes sur les donnes
de l'objet Salesforce :

Insert : insrer des donnes.

Update : mettre jour des donnes.

Upsert : mettre jour et insrer des donnes.


Upsert Key Column Spcifiez la colonne de cl pour l'opration d'upsert.

Disponible lorsque l'option Upsert et slectionne dans la liste


Action.
Module Slectionnez l'objet adquat dans la liste.

Custom Object : cette option fait apparatre le champ Custom


Module Name dans lequel vous pouvez saisir l'objet auquel vous
souhaitez vous connecter.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.

Guide de rfrence des Composants de Talend Open Studio 153


Scnario associ

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 :

Parallel : Traite les lots en mode parallle.

Serial : Traite les lots en mode squentiel.


Wait time for checking batch Saisissez l'intervalle de temps entre les vrifications de traitement
state(milliseconds) des lots de donnes d'un Job jusqu' ce que tous les lots soient
traits.
Use Socks Proxy Cochez cette case si vous souhaitez utiliser un proxy. Une fois la
case coche, vous devez saisir les paramtres de connexion dans
les champs qui apparaissent, l'hte, le port, le nom d'utilisateur et
le mot de passe du proxy que vous souhaitez utiliser.
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_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.

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.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.

Pour plus d'informations sur les niveaux 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.

154 Guide de rfrence des Composants de Talend Open Studio


tSalesforceConnection

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.

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.

Depuis la version 5.6, les modes Built-in et Repository sont


disponibles dans n'importe quelle solution de Talend.
For salesforce bulk component Cochez cette case si vous utilisez des composants de traitement
de donnes de masse de la famille Salesforce. Une fois coche,
le champ Salesforce Version apparat. Saisissez la version de
Salesforce que vous utilisez.

Pour plus d'informations concernant ces composants


de traitement de donnes de masse,
consultez tSalesforceOutputBulk, tSalesforceBulkExec et
tSalesforceOutputBulkExec.
Login Type Deux options sont disponibles :

Basic : slectionnez cette option afin de vous connecter


Salesforce.com en saisissant vos identifiants (nom d'utilisateur
et mot de passe) dans le tSalesforceConnection.

OAuth2 : slectionnez cette option pour accder


Salesforce.com en saisissant votre Consumer key/Consumer
Secret dans le tSalesforceConnection. Ainsi, vos identifiants ne
sont pas visibles dans le tSalesforceConnection, mais un effort
supplmentaire est requis :

Dfinissez une application connecte (Connected App) sur


Salesforce.com pour obtenir votre Consumer key/Consumer
Secret. Pour plus d'informations concernant les applications
connectes, consultez Connected Apps (en anglais). Pour
plus d'informations concernant la cration d'une application
connecte, consultez Defining Remote Access Applications
(en anglais).

Lors de l'excution d'un Job, la console du Studio affiche


l'URL traiter via OAuth. Pour plus d'informations,
consultez Scnario : Utiliser OAuth2 pour vous connecter
Salesforce.com.
Salesforce Webservice URL Saisissez l'URL du service Web permettant de se connecter la
base de donnes Salesforce.
Salesforce Version Saisissez la version de Salesforce que vous utilisez.
Username et Password Saisissez les informations d'authentification de l'utilisateur au
service Web.

Guide de rfrence des Composants de Talend Open Studio 155


Proprits du tSalesforceConnection

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.
Consumer Key et Consumer Secret Saisissez les dtails de votre authentification OAuth. Ces
informations sont disponibles dans la zone OAuth Settings de
l'application connecte cre sur le site Salesforce.com.

Pour saisir le Secret du consumer, cliquez sur le bouton [...]


ct du champ Consumer Secret, puis, dans la bote de dialogue
qui s'ouvre, saisissez le Secret du consumer entre guillemets
doubles puis cliquez sur OK afin de sauvegarder les paramtres.

Pour comprendre ce qu'est une application connecte, consultez


Connected Apps (en anglais). Pour plus d'informations
concernant la cration d'une application connecte, consultez
Defining Remote Access Applications (en anglais).
Callback Host et Callback Port Saisissez l'URL de votre fonction de rappel pour
l'authentification OAuth. Cette URL (contenant l'hte et le
port) est dfinie durant la cration d'une application connecte
et apparat dans la zone OAuth Settings de l'application
connecte.
Token File Saisissez le nom du jeton de fichier. Il stocke le jeton de
rafrachissement utilis pour rcuprer le jeton d'accs sans
autorisation.
Use Soap Compression Cochez cette case pour activer la compression SOAP.

La compression des messages SOAP permet un gain


de performance.
Timeout (milliseconds) Saisissez le dlai avant suspension de la requte sur
Salesforce.com.
Output Http Trace Message Slectionnez cette option pour crire en sortie les interactions
HTTP dans la console du Studio.

Disponible lorsque l'option For salesforce bulk component est


slectionne.
Use Socks Proxy Cochez cette case si vous souhaitez utiliser un proxy. Une fois la
case coche, vous devez saisir les paramtres de connexion dans
les champs qui apparaissent, l'hte, le port, le nom d'utilisateur
et le mot de passe du proxy que vous souhaitez utiliser.
Advanced settings 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.
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.
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).

156 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser OAuth2 pour vous connecter Salesforce.com

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 : Utiliser OAuth2 pour vous connecter


Salesforce.com
Dans ce scnario, la mthode OAuth2 (Open Authorization 2.0) est adopte pour autoriser tSalesforceConnection
accder aux ressources de Salesforce.com. Ainsi, la scurit est optimise et les utilisateurs n'ont pas besoin de
saisir leur identifiant et mot de passe Salesforce directement dans le tSalesforceConnection, ncessaire pour le
type d'authentification Basic.

Relier les composants


1. Dposez un tSalesforceConnection, un tFixedFlowInput et un tSalesforceOutput de la Palette dans
l'espace de modlisation graphique.

2. Reliez le tSalesforceConnection au tFixedFlowInput l'aide d'un lien OnSubjobOk.

3. Reliez le tFixedFlowInput au tSalesforceOutput l'aide d'un lien Row > Main.

Configurer les composants


1. Double-cliquez sur le tSalesforceConnection pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 157


Scnario : Utiliser OAuth2 pour vous connecter Salesforce.com

2. Dans la liste Login Type, slectionnez OAuth2.

3. Dans les champs Consumer Key et Consumer Secret, saisissez les informations requises.

4. Double-cliquez sur le tFixedFlowInput pour ouvrir sa vue Basic settings.

Slectionnez Use Inline Content (delimited file) dans la zone Mode.

5. Dans le champ Content, saisissez les donnes crire dans Saleforce.com, par exemple :
Talend

6. Double-cliquez sur le tSalesforceOutput pour ouvrir sa vue Basic settings.

7. Cochez la case Use an existing connection.

158 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser OAuth2 pour vous connecter Salesforce.com

8. Dans la liste Action, slectionnez insert pour insrer le nom du compte, Talend.

9. Dans la liste Module, slectionnez Account.

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.

13. Cliquez sur OK pour valider les paramtres et fermer l'diteur.

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.

Guide de rfrence des Composants de Talend Open Studio 159


Scnario : Utiliser OAuth2 pour vous connecter Salesforce.com

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.

La rponse l'authentification s'affiche dans le navigateur.

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.

160 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser OAuth2 pour vous connecter Salesforce.com

Guide de rfrence des Composants de Talend Open Studio 161


tSalesforceGetDeleted

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement
les composants de connexion du Job du mme niveau.
Login Type Deux options sont disponibles :

Basic : slectionnez cette option afin de vous connecter


Salesforce.com en saisissant vos identifiants (nom d'utilisateur et
mot de passe) dans le tSalesforceConnection.

OAuth2 : slectionnez cette option pour accder


Salesforce.com en saisissant votre Consumer key/Consumer
Secret dans le tSalesforceConnection. Ainsi, vos identifiants ne
sont pas visibles dans le tSalesforceConnection, mais un effort
supplmentaire est requis :

Dfinissez une application connecte (Connected App) sur


Salesforce.com pour obtenir votre Consumer key/Consumer
Secret. Pour plus d'informations concernant les applications
connectes, consultez Connected Apps (en anglais). Pour
plus d'informations concernant la cration d'une application
connecte, consultez Defining Remote Access Applications
(en anglais).

Lors de l'excution d'un Job, la console du Studio affiche


l'URL traiter via OAuth. Pour plus d'informations,
consultez Scnario : Utiliser OAuth2 pour vous connecter
Salesforce.com.
Salesforce Webservice URL Saisissez l'URL du service Web permettant de se connecter la
base de donnes Salesforce.
Salesforce Version Saisissez la version de Salesforce que vous utilisez.
Username et Password Saisissez les informations d'authentification de l'utilisateur au
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.
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.

Pour saisir le Secret du consumer, cliquez sur le bouton [...] ct


du champ Consumer Secret, puis, dans la bote de dialogue qui

162 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSalesforceGetDeleted

s'ouvre, saisissez le Secret du consumer entre guillemets doubles


puis cliquez sur OK afin de sauvegarder les paramtres.

Pour comprendre ce qu'est une application connecte, consultez


Connected Apps (en anglais). Pour plus d'informations
concernant la cration d'une application connecte, consultez
Defining Remote Access Applications (en anglais).
Callback Host et Callback Saisissez l'URL de votre fonction de rappel pour l'authentification
Port OAuth. Cette URL (contenant l'hte et le port) est dfinie durant
la cration d'une application connecte et apparat dans la zone
OAuth Settings de l'application connecte.
Token File Saisissez le nom du jeton de fichier. Il stocke le jeton de
rafrachissement utilis pour rcuprer le jeton d'accs sans
autorisation.
Timeout (milliseconds) Saisissez le dlai avant suspension de la requte sur
Salesforce.com.
Module Slectionnez l'objet adquat dans la liste.

Custom Object : cette option fait apparatre le champ Costum


Module Name dans lequel vous pouvez saisir l'objet auquel vous
souhaitez vous connecter.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.
Start Date Saisissez entre guillemets la date laquelle vous voulez
commencer la recherche. Pour cela, utilisez le format de date
suivant : "yyyy-MM-dd HH:mm:ss".

Vous ne pouvez effectuer la recherche que sur les


30 derniers jours.
End Date Saisissez entre guillemet la date laquelle vous voulez terminer
la recherche. Pour cela, utilisez le format de date suivant : "yyyy-
MM-dd HH:mm:ss".
Advanced settings Use Soap Compression Cochez cette case pour activer la compression SOAP.

La compression des messages SOAP permet un gain de


performance.
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.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.

Guide de rfrence des Composants de Talend Open Studio 163


Scnario : Rcuprer les donnes supprimes du serveur Salesforce

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 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 : Rcuprer les donnes supprimes du


serveur Salesforce
Ce scnario dcrit un Job deux composants permettant de rcuprer les donnes supprimes du serveur
Salesforce, dans les 5 derniers jours.

Configurer le Job
1. Cliquez et dposez les composants tSalesforceGetDeleted et tLogRow de la Palette dans le Job Designer.

2. Reliez-les via un lien de type Row > Main.

Configurer la connexion au serveur Salesforce


1. Double-cliquez sur le composant tSalesforceGetDeleted pour afficher l'onglet Basic settings de la vue
Component et paramtrer ses proprits :

164 Guide de rfrence des Composants de Talend Open Studio


Scnario : Rcuprer les donnes supprimes du serveur Salesforce

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.

Paramtrer les conditions de la recherche


1. 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.

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.

4. Enregistrez votre Job et appuyez sur F6 pour l'excuter.

Guide de rfrence des Composants de Talend Open Studio 165


Scnario : Rcuprer les donnes supprimes du serveur Salesforce

La console affiche les donnes supprimes rcupres par le composant tSalesforceGetDeleted sous forme
de tableau.

166 Guide de rfrence des Composants de Talend Open Studio


tSalesforceGetServerTimestamp

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.
Login Type Deux options sont disponibles :

Basic : slectionnez cette option afin de vous connecter


Salesforce.com en saisissant vos identifiants (nom d'utilisateur et
mot de passe) dans le tSalesforceConnection.

OAuth2 : slectionnez cette option pour accder


Salesforce.com en saisissant votre Consumer key/Consumer
Secret dans le tSalesforceConnection. Ainsi, vos identifiants ne
sont pas visibles dans le tSalesforceConnection, mais un effort
supplmentaire est requis :

Dfinissez une application connecte (Connected App) sur


Salesforce.com pour obtenir votre Consumer key/Consumer
Secret. Pour plus d'informations concernant les applications
connectes, consultez Connected Apps (en anglais). Pour
plus d'informations concernant la cration d'une application
connecte, consultez Defining Remote Access Applications
(en anglais).

Lors de l'excution d'un Job, la console du Studio affiche


l'URL traiter via OAuth. Pour plus d'informations,
consultez Scnario : Utiliser OAuth2 pour vous connecter
Salesforce.com.
Salesforce Webservice URL Saisissez l'URL du service Web permettant de se connecter la
base de donnes Salesforce.

Guide de rfrence des Composants de Talend Open Studio 167


Proprits du tSalesforceGetServerTimestamp

Salesforce Version Saisissez la version de Salesforce que vous utilisez.


Username et Password Saisissez les informations d'authentification de l'utilisateur au
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.
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.

Pour saisir le Secret du consumer, cliquez sur le bouton [...] ct


du champ Consumer Secret, puis, dans la bote de dialogue qui
s'ouvre, saisissez le Secret du consumer entre guillemets doubles
puis cliquez sur OK afin de sauvegarder les paramtres.

Pour comprendre ce qu'est une application connecte, consultez


Connected Apps (en anglais). Pour plus d'informations
concernant la cration d'une application connecte, consultez
Defining Remote Access Applications (en anglais).
Callback Host et Callback Saisissez l'URL de votre fonction de rappel pour l'authentification
Port OAuth. Cette URL (contenant l'hte et le port) est dfinie durant
la cration d'une application connecte et apparat dans la zone
OAuth Settings de l'application connecte.
Token File Saisissez le nom du jeton de fichier. Il stocke le jeton de
rafrachissement utilis pour rcuprer le jeton d'accs sans
autorisation.
Timeout (milliseconds) Saisissez le dlai avant suspension de la requte sur
Salesforce.com.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.
Advanced settings Use Socks Proxy Cochez cette case si vous souhaitez utiliser un proxy. Une fois la
case coche, vous devez saisir les paramtres de connexion dans
les champs qui apparaissent, l'hte, le port, le nom d'utilisateur et
le mot de passe du proxy que vous souhaitez utiliser.
Use Soap Compression Cochez cette case pour activer la compression SOAP.

La compression des messages SOAP permet un gain de


performance.

168 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.
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.

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.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.

Pour plus d'informations sur les niveaux 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.

Guide de rfrence des Composants de Talend Open Studio 169


tSalesforceGetUpdated

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement
les composants de connexion du Job du mme niveau.
Login Type Deux options sont disponibles :

Basic : slectionnez cette option afin de vous connecter


Salesforce.com en saisissant vos identifiants (nom d'utilisateur et
mot de passe) dans le tSalesforceConnection.

OAuth2 : slectionnez cette option pour accder


Salesforce.com en saisissant votre Consumer key/Consumer
Secret dans le tSalesforceConnection. Ainsi, vos identifiants ne
sont pas visibles dans le tSalesforceConnection, mais un effort
supplmentaire est requis :

Dfinissez une application connecte (Connected App) sur


Salesforce.com pour obtenir votre Consumer key/Consumer
Secret. Pour plus d'informations concernant les applications
connectes, consultez Connected Apps (en anglais). Pour
plus d'informations concernant la cration d'une application
connecte, consultez Defining Remote Access Applications
(en anglais).

Lors de l'excution d'un Job, la console du Studio affiche


l'URL traiter via OAuth. Pour plus d'informations,
consultez Scnario : Utiliser OAuth2 pour vous connecter
Salesforce.com.
Salesforce Webservice URL Saisissez l'URL du service Web permettant de se connecter la
base de donnes Salesforce.
Salesforce Version Saisissez la version de Salesforce que vous utilisez.
Username et Password Saisissez les informations d'authentification de l'utilisateur au
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.
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.

Pour saisir le Secret du consumer, cliquez sur le bouton [...] ct


du champ Consumer Secret, puis, dans la bote de dialogue qui

170 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSalesforceGetUpdated

s'ouvre, saisissez le Secret du consumer entre guillemets doubles


puis cliquez sur OK afin de sauvegarder les paramtres.

Pour comprendre ce qu'est une application connecte, consultez


Connected Apps (en anglais). Pour plus d'informations
concernant la cration d'une application connecte, consultez
Defining Remote Access Applications (en anglais).
Callback Host et Callback Saisissez l'URL de votre fonction de rappel pour l'authentification
Port OAuth. Cette URL (contenant l'hte et le port) est dfinie durant
la cration d'une application connecte et apparat dans la zone
OAuth Settings de l'application connecte.
Token File Saisissez le nom du jeton de fichier. Il stocke le jeton de
rafrachissement utilis pour rcuprer le jeton d'accs sans
autorisation.
Timeout (milliseconds) Saisissez le dlai avant suspension de la requte sur
Salesforce.com.
Module Slectionnez l'objet adquat dans la liste.

Custom Object : cette option fait apparatre le champ Custom


Module Name dans lequel vous pouvez saisir l'objet auquel vous
souhaitez vous connecter.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.
Start Date Saisissez entre guillemet la date laquelle vous voulez
commencer la recherche. Pour cela, utilisez le modle de date
suivant : "yyyy-MM-dd HH:mm:ss".

Vous ne pouvez effectuer la recherche que sur les


30 derniers jours.
End Date Saisissez entre guillemets la date laquelle vous voulez terminer
la recherche. Pour cela, utilisez le modle de date suivant : "yyyy-
MM-dd HH:mm:ss".
Advanced settings Use Soap Compression Cochez cette case pour activer la compression SOAP.

La compression des messages SOAP permet un gain de


performance.
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.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.

Guide de rfrence des Composants de Talend Open Studio 171


Scnario associ

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 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.

172 Guide de rfrence des Composants de Talend Open Studio


tSalesforceInput

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.

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 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.

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 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.

Lorsqu'un Job contient un Job parent et un Job enfant, la


liste Component list prsente uniquement les composants de
connexion du Job du mme niveau.
Query mode Deux options sont disponibles : Query et Bulk Query.
Login Type Deux options sont disponibles :

Basic : slectionnez cette option afin de vous connecter Salesforce.com


en saisissant vos identifiants (nom d'utilisateur et mot de passe) dans le
tSalesforceConnection.

OAuth2 : slectionnez cette option pour accder Salesforce.com


en saisissant votre Consumer key/Consumer Secret dans le
tSalesforceConnection. Ainsi, vos identifiants ne sont pas visibles dans le
tSalesforceConnection, mais un effort supplmentaire est requis :

Dfinissez une application connecte (Connected App) sur


Salesforce.com pour obtenir votre Consumer key/Consumer Secret. Pour
plus d'informations concernant les applications connectes, consultez
Connected Apps (en anglais). Pour plus d'informations concernant la
cration d'une application connecte, consultez Defining Remote Access
Applications (en anglais).

Lors de l'excution d'un Job, la console du Studio affiche l'URL


traiter via OAuth. Pour plus d'informations, consultez Scnario : Utiliser
OAuth2 pour vous connecter Salesforce.com.
Salesforce Webservice URL Saisissez l'URL du service Web permettant de se connecter la base de
donnes Salesforce.
Salesforce Version Saisissez la version de Salesforce que vous utilisez.
Username et Password Saisissez les informations d'authentification de l'utilisateur au service Web.

Guide de rfrence des Composants de Talend Open Studio 173


Proprits du tSalesforceInput

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.
Consumer Key et Consumer Saisissez les dtails de votre authentification OAuth. Ces informations sont
Secret disponibles dans la zone OAuth Settings de l'application connecte cre
sur le site Salesforce.com.

Pour saisir le Secret du consumer, cliquez sur le bouton [...] ct du champ


Consumer Secret, puis, dans la bote de dialogue qui s'ouvre, saisissez le
Secret du consumer entre guillemets doubles puis cliquez sur OK afin de
sauvegarder les paramtres.

Pour comprendre ce qu'est une application connecte, consultez Connected


Apps (en anglais). Pour plus d'informations concernant la cration d'une
application connecte, consultez Defining Remote Access Applications (en
anglais).
Callback Host et Callback Saisissez l'URL de votre fonction de rappel pour l'authentification OAuth.
Port Cette URL (contenant l'hte et le port) est dfinie durant la cration
d'une application connecte et apparat dans la zone OAuth Settings de
l'application connecte.
Token File Saisissez le nom du jeton de fichier. Il stocke le jeton de rafrachissement
utiliser pour rcuprer le jeton d'accs sans autorisation.
Timeout (milliseconds) Saisissez le dlai avant suspension de la requte sur Salesforce.com.

Disponible lorsque l'option Query est slectionne dans la liste Query


mode.
Module Slectionnez l'objet adquat dans la liste.

Custom Object : cette option fait apparatre le champ Costum Module


Name dans lequel vous pouvez saisir l'objet auquel vous souhaitez vous
connecter.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Dans ce composant, le schma est relatif au Module slectionn.

Pour retrouver une colonne d'un module li, il est ncessaire


de dfinir la colonne, d'une manire prcise, dans la vue Edit
Schema, sinon la requte relationnelle ne fonctionnera pas. La
syntaxe correcte est : NameofCurrentModule_NameofLinked
Module_NameofColumnofInterest.
Query condition Saisissez la requte permettant de slectionner les donnes extraire.
Exemple : account_name= Talend'
Manual input of SOQL query Cochez cette case pour saisir manuellement la requte Salesforce que vous
souhaitez effectuer dans le champ Query.

174 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSalesforceInput

Query all records (include Cochez cette case pour interroger tous les enregistrements, y compris les
deleted records) enregistrements supprims.

Disponible lorsque l'option Query est slectionne dans la liste Query


mode.
Advanced settings Batch Size Nombre d'enregistrements dans chaque lot rcupr.

Disponible lorsque l'option Query est slectionne dans la liste Query


mode.
Use Socks Proxy Cochez cette case si vous souhaitez utiliser un proxy. Une fois la case
coche, vous devez saisir les paramtres de connexion dans les champs qui
apparaissent, l'hte, le port, le nom d'utilisateur et le mot de passe du proxy
que vous souhaitez utiliser.
Normalize delimited (for Caractre, chane ou expression rgulire utilis pour normaliser les donnes
child relationship) collectes l'aide de requtes effectues sur les relations hirarchiques entre
les diffrents objets Salesforce.

Disponible lorsque l'option Query est slectionne dans la liste Query


mode.
Column name delimiter (for Caractre, chane ou expression rgulire utilis pour sparer le nom de
child relationship) l'objet parent du nom de l'objet fils lorsque vous effectuez une requte sur
les relations hirarchiques entre les diffrents objets Salesforce.

Disponible lorsque l'option Query est slectionne dans la liste Query


mode.
Use Soap Compression Cochez cette case pour activer la compression SOAP.

La compression des messages SOAP permet un gain de


performance, notamment lors des oprations de batch.
Output Http Trace Message Cochez cette case pour crire en sortie le message HTTP Trace.

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.

Disponible lorsque l'option Query est slectionne dans la liste Query


mode.
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 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).

Guide de rfrence des Composants de Talend Open Studio 175


Scnario : Utiliser des requtes pour extraire des donnes d'une base de donnes Salesforce

Scnario : Utiliser des requtes pour extraire des


donnes d'une base de donnes Salesforce
Ce scnario dcrit un Job comprenant quatre composants, utiliss pour extraire des ensembles spcifiques de
donnes d'objets parents et enfants dans une base de donnes Salesforce.

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.

3. Reliez le tSalesforceInput_1 au tSalesforceInput_2 en utilisant un lien OnSubjobOk.

Configurer la connexion au serveur Salesforce pour l'objet parent


1. Double-cliquez sur le tSalesforceInput_1 afin de dfinir ses Basic settings dans la vue Component.

2. Dans le champ Salesforce WebService URL, saisissez l'URL de la base de donnes laquelle vous souhaitez
vous connecter.

176 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser des requtes pour extraire des donnes d'une base de donnes Salesforce

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).

Configurer la requte et le schma pour l'objet parent


1. Slectionnez le Module (objet Salesforce) que vous souhaitez interroger.

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 :

"SELECT IsWon, FiscalYear, Account.Name FROM Opportunity".

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.

Configurer la connexion au serveur Salesforce pour l'objet fils


1. Double-cliquez sur le tSalesforceInput_2 afin de dfinir ses Basic settings dans la vue Component.

Guide de rfrence des Composants de Talend Open Studio 177


Scnario : Utiliser des requtes pour extraire des donnes d'une base de donnes Salesforce

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).

Configurer la requte et le schma pour l'objet fils


1. Slectionnez le Module (objet Salesforce) que vous souhaitez interroger.

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.

178 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser des requtes pour extraire des donnes d'une base de donnes Salesforce

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.

2. Enregistrez le Job et appuyez sur F6 pour l'excuter.

Les rsultats sont affichs dans la console de la vue Run :

Guide de rfrence des Composants de Talend Open Studio 179


tSalesforceOutput

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.

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 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.

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 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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement
les composants de connexion du Job du mme niveau.
Login Type Deux options sont disponibles :

Basic : slectionnez cette option afin de vous connecter


Salesforce.com en saisissant vos identifiants (nom d'utilisateur et
mot de passe) dans le tSalesforceConnection.

OAuth2 : slectionnez cette option pour accder


Salesforce.com en saisissant votre Consumer key/Consumer
Secret dans le tSalesforceConnection. Ainsi, vos identifiants ne
sont pas visibles dans le tSalesforceConnection, mais un effort
supplmentaire est requis :

Dfinissez une application connecte (Connected App) sur


Salesforce.com pour obtenir votre Consumer key/Consumer
Secret. Pour plus d'informations concernant les applications
connectes, consultez Connected Apps (en anglais). Pour
plus d'informations concernant la cration d'une application
connecte, consultez Defining Remote Access Applications
(en anglais).

Lors de l'excution d'un Job, la console du Studio affiche


l'URL traiter via OAuth. Pour plus d'informations,
consultez Scnario : Utiliser OAuth2 pour vous connecter
Salesforce.com.
Salesforce Webservice URL Saisissez l'URL du service Web permettant de se connecter la
base de donnes Salesforce.

180 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSalesforceOutput

Salesforce Version Saisissez la version de Salesforce que vous utilisez.


Username et Password Saisissez les informations d'authentification de l'utilisateur au
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.
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.

Pour saisir le Secret du consumer, cliquez sur le bouton [...] ct


du champ Consumer Secret, puis, dans la bote de dialogue qui
s'ouvre, saisissez le Secret du consumer entre guillemets doubles
puis cliquez sur OK afin de sauvegarder les paramtres.

Pour comprendre ce qu'est une application connecte, consultez


Connected Apps (en anglais). Pour plus d'informations
concernant la cration d'une application connecte, consultez
Defining Remote Access Applications (en anglais).
Callback Host et Callback Saisissez l'URL de votre fonction de rappel pour l'authentification
Port OAuth. Cette URL (contenant l'hte et le port) est dfinie durant
la cration d'une application connecte et apparat dans la zone
OAuth Settings de l'application connecte.
Token File Saisissez le nom du jeton de fichier. Il stocke le jeton de
rafrachissement utilis pour rcuprer le jeton d'accs sans
autorisation.
Timeout (milliseconds) Saisissez le dlai avant suspension de la requte sur
Salesforce.com.
Action Vous pouvez effectuer l'une des oprations suivantes sur les
donnes de l'objet Salesforce :

Insert : insrer les donnes.

Update : mettre les donnes jour.

Delete : supprimer les donnes.

Upsert : mettre jour et insrer les donnes.


Upsert Key Column Spcifiez la colonne de cl pour l'opration d'upsert.

Disponible lorsque l'option Upsert et slectionne dans la liste


Action.
Module Slectionnez l'objet adquat dans la liste.

Custom Object : cette option fait apparatre le champ Costum


Module Name dans lequel vous pouvez saisir l'objet auquel vous
souhaitez vous connecter.
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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option


pour passer le schma en mode Built-In et effectuer des
modifications locales.

Guide de rfrence des Composants de Talend Open Studio 181


Proprits du tSalesforceOutput

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 settings Extended Output Cette case est coche par dfaut. Elle permet de transfrer les
donnes de sortie en lot. Dans le champ Rows to commit,
spcifiez le nombre de lignes par lot.
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 erreurs, et ignorer les lignes en erreur. Vous pouvez
rcuprer les lignes en erreur, si vous le souhaitez. Pour cela,
utilisez un lien Row > Reject.

Le lien Reject est disponible uniquement lorsque


les cases Extended Output et Die on error sont
dcoches.
Error logging file Renseignez ce champ si vous souhaitez crer un fichier contenant
les logs d'erreur. Pour cela, cliquez sur le bouton [...] ct de ce
champ pour dfinir le chemin d'accs et le nom du fichier
Use Socks Proxy Cochez cette case si vous souhaitez utiliser un proxy. Une fois la
case coche, vous devez saisir les paramtres de connexion dans
les champs qui apparaissent, l'hte, le port, le nom d'utilisateur et
le mot de passe du proxy que vous souhaitez utiliser.
Ignore NULL fields values Cochez cette case pour ignorer les valeurs nulles en mode Update
ou Upsert.
Use Soap Compression Cochez cette case pour activer la compression SOAP.

La compression des messages SOAP permet un gain de


performance.
Retrieve inserted ID Cochez cette case afin de permettre Salesforce.com de retourner
l'ID Salesforce produit pour une nouvelle ligne devant tre
insre. La colonne ID est ajoute au schma des donnes traites
dans Salesforce.com.

Cette option est disponible uniquement si vous avez


slectionn l'action Insert, mais non en mode batch,
c'est--dire sans l'option Extended Output.
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.
Relationship mapping for Cliquez sur le bouton [+] pour ajouter des lignes et spcifiez les
upsert (pour upsert champs d'IDs externes du flux d'entre, les champs de relations
uniquement) lookup dans le module d'upsert, le module de lookup, ainsi que
les champs d'ID externes dans le module de lookup.

Column name of Talend schema : champ d'ID externe dans le


flux d'entre.

Lookup field name : champ de relations lookup dans le module


d'upsert.

Module name : nom du module de lookup.

External id name : champ d'ID externe dans le module de


lookup.

Column name of Talend schema fait rfrence


aux champs du schma du composant prcdent
le tSalesforceOutput. Ces colonnes sont mises
en correspondance par rapport aux champs d'IDs
externes spcifis dans la colonne External id

182 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Supprimer des donnes de l'objet Account

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.
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_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.

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.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.

Pour plus d'informations sur les niveaux 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 1 : Supprimer des donnes de l'objet


Account
Ce scnario dcrit un Job deux composants permettant de supprimer une entre de l'objet Account.

Dposer et relier les composants


1. Cliquez et dposez les composants tSalesforceInput et tSalesforceOutput de la Palette dans le Job
Designer.

2. Reliez-les via un lien de type Row > Main.

Guide de rfrence des Composants de Talend Open Studio 183


Scnario 1 : Supprimer des donnes de l'objet Account

Effectuer une requte sur le contenu effacer

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.

Supprimer le contenu interrog

1. Double-cliquez sur le composant tSalesforceOutput pour afficher l'onglet Basic settings de la vue
Component et paramtrer ses proprits :

184 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Rassembler des donnes en erreur tout en insrant des donnes dans un module sur Salesforce.com

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.

8. Enregistrez le Job et appuyez sur F6 pour l'excuter.

Consultez le contenu de l'objet Account et vrifiez que le compte sForce a t supprim du serveur.

Scnario 2 : Rassembler des donnes en erreur


tout en insrant des donnes dans un module sur
Salesforce.com
Dans ce scnario, les donnes d'un fichier local sont insres dans le module AdditionalNumber. Pendant ce
temps, les donnes en erreur de ce fichier sont collectes via un lien Row > Reject.

Dposer et relier les composants


1. Dposez les composants suivants de la Palette dans l'espace de modlisation graphique :
tFileInputDelimited, tSalesforceOutput et deux tLogRow.

2. Renommez le tFileInputDelimited en DataToInsert, le tSalesforceOutput en InsertToSalesforce et les deux


tLogRow en DataInserted et DataRejected, respectivement.

3. Reliez le DataToInsert au InsertToSalesforce l'aide d'un lien Row > Main.

4. Reliez le InsertToSalesforce au DataInserted l'aide d'un lien Row > Main.

5. Reliez le InsertToSalesforce au DataRejected l'aide d'un lien Row > Reject.

Guide de rfrence des Composants de Talend Open Studio 185


Scnario 2 : Rassembler des donnes en erreur tout en insrant des donnes dans un module sur Salesforce.com

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.

Configurer la source des donnes

1. Double-cliquez sur le composant DataToInsert pour ouvrir sa vue Basic settings dans l'onglet Component.

2. Dans la liste Property Type, slectionnez Built-In.

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.

Configurer le module pour l'insertion de donnes

1. Double-cliquez sur le InsertToSalesforce pour ouvrir sa vue Basic settings dans l'onglet Component.

186 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Rassembler des donnes en erreur tout en insrant des donnes dans un module sur Salesforce.com

2. Dans le champ Username, saisissez votre identifiant, par exemple, cantoine@talend.com.

3. Dans le champ Password, saisissez votre mot de passe, par exemple, talendehmrEvHz2xZ8f2KlmTCymS0XU.

4. Dans la liste Action, slectionnez insert.

5. Dans la liste Module, slectionnez AdditionalNumber.

Les cases Extended Output et Die on error ont prcdemment t dcoches dans la vue Advanced settings afin
de faire apparatre le lien Reject.

6. Laissez les autres champs tels qu'ils sont.

Configurer l'affichage des rsultats et excuter le Job

1. Double-cliquez sur le composant DataInserted pour ouvrir sa vue Basic settings.

2. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour une meilleure prsentation
des rsultats.

3. Rptez l'opration pour le composant DataRejected.

4. Appuyez sur Ctrl+S pour sauvegarder votre Job.

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.

Guide de rfrence des Composants de Talend Open Studio 187


Scnario 3 : Insrer des ID d'un fichier Excel vers le Module Contact

Comme affich dans la capture d'cran, les donnes de deux champs Call Center ID sont incorrectes.

Scnario 3 : Insrer des ID d'un fichier Excel vers le


Module Contact
Dans ce scnario, les AccountIDs d'un fichier Excel sont insrs dans le module Contact sur
www.salesforce.com selon la correspondance des champs LastName et Name.

Dposer les composants


1. Glissez-dposez les composants suivants de la Palette dans l'espace de modlisation graphique : un
tFileInputExcel, un tSalesforceIntput, un tMap et un tSalesforceOutput.

2. Renommez le tFileInputExcel en excel_source, le tSalesforceIntput en load_salesforce_data, le tMap en


match_and_output et le tSalesforceOutput en insert_to_contact_module.

3. Reliez les composants l'aide de liens Row > Main.

Configurer les composants


Configurer le fichier Excel source
1. Double-cliquez sur le composant nomm excel_source pour ouvrir sa vue Component.

188 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Insrer des ID d'un fichier Excel vers le Module Contact

2. Cliquez sur le bouton [...] ct du champ File name/Stream afin de slectionner le fichier source.

Il se prsente comme suit :

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.

Configurer le module de destination et l'opration souhaite

1. Double-cliquez sur le composant nomm insert_to_contact_module pour ouvrir sa vue Component.

Guide de rfrence des Composants de Talend Open Studio 189


Scnario 3 : Insrer des ID d'un fichier Excel vers le Module Contact

2. Dans les champs Username et Password, saisissez vos informations de connexion.

3. Slectionnez insert dans la liste Action et Contact dans la liste Module.

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.

6. Cliquez sur OK pour fermer l'diteur.

Configurer la source de rfrence et tablir le mapping

1. Double-cliquez sur load_salesforce_data pour ouvrir sa vue Component.

190 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Insrer des ID d'un fichier Excel vers le Module Contact

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.

4. Dans le champ Query Condition, supprimez le texte.

5. Double-cliquez sur match_and_output afin d'ouvrir l'diteur de mapping.

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.

8. Cliquez sur OK pour fermer l'diteur.

Guide de rfrence des Composants de Talend Open Studio 191


Scnario 4 : Effectuer un upsert du module Contact selon les relations de mapping avec les ID externes dans le module Account

Excuter le Job
1. Appuyez sur Ctrl+S pour sauvegarder votre Job.

2. Appuyez sur F6 pour excuter le Job.

Scnario 4 : Effectuer un upsert du module Contact


selon les relations de mapping avec les ID externes
dans le module Account
Ce scnario effectue un upsert des enregistrements du module Contact selon le mapping (matching) par rapport
aux ID externes dans le module Account :

Relier les composants


1. Dposez un tSalesforceConnection, deux tFixedFlowInput, deux tSalesforceInput, deux
tSalesforceOutput et deux tLogRow de la Palette dans l'espace de modlisation graphique.

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.

3. Reliez le tSalesforceConnection au external ids to insert l'aide d'un lien OnSubjobOk.

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.

9. Reliez le emails to upsert au Contact (in) l'aide d'un lien OnSubjobOk.

10. Reliez le composant Contact (in) au emails upserted l'aide d'un lien Row > Main.

192 Guide de rfrence des Composants de Talend Open Studio


Scnario 4 : Effectuer un upsert du module Contact selon les relations de mapping avec les ID externes dans le module Account

Configurer les composants


1. Double-cliquez sur le tSalesforceConnection pour ouvrir sa vue Basic settings.

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.

Guide de rfrence des Composants de Talend Open Studio 193


Scnario 4 : Effectuer un upsert du module Contact selon les relations de mapping avec les ID externes dans le module Account

3. Cliquez sur le bouton Edit schema pour ouvrir l'diteur de schma.

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.

Cliquez sur OK pour fermer l'diteur.

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.

194 Guide de rfrence des Composants de Talend Open Studio


Scnario 4 : Effectuer un upsert du module Contact selon les relations de mapping avec les ID externes dans le module Account

Cochez la case Use an existing connection.

Slectionnez insert dans la liste Action et Account dans la liste Module.

5. Double-cliquez sur Account (in) pour ouvrir sa vue Basic settings.

Cochez la case Use an existing connection.

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%'".

6. Cliquez sur le bouton Edit schema pour ouvrir l'diteur de schma.

Guide de rfrence des Composants de Talend Open Studio 195


Scnario 4 : Effectuer un upsert du module Contact selon les relations de mapping avec les ID externes dans le module Account

Cliquez trois fois sur le bouton [+] pour ajouter trois colonnes. Nommez-les respectivement Name,
AccountID__c et AccountBizLicense__c, toutes de type String.

Cliquez sur OK pour fermer l'diteur.

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.

8. Double-cliquez sur emails to upsert pour ouvrir sa vue Basic settings.

9. Cliquez sur le bouton Edit schema pour ouvrir l'diteur du schma.

196 Guide de rfrence des Composants de Talend Open Studio


Scnario 4 : Effectuer un upsert du module Contact selon les relations de mapping avec les ID externes dans le module Account

Cliquez quatre fois sur le bouton [+] pour ajouter quatre colonnes. Nommez-les Email, AccountID,
AccountBizLicense et LastName, toutes de type String.

Cliquez sur OK pour fermer l'diteur.

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.

Cochez la case Use an existing connection.

Slectionnez upsert dans la liste Action, Email dans la liste Upsert Key Column et Contact dans la liste
Module.

Cliquez sur l'onglet Advanced settings afin de configurer le mapping relationnel :

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 du module dans la colonne Module name, savoir Account.

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.

Guide de rfrence des Composants de Talend Open Studio 197


Scnario 4 : Effectuer un upsert du module Contact selon les relations de mapping avec les ID externes dans le module Account

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.

Cochez la case Use an existing connection.

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.

Cliquez sur OK pour fermer l'diteur.

13. Double-cliquez sur le composant emails upserted pour ouvrir sa vue Basic settings.

198 Guide de rfrence des Composants de Talend Open Studio


Scnario 4 : Effectuer un upsert du module Contact selon les relations de mapping avec les ID externes dans le module Account

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.

2. Appuyez sur F6 pour excuter le Job.

Comme affich ci-dessus, les actions d'insertion et de mise jour ont bien t effectues.

Guide de rfrence des Composants de Talend Open Studio 199


tSalesforceOutputBulk

tSalesforceOutputBulk

Les composants tSalesforceOutputBulk et tSalesforceBulkExec sont gnralement utiliss ensemble pour


gnrer en sortie le fichier dfini et excuter ensuite les actions souhaites sur votre fichier, dans votre
Salesforce.com. Cette excution en deux tapes est unifie dans le composant tSalesforceOutputBulkExec,
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.

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.
Ignore NULL fields values Cochez cette case pour ignorer les valeurs nulles en mode Update
ou Upsert.
Advanced settings Relationship mapping for Cliquez sur le bouton [+] pour ajouter des lignes et spcifiez les
upsert (pour upsert champs d'ID externes du flux d'entre, les champs de relations
uniquement) lookup dans le module d'upsert, le module de lookup ainsi que
les champs d'ID externes dans le module de lookup.

De plus, la case Polymorphic doit tre coche uniquement


lorsque les champs polymorphiques sont utiliss pour le
mapping de relations. Pour plus d'informations concernant
les champs polymorphiques, recherchez polymorphic sur
http://www.salesforce.com/us/developer/docs/api_asynch/ (en
anglais).

200 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSalesforceOutputBulk

Column name of Talend schema : champ d'ID externe dans le


flux d'entre.

Lookup field name : champ de relation lookup dans le module


d'upsert.

External id name : champ d'ID externe dans le module de


lookup.

Polymorphic : cochez cette case uniquement lorsque les champs


polymorphiques sont utiliss pour le mapping de relations.

Module name : nom du module de lookup.

Column name of Talend schema fait rfrence


aux champs du schma du composant prcdent
le tSalesforceOutput. Ces colonnes sont mises
en correspondance par rapport aux 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.

Cochez la case Polymorphic uniquement pour


les champs polymorphiques. Vous pouvez obtenir
une erreur si vous ne cochez pas cette case pour
un champ polymorphique. Vous pouvez galement
obtenir une erreur si vous la slectionnez pour un
champ qui n'est pas polymorphique.
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.

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 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

Guide de rfrence des Composants de Talend Open Studio 201


Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com

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 : Insrer des donnes de masse


transformes dans votre Salesforce.com
Ce scnario dcrit un Job six composants qui transforme des donnes .csv appropries un traitement de masse,
les charge dans Salesforce.com et affiche ensuite les rsultats de l'excution du Job dans la console.

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.

Afin de crer et excuter ce Job, procdez comme suit :

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.

202 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com

4. Utilisez un lien Trigger > OnSubjobOk afin de connecter le composant tFileInputDelimited au


tSalesforceBulkExec.

Configurer le composant d'entre


1. Double-cliquez sur le tFileInputDelimited afin d'afficher sa vue Component et dfinir ses proprits.

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. Glissez-dposez toutes les colonnes de la table d'entre dans la table de sortie.

Guide de rfrence des Composants de Talend Open Studio 203


Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com

Ajoutez .toUpperCase() la fin de la colonne Name.

3. Cliquez sur OK afin de valider la transformation.

Dfinir le chemin de sortie


1. Double-cliquez sur le tSalesforceOutputBulk afin d'afficher sa vue Component et dfinir ses proprits.

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.

Configurer la connexion au serveur Salesforce


1. Double-cliquez sur le tSalesforceBulkExect afin d'afficher sa vue Component et dfinir ses proprits.

2. Utilisez l'URL par dfaut du service Web Salesforce, ou saisissez l'URL laquelle vous souhaitez accder.

204 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com

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.

Configurer le composant de sortie


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.

4. Rptez l'opration avec le tLogRow_2.

Excuter le Job
1. Sauvegardez votre Job.

2. Appuyez sur F6 pour l'excuter.

Dans la console de la vue Run, vous pouvez vrifier les rsultats d'excution.

Guide de rfrence des Composants de Talend Open Studio 205


Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com

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.

Tous les noms de clients sont crits en majuscules.

206 Guide de rfrence des Composants de Talend Open Studio


tSalesforceOutputBulkExec

tSalesforceOutputBulkExec

Les composants tSalesforceOutputBulk et tSalesforceBulkExec sont gnralement utiliss ensemble pour


gnrer en sortie le fichier dfini et excuter ensuite les actions souhaites sur votre fichier, dans votre
Salesforce.com. Cette excution en deux tapes est unifie dans le composant tSalesforceOutputBulkExec.
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.

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement
les composants de connexion du Job du mme niveau.
Login Type Deux options sont disponibles :

Basic : slectionnez cette option afin de vous connecter


Salesforce.com en saisissant vos identifiants (nom d'utilisateur et
mot de passe) dans le tSalesforceConnection.

OAuth2 : slectionnez cette option pour accder


Salesforce.com en saisissant votre Consumer key/Consumer
Secret dans le tSalesforceConnection. Ainsi, vos identifiants ne
sont pas visibles dans le tSalesforceConnection, mais un effort
supplmentaire est requis :

Dfinissez une application connecte (Connected App) sur


Salesforce.com pour obtenir votre Consumer key/Consumer
Secret. Pour plus d'informations concernant les applications
connectes, consultez Connected Apps (en anglais). Pour
plus d'informations concernant la cration d'une application
connecte, consultez Defining Remote Access Applications
(en anglais).

Lors de l'excution d'un Job, la console du Studio affiche


l'URL traiter via OAuth. Pour plus d'informations,
consultez Scnario : Utiliser OAuth2 pour vous connecter
Salesforce.com.
Salesforce Webservice URL Saisissez l'URL du service Web permettant de se connecter la
base de donnes Salesforce.
Salesforce Version Saisissez la version de Salesforce que vous utilisez.
Username et Password Saisissez les informations d'authentification de l'utilisateur au
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.

Guide de rfrence des Composants de Talend Open Studio 207


Proprits du tSalesforceOutputBulkExec

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.

Pour saisir le Secret du consumer, cliquez sur le bouton [...] ct


du champ Consumer Secret, puis, dans la bote de dialogue qui
s'ouvre, saisissez le Secret du consumer entre guillemets doubles
puis cliquez sur OK afin de sauvegarder les paramtres.

Pour comprendre ce qu'est une application connecte, consultez


Connected Apps (en anglais). Pour plus d'informations
concernant la cration d'une application connecte, consultez
Defining Remote Access Applications (en anglais).
Callback Host et Callback Saisissez l'URL de votre fonction de rappel pour l'authentification
Port OAuth. Cette URL (contenant l'hte et le port) est dfinie durant
la cration d'une application connecte et apparat dans la zone
OAuth Settings de l'application connecte.
Token File Saisissez le nom du jeton de fichier. Il stocke le jeton de
rafrachissement utiliser pour rcuprer le jeton d'accs sans
autorisation.
Bulk file path Chemin d'accs au rpertoire o sont stockes les donnes de
masse traiter.
Action Vous pouvez effectuer l'une des oprations suivantes sur les
donnes de l'objet Salesforce :

Insert : insrer les donnes.

Update : mettre les donnes jour.

Upsert : mettre jour et insrer les donnes.

Delete : supprimer les donnes.


Upsert Key Column Spcifiez la colonne de cl pour l'opration d'upsert.

Disponible lorsque l'option Upsert et slectionne dans la liste


Action.
Module Slectionnez l'objet adquat dans la liste.

Custom Object : cette option fait apparatre le champ Custom


Module Name dans lequel vous pouvez saisir l'objet auquel vous
souhaitez vous connecter.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.

208 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSalesforceOutputBulkExec

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 :

Parallel : Traite les lots en mode parallle.

Serial : Traite les lots en mode squentiel.


Wait time for checking batch Saisissez l'intervalle de temps entre les vrifications de traitement
state(milliseconds) des lots de donnes d'un Job jusqu' ce que tous les lots soient
traits.
Use Socks Proxy Cochez cette case si vous souhaitez utiliser un proxy. Dans ce cas,
vous devez renseigner les paramtres du proxy dans les champs
qui apparaissent, une fois la case coche.
Ignore NULL fields values Cochez cette case pour ignorer les valeurs nulles en mode Update
ou Upsert.
Relationship mapping for Cliquez sur le bouton [+] pour ajouter des lignes et spcifiez les
upsert (pour upsert champs d'ID externes du flux d'entre, les champs de relations
uniquement) lookup dans le module d'upsert, le module de lookup ainsi que
les champs d'ID externes dans le module de lookup.

De plus, la case Polymorphic doit tre coche uniquement


lorsque les champs polymorphiques sont utiliss pour le
mapping de relations. Pour plus d'informations concernant
les champs polymorphiques, recherchez polymorphic sur
http://www.salesforce.com/us/developer/docs/api_asynch/ (en
anglais).

Column name of Talend schema : champ d'ID externe dans le


flux d'entre.

Lookup field name : champ de relation lookup dans le module


d'upsert.

External id name : champ d'ID externe dans le module de


lookup.

Polymorphic : cochez cette case uniquement lorsque les champs


polymorphiques sont utiliss pour le mapping de relations.

Module name : nom du module de lookup.

Column name of Talend schema fait rfrence


aux champs du schma du composant prcdent
le tSalesforceOutput. Ces colonnes sont mises
en correspondance par rapport aux 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.

Cochez la case Polymorphic uniquement pour


les champs polymorphiques. Vous pouvez obtenir
une erreur si vous ne cochez pas cette case pour
un champ polymorphique. Vous pouvez galement

Guide de rfrence des Composants de Talend Open Studio 209


Scnario : Insrer des donnes de masse dans votre Salesforce.com

obtenir une erreur si vous la slectionnez pour un


champ qui n'est pas polymorphique.
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.
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

Scnario : Insrer des donnes de masse dans votre


Salesforce.com
Ce scnario dcrit un Job quatre composants qui charge des donnes en masse dans Salesforce.com, excute les
actions dfinies, et affiche les rsultats d'excution du Job dans la console.

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.

Afin de crer et excuter le Job, procdez comme suit :

Configurer le Job
1. Glissez-dposez de la Palette dans l'espace de modlisation graphique un composant tFileInputDelimited,
un tSalesforceOutputBulkExec, et deux tLogRow.

2. Utilisez un lien Row > Main pour connecter le tFileInputDelimited au tSalesforceOutputBulkExec.

3. Utilisez un lien Row > Main et un lien Row > Reject afin de connecter le tSalesforceOutputBulkExec aux
deux tLogRow respectifs.

210 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes de masse dans votre Salesforce.com

Configurer les donnes d'entre


1. Double-cliquez sur le tFileInputDelimited afin d'afficher sa vue Component et dfinir ses proprits.

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...

Configurer la connexion au serveur Salesforce


1. Double-cliquez sur le composant tSalesforceOutputBulkExec afin d'afficher sa vue Component et dfinir
ses proprits.

Guide de rfrence des Composants de Talend Open Studio 211


Scnario : Insrer des donnes de masse dans votre Salesforce.com

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.

Le fichier de masse traiter doit tre au format .csv.

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.

4. Rptez l'opration pour le tLogRow_2.

5. Sauvegardez votre Job et appuyez sur F6 afin de l'excuter.

212 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes de masse dans votre Salesforce.com

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.

Guide de rfrence des Composants de Talend Open Studio 213


tSalesforceWaveBulkExec

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.

La liste Schema et le bouton Editor schema ne sont pas disponibles pas si la


case Custom JSON Metadata est coche.
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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour passer le


schma en mode Built-In et effectuer des modifications locales.

214 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSalesforceWaveBulkExec

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].
Operation Slectionnez l'opration effectuer sur l'ensemble de donnes :

Append : Ajoute toutes les donnes l'ensemble de donnes. Cre un


ensemble de donnes s'il n'existe pas.

Upsert : Insre ou met jour des lignes dans l'ensemble de donnes. Cre
un ensemble de donnes s'il n'existe pas.

Overwrite : Cre un nouvel ensemble de donnes partir des donnes


fournies et remplace l'ensemble de donnes s'il existe dj.

Delete : Supprime les lignes de l'ensemble de donnes.

Un fichier de mtadonnes JSON est requis pour les oprations


Append, Upsert et Delete.

Les donnes et les mtadonnes des oprations Append et


Upsert doivent correspondre l'ensemble de donnes sur lequel
l'opration est effectue. Toutes les colonnes, les dimensions et les
mesures doivent correspondre parfaitement.

L'opration Append n'est pas autorise si vous dfinissez


n'importe quelle colonne comme tant la cl primaire.

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.

Les mtadonnes pour l'opration Delete doivent tre un sous-


ensemble des colonnes de l'ensemble de donnes.
Name Saisissez le nom de l'ensemble de donnes dans lequel charger les donnes.
CSV File Spcifiez le chemin vers le fichier CSV charger.
Advanced settings Encoding Slectionnez le type d'encodage utilis pour gnrer le fichier de mtadonnes
JSON qui dcrit la structure des donnes charger.
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.

Ce champ est disponible uniquement lorsque la case Auto Generate JSON


Metadata Description n'est pas coche.
Unique API Name Spcifiez le nom unique de l'API pour l'objet dans la description des
mtadonnes JSON.

Ce champ est disponible uniquement lorsque la case Auto Generate JSON


Metadata Description n'est pas coche.
Label Spcifiez le nom afficher pour l'objet dans la description des mtadonnes
JSON.

Ce champ est disponible uniquement lorsque la case Auto Generate JSON


Metadata Description n'est pas coche.
Fully Qualified Name Spcifiez le chemin complet qui identifie de manire unique l'enregistrement
dans la description des mtadonnes JSON.

Ce champ est disponible uniquement lorsque la case Auto Generate JSON


Metadata Description n'est pas coche.
Custom JSON Meatadata Cochez cette case pour utiliser un fichier de mtadonnes JSON personnalis.

Cette case est disponible uniquement lorsque la case Auto Generate JSON
Metadata Description n'est pas coche.

Guide de rfrence des Composants de Talend Open Studio 215


Scnario associ

JSON Meatadata Spcifiez le chemin vers le fichier de mtadonnes JSON personnalis.

Ce champ est disponible uniquement lorsque la case Custom JSON Metadata


est coche.
Generate JSON in File Cochez cette case pour crire la description des mtadonnes JSON dans un
fichier local.

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.

Ce champ est disponible uniquement lorsque la case Generate JSON in File


est coche.
tStatCatcher Statistics Cochez cette case pour rcuprer les mtadonnes relatives l'excution du Job,
au niveau du Job et 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 peut tre utilis en standalone.

Scnario associ
Pour un scnario associ, consultez Scnario : Insrer des donnes de masse transformes dans votre
Salesforce.com.

216 Guide de rfrence des Composants de Talend Open Studio


tSalesforceWaveOutputBulkExec

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.

La liste Schema et le bouton Editor schema ne sont pas disponibles lorsque la


case Custom JSON Metadata est coche.
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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour passer le


schma en mode Built-In et effectuer des modifications locales.

Guide de rfrence des Composants de Talend Open Studio 217


Proprits du tSalesforceWaveOutputBulkExec

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma du composant


prcdent.
Operation Slectionnez l'opration effectuer sur l'ensemble de donnes :

Append : Ajoute toutes les donnes l'ensemble de donnes. Cre un


ensemble de donnes s'il n'existe pas.

Upsert : Insre ou met jour des lignes dans l'ensemble de donnes. Cre
un ensemble de donnes s'il n'existe pas.

Overwrite : Cre un nouvel ensemble de donnes partir des donnes


fournies et remplace l'ensemble de donnes s'il existe dj.

Delete : Supprime les lignes de l'ensemble de donnes.

Un fichier de mtadonnes JSON est requis pour les oprations


Append, Upsert et Delete.

Les donnes et les mtadonnes des oprations Append et


Upsert doivent correspondre l'ensemble de donnes sur lequel
l'opration est effectue. Toutes les colonnes, les dimensions et les
mesures doivent correspondre parfaitement.

L'opration Append n'est pas autorise si vous dfinissez


n'importe quelle colonne comme tant la cl primaire.

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.

Les mtadonnes pour l'opration Delete doivent tre un sous-


ensemble des colonnes de l'ensemble de donnes.
Name Saisissez le nom de l'ensemble de donnes dans lequel charger les donnes.
Generated CSV File Spcifiez le chemin vers le fichier CSV gnrer.
Append Cochez cette case pour crire la suite les donnes dans le fichier local spcifi
s'il existe au lieu de l'craser.
Include Header Cochez cette case pour inclure l'en-tte des colonnes dans le fichier.
Advanced settings Encoding Slectionnez le type d'encodage utilis pour gnrer le fichier de mtadonnes
JSON qui dcrit la structure des donnes charger.
Create directory if not Cochez cette case pour crer, s'il n'existe pas, le rpertoire spcifi dans le
exists champ Generated CSV File.
Custom the flush buffer Cochez cette case pour spcifier le nombre de lignes crire avant de vider la
size mmoire tampon.
Row number Spcifiez le nombre de lignes crire avant de vider la mmoire tampon.

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.

Ce champ est disponible uniquement lorsque la case Auto Generate JSON


Metadata Description n'est pas coche.
Unique API Name Spcifiez le nom unique de l'API pour l'objet dans la description des
mtadonnes JSON.

218 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Ce champ est disponible uniquement lorsque la case Auto Generate JSON


Metadata Description n'est pas coche.
Label Spcifiez le nom afficher pour l'objet dans la description des mtadonnes
JSON.

Ce champ est disponible uniquement lorsque la case Auto Generate JSON


Metadata Description n'est pas coche.
Fully Qualified Name Spcifiez le chemin complet qui identifie de manire unique l'enregistrement
dans la description des mtadonnes JSON.

Ce champ est disponible uniquement lorsque la case Auto Generate JSON


Metadata Description n'est pas coche.
Custom JSON Metadata Cochez cette case pour utiliser un fichier de mtadonnes JSON personnalis.

Cette case s'affiche uniquement lorsque la case Auto Generate JSON


Metadata Description n'est pas coche.
JSON Metadata Spcifiez le chemin vers le fichier de mtadonnes JSON personnalis.

Ce champ est disponible uniquement lorsque la case Custom JSON Metadata


est coche.
Generate JSON in File Cochez cette case pour crire la description des mtadonnes JSON dans un
fichier local.

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.

Ce champ est disponible uniquement lorsque la case Generate JSON in File


est coche.
tStatCatcher Statistics Cochez cette case pour rcuprer les mtadonnes relatives l'excution du Job,
au niveau du Job et 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 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.

Guide de rfrence des Composants de Talend Open Studio 219


tSAPBWInput

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

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.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].
JDBC URL Saisissez l'URL JDBC dans le champ associ pour vous connecter
la base de donnes. Par exemple, saisissez : jdbc:jdbc4olap://
adresse IP/nom de la base de donnes pour vous connecter une
base de donnes SAP BW.
Username Saisissez l'identifiant d'authentification la base de donnes.
Password Saisissez le mot de passe d'authentification 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.
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.

220 Guide de rfrence des Composants de Talend Open Studio


Scnario : Lire des donnes d'une base de donnes SAP BW

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.
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.
Advanced settings Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et en
columns fin de champ dans toutes les colonnes contenant des chanes de
caractres.
Trim column Supprimez les espaces en dbut et en fin de champ dans les
colonnes slectionnes.

Dcochez la case Trim all the String/Char columns


pour activer la case Trim columns.
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.
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.

Scnario : Lire des donnes d'une base de donnes


SAP BW
Ce scnario dcrit un Job comprenant deux composants, lisant des donnes d'une base de donnes SAP BW. Les
donnes rcupres sont affiches dans la console.

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 :

Guide de rfrence des Composants de Talend Open Studio 221


Scnario : Lire des donnes d'une base de donnes SAP BW

- 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).

Dans ce scnario, les quatre oprations suivantes sont ncessaires :

1. Configurez le Job.

2. Configurez la connexion JDBC au serveur SAP BW.

3. Configurez une requte.

4. Affichez les donnes rcupres dans la console.

Configurer le Job
1. Dposez un composant tSAPBWInput et un tLogRow de la Palette dans l'espace de modlisation graphique.

2. Connectez le tSAPBWInput au tLogRow l'aide d'un lien Main > Row.

Configurer la connexion JDBC au serveur SAP BW


1. Double-cliquez sur le composant tSAPBWInput pour ouvrir sa vue Basic settings et configurer ses
proprits.

222 Guide de rfrence des Composants de Talend Open Studio


Scnario : Lire des donnes d'une base de donnes SAP BW

2. Dans le champ JDBC URL, saisissez l'URL de votre serveur jdbc4olap.

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.

Configurer une requte


1. Dans la vue Basic settings du composant tSAPBWInput, dans le champ Table Name, saisissez le nom de
la table. Dans ce scnario, le nom de la table "Measures" est uniquement pour dmonstration.

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,

Guide de rfrence des Composants de Talend Open Studio 223


Scnario : Lire des donnes d'une base de donnes SAP BW

\"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).

Afficher les donnes rcupres dans la console


1. Double-cliquez sur le composant tLogRow pour ouvrir sa vue Basic settings et configurer ses proprits.

2. Cliquez sur le bouton Sync columns pour rcuprer le schma dfini dans le composant prcdent.

3. Slectionnez Table dans la zone Mode.

4. Appuyez sur Ctrl+S pour sauvegarder votre Job et appuyez sur F6 pour l'excuter.

Les donnes de la table "Measure" sont rcupres et affiches dans la console.

224 Guide de rfrence des Composants de Talend Open Studio


tSAPCommit

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.

Si vous utilisez un lien Row>Main pour relier le


tSAPCommit votre Job, vos donnes seront commites
ligne par ligne. Dans ce cas, ne cochez pas la case Release
connection, ou votre connexion sera ferme avant la fin
du commit de votre premire ligne.
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.

Lorsqu'un paramtre dynamique est dfini, l'option SAPConnection Component List


correspondante est dsactive 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 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.

Guide de rfrence des Composants de Talend Open Studio 225


tSAPConnection

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

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 o sont stockes les
proprits du composant. Les champs suivants sont alors pr-
remplis l'aide des donnes collectes.
SAP JCO Version Slectionnez la version de SAP Java Connector dans la liste
droulante, talend sap api, sap jco 2.* ou sap jco 3.*.

Notez que la connexion SAP ouverte peut tre rutilise par le


tSAPBapi et le tSAPTableInput uniquement si l'option talend
sap apiest slectionne.
Connection configuration Client type : Saisissez votre code de connexion SAP habituel.

Userid : Saisissez l'identifiant de connexion utilisateur.

Password : Saisissez le mot de passe.

Language : Spcifiez la langue.

Host name : Saisissez l'adresse IP du systme SAP.

System number : Saisissez le numro du systme.

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.
Specify a shared destination Cochez cette case et spcifiez la destination partage dfinie du
ct Talend Runtime dans le champ Shared destination name.
Le champ Shared destination name permet aux composants
tSAP* d'utiliser une destination partage dans Talend Runtime,
lorsqu'ils sont excuts comme partie d'une Route ESB ou d'un
service de donnes ESB dans l'environnement OSGi du conteneur
de Talend Runtime.

Cette option est disponible uniquement lorsque vous slectionnez


sap jco 3.* dans la liste droulante SAP JCO Version.

En plus de spcifier la destination partage, dans le champ


Shared destination name du composant, vous devez galement
configurer la source des donnes SAP (DataSource) pour Talend
Runtime. La procdure pour dfinir la source des donnes SAP
et pour la configurer sont dcrites dans le fichier lisezmoi.txt
fourni dans le package de Talend ESB, dans le dossier /add-ons/
datasource/sap.

226 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Si vous utilisez la configuration propre du composant,


votre connexion SAP se ferme la fin de l'excution
du composant. Pour viter cela, utilisez une destination
partage ayant un nom spcifi.
SAP Properties Si vous souhaitez utiliser une configuration personnalise pour
le systme SAP utiliser, renseignez cette table avec la ou les
proprit(s) personnaliser. Par exemple,

si vous devez tablir une connexion Unicode entre le


systme SAP et le Studio Talend, ajoutez la proprit
jco.server.unicode et configurez sa valeur 1.

si vous devez configurer une connexion SAP


avec SNC (Secure Network Communications),
ajoutez les paramtres SNC et configurez leur
valeur dans cette table. Pour plus d'informations
concernant la configuration des paramtres SCN,
consultez http://help.sap.com/saphelp_erp60_sp/helpdata/en/
ce/1dfd3d4aefd95ee10000000a114084/content.htm et https://
help.sap.com/javadocs/NW04/current/jc/com/sap/mw/jco/
JCO.html (en anglais).
Advanced settings 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.

Cette case est indisponible si vous cochez la case Use


an existing connection dans l'onglet Basic 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.
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.

Guide de rfrence des Composants de Talend Open Studio 227


tSAPInput

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.

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 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.

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 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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement
les composants de connexion du Job du mme niveau.
SAP JCO Version Slectionnez la version de SAP Java Connector dans la liste
droulante.
Connection configuration Client : Saisissez votre code de connexion SAP habituel.

Userid : Saisissez l'identifiant de connexion utilisateur.

Password : Saisissez le mot de passe.

Language : Spcifiez la langue.

Host name : Saisissez l'adresse IP du systme SAP.

System number : Saisissez le numro du systme.

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.
FunName Saisissez le nom de la fonction que vous souhaitez utiliser pour
rcuprer les donnes.
Initialize input Configurez les paramtres d'entre.

Parameter Value : Saisissez entre guillemets les valeurs


correspondant au paramtre dfini dans la colonne Parameter
Name.

Type : Slectionnez le type d'entre rcuprer.

228 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSAPInput

Table Name (Structure Name) : Saisissez entre guillemets le


nom de la table.

Parameter Name : Saisissez entre guillemets le nom du champ


correspondant la table dfinie dans la colonne Table Name.

Lorsque plusieurs valeurs de paramtres utilisent le


mme nom de paramtre, vous devez saisir ces valeurs
dans une seule ligne et les sparer par des virgules.
Outputs Configurez les paramtres des schmas transmettre en sortie.

Schema : Saisissez le nom du schma transmettre en sortie.

Type (for iterate) : Slectionnez le type de sortie que vous


souhaitez obtenir.

Table Name (Structure Name) : Saisissez entre guillemets le


nom de la table.

Mapping : Saisissez entre guillemets le nom des champs dont


vous souhaitez rcuprer les donnes.

Vous pouvez dfinir autant de liens de sortie Main pour


crire des donnes que de schmas ajouts au tableau
Outputs. Ainsi, les donnes peuvent tre groupes
dans diffrents fichiers.
Specify a shared destination Cochez cette case et spcifiez la destination partage dfinie du
ct Talend Runtime dans le champ Shared destination name.
Le champ Shared destination name permet aux composants
tSAP* d'utiliser une destination partage dans Talend Runtime,
lorsqu'ils sont excuts comme partie d'une Route ESB ou d'un
service de donnes ESB dans l'environnement OSGi du conteneur
de Talend Runtime.

Cette option est disponible uniquement lorsque vous slectionnez


sap jco 3.* dans la liste droulante SAP JCO Version et que
vous ne cochez pas la case Use an existing connection.

En plus de spcifier la destination partage, dans le champ


Shared destination name du composant, vous devez galement
configurer la source des donnes SAP (DataSource) pour Talend
Runtime. La procdure pour dfinir la source des donnes SAP
et pour la configurer sont dcrites dans le fichier lisezmoi.txt
fourni dans le package de Talend ESB, dans le dossier /add-ons/
datasource/sap.

Si vous utilisez la configuration propre du composant,


votre connexion SAP se ferme la fin de l'excution
du composant. Pour viter cela, utilisez une destination
partage ayant un nom spcifi.
Advanced settings SAP Properties Si vous souhaitez utiliser une configuration personnalise pour
le systme SAP utiliser, renseignez cette table avec la ou les
proprit(s) personnaliser. Par exemple,

si vous devez tablir une connexion Unicode entre le


systme SAP et le Studio Talend, ajoutez la proprit
jco.server.unicode et configurez sa valeur 1.

si vous devez configurer une connexion SAP


avec SNC (Secure Network Communications),
ajoutez les paramtres SNC et configurez leur
valeur dans cette table. Pour plus d'informations
concernant la configuration des paramtres SCN,
consultez http://help.sap.com/saphelp_erp60_sp/helpdata/en/
ce/1dfd3d4aefd95ee10000000a114084/content.htm et https://
help.sap.com/javadocs/NW04/current/jc/com/sap/mw/jco/
JCO.html (en anglais).

Guide de rfrence des Composants de Talend Open Studio 229


Scnario 1 : Rcuprer les mtadonnes d'un systme SAP

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.

Cette case est indisponible si vous cochez la case Use


an existing connection dans l'onglet Basic settings.
Release Connection Dcochez cette case afin de continuer utiliser la connexion
slectionne, une fois que le composant a excut sa tche.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Connections Liens de sortie (de ce composant un autre) :

Row : Main, Iterate.

Trigger : RunIf, OnComponentOk; OnComponentError, OnSubjobOk, OnSubjobError.

Liens d'entre (d'un autre composant celui-ci) :

Row : Iterate

Trigger : Runif, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError.

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.

Scnario 1 : Rcuprer les mtadonnes d'un systme


SAP
Les composants SAP (tSAPInput et tSAPOutput) ainsi que l'assistant SAP sont bass sur des bibliothques
valides et fournies par SAP (JCO) permettant l'utilisateur d'appeler les fonctions RFC ou BAPI et de rcuprer
les donnes du systme SAP au niveau des tables, RFC ou BAPI.

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.

230 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Rcuprer les mtadonnes d'un systme SAP

Paramtrer la connexion SAP l'aide de l'assistant

Paramtrer la connexion au systme SAP


1. Crez une connexion au systme SAP l'aide de l'assistant SAP. Dans ce scnario, la connexion SAP est
appele sap et a t sauvegarde dans le nud Metadata.

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.

4. Slectionnez BAPI_COMPANY_GETDETAIL pour afficher le schma dcrivant les informations de


l'entreprise.

Guide de rfrence des Composants de Talend Open Studio 231


Scnario 1 : Rcuprer les mtadonnes d'un systme SAP

La vue droite de l'assistant affiche les mtadonnes de la fonction BAPI_COMPANY_GETDETAIL et vous


permet de configurer les paramtres ncessaires.

La vue Document affiche le document HTML SAP de la fonction BAPI_COMPANY_GETDETAIL.

La vue Parameter fournit les informations sur les paramtres d'entre et de sortie ncessaire la fonction
BAPI_COMPANY_GETDETAIL pour retourner les valeurs.

Dfinir les paramtres d'entre et de sortie l'aide de l'assistant

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.

232 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Rcuprer les mtadonnes d'un systme SAP

Chacun des paramtres de "structure" est compos de nombreux paramtres "single".

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".

Guide de rfrence des Composants de Talend Open Studio 233


Scnario 1 : Rcuprer les mtadonnes d'un systme SAP

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.

4. Dans la liste Output type en bas de l'assistant, slectionnez output.table.

5. Cliquez sur Launch en bas de la vue pour afficher la valeur de chaque paramtre "single" retourn par la
fonction BAPI_COMPANY_GETDETAIL.

6. Cliquez sur Finish pour fermer l'assistant et crer la connexion.

La connexion sap et la fonction BAPI_COMPANY_GETDETAIL apparaissent sous le nud SAP Connections


du Repository.

Rcuprer les diffrents schmas des fonctions SAP


Pour rcuprer les diffrents schmas de la fonction BAPI_COMPANY_GETDETAIL, veuillez suivre la
procdure suivante :

1. Cliquez-droit sur BAPI_COMPANY_GETDETAIL 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 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.

234 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Rcuprer les mtadonnes d'un systme SAP

Les deux schmas apparaissent sous la fonction BAPI_COMPANY_GETDETAIL dans le Repository.

Rcuprer les donnes correspondant l'entreprise


Pour rcuprer les donnes correspondant l'entreprise dont l'identifiant est 000001 et les afficher dans le Studio
Talend :

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.

4. Slectionnez tSAPInput dans la liste de composants et cliquez sur OK.

5. Cliquez et dposez les composants tFilterColumns et tLogRow dans l'espace de modlisation.

6. Connectez le tSAPConnection au tSAPInput via un lien Trigger > OnSubjobOk

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.

Guide de rfrence des Composants de Talend Open Studio 235


Scnario 1 : Rcuprer les mtadonnes d'un systme SAP

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.

2. Enregistrez le Job et appuyez sur F6 pour l'excuter.

236 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE

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.

Scnario 2 : Lire les donnes des diffrents schmas


de la fonction RFC_READ_TABLE
Les composants SAP (tSAPInput et tSAPOutput) ainsi que l'assistant SAP sont bass sur des bibliothques
valides et fournies par SAP (JCO) permettant l'utilisateur d'appeler les fonctions RFC ou BAPI et de rcuprer
les donnes du systme SAP au niveau des tables, RFC ou BAPI.

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.

Paramtrer et configurer la connexion SAP l'aide de l'utilisateur


1. Crez une connexion au systme SAP l'aide de l'assistant SAP. Dans ce scnario, la connexion SAP est
appele 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.

Guide de rfrence des Composants de Talend Open Studio 237


Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE

4. Slectionnez RFC_READ_TABLE pour afficher les schmas de cette fonction.

La vue droite de l'assistant affiche les mtadonnes de la fonction RFC_READ_TABLE et permet de dfinir les
paramtres ncessaires.

L'onglet Document affiche le document html SAP de la fonction RFC_READ_TABLE.

L'onglet Parameter fournit les informations sur les paramtres requis par la fonction RFC_READ_TABLE pour
pouvoir retourner les valeurs des paramtres.

Dfinir les paramtres d'entre et de sortie l'aide de l'assistant

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.

238 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Lire les donnes des diffrents schmas 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.

4. Dans la liste Output type en bas de l'assistant, slectionnez output.table.

5. Dans la liste Constructure|Table, slectionnez DATA.

Guide de rfrence des Composants de Talend Open Studio 239


Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE

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.

7. Cliquez sur Finish pour fermer l'assistant et crer la connexion.

Rcuprer les diffrents schmas de la fonction RFC_READ_TABLE

La connexion sap et la fonction RFC_READ_TABLE apparaissent sous le nud SAP Connections du


Repository.

Pour rcuprer les diffrents schmas de la fonction RFC_READ_TABLE :

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.

3. Cliquez sur Next pour afficher ces diffrents schmas.

4. Cliquez sur Finish.

Les trois schmas apparaissent sous la fonction RFC_READ_TABLE dans le Repository.

Rcuprer les noms des colonnes de donnes du schma


SFLIGHT
Dans ce scnario, l'objectif est de rcuprer les donnes et le nom des colonnes de la table SFLIGHT pour les
rcuprer et les afficher dans le Studio Talend. Pour ce faire, suivez la procdure suivante :

Construire le Job

1. Dans le Repository, slectionnez la fonction RFC_READ_TABLE de la connexion sap et glissez-la


dans l'espace de modlisation, slectionnez tSAPInput dans la liste de composants et cliquez sur OK. Le
tSAPInput s'affiche dans l'espace de modlisation.

2. Cliquez et dposez deux composants tLogRow dans l'espace de modlisation.

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.

240 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE

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.

Guide de rfrence des Composants de Talend Open Studio 241


Scnario 3 : Rcuprer les donnes d'un systme SAP

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.

Scnario 3 : Rcuprer les donnes d'un systme SAP


Ce scnario dcrit un Job qui ouvre une connexion un systme SAP avec tous les paramtres de connexion
configurs dans le composant tSAPConnection, rcupre les donnes stockes dans une table du systme SAP
et affiche les donnes dans la console.

242 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Rcuprer les donnes d'un systme SAP

Dposer les composants


Crez un nouveau Job et ajoutez les trois composants indiqus ci-dessous en saisissant leur nom dans l'espace
de modlisation ou en les dposant de la Palette :

le tSAPConnection : ouvre une connexion au systme SAP.

le tSAPInput : rcupre les donnes dans une table du systme SAP.

le tLogRow : affiche les donnes qu'il reoit du composant prcdent dans la console.

Configurer le composant de connexion


1. Double-cliquez sur le composant tSAPConnection afin d'ouvrir sa vue Basic settings.

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.*.

Guide de rfrence des Composants de Talend Open Studio 243


Scnario 3 : Rcuprer les donnes d'un systme SAP

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

Configurer le composant d'entre


1. Double-cliquez sur le composant tSAPInput afin d'afficher sa vue Basic settings.

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.

QUERY_TABLE : le nom de la table interroge. Il s'agit d'un paramtre de type input_single,"SFLIGHT"


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.

244 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Rcuprer les donnes d'un systme SAP

Cliquez sur OK pour fermer la bote de dialogue.

9. Dans la bote de dialogue qui s'ouvre, cliquez sur le bouton [+] pour ajouter une colonne, WA de type String
dans cet exemple.

Cliquez sur OK pour sauvegarder les paramtres.

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".

Configurer le composant de sortie


1. Double-cliquez sur le composant tLogRow afin d'ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 245


Scnario 3 : Rcuprer les donnes d'un systme SAP

2. Dans la zone Mode, slectionnez Table (print values in cells of a table).

Relier les composants et excuter le Job


1. Liez le composant tSAPConnection au composant tSAPInput l'aide d'une connexion Trigger > On
Subjob Ok, puis reliez le composant tSAPInput au composant tLogRow l'aide d'une connexion Row >
output.

2. Appuyez sur les touches Ctrl+S pour sauvegarder le Job.

3. Appuyez sur F6 pour excuter le Job.

Les donnes correspondantes dans l'un des schmas DATA de la table SFLIGHT sont affiches dans la
console.

246 Guide de rfrence des Composants de Talend Open Studio


tSAPOutput

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

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 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.

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 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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement
les composants de connexion du Job du mme niveau.
SAP JCO Version Slectionnez la version de SAP Java Connector dans la liste
droulante.
Connection configuration Client type : Saisissez votre code de connexion SAP habituel.

Userid : Saisissez l'identifiant de connexion utilisateur.

Password : Saisissez le mot de passe.

Language : Spcifiez la langue.

Host name : Saisissez l'adresse IP du systme SAP.

System number : Saisissez le numro du systme.

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 :

Guide de rfrence des Composants de Talend Open Studio 247


Proprits du tSAPOutput

View schema : slectionnez cette option afin de voir le schma.

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].
FunName Saisissez le nom de la fonction que vous souhaitez utiliser pour
rcuprer les donnes.
Mapping Configurez les paramtres afin de slectionner les donnes
crire dans le systme SAP.
Specify a shared destination Cochez cette case et spcifiez la destination partage dfinie du
ct Talend Runtime dans le champ Shared destination name.
Le champ Shared destination name permet aux composants
tSAP* d'utiliser une destination partage dans Talend Runtime,
lorsqu'ils sont excuts comme partie d'une Route ESB ou d'un
service de donnes ESB dans l'environnement OSGi du conteneur
de Talend Runtime.

Cette option est disponible uniquement lorsque vous slectionnez


sap jco 3.* dans la liste droulante SAP JCO Version et que
vous ne cochez pas la case Use an existing connection.

En plus de spcifier la destination partage, dans le champ


Shared destination name du composant, vous devez galement
configurer la source des donnes SAP (DataSource) pour Talend
Runtime. La procdure pour dfinir la source des donnes SAP
et pour la configurer sont dcrites dans le fichier lisezmoi.txt
fourni dans le package de Talend ESB, dans le dossier /add-ons/
datasource/sap.

Si vous utilisez la configuration propre du composant,


votre connexion SAP se ferme la fin de l'excution
du composant. Pour viter cela, utilisez une destination
partage ayant un nom spcifi.
Advanced settings SAP Properties Si vous souhaitez utiliser une configuration personnalise pour
le systme SAP utiliser, renseignez cette table avec la ou les
proprit(s) personnaliser. Par exemple,

si vous devez tablir une connexion Unicode entre le


systme SAP et le Studio Talend, ajoutez la proprit
jco.server.unicode et configurez sa valeur 1.

si vous devez configurer une connexion SAP


avec SNC (Secure Network Communications),
ajoutez les paramtres SNC et configurez leur
valeur dans cette table. Pour plus d'informations
concernant la configuration des paramtres SCN,
consultez http://help.sap.com/saphelp_erp60_sp/helpdata/en/
ce/1dfd3d4aefd95ee10000000a114084/content.htm et https://
help.sap.com/javadocs/NW04/current/jc/com/sap/mw/jco/
JCO.html (en anglais).
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.

Cette case est indisponible si vous cochez la case Use


an existing connection dans l'onglet Basic settings.

248 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Release Connection Dcochez cette case afin de continuer utiliser la connexion


slectionne, une fois que le composant a excut sa tche.
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.
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.

Guide de rfrence des Composants de Talend Open Studio 249


tSAPRollback

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.

Lorsqu'un paramtre dynamique est dfini, l'option SAPConnection Component List


correspondante est dsactive 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 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.

250 Guide de rfrence des Composants de Talend Open Studio


tSugarCRMInput

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.

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.
Module Slectionnez le module adquat dans la liste.

Pour utiliser des tables personnalises, slectionnez


Use custom module dans la liste . Les champs Custom
module package name et Custom module name
qui s'affichent sont automatiquement remplis avec les
noms correspondants.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Pour ce composant, le schma dpend du Module slectionn.


Query condition Saisissez la requte permettant de slectionner les donnes
extraire. Exemple : account_name= Talend'.
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.

Guide de rfrence des Composants de Talend Open Studio 251


Scnario: Extraire les donnes d'un compte partir de SugarCRM

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.

Scnario: Extraire les donnes d'un compte partir de


SugarCRM
Ce scnario dcrit un Job deux composants visant extraire les informations d'un compte partir d'une base de
donnes SugarCRM vers un fichier de sortie Excel.

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.

Configurer le composant d' entre


1. Double-cliquez sur le composant tSugarCRMInput pour afficher l'onglet Basic settings de la vue
Component et paramtrer ses proprits.

2. Remplissez les informations de connexion dans les champs SugarCRM Web Service URL, Username et
Password.

252 Guide de rfrence des Composants de Talend Open Studio


Scnario: Extraire les donnes d'un compte partir de SugarCRM

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.

3. Enregistrez votre Job puis appuyez sur F6 pour l'excuter.

Les donnes filtres sont inscrites en sortie dans la feuille de calcul du fichier Excel spcifi.

Guide de rfrence des Composants de Talend Open Studio 253


tSugarCRMOutput

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.

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.
Module Slectionnez le module adquat dans la liste.

Pour utiliser des tables personnalises, slectionnez


Use custom module dans la liste . Les champs Custom
module package name et Custom module name
qui s'affichent sont automatiquement remplis avec les
noms correspondants.
Action Vous pouvez effectuer l'une des oprations suivantes sur les
donnes du module SugarCRM :

Insert : insrer les donnes.

Update : mettre les donnes jour.


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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma


du composant prcdent.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.

254 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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 utilis comme composant de sortie. Il ncessite un composant d'entre.

Scnario associ
Aucun scnario n'est disponible pour ce composant.

Guide de rfrence des Composants de Talend Open Studio 255


tVtigerCRMInput

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.

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.
Version Renseignez la version de VtigerCRM que vous utilisez.
Module Slectionnez le module adquat dans la liste.
Method Slectionnez la mthode adquate dans la liste. Cette mthode
permet de dterminer l'action appliquer au module VtigerCRM
slectionn.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Pour ce composant, le schma dpend du Module slectionn.


Vtiger 5.1 Endpoint Saisissez l'URL du serveur Web invoqu.
Username Saisissez le nom d'utilisateur afin de vous connecter au
VtigerCRM..
Access key Saisissez la cl d'accs pour le nom d'utilisateur.

256 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Query condition Saisissez la requte permettant de slectionner les donnes


extraire.
Manual input of SQL query Cochez cette case pour saisir manuellement la requte que vous
souhaitez effectuer dans le champ Query.
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.

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.

Scnario associ
Aucun scnario n'est disponible pour ce composant.

Guide de rfrence des Composants de Talend Open Studio 257


tVtigerCRMOutput

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.

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.
Version Renseignez la version de VtigerCRM que vous utilisez.
Module Slectionnez le module adquat dans la liste.
Method Slectionnez la mthode adquate dans la liste. Cette mthode
permet de dterminer l'action appliquer au module VtigerCRM
slectionn.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Pour ce composant, le schma dpend du Module slectionn.


Vtiger 5.1 Endpoint Saisissez l'URL du serveur Web invoqu.
Username Saisissez le nom d'utilisateur afin de vous connecter au
VtigerCRM.
Access key Saisissez la cl d'accs pour le nom d'utilisateur.

258 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Action Vous pouvez effectuer l'une des oprations suivantes sur les
donnes du module VtigerCRM :

Insert : insrer les donnes.

Update : mettre les donnes jour.


Module Slectionnez le module adquat dans la liste.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Pour ce composant, le schma dpend du Module slectionn.


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 erreurs, et ignorer les lignes en erreur.
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.

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.

Scnario associ
Aucun scnario n'est disponible pour ce composant.

Guide de rfrence des Composants de Talend Open Studio 259


Guide de rfrence des Composants de Talend Open Studio
Composants Business Intelligence
Ce chapitre passe en revue les principaux composants prsents dans la famille Business Intelligence de la Palette
dans la perspective Integration du Studio Talend.

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.

Guide de rfrence des Composants de Talend Open Studio


tBarChart

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Le schma du tBarChart contient trois colonnes en


lecture seule nommes respectivement series (type
String), category (type String), et value (type Integer),
selon un ordre prdtermin. Les donnes de toutes les
autres colonnes seront simplement passes au composant
suivant, s'il y en a un, mais elles ne seront pas prsentes
dans le diagramme en barres.
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.
Sync columns Permet de synchroniser le schma du fichier d'entre avec le schma
du fichier de sortie. La fonction Sync ne s'affiche que lorsqu'une
connexion de type Row est connecte au composant de sortie.
Generated image path Nom et chemin d'accs du fichier image de sortie.
Chart title Saisissez le titre du diagramme en barres gnrer.
Include legend Cochez cette case si vous souhaitez inclure une lgende votre
diagramme en barres, afin d'afficher toutes les sries (series) dans
des couleurs diffrentes.
3Dimensions Cochez cette case afin de crer une image en trois dimensions. Par
dfaut, cette case est coche et les barres reprsentant les sries
(series) de chaque catgorie (category) sont empiles les unes sur les
autres. Si cette case est dcoche, une image en deux dimensions est

262 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer un diagramme en barres partir de donnes d'entre

cre, et les barres s'affichent les unes ct des autres le long de


l'axe category.
Image width et Image height Saisissez la largeur et la hauteur du fichier image, exprimes en
pixels.
Category axis name et Value Saisissez le nom de l'axe category et le nom de l'axe value.
axis name
Foreground alpha Saisissez un entier entre 0 et 100 afin de dfinir la transparence de
l'image. Plus ce nombre est petit, plus votre image sera transparente.
Plot orientation Choisissez l'orientation qu'aura votre diagramme en barres:
VERTICAL ou HORIZONTAL.
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.

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.

Scnario : Crer un diagramme en barres partir de


donnes d'entre
Ce scnario dcrit un Job simple qui lit les donnes d'un fichier CSV et les transforme en diagramme en barres.
Le fichier d'entre est prsent ci-dessous :
City;Population(x1000);LandArea(km2);PopulationDensity(people/km2)
Beijing;10233;1418;7620
Moscow;10452;1081;9644
Seoul;10422;605;17215
Tokyo;8731;617;14151
Jakarta;8490;664;12738
New York;8310;789;10452

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.

Dposer et relier les composants


1. A partir de la Palette, dposez les composants suivants dans l'espace de modlisation graphique : deux
composants tFileInputDelimited, un tMap, trois composants tFileOutputDelimited et un tBarChart.
Renommez les composants comme vous le souhaitez pour faciliter le travail de conception.

Guide de rfrence des Composants de Talend Open Studio 263


Scnario : Crer un diagramme en barres partir de donnes d'entre

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.

7. Connectez le premier composant tFileInputDelimited au second tFileInputDelimited en utilisant une


connexion Trigger > OnSubjobOk.

8. Renommez les composants de faon dcrire leur fonction.

Lire les donnes source


1. Double-cliquez sur le premier composant tFileInputDelimited afin d'afficher l'onglet Basic settings de sa
vue Component.

264 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer un diagramme en barres partir de donnes d'entre

2. Renseignez le chemin d'accs au fichier traiter dans le champ File name.

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.

Adapter les donnes source au schma tBarChart


1. Double-cliquez sur le tMap pour ouvrir l'diteur Map Editor.

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.

Guide de rfrence des Composants de Talend Open Studio 265


Scnario : Crer un diagramme en barres partir de donnes d'entre

8. Cliquez sur OK pour sauvegarder les mappings, fermer l'diteur et propager les schmas de sortie aux
composants de sortie.

Gnrer le fichier d'entre temporaire


1. Double-cliquez sur le premier composant tFileOutputDelimited pour ouvrir sa vue Basic settings.

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.

3. Cochez la case Append.

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,

266 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer un diagramme en barres partir de donnes d'entre

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 les donnes d'entre pour le tBarChart


1. Double-cliquez sur le second composant tFileInputDelimited afin d'afficher l'onglet Basic settings de sa
vue Component.

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.

3. Double-cliquez sur le composant tBarChart pour afficher l'onglet Basic settings.

4. Dans le champ Generated image path, renseignez le chemin d'accs du fichier image gnrer.

5. Dans le champ Chart title, saisissez un titre pour le diagramme en barres.

6. Saisissez un nom pour les axes category et series.

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.

8. Cliquez sur Edit schema afin d'ouvrir la bote de dialogue du schma.

Guide de rfrence des Composants de Talend Open Studio 267


Scnario : Crer un diagramme en barres partir de donnes d'entre

9. 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.

Supprimer le fichier temporaire


La fonction des composants tPrejob et tPostjob est de dclencher les sous-jobs connects et n'ont pas besoin
d'tre configurs. Vous devez simplement dfinir les proprits des deux composants tFileDelete.

1. Double-cliquez sur le premier composant tFileDelete pour afficher sa vue Basic settings.

2. Dans le champ File name, renseignez le chemin d'accs du fichier temporaire.

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.

268 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer un diagramme en barres partir de donnes d'entre

Excuter votre Job


1. Sauvegardez votre Job.

2. Appuyez sur F6 pour l'excuter.

Un diagramme en barres est gnr selon les critres dfinis.

Guide de rfrence des Composants de Talend Open Studio 269


tDB2SCD

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
Property type 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.
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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.

270 Guide de rfrence des Composants de Talend Open Studio


Proprits du tDB2SCD

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.

Pour plus d'informations, consultez Mthodologie de gestion du SCD.


Use memory saving Cochez cette case pour amliorer les performances du systme.
Mode
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 proprits de connexion supplmentaires pour la connexion la base de
settings parameters donnes que vous crez.

Vous pouvez configurer les paramtres d'encodage dans ce champ.

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.

Guide de rfrence des Composants de Talend Open Studio 271


Scnario associ

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.

272 Guide de rfrence des Composants de Talend Open Studio


tDB2SCDELT

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
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.
Source table Nom de la table contenant les donnes filtrer.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois 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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Guide de rfrence des Composants de Talend Open Studio 273


Proprits du tDB2SCDELT

Clear a table : supprimer le contenu de la table.

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
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 :

View schema : slectionnez cette option afin de voir le schma.

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 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.

Vous pouvez configurer les paramtres d'encodage dans ce champ.

274 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 275


tGreenplumSCD

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.

276 Guide de rfrence des Composants de Talend Open Studio


Proprits du tGreenplumSCD

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.

Pour plus d'informations, consultez Mthodologie de gestion du SCD.


Use memory saving Cochez cette case pour amliorer les performances du systme.
Mode
Source keys include Cochez cette case pour autoriser, dans les colonnes cls source, les valeurs Null.
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 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.

Guide de rfrence des Composants de Talend Open Studio 277


Scnario associ

Scnario associ
Pour un scnario associ, consultez tMysqlSCD.

278 Guide de rfrence des Composants de Talend Open Studio


tInformixSCD

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

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.
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.
Instance Nom de l'instance Informix utiliser. Cette information se trouve gnralement dans le fichier
SQL hosts.
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 :

Guide de rfrence des Composants de Talend Open Studio 279


Proprits du tInformixSCD

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez Mthodologie de gestion du SCD.


Use memory Cochez cette case pour amliorer les performances du systme.
saving Mode
Source keys Cochez cette case pour autoriser, dans les colonnes cls source, les valeurs Null.
include Null
Lorsque cette case est coche, assurez-vous que la valeur de(s) cl(s) source est
unique.
Use Transaction Dcochez cette case lorsque la base de donnes est configure en mode NO_LOG.
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 Spcifiez la valeur de temps du paramtre de date et heure de fin du SCD au format HH:mm:ss.
settings 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.
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.

280 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 281


tIngresSCD

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.

282 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Pour plus d'informations, consultez Mthodologie de gestion du SCD.


Use memory saving Cochez cette case pour amliorer les performances du systme.
Mode
Source keys include Cochez cette case pour autoriser, dans les colonnes cls source, les valeurs Null.
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 End date time Spcifiez la valeur de temps du paramtre de date et heure de fin du SCD au format HH:mm:ss.
settings 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.
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.

Guide de rfrence des Composants de Talend Open Studio 283


tJasperOutput

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.

Famille de composant Business Intelligence/Jasper


Fonction Le composant tJasperOutput 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.
Objectif Ce composant vous permet d'utiliser l'outil iReport de Jaspersoft afin de crer un rapport dans des
formats riches.
Basic settings Jrxml file Fichier du modle de rapport cr dans iReport.
Temp path Chemin d'accs aux fichiers temporaires.
Destination path Chemin d'accs au fichier final du rapport.
File name/Stream Nom du rapport final.
Report type Type du fichier du rapport final.
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 :

View schema : slectionnez cette option afin de voir le schma.

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.
Sync columns Permet de synchroniser le schma du fichier d'entre avec le schma
du fichier de sortie. La fonction Sync ne s'affiche que lorsqu'une
connexion de type Row est connecte au composant de sortie.
iReport Editez la commande pour fournir le chemin d'accs
au fichier d'excution de iReport, par exemple en
remplaant __IREPORT_PATH__\ par E:\Program Files\Jaspersoft
\iReport-4.1.1\bin\, ou en saisissant le chemin d'accs complet
au fichier d'excution, par exemple "E:\Program Files\Jaspersoft
\iReport-4.1.1\bin\iReport.exe".
Launch Cliquez sur ce bouton pour lancer iReport.

284 Guide de rfrence des Composants de Talend Open Studio


Scnario : Gnrer un rapport avec un modle .jrxml

Advanced settings Specify Locale Cochez cette case afin de slectionner la langue de votre rapport dans
la liste Report Locale.

La premire ligne de la liste Report Locale est vide. Vous


pouvez cliquer dessus pour personnaliser le langage.
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.
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 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.

Scnario : Gnrer un rapport avec un modle .jrxml


Le Job suivant lit des donnes d'un fichier .csv et cre un rapport .pdf bas sur un modle de rapport .jrxml existant.
Notez que le fichier de modle doit avoir t cr via l'outil iReport de Jaspersoft partir d'un fichier partageant
le mme schma avec le fichier source .csv du Job.

Configurer votre Job


1. Glissez-dposez les composants suivants de la Palette dans l'espace de modlisation graphique :
tFileInputDelimited et tJasperOutput.

2. Reliez le tFileInputDelimited au tJasperOutput l'aide d'un lien Row.

Configurer le composant d'entre


1. Double-cliquez sur le composant tFileInputDelimited afin d'afficher sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 285


Scnario : Gnrer un rapport avec un modle .jrxml

2. Slectionnez Built-In dans la liste droulante Property Type.

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.

Configurer le composant de sortie


1. Double-cliquez sur le tJasperOutput pour afficher sa vue Basic settings et configurer ses proprits.

286 Guide de rfrence des Composants de Talend Open Studio


Scnario : Gnrer un rapport avec un modle .jrxml

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.

6. Dans le champ Report type, slectionnez le format du rapport final.

7. Cliquez sur Sync columns afin de rcuprer le schma du composant prcdent.

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.

Excuter votre Job


1. Sauvegardez le Job.

2. Appuyez sur F6 pour l'excuter.

Le fichier out.pdf est cr l'emplacement spcifi dans le champ Destination path.

Guide de rfrence des Composants de Talend Open Studio 287


tJasperOutputExec

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.

Famille de composant Business Intelligence/


Jasper
Fonction Le composant tJasperOutputExec 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.
Objectif Ce composant vous permet d'utiliser l'outil iReport de Jaspersoft afin de crer un rapport dans des
formats riches. Il permet un gain de performance, puisqu'il est la combinaison d'un composant
d'entre et du composant de sortie tJasperOutput.
Basic settings Jrxml file Fichier du modle de rapport cr dans iReport
Source file Nom du fichier source.
Record delimiter Saisissez votre dlimiteur d'enregistrements.
Destination path Chemin d'accs au fichier final du rapport.
Use Default Output Name Cochez cette case pour utiliser le nom par dfaut du rapport gnr,
c'est--dire le nom du fichier source.
Output Name Nom du rapport final.

Ce champ n'apparat pas si la case Use Default Output


Name est coche.
Report type Type du fichier du rapport final.
iReport Editez la commande pour fournir le chemin d'accs
au fichier d'excution de iReport, par exemple en
remplaant __IREPORT_PATH__\ par E:\Program Files\Jaspersoft
\iReport-4.1.1\bin\, ou en saisissant le chemin d'accs complet
au fichier d'excution, par exemple "E:\Program Files\Jaspersoft
\iReport-4.1.1\bin\iReport.exe".
Launch Cliquez sur ce bouton pour lancer iReport.
Advanced settings Specify Locale Cochez cette case afin de slectionner la langue de votre rapport dans
la liste Report Locale.

La premire ligne de la liste Report Locale est vide. Vous


pouvez cliquer dessus pour personnaliser le langage.
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.
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.

288 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez 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.

Guide de rfrence des Composants de Talend Open Studio 289


tLineChart

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.

Depuis la version 5.6, les modes Built-in et Repository sont


disponibles dans n'importe quelle solution de Talend.

Le schma du tLineChart contient trois colonnes


en lecture seule nommes respectivement series (type
String), category (type String), et value (type Integer),
selon un ordre prdtermin. Les donnes de toutes les
autres colonnes seront simplement passes au composant
suivant, s'il y en a un, mais elles ne seront pas prsentes
dans le diagramme en barres.
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.
Sync columns Permet de synchroniser le schma du fichier d'entre avec le schma
du fichier de sortie. La fonction Sync ne s'affiche que lorsqu'une
connexion de type Row est connecte au composant de sortie.
Generated image path Nom et chemin d'accs du fichier image de sortie.
Chart title Saisissez le titre du graphique en lignes gnrer.
Domain axis label et Range Saisissez le nom de l'axe domain (axe X) et le nom de l'axe range
axis label (axe Y).
Plot orientation Choisissez l'orientation qu'aura votre graphique en lignes :
VERTICAL ou HORIZONTAL.
Include legend Saisissez true dans ce champ si vous souhaitez inclure une lgende
indiquant les lignes des sries dans des couleurs diffrentes ; sinon,
saisissez false.
Image width et Image height Saisissez la largeur et la hauteur du fichier image, exprimes en
pixels.
Moving average Cochez cette case afin d'afficher la moyenne mobile de chaque
srie dans votre graphique en lignes. Lorsque cette case est coche,
le champ Period apparat et vous pouvez dfinir la priode dans
laquelle apparat la moyenne mobile.
Lower bound and Upper Dfinissez quelles sont les plus hautes et les plus basses valeurs qui
bound seront affiches sur l'axe range.
Chart background et Plot Choisissez dans la liste la couleur de fond du graphique ainsi que la
background couleur de fond du plan du graphique (zone de l'orientation).
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.

290 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer un graphique en lignes afin de faciliter l'analyse des tendances

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.

Scnario : Crer un graphique en lignes afin de


faciliter l'analyse des tendances
Ce scnario dcrit un Job simple qui lit les donnes d'un fichier CSV et les transforme en graphique en lignes afin
de faciliter l'analyse des tendances. Le fichier d'entre indique combien de temps (en minutes) par semaine une
personne regarde diffrentes chanes de tlvision, sur une priode de dix semaines, comme prsent ci-dessous :
Week;TV_A;TV_B;TV_C
1;327;286;244
2;326;285;243
3;325;283;245
4;323;282;246
5;322;285;248
6;321;288;247
7;322;291;245
8;321;292;244
9;320;293;243
10;319;294;242

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.

Dposer et relier les composants


1. A partir de la Palette, dposez les composants suivants dans l'espace de modlisation graphique : deux
composants tFileInputDelimited, un tMap, trois composants tFileOutputDelimited et un tLineChart.

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.

Guide de rfrence des Composants de Talend Open Studio 291


Scnario : Crer un graphique en lignes afin de faciliter l'analyse des tendances

6. Connectez le premier composant tFileInputDelimited au second tFileInputDelimited l'aide d'une


connexion Trigger > OnSubjobOk.

7. Connectez le premier tFileDelete au premier composant tFileInputDelimited, et le second


tFileInputDelimited au second tFileDelete l'aide d'une connexion Trigger > OnSubjobOk.

8. Renommez les composants comme vous le souhaitez afin qu'ils dcrivent au mieux leur fonction.

Lire les donnes source


1. Double-cliquez sur le premier composant tFileInputDelimited afin d'afficher l'onglet Basic settings.

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.

292 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer un graphique en lignes afin de faciliter l'analyse des tendances

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.

Adapter les donnes source au schma tLineChart


1. Double-cliquez sur le tMap pour ouvrir l'diteur Map Editor.

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.

5. Dposez la colonne Mins_TVA de la table d'entre dans la colonne y de la table TV_A.

6. Dposez la colonne Mins_TVB de la table d'entre dans la colonne y de la table TV_B.

7. Dposez la colonne Mins_TVC de la table d'entre dans la colonne y de la table Mins_TV_C.

Guide de rfrence des Composants de Talend Open Studio 293


Scnario : Crer un graphique en lignes afin de faciliter l'analyse des tendances

8. Cliquez sur OK pour sauvegarder le mapping, fermer l'diteur et propager le schma de sortie au composant
de sortie.

Gnrer le fichier d'entre temporaire


1. Double-cliquez sur le premier composant tFileOutputDelimited pour afficher l'onglet Basic settings.

294 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer un graphique en lignes afin de faciliter l'analyse des tendances

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.

3. Cochez la case Append.

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.

3. Double-cliquez sur le composant tLineChart pour afficher l'onglet Basic settings.

4. Cliquez sur Edit schema afin d'ouvrir la bote de dialogue du schma.

Guide de rfrence des Composants de Talend Open Studio 295


Scnario : Crer un graphique en lignes afin de faciliter l'analyse des tendances

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.

Supprimer le fichier temporaire


1. Double-cliquez sur le premier composant tFileDelete pour afficher sa vue Basic settings.

296 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer un graphique en lignes afin de faciliter l'analyse des tendances

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.

3. Spcifiez le mme chemin d'accs que dans l'autre composant tFileDelete.

Excuter le Job
1. Appuyez sur Ctrl+S pour sauvegarder votre Job.

2. Appuyez sur F6 pour l'excuter.

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.

Guide de rfrence des Composants de Talend Open Studio 297


Scnario : Crer un graphique en lignes afin de faciliter l'analyse des tendances

298 Guide de rfrence des Composants de Talend Open Studio


tMondrianInput

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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. Consultez galement le Guide utilisateur
du Studio Talend.
Catalog Chemin d'accs au catalogue (structure de l'entrept de donnes).

Guide de rfrence des Composants de Talend Open Studio 299


Scnario : Tables en jointure croise

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.

Scnario : Tables en jointure croise


Le prsent Job permet d'extraire des groupes de donnes multidimensionnels partir de tables de bases de
donnes relationnelles stockes dans une base MySQL. Les donnes sont rcupres l'aide d'une expression
multidimensionnelle (requte MDX). Il est clair que vous devez connatre la structure de vos donnes, ou du moins
disposer d'une description de la structure (catalogue) comme rfrence du groupe de donnes rcuprer dans
ces diffrentes dimensions.

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.

300 Guide de rfrence des Composants de Talend Open Studio


Scnario : Tables en jointure croise

Configurer la connexion la base de donnes


Slectionnez le composant tMondrianInput puis cliquez sur la vue Component.

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).

Configurer la requte sur la base de donnes


1. La base de donnes relationnelle que l'on veut interroger contient cinq colonnes : media, drink, unit_sales,
store_cost et store_sales.

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 :

Guide de rfrence des Composants de Talend Open Studio 301


Scnario : Tables en jointure croise

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.

2. Entrez ensuite la requte MDX de la manire suivante :

"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])"

3. Slectionnez enfin le type d'encodage partir de la liste du champ Encoding Type.

Excuter le Job
1. Slectionnez le composant tLogRow puis cochez l'option Print header pour afficher le nom des colonnes
sur la console.

2. Enregistrez le Job puis appuyez sur F6 pour l'excuter.

302 Guide de rfrence des Composants de Talend Open Studio


Scnario : Tables en jointure croise

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.

Guide de rfrence des Composants de Talend Open Studio 303


tMSSqlSCD

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
Server Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Schema Nom du schma de la base de donnes.
Database Nom 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 :

View schema : slectionnez cette option afin de voir le schma.

304 Guide de rfrence des Composants de Talend Open Studio


Proprits du tMSSqlSCD

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.

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.

Guide de rfrence des Composants de Talend Open Studio 305


Scnario associ

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.

306 Guide de rfrence des Composants de Talend Open Studio


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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Slectionnez la version de Mysql 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 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 :

None : n'effectuer aucune opration de table.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.


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.

Guide de rfrence des Composants de Talend Open Studio 307


Proprits du tMysqlSCD

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez Mthodologie de gestion du SCD.


Use memory saving Cochez cette case pour amliorer les performances du systme.
mode
Source keys include Cochez cette case pour autoriser, dans les colonnes cls source, les valeurs Null.
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. Cette
settings Parameters 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 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.

308 Guide de rfrence des Composants de Talend Open Studio


Proprits du tMysqlSCD

Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez 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.

Mthodologie de gestion du SCD


Lors de dimensions volution lente ou Slowly Changing Dimensions (SCD), les donnes changent lentement.
L'diteur SCD permet de construire de manire simple le flux de sortie des donnes SCD. Dans l'diteur SCD,
vous pouvez relier les colonnes, slectionner la cl de substitution (Surrogate key) et paramtrer les attributs des
colonnes modifies en combinant les diffrents types de modifications SCD.

La figure ci-dessous reprsente l'diteur SCD.

Guide de rfrence des Composants de Talend Open Studio 309


Proprits du tMysqlSCD

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.

Creation : Slectionnez une des mthodes suivantes permettant de gnrer la cl :

Auto increment : la cl est auto-incrmente.

Input field : la cl est fournie par un champ d'entre.

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.

310 Guide de rfrence des Composants de Talend Open Studio


Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

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.

Scnario : Traquer des modifications avec les Slowly


Changing Dimensions de type 0 3
Ce scnario dcrit un Job traquant les modifications effectues dans quatre des colonnes du fichier dlimit source,
crit ces modifications ainsi que l'historique des modifications dans une table SCD et affiche les informations
d'erreurs dans la console Run.

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.

Guide de rfrence des Composants de Talend Open Studio 311


Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 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.

Dfinir le flux principal du Job


1. Cliquez et dposez les composants suivants dans l'diteur graphique : tMysqlConnection,
tFileInputDelimited, tMysqlSCD, tMysqlCommit ainsi que deux composants tLogRow.

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.

3. Connectez le tMysqlConnection au tFileInputDelimited et le tMysqlSCD au tMysqlCommit l'aide de


liens OnComponentOk.

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.

Configurer la connexion la base de donnes et le composant


d'entre
1. Dans l'diteur graphique, double-cliquez sur le composant tMysqlConnection pour afficher ses proprits
de base dans l'onglet Basic settings et renseigner manuellement les informations de connexion. Lorsque
plusieurs composants Database sont utiliss, le composant tMysqlConnection devrait tre utilis pour viter
de renseigner plusieurs fois les mmes informations de connexion la base de donnes.

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.

312 Guide de rfrence des Composants de Talend Open Studio


Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

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.

5. Si ncessaire, renseignez les champs Header, Footer et Limit.

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.

Guide de rfrence des Composants de Talend Open Studio 313


Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

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.

Configurer tMysqlSCD et tMysqlCommit


1. Dans l'diteur graphique, double-cliquez sur le composant tMysqlSCD pour paramtrer ses proprits.

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.

314 Guide de rfrence des Composants de Talend Open Studio


Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

Paramtrer l'diteur SCD


1. Dans l'onglet Basic settings du composant tMysqlSCD, cliquez sur le bouton [...] ct du champ SCD
Editor pour ouvrir l'diteur SCD editor et construire le flux de donnes en sortie du SCD.

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.

Dans la zone Versioning :

-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 le case version pour conserver le numro de version de l'enregistrement.

-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.

Guide de rfrence des Composants de Talend Open Studio 315


Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

Pour plus d'informations sur les types de SCD, consultez Mthodologie de gestion du SCD.

9. Cliquez sur OK pour valider votre configuration et fermer l'diteur SCD.

Crer la table SCD


1. Cliquez sur Edit schema pour afficher le flux de donnes en entre et en sortie. Le schma de sortie du SCD
devrait inclure les colonnes spcifiques au SCD contenant les informations de log standard dfinies dans
l'diteur SCD editor.

316 Guide de rfrence des Composants de Talend Open Studio


Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

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.

Martin travaille dsormais chez Phillips and Brothers.

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.

Guide de rfrence des Composants de Talend Open Studio 317


Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

318 Guide de rfrence des Composants de Talend Open Studio


tMysqlSCDELT

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
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.
Source table Nom de la table contenant les donnes filtrer.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois 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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Guide de rfrence des Composants de Talend Open Studio 319


Proprits du tMysqlSCDELT

Clear a table : supprimer le contenu de la table.

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
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 :

View schema : slectionnez cette option afin de voir le schma.

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.
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.

320 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 321


tNetezzaSCD

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

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.
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.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table slectionne :

None : n'effectuer aucune opration de table.

Create a table : crer une nouvelle table.

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 :

322 Guide de rfrence des Composants de Talend Open Studio


Proprits du tNetezzaSCD

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez Mthodologie de gestion du SCD.


Use memory Cochez cette case afin d'optimiser les performances du systme.
saving Mode
Source keys Cochez cette case pour autoriser, dans les colonnes cls source, les valeurs Null.
include Null
Lorsque cette case est coche, assurez-vous que la valeur de(s) cl(s) source est
unique.
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.
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.

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.

Guide de rfrence des Composants de Talend Open Studio 323


Scnario associ

Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs l'excution
d'un composant.

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez 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.

324 Guide de rfrence des Composants de Talend Open Studio


tOracleSCD

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
Connection type Liste droulante des pilotes disponibles:

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.

Guide de rfrence des Composants de Talend Open Studio 325


Proprits du tOracleSCD

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 :

None : n'effectuer aucune opration de table.

Create a table : crer une nouvelle table.

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez Mthodologie de gestion du SCD.


Use memory saving Cochez cette case pour amliorer les performances du systme.
Mode
Source keys include Cochez cette case pour autoriser, dans les colonnes cls source, les valeurs Null.
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 d'ignorer les lignes en erreur.
Advanced Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette
settings parameters option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans
les Basic settings.
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.
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.

326 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 327


tOracleSCDELT

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
Connection type Liste droulante des pilotes disponibles:

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.

328 Guide de rfrence des Composants de Talend Open Studio


Proprits du tOracleSCDELT

Source table Nom de la table contenant les donnes filtrer.


Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois 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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear a table : supprimer le contenu de la table.

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Guide de rfrence des Composants de Talend Open Studio 329


Scnario associ

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.

330 Guide de rfrence des Composants de Talend Open Studio


tPaloCheckElements

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement les
composants de connexion du Job du mme niveau.
Connection configuration Host Name Saisissez le nom de l'hte ou l'adresse IP du serveur hte.

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 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.
Database Saisissez le nom de la base de donnes dans laquelle crire les
donnes.
Cube Saisissez le nom du cube dans lequel les donnes doivent tre
crites.
On element error Slectionnez l'action effectuer lorsqu'un lment n'existe pas.

- Reject row : la ligne correspondante sera rejete et place dans


le flux de rejet.

- Use default : la valeur par dfaut dfinie sera utilise.

- Stop : le processus complet sera interrompu.


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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour


passer le schma en mode Built-In et effectuer des modifications
locales.

Guide de rfrence des Composants de Talend Open Studio 331


Proprits du tPaloCheckElements

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.
Un tableau vous permet de dfinir les lments vrifier.

- Column : affiche la (les) colonne(s) du schma d'entre. Cette


colonne est automatiquement remplie une fois qu'un schma
d'entre est saisi ou cr.

- Element type : slectionnez le type d'lment de la colonne


d'entre. Seule une colonne peut tre dfinie en tant que Measure.

- Default : saisissez la valeur par dfaut qui sera utilise si l'option


Use default a t slectionne dans le champ On element error.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant requiert un composant d'entre.
Connections Liens de sortie (de ce composant un autre) :

Row : Main, Rejects

Trigger : Run if, On Component Ok, On Component Error.

Liens d'entre (d'un autre composant celui-ci) :

Row : Main, Rejects

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.

332 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 333


tPaloClose

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.

334 Guide de rfrence des Composants de Talend Open Studio


tPaloConnection

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.

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 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.
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) :

Trigger : Run if, On Subjob Ok, On Subjob Error, On Component


Ok, On Component Error.

Liens d'entre (d'un autre composant celui-ci) :

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.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.

Pour plus d'informations sur les niveaux 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

Guide de rfrence des Composants de Talend Open Studio 335


Scnario associ

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 : Crer une dimension avec des lments.

336 Guide de rfrence des Composants de Talend Open Studio


tPaloCube

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement les
composants de connexion du Job du mme niveau.
Connection configuration Host Name Saisissez le nom de l'hte ou l'adresse IP du serveur hte.

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 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.
Database Saisissez le nom de la base de donnes dans laquelle l'opration
donne doit s'effectuer.
Cube Saisissez le nom du cube dans lequel l'opration donne doit
s'effectuer.
Cube type Slectionnez le type de cube dans la liste droulante pour le cube
sur lequel l'opration donne doit s'effectuer :

- Normal : Type de cube "normal", type par dfaut.

- Attribut : un cube Attribute sera cr avec la cration d'un cube


"normal".

- User Info : un cube User Info sera cr/modifi par ce composant.


Action on cube Slectionnez l'opration que vous souhaitez effectuer sur le cube
dfini :

- Create cube : le cube n'existe pas et sera cr.

- Create cube if not exists : cre un cube s'il n'existe pas.

- Delete cube if exists and create : supprime un cube s'il existe et


en cre un nouveau.

- Delete cube : supprime le cube de la base de donnes.

- Clear cube : supprime les donnes du cube.


Dimension list Ajoutez des lignes en cliquant sur le bouton [+] et dans chaque
ligne, saisissez le nom d'une dimension existant dans la base de

Guide de rfrence des Composants de Talend Open Studio 337


Scnario : Crer un cube dans une base de donnes existante

donnes et devant tre utilise dans le cube. L'ordre de cette liste


dfinit galement l'ordre de cration des dimensions.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant peut tre utilis en standalone dans la cration dynamique de cubes, avec une liste
dfinie de dimensions.
Connections Liens de sortie (de ce composant un autre) :

Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.

Liens d'entre (d'un autre composant celui-ci) :

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.

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 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.

Scnario : Crer un cube dans une base de donnes


existante
Le Job de ce scnario cre un nouveau cube deux dimensions dans la base de donnes dmo Biker de Palo.

338 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer un cube dans une base de donnes existante

Pour reproduire ce scnario, procdez comme suit :

Configurer le composant tPaloCube


1. Dposez un composant tPaloCube de la Palette dans l'espace de modlisation graphique.

2. Double-cliquez sur le composant tPaloCube afin d'ouvrir sa vue Component.

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.

Guide de rfrence des Composants de Talend Open Studio 339


Scnario : Crer un cube dans une base de donnes existante

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.

340 Guide de rfrence des Composants de Talend Open Studio


tPaloCubeList

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement les
composants de connexion du Job du mme niveau.
Connection configuration Host Name Saisissez le nom de l'hte ou l'adresse IP du serveur hte.

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 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.
Database Saisissez le nom de la base de donnes contenant les cubes dont vous
souhaitez rcuprer les informations.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant peut tre utilis en tant que composant de dbut. Il requiert un composant de sortie.
Connections Liens de sortie (de ce composant un autre) :

Row : Main, Iterate.

Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.

Liens d'entre (d'un autre composant celui-ci) :

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.

Guide de rfrence des Composants de Talend Open Studio 341


Dcouvrir le schma de sortie en lecture seule du tPaloCubeList

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.

Dcouvrir le schma de sortie en lecture seule du


tPaloCubeList
Le tableau ci-dessous prsente les informations relatives au schma en lecture seule du composant tPaloCubeList.

Colonne Type Description


Cube_id int ID interne du cube.
Cube_name string Nom du cube.
Cube_dimensions int Nombre de dimensions dans le cube.
Cube_cells long Nombre de cellules l'intrieur du cube.
Cube_filled_cells long Nombre de cellules remplies dans le cube.
Cube_status int Statut du cube. Il peut tre :

- 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

342 Guide de rfrence des Composants de Talend Open Studio


Scnario : Rcuprer des informations dtailles d'un cube d'une base de donnes dtermine

Scnario : Rcuprer des informations dtailles d'un


cube d'une base de donnes dtermine
Le Job dans ce scnario rcupre des informations dtailles concernant les cubes de la base de donnes dmo
de Palo Biker.

Pour reproduire ce scnario, procdez comme suit :

Configurer le Job
1. Dposez un composant tPaloCubeList et un tLogRow de la Palette dans l'espace de modlisation graphique.

2. Cliquez-droit sur le tPaloCubeList afin d'ouvrir son menu contextuel.

3. Dans ce menu, slectionnez Row > Main pour relier les deux composants.

Configurer le composant tPaloCube


1. Double-cliquez sur le tPaloCube afin d'ouvrir sa vue Component.

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.

Guide de rfrence des Composants de Talend Open Studio 343


Scnario : Rcuprer des informations dtailles d'un cube d'une base de donnes dtermine

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.

344 Guide de rfrence des Composants de Talend Open Studio


tPaloDatabase

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement les
composants de connexion du Job du mme niveau.
Connection configuration Host Name Saisissez le nom de l'hte ou l'adresse IP du serveur hte.

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 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.
Database Saisissez le nom de la base de donnes dans laquelle l'opration
doit s'effectuer.
Action on database Slectionnez l'opration que vous souhaitez effectuer sur le base de
donnes:

- Create database : la base de donnes n'existe pas et sera cre.

- Create database if not exists : la base est cre lorsqu'elle n'existe


pas.

- Delete database if exists and create : la base de donnes est


supprime si elle existe et une nouvelle base de donnes est cre.

- Delete database : la base de donnes est supprime du serveur.


Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables DATABASENAME : nom de la base de donnes. 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.

Guide de rfrence des Composants de Talend Open Studio 345


Scnario : Crer une base de donnes

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.

Liens d'entre (d'un autre composant celui-ci) :

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.

Scnario : Crer une base de donnes


Le Job de ce scnario cre une nouvelle base de donnes sur un serveur Palo donn.

Pour reproduire ce scnario, procdez comme suit :

1. Dposez un composant tPaloDatabase de la Palette dans l'espace de modlisation graphique.

2. Double-cliquez sur le composant tPaloDatabase afin d'ouvrir sa vue Component.

346 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer une base de donnes

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.

8. Appuyez sur F6 pour excuter votre Job.

Une nouvelle base de donnes est cre sur le serveur Palo donn.

Guide de rfrence des Composants de Talend Open Studio 347


tPaloDatabaseList

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement les
composants de connexion du Job du mme niveau.
Connection configuration Host Name Saisissez le nom de l'hte ou l'adresse IP du serveur hte.

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 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 tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant peut tre utilis en tant que composant de dbut. Il ncessite un composant de sortie.
Connections Liens de sortie (de ce composant un autre) :

Row : Main, Iterate.

Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.

Liens d'entre (d'un autre composant celui-ci) :

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.

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.

348 Guide de rfrence des Composants de Talend Open Studio


Dcouvrir le schma de sortie en lecture seule du tPaloDatabaseList

Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette 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.

Dcouvrir le schma de sortie en lecture seule du


tPaloDatabaseList
Le tableau ci-dessous prsente les informations relatives au schma de sortie en lecture seule du composant
tPaloDatabaseList.

Base de donnes Type Description


Database_id long ID interne de la base de donnes.
Database_name string Nom de la base de donnes.
Database_dimensions int Nombre de dimensions dans la base de donnes.
Database_cubes int Nombre de cubes dans la base du donnes.
Database_status int Statut de la base de donnes.

- 0 = non charge

- 1 = charge

- 2 = change
Database_types int Type de la base de donnes.

- 0 = normal

- 1 = system

- 3 = user info

Scnario : Rcuprer des informations dtailles


concernant les bases de donnes d'un serveur Palo
donn
Le Job de ce scnario rcupre des informations concernant toutes les bases de donnes d'un serveur Palo donn.

Guide de rfrence des Composants de Talend Open Studio 349


Scnario : Rcuprer des informations dtailles concernant les bases de donnes d'un serveur Palo donn

Pour reproduire ce scnario, procdez comme suit :

Configurer le Job
1. Dposez un composant tPaloDatabaseList et un tLogRow de la Palette dans l'espace de modlisation
graphique.

2. Cliquez-droit sur le tPaloDatabaseList pour ouvrir le menu contextuel.

3. Dans ce menu, slectionnez Row > Main pour relier les deux composants.

Configurer le composant tPaloDatabaseList


1. Double-cliquez sur le tPaloDatabaseList pour ouvrir sa vue Component.

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.

350 Guide de rfrence des Composants de Talend Open Studio


Scnario : Rcuprer des informations dtailles concernant les bases de donnes d'un serveur Palo donn

Pour plus d'informations concernant le schma de sortie, consultez Dcouvrir le schma de sortie en lecture seule
du tPaloDatabaseList.

Guide de rfrence des Composants de Talend Open Studio 351


tPaloDimension

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement les
composants de connexion du Job du mme niveau.
Connection configuration Host Name Saisissez le nom de l'hte ou l'adresse IP du serveur hte.

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 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.
Database Saisissez le nom de la base de donnes dans laquelle les
dimensions sont gres.
Dimension Saisissez le nom de la dimension sur laquelle l'opration donne
doit s'effectuer.
Action on dimension Slectionnez l'opration que vous souhaitez effecteur sur la
dimension :

- None : aucune action n'est effectue sur la dimension.

- Create dimension : la dimension n'existe pas et sera cre.

- Create dimension if not exists : cette dimension est cre quand


elle n'existe pas.

- Delete dimension if exists and create : cette dimension est


supprime si elle existe et une nouvelle dimension est cre.

- Delete dimension : la dimension est supprime de la base de


donnes.
Create dimension elements Cochez cette case pour activer les champs de gestion des
dimensions et crer des lments de dimension , et crer cette
dimension.
Les champs ci- Dimension type Slectionnez le type de dimension crer. Le type peut tre :
dessous sont disponibles
uniquement quand la - Normal
case Create dimension
elements est coche. Disponible - User info
uniquement
lorsque l'action - System

352 Guide de rfrence des Composants de Talend Open Studio


Proprits du tPaloDimension

effectuer sur - Attribute


la dimension est
None.
Commit size Saisissez le nombre d'lments qui seront crs avant de les
sauvegarder dans la dimension.
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 :

View schema : slectionnez cette option afin de voir le schma.

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.
Consolidation type - None Slectionnez ce bouton pour dplacer directement les lments
entrants dans la dimension donne. Avec cette option, vous ne
Cette option dfinissez aucune consolidation ou hirarchie.
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 traiter. Ce mode peut tre :

- Add : ajoute simplement un lment la dimension.

- Force add : force la cration de cet lment. S'il existe, l'lment


sera recr.

- Update : met jour l'lment s'il existe.

- Add or Update : si l'lment n'existe pas, il sera cr. S'il existe,


il sera mis jour. Cette option est l'option par dfaut.

- Delete : supprime cet lment de la dimension.

Guide de rfrence des Composants de Talend Open Studio 353


Proprits du tPaloDimension

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 :

- Add : ajoute simplement un lment la dimension.

- Force add : force la cration de cet lment. S'il existe, l'lment


sera recr.

- Update : met jour l'lment s'il existe.

- Add or Update : si l'lment n'existe pas, il sera cr. S'il existe,


il sera mis jour. Cette option est l'option par dfaut.
Consolidation type - Self- Slectionnez ce bouton pour crer des lments et les structurer
referenced partir d'une relation parent-enfant. Le flux d'entre est responsable
du regroupement de la consolidation.
Cette option
active les champs
des paramtres
correspondants
devant tre
renseigns.
Element's 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 :

- Add : ajoute simplement un lment la dimension.

- Force add : force la cration de cet lment. S'il existe, l'lment


sera recr.

- Update : met jour l'lment s'il existe.

- Add or Update : si l'lment n'existe pas, il sera cr. S'il existe,


il sera mis jour. Cette option est l'option par dfaut.
Input Column : slectionnez une colonne dans la liste droulante.
Les colonnes dans cette liste 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.
Hierarchy Element : slectionnez le type et la relation de cette
colonne d'entre pour la consolidation.

- Parent : dfinissez la valeur d'entre en tant qu'lment parent.

- Child : lie la valeur d'entre la valeur parent et construit la


consolidation.

354 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer une dimension avec des lments

- Factor : dfinissez le facteur de cette consolidation.


Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant peut tre utilis en standalone ou comme composant de fin d'un processus.
Connections Liens de sortie (de ce composant un autre) :

Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.

Liens d'entre (d'un autre composant celui-ci) :

Row : Main, 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 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.

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 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.

Scnario : Crer une dimension avec des lments


Le Job de ce scnario cre une dimension de date avec une hirarchie d'lments simple, compose de trois
niveaux : Year, Month, Date (Anne, mois, date).

Guide de rfrence des Composants de Talend Open Studio 355


Scnario : Crer une dimension avec des lments

Pour reproduire ce scnario, procdez comme suit :

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.

Paramtrer la connexion une base de donnes


1. Double-cliquez sur le composant tPaloCube afin d'ouvrir sa vue Component.

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.

356 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer une dimension avec des lments

Configurer le composant Input


1. Double-cliquez sur le tRowGenerator pour ouvrir son diteur.

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.

5. Cliquez sur OK afin de valider vos modifications et fermer l'diteur.

6. Dans la bote de dialogue qui s'ouvre, cliquez sur OK pour propager les modifications.

Configurer le tMap editor


1. Double-cliquez sur le tMap afin d'ouvrir son diteur.

Guide de rfrence des Composants de Talend Open Studio 357


Scnario : Crer une dimension avec des lments

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.

5. Appuyez sur les touches Ctrl+Espace afin d'ouvrir la liste d'auto-compltion.

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).

7. Remplacez l'expression par dfaut par TalendDate.formatDate("yyyy",row1.random_date).

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.

Configurer le composant tPaloDimension


1. Dans l'espace de modlisation graphique, double-cliquez sur le tPaloDimension afin d'ouvrir sa vue
Component.

358 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer une dimension avec des lments

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.

6. Slectionnez la case Create dimension elements.

7. Dans la zone Consolidation Type, slectionnez le bouton Normal.

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.

Une nouvelle dimension a t cre dans la base de donnes Palo talendDatabase.

Guide de rfrence des Composants de Talend Open Studio 359


Scnario : Crer une dimension avec des lments

360 Guide de rfrence des Composants de Talend Open Studio


tPaloDimensionList

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.

Lorsqu'un Job contient un Job parent et un Job enfant, la


liste Component list prsente uniquement les composants
de connexion du Job du mme niveau.
Connection configuration Host Name Saisissez le nom de l'hte ou l'adresse IP du serveur hte.

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 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.
Database Saisissez le nom de la base de donnes dans laquelle se trouvent les
dimensions qui vous intressent.
Retrieve cube dimensions Cochez cette case pour rcuprer les informations des dimensions
d'un cube existant.
Cube Saisissez le nom du cube duquel les informations concernant les
dimensions sont rcupres.
Disponible
lorsque vous
cochez la case
Retrieve cube
dimensions.
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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour


passer le schma en mode Built-In et effectuer des modifications
locales.

Guide de rfrence des Composants de Talend Open Studio 361


Proprits du tPaloDimensionList

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.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant peut tre utilis en standalone ou comme composant de dbut d'un processus.
Connections Liens de sortie (de ce composant un autre) :

Row : Main, Iterate.

Trigger : Run if, On Subjob Ok; On Subjob Error, On Component


Ok, On Component Error.

Liens d'entre (d'un autre composant celui-ci) :

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 DIMENSIONNAME : nom de la dimension. 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.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.

Pour plus d'informations sur les niveaux 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.

362 Guide de rfrence des Composants de Talend Open Studio


Dcouvrir le schma de sortie en lecture seule du tPaloDimensionList

Dcouvrir le schma de sortie en lecture seule du


tPaloDimensionList
Le tableau ci-dessous prsente les informations relatives au schma de sortie en lecture seule du composant
tPaloDimensionList.

Dimension Type Description


Dimension_id long ID interne de la dimension.
Dimension_name string Nom de la dimension.
Dimension_attribute_cube string Nom du cube des attributs.
Dimension_rights_cube string Nom du cube des droits.
Dimension_elements int Nombre d'lments de dimension.
Dimension_max_level int Niveau maximal de la dimension.
Dimension_max_indent int Indentation maximum de la dimension.
Dimension_max_depth int Profondeur maximale de la dimension.
Dimension_type int Type de la dimension :

- 0 = normal

- 1 = system

- 2 = attribute

- 3 = user info

Scnario: Rcuprer des informations dtailles


concernant les dimensions d'une base de donnes
dtermine
Le Job de ce scnario rcupre les informations de toutes les dimensions d'une base de donnes dtermine.

Pour reproduire ce scnario, procdez comme suit :

Construire le Job
1. Dposez un composant tPaloDimensionList et un tLogRow de la Palette dans l'espace de modlisation
graphique.

2. Cliquez-droit sur le tPaloDimensionList pour ouvrir le menu contextuel.

3. Dans le menu, slectionnez Row > Main pour relier les deux composants.

Guide de rfrence des Composants de Talend Open Studio 363


Scnario: Rcuprer des informations dtailles concernant les dimensions d'une base de donnes dtermine

Configurer le composent tPaloDimensionList


1. Double-cliquez sur le composant tPaloDimensionList pour ouvrir sa vue Component.

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.

364 Guide de rfrence des Composants de Talend Open Studio


Scnario: Rcuprer des informations dtailles concernant les dimensions d'une base de donnes dtermine

Pour plus d'informations concernant le schma de sortie, consultez Dcouvrir le schma de sortie en lecture seule
du tPaloDimensionList.

Guide de rfrence des Composants de Talend Open Studio 365


tPaloInputMulti

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.

Lorsqu'un Job contient un Job parent et un Job enfant, la


liste Component list prsente uniquement les composants
de connexion du Job du mme niveau.
Connection configuration Host Name Saisissez le nom de l'hte ou l'adresse IP du serveur hte.

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 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.
Database Saisissez le nom de la base de donnes dans laquelle se trouvent les
lments qui vous intressent.
Cube Saisissez le nom du cube dans lequel les lments de dimension
rcuprer sont stocks.
Cube type Slectionnez le type de cube dans la liste droulante pour le cube sur
lequel l'opration donne doit s'effectuer :

- Normal : Type de cube "normal", type par dfaut.

- Attribut : un cube Attribute sera cr avec la cration d'un cube


"normal".

- System : Type de cube "systme".

- User Info : un cube User Info sera cr/modifi par ce composant.


Commit size Saisissez le nombre de lignes de chaque lot 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.

Cliquez sur Edit schema pour modifier le schma. Si le schma est


en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

366 Guide de rfrence des Composants de Talend Open Studio


Proprits du tPaloInputMulti

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.
Cube Query Remplissez ce tableau pour prciser les donnes que vous souhaitez
rcuprer.
Column : les colonnes du schma sont ajoutes automatiquement
cette colonne, une fois dfinies dans l'diteur du schma. Les
colonnes du schma sont utilises pour stocker les lments de
dimensions rcuprs.
Dimensions : saisissez le nom de chaque dimension du cube duquel
vous souhaitez rcuprer les lments de dimensions.

L'ordre des dimensions dans cette colonne doit tre


cohrent avec l'ordre dans le cube stockant ces
dimensions.
Elements : saisissez les lments de dimensions desquels rcuprer
les donnes. Si plusieurs lments d'une dimension sont requis,
sparez-les avec une virgule.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant requiert un composant de sortie.
Connections Liens de sortie (de ce composant un autre) :

Row : Main

Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.

Liens d'entre (d'un autre composant celui-ci) :

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).

Guide de rfrence des Composants de Talend Open Studio 367


Scnario : Rcuprer des lments de dimensions dans un cube donn

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.

Scnario : Rcuprer des lments de dimensions


dans un cube donn
Le Job de ce scnario rcupre plusieurs lments de dimensions du cube de dmo Palo Sales.

Pour reproduire ce scnario, procdez comme suit :

Construire le Job
1. Dposez un composant tPaloInputMulti et un tLogRow de la Palette dans l'espace de modlisation
graphique.

2. Cliquez-droit sur le composant tPaloInputMulti afin d'ouvrir son menu contextuel.

3. Dans le menu, slectionnez Row > Main afin de relier le tPaloInputMulti au tLogRow.

Paramtrer la connexion une base de donnes


1. Double-cliquez sur le tPaloInputMulti afin d'ouvrir sa vue Component.

368 Guide de rfrence des Composants de Talend Open Studio


Scnario : Rcuprer des lments de dimensions dans un cube donn

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.

Configurer le Cube Query


1. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle est stock le cube.

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.

Guide de rfrence des Composants de Talend Open Studio 369


Scnario : Rcuprer des lments de dimensions dans un cube donn

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.

370 Guide de rfrence des Composants de Talend Open Studio


Scnario : Rcuprer des lments de dimensions dans un cube donn

3. Appuyez sur F6 pour excuter le Job.

Les lments de dimensions et la valeur Measure correspondant s'affichent dans la console de la vue Run.

Guide de rfrence des Composants de Talend Open Studio 371


tPaloOutput

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.

Lorsqu'un Job contient un Job parent et un Job enfant, la


liste Component list prsente uniquement les composants
de connexion du Job du mme niveau.
Connection configuration Host Name Saisissez le nom de l'hte ou l'adresse IP du serveur hte.

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 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.
Database Saisissez le nom de la base de donnes dans laquelle se trouve le
cube qui vous intresse.
Cube Saisissez le nom du cube dans lequel les donnes entrantes sont
crites.
Commit size Saisissez le nombre de lignes de chaque lot devant tre crit dans le
cube.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

372 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.
Column as Measure Slectionnez la colonne du flux d'entre contenant les valeurs
Measure ou Text.
Create element if not exist Cochez cette case afin de crer l'lment traiter s'il n'existe pas.
Save cube at process end Cochez cette case afin de sauvegarder le cube dans lequel vous avez
crit les donnes la fin du processus.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant requiert un composant d'entre.
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.
Connections Liens de sortie (de ce composant un autre) :

Row : Iterate.

Trigger : Run if.

Liens d'entre (d'un autre composant celui-ci) :

Row : Main, Reject.

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.

Guide de rfrence des Composants de Talend Open Studio 373


tPaloOutputMulti

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.

Lorsqu'un Job contient un Job parent et un Job enfant, la


liste Component list prsente uniquement les composants
de connexion du Job du mme niveau.
Connection configuration Host Name Saisissez le nom de l'hte ou l'adresse IP du serveur hte.

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 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.
Database Saisissez le nom de la base de donnes dans laquelle se trouve le
cube qui vous intresse.
Cube Saisissez le nom du cube dans lequel les donnes entrantes sont
crites.
Cube type Slectionnez le type de cube dans la liste droulante pour le cube sur
lequel l'opration donne doit s'effectuer :

- Normal : Type de cube "normal", type par dfaut.

- Attribut : un cube Attribute sera cr avec la cration d'un cube


"normal".

- System : Type de cube "systme".

- User Info : un cube User Info sera cr/modifi par ce composant.


Commit size Saisissez le nombre de lignes de chaque lot devant tre crit dans le
cube.
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 :

View schema : slectionnez cette option afin de voir le schma.

374 Guide de rfrence des Composants de Talend Open Studio


Proprits du tPaloOutputMulti

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.
Measure value Slectionnez la colonne du flux d'entre contenant les valeurs
Measure ou Text.
Splash mode Slectionnez le mode splash utilis pour crire des donnes dans un
lment consolid. Le mode peut tre :

- Add :crit des valeurs dans les lments sous-jacents.

- Default : utilise le mode splash par dfaut.

- Set : dfinit simplement la valeur et effectue la distribution partir


d'autres valeurs.

- Disable : n'applique aucun splash.

Pour plus d'informations concernant les modes splash Palo, consultez


le Guide utilisateur de Palo.
Add values Cochez cette case pour ajouter des nouvelles valeurs aux valeurs
actuelles. Si vous ne cochez pas cette case, les nouvelles valeurs
craseront les valeurs actuelles.
Use eventprocessor Cochez cette case pour appeler le serveur de supervision.
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 settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant requiert un composant de dbut.
Connections Liens de sortie (de ce composant un autre) :

Row : Main

Trigger : Run if, On Component Ok, On Component Error.

Liens d'entre (d'un autre composant celui-ci) :

Row : Main, Reject

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.

Guide de rfrence des Composants de Talend Open Studio 375


Scnario 1 : Ecrire des donnes dans un cube donn

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.

Scnario 1 : Ecrire des donnes dans un cube donn


Le Job de ce scnario crit de nouvelles valeurs dans le cube Sales donn en dmo dans la base de donnes Demo
installe avec Palo.

Pour reproduire ce scnario, procdez comme suit :

Construire le Job
1. Dposez un tFixedFlowInput et un tPaloOutputMulti de la Palette dans l'espace de modlisation
graphique.

2. Cliquez-droit sur le composant tFixedFlowInput afin d'ouvrir son menu contextuel.

3. Dans ce menu, slectionnez Row > Main pour relier ce composant au tPaloOutputMulti.

Configurer le composant d'entre


1. Double-cliquez sur le tFixedFlowInput pour ouvrir sa vue Component.

376 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Ecrire des donnes dans un cube donn

2. Cliquez sur le bouton [...] pour ouvrir l'diteur de schma.

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.

Guide de rfrence des Composants de Talend Open Studio 377


Scnario 1 : Ecrire des donnes dans un cube donn

Configurer le composant de sortie


1. Double-cliquez sur le composant tPaloOutputMulti afin d'ouvrir sa vue Component.

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.

7. Dans le champ Measure Value, slectionnez Value.

Excuter le Job
Appuyez sur F6 pour excuter le Job.

Le flux d'entre de donnes a t crit dans le cube Sales.

378 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Refuser un flux de donnes d'entre lorsque les lments crire n'existent pas dans un cube donn

Scnario 2 : Refuser un flux de donnes d'entre


lorsque les lments crire n'existent pas dans un
cube donn
Le Job de ce scnario essaye d'crire des donnes dans le cube Sales mais puisque les lments concerns n'existent
pas dans ce cube, le flux d'entre est refus.

Pour reproduire ce scnario, procdez comme suit :

Construire le Job
1. Dposez les composants tFixedFlowInput, tPaloCheckElements, tPaloOutputMulti et tLogRow de la
Palette dans l'espace de modlisation graphique.

2. Cliquez-droit sur le tFixedFlowInput afin d'ouvrir son menu contextuel.

3. Dans ce menu, slectionnez Row > Main afin de connecter ce composant au tPaloCheckElements.

Configurer le composant d'entre


1. Double-cliquez sur le composant tFixedFlowInput afin d'ouvrir sa vue Component.

Guide de rfrence des Composants de Talend Open Studio 379


Scnario 2 : Refuser un flux de donnes d'entre lorsque les lments crire n'existent pas dans un cube donn

2. Cliquez sur le bouton [...] afin d'ouvrir l'diteur de schma.

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.

380 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Refuser un flux de donnes d'entre lorsque les lments crire n'existent pas dans un cube donn

Configurer le composant tPaloCheckElements


1. Double-cliquez sur le composant tPaloCheckElements afin d'ouvrir sa vue Component.

2. Dans le champ Host name, saisissez localhost.

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.

7. Dans le champ On Element Error, slectionnez Reject dans la liste droulante.

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.

Configurer le composant de sortie


1. Double-cliquez sur le tPaloOutputMulti pour afficher sa vue Component.

Guide de rfrence des Composants de Talend Open Studio 381


Scnario 2 : Refuser un flux de donnes d'entre lorsque les lments crire n'existent pas dans un cube donn

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.

7. Dans le champ Measure Value, slectionnez Value.

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.

382 Guide de rfrence des Composants de Talend Open Studio


tPaloRule

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement les
composants de connexion du Job du mme niveau.
Connection configuration Host Name Saisissez le nom de l'hte ou l'adresse IP du serveur hte.

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 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.
Database Saisissez le nom de la base de donnes dans laquelle se trouvent les
dimensions appliquant les rgles.
Cube Saisissez le nom du cube dans lequel les informations de
dimensions doivent tre retrouves.
Cube rules Remplissez ce tableau afin d'effectuer diffrentes actions sur les
rgles spcifiques :

- Definition : saisissez la rgle appliquer.


- External Id : saisissez l'ID externe personnalis.
- Comment : saisissez un commentaire pour cette rgle.
- Activated : cochez cette case afin d'activer la rgle.
- Action : slectionnez dans la liste droulante l'action effectuer :

- Create : crer cette rgle.

- Delete : supprimer cette rgle.

- Update : mettre jour cette rgle.


Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant peut tre utilis en standalone dans la cration dynamique de cubes, avec une liste
dfinie de dimensions.
Connections Liens de sortie (de ce composant un autre) :

Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.

Liens d'entre (d'un autre composant celui-ci) :

Guide de rfrence des Composants de Talend Open Studio 383


Scnario : Crer une rgle dans un cube donn

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.

Scnario : Crer une rgle dans un cube donn


Le Job de ce scnario cre une rgle applique aux dimensions d'un cube donn.

Pour reproduire ce scnario, procdez comme suit :

Paramtrer la connexion une base de donnes


1. Dposez un composant tPaloRule de la Palette dans l'espace de modlisation graphique.

384 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer une rgle dans un cube donn

2. Double-cliquez sur le composant tPaloRule afin d'ouvrir sa vue Component.

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.

Dfinir les rgles du cube


1. Sous le tableau Cube rules, cliquez sur le bouton [+] afin d'ajouter une ligne.

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.

3. Dans la colonne Activated, cochez la case.

4. Dans la colonne Action, slectionnez Create dans la liste droulante.

Excuter le Job
Appuyez sur F6 afin d'excuter le Job.

La nouvelle rgle a t cre et la valeur de chaque lment de 2009 est 123.

Guide de rfrence des Composants de Talend Open Studio 385


Scnario : Crer une rgle dans un cube donn

386 Guide de rfrence des Composants de Talend Open Studio


tPaloRuleList

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement les
composants de connexion du Job du mme niveau.
Connection configuration Host Name Saisissez le nom de l'hte ou l'adresse IP du serveur hte.

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 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.
Database Saisissez le nom de la base de donnes dans laquelle se trouve le
cube qui vous intresse.
Cube Saisissez le nom du cube dans lequel les informations de rgles
doivent tre retrouves.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Guide de rfrence des Composants de Talend Open Studio 387


Proprits du tPaloRuleList

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.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant peut tre utilis en standalone ou en tant que composant de dbut d'un processus.
Connections Liens de sortie (de ce composant un autre) :

Row : Main, Iterate.

Trigger : Run if, On Subjob Ok, On Subjob Error, On Component


Ok, On Component Error.

Liens d'entre (d'un autre composant celui-ci) :

Row : Iterate

Trigger : Run if, On Subjob Ok, On Subjob Error, On Component


Ok, On Component Error.

Pour plus d'informations propos des connexions, consultez


la section concernant les types de connexions, dans le Guide
utilisateur du Studio Talend.
Global Variables NB_RULES : nombre de rgles. Cette variable est une variable After et retourne un nombre entier

EXTERNAL_RULEID : ID externe de la rgle. 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.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.

Pour plus d'informations sur les niveaux 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.

388 Guide de rfrence des Composants de Talend Open Studio


Dcouvrir le schma de sortie en lecture seule du tPaloRuleList

Dcouvrir le schma de sortie en lecture seule du


tPaloRuleList
Le tableau ci-dessous prsente les informations relatives au schma de sortie en lecture seule du
composanttPaloRuleList.

Base de donnes Type Description


rule_identifier long Identifiant interne de la rgle.
rule_definition string Nom de la dimension.
Dimension_attribute_cube string Formule de la rgle. Pour plus d'informations concernant cette rgle,
consultez le Guide utilisateur Palo.
rule_extern_id string ID externe personnalis.
rule_comment string Commentaire utilisateur de la rgle.
rule_activated boolean Indique si la rgle a t active ou non.

Scnario : Rcuprer des informations dtailles


concernant des rgles d'un cube donn
Le Job de ce scnario rcupre les informations concernant les rgles appliques dans les dimensions d'un cube
donn.

Pour reproduire ce scnario, procdez comme suit :

Construire le Job
1. Dposez un composant tPaloRuleList et un tLogRow de la Palette dans l'espace de modlisation graphique.

2. Cliquez-droit sur le tPaloRuleList afin d'ouvrir son menu contextuel.

3. Dans ce menu, slectionnez Row > Main afin de lier les deux composants.

Configurer le composant tPaloRuleList


1. Double-cliquez sur le tPaloRuleList pour ouvrir sa vue Component.

Guide de rfrence des Composants de Talend Open Studio 389


Scnario : Rcuprer des informations dtailles concernant des rgles d'un cube donn

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.

390 Guide de rfrence des Composants de Talend Open Studio


tParAccelSCD

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
Connection type Slectionnez dans la liste le pilote 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 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 :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 391


Proprits du tParAccelSCD

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.

Pour plus d'informations, consultez Mthodologie de gestion du SCD.


Use memory Cochez cette case pour amliorer les performances du systme.
saving Mode
Source keys Cochez cette case pour autoriser, dans les colonnes cls source, les valeurs Null.
include 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 End date time Spcifiez la valeur de temps du paramtre de date et heure de fin du SCD au format HH:mm:ss.
settings 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.
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.

392 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 393


tPostgresPlusSCD

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion crant
cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

394 Guide de rfrence des Composants de Talend Open Studio


Proprits du tPostgresPlusSCD

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.

Pour plus d'informations, consultez Mthodologie de gestion du SCD.


Use memory saving Mode Cochez cette case pour amliorer les performances du systme.
Source keys include Null Cochez cette case pour permettre aux colonnes source cls de contenir des valeurs
nulles.

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.

Guide de rfrence des Composants de Talend Open Studio 395


Scnario associ

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.

396 Guide de rfrence des Composants de Talend Open Studio


tPostgresPlusSCDELT

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Liste des versions de la base de donnes.
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 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.
Source table Nom de la table contenant les donnes filtrer.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois 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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Guide de rfrence des Composants de Talend Open Studio 397


Proprits du tPostgresPlusSCDELT

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear a table : supprimer le contenu de la table.

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
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 :

View schema : slectionnez cette option afin de voir le schma.

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.
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

398 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 399


tPostgresqlSCD

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio 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 la base de donnes 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 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 :

400 Guide de rfrence des Composants de Talend Open Studio


Proprits du tPostgresqlSCD

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez Mthodologie de gestion du SCD.


Use memory saving Cochez cette case pour amliorer les performances du systme.
Mode
Source keys include Null Cochez cette case pour permettre aux colonnes source cls de contenir des valeurs nulles.

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.

Guide de rfrence des Composants de Talend Open Studio 401


Scnario associ

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.

402 Guide de rfrence des Composants de Talend Open Studio


tPostgresqlSCDELT

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Slectionnez dans la liste la version de la base de donnes 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.
Source table Nom de la table contenant les donnes filtrer.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois 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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Guide de rfrence des Composants de Talend Open Studio 403


Proprits du tPostgresqlSCDELT

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear a table : supprimer le contenu de la table.

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
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 :

View schema : slectionnez cette option afin de voir le schma.

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.
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

404 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 405


tSPSSInput

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.

Depuis la version 5.6, les modes Built-in et Repository sont


disponibles dans n'importe quelle solution de Talend.

Pour ce composant, le schma des mtadonnes est directement


rcupr partir du fichier SPSS d'entre, c'est pourquoi il est en
lecture seule.

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.

Si vous cochez cette case, vous devrez nouveau rcuprer


les mtadonnes.
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.

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).

406 Guide de rfrence des Composants de Talend Open Studio


Scnario : Afficher le contenu d'un fichier SPSS

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.

Pour ce faire, procdez comme suit :

1. Ouvrez le Job dans l'espace de modlisation graphique.

2. Cliquez sur l'onglet Run et cliquez sur l'onglet Advanced settings.

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 : Afficher le contenu d'un fichier SPSS


Le scnario suivant cre un Job deux composants qui permet de lire chaque ligne d'un fichier SPSS (.sav) et de
les afficher en sortie dans la console de log de la vue Run.

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.

Configurer le composant d'entre


1. Double-cliquez sur le composant tSPSSInput pour afficher la vue Basic settings et configurer ses
paramtres.

2. Cliquez sur le bouton [...] ct du champ Filename pour parcourir vos dossiers jusqu'au fichier SPSS que
vous voulez lire.

Guide de rfrence des Composants de Talend Open Studio 407


Scnario : Afficher le contenu d'un fichier SPSS

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.

4. Cliquez sur le bouton Yes pour fermer le message.

5. Si ncessaire, cliquez sur le bouton [...] ct du champ Edit schema pour visualiser la structure de donnes
prdfinie dans le fichier SPSS source.

6. Cliquez sur le bouton OK pour fermer la bote de dialogue.

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.

Convertir les valeurs stockes


Afin d'effectuer de convertir les valeurs stockes, procdez comme suit :

408 Guide de rfrence des Composants de Talend Open Studio


Scnario : Afficher le contenu d'un fichier SPSS

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.

5. Enregistrez le Job puis appuyez sur la touche F6 pour l'excuter.

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.

Guide de rfrence des Composants de Talend Open Studio 409


tSPSSOutput

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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.
Filename Nom ou chemin d'accs du fichier SPSS crire.
Write Type Slectionnez dans la liste le type d'action effectuer :

Write: crit simplement les nouvelles donnes.

Append: crit les nouvelles donnes la suite de celles existantes.


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.

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.

410 Guide de rfrence des Composants de Talend Open Studio


Scnario : Ecrire des donnes dans un fichier .sav

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez 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.

Pour ce faire, procdez comme suit :

1. Ouvrez le Job dans l'espace de modlisation graphique.

2. Cliquez sur l'onglet Run et cliquez sur l'onglet Advanced settings.

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 : Ecrire des donnes dans un fichier .sav


Ce scnario dcrit un Job trs simple qui crit des donnes d'entre dans un fichier .sav.

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.

Configurer le composant d'entre


1. Dans l'espace de modlisation graphique, double-cliquez sur le tRowGenerator afin d'afficher sa vue Basic
settings et ouvrir son diteur. Vous pouvez dfinir votre schma.

Guide de rfrence des Composants de Talend Open Studio 411


Scnario : Ecrire des donnes dans un fichier .sav

2. Cliquez sur le bouton [+] afin d'ajouter les colonnes que vous voulez crire dans le fichier .sav.

3. Dfinissez le schma, et configurez les paramtres des colonnes.

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.

4. Cliquez sur OK afin de valider votre schma et fermer l'diteur.

Configurer le composant de sortie


1. Double-cliquez sur le tSPSSOutput afin d'afficher sa vue Component et dfinir ses proprits.

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.

412 Guide de rfrence des Composants de Talend Open Studio


Scnario : Ecrire des donnes dans un fichier .sav

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.

Guide de rfrence des Composants de Talend Open Studio 413


tSPSSProperties

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.

Depuis la version 5.6, les modes Built-in et Repository sont


disponibles dans n'importe quelle solution de Talend.

Pour ce composant, le schma des mtadonnes est prdfini, c'est


pourquoi il est en lecture seule. Il correspond la convention
interne SPSS. Vous pouvez cliquer sur Edit schema pour voir les
mtadonnes prdfinies.
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.
Filename Nom ou chemin d'accs au fichier SPSS traiter.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables IS_VALID_FILE : rsultat de la validation du fichier. Cette variable est une variable After et
retourne un boolen.

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).

414 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Pour ce faire, procdez comme suit :

1. Ouvrez le Job dans l'espace de modlisation graphique.

2. Cliquez sur l'onglet Run et cliquez sur l'onglet Advanced settings.

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 :

Scnario : Lire les donnes matre d'un hub MDM

Scnario : Ecrire des donnes dans un fichier .sav

Guide de rfrence des Composants de Talend Open Studio 415


tSPSSStructure

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.

Depuis la version 5.6, les modes Built-in et Repository sont


disponibles dans n'importe quelle solution de Talend.

Pour ce composant, le schma des mtadonnes est prdfini, c'est


pourquoi il est en lecture seule. Il correspond la convention
interne SPSS. Vous pouvez cliquer sur Edit schema pour voir les
mtadonnes prdfinies.
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.
Filename Nom ou chemin d'accs au fichier SPSS traiter.
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.

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.

416 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Pour plus d'informations sur les niveaux 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.

Pour ce faire, procdez comme suit :

1. Ouvrez le Job dans l'espace de modlisation graphique.

2. Cliquez sur l'onglet Run et cliquez sur l'onglet Advanced settings.

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 :

Scnario : Lire les donnes matre d'un hub MDM.

Scnario : Ecrire des donnes dans un fichier .sav.

Guide de rfrence des Composants de Talend Open Studio 417


tSybaseSCD

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom 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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour passer le schma en


mode Built-In et effectuer des modifications locales.

418 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSybaseSCD

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.

Pour plus d'informations, consultez Mthodologie de gestion du SCD.


Use memory saving Cochez cette case pour amliorer les performances du systme.
Mode
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 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.

Guide de rfrence des Composants de Talend Open Studio 419


Scnario associ

Scnario associ
Pour un scnario associ, consultez tMysqlSCD.

420 Guide de rfrence des Composants de Talend Open Studio


tSybaseSCDELT

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

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.
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.
Source table Nom de la table contenant les donnes filtrer.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois pour que l'opration
d'insert soit autorise.
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.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Clear a table : supprimer le contenu de la table.

Guide de rfrence des Composants de Talend Open Studio 421


Proprits du tSybaseSCDELT

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

422 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 423


tVerticaSCD

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la vue


Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de lire


la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Slectionnez la version de Vertica que vous utilisez.
Host Saisissez l'adresse IP du serveur de 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.
Username Informations d'authentification de l'utilisateur de base de donnes.
et 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. Une seule table peut tre crite le fois.
Action on Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table slectionne :
table
None : aucune opration n'est effectue.

Create a table : la table n'existe pas et est cre.

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.

424 Guide de rfrence des Composants de Talend Open Studio


Proprits du tVerticaSCD

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez Mthodologie de gestion du SCD.


Use Cochez cette case pour amliorer les performances du systme.
memory
saving
mode
Die on Cette case est dcoche par dfaut, ce qui vous permet de terminer le traitement avec les lignes sans
error erreur, et ignorer les lignes en erreur.
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.
End date Spcifiez la valeur de temps du paramtre de date et heure de fin du SCD au format HH:mm:ss. La
time details 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 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.

Guide de rfrence des Composants de Talend Open Studio 425


Conseils et techniques

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez 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.

426 Guide de rfrence des Composants de Talend Open Studio


Composants Cloud
Ce chapitre passe en revue les principaux composants prsents dans la famille Cloud de la Palette dans la
perspective Integration du Studio Talend.

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.

Guide de rfrence des Composants de Talend Open Studio


tAmazonAuroraClose

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.

428 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Guide de rfrence des Composants de Talend Open Studio 429


tAmazonAuroraCommit

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.

Si vous utilisez un lien de type Row > Main pour relier le


tAmazonAuroraCommit votre Job, vos donnes seront commites
ligne par ligne. Dans ce cas, ne cochez pas la case Close connection
car la connexion sera ferme avant la fin du commit de votre premire
ligne.
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 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).

430 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Scnario associ
La base de donnes Aurora est compatible avec MySQL v5.6. Pour un scnario similaire, consultez :

Scnario 1 : Insrer des donnes dans des tables mre/fille

Guide de rfrence des Composants de Talend Open Studio 431


tAmazonAuroraConnection

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.

Cette case est indisponible lorsque la case Use or register a shared DB


Connection est coche.
Data source alias Saisissez l'alias de la source de donnes cre, du ct Talend Runtime.

432 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Notez que la fonctionnalit d'auto-commit permet de commiter chaque


instruction SQL comme transaction unique immdiatement aprs son excution
et que le composant de commit ne commite pas jusqu' ce que toutes les
instructions soient excutes. Pour cette raison, si vous avez besoin de plus
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 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 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 1 : Insrer des donnes dans des tables mre/fille.

Scnario 2 : Partager une connexion de base de donnes entre un Job pre et un Job fils.

Guide de rfrence des Composants de Talend Open Studio 433


tAmazonAuroraInput

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion
crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion


travers diffrents niveaux de Jobs, consultez le Guide utilisateur du
Studio Talend.
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.
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.
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.

434 Guide de rfrence des Composants de Talend Open Studio


Proprits du tAmazonAuroraInput

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 :

View schema : slectionnez cette option afin de voir le schma.

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 Saisissez le nom de la table lire.
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 afin de gnrer la requte correspondant au schma de la
table dans le champ Query.
Guess schema Cliquez sur ce bouton afin de rcuprer le schma de la table.
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.

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.

Ce champ est indisponible lorsque la case Use an existing connection est


coche dans l'onglet Basic settings.
Enable stream Cochez cette case pour prfrer le streaming la mise en mmoire tampon, ce
qui permet au code de lire les donnes d'une table volumineuse sans consommer
beaucoup de mmoire, afin d'optimiser 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 Cochez la (les) case(s) de la colonne Trim afin de supprimer les espaces en
dbut et en fin de champ dans les colonnes slectionnes.

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.

Guide de rfrence des Composants de Talend Open Studio 435


Scnarios associs

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.

436 Guide de rfrence des Composants de Talend Open Studio


tAmazonAuroraOutput

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion
crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio
Talend.
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.
Username et Password Saisissez les informations d'authentification de l'utilisateur 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 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 :

None : n'effectuer aucune opration sur la table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Guide de rfrence des Composants de Talend Open Studio 437


Proprits du tAmazonAuroraOutput

Drop table if exists and create : supprimer la table si elle existe dj, puis en
crer une nouvelle.

Clear table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans


possibilit de Rollback.
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.

Update : mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la


rfrence donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si


l'enregistrement n'existe pas, un nouvel enregistrement est insr.

Delete : supprimer les entres correspondant au flux d'entre.

Replace: ajouter de nouvelles entres la table. Si une ancienne ligne dans la


table a la mme valeur qu'une nouvelle ligne pour un index PRIMARY KEY ou
UNIQUE, l'ancienne ligne est supprime avant insertion de la nouvelle.

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.

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 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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying


+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

438 Guide de rfrence des Composants de Talend Open Studio


Proprits du tAmazonAuroraOutput

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].
Specify a data source alias Cochez cette case et spcifiez l'alias de la source de donnes cre dans 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.

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.

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.

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.

Ce champ est disponible lorsque la case Extend Insert est coche.


Use Batch Size Cochez cette case afin d'activer le mode batch pour le traitement des donnes.

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.

Name : saisissez le nom de la colonne du schma modifier ou insrer.

SQL expression : saisissez l'instruction SQL excuter afin de modifier ou


insrer les donnes dans la colonne correspondante.

Position : slectionnez Before, After ou Replace, selon l'action effectuer sur


la colonne de rfrence.

Guide de rfrence des Composants de Talend Open Studio 439


Proprits du tAmazonAuroraOutput

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.

Key in update : cochez la case de la colonne correspondante, par rapport


laquelle les donnes sont mises jour.

Key in delete : cochez la case de la colonne correspondante, par rapport


laquelle les donnes sont supprimes.

Updatable : cochez la case si les donnes de la colonne correspondante peuvent


tre mises jour.

Insertable : cochez la case si les donnes de la colonne correspondante peuvent


tre insres.
Use Hint Options Cochez cette case pour configurer les indicateurs pouvant permettre d'optimiser
l'excution d'une requte.
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 /*


+ */.

POSITION : spcifiez la place de l'indicateur dans une instruction SQL.

SQL STMT*: slectionnez l'instruction SQL INSERT, UPDATE, ou


DELETE utiliser.
Enable debug mode Cochez cette case pour afficher chaque tape du processus d'criture dans la base
de donnes.
Use duplicate key update Cochez cette case pour activer le mode ON DUPLICATE KEY UPDATE, puis
mode insert cliquez sur le bouton [+] sous la table pour ajouter des colonnes mettre jour et
spcifiez l'action de mise jour effectuer sur la colonne correspondante.

Column : saisissez le nom de la colonne mettre jour.

Value : saisissez l'action effectuer sur la colonne.

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.

440 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 :

Scnario 1 : Ajouter une colonne et modifier les donnes

Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject

Guide de rfrence des Composants de Talend Open Studio 441


tAmazonAuroraRollback

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 :

442 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Scnario : Annuler l'insertion de donnes dans des tables mre/fille

Guide de rfrence des Composants de Talend Open Studio 443


tAmazonMysqlClose

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.

Pour un scnario associ au composant tAmazonMysqlClose, consultez tMysqlConnection.

444 Guide de rfrence des Composants de Talend Open Studio


tAmazonMysqlCommit

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.

Si vous utilisez un lien de type Row > Main pour relier


le tAmazonMysqlCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 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.

Guide de rfrence des Composants de Talend Open Studio 445


Scnario associ

Pour plus d'informations sur les niveaux 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.

446 Guide de rfrence des Composants de Talend Open Studio


tAmazonMysqlConnection

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

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.
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.
Additional JDBC Spcifiez des informations supplmentaires de connexion la base
parameters de donnes cre.
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 DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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

Guide de rfrence des Composants de Talend Open Studio 447


Scnario associ

doivent tre commites de manire explicite l'aide du composant


correspondant de commit.

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 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 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

448 Guide de rfrence des Composants de Talend Open Studio


tAmazonMysqlInput

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion
crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
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.
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 sera cr et conserv pour ce composant seulement. Voir


galement le Guide utilisateur du Studio Talend.

Guide de rfrence des Composants de Talend Open Studio 449


Proprits du tAmazonMysqlInput

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 lire.
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.
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.

Lorsque vous devez traiter des donnes au format date/heure


0000-00-00 00:00:00 utilisant ce composant, dfinissez les paramtres
comme suit :

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.

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 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).

450 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Scnarios associs
Pour des scnarios associs, consultez tMysqlInput.

Guide de rfrence des Composants de Talend Open Studio 451


tAmazonMysqlOutput

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion
crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
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 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 :

Default : n'effectuer aucune opration sur la table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

452 Guide de rfrence des Composants de Talend Open Studio


Proprits du tAmazonMysqlOutput

Drop a table if exists and create : supprimer la table si elle existe dj, puis
en crer une nouvelle.

Clear a table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans


possibilit de Rollback.
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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la


rfrence donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si


l'enregistrement n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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.

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 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 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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/


Verifying+default+values+in+a+retrieved+schema (en anglais).
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.

Guide de rfrence des Composants de Talend Open Studio 453


Proprits du tAmazonMysqlOutput

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.

Si vous utilisez ce composant avec un tMysqlLastInsertID, soyez sr


de dcocher la case Extend Insert dans la vue Advanced settings.
Extend Insert permet le chargement par lots, cependant, si la case
est coche, seul l'ID de la dernire ligne du dernier lot sera retourn.
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
tAmazonMysqlOutput 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


/*+ */

- POSITION : spcifiez la place de l'indicateur dans une instruction SQL.

- SQL STMT : slectionnez l'instruction SQL que vous souhaitez utiliser.


Enable debug mode Cochez cette case pour afficher chaque tape du processus d'criture dans la
base de donnes.
Use duplicate key update Met jour les valeurs des colonnes spcifies en cas de doublon de la cl
mode insert primaire.

Column : Saisissez entre guillemets le nom de la colonne mettre jour.

Value : Saisissez l'opration que vous souhaitez effectuer sur la colonne.

Pour utiliser cette option, vous devez pralablement slectionner le


mode Insert 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 composant.

454 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

Guide de rfrence des Composants de Talend Open Studio 455


tAmazonMysqlRollback

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.

456 Guide de rfrence des Composants de Talend Open Studio


tAmazonMysqlRow

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion
crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
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.
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.

Guide de rfrence des Composants de Talend Open Studio 457


Proprits du tAmazonMysqlRow

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/


Verifying+default+values+in+a+retrieved+schema (en anglais).
Table Name Nom de la table traiter.
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 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.

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 PreparedStatement Cochez cette case pour utiliser une instance PreparedStatement afin de requter
votre base 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

458 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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 3 : Combiner deux flux pour une sortie slective

Guide de rfrence des Composants de Talend Open Studio 459


tAmazonOracleClose

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.

Pour un scnario associ au composant tAmazonOracleClose, consultez tMysqlConnection.

460 Guide de rfrence des Composants de Talend Open Studio


tAmazonOracleCommit

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.

Si vous utilisez un lien de type Row > Main pour relier le


tOracleCommit votre Job, vos donnes seront commites
ligne par ligne. Dans ce cas, ne cochez pas la case Close
connection car la connexion sera ferme avant la fin du
commit de votre premire ligne.
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 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.

Guide de rfrence des Composants de Talend Open Studio 461


Scnario associ

Pour plus d'informations sur les niveaux 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.

462 Guide de rfrence des Composants de Talend Open Studio


tAmazonOracleConnection

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 :

Oracle SID : Slectionnez ce type de connexion pour identifier


exclusivement une base de donnes spcifique sur un systme.
DB Version Oracle 11-5 est disponible.
Use tns file Cochez cette case pour utiliser les mtadonnes d'un contexte contenu dans
un fichier tns.

Un mme fichier Tns peut contenir plusieurs contextes.

TNS File : Renseignez manuellement le chemin d'accs ou cliquez sur le


bouton [...] pour parcourir vos dossiers jusqu'au fichier Tns utiliser.

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.

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.
Additional JDBC Spcifiez des informations supplmentaires de connexion la base de
parameters donnes cre.

Dans ce champ, vous pouvez paramtrer le type d'encodage.

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.

Guide de rfrence des Composants de Talend Open Studio 463


Scnario associ

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.

Shared DB Connection Name : dfinissez ou saisissez le nom de la


connexion partage.
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.

Notez que la fonctionnalit d'auto-commit permet de commiter chaque


instruction SQL comme transaction unique immdiatement aprs son
excution et que le composant de commit ne commite pas jusqu' ce que
toutes les instructions soient excutes. Pour cette raison, si vous avez besoin
de plus despace pour grer vos transactions dans un Job, il est recommand
d'utiliser un composant Commit.
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement du Job 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 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.

464 Guide de rfrence des Composants de Talend Open Studio


tAmazonOracleInput

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 :

Oracle SID : Slectionnez ce type de connexion pour identifier exclusivement


une base de donnes spcifique sur in systme.
DB Version Slectionnez la version d'Oracle que vous utilisez.
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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion
crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Oracle schema Nom du schma Oracle.
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.
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

Guide de rfrence des Composants de Talend Open Studio 465


Proprits du tAmazonOracleInput

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.
Table name Nom de la table de base de donnes.
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.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
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 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 Supprimer les espaces en dbut et en fin de champ dans les colonnes
slectionnes.
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 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.

466 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 second scnario du composant tDBInput, dans Scnario 2 : Utiliser la variable StoreSQLQuery.

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.

Guide de rfrence des Composants de Talend Open Studio 467


tAmazonOracleOutput

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion
crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion


travers diffrents niveaux de Jobs, consultez le Guide utilisateur du
Studio Talend.
Connection type Liste droulante des pilotes disponibles :

Oracle SID : Slectionnez ce type de connexion pour identifier exclusivement


une base de donnes spcifique sur un systme.
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 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.
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.

468 Guide de rfrence des Composants de Talend Open Studio


Proprits du tAmazonOracleOutput

Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table
slectionne :

None : neffectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui nexiste pas encore.

Create table if doesnt exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis
en crer une nouvelle.

Clear a table : supprimer le contenu de la table.

Si vous cochez la case Use an existing connection et slectionnez


une option diffrente de None dans la liste Action on table, une
instruction de commit est gnre automatiquement avant l'opration
de mise jour/insertion/suppression 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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la


rfrence donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si


l'enregistrement n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondant au flux d'entre.

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 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.

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 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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/


Verifying+default+values+in+a+retrieved+schema (en anglais).

Guide de rfrence des Composants de Talend Open Studio 469


Proprits du tAmazonOracleOutput

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.

Vous pouvez appuyer sur Ctrl+Espace afin d'accder une liste de


variables globales prdfinies.
Override any existing Cochez cette case pour craser les variables d'environnement NLS_LANG dj
NLS_LANG environment dfinies.
variable
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.
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
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 afin d'activer la configuration de la zone des Hints, vous
permettant ainsi d'optimiser l'excution d'une requte. Dans cette zone, les
paramtres sont :

- HINT : spcifiez l'hint dont vous avez besoin, l'aide de la syntaxe /*+ */.

-POSITION : spcifiez o mettre l'hint dans une instruction SQL.

- SQL STMT : slectionnez l'instruction SQL que vous souhaitez utiliser.


Convert columns and Cochez cette case pour passer les noms de colonnes et de tables en majuscule.
table to uppercase
Enable debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans
la base de donnes.
Use Batch Size Nombre de lignes dans chaque lot de traitement de donnes.

Si cette case n'apparat pas, vrifiez que la case Use an existing


connection dans les Basic settings est dcoche.
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.

470 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

tMysqlOutput : dans Scnario 1 : Ajouter une colonne et modifier les donnes.

Guide de rfrence des Composants de Talend Open Studio 471


tAmazonOracleRollback

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.

472 Guide de rfrence des Composants de Talend Open Studio


tAmazonOracleRow

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion
crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion


travers diffrents niveaux de Jobs, consultez le Guide utilisateur du
Studio Talend.
Connection type Liste droulante des pilotes disponibles.
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 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.
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.

Guide de rfrence des Composants de Talend Open Studio 473


Proprits du tAmazonOracleRow

Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il


peut tre rutilis. Voir galement le Guide utilisateur du Studio Talend.
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.
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.

NONE : n'alimente pas la variable.

INSERTED : alimente la variable avec le nombre de lignes insres.

UPDATED : alimente la variable avec le nombre de lignes mises jour.

DELETED : alimente la variable avec le nombre de lignes supprimes.


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 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 PreparedStatement Cochez cette case pour utiliser une instance PreparedStatement afin de requter
votre base 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

474 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

tDBSQLRow: Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes.

tMySQLRow: Scnario 1 : Supprimer et re-gnrer un index de table MySQL.

Guide de rfrence des Composants de Talend Open Studio 475


tBoxConnection

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

476 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Scnario associ
Pour un scnario associ, consultez Scnario : Charger et tlcharger des fichiers depuis Box.

Guide de rfrence des Composants de Talend Open Studio 477


tBoxCopy

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.

478 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Notez que le schma de ce composant est en lecture seule. Il a quatre


colonnes nommes destinationFilePath, destinationFileName,
sourceDirectory et destinationDirectory.
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.

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.

DESTINATION_DIRECTORY : rpertoire cible. 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.

Guide de rfrence des Composants de Talend Open Studio 479


tBoxDelete

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.

Notez que le schma de ce composant est en lecture seule. Il contient


une seule colonne nomme filepath.
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.

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.

480 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez 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.

Guide de rfrence des Composants de Talend Open Studio 481


tBoxGet

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.

Notez que le schma de ce composant est en lecture seule. Il contient


deux colonnes nommes fileName et content.

Le champ Schema n'est disponible que si vous cochez la case Save


as file.
Advanced settings tStatCatcher Statistics Cochez cette case afin de collecter les informations de log au niveau
du composant.

482 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 483


tBoxList

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.

Notez que le schma de ce composant est en lecture seule. Il contient


six colonnes nommes name, path, lastModified, size, id et type.
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.

NAME : le nom du fichier distant trait. Cette variable est une variable Flow et retourne une chane
de caractres.

484 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

LAST_MODIFIED : date et heure de la dernire modification apporte au fichier trait. Cette


variable est une variable Flow et retourne un long.

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.

Guide de rfrence des Composants de Talend Open Studio 485


tBoxPut

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 :

Upload incoming content as file : Slectionnez ce bouton radio


afin de lire les donnes directement depuis le flux d'entre du
composant prcdent. Ces donnes sont ensuite crites dans le
fichier spcifi dans le champ Remote Path.

Upload local file : Slectionnez ce bouton radio afin de charger un


fichier local sur Box. Dans le champ File qui s'affiche, saisissez le
chemin ou parcourez votre systme jusqu' ce fichier.

Expose as OutputStream : Cochez cette case afin d'exposer le flux


de sortie de ce composant. Ce flux de sortie peut tre utilis par
d'autres composants afin d'crire des donnes dans le fichier. Par
exemple, vous pouvez utiliser la fontionnalit Use output stream
du composant tFileOutputDelimited afin d'alimenter le flux de
sortie d'un tBoxPut expos. Pour plus d'informations, consultez
tFileOutputDelimited.

486 Guide de rfrence des Composants de Talend Open Studio


Scnario : Charger et tlcharger des fichiers depuis Box

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.

Notez que le schma de ce composant est en lecture seule. Il contient


une seule colonne nomme content et reoit des donnes uniquement
depuis la colonne content du schma d'entre. Cela signifie que vous
devez utiliser une colonne content dans le flux de donnes d'entre
afin de transporter les donnes charger. Ce type de colonne est
gnralement fournit par le composant tFileInputRaw. Pour plus
d'informations, consultez tFileInputRaw.

Le champ Schema n'est disponible que si vous avez slectionn le


mode de chargement Expose as OutputStream ou Upload local file.
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 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

Scnario : Charger et tlcharger des fichiers depuis


Box
Ce scnario dcrit un Job de trois composants qui charge un fichier sur Box puis tlcharge un fichier depuis Box
sur votre systme de fichiers local.

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.

Guide de rfrence des Composants de Talend Open Studio 487


Scnario : Charger et tlcharger des fichiers depuis Box

Relier les composants


1. Dans la perspective Integration du Studio, crez un Job vierge depuis le nud Job Designs du Repository.

Pour plus d'informations sur la cration d'un Job, consultez le Guide utilisateur du Studio Talend.

2. Dans l'espace de modlisation graphique, saisissez le nom du composant utiliser et slectionnez ce


composant dans la liste qui s'ouvre. Dans ce scnario, les composants sont le tBoxConnection, le tBoxPut
et le tBoxGet.

3. Reliez le tBoxConnection au tBoxPut l'aide d'un lien Trigger > OnSubjobOk.

4. Reliez le tBoxPut au tBoxGet l'aide d'un lien Trigger > OnSubjobOk.

Configurez les composants


1. Double-cliquez sur le tBoxConnection afin d'ouvir sa vue Component.

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.

3. Double-cliquez sur le tBoxPut afin d'ouvrir sa vue Component.

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.

5. Double-cliquez sur le tBoxGet afin d'ouvrir sa vue Component.

488 Guide de rfrence des Composants de Talend Open Studio


Scnario : Charger et tlcharger des fichiers depuis Box

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.

Guide de rfrence des Composants de Talend Open Studio 489


Scnario : Charger et tlcharger des fichiers depuis Box

490 Guide de rfrence des Composants de Talend Open Studio


tCloudStart

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du


champ Secret key, 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.
Cloud provider Slectionnez le fournisseur Cloud utiliser.
Image Saisissez le nom de l'image de la machine Amazon (Amazon
Machine Image) utiliser pour lancer une instance. L'AMI dfinit
la configuration de base de cette instance.
Region et Zone Saisissez la rgion et la zone utiliser comme emplacement
gographique o lancer une instance.

La syntaxe utilise pour exprimer un lieu est prdfinie par


Amazon. Par exemple, us-east-1 reprsente la rgion US East
(Northern Virginia) et us-east-1a reprsente l'une es zones
de disponibilit dans cette rgion. Pour plus d'informations
propos des rgions disponibles pour Amazon, consultez la
documentation Amazon concernant les rgions et les endpoints
ainsi que la FAQ Amazon des rgions et des zones de
disponibilit.
Instance name Saisissez le nom de l'instance lancer. Par exemple, vous pouvez
saisir Talend.

Notez que toute lettre en majuscule sera convertie en minuscule.


Instance count Saisissez le nombre d'instances lancer. Au moment de
l'excution, le nom spcifi dans le champ Instance name, par
exemple Talend, est utilis comme premire partie du nom de
chaque instance. Des lettres et des chiffres sont ajouts au hasard
afin de complter chaque nom.
Instance type Slectionnez le type d'instance(s) lancer. Chaque type est
prdfini par Amazon et dfinit la performance de chaque
instance lancer.

Cette liste droulante prsente le nom de l'API pour chaque type


d'instance. Pour plus d'informations, consultez la documentation
Amazon concernant les types d'instance.
Proceed with a Key pair Cochez cette case pour utiliser la paire de cls Amazon (Key Pair)
afin de vous connecter Amazon EC2. Une fois la case coche,
une liste droulante apparat. Vous pouvez slectionner :

Use an existing Key Pair pour saisir le nom de cette paire de


cls dans le champ ct de la liste droulante. Si ncessaire,

Guide de rfrence des Composants de Talend Open Studio 491


Scnario associ

Amazon vous demande de trouver et d'utiliser cette paire de


cls lors de l'excution.

Create a Key Pair pour saisir le nom de la nouvelle paire


de cls dans le champ ct de la liste droulante et dfinir
l'emplacement o stocker cette paire de cls, dans la vue
Advanced settings.
Security group Ajoutez des lignes dans cette table et saisissez les noms des
groupes de scurit auxquels vous devez assigner l'instance ou
les instances lancer. Les groupes de scurit configurs dans
cette table doivent exister dans votre Amazon EC2.

Un groupe de scurit applique des rgles spcifiques sur le


trafic entrant dans les instances assignes au groupe, comme les
ports utiliser. Pour plus d'informations concernant les groupes
de scurit, consultez la documentation Amazon concernant les
groupes de scurit.
Advanced settings Key Pair folder Parcourez votre systme, ou saisissez le chemin d'accs au
dossier utiliser pour stocker la paire de cls cre.

Ce champ apparat lorsque vous slectionnez Creating a Key


Pair dans l'onglet Basic settings.
Volumes Ajoutez des lignes et dfinissez le(s) volume(s) crer pour les
instances lancer, en plus des volumes prdfinis et allous par
votre Amazon EC2.

Les paramtres configurer dans cette table ont la mme valeur


que les paramtres utiliss Amazon pour dcrire un volume.

Si vous devez supprimer automatiquement un volume


supplmentaire aprs la fin de son instance relative, cochez la
case dans la colonne Delete on termination.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau des
composants.
Global Variables NODE_GROUP : nom de l'instance. Cette variable est une variable After et retourne une chane
de caractres.

NODES : instances en cours d'excution. Cette variable est une variable After et retourne un
object.

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 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.

492 Guide de rfrence des Composants de Talend Open Studio


tCloudStop

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du


champ Secret key, 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.
Cloud provider Slectionnez le fournisseur Cloud utiliser.
Action Slectionnez l'action que doit effectuer le tCloudStop afin de
modifier le statut d'une instance donne. L'action peut tre :

Suspend

Resume

Terminate

Notez que si vous terminez une instance, cette instance est


supprime, alors que vous pouvez toujours reprendre une
instance suspendue.
Predicate Slectionnez l'instance ou les instances dont vous souhaitez
modifier le statut. Les options sont les suivantes :

Running instances : le statut de toutes les instances en cours


est modifi.

Instances in a specific group : le statut des instances d'un


groupe d'instances spcifique est modifi. Vous devez saisir le
nom de ce groupe dans le champ Group name.

Running instances in a specific group : le statut des instances


en cours d'un groupe d'instances spcifiques est modifi. Vous
devez saisir le nom de ce groupe dans le champ Group name.

Instance with predefined id : le statut d'une instance donne


est modifi. Vous devez saisir l'ID de cette instance dans le
champ Id. Vous pouvez trouver cet ID dans votre Amazon
EC2.

Un groupe d'instances se compose d'instances utilisant le mme


nom d'instance, dfini dans le champ Instance name du
composant tCloudStart.
Group name Saisissez le nom du groupe dans lequel vous souhaitez modifier
le statut des instances donnes. Ce champ apparat lorsque
vous slectionnez Instances in a specific group ou Running
instances in a specific group dans la liste Predicate.

Guide de rfrence des Composants de Talend Open Studio 493


Scnario associ

Id Saisissez l'ID de l'instance dont vous devez changer le statut.


Le champ apparat lorsque vous slectionnez Instance with
predefined id dans la liste Predicate.
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 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.

494 Guide de rfrence des Composants de Talend Open Studio


tDropboxConnection

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.

Notez qu'une application Dropbox doit avoir t cre au


pralable sous ce compte avant que le jeton d'accs puisse tre
gnr. Pour plus d'informations concernant les jetons d'accs
Dropbox, consultez https://www.dropbox.com/developers/blog/94/
generate-an-access-token-for-your-own-account (en anglais).
Use HTTP proxy Si vous utilisez un proxy, cochez cette case et saisissez les
informations d'hte et de port de ce proxy dans les champs
correspondants qui s'affichent.
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 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

Guide de rfrence des Composants de Talend Open Studio 495


tDropboxDelete

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 qu'une application Dropbox doit avoir t cre au


pralable sous ce compte avant que le jeton d'accs puisse tre
gnr. Pour plus d'informations concernant les jetons d'accs
Dropbox, consultez https://www.dropbox.com/developers/blog/94/
generate-an-access-token-for-your-own-account (en anglais).
Use HTTP proxy Si vous utilisez un proxy, cochez cette case et saisissez les
informations d'hte et de port de ce proxy dans les champs
correspondants qui s'affichent.
Path Renseignez le chemin Dropbox d'accs au dossier ou fichier que vous
souhaitez supprimer.

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.

496 Guide de rfrence des Composants de Talend Open Studio


tDropboxGet

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 qu'une application Dropbox doit avoir t cre au


pralable sous ce compte avant que le jeton d'accs puisse tre
gnr. Pour plus d'informations concernant les jetons d'accs
Dropbox, consultez https://www.dropbox.com/developers/blog/94/
generate-an-access-token-for-your-own-account (en anglais).
Use HTTP proxy Si vous utilisez un proxy, cochez cette case et saisissez les
informations d'hte et de port de ce proxy dans les champs
correspondants qui s'affichent.
Path Renseignez le chemin Dropbox d'accs au fichier que vous souhaitez
tlcharger.

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.

Guide de rfrence des Composants de Talend Open Studio 497


Scnario associ

Limitation n/a

Scnario associ
Aucun scnario n'est disponible pour ce composant.

498 Guide de rfrence des Composants de Talend Open Studio


tDropboxList

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 qu'une application Dropbox doit avoir t cre au


pralable sous ce compte avant que le jeton d'accs puisse tre
gnr. Pour plus d'informations concernant les jetons d'accs
Dropbox, consultez https://www.dropbox.com/developers/blog/94/
generate-an-access-token-for-your-own-account (en anglais).
Use HTTP proxy Si vous utilisez un proxy, cochez cette case et saisissez les
informations d'hte et de port de ce proxy dans les champs
correspondants qui s'affichent.
Path Renseignez le chemin d'accs vers le dossier dont vous souhaitez
lister les fichiers, ou renseignez le chemin d'accs vers le fichier exact
que vous souhaitez lire.

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.

LAST_MODIFIED : date et heure de la dernire modification apporte au fichier trait. Cette


variable est une variable Flow et retourne un long.

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.

Guide de rfrence des Composants de Talend Open Studio 499


Scnario associ

Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez 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.

500 Guide de rfrence des Composants de Talend Open Studio


tDropboxPut

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 qu'une application Dropbox doit avoir t cre au pralable


sous ce compte avant que le jeton d'accs puisse tre gnr.
Pour plus d'informations concernant les jetons d'accs Dropbox,
consultez https://www.dropbox.com/developers/blog/94/generate-an-
access-token-for-your-own-account (en anglais).
Use HTTP proxy Si vous utilisez un proxy, cochez cette case et saisissez les informations
d'hte et de port de ce proxy dans les champs correspondants qui
s'affichent.
Path (File only) Renseignez le chemin d'accs vers le fichier dans lequel vous souhaitez
crire du contenu. Ce fichier est cr s'il n'existe pas.

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 :

Rename if existing : le fichier tlcharg dans Dropbox est


automatiquement renomm. Par exemple, un fichier nomm test.txt
peut tre renomm en test (1).txt.

Replace if existing : le fichier tlcharg dans Dropbox remplace le


fichier dj existant.

Update specified revision : le fichier que vous tlchargez dans


Dropbox est utilis pour mettre jour une rvision spcifique de ce
fichier. Si la rvision que vous spcifiez est la dernire rvision, alors
le fichier existant dans Dropbox est remplac. S'il s'agit une rvision
antrieure, le fichier que vous tlchargez est renomm pour indiquer
qu'il y a un conflit. Si la rvision n'existe pas, une erreur est retourne.
Upload incoming content Slectionnez ce bouton radio pour lire les donnes directement du flux
as file d'entre du composant prcdent et crire les donnes dans le fichier
spcifi 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.

Notez que le schma de ce composant est en lecture seule et est


compos d'une seule colonne appele content. Il reoit des donnes de
la colonne content de son schma d'entre uniquement. Cela signifie
que vous devez utiliser une colonne content dans le flux de donnes
d'entre pour transporter les donnes tlcharger. Ce type de colonne

Guide de rfrence des Composants de Talend Open Studio 501


Scnario : Tlcharger des fichiers dans Dropbox

est gnralement fourni par le composant tFileInputRaw. Pour plus


d'informations, consultez tFileInputRaw.

Le champ Schema n'est pas disponible lorsque vous slectionnez le


bouton radio Expose as OutputStream ou Upload local file.
Upload local file Slectionnez ce bouton radio pour tlcharger dans Dropbox un fichier
stock localement. Dans le champ File qui s'affiche, vous devez saisir
le chemin d'accs ou parcourir votre systme jusqu'au fichier.
Expose as OutputStream Cochez cette case pour exposer le flux de sortie de ce composant
en tant que variable appele OUTPUTSTREAM, afin que les autres
composants puissent rutiliser cette variable pour crire le contenu
tlcharger dans le flux de sortie expos.

Par exemple, vous pouvez utiliser la fonctionnalit Use output stream


du composant tFileOutputDelimited pour alimenter le flux de sortie
expos d'un tDropboxPut donn. Pour plus d'informations, consultez
tFileOutputDelimited.
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.

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

Scnario : Tlcharger des fichiers dans Dropbox


Dans ce scnario, un Job six composants compos de trois sous-jobs est cr pour crire des donnes dans
Dropbox l'aide de diffrents modes de tlchargement.

502 Guide de rfrence des Composants de Talend Open Studio


Scnario : Tlcharger des fichiers dans Dropbox

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 l'application Dropbox, consultez https://www.dropbox.com/developers/apps/


.

Relier les composants


1. Dans la perspective Integration du Studio, crez un Job vide partir du nud Job Designs dans la vue
Repository.

Pour plus d'informations concernant la cration d'un Job, consultez le Guide utilisateur du Studio Talend.

2. Dans l'espace de modlisation, saisissez le nom du composant utiliser et slectionnez ce composant


dans la liste qui apparat. Dans ce scnario, les composants utiliss sont le tDropboxConnection, le
tFixedFlowInput, le tFileOutputDelimited, le tFileInputRaw et deux composants tDropboxPut.

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.

Guide de rfrence des Composants de Talend Open Studio 503


Scnario : Tlcharger des fichiers dans Dropbox

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.

Gnrer le flux de sortie

Dfinir les donnes d'entre

1. Double-cliquez sur le tFixedFlowInput pour ouvrir sa vue Component.

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.

504 Guide de rfrence des Composants de Talend Open Studio


Scnario : Tlcharger des fichiers dans Dropbox

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.

6. Saisissez dans cette table les donnes mentionnes ci-dessus.

Dfinir le flux de sortie

1. Double-cliquez sur le tFileOutputDelimited pour ouvrir sa vue Component.

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.

Guide de rfrence des Composants de Talend Open Studio 505


Scnario : Tlcharger des fichiers dans Dropbox

Exposer le flux de sortie du tDropboxPut


1. Double-cliquez sur le composant tDropboxPut reli au tFileOutputDelimited pour ouvrir sa vue
Component.

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.

4. Dans la zone Upload mode, slectionnez le bouton radio Rename if Existing.

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.

Dfinir les donnes du mdia tlcharger


1. Double-cliquez sur le tFileInputRaw pour ouvrir sa vue Component.

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.

506 Guide de rfrence des Composants de Talend Open Studio


Scnario : Tlcharger des fichiers dans Dropbox

Mettre jour le contenu entrant


1. Double-cliquez sur le composant tDropboxPut reli au tFileInputRaw pour ouvrir sa vue Component.

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.

4. Dans la zone Upload mode, slectionnez Rename if existing.

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.

Guide de rfrence des Composants de Talend Open Studio 507


tGoogleDriveConnection

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

508 Guide de rfrence des Composants de Talend Open Studio


Obtenir un jeton d'accs Google Drive

Obtenir un jeton d'accs Google Drive


Pour utiliser les API Google Drive, vous devez obtenir le jeton d'accs en compltant les tapes suivantes dans
Google Chrome ayant l'extension REST Console installe :

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.

Guide de rfrence des Composants de Talend Open Studio 509


Obtenir un jeton d'accs Google Drive

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.

510 Guide de rfrence des Composants de Talend Open Studio


Obtenir un jeton d'accs Google Drive

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.

client_id : valeur de CLIENT ID dans la vue Credentials.

redirect_uri : valeur de REDIRECT URIS dans la vue Credentials.

response_type : valeur code.

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).

access_type : valeur online.

Guide de rfrence des Composants de Talend Open Studio 511


Obtenir un jeton d'accs Google Drive

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.

512 Guide de rfrence des Composants de Talend Open Studio


Obtenir un jeton d'accs Google Drive

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.

code : code d'autorisation gnr dans l'tape prcdente.

client_id : valeur de CLIENT ID dans la vue Credentials.

client_secret : valeur de CLIENT SECRET dans la vue Credentials.

redirect_uri : valeur de REDIRECT URIS dans la vue Credentials.

grant_type : valeur authorization_code.

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

Guide de rfrence des Composants de Talend Open Studio 513


Scnario associ

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.

514 Guide de rfrence des Composants de Talend Open Studio


tGoogleDriveCopy

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 l'option File est slectionne.


Source Folder Name Saisissez le nom du dossier source dplacer.

Ce champ est disponible uniquement lorsque l'option Folder est slectionne.


Destination Folder Name Saisissez le nom du dossier de destination dans lequel copier ou dplacer le
fichier ou le dossier.
Rename (set new title) Cochez cette case afin de renommer le fichier ou dossier copi ou dplac dans
le dossier de destination.
Destination Name Saisissez le nom du fichier/dossier aprs copie ou dplacement dans le dossier
de destination.

Guide de rfrence des Composants de Talend Open Studio 515


Scnario associ

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.

Ce champ est disponible uniquement lorsque l'option File est slectionne.


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 de ce composant est en lecture seule. Vous pouvez cliquer sur le


bouton [...] ct de Edit schema afin de voir le schma prdfini contenant
les champs suivants :

sourceFileID : ID du fichier/dossier source.

destinationFileID : ID du fichier/dossier de destination.


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 SOURCE_FILEID : ID du fichier/dossier source. Cette variable est une variable After et retourne une
chane de caractres.

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.

516 Guide de rfrence des Composants de Talend Open Studio


tGoogleDriveCreate

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.

Le schma de ce composant est en lecture seule. Vous pouvez cliquer sur le


bouton [...] ct de Edit schema afin de voir le schma prdfini contenant
les champs suivants :

parentFolderID : ID du dossier pre.

newFolderID : ID du nouveau dossier crer.


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 PARENTFOLDERID : ID du dossier pre. Cette variable est une variable After et retourne une chane
de caractres.

Guide de rfrence des Composants de Talend Open Studio 517


Scnario associ

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.

518 Guide de rfrence des Composants de Talend Open Studio


tGoogleDriveDelete

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.

Guide de rfrence des Composants de Talend Open Studio 519


Scnario associ

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez 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.

520 Guide de rfrence des Composants de Talend Open Studio


tGoogleDriveGet

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.

Le schma de ce composant est en lecture seule. Vous pouvez cliquer sur le


bouton [...] ct de Edit schema afin de voir le schma prdfini ayant un
champ nomm content, dcrivant le contenu du fichier tlcharger.
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.

Guide de rfrence des Composants de Talend Open Studio 521


Scnario associ

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.

522 Guide de rfrence des Composants de Talend Open Studio


tGoogleDriveList

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.

Files : les fichiers dans le dossier spcifi.

Directories : les sous-dossiers dans le dossier spcifi.

Both : Les fichiers et les sous-dossiers dans le dossier spcifi.


Includes subdirectories Cochez cette case pour galement itrer sur les sous-rpertoires.
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 ID : ID du fichier/dossier en cours de traitement. Cette variable est une variable Flow et retourne une
chane de caractres.

TITLE : titre du fichier/dossier en cours de traitement. Cette variable est une variable Flow et retourne
une chane de caractres.

Guide de rfrence des Composants de Talend Open Studio 523


Scnario associ

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).

LAST_MODIFIED : dernire date de modification du fichier/dossier en cours de traitement. Cette


variable est une variable Flow et retourne une chane de caractres.

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.

524 Guide de rfrence des Composants de Talend Open Studio


tGoogleDrivePut

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.

Le schma de ce composant est en lecture seule. Vous pouvez cliquer sur le


bouton [...] ct de Edit schema afin de voir le schma prdfini ayant un
champ nomm content dcrivant les donnes charger.

La liste Schema et le bouton [...] ct de Edit schema s'affichent uniquement


lorsque l'option Upload Incoming content as File est slectionne.

Guide de rfrence des Composants de Talend Open Studio 525


Gestion des fichiers avec Google Drive

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.

Ce champ s'affiche uniquement lorsque l'option Upload Local File est


slectionne.
Expose As OutputStream Slectionnez cette option pour exposer le flux de sortie de ce composant,
pouvant tre utilis par d'autres composants pour crire le contenu du fichier.
Par exemple, vous pouvez utiliser la fonctionnalit Use Output Stream du
composant tFileOutputDelimited pour alimenter un flux de sortie expos du
tGoogleDrivePut. Pour plus d'informations, consultez tFileOutputDelimited.
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 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, 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

Gestion des fichiers avec Google Drive


Ce scnario dcrit un Job chargeant deux fichiers dans un dossier vide Talend dans le rpertoire racine de Google
Drive, crant un nouveau dossier Backup dans le dossier Talend, copiant un fichier dans le dossier Backup et
affichant tous les fichiers et dossiers dans le rpertoire racine de Google Drive dans la console.

526 Guide de rfrence des Composants de Talend Open Studio


Gestion des fichiers avec Google Drive

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.

2. Un dossier vide Talend a t cr dans le rpertoire racine de Google Drive.

Guide de rfrence des Composants de Talend Open Studio 527


Gestion des fichiers avec Google Drive

Ajouter et relier les composants


1. Crez un nouveau Job et ajoutez les composants suivants en saisissant leur nom dans l'espace de modlisation
graphique ou en les dposant depuis la Palette :

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.

4. Reliez le tGoogleDriveList au tIterateToFlow l'aide d'une connexion Row > Iterate.

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.

Configurer les composants


Ouvrir une connexion Google Drive
1. Double-cliquez sur le tGoogleDriveConnection pour ouvrir sa vue Basic settings.

528 Guide de rfrence des Composants de Talend Open Studio


Gestion des fichiers avec Google Drive

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.

Charger des fichiers dans Google Drive

1. Double-cliquez sur le premier tGoogleDrivePut pour ouvrir sa vue Basic settings.

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.

6. Double-cliquez sur le second tGoogleDrivePut pour ouvrir sa vue Basic settings.

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.

Crer un nouveau dossier dans Google Drive

1. Double-cliquez sur le tGoogleDriveCreate pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 529


Gestion des fichiers avec Google Drive

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.

6. Double-cliquez sur le premier tLogRow pour ouvrir sa vue Basic settings.

7. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un affichage optimal des
rsultats.

Copier un fichier dans le nouveau dossier

1. Double-cliquez sur le tGoogleDriveCopy pour ouvrir sa vue Basic settings.

530 Guide de rfrence des Composants de Talend Open Studio


Gestion des fichiers avec Google Drive

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.

7. Double-cliquez sur le second tLogRow pour ouvrir sa vue Basic settings.

8. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un affichage optimal des
rsultats.

Guide de rfrence des Composants de Talend Open Studio 531


Gestion des fichiers avec Google Drive

Lister les fichiers et dossiers dans Google Drive


1. Double-cliquez sur le tGoogleDriveList pour ouvrir sa vue Basic settings.

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.

5. Double-cliquez sur le tIterateToFlow pour ouvrir sa vue Basic settings.

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.

532 Guide de rfrence des Composants de Talend Open Studio


Gestion des fichiers avec Google Drive

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 :

((String)globalMap.get("tGoogleDriveList_1_ID")) pour la colonne ID,

((String)globalMap.get("tGoogleDriveList_1_TITLE")) pour la colonne Title,

((String)globalMap.get("tGoogleDriveList_1_MIME_TYPE")) pour la colonne MimeType et

((Long)globalMap.get("tGoogleDriveList_1_SIZE")) pour la colonne Size.

8. Double-cliquez sur le troisime tLogRow pour ouvrir sa vue Basic settings.

9. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un affichage optimal des
rsultats.

Sauvegarder et excuter le Job


1. Appuyez sur les touches Ctrl+S pour sauvegarder le Job.

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.

Guide de rfrence des Composants de Talend Open Studio 533


Gestion des fichiers avec Google Drive

534 Guide de rfrence des Composants de Talend Open Studio


tGSBucketCreate

tGSBucketCreate

Le composant tGSBucketCreate appartient deux familles : Big Data et Cloud. Pour plus d'informations,
consultez tGSBucketCreate.

Guide de rfrence des Composants de Talend Open Studio 535


tGSBucketDelete

tGSBucketDelete

Le composant tGSBucketDelete appartient deux familles : Big Data et Cloud. Pour plus d'informations,
consultez tGSBucketDelete.

536 Guide de rfrence des Composants de Talend Open Studio


tGSBucketExist

tGSBucketExist

Le composant tGSBucketExist appartient deux familles : Big Data et Cloud. Pour plus d'informations, consultez
tGSBucketExist.

Guide de rfrence des Composants de Talend Open Studio 537


tGSBucketList

tGSBucketList

Le composant tGSBucketList appartient deux familles : Big Data et Cloud. Pour plus d'informations, consultez
tGSBucketList.

538 Guide de rfrence des Composants de Talend Open Studio


tGSClose

tGSClose

Le composant tGSClose appartient deux familles : Big Data et Cloud. Pour plus d'informations, consultez
tGSClose.

Guide de rfrence des Composants de Talend Open Studio 539


tGSConnection

tGSConnection

Le composant tGSConnection appartient deux familles : Big Data et Cloud. Pour plus d'informations, consultez
tGSConnection.

540 Guide de rfrence des Composants de Talend Open Studio


tGSCopy

tGSCopy

Le composant tGSCopy appartient deux familles : Big Data et Cloud. Pour plus d'informations, consultez
tGSCopy.

Guide de rfrence des Composants de Talend Open Studio 541


tGSDelete

tGSDelete

Le composant tGSDelete appartient deux familles : Big Data et Cloud. Pour plus d'informations, consultez
tGSDelete.

542 Guide de rfrence des Composants de Talend Open Studio


tGSGet

tGSGet

Le composant tGSGet appartient deux familles diffrentes : Big Data et Cloud. Pour plus d'informations,
consultez tGSGet.

Guide de rfrence des Composants de Talend Open Studio 543


tGSList

tGSList

Le composant tGSList appartient deux familles diffrentes : Big Data et Cloud. Pour plus d'informations,
consultez tGSList.

544 Guide de rfrence des Composants de Talend Open Studio


tGSPut

tGSPut

Le composant tGSPut appartient deux familles diffrentes : Big Data et Cloud. Pour plus d'informations,
consultez tGSPut.

Guide de rfrence des Composants de Talend Open Studio 545


tMarketoInput

tMarketoInput

Le composant tMarketoInput appartient deux familles diffrentes : Business et Cloud. Pour plus d'informations,
consultez tMarketoInput.

546 Guide de rfrence des Composants de Talend Open Studio


tMarketoListOperation

tMarketoListOperation

Le composant tMarketoListOperation appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tMarketoListOperation.

Guide de rfrence des Composants de Talend Open Studio 547


tMarketoOutput

tMarketoOutput

Le composant tMarketoOutput appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tMarketoOutput.

548 Guide de rfrence des Composants de Talend Open Studio


tNetsuiteInput

tNetsuiteInput

Le composant tNetsuiteInput appartient deux familles diffrentes : Business et Cloud. Pour plus d'informations
concernant ce composant, tNetsuiteInput.

Guide de rfrence des Composants de Talend Open Studio 549


tNetsuiteOutput

tNetsuiteOutput

Le composant tNetsuiteOutput appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations concernant ce composant, consultez tNetsuiteOutput.

550 Guide de rfrence des Composants de Talend Open Studio


tS3BucketCreate

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.
Region Spcifiez la zone gographique AWS en slectionnant le nom d'une
zone gographique dans la liste ou en saisissant le nom de la zone
entre guillemets doubles ("us-east-1" par exemple) dans la liste. Pour
plus d'informations sur les zones gographiques AWS, consultez
Regions and Endpoints (en anglais).
Bucket Nom du bucket crer.
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.

Client parameter : slectionnez les paramtres client dans la liste.

Value : saisissez la valeur des paramtres.

Cette option n'est pas disponible lorsque la case Use existing


connection est coche.
tStatCatcher Statistics Cochez cette case afin de 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.

Guide de rfrence des Composants de Talend Open Studio 551


Scnario associ

Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez 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 .

552 Guide de rfrence des Composants de Talend Open Studio


tS3BucketDelete

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.
Region Spcifiez la zone gographique AWS en slectionnant le nom d'une
zone gographique dans la liste ou en saisissant le nom de la zone
entre guillemets doubles ("us-east-1" par exemple) dans la liste. Pour
plus d'informations sur les zones gographiques AWS, consultez
Regions and Endpoints (en anglais).
Bucket Nom du bucket supprimer.
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.

Client parameter : slectionnez les paramtres client dans la liste.

Value : saisissez la valeur des paramtres.

Cette option n'est pas disponible lorsque la case Use existing


connection est coche.
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.

Guide de rfrence des Composants de Talend Open Studio 553


Scnario associ

Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez 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 .

554 Guide de rfrence des Composants de Talend Open Studio


tS3BucketExist

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.
Region Spcifiez la zone gographique AWS en slectionnant le nom d'une
zone gographique dans la liste ou en saisissant le nom de la zone
entre guillemets doubles ("us-east-1" par exemple) dans la liste. Pour
plus d'informations sur les zones gographiques AWS, consultez
Regions and Endpoints (en anglais).
Bucket Nom du bucket sur le serveur S3.
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.

Client parameter : slectionnez les paramtres client dans la liste.

Value : saisissez la valeur des paramtres.

Cette option n'est pas disponible lorsque la case Use existing


connection est coche.
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 BUCKET_EXIST : prsence ou non d'un bucket spcifi. Cette variable est une variable Flow
et retourne un boolen.

Guide de rfrence des Composants de Talend Open Studio 555


Scnario : Vrifier l'absence d'un bucket, le crer et lister tous les buckets S3

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.

Scnario : Vrifier l'absence d'un bucket, le crer et


lister tous les buckets S3
Dans ce scnario, le tS3BucketExist est utilis pour vrifier l'absence d'un bucket. Le composant
tS3BucketCreate est utilis pour crer ce bucket aprs confirmation de l'absence du bucket. Le tS3BucketList
permet de lister tous les buckets dans Amazon S3.

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. Reliez le tS3Connection au tS3BucketExist l'aide d'un lien OnSubjobOk.

3. Reliez le tS3BucketExist au tS3BucketCreate l'aide d'un lien Run if.

4. Reliez le tS3BucketCreate au tS3BucketList l'aide d'un lien OnSubjobOk.

5. Reliez le tS3BucketList au tIterateToFlow l'aide d'un lien Row > Iterate.

6. Reliez le tIterateToFlow au tLogRow l'aide d'un lien Row > Main.

556 Guide de rfrence des Composants de Talend Open Studio


Scnario : Vrifier l'absence d'un bucket, le crer et lister tous les buckets S3

Configurer les composants


1. Double-cliquez sur le tS3Connection pour ouvrir sa vue Basic settings.

2. Dans les champ Access Key et Secret Key, saisissez vos informations d'authentification.

3. Double-cliquez sur le composant tS3BucketExist pour ouvrir sa vue Basic settings.

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.

6. Double-cliquez sur le lien If afin de configurer sa condition.

7. Dans le champ Condition, saisissez l'expression :

Guide de rfrence des Composants de Talend Open Studio 557


Scnario : Vrifier l'absence d'un bucket, le crer et lister tous les buckets S3

!((Boolean)globalMap.get("tS3BucketExist_1_BUCKET_EXIST"))

Ainsi, le reste du Job est excut si le bucket spcifi n'existe pas.

8. Double-cliquez sur le tS3BucketCreate pour ouvrir sa vue Basic settings.

Cochez la case Use existing connection afin de rutiliser la connexion.

Dans le champ Bucket, saisissez le nom du bucket crer.

9. Double-cliquez sur le tS3BucketList pour ouvrir sa vue Basic settings.

Cochez la case Use existing connection pour rutiliser la connexion.

10. Double-cliquez sur le tIterateToFlow pour ouvrir sa vue Basic settings.

11. Cliquez sur le bouton Edit schema pour ouvrir l'diteur de schma.

558 Guide de rfrence des Composants de Talend Open Studio


Scnario : Vrifier l'absence d'un bucket, le crer et lister tous les buckets S3

Cliquez sur le bouton [+] pour ajouter une colonne. Nommez-la bucket_list et dfinissez son type String.

Cliquez sur OK pour valider la configuration et fermer l'diteur.

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.

13. Double-cliquez sur le tLogRow 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 le Job.

2. Appuyez sur F6 pour excuter le Job.

Comme affich ci-dessus, le bucket est cr et tous les buckets sont lists.

Guide de rfrence des Composants de Talend Open Studio 559


Scnario : Vrifier l'absence d'un bucket, le crer et lister tous les buckets S3

3. Allez dans la console Web S3 :

Vous pouvez constater que le bucket a bien t cr sur le serveur S3.

4. Rafrachissez le client S3 Browser :

La capture d'cran ci-dessus vous montre que l'action S3 Create s'est droule avec succs.

560 Guide de rfrence des Composants de Talend Open Studio


tS3BucketList

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.
Region Spcifiez la zone gographique AWS en slectionnant le nom d'une
zone gographique dans la liste ou en saisissant le nom de la zone
entre guillemets doubles ("us-east-1" par exemple) dans la liste. Pour
plus d'informations sur les zones gographiques AWS, consultez
Regions and Endpoints (en anglais).
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.

Client parameter : slectionnez les paramtres client dans la liste.

Value : saisissez la valeur des paramtres.

Cette option n'est pas disponible lorsque la case Use existing


connection est coche.
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 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.

Guide de rfrence des Composants de Talend Open Studio 561


Scnario associ

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 .

562 Guide de rfrence des Composants de Talend Open Studio


tS3Close

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.

Guide de rfrence des Composants de Talend Open Studio 563


Scnario associ

Scnario associ
Pour un scnario associ au tS3Close, consultez Scnario : Lister les fichiers d'un bucket ayant le mme prfixe.

564 Guide de rfrence des Composants de Talend Open Studio


tS3Connection

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.
Region Spcifiez la zone gographique AWS en slectionnant le nom d'une
zone gographique dans la liste ou en saisissant le nom de la zone
entre guillemets doubles ("us-east-1" par exemple) dans la liste. Pour
plus d'informations sur les zones gographiques AWS, consultez
Regions and Endpoints (en anglais).
Advanced settings Config client Cochez cette case pour configurer des paramtres client.

Client parameter : slectionnez les paramtres client dans la liste.

Value : saisissez la valeur des paramtres.


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.

Guide de rfrence des Composants de Talend Open Studio 565


Scnario associ

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 .

566 Guide de rfrence des Composants de Talend Open Studio


tS3Delete

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.
Region Spcifiez la zone gographique AWS en slectionnant le nom d'une
zone gographique dans la liste ou en saisissant le nom de la zone
entre guillemets doubles ("us-east-1" par exemple) dans la liste. Pour
plus d'informations sur les zones gographiques AWS, consultez
Regions and Endpoints (en anglais).
Bucket Nom du bucket dans Amazon S3.
Key Nom du fichier supprimer.
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.

Client parameter : slectionnez les paramtres client dans la liste.

Value : saisissez la valeur des paramtres.

Cette option n'est pas disponible lorsque la case Use existing


connection est coche.
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.

Guide de rfrence des Composants de Talend Open Studio 567


Scnario associ

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 .

568 Guide de rfrence des Composants de Talend Open Studio


tS3Get

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.
Region Spcifiez la zone gographique AWS en slectionnant le nom d'une
zone gographique dans la liste ou en saisissant le nom de la zone
entre guillemets doubles ("us-east-1" par exemple) dans la liste. Pour
plus d'informations sur les zones gographiques AWS, consultez
Regions and Endpoints (en anglais).
Bucket Nom du bucket du serveur S3.
Key Nom du fichier sauvegarder sur le serveur S3.
File Nom du fichier local charger sur le serveur S3.
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.

Client parameter : slectionnez les paramtres client dans la liste.

Value : saisissez la valeur des paramtres.

Cette option n'est pas disponible lorsque la case Use existing


connection est coche.
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.

Guide de rfrence des Composants de Talend Open Studio 569


Scnario associ

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 .

570 Guide de rfrence des Composants de Talend Open Studio


tS3List

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.
Region Spcifiez la zone gographique AWS en slectionnant le nom d'une
zone gographique dans la liste ou en saisissant le nom de la zone
entre guillemets doubles ("us-east-1" par exemple) dans la liste. Pour
plus d'informations sur les zones gographiques AWS, consultez
Regions and Endpoints (en anglais).
List all bucket objects Cochez cette case pour lister tous les fichiers sur le serveur 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.

Bucket name : nom du bucket duquel lister les fichiers.

Key prefix : prfixe des fichiers lister.

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.

Client parameter : slectionnez les paramtres client dans la liste.

Value : saisissez la valeur des paramtres.

Cette option n'est pas disponible lorsque la case Use existing


connection est coche.
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

Guide de rfrence des Composants de Talend Open Studio 571


Scnario : Lister les fichiers d'un bucket ayant le mme prfixe

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.

Scnario : Lister les fichiers d'un bucket ayant le


mme prfixe
Dans ce scnario, le tS3List est utilis pour lister tous les fichiers d'un bucket ayant le mme prfixe.

Voici les fichiers du bucket :

572 Guide de rfrence des Composants de Talend Open Studio


Scnario : Lister les fichiers d'un bucket ayant le mme prfixe

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. Reliez le tS3Connection au tS3List l'aide d'un lien OnSubjobOk.

3. Reliez le tS3List au tIterateToFlow l'aide d'un lien Row > Iterate.

4. Reliez le tIterateToFlow au tLogRow l'aide d'un lien Row > Main.

5. Reliez le tS3List au tS3Close l'aide d'un lien OnSubjobOk.

Configurer les composants


1. Double-cliquez sur le tS3Connection pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 573


Scnario : Lister les fichiers d'un bucket ayant le mme prfixe

2. Dans les champs Access Key et Secret Key, saisissez les informations d'authentification.

3. Double-cliquez sur le tS3List pour ouvrir sa vue Basic settings.

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.

Ainsi, seuls les fichiers ayant le prfixe spcifi seront lists.

7. Double-cliquez sur le tIterateToFlow pour ouvrir sa vue Basic settings.

8. Cliquez sur Edit schema pour ouvrir l'diteur du schma.

574 Guide de rfrence des Composants de Talend Open Studio


Scnario : Lister les fichiers d'un bucket ayant le mme prfixe

Cliquez sur le bouton [+] pour ajouter une colonne. Nommez-la file_list et dfinissez son type String.

Cliquez sur OK pour valider la configuration et fermer l'diteur.

9. Dans la table Mapping, appuyez sur les touches Ctrl+Espace dans la colonne Value afin de slectionner
la variable tS3List_1_CURRENT_KEY.

10. Double-cliquez sur le tLogRow pour ouvrir sa vue Basic settings.

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.

2. Appuyez sur la touche F6 pour excuter le Job.

Guide de rfrence des Composants de Talend Open Studio 575


Scnario : Lister les fichiers d'un bucket ayant le mme prfixe

Comme affich ci-dessus, seuls les fichiers ayant le prfixe "in" sont lists.

576 Guide de rfrence des Composants de Talend Open Studio


tS3Put

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ


Secret key, 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.
Region Spcifiez la zone gographique AWS en slectionnant le nom d'une
zone gographique dans la liste ou en saisissant le nom de la zone
entre guillemets doubles ("us-east-1" par exemple) dans la liste. Pour
plus d'informations sur les zones gographiques AWS, consultez
Regions and Endpoints (en anglais).
Bucket Nom du bucket du serveur S3.
Key Nom du fichier sauvegarder sur le serveur S3.
File Nom du fichier local charger sur le serveur S3.
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.

Client parameter : slectionnez les paramtres client dans la liste.

Value : saisissez la valeur des paramtres.

Cette option n'est pas disponible lorsque la case Use existing


connection est coche.
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.

Guide de rfrence des Composants de Talend Open Studio 577


Scnario : Echange de fichiers avec Amazon S3

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.

Scnario : Echange de fichiers avec Amazon S3


Dans ce scnario, le composant tS3Put est utilis pour envoyer un fichier sur le serveur Amazon S3 pendant que
le tS3Get rcupre ce fichier.

Construire le Job
1. Dposez un tS3Connection, un tS3Put et un tS3Get de la Palette dans l'espace de modlisation graphique.

2. Reliez le tS3Connection au tS3Put l'aide d'un lien OnSubjobOk.

3. Reliez le tS3Put au tS3Get l'aide d'un lien OnSubjobOk.

578 Guide de rfrence des Composants de Talend Open Studio


Scnario : Echange de fichiers avec Amazon S3

Configurer les composants


1. Double-cliquez sur le tS3Connection pour ouvrir sa vue Basic settings.

2. Dans les champs Access Key et Secret Key, saisissez les informations d'authentification.

3. Double-cliquez sur le tS3Put pour ouvrir sa vue Basic settings.

4. Cochez la case Use existing connection pour rutiliser la connexion.

5. Dans le champ Bucket, saisissez le nom du bucket.

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.

8. Double-cliquez sur le composant tS3Get pour ouvrir sa vue Basic settings.

9. Cochez la case Use existing connection pour rutiliser la connexion.

10. Dans le champ Bucket, saisissez le nom du bucket.

11. Dans le champ Key, saisissez le nom du fichier rcuprer du serveur S3.

12. Dans le champ File, saisissez le nom local du fichier rcupr.

Excuter le Job
1. Appuyez sur les touches Ctrl + S pour sauvegarder le Job.

Guide de rfrence des Composants de Talend Open Studio 579


Scnario : Echange de fichiers avec Amazon S3

2. Appuyez sur F6 pour excuter le Job.

3. Consultez la console Web S3 :

Comme affich ci-dessus, le fichier a bien t mis sur le serveur S3.

4. Rafrachissez le client S3 Browser :

Comme affich ci-dessus, cela montre galement l'action russie du composant S3 Put.

5. Allez dans le dossier o est sauvegard localement le fichier rcupr :

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.

580 Guide de rfrence des Composants de Talend Open Studio


tSalesforceBulkExec

tSalesforceBulkExec

Le composant tSalesforceBulkExec appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceBulkExec.

Guide de rfrence des Composants de Talend Open Studio 581


tSalesforceConnection

tSalesforceConnection

Le composant tSalesforceConnection appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceConnection.

582 Guide de rfrence des Composants de Talend Open Studio


tSalesforceGetDeleted

tSalesforceGetDeleted

Le composant tSalesforceGetDeleted appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceGetDeleted.

Guide de rfrence des Composants de Talend Open Studio 583


tSalesforceGetServerTimestamp

tSalesforceGetServerTimestamp

Le composant tSalesforceGetServerTimestamp appartient deux familles diffrentes : Business et Cloud. Pour


plus d'informations, consultez tSalesforceGetServerTimestamp.

584 Guide de rfrence des Composants de Talend Open Studio


tSalesforceGetUpdated

tSalesforceGetUpdated

Le composant tSalesforceGetUpdated appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceGetUpdated.

Guide de rfrence des Composants de Talend Open Studio 585


tSalesforceInput

tSalesforceInput

Le composant tSalesforceInput appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceInput.

586 Guide de rfrence des Composants de Talend Open Studio


tSalesforceOutput

tSalesforceOutput

Le composant tSalesforceOutput appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceOutput.

Guide de rfrence des Composants de Talend Open Studio 587


tSalesforceOutputBulk

tSalesforceOutputBulk

Le composant tSalesforceOutputBulk appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceOutputBulk.

588 Guide de rfrence des Composants de Talend Open Studio


tSalesforceOutputBulkExec

tSalesforceOutputBulkExec

Le composant tSalesforceOutputBulkExec appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSalesforceOutputBulkExec.

Guide de rfrence des Composants de Talend Open Studio 589


tSalesforceWaveBulkExec

tSalesforceWaveBulkExec

Le SalesforceWaveBulkExec appartient deux familles : Business et Cloud. Pour plus d'informations, consultez
tSalesforceWaveBulkExec.

590 Guide de rfrence des Composants de Talend Open Studio


tSalesforceWaveOutputBulkExec

tSalesforceWaveOutputBulkExec

Le tSalesforceWaveOutputBulkExec appartient deux familles : Business et Cloud. Pour plus d'informations,


consultez tSalesforceWaveOutputBulkExec.

Guide de rfrence des Composants de Talend Open Studio 591


tSugarCRMInput

tSugarCRMInput

Le composant tSugarCRMInput appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSugarCRMInput.

592 Guide de rfrence des Composants de Talend Open Studio


tSugarCRMOutput

tSugarCRMOutput

Le composant tSugarCRMOutput appartient deux familles diffrentes : Business et Cloud. Pour plus
d'informations, consultez tSugarCRMOutput.

Guide de rfrence des Composants de Talend Open Studio 593


Guide de rfrence des Composants de Talend Open Studio
Composants Custom Code
Ce chapitre passe en revue les principaux composants prsents dans la famille Custom Code de la Palette dans
la perspective Integration du Studio Talend.

La famille Custom Code regroupe tous les composants rpondant un besoin spcifique de cration de code
la vole.

Guide de rfrence des Composants de Talend Open Studio


tGroovy

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 :

Name : nom de la variable appele dans le code.

Value : valeur associe cette variable.


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.
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.

596 Guide de rfrence des Composants de Talend Open Studio


tGroovyFile

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 :

Name : nom de la variable appele dans le code.

Value : valeur associe cette variable.


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.
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.

Scnario : Appeler du code Groovy contenu dans un


fichier
Ce scnario utilise un composant tGroovyFile en standalone. Le Job appelle un fichier contenant du code Groovy
afin d'afficher les informations de ce fichier dans la Console.

Guide de rfrence des Composants de Talend Open Studio 597


Scnario : Appeler du code Groovy contenu dans un fichier

Construire le Job
Dveloppez le dossier Custom_Code de la Palette et dposez un composant tGroovyFile dans l'espace de
modlisation graphique.

Configurer le composant tGroovyFile


1. Double-cliquez sur le composant pour ouvrir sa vue Component.

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 :

println("The captain is " + age + " years old")

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.

598 Guide de rfrence des Composants de Talend Open Studio


tJava

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.

Pour la rfrence Java complte, consultez http://docs.oracle.com/


javaee/6/api/ (en anglais).
Advanced settings Import Saisissez le code Java permettant d'importer, si ncessaire, la
librairie externe utilise dans le champ Main code de l'onglet
Basic 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.
Utilisation Ce composant est gnralement utilis en tant que sous-job un seul composant.
Limitation Il est ncessaire de connatre le langage Java.

Scnario : Imprimer le contenu d'une variable


Le scnario suivant est une simple dmonstration de l'application possible du composant tJava. L'objectif de ce
Job est d'imprimer les lignes traites l'aide d'une commande Java et des variables globales fournies dans le Studio
Talend.

Guide de rfrence des Composants de Talend Open Studio 599


Scnario : Imprimer le contenu d'une variable

Construire le Job
1. Cliquez et dposez les composants dans l'espace de modlisation : tFileInputDelimited, tFileOutputExcel,
tJava.

2. Connectez le composant tFileInputDelimited au tFileOutputExcel l'aide d'une connexion de type Row


Main. Le contenu du fichier .txt dlimit sera transmis un fichier de type XSL via cette connexion sans
subir de transformation.

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.

Configurer le composant d'entre


1. Dfinissez les paramtres du composant tFileInputDelimited dans l'onglet Basic settings de la vue
Component. Le fichier d'entre utilis en exemple est un simple fichier texte deux colonnes : Name (des
noms de personnes) et leur Emails respectifs.

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.

3. Cliquez sur le bouton Edit Schema.

600 Guide de rfrence des Composants de Talend Open Studio


Scnario : Imprimer le contenu d'une variable

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.

Configurer le composant de sortie


Paramtrez le fichier de sortie afin qu'il reoive le contenu du fichier d'entre sans modifications. Si le fichier
n'existe pas dj, il sera cr.

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.

Configurer le composant tJava


1. Slectionnez le composant tJava pour dfinir la commande Java excuter.

Guide de rfrence des Composants de Talend Open Studio 601


Scnario : Imprimer le contenu d'une variable

2. Dans la zone Code, saisissez la commande suivante :

String var = "Nb of line processed: ";


var = var + globalMap.get("tFileInputDelimited_1_NB_LINE");
System.out.println(var);

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.

2. Appuyez sur F6 pour l'excuter.

Le contenu est donc transmis au fichier Excel spcifi et le nombre de lignes traites est affich dans la console
Run.

602 Guide de rfrence des Composants de Talend Open Studio


tJavaFlex

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.

Depuis la version 5.6, les modes Built-in et Repository sont


disponibles dans n'importe quelle solution de Talend.

Cliquez sur Sync columns pour rcuprer le schma du composant


prcdent.
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 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.

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma
est en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].
Data Auto Propagate Cochez cette case pour propager automatiquement les donnes au
composant suivant.
Start code Saisissez le code Java qui va tre appel lors de la phase
d'initialisation.
Main code Saisissez le code Java qui va tre appliqu pour chaque ligne du
flux.
End code Saisissez le code Java qui va tre appel lors de la phase de clture.

Guide de rfrence des Composants de Talend Open Studio 603


Scnario 1 : Gnrer un flux de donnes

Advanced settings Import Saisissez le code Java permettant d'importer, si ncessaire, la


librairie externe utilise dans le champ Main code de l'onglet
Basic 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.
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.

Scnario 1 : Gnrer un flux de donnes


Ce scnario dcrit un Job deux composants dont le but est de gnrer un flux de trois lignes dcrivant les
diffrentes civilit : mademoiselle (Miss), madame (Mrs) et monsieur (Mr), et de les afficher dans la console.

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. Connectez-les via un lien Row Main.

Configurer le composant tJavaFlex


1. Double-cliquez sur le composant tJavaFlex pour paramtrer ses proprits.

604 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Gnrer un flux de donnes

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.

4. Cliquez OK pour valider les changements et fermer la bote de dialogue.

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"};

for (int i=0;i<valueArray.length;i++) {

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];

Guide de rfrence des Composants de Talend Open Studio 605


Scnario 1 : Gnrer un flux de donnes

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");

9. Si ncessaire, assurez-vous que le schma a bien t propag au tLogRow en double-cliquant sur le


composant et en cliquant sur le bouton [...] ct de Edit schema.

Sauvegarder et excuter le Job


1. Enregistrez le Job en appuyant sur Ctrl+S.

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.

606 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Traiter des lignes de donnes avec le tJavaFlex

Scnario 2 : Traiter des lignes de donnes avec le


tJavaFlex
Ce scnario dcrit un Job deux composants gnrant des donnes de manire alatoire, rcuprant et traitant ces
donnes ligne par ligne avec du code Java via le tJavaFlex.

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. Connectez-les via un lien Row > Main.

Configurer le composant d'entre


1. Double-cliquez sur le composant tRowGenerator pour ouvrir son diteur.

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.

Guide de rfrence des Composants de Talend Open Studio 607


Scnario 2 : Traiter des lignes de donnes avec le tJavaFlex

6. Cliquez sur OK pour valider vos changements et fermer l'diteur.

Configurer le composant tJavaFlex


1. Double-cliquez sur le composant tJavaFlex pour paramtrer ses proprits.

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 :

System.out.print(" row" + i + ":");


System.out.print("# number:" + row1.number);
System.out.print (" | txt:" + row1.txt.toUpperCase());
System.out.print(" | date:" + row1.date);
if(row1.flag) System.out.println(" | flag: true");
else System.out.println(" | flag: false");

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.

608 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Traiter des lignes de donnes avec le tJavaFlex

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");

Sauvegarder et excuter le Job


1. Enregistrez votre Job en appuyant sur Ctrl+S.

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.

Guide de rfrence des Composants de Talend Open Studio 609


tJavaRow

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.

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 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.

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma
est en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma du


composant prcdent.
Code Saisissez le code Java qui va tre appliqu pour chaque ligne du
flux.
Advanced settings Import Saisissez le code Java permettant d'importer, si ncessaire, la
librairie externe utilise dans le champ Main code de l'onglet
Basic 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.

610 Guide de rfrence des Composants de Talend Open Studio


Scnario : Transformer des donnes ligne par ligne avec un tJavaRow

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.

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.

Scnario : Transformer des donnes ligne par ligne


avec un tJavaRow
Dans ce scnario, les informations de quelques villes sont lues depuis un fichier d'entre dlimit et sont
transformes l'aide de code Java via le composant tJavaRow, puis affiches dans la console.

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.

Configurer les composants


1. Double-cliquez sur le tFileInputDelimited pour afficher sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 611


Scnario : Transformer des donnes ligne par ligne avec un tJavaRow

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.

Dans cet exemple, le fichier d'entre contient :

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.

4. Double-cliquez sur le composant tJavaRow afin d'afficher sa vue Basic settings.

612 Guide de rfrence des Composants de Talend Open Studio


Scnario : Transformer des donnes ligne par ligne avec un tJavaRow

5. Cliquez sur Sync columns afin de vous assurer que le schma est bien rcupr du composant prcdent.

6. Dans le champ Code, saisissez le code appliquer chaque ligne de donnes.

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 :

System.out.print("\n" + input_row.City.toUpperCase() + ":");


System.out.print("\n - Population: "
+ FormatterUtils.format_Number(String.valueOf(input_row.Population), ',', '.') + "
people");
System.out.print("\n - Land area: "
+ FormatterUtils.format_Number(String.valueOf(input_row.LandArea), ',', '.')
+ " km2");
System.out.print("\n - Population density: "
+ FormatterUtils.format_Number(String.valueOf(input_row.PopDensity), ',', '.') + "
people/km2\n");

Dans le champ Code, input_row fait rfrence la connexion vers le tJavaRow.

Sauvegarder et 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 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.

Guide de rfrence des Composants de Talend Open Studio 613


Scnario : Transformer des donnes ligne par ligne avec un tJavaRow

614 Guide de rfrence des Composants de Talend Open Studio


tLibraryLoad

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).

Guide de rfrence des Composants de Talend Open Studio 615


Scnario : Vrifier le format d'une adresse e-mail

Scnario : Vrifier le format d'une adresse e-mail


Ce scnario comprend deux composants, un tLibraryLoad et un tJava. Le but de ce scnario est de vrifier le
format d'une adresse e-mail et de retourner si elle est valide ou non.

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. Reliez le tLibraryLoad au tJava l'aide d'un lien Trigger > OnSubjobOk.

Configurer le composant tLibraryLoad


1. Double-cliquez sur le tLibraryLoad pour afficher sa vue Basic settings. Dans la liste Library, slectionnez
jakarta-oro-2.0.8.jar.

2. Dans le champ Import de l'onglet Advanced settings, saisissez import org.apache.oro.text.regex.*;

616 Guide de rfrence des Composants de Talend Open Studio


Scnario : Vrifier le format d'une adresse e-mail

Configurer le composant tJava


1. Double-cliquez sur le composant tJava pour afficher sa vue Component.

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.

Guide de rfrence des Composants de Talend Open Studio 617


tSetGlobalVar

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.

Key : Nom de la variable appeler dans le code.

Value : la valeur assigne cette variable.


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 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.

Scnario : Afficher le contenu d'une variable globale


Ce scnario se compose d'un Job simple affichant la valeur d'une variable globale dfinie dans le composant
tSetGlobalVar.

618 Guide de rfrence des Composants de Talend Open Studio


Scnario : Afficher le contenu d'une variable globale

Construire le Job
1. Dposez les composants suivants de la Palette dans l'espace de modlisation graphique : tSetGlobalVar et
tJava.

2. Reliez le tSetGlobalVar au tJava l'aide d'un lien Trigger > OnSubjobOk.

Configurer le composant tSetGlobalVar


1. Double-cliquez sur le composant tSetGlobalVar afin d'afficher sa vue Basic settings.

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.

4. Dans la zone Code, saisissez le code suivant :

String foo = "bar";


String K1;
String Result = "The value is:";
Result = Result + globalMap.get("K1");
System.out.println(Result);

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.

Guide de rfrence des Composants de Talend Open Studio 619


Scnario : Afficher le contenu d'une variable globale

Le contenu de la variable globale K1 s'affiche dans la console.

620 Guide de rfrence des Composants de Talend Open Studio


Composants Data Quality
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille Data Quality de la
Palette dans la perspective Integration du Studio Talend.

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.

Guide de rfrence des Composants de Talend Open Studio


tAddCRCRow

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

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 rutilisable dans divers projets et Job
designs. Voir galement le Guide utilisateur du Studio Talend.
Implication Cochez la case correspondant aux colonnes dfinir comme cl de
substitution et vrifier l'intgrit de leurs donnes.
Advanced settings CRC type Slectionnez la longueur CRC. Plus le CRC est long, moins il y
aura de risque d'erreur.
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de process
du Job, aussi bien au niveau du Job 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 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.

622 Guide de rfrence des Composants de Talend Open Studio


Scnario : Ajouter une cl de substitution un fichier

Scnario : Ajouter une cl de substitution un fichier


Ce scnario dcrit un Job ajoutant une cl de substitution un schma de fichier dlimit.

Construire le Job
1. Glissez les composants suivants dans l'espace de modlisation : tFileInputDelimited, tAddCRCRow et
tLogRow.

2. Connectez-les en utilisant un lien de type Main row.

Configurer le composant d'entre


1. Dans la vue Component du tFileInputDelimited, renseignez le champ File Name en saisissant le chemin
d'accs votre fichier, ainsi que toutes les proprits en rapport, au cas o elles ne soient pas stockes dans
le Repository.

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).

Configurer le composant tAddCRCRow


1. Dans la vue Component du composant tAddCRCRow, slectionnez les cases de la colonne du flux entrant
utiliser pour calculer le CRC.

Guide de rfrence des Composants de Talend Open Studio 623


Scnario : Ajouter une cl de substitution un fichier

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).

624 Guide de rfrence des Composants de Talend Open Studio


tChangeFileEncoding

tChangeFileEncoding

Le tChangeFileEncoding appartient deux familles : Data Quality et File. Pour plus d'informations concernant
le composant tChangeFileEncoding, consultez tChangeFileEncoding.

Guide de rfrence des Composants de Talend Open Studio 625


tExtractRegexFields

tExtractRegexFields

Le tExtractRegexFields appartient deux familles : Data Quality et Processing. Pour plus d'informations
concernant le composant tExtractRegexFields, consultez tExtractRegexFields.

626 Guide de rfrence des Composants de Talend Open Studio


tFuzzyMatch

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.

Deux colonnes en lecture seule sont ajoutes automatiquement au


schma de sortie : Value et Match.

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 rutilisable dans divers projets et Job
designs. Voir galement le Guide utilisateur du Studio Talend.
Matching type Slectionnez l'algorithme de correspondance appropri parmi les
suivants :

Levenshtein : Bas sur la thorie de la distance d'dition. Il calcule


le nombre d'insertion, de suppression ou de substitution ncessaire
pour correspondre la rfrence.

Metaphone : Bas sur la phontique. Tout d'abord, il charge les


sonorits de toutes les entres du flux de rfrence (Lookup) et les
compare avec celles des entres du flux principal (Main).

Double Metaphone : une nouvelle version de l'algorithme


phontique Metaphone, qui produit des rsultats plus prcis que
l'algorithme original. Il peut retourner la fois un code primaire
et secondaire pour une chane de caractres. Pour viter toute
ambigut que le Metaphone n'aurait pas pu dtecter, utilisez cette
option.
Min distance (Levenshtein uniquement) Dfinissez le nombre minimum de
modifications autorises pour correspondre la rfrence. Si vous
dfinissez 0, seules les correspondances exactes sont extraites.
Max distance (Levenshtein uniquement) Dfinissez le nombre maximum de
modifications pouvant correspondre la rfrence.
Matching column Slectionnez la colonne du flux principal qui doit tre compare
avec la colonne cl du flux de rfrence (Lookup).
Unique matching Cochez cette case pour obtenir la meilleure correspondance
possible, si plusieurs correspondances sont disponibles.
Matching item separator Si plusieurs correspondances sont disponibles, elles seront toutes
affiches sauf si la case Unique match est coche. Dfinissez le
dlimiteur entre chaque correspondance.
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.

Guide de rfrence des Composants de Talend Open Studio 627


Scnario 1 : Distance de Levenshtein de 0 pour les prnoms

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 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).

Scnario 1 : Distance de Levenshtein de 0 pour les


prnoms
Ce scnario dcrit un Job constitu de quatre composants dont le but est de vrifier la distance d'dition comprise
entre les colonnes First Name (prnom) d'un fichier d'entre et de comparer les donnes avec celles du fichier
de rfrence. Le rsultat de cette vrification de la distance de Levenshtein et le contenu du flux principal sont
affichs dans une table.

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.

628 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Distance de Levenshtein de 0 pour les prnoms

Configurer les composants


1. Configurez les paramtres du premier tFileInputDelimited dans sa vue Basic settings. Parcourez votre
systme jusqu'au fichier d'entre analyser.

2. Dfinissez le schma du composant. Dans cet exemple, le schma d'entre possde deux colonnes, firstname
et gender.

3. Configurez le second tFileInputDelimited de la mme faon.

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.

Guide de rfrence des Composants de Talend Open Studio 629


Scnario 1 : Distance de Levenshtein de 0 pour les prnoms

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.

7. Dcochez la case Case sensitive pour ne pas prendre en compte la casse.

8. Vrifiez que la colonne de correspondance et la colonne de rfrence sont bien slectionnes.

9. Laissez les autres paramtres par dfaut.

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

630 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Distance de Levenshtein de 1 ou 2 pour les prnoms

Scnario 2 : Distance de Levenshtein de 1 ou 2 pour


les prnoms
Ce scnario est bas sur le scnario dcrit ci-dessus. Seuls les paramtres distance minimum et maximum du
composant tFuzzyMatch sont modifis, ce qui modifiera la sortie affiche.

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.

Aucune autre modification de paramtres n'est ncessaire.

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.

4. Enregistrez votre nouveau Job et appuyez sur F6 pour l'excuter.

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.

Guide de rfrence des Composants de Talend Open Studio 631


Scnario 3 : Distance mtaphonique pour les prnoms

Scnario 3 : Distance mtaphonique pour les prnoms


Ce scnario est bas sur un scnario dcrit plus haut.

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.

632 Guide de rfrence des Composants de Talend Open Studio


tIntervalMatch

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].
Search Column Slectionnez la colonne du flux principal contenant les valeurs qui
doivent tre mises en correspondance avec l'intervalle de valeurs.
Column (LOOKUP) Slectionnez la colonne du flux lookup contenant les valeurs qui
doivent tre retournes quand la jointure est ok.
Lookup Column (min) / Slectionnez la colonne contenant la valeur minimale de
Include the bound (min) l'intervalle. Cochez la case pour inclure la valeur maximale de
l'intervalle.
Lookup Column (max) / Slectionnez la colonne contenant la valeur maximale de
Include the bound (max) l'intervalle. Cochez la case pour inclure la valeur maximale de
l'intervalle.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de process
du Job, aussi bien au niveau du Job 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.

Guide de rfrence des Composants de Talend Open Studio 633


Scnario : Identifier l'emplacement de serveurs partir de leur IP

Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez 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).

Scnario : Identifier l'emplacement de serveurs partir


de leur IP
Ce scnario dcrit un Job quatre composants vrifiant les adresses IP de serveur, listes dans le fichier
d'entre principal, par rapport une liste d'intervalles d'IPs dans le fichier de rfrence, afin d'identifier le pays
d'hbergement de chaque serveur.

Construire le Job
1. Dans l'espace de modlisation, glissez deux composants tFileInputDelimited, un tIntervalMatch et un
tLogRow.

2. Reliez les composants l'aide de liens Row > Main.

La connexion du second tFileInputDelimited au tIntervalMatch apparat comme Lookup.

Configurer les composants


1. Double-cliquez sur le premier tFileInputDelimited pour ouvrir sa vue Component et configurer ses
proprits.

634 Guide de rfrence des Composants de Talend Open Studio


Scnario : Identifier l'emplacement de serveurs partir de leur IP

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.

5. Configurez de la mme manire les proprits du second tFileInputDelimited.

Guide de rfrence des Composants de Talend Open Studio 635


Scnario : Identifier l'emplacement de serveurs partir de leur IP

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

Le schma du flux de rfrence doit possder la structure suivante :

6. Double-cliquez sur le composant tIntervalMatch pour ouvrir sa vue Basic settings.

636 Guide de rfrence des Composants de Talend Open Studio


Scnario : Identifier l'emplacement de serveurs partir de leur IP

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.

Guide de rfrence des Composants de Talend Open Studio 637


tReplaceList

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.

Depuis la version 5.6, les modes Built-in et Repository sont


disponibles dans n'importe quelle solution de Talend.

Deux colonnes en lecture seule, Value et Match sont


automatiquement ajouts au schma de sortie.

Le type de donnes dfini dans les schmas doit tre


cohrent, c'est--dire qu'un entier ne peut tre remplac
que par un entier en utilisant un entier comme champ de
rfrence. Une valeur d'un type ne peut tre remplace
par une valeur d'un autre type.
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.
Lookup search column Slectionnez la colonne rechercher dans le schma de lookup.
Lookup replacement column Slectionnez la colonne dans laquelle les valeurs de remplacement
sont stockes.
Column options Slectionnez les colonnes du flux principal dans lequel le
remplacement est effectu.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de process
du Job, 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 un composant intermdiaire, il ncessite un composant d'entre et un
composant de sortie.

638 Guide de rfrence des Composants de Talend Open Studio


Scnario : Remplacement partir d'un fichier de rfrence

Scnario : Remplacement partir d'un fichier de


rfrence
Le Job suivant recherche et remplace une liste d'tats par le code deux lettres correspondant. Les codes
correspondants proviennent d'un fichier de rfrence plac dans le flux lookup du Job.

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.

Configurer les composants


1. Double-cliquez sur le premier tFileInputDelimited pour ouvrir sa vue Basic settings et configurer les
paramtres du flux d'entre principal, notamment le chemin d'accs au fichier lire, ainsi que le nombre de
lignes d'en-tte ignorer.

Guide de rfrence des Composants de Talend Open Studio 639


Scnario : Remplacement partir d'un fichier de rfrence

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.

3. Configurez de la mme faon les proprits du second tFileInputDelimited.

640 Guide de rfrence des Composants de Talend Open Studio


Scnario : Remplacement partir d'un fichier de rfrence

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.

Guide de rfrence des Composants de Talend Open Studio 641


Scnario : Remplacement partir d'un fichier de rfrence

Le nom des tats a t remplac par le code deux lettres correspondant.

642 Guide de rfrence des Composants de Talend Open Studio


tSchemaComplianceCheck

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.

Dfinissez la structure et la nature des donnes 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 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 rutilisable dans divers projets et Job designs. Voir
galement le Guide utilisateur du Studio Talend.
Check all columns from Cochez cette option si vous souhaitez effectuer la vrification sur toutes
schema les colonnes du schma de base.
Custom defined Cochez cette option si vous souhaitez effectuer la vrification sur des
colonnes en particulier. Lorsque cette option est coche, le tableau
Checked Columns apparat.
Checked Columns Dfinissez dans ce tableau quelles sont les vrifications effectuer, et
sur quelles colonnes.
Column : Affiche les noms des colonnes.
Type : slectionnez les proprits que les donnes doivent avoir. Cette
validation est obligatoire pour toutes les colonnes.

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.

Guide de rfrence des Composants de Talend Open Studio 643


Proprits du tSchemaComplianceCheck

Ces proprits peuvent correspondre au type de donnes, aux valeurs


nulles, et/ou la longueur des donnes.
Trim the excess content of Cochez cette case afin de tronquer les donnes dpassant la longueur
column when length checking spcifie plutt que de les rejeter. L'option fonctionne avec les trois
chosen and the length is modes du tSchemaComplianceCheck.
greater than defined length
Cette option s'applique uniquement aux donnes de type
String.
Advanced settings Use Fastest Date Check Cochez cette case afin d'effectuer une vrification rapide du format de
date en utilisant la mthode TalendDate.isDate() de la routine systme
TalendDate lorsque Date pattern (format de date) n'est pas dfini.
Pour plus d'informations concernant les routines, consultez le Guide
utilisateur du Studio Talend.
Ignore TimeZone when Check Cochez cette case pour ignorer le fuseau horaire lors de la vrification
Date de la date.

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.

Le composant ne supporte pas les donnes de type Object et List.

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.

644 Guide de rfrence des Composants de Talend Open Studio


Scnario : Valider les dates en fonction d'un schma

Scnario : Valider les dates en fonction d'un schma


Ce scnario permet de vrifier le type, la nullabilit et la longueur des donnes du flux d'entre en fonction du
schma de rfrence dfini. Il permet galement d'afficher les rsultats de validation dans la console de la vue Run.

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.

2. Cliquez-droit sur le tFileInputDelimited pour le connecter au composant tSchemaComplianceCheck via


une connexion Row Main.

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.

Configurer les composants


1. Double-cliquez sur le composant tFileInputDelimited afin d'afficher sa vue Basic settings. Configurez ses
proprits, notamment le nom du fichier d'entre et le nombre de lignes d'en-tte ignorer.

Guide de rfrence des Composants de Talend Open Studio 645


Scnario : Valider les dates en fonction d'un schma

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.

4. Double-cliquez sur le composant tSchemaComplianceCheck pour configurer les paramtres de validation.

646 Guide de rfrence des Composants de Talend Open Studio


Scnario : Valider les dates en fonction d'un 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 :

- Slectionnez Int comme Type de donnes de la colonne ID.

- 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.

Guide de rfrence des Composants de Talend Open Studio 647


Scnario : Valider les dates en fonction d'un schma

Deux tableaux s'affichent dans la console, qui montrent respectivement les donnes valides et les donnes rejetes.

648 Guide de rfrence des Composants de Talend Open Studio


tUniqRow

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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 rutilisable dans divers projets et Job
designs. Voir galement le Guide utilisateur du Studio Talend.
Unique key Slectionnez dans cette zone une ou plusieurs colonnes sur
lesquelles le ddoublonnage sera effectu.

- Cochez la case Key attribute afin d'effectuer le ddoublonnage


sur toutes les colonnes.

- Cochez la case Case sensitive afin de diffrencier les majuscules


et les minuscules.
Advanced settings Only once each duplicated Cochez cette case si vous souhaitez envoyer uniquement les
key premires entres en doublon des colonnes dfinies comme cl(s)
vers le flux de sortie des doublons.
Use of disk (suitable for Cochez cette case pour permettre la gnration de fichiers
processing large row set) temporaires sur le disque dur lors du traitement de donnes
volumineuses. Cela permet d'empcher l'chec de l'excution d'un
Indisponible pour Job d un dbordement de la mmoire. Quand cette case est
les Jobs Map/ coche, vous devez galement dfinir les lments suivants :
Reduce.
- Buffer size in memory: Slectionnez le nombre de lignes
mettre en mmoire tampon avant qu'un fichier temporaire ne soit
gnr sur le disque dur.

- Directory for temp files: Indiquez l'endroit o les fichiers


temporaires doivent tre enregistrs.

Guide de rfrence des Composants de Talend Open Studio 649


Scnario 1 : Ddoublonner des donnes

Assurez-vous que le rpertoire indiqu pour vos


fichiers temporaires existe, sans quoi l'excution du Job
chouera.
Ignore trailing zeros for Cochez cette case pour ignorer les zros en fin de champs pour les
BigDecimal donnes de type BigDecimal.
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de process
du Job, aussi bien au niveau du Job qu'au niveau de chaque
composant. Notez que cette case n'est pas disponible dans la
version Map/Reduce de ce composant.
Global Variables NB_UNIQUES : nombre de lignes uniques. Cette variable est une variable After et retourne
un nombre entier.

NB_DUPLICATES : nombre de lignes en doublon. 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 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.

Pour un exemple de scnario de Job Map/Reduce Job utilisant ce composant, consultez le


Scnario 2 : Ddoublonner des entres en utilisant des composants Map/Reduce.

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).

Scnario 1 : Ddoublonner des donnes


Ce scnario dcrit un Job cinq composants, dont le but est de trier des entres partir d'une liste d'entre
comprenant des noms, de trouver des noms en doublons, et d'afficher les noms uniques ainsi que les noms en
doublon dans la console Run.

650 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Ddoublonner des donnes

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.

Configurer les composants


1. Double-cliquez sur le composant tFileInputDelimited afin d'afficher l'onglet Basic settings de sa vue
Component.

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.

5. Double-cliquez sur le tSortRow afin d'afficher sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 651


Scnario 1 : Ddoublonner des donnes

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.

Sauvegarder et excuter le Job


1. Sauvegardez votre Job l'aide des touches Ctrl+S.

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.

652 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Ddoublonner des entres en utilisant des composants Map/Reduce

Scnario 2 : Ddoublonner des entres en utilisant


des composants Map/Reduce
Ce scnario montre comment crer un Job Talend Map/Reduce afin de ddoublonner des entres. En d'autres
termes, ce scnario utilise des composants Map/Reduce afin de gnrer du code Map/Reduce et excuter le Job
dans Hadoop.

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.

Les donnes d'exemple utilises dans ce scnario se prsentent comme suit :

Guide de rfrence des Composants de Talend Open Studio 653


Scnario 2 : Ddoublonner des entres en utilisant 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.

L'assistant se prsente comme dans la capture d'cran ci-dessous :

654 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Ddoublonner des entres en utilisant des composants Map/Reduce

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.

Rorganiser les composants


1. Double-cliquez sur le Job Map/Reduce que vous venez de crer afin de l'ouvrir dans l'espace de modlisation
graphique. La Palette de composants Map/Reduce s'ouvre et des composants peuvent tre barrs, car il n'ont
pas de version Map/Reduce.

2. Cliquez-droit sur chacun des composants en question et slectionnez Delete afin de les supprimer.

3. Dposez un composant tHDFSInput, un tHDFSOutput et un tJDBCOutput dans l'espace de modlisation


graphique. Le tHDFSInput lit les donnes partir de la distribution Hadoop utilise, le tHDFSOutput
crit les donnes dans cette distribution et le tJDBCOutput crit les donnes dans une base de donnes, par
exemple, une base de donnes MySQL pour ce scnario. Les deux composants de sortie remplacent les deux
tLogRow pour crire les donnes en sortie.

Guide de rfrence des Composants de Talend Open Studio 655


Scnario 2 : Ddoublonner des entres en utilisant des composants Map/Reduce

Si vous partez d'un Job vierge, dposez galement un tSortRow et un tUniqRow.

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.

Configurer une connexion Hadoop


1. Cliquez sur Run afin d'ouvrir la vue correspondante et cliquez sur l'onglet Hadoop Configuration afin
d'afficher cette vue et configurer la connexion Hadoop pour ce Job.

La vue se prsente comme dans la capture d'cran ci-dessous :

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.

656 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Ddoublonner des entres en utilisant des composants Map/Reduce

Pour un exemple d'utilisation tape par tape de cette option Custom, consultez Connexion une distribution
Hadoop personnalise.

En plus de l'volution de Hadoop, veuillez noter les changements suivants :

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 resourcemanager scheduler address et saisissez l'adresse de l'ordonnanceur


(Scheduler) dans le champ qui apparat.

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.

Guide de rfrence des Composants de Talend Open Studio 657


Scnario 2 : Ddoublonner des entres en utilisant des composants Map/Reduce

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.

658 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Ddoublonner des entres en utilisant des composants Map/Reduce

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).

Pour plus d'informations concernant la dfinition des paramtres de mmoire pour


YARN et MapReduce, consultez la documentation de la distribution utilise comme,
par exemple, celle d'Hortonworks : http://docs.hortonworks.com/HDPDocuments/HDP2/HDP-2.0.6.0/
bk_installing_manually_book/content/rpm-chap1-11.html (en anglais).

Configurer les composants d'entre et de sortie

Configurer le tHDFSInput

1. Double-cliquez sur le tHDFSInput pour ouvrir sa vue Component.

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.

Guide de rfrence des Composants de Talend Open Studio 659


Scnario 2 : Ddoublonner des entres en utilisant des composants Map/Reduce

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.

Vrifier les composants de transformation

1. Double-cliquez sur le tSortRow afin d'ouvrir sa vue Component.

660 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Ddoublonner des entres en utilisant des composants Map/Reduce

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.

2. Double-cliquez sur le tUniqRow pour ouvrir sa vue Component.

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

1. Double-cliquez sur le tHDFSOutput pour ouvrir sa vue Component.

2. Comme expliqu prcdemment pour la vrification du schma du tHDFSInput, procdez de la mme


manire afin de vrifier le schma du tHDFSOutput. S'il ne correspond pas au schma du composant
prcdent, le tUniqRow, cliquez sur Sync column afin de rcuprer le schma du tUniqRow.

Guide de rfrence des Composants de Talend Open Studio 661


Scnario 2 : Ddoublonner des entres en utilisant des composants Map/Reduce

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

1. Double-cliquez sur le tJDBCOutput afin d'ouvrir sa vue Component.

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.

662 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Ddoublonner des entres en utilisant des composants Map/Reduce

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.

Guide de rfrence des Composants de Talend Open Studio 663


Scnario 2 : Ddoublonner des entres en utilisant des composants Map/Reduce

Dans HDFS, les entres uniques sont crites dans des fichiers spars.

Dans MySQL, deux donnes dupliques sont ajoutes.

Si vous souhaitez plus d'informations concernant le Job et son excution, utilisez la console Web fournie par la
distribution Hadoop que vous utilisez.

664 Guide de rfrence des Composants de Talend Open Studio


tUniservBTGeneric

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns pour rcuprer le schma du


composant prcdent.

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.

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.
Job directory Rpertoire de DQ Batch Suite dans lequel est sauvegard le
processus.
Job name Nom du processus DQ Batch Suite excuter.

Guide de rfrence des Composants de Talend Open Studio 665


Proprits du tUniservBTGeneric

Job file path Chemin d'accs l'emplacement o le processus excut sera


sauvegard. Le chemin vers le fichier doit tre absolu.
Advanced settings Temporary directory Rpertoire dans lequel les fichiers temporaires crs lors de
l'excution du processus sont sauvegards.
Input Parameters Ces paramtres doivent correspondre aux paramtres de la fonction
Input de l'onglet Format du processus.

File location : Dfinit si le fichier d'entre est sauvegard dans le


pool ou dans le rpertoire du processus local.

Directory : Si File location = Pool, le rpertoire est li au pool. Si


File location = Job, "input" doit tre ici spcifi.

File name : Nom du fichier dlimiteur gnr par le composant


tUniservBTGeneric et transfr DQ Batch Suite. Le nom du
fichier doit correspondre au nom de fichier dfini dans la fonction
Input du processus.

No. of header rec. : 0 = pas d'en-tte enregistr, 1 = en-tte dans


le fichier d'entre.

Field separator : Sparateur de champs dfini dans la fonction


Input du processus DQ Batch Suite.
Output Parameters Ces paramtres doivent correspondre aux paramtres de la fonction
Output de l'onglet Format du processus.

File location : Dfinit si le fichier d'entre est sauvegard dans le


pool ou dans le rpertoire du processus local.

Directory : Si File location = Pool, le rpertoire est bas dans le


pool. Si File location = Job, "output" doit tre ici spcifi.

File name : Nom du fichier de sortie au format dlimiteur gnr par


le composant tUniservBTGeneric et transfr DQ Batch Suite.
Le nom du fichier doit correspondre au nom de fichier dfini dans
la fonction Output du processus.

No. of header rec. : 0 = pas d'en-tte enregistr, 1 = en-tte dans


le fichier de sortie.

Field separator : Sparateur de champs dfini dans la fonction


Output du processus.
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 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.

Veuillez noter que :

le processus doit tre configur et excutable dans DQ Batch Suite,

l'utilisateur doit possder les droits pour excuter le processus,

le processus DQ Batch Suite ne doit tre compos que d'une seule ligne,

666 Guide de rfrence des Composants de Talend Open Studio


Scnario : Excution d'un processus dans DQ Batch Suite

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.

Scnario : Excution d'un processus dans DQ Batch


Suite
Ce scnario dcrit un processus dont les rsultats de l'excution sont traits dans Data Quality Service Hub Studio.
La source d'entre du processus est fournie par Data Quality Service Hub Studio.

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.

La bote de dialogue ci-dessous apparat.

2. Slectionnez tOracleInput et cliquez sur OK pour fermer la bote de dialogue.

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.

4. Connectez le tMap au tUniservBTGeneric l'aide d'un lien Row > Main.

Guide de rfrence des Composants de Talend Open Studio 667


Scnario : Excution d'un processus dans DQ Batch Suite

Acceptez le schma du tUniservBTGeneric en cliquant sur Yes dans la fentre de propagation.

5. Connectez les autres composants l'aide de liens Row > Main.

6. Double-cliquez sur le tUniservBTGeneric pour afficher sa vue Basic settings.

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.

668 Guide de rfrence des Composants de Talend Open Studio


Scnario : Excution d'un processus dans DQ Batch Suite

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.

Guide de rfrence des Composants de Talend Open Studio 669


Scnario : Excution d'un processus dans DQ Batch Suite

Cliquez sur OK pour fermer la bote de dialogue.

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.

670 Guide de rfrence des Composants de Talend Open Studio


tUniservRTConvertName

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.

Le composant reconnat les adresses d'entreprise ou d'institution et est capable de fournir la


fiche de l'organisme sparment. Il divise galement les lignes contenant des informations sur
plusieurs personnes. De plus, il reconnat certains modles n'appartenant pas aux informations
de nom, dans la ligne de nom (numro client, notes, etc.) et les supprime ou les dplace dans
certains champs mmo spcifiques.
Objectif Le 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.
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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].
Host name Nom de l'hte du serveur, entre guillemets doubles.
Port Numro du port du serveur, entre guillemets doubles.
Service Le nom/type du service est "cname_d" par dfaut. Saisissez un
nouveau nom si ncessaire (si le suffixe du service change, par
exemple), entre guillemets doubles. Les services disponibles sont :

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"

Guide de rfrence des Composants de Talend Open Studio 671


Scnario : Analyse d'une ligne de nom et attribution d'un titre

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.

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 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.

Scnario : Analyse d'une ligne de nom et attribution


d'un titre
Ce scnario dcrit un Job vous permettant d'analyser le nom de personnes dans un fichier et de leur attribuer un titre.

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.

La bote de dialogue suivante s'ouvre :

672 Guide de rfrence des Composants de Talend Open Studio


Scnario : Analyse d'une ligne de nom et attribution d'un titre

2. Slectionnez le composant tFileInputDelimited et cliquez sur OK pour fermer la bote de dialogue.

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.

4. Reliez le tMap au tUniservRTConvertName l'aide d'un lien Row > Main.

Acceptez le schma du tUniservRTConvertName en cliquant sur Yes dans la fentre de propagation.

5. Connectez les autres composants l'aide de liens Row > Main.

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.

Guide de rfrence des Composants de Talend Open Studio 673


Scnario : Analyse d'une ligne de nom et attribution d'un titre

7. Assignez les colonnes de la source d'entre leurs colonnes respectives du tUnivservRTConvertName.


Pour ce faire, slectionnez une colonne de la source d'entre et glissez-la dans la colonne du mme nom du
ct droit. Si les champs du fichier d'entre doivent tre passs au fichier de sortie, comme les adresses ou
les IDs, vous devrez dfinir des champs supplmentaires.

8. Cliquez sur OK pour fermer la bote de dialogue.

9. Double-cliquez sur le tUniservRTConvertName pour ouvrir sa vue Basic settings.

10. Renseignez les informations concernant le serveur et spcifiez le pays li au service.

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.

674 Guide de rfrence des Composants de Talend Open Studio


Scnario : Analyse d'une ligne de nom et attribution d'un titre

12. Cliquez sur OK pour fermer la fentre.

13. Double-cliquez sur le tFileOutputDelimited et saisissez les dtails du fichier de sortie.

Guide de rfrence des Composants de Talend Open Studio 675


tUniservRTMailBulk

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.

Le schma de ce composant est en lecture seule. Vous pouvez


cliquer sur Edit schema afin de visualiser le schma.
Host name Nom de l'hte du serveur, entre guillemets doubles.
Port Numro du port d'coute du serveur, entre guillemets doubles.
Service Le nom du service est "mail" par dfaut. Saisissez une nouvelle
valeur si ncessaire (si le suffixe du service change, par exemple),
entre guillemets doubles.
Advanced settings Uniserv Parameters Pour plus d'informations, veuillez consulter le manuel utilisateur
Uniserv mailRetrieval.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
Job et 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.
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.

Scnario : Crer un pool d'index


Ce scnario dcrit un Job chargeant une liste d'adresses d'une base de donnes SQL vers un pool d'index.

La base de donnes de ce scnario est dj sauvegarde dans le Repository, toutes les mtadonnes de schma
sont donc dj disponibles.

676 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer un pool d'index

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.

La bote de dialogue suivante s'ouvre :

2. Slectionnez le composant tMysqlInput et cliquez sur OK pour fermer la bote de dialogue.

Le composant apparat dans l'espace de modlisation graphique.

3. Glissez les composants suivants de la Palette dans l'espace de modlisation graphique: tMap et
tUniservRTMailBulk.

4. Connectez le tMap au tUniservRTMailBulk l'aide d'un lien Row > Main.

Acceptez le schma du tUniservRTMailBulk en cliquant sur Yes dans la fentre de propagation.

5. Connectez les autres composants l'aide de liens Row > Main.

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.

Guide de rfrence des Composants de Talend Open Studio 677


Scnario : Crer un pool d'index

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.

8. Cliquez sur OK pour fermer la fentre de dialogue.

9. Double-cliquez sur le tUniservRTMailBulk pour ouvrir sa vue Basic settings.

10. Renseignez les informations relatives au serveur et spcifiez le service.

11. Dans la vue Advanced settings, adaptez les paramtres serveur.

678 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer un pool d'index

Guide de rfrence des Composants de Talend Open Studio 679


tUniservRTMailOutput

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].
Host name Nom de l'hte du serveur, entre guillemets doubles.
Port Numro du port d'coute du serveur, entre guillemets doubles.
Service Le nom du service est "mail" par dfaut. Saisissez une nouveau
nom si ncessaire (si le suffixe du service change, par exemple),
entre guillemets doubles.
Action on data Oprations ralisables dans le pool d'index :

Insert : insre un nouvel enregistrement dans le pool d'index.


Cette requte choue si l'enregistrement possdant la mme
rfrence existe dj dans le pool.

Update : met jour un enregistrement existant dans le pool. Cette


requte choue si aucun enregistrement ne possde le nom de la
rfrence donne.

Insert or update : insre un nouvel enregistrement dans le pool


d'index. Si l'enregistrement avec la rfrence donne existe dj,
une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence


donne. Si l'enregistrement n'existe pas dans le pool d'index, un
nouvel enregistrement est insr..

Delete : supprime l'enregistrement correspondant la rfrence


donne dans le pool d'index.
Advanced settings Uniserv Parameters Pour plus d'informations, consultez le manuel utilisateur
d'Uniserv mailRetrieval.

680 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Avant d'utiliser le tUniservRTMailOutput pour la premire fois, un pool d'index doit


tre cr. Crez-en un l'aide du composant tUniservRTMailBulk.

Scnario associ
Pour un scnario associ, consultez Scnario : Ajouter des contacts au pool d'index de mailRetrieval.

Guide de rfrence des Composants de Talend Open Studio 681


tUniservRTMailSearch

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].
Host name Nom de l'hte du serveur, entre guillemets doubles.
Port Numro du port d'coute du serveur, entre guillemets doubles.
Service Le nom du service est "mail" par dfaut. Saisissez une nouveau
nom si ncessaire (si le suffixe du service change, par exemple),
entre guillemets doubles.
Maximum of displayed Saisissez le nombre maximum de doublons afficher dans la
duplicates (0 = All) vue Run. La valeur par dfaut est 0, ce qui signifie que tous les
doublons sont affichs. Mille doublons peuvent tre affichs au
maximum.
Use rejects Cochez cette case pour paramtrer les options dfinissant les
enregistrements de doublons ajouter au flux de rejet. Dfinissez :

Element : Compte des doublons.

Operator : <, <=, =, >=, >.

Value : Saisissez la valeur manuellement..


Advanced settings Uniserv Parameters Pour plus d'informations, veuillez consulter le manuel utilisateur
Uniserv mailRetrieval.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
Job et 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.

682 Guide de rfrence des Composants de Talend Open Studio


Scnario : Ajouter des contacts au pool d'index de mailRetrieval

Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne
aprs l'excution d'un composant.

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, 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.

Avant d'utiliser le tUniservRTMailSearch, un pool d'index doit tre cr. Vous


pouvez crer un pool d'index grce au composant tUniservRTMailBulk.

Scnario : Ajouter des contacts au pool d'index de


mailRetrieval
Ce scnario dcrit un Job qui ajoute des contacts un pool d'index de mailRetrieval. Vous devez au pralable vous
assurer que ces contacts existent dj.

Le fichier d'entre de ce scnario est sauvegard dans le Repository, ce qui rend disponible le schma des
mtadonnes.

Les donnes de la source d'entre doivent provenir du mme pays.

Dposer et relier les composants


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.

La bote de dialogue suivante apparat :

2. Slectionnez tFileInputDelimited et cliquez sur OK pour fermer la bote de dialogue.

Guide de rfrence des Composants de Talend Open Studio 683


Scnario : Ajouter des contacts au pool d'index de mailRetrieval

Le composant s'affiche dans l'espace de modlisation graphique.

3. Glissez les composants suivants de la Palette dans l'espace de modlisation graphique : deux composants
tMap, un tUniservRTMailSearch et un tUniservRTMailOutput.

4. Connectez le tMap au tUniservRTMailSearch l'aide d'un lien Row > Main.

Acceptez le schma du tUniservRTMailSearch en cliquant sur Yes dans la fentre de propagation.

5. Connectez les autres composants l'aide de liens Row > Main.

Configurer les composants

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.

684 Guide de rfrence des Composants de Talend Open Studio


Scnario : Ajouter des contacts au pool d'index de mailRetrieval

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.

Cliquez sur OK pour fermer la fentre.

4. Double-cliquez sur le composant tUniservRTMailSearch pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 685


Scnario : Ajouter des contacts au pool d'index de mailRetrieval

5. Dans la case Maximum of displayed "duplicates", saisissez 0 pour afficher tous les doublons.

Slectionnez Define rejects pour ouvrir la fentre de dfinition des rejets.

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.

9. Cliquez sur Auto map! pour mapper les champs automatiquement.

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.

686 Guide de rfrence des Composants de Talend Open Studio


Scnario : Ajouter des contacts au pool d'index de mailRetrieval

Cliquez sur OK pour fermer la bote de dialogue.

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.

Guide de rfrence des Composants de Talend Open Studio 687


tUniservRTPost

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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 : 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 name Nom de l'hte du serveur, entre guillemets doubles.
Port Numro du port d'coute du serveur, entre guillemets doubles.
Service Le nom du service est "post" par dfaut. Saisissez un nouveau
nom si ncessaire (suffixe du service par exemple), entre
guillemets doubles.
Use rejects Cochez cette case pour collecter les adresses incorrectes via la
connexion rejects. Il s'agit habituellement des adresses de classe
5. Les valeurs valides pour les classes de rsultat vont de 1 5. La
valeur doit tre entre guillemets doubles.

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.

688 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Vrifier et corriger le code postal, la ville et la rue

Lorsqu'une adresse ne peut tre corrige de manire certaine, une


liste de rsultats ambigus est cre.

Cette liste peut par la suite tre traite via la connexion


AMBIGUITY. Tous les rsultats potentiellement candidats sont
redirigs via cette connexion. Le schma de cette connexion est
pr-initialis avec les arguments de la liste de slection dissoute
du service 'post'.
Advanced settings Uniserv Parameters Cochez cette case pour dfinir les paramtres correspondants.
Pour plus d'informations, veuillez vous rfrer au manuel Uniserv
International Postal Framework.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
Job et de chaque composant.
"Full address" selection list Cochez la case Display pour afficher toutes les colonnes. Vous
pouvez galement cocher la case d'une colonne en particulier pour
n'afficher qu'elle.

Cette option contrle le contenu du fichier des adresses


incertaines. Seules les colonnes slectionnes seront crites dans
le fichier.
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 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.

Scnario 1 : Vrifier et corriger le code postal, la ville


et la rue
Ce scnario dcrit un Job qui vrifie et corrige les adresses et les codes postaux d'un fichier.

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.

La bote de dialogue suivante apparat :

Guide de rfrence des Composants de Talend Open Studio 689


Scnario 1 : Vrifier et corriger le code postal, la ville et la rue

2. Slectionnez le composant tFileInputDelimited et cliquez sur OK pour fermer la bote de dialogue.

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.

4. Connectez le tMap au tUniservRTPost l'aide d'un lien Row > Main.

Acceptez le schma du tUniservRTPost en cliquant sur Yes dans la fentre proposant la propagation.

5. Connectez les autres composants l'aide de liens Row > Main.

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.

690 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Vrifier et corriger le code postal, la ville et la rue

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.

8. Cliquez sur OK pour fermer la fentre.

9. Double-cliquez sur le composant tUniservRTPost et ouvrez sa vue Advanced settings.

Guide de rfrence des Composants de Talend Open Studio 691


Scnario 1 : Vrifier et corriger le code postal, la ville et la rue

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.

692 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Vrifier et corriger le code postal, la ville et la rue, tout en rejetant les donnes incorrectes

12. Cliquez sur OK pour fermer la bote de dialogue.

13. Double-cliquez sur le composant tFileOutputDelimited pour saisir les dtails du fichier de sortie.

Scnario 2 : Vrifier et corriger le code postal, la ville


et la rue, tout en rejetant les donnes incorrectes
Ce scnario est troitement li au prcdent ceci prs que les adresses qui ne peuvent tre assignes sont crites
dans un champ part pour une vrification manuelle. De plus, pour crire des adresses ambigus dans un fichier
spar, la procdure est la mme que celle dcrite ici.

1. Crez un Job comme dcrit dans le scnario prcdent.

2. Glissez les composants suivants de la Palette dans l'espace de modlisation graphique : un tMap et un
tFileOutputDelimited.

3. Double-cliquez sur le composant tUniservRTPost pour ouvrir sa vue Basic settings.

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.

Guide de rfrence des Composants de Talend Open Studio 693


Scnario 2 : Vrifier et corriger le code postal, la ville et la rue, tout en rejetant les donnes incorrectes

5. Connectez le composant tUniservRTPost au tMap_5 l'aide d'un lien Row > Rejects.

6. Connectez le tMap au tFileOutputDelimited l'aide d'un lien Row > Main.

7. Dfinissez les champs du fichier de sortie dans la fentre de mapping du schma.

694 Guide de rfrence des Composants de Talend Open Studio


Databases - Composants traditionnels
Le chapitre Databases - Composants traditionnels dcrit les connecteurs de bases de donnes traditionnelles ainsi
que les connecteurs aux 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. Plus de 40 SGBDR sont supports. Ces composants sont prsents dans la famille Databases de la Palette
dans la perspective Integration du Studio Talend.

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.

Guide de rfrence des Composants de Talend Open Studio


tAccessBulkExec

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Slectionnez la version d'Access que vous utilisez.
Database Nom de la base de donnes.
Username and 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.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :

None : n'effectuer aucune opration de table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

696 Guide de rfrence des Composants de Talend Open Studio


Proprits du tAccessBulkExec

Clear table : supprimer le contenu de la table.


Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois et la table doit
exister pour que l'opration Insert soit autorise.
Local filename Nom du fichier traiter.

Voir galement le Guide utilisateur de Studio Talend.


Action on data Vous pouvez effectuer, sur les donnes de la table dfinie, l'opration que vous souhaitez :

Insert : ajoute de nouvelles entres la table.


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 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 :

View schema : slectionnez cette option afin de voir le schma.

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 settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes existante.
parameters Cette option est disponible lorsque la case Use an existing connection est dcoche dans
les Basic settings.
Include header Cochez cette case pour inclure l'en-tte des colonnes dans le fichier.
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 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.

Guide de rfrence des Composants de Talend Open Studio 697


Scnarios associs

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.

698 Guide de rfrence des Composants de Talend Open Studio


tAccessClose

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.

Guide de rfrence des Composants de Talend Open Studio 699


tAccessCommit

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.

Si vous utilisez un lien de type Row > Main pour relier le


tAccessCommit votre Job, vos donnes seront commites
ligne par ligne. Dans ce cas, ne cochez pas la case Close
connection car la connexion sera ferme avant la fin du
commit de votre premire ligne.
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 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

700 Guide de rfrence des Composants de Talend Open Studio


tAccessConnection

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

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 d'Access que vous utilisez (Access 2003 ou
versions suprieures).
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.
Use or register a shared DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
Advanced settings Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires
parameters la connexion la base de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant est gnralement utilis avec des composants Access et notamment avec les
composants tAccessCommit 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.

Guide de rfrence des Composants de Talend Open Studio 701


Scnario: Insrer des donnes dans des tables parent/enfant

Scnario: Insrer des donnes dans des tables parent/


enfant
Le Job suivant est ddi des utilisateurs avancs de base de donnes qui souhaitent effectuer des insertions dans
des tables multiples en utilisant une table parent Table1 pour gnrer deux tables enfant : Name et Birthday.

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.

702 Guide de rfrence des Composants de Talend Open Studio


Scnario: Insrer des donnes dans des tables parent/enfant

Dans la vue Component du composant tAccessConnection, dfinissez manuellement les informations de


connexion ou rcuprez-les dans le Repository si vous les avez pralablement stockes dans le dossier DB
connection du rpertoire Metadata. Pour plus d'informations concernant les Mtadonnes, consultez le Guide
utilisateur du Studio Talend.

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.

Guide de rfrence des Composants de Talend Open Studio 703


Scnario: Insrer des donnes dans des tables parent/enfant

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.

Cliquez sur Guess Query.

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.

Enregistrez votre Job et appuyez sur F6 pour l'excuter.

704 Guide de rfrence des Composants de Talend Open Studio


Scnario: Insrer des donnes dans des tables parent/enfant

La table parent Table1 est utilise la fois pour gnrer la table Name et la table Birthday.

Guide de rfrence des Composants de Talend Open Studio 705


tAccessInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Slectionnez la version d'Access que vous utilisez.
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.
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.

706 Guide de rfrence des Composants de Talend Open Studio


Proprits du tAccessInput

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Guide de rfrence des Composants de Talend Open Studio 707


Scnarios associs

Scnarios associs
Pour un scnario associ, consultez les scnarios tDBInput dans :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

Pour plus d'informations sur les contextes dynamiques dans le cadre d'une utilisation de base de donnes, consultez
tContextLoad.

708 Guide de rfrence des Composants de Talend Open Studio


tAccessOutput

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.

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 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.

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 :

1. Au niveau parent, enregistrer la connexion la base


de donnes partager, dans la vue Basic settings du
composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi


la cration de connexion, afin de lire la connexion
enregistre.

Pour plus d'informations concernant le partage d'une


connexion travers diffrents niveaux de Jobs, consultez
le Guide utilisateur du Studio Talend.
DB Version Slectionnez la version d'Access que vous utilisez.
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 crer. Vous ne pouvez crer qu'une seule table
la fois.

Guide de rfrence des Composants de Talend Open Studio 709


Proprits du tAccessOutput

Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes
de la table slectionne :

None : n'effectuer aucune opration de table.

Drop and create table : supprimer la table puis en crer une


nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe


dj, puis en crer une nouvelle.

Clear table : supprimer le contenu de la table.


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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si


l'enregistrement avec la rfrence donne existe dj, une mise jour
est effectue.

Update or insert : met jour l'enregistrement avec la rfrence


donne. Si l'enregistrement n'existe pas, un nouvel enregistrement
est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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 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.

710 Guide de rfrence des Composants de Talend Open Studio


Proprits du tAccessOutput

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema (en
anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est
en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 Additional JDBC parameters Ajoutez des informations de connexion supplmentaires ncessaires
settings la connexion la base de donnes.

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 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 tAccessOutput peut utiliser pour situer ou remplacer la
nouvelle colonne ou celle modifier.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Use field options Cochez cette case pour personnaliser une requte, surtout lorsqu'il y
a plusieurs actions sur les donnes.
Enable debug mode Cochez cette case pour afficher chaque tape du processus de
d'criture dans la base de donnes.
Support null in "SQL WHERE" statement Cochez cette case pour prendre en compte les valeurs Null d'une
table de base de donnes.

Assurez-vous que la case Nullable est bien coche pour les


colonnes du schma correspondantes.
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.

Guide de rfrence des Composants de Talend Open Studio 711


Scnarios associs

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du tMySQLOutput.

712 Guide de rfrence des Composants de Talend Open Studio


tAccessOutputBulk

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.

Famille de composant Databases/Access


Fonction Le composant tAccessOutputBulk crit un fichier dlimit.
Objectif Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter 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.
File Name Chemin d'accs et nom du fichier traiter, et/ou variable utiliser.

Pour plus d'informations concernant l'utilisation et la dfinition


de variables, consultez le Guide utilisateur du Studio Talend.
Create directory if not exists Cette case est coche par dfaut. Cette option permet de crer le
dossier contenant le fichier de sortie s'il n'existe pas dj.
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 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.
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.

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma
est en mode Repository, trois options sont disponibles :

Guide de rfrence des Composants de Talend Open Studio 713


Scnarios associs

View schema : slectionnez cette option afin de voir le schma.

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 settings 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 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 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.

Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

714 Guide de rfrence des Composants de Talend Open Studio


tAccessOutputBulkExec

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Slectionnez la version d'Access que vous utilisez.
DB Name 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.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table slectionne :

None : n'effectuer aucune opration de table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear table : supprimer le contenu de la table.

Guide de rfrence des Composants de Talend Open Studio 715


Proprits du tAccessOutputBulkExec

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.

Voir galement le Guide utilisateur du Studio Talend.


Action on data Vous pouvez effectuer, sur les donnes de la table dfinie, l'opration que vous souhaitez :

Insert : ajoute de nouvelles entres la table.


Schema et Edit Un schma est une description de lignes, il dfinit le nombre de champs qui sont traits et
schema 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.
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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].
Create directory if Cette case est coche par dfaut. Cette option permet de crer le dossier contenant le fichier
not exists de sortie s'il n'existe pas dj.
Append Cochez cette option pour ajouter des nouvelles lignes la fin du fichier.
Advanced Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base
settings parameters de donnes.

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.

716 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Guide de rfrence des Composants de Talend Open Studio 717


tAccessRollback

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.

718 Guide de rfrence des Composants de Talend Open Studio


tAccessRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Slectionnez la version d'Access que vous utilisez.
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.
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 :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 719


Proprits du tAccessRow

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 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

720 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez 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 :

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du tMySQLRow.

Guide de rfrence des Composants de Talend Open Studio 721


tAS400Close

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.

Pour un scnario associ au composant, consultez tMysqlConnection du composant tAS400Close.

722 Guide de rfrence des Composants de Talend Open Studio


tAS400Commit

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.

Si vous utilisez un lien de type Row > Main pour relier le


tAS400Commit votre Job, vos donnes seront commites
ligne par ligne. Dans ce cas, ne cochez pas la case Close
connection car la connexion sera ferme avant la fin du
commit de votre premire ligne.
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 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.

Guide de rfrence des Composants de Talend Open Studio 723


tAS400Connection

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

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 d'AS/400 que vous utilisez.
Host Adresse IP du serveur de base de donnes.
Database Nom de la base de donnes.
Table 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 DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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.
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

724 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

doivent tre commites de manire explicite l'aide du composant


correspondant de commit.

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 au niveau du
composant.
Utilisation Ce composant est gnralement utilis avec des composants AS/400 et notamment avec les
composants tAS400Commit 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 plus d'informations relatives au fonctionnement du composant tAS400Connection, consultez
tMysqlConnection.

Guide de rfrence des Composants de Talend Open Studio 725


tAS400Input

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
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.

726 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 :

View schema : slectionnez cette option afin de voir le schma.

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 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.
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 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.
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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.

Guide de rfrence des Composants de Talend Open Studio 727


tAS400LastInsertId

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].
Component list Slectionnez le composant tAS400Connection dans la liste s'il y a
plus d'une connexion dans votre Job.
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 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.

728 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Pour plus d'informations sur les niveaux 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.

Guide de rfrence des Composants de Talend Open Studio 729


tAS400Output

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
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 Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table slectionne :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

730 Guide de rfrence des Composants de Talend Open Studio


Proprits du tAS400Output

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear a table : supprimer le contenu de la table.


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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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
schema 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.
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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 Use commit Cochez cette case pour accder au champ Commit every et dfinir les oprations de commit.
settings control
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.

Guide de rfrence des Composants de Talend Open Studio 731


Scnarios associs

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

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

732 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Guide de rfrence des Composants de Talend Open Studio 733


tAS400Rollback

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.

734 Guide de rfrence des Composants de Talend Open Studio


tAS400Row

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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 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 :

Guide de rfrence des Composants de Talend Open Studio 735


Proprits du tAS400Row

View schema : slectionnez cette option afin de voir le schma.

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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

736 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.

Pour plus d'informations sur les niveaux 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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

Guide de rfrence des Composants de Talend Open Studio 737


tDB2BulkExec

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Table Schema Nom du schma.
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.
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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer
une nouvelle.

738 Guide de rfrence des Composants de Talend Open Studio


Proprits du tDB2BulkExec

Clear a table : supprimer le contenu de la table.


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.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].
Data file 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.
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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si


l'enregistrement n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

Il est ncessaire de spcifier au minimum une cl de recherche sur laquelle


baser les oprations Update et Delete. Il est possible de dfinir les colonnes
qui agiront comme cl de recherche partir du schma, pour une utilisation de
base, ou partir des options avances (Advanced settings) pour une utilisation
optimise de ces oprations.
Advanced settings Additional JDBC Spcifiez des proprits de connexion supplmentaires pour la connexion la base de
parameters donnes que vous crez.

Vous pouvez configurer les paramtres d'encodage dans ce champ.

Field terminated Caractre, chane ou expression rgulire sparant les champs.


by
Date Format Utilisez ce champ pour dfinir l'ordre des mois et des jours.
Time Format Utilisez ce champ pour dfinir l'ordre des heures, minutes et secondes.
Timestamp Format Utilisez ce champ pour dfinir l'ordre de la date et de l'heure.
Remove Load Quand la case est coche, dbloque la table en tat "Pending", aprs un chargement massif.
Pending
Load options Cliquez sur le bouton [+] afin d'ajouter des options de chargement des donnes.

Parameter : dans la liste, slectionnez un paramtre de chargement.

Guide de rfrence des Composants de Talend Open Studio 739


Scnario associ

Value : saisissez une valeur pour le paramtre slectionn.


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.

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.

740 Guide de rfrence des Composants de Talend Open Studio


tDB2Close

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.

Pour un scnario associ au composant tDB2Close, consultez tMysqlConnection.

Guide de rfrence des Composants de Talend Open Studio 741


tDB2Commit

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.

Si vous utilisez un lien de type Row > Main pour relier le


tDB2Commit votre Job, vos donnes seront commites
ligne par ligne. Dans ce cas, ne cochez pas la case Close
connection car la connexion sera ferme avant la fin du
commit de votre premire ligne.
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 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.

742 Guide de rfrence des Composants de Talend Open Studio


tDB2Connection

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.

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.
Table 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.
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.
Use or register a shared DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
Advanced settings Additional JDBC Spcifiez des proprits de connexion supplmentaires pour la
parameters connexion la base de donnes que vous crez.

Vous pouvez configurer les paramtres d'encodage dans


ce champ.
Auto Commit Cochez cette case afin de commiter automatiquement toute
modification dans la base de donnes lorsque la transaction est
termine.

Guide de rfrence des Composants de Talend Open Studio 743


Scnarios associs

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.

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 au niveau du
composant.
Utilisation Ce composant est gnralement utilis avec des composants DB2, notamment les composants
tDB2Commit et 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).
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.

744 Guide de rfrence des Composants de Talend Open Studio


tDB2Input

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

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 d'annuaire DB2.
Port Numro du port d'coute du serveur.
Database Nom de la base de donnes.
Schema Nom du schma.
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.

Guide de rfrence des Composants de Talend Open Studio 745


Proprits du tDB2Input

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

746 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Pour plus d'informations sur les niveaux 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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.

Guide de rfrence des Composants de Talend Open Studio 747


tDB2Output

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

748 Guide de rfrence des Composants de Talend Open Studio


Proprits du tDB2Output

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear a table : supprimer le contenu de la table.

Truncate table : supprimer le contenu de la table. Il n'y a pas de possibilit de rollback.

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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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

Guide de rfrence des Composants de Talend Open Studio 749


Proprits du tDB2Output

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 Additional Spcifiez des proprits de connexion supplmentaires pour la connexion la base de donnes
settings JDBC que vous crez.
parameters
Vous pouvez configurer les paramtres d'encodage dans ce champ.

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.

750 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du tMysqlOutput.

Guide de rfrence des Composants de Talend Open Studio 751


tDB2Rollback

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.

752 Guide de rfrence des Composants de Talend Open Studio


tDB2Row

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
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 :

Guide de rfrence des Composants de Talend Open Studio 753


Proprits du tDB2Row

View schema : slectionnez cette option afin de voir le schma.

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 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

754 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

Guide de rfrence des Composants de Talend Open Studio 755


tDB2SCD

tDB2SCD

Le composant tDB2SCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus
d'informations, consultez tDB2SCD.

756 Guide de rfrence des Composants de Talend Open Studio


tDB2SCDELT

tDB2SCDELT

Le composant tDB2SCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tDB2SCDELT.

Guide de rfrence des Composants de Talend Open Studio 757


tDB2SP

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
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 :

View schema : slectionnez cette option afin de voir le schma.

758 Guide de rfrence des Composants de Talend Open Studio


Proprits du tDB2SP

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.
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.

Slectionnez le Type de paramtre :

IN : paramtre d'entre (Input)

OUT : paramtre de sortie (Output)/valeur retourne

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.

Guide de rfrence des Composants de Talend Open Studio 759


Scnario associ

Scnario associ
Pour un scnario associ, consultez

Scnario : Rcuprer des informations personnelles l'aide d'une procdure stocke.

Scnario : Trouver le libell State l'aide d'une procdure stocke.

Scnario : Vrifier le format de numros l'aide d'une procdure stocke.

Scnario : Excuter une procdure stocke dans le hub MDM.

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.

760 Guide de rfrence des Composants de Talend Open Studio


tInformixBulkExec

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

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.
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 sur 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.
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 :

Guide de rfrence des Composants de Talend Open Studio 761


Proprits du tInformixBulkExec

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer
une nouvelle.

Clear table : supprimer le contenu de la table.


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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying


+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].
Informix Directory Rpertoire d'installation d'Informix, par exemple " C:\Program Files\IBM\IBM
Informix Dynamic Server\11.50\".
Data file Nom du fichier charger.
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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si


l'enregistrement n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

Il est ncessaire de spcifier au minimum une cl de recherche sur laquelle


baser les oprations Update et Delete. Il est possible de dfinir les colonnes
qui agiront comme cl de recherche partir du schma, pour une utilisation
de base, ou partir des options avances (Advanced settings) pour une
utilisation optimise de ces oprations.

762 Guide de rfrence des Composants de Talend Open Studio


Proprits du tInformixBulkExec

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.

Guide de rfrence des Composants de Talend Open Studio 763


Scnario associ

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.

764 Guide de rfrence des Composants de Talend Open Studio


tInformixClose

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.

Pour un scnario associ au composant tInformixClose, consultez tMysqlConnection.

Guide de rfrence des Composants de Talend Open Studio 765


tInformixCommit

tInformixCommit

Proprits du tInformixCommit
Ce composant est troitement li aux composants tInformixConnection et tInformixRollback. Ils sont
gnralement utiliss ensemble lors de transactions.

Famille de composant Databases/Informix


Fonction Le composant tInformixCommit valide les donnes traites dans un Job partir d'une base de
donnes connecte.

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.

Si vous utilisez un lien de type Row > Main pour relier


le tInformixCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 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).

766 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 767


tInformixConnection

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.

Famille de composant Databases/Informix


Fonction Le composant tInformixConnection 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.
Instance Nom de l'instance Informix utiliser. Cette information se trouve
gnralement dans le fichier SQL hosts.
Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires
parameters la connexion la base de donnes.
Use or register a shared DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
Advanced settings Use Transaction Dcochez cette case lorsque la base de donnes est configure en
mode NO_LOG. Si la case est coche, vous pouvez choisir d'activer
ou non l'option Auto Commit.

768 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 au niveau du
composant.
Utilisation Ce composant est gnralement utilis avec des composants Informix, notamment les composants
tInformixCommit 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).
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.

Guide de rfrence des Composants de Talend Open Studio 769


tInformixInput

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

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 connection Cochez cette case et slectionnez le composant adquat partir de
la liste Component pour rutiliser les paramtres d'une connexion
que vous avez dj dfinis.
Host name Adresse IP du serveur de base de donnes.
Port Numro de port d'coute du serveur.
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.
Instance Nom de l'instance Informix utiliser. Cette information se trouve
gnralement dans le fichier SQL hosts.
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 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 :

770 Guide de rfrence des Composants de Talend Open Studio


Proprits du tInformixInput

View schema : slectionnez cette option afin de voir le schma.

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 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.
Guess schema Cliquez sur le bouton pour rcuprer le schma de la table.
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.
Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et en fin de
columns champ dans toutes les colonnes contenant des chanes de caractres.
Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes
slectionnes.
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 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).

Guide de rfrence des Composants de Talend Open Studio 771


Scnarios associs

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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.

772 Guide de rfrence des Composants de Talend Open Studio


tInformixOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
Port Numro de port d'coute du serveur.
Database Nom de la base de donnes.
Schema Nom du schma.
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.
Instance Nom de l'instance Informix utiliser. Cette information se trouve gnralement dans le
fichier SQL hosts.
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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Guide de rfrence des Composants de Talend Open Studio 773


Proprits du tInformixOutput

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear a table : supprimer le contenu de la table.

Truncate table : tronquer la table.

Une opration de commit est effectue aprs troncature de la table.

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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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
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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].

774 Guide de rfrence des Composants de Talend Open Studio


Proprits du tInformixOutput

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.

Guide de rfrence des Composants de Talend Open Studio 775


Scnarios associs

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

776 Guide de rfrence des Composants de Talend Open Studio


tInformixOutputBulk

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.

Famille de composant Databases/Informix


Fonction Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards
Informix.
Objectif Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter 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.
File Name Nom du fichier gnrer.
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.

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.

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma
est en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 777


Proprits du tInformixOutputBulk

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 settings Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
Field separator 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.
Create directory if not exists Cette case est coche par dfaut. Cette option permet de crer le
dossier contenant le fichier de sortie s'il n'existe pas dj.
Custom the flush buffer size Cochez cette case pour personnaliser la taille de la mmoire
utilise pour stocker 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 de base 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.

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 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).

778 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Guide de rfrence des Composants de Talend Open Studio 779


tInformixOutputBulkExec

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
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 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.
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 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 :

780 Guide de rfrence des Composants de Talend Open Studio


Proprits du tInformixOutputBulkExec

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Clear table : supprimer le contenu de la table.


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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].
Informix Rpertoire d'installation d'Informix, par exemple " C:\Program Files\IBM\IBM Informix
Directory Dynamic Server\11.50\".
Data file Nom du fichier gnrer et charger.
Append Cochez cette option pour ajouter des nouvelles lignes la fin du fichier.
Action on data Slectionnez l'opration que vous voulez effectuer :

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

Guide de rfrence des Composants de Talend Open Studio 781


Scnarios associs

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.

Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

782 Guide de rfrence des Composants de Talend Open Studio


tInformixRollback

tInformixRollback

Proprits du tInformixRollback
Ce composant est troitement li aux composants tInformixCommit et tInformixConnection. Ils sont
gnralement utiliss ensemble lors de transactions.

Famille de composant Databases/Informix


Fonction Le tInformixRollback 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 tInformixConnection
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 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.

Guide de rfrence des Composants de Talend Open Studio 783


tInformixRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur.
Database Nom de la base de donnes.
Schema Nom du schma.
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.
Instance Nom de l'instance Informix utiliser. Cette information se trouve gnralement dans le
fichier SQL hosts.
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 pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.

784 Guide de rfrence des Composants de Talend Open Studio


Proprits du tInformixRow

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 :

View schema : slectionnez cette option afin de voir le schma.

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.
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.
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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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

Guide de rfrence des Composants de Talend Open Studio 785


Scnarios associs

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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

786 Guide de rfrence des Composants de Talend Open Studio


tInformixSCD

tInformixSCD

Le composant tInformixSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tInformixSCD.

Guide de rfrence des Composants de Talend Open Studio 787


tInformixSP

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
Port Numro de port d'coute du serveur.
Database Nom de la base de donnes.
Schema Nom du schma.
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.
Instance Nom de l'instance Informix utiliser. Cette information se trouve gnralement dans le
fichier SQL hosts.
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 :

788 Guide de rfrence des Composants de Talend Open Studio


Proprits du tInformixSP

View schema : slectionnez cette option afin de voir le schma.

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.
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.

Slectionnez le Type de paramtre :

IN : paramtre d'entre (Input).

OUT : paramtre de sortie (Output)/valeur retourne.

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.

Guide de rfrence des Composants de Talend Open Studio 789


Scnarios associs

Scnarios associs
Pour un scnario associ, consultez :

Scnario : Rcuprer des informations personnelles l'aide d'une procdure stocke.

Scnario : Trouver le libell State l'aide d'une procdure stocke.

Scnario : Vrifier le format de numros l'aide d'une procdure stocke.

Scnario : Excuter une procdure stocke dans le hub MDM.

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.

790 Guide de rfrence des Composants de Talend Open Studio


tMSSqlBulkExec

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.

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.

Lorsqu'un Job contient un Job parent et un Job enfant, la


liste Component list prsente uniquement les composants
de connexion du Job du mme niveau.
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.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la
fois et la table doit 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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une
nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe


dj, puis en crer une nouvelle.

Guide de rfrence des Composants de Talend Open Studio 791


Proprits du tMSSqlBulkExec

Clear a table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais


sans possibilit de Rollback.
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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est
en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].
Remote 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.
Advanced settings Action Slectionnez l'opration que vous voulez effectuer :

Bulk insert ou Bulk update Bcp query out. Les informations


demandes seront diffrentes en fonction de l'action choisie.
Bulk insert & Bulk update 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.
Fields terminated Caractre, chane ou expression rgulire sparant les champs.
Rows terminated Caractre, chane ou expression rgulire sparant les lignes.
First row Saisissez le numro du rang partir duquel vous voulez dmarrer
l'action.
Code page Cette valeur peut prendre plusieurs formes :

OEM (valeur par dfaut)

ACP RAW : Personnalise par l'utilisateur.


Data file type Slectionnez le type de donnes traiter.
Output Slectionnez la sortie utiliser pour rcuprer la sortie standard de
la base MSSql :

792 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

to console : vers la console.

to global variable : vers la variable globale.


tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Bcp query out Fields terminated Caractre, chane ou expression rgulire sparant les champs.
Rows terminated Caractre, chane ou expression rgulire sparant les lignes.
Data file type Slectionnez le type de donnes traiter.
Output Slectionnez la sortie utiliser pour rcuprer la sortie standard de
la base MSSql :

to console : vers la console.

to global variable : vers la variable globale.


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 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.

Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Guide de rfrence des Composants de Talend Open Studio 793


tMSSqlColumnList

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.

CHARACTER_MAXIMUM_LENGTH : nombre maximum de caractres de la colonne sur


laquelle se fait l'itration. Cette variable est une variable Flow et retourne une chane de caractres
numriques pour les types de donnes binaires ou caractres et retourne NULL pour les autres
types.

CHARACTER_OCTET_LENGTH : longueur maximale en octets de la colonne sur laquelle se


fait l'itration. Cette variable est une variable Flow et retourne une chane de caractres numriques
pour les types de donnes binaires ou caractres et retourne NULL pour les autres types.

NUMERIC_PRECISION : prcision des donnes de la colonne sur laquelle se fait l'itration.


Cette variable est une variable Flow et retourne une chane de caractres numriques pour les
donnes numriques approximatives, exactes, les entiers, les donnes montaires et retourne NULL
pour les autres types de donnes.

NUMERIC_PRECISION_RADIX : base (radix) de prcision des donnes de la colonne sur


laquelle s'effectue l'itration. Cette variable est une variable Flow et retourne une chane de
caractres numriques pour les donnes numriques approximatives, exactes, les entiers, les
donnes montaires et retourne NULL pour les autres types de donnes.

NUMERIC_SCALE : l'chelle en chiffres autorise sur la coloone sur laquelle l'itration


s'effectue. Cette variable est une variable Flow et retourne une chane de caractres numriques

794 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

pour les donnes numriques approximatives, exactes, les entiers, les donnes montaires et
retourne NULL pour les autres types de donnes.

DATETIME_PRECISION : prcision de l'heure et de la date en secondes fractionnelles de la


colonne sur laquelle s'effectue l'itration. Cette variable est une variable Flow et retourne une
chane de caractres numriques si le type de donnes est datetime ou smalldatetime. Sinon,
retourne NULL.

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.

Guide de rfrence des Composants de Talend Open Studio 795


tMSSqlClose

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.

Pour un scnario associ au composant tMSSqlClose, consultez tMysqlConnection.

796 Guide de rfrence des Composants de Talend Open Studio


tMSSqlCommit

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.

Si vous utilisez un lien de type Row > Main pour relier le


tMSSqlCommit votre Job, vos donnes seront commites
ligne par ligne. Dans ce cas, ne cochez pas la case Close
connection car la connexion sera ferme avant la fin du
commit de votre premire ligne.
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 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.

Guide de rfrence des Composants de Talend Open Studio 797


tMSSqlConnection

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

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.
Schema Nom du schma.
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.
Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires
parameters la connexion la base de donnes.
Use or register a shared DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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.

798 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes dans une table de base de donnes et en extraire des informations

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 MSSql, notamment les composants
tMSSqlCommit 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).
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 : Insrer des donnes dans une table de


base de donnes et en extraire des informations
Ce scnario dcrit un Job lisant des donnes d'un fichier texte, relatives aux employs, insrant les donnes dans
une table d'une base de donnes MSSQL et extrayant les donnes les plus utiles de la table, pour les afficher dans
la console.

Guide de rfrence des Composants de Talend Open Studio 799


Scnario : Insrer des donnes dans une table de base de donnes et en extraire des informations

Ce scnario comprend les composants suivants :

un tMSSqlConnection : tablit une connexion au serveur MSSQL.

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.

un tMSSqlInput : extrait les donnes de la table selon une requte SQL.

un tLogRow : affiche les informations reues du composant prcdent dans la console.

un tMSSqlCommit : commite la transaction sur le serveur MSSQL connect.

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. Connectez le tMSSqlConnection au tFileInputDelimited l'aide d'un lien Trigger > OnSubjobOk.

3. Reliez de la mme manire le tFileInputDelimited au tMSSqlInput et le composant tMSSqlInput au


tMSSqlCommit.

4. Connectez le tFileInputDelimited au tMSSqlOutput l'aide d'un lien Row > Main.

800 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes dans une table de base de donnes et en extraire des informations

5. Rptez l'opration pour connecter le tMSSqlInput au tLogRow.

Configurer les composants


Ouvrir une connexion au serveur MSSQL
1. Double-cliquez sur le composant tMSSqlConnection pour ouvrir sa vue Basic settings.

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.

Lire les donnes d'entre


1. Double-cliquez sur le composant tFileInputDelimited pour ouvrir sa vue Component.

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

Guide de rfrence des Composants de Talend Open Studio 801


Scnario : Insrer des donnes dans une table de base de donnes et en extraire des informations

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.

Pour plus d'informations, consultez tFileInputDelimited.

Ecrire les donnes dans la table de la base de donnes


1. Double-cliquez sur le tMSSqlOutput pour ouvrir sa vue Basic settings.

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.

5. Slectionnez Insert if not exists dans la liste droulante Action on data.

802 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes dans une table de base de donnes et en extraire des informations

6. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent.

Extraire des informations de la table


1. Double-cliquez sur le composant tMSSqlInput pour afficher sa vue Component.

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.

Guide de rfrence des Composants de Talend Open Studio 803


Scnario : Insrer des donnes dans une table de base de donnes et en extraire des informations

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

Afficher les informations dans la console


1. Double-cliquez sur le tLogRow pour afficher sa vue Basic settings.

2. Dans la zone Mode, slectionnez Table (print values in cells of a table).

Commiter la transaction et fermer la connexion


1. Double-cliquez sur le tMSSqlCommit pour ouvrir sa vue Basic settings.

2. Cochez la case Close Connection.

Sauvegarder et excuter le Job


1. Appuyez sur les touches Ctrl+S pour sauvegarder votre Job.

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.

804 Guide de rfrence des Composants de Talend Open Studio


tMSSqlInput

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.

Lorsqu'un Job contient un Job parent et un Job enfant, la


liste Component list prsente uniquement les composants
de connexion du Job du mme niveau.
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.
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.
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 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.

Guide de rfrence des Composants de Talend Open Studio 805


Proprits du tMSSqlInput

Cliquez sur Edit schema pour modifier le schma. Si le schma est


en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 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 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.
Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et en fin de
columns champ dans toutes les colonnes contenant des chanes de caractres.
Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes
slectionnes.
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 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).

806 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

Scnario 2 : Utiliser la variable StoreSQLQuery.

Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du tContextLoad.

Guide de rfrence des Composants de Talend Open Studio 807


tMSSqlLastInsertId

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].
Component list Slectionnez le composant tMSSqlConnection dans la liste s'il y a
plus d'une connexion dans votre Job.
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 NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.

808 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 809


tMSSqlOutput

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.

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 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.

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 :

1. Au niveau parent, enregistrer la connexion la base


de donnes partager, dans la vue Basic settings du
composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi


la cration de connexion, afin de lire la connexion
enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Schema Nom du schma.
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.

810 Guide de rfrence des Composants de Talend Open Studio


Proprits du tMSSqlOutput

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 :

Default : n'effectuer aucune opration de table.

Drop and create table : supprimer la table puis en crer une


nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe


dj, puis en crer une nouvelle.

Clear table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais


sans possibilit de Rollback.
Turn on identity insert Cochez cette case pour utiliser votre propre squence sur les valeurs
Identity des donnes insres (plutt que de laisser le serveur SQL
choisir les valeurs squentielles).
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.

Single Insert Query : Ajouter de nouvelles entres la table,


regroupes dans un lot.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si


l'enregistrement avec la rfrence donne existe dj, une mise jour
est effectue.

Update or insert : met jour l'enregistrement avec la rfrence


donne. Si l'enregistrement n'existe pas, un nouvel enregistrement
est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

Insert if not exist : Ajouter de nouvelles entres la table si


ncessaire.

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).
Specify identity field Cochez cette case pour spcifier quel est le champ identity
(Identity field), constitu d'un numro d'identification incrment
automatiquement. Lorsque cette case est coche, trois autres champs
s'affichent :

Guide de rfrence des Composants de Talend Open Studio 811


Proprits du tMSSqlOutput

Identity field : slectionnez dans la liste la colonne que vous


souhaitez dfinir comme champ identity.

Start value : saisissez une valeur de dpart, utilise pour la premire


ligne charge dans la table.

Step : saisissez une valeur d'incrment, ajoute la valeur de la ligne


prcdemment charge.

Cette case est disponible si vous slectionnez l'option Drop and


create table, Create table, Create table if not exists ou Drop table
if exists and create dans la liste Action on table. Si vous cochez
cette case sans avoir coch la case Turn on identity insert mais en
ayant slectionn Create table if not exists dans la liste Action on
table et si la table spcifie n'existe pas, seule une table est cre
sans qu'aucune donne y soit insre.

Vous pouvez galement spcifier le champ identity


(Identity field) partir du schma du composant. Pour ce
faire, paramtrez le type de base de donnes (DB Type) de
la colonne correspondante en INT IDENTITY.

Lorsque la case Specify identity field est coche, le type


de base de donnes (DB Type) INT IDENTITY du
schma est ignor.
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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
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.

812 Guide de rfrence des Composants de Talend Open Studio


Proprits du tMSSqlOutput

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.

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 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 tMSSqlOutput 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.
Ignore date validation Cochez cette case pour ignorer la validation de la date et
insrer les donnes directement dans la base de donnes pour
les types de donnes DATE, DATETIME, DATETIME2 et
DATETIMEOFFSET.
Enable debug mode Cochez cette case pour afficher chaque tape du processus d'criture
dans la base de donnes.
Support null in "SQL Cochez cette case pour prendre en compte les valeurs Null d'une table
WHERE" statement de base de donnes.

Assurez-vous que la case Nullable est bien coche pour


les colonnes du schma correspondantes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau 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 la liste Action
on data.

Si vous slectionnez l'option Single Insert Query dans la


liste Action on data, la taille des lots doit tre infrieure ou
gale la limite des marqueurs de paramtres autoriss par
le pilote JDBC (gnralement 2000), divis par le nombre
de colonnes.
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.

Guide de rfrence des Composants de Talend Open Studio 813


Scnarios associs

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

814 Guide de rfrence des Composants de Talend Open Studio


tMSSqlOutputBulk

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.

Famille de composant Databases/MSSql


Fonction Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards MSSql.
Objectif Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une
base de donnes MSSQL.
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.
File Name Nom du fichier gnrer.

Ce fichier est gnr sur la machine locale ou dans un


dossier partag sur le rseau local.
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.

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.

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma
est en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 815


Scnarios associs

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 settings Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
Field separator Caractre, chane ou expression rgulire sparant les champs.
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 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 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.

Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

816 Guide de rfrence des Composants de Talend Open Studio


tMSSqlOutputBulkExec

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.

Famille de composant Databases/MSSql


Fonction Le tMSSqlOutputBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tMSSqlOutputBulkExec est un composant ddi qui permet un gain de performance pendant
les oprations d'Insert dans une base de donnes MSSQL.
Basic settings Action Permet de choisir entre les options Bulk Insert et Bulk update.
Property Type 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.
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.

Lorsqu'un Job contient un Job parent et un Job enfant, la


liste Component list prsente uniquement les composants
de connexion du Job du mme niveau.
Host Adresse IP du serveur de la base de donnes.

Seuls l'adresse IP exacte de la machine locale, localhost ou 127.0.0.1


permettent un fonctionnement optimal. Le serveur de la base de
donnes doit tre install sur la mme machine que le Studio Talend
ou que le Job contenant un tMSSqlOutputBulkExec.
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.
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 :

None : n'effectuer aucune opration de table.

Guide de rfrence des Composants de Talend Open Studio 817


Proprits du tMSSqlOutputBulkExec

Drop and create the table : supprimer la table puis en crer une
nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Clear a table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais


sans possibilit de Rollback.
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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est
en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].
Local File Name Nom du fichier gnrer et charger.

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.

Vous pouvez appuyer sur Ctrl+Espace afin d'accder


une liste de variables globales prdfinies.
Field separator Caractre, chane ou expression rgulire sparant les champs.
Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
First row Saisissez le numro du rang partir duquel vous voulez dmarrer
l'action.
Include header Cochez cette case pour inclure l'en-tte des colonnes dans le fichier.

818 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Data file type Slectionnez le type de donnes traiter.


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.
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 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.

Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Guide de rfrence des Composants de Talend Open Studio 819


tMSSqlRollback

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.

820 Guide de rfrence des Composants de Talend Open Studio


tMSSqlRow

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.

Lorsqu'un Job contient un Job parent et un Job enfant, la


liste Component list prsente uniquement les composants
de connexion du Job du mme niveau.
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 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.
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 :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 821


Proprits du tMSSqlRow

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 et la table doit exister pour que l'opration d'Insert soit autorise.
Turn on identity insert Cochez cette case pour utiliser votre propre squence sur les valeurs
Identity des donnes insres (plutt que de laisser le serveur SQL
choisir les valeurs squentielles).
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 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.
Propagate QUERY's Cochez cette case pour insrer les rsultats de la requte dans une
recordset colonne du flux en cours. Slectionnez cette colonne dans la liste use
column.

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 PreparedStatement Cochez cette case pour utiliser une instance PreparedStatement
afin de requter votre base 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.

Parameter Index : Saisissez la position du paramtre dans


l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

822 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du tMysqlRow.

Guide de rfrence des Composants de Talend Open Studio 823


tMSSqlSCD

tMSSqlSCD

Le composant tMSSqlSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus
d'informations, consultez tMSSqlSCD.

824 Guide de rfrence des Composants de Talend Open Studio


tMSSqlSP

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.

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 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.

Lorsqu'un Job contient un Job parent et un Job enfant, la


liste Component list prsente uniquement les composants
de connexion du Job du mme niveau.
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 sur 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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour


passer le schma en mode Built-In et effectuer des modifications
locales.

Guide de rfrence des Composants de Talend Open Studio 825


Proprits du tMSSqlSP

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 / Return result in Cochez cette case, si une seule valeur doit tre retourne.

Slectionnez dans la liste la colonne du schma sur laquelle est base


la valeur obtenir.
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.

Slectionnez le Type de paramtre :

IN : paramtre d'entre (Input)

OUT : paramtre de sortie (Output)/valeur retourne

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 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.
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 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.

826 Guide de rfrence des Composants de Talend Open Studio


Scnario : Rcuprer des informations personnelles l'aide d'une procdure stocke

Scnario : Rcuprer des informations personnelles


l'aide d'une procdure stocke
Ce scnario dcrit un Job rcuprant un enregistrement contenant des informations personnelles partir d'une table
spcifie. Il utilise pour cela une procdure stocke se basant sur la valeur id dfinie dans le flux d'entre.

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 :

CREATE PROCEDURE [dbo].[QueryPerson]


@id int,
@name varchar(50)
AS
BEGIN
SET NOCOUNT ON
SELECT * FROM dbo.person where id=@id
END

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. Reliez le tFixedFlowInput au tMSSqlSP l'aide d'un lien Row > Main.

3. Rptez l'opration pour connecter le tMSSqlSP au premier tLogRow, le premier tLogRow au


tParseRecordSet et le tParseRecordSet au second tLogRow.

Configurer les composants

Configurer le composant d'entre

1. Double-cliquez sur le composant tFixedFlowInput pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 827


Scnario : Rcuprer des informations personnelles l'aide d'une procdure stocke

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.

Cliquez sur OK pour fermer l'diteur du schma.

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.

Configurer le composant tMSSqlSP

1. Double-cliquez sur le tMSSqlSP pour ouvrir sa vue Basic settings.

828 Guide de rfrence des Composants de Talend Open Studio


Scnario : Rcuprer des informations personnelles l'aide d'une 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

1. Double-cliquez sur le tParseRecordSet pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 829


Scnario : Rcuprer des informations personnelles l'aide d'une procdure stocke

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.

Configurer les composants de sortie


1. Double-cliquez sur le premier tLogRow pour ouvrir sa vue Basic settings.

830 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Dans la zone Mode, slectionnez Vertical (each row is a key/value list) pour un affichage optimal des
rsultats.

2. Configurez de la mme manire le second tLogRow.

Sauvegarder et excuter le Job


1. Appuyez sur les touches Ctrl + S pour sauvegarder votre Job.

2. Appuyez sur F6 afin de l'excuter.

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 :

Scnario : Trouver le libell State l'aide d'une procdure stocke.

Scnario : Vrifier le format de numros l'aide d'une procdure stocke.

Scnario : Excuter une procdure stocke dans le hub MDM.

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.

Guide de rfrence des Composants de Talend Open Studio 831


tMSSqlTableList

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).

832 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Scnario associ
Pour un scnario associ, consultez Scnario : Itrer une table de base de donnes et lister le nom des colonnes
de la table.

Guide de rfrence des Composants de Talend Open Studio 833


tMysqlBulkExec

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
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.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :

None : n'effectuer aucune action sur la table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

834 Guide de rfrence des Composants de Talend Open Studio


Proprits du tMysqlBulkExec

Create table if doesn't exist : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en crer
un nouvelle.

Clear a table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit


de Rollback.
Table Nom de la table crire.

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying


+default+values+in+a+retrieved+schema (en anglais).
Advanced Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires la connexion
settings parameters la base de donnes.
Lines terminated by Caractre ou suite de caractres utiliss pour sparer les lignes.
Fields terminated by Caractre, chane ou expression rgulire sparant les champs.
Enclosed by Caractres entourant les donnes.
Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne :

Insert records in table : Insre de nouveaux enregistrements dans une table.

Replace records in table : Remplace les enregistrements existants par de nouveaux.

Update records in table : Modifie les enregistrements existants.

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.

Guide de rfrence des Composants de Talend Open Studio 835


Scnarios associs

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.
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 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.

836 Guide de rfrence des Composants de Talend Open Studio


tMysqlClose

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.

Pour un scnario associ au composant tMysqlClose, consultez tMysqlConnection.

Guide de rfrence des Composants de Talend Open Studio 837


tMysqlColumnList

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.

CHARACTER_MAXIMUM_LENGTH : nombre maximum de caractres de la colonne sur


laquelle se fait l'itration. Cette variable est une variable Flow et retourne une chane de caractres
numriques pour les types de donnes binaires ou caractres et retourne NULL pour les autres
types.

NUMERIC_PRECISION : prcision des donnes de la colonne sur laquelle se fait l'itration.


Cette variable est une variable Flow et retourne une chane de caractres numriques pour les
donnes numriques approximatives, exactes, les entiers, les donnes montaires et retourne NULL
pour les autres types de donnes.

NUMERIC_SCALE : l'chelle en chiffres autorise sur la coloone sur laquelle l'itration


s'effectue. Cette variable est une variable Flow et retourne une chane de caractres numriques
pour les donnes numriques approximatives, exactes, les entiers, les donnes montaires et
retourne NULL pour les autres types de donnes.

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.

838 Guide de rfrence des Composants de Talend Open Studio


Scnario : Itrer une table de base de donnes et lister le nom des colonnes 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.
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).

Scnario : Itrer une table de base de donnes et lister


le nom des colonnes de la table
Le scnario Java suivant permet de crer un Job cinq composants. Ce Job permet d'itrer une table donne partir
d'une base de donnes MySQL en utilisant la commande Where et de lister tous les libells des colonnes de la table.

Dans la Palette, cliquez sur chacun des composants suivants et dposez-les dans l'espace de modlisation :
tMysqlConnection, tMysqlTableList, tMysqlColumnList, tFixedFlowInput et tLogRow.

Reliez le tMysqlConnection au tMysqlTableList par le biais d'un lien OnSubjobOk.

Reliez les composants tMysqlTableList, tMysqlColumnList et tFixedFlowInput l'aide de liens Iterate.

Reliez le tFixedFlowInput au tLogRow par le biais d'un lien Row Main.

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

Guide de rfrence des Composants de Talend Open Studio 839


Scnario : Itrer une table de base de donnes et lister le nom des colonnes de la table

+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 ce scnario, itrez la table appele customer.

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.

840 Guide de rfrence des Composants de Talend Open Studio


Scnario : Itrer une table de base de donnes et lister le nom des colonnes de la table

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.

Dans la liste des variables globales, slectionnez :


((String)globalMap.get("tMysqlTableList_1_CURRENT_TABLE")) pour la colonne TableName et

((String)globalMap.get("tMysqlColumnList_1_COLUMN_NAME")) pour la colonne ColumnName.

Dans l'espace de modlisation, slectionnez le composant tLogRow.

Cliquez sur la vue Component et paramtrez les proprits de base du tLogRow en fonction de vos besoins.

Enregistrez votre Job et appuyez sur F6 pour l'excuter.

Le nom de la table MySQL et le libell de ses colonnes sont affichs dans la console.

Guide de rfrence des Composants de Talend Open Studio 841


tMysqlCommit

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.

Si vous utilisez un lien de type Row > Main pour relier le


tMysqlCommit votre Job, vos donnes seront commites
ligne par ligne. Dans ce cas, ne cochez pas la case Close
connection car la connexion sera ferme avant la fin du
commit de votre premire ligne.
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 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.

842 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Pour plus d'informations sur les niveaux 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.

Guide de rfrence des Composants de Talend Open Studio 843


tMysqlConnection

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.

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.
Table 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 DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
Specify a data source alias Cochez cette case et spcifiez l'alias de la source de donnes
cre dans 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.
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

844 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Insrer des donnes dans des tables mre/fille

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.

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus despace pour grer vos
transactions dans un Job, il est recommand d'utiliser un composant
Commit.
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement du
Job au niveau du Job ainsi qu'au niveau de chaque composant.
Utilisation Ce composant est gnralement utilis avec des composants MySQL, notamment les composants
tMysqlCommit 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 1 : Insrer des donnes dans des tables


mre/fille
Le Job suivant est ddi des utilisateurs avancs de base de donnes qui souhaitent effectuer des insertions dans
des tables multiples l'aide de l'id d'une table parent qui alimentera une table enfant.

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.

1. Dans un diteur de ligne de commande, connectez-vous votre serveur MySQL.

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;

3. Puis crez la deuxime table :


create table baby (id_baby int not null, years int) 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.

2. Connectez le composant tMysqlConnection au tFileList l'aide d'une connexion de type


OnComponentOk.

3. Connectez le composant tFileList au tMysqlCommit l'aide d'un lien OnComponentOk.

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.

Guide de rfrence des Composants de Talend Open Studio 845


Scnario 1 : Insrer des donnes dans des tables mre/fille

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.

Configurer les composants


1. Configurez les proprits du tFileList, notamment le nom du rpertoire duquel les fichiers vont tre rcuprs.

2. Dans la vue Component du composant tMysqlConnection, dfinissez les informations de connexion


manuellement ou rcuprez-les dans le Repository si vous les avez pralablement stockes dans le dossier
DB connection du rpertoire Metadata. Pour plus d'informations concernant les Mtadonnes, consultez le
Guide utilisateur du Studio Talend.

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.

846 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Insrer des donnes dans des tables mre/fille

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.

12. Dans le champ SQL expression, saisissez : '(Select Last_Insert_id())'

Dans la colonne Position, slectionnez l'option Before et dans Reference column, l'option years.

Dans l'onglet Advanced settings, dcochez la case Extend insert.

Guide de rfrence des Composants de Talend Open Studio 847


Scnario 2 : Partager une connexion de base de donnes entre un Job pre et un Job fils

Excuter le Job
1. Appuyez sur les touches Ctrl+S pour enregistrer votre Job.

2. Appuyez sur F6 pour l'excuter.

L'id de la table parent a t rutilis pour alimenter la colonne id_baby.

Scnario 2 : Partager une connexion de base de


donnes entre un Job pre et un Job fils
Ce scnario montre comment partager une connexion entre un Job pre et un Job fils. Le Job pre appelle le Job
fils afin d'crire des donnes alatoires dans une base de donnes MySQL. Il lit ensuite les donnes depuis la base
de donnes MySQL puis les affiche dans la console. La connexion la base de donnes MySQL est configure
une seule fois et utilise dans les deux Jobs.

Configurer le Job fils

Ajouter et relier les composants

1. Ajoutez les composants suivants en saisissant leur nom dans l'espace de modlisation graphique ou en les
dposant depuis la Palette :

un tMysqlConnection, afin d'ouvrir une connexion la base de donnes MySQL,

un tRowGenerator, afin de gnrer des donnes d'entre alatoires,

un tMysqlOutput, afin d'crire des donnes dans la base de donnes MySQL.

2. Reliez le tRowGenerator au tMysqlOutput l'aide d'un lien Row > Main.

3. Reliez le tMysqlConnection au tRowGenerator l'aide d'un lien Trigger > OnSubjobOk.

848 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Partager une connexion de base de donnes entre un Job pre et un Job fils

Configurer la connexion la base de donnes


1. Double-cliquez sur le tMysqlConnection afin d'ouvrir sa vue Basic settings.

2. Dans la liste Property Type, slectionnez Built-In puis configurez les dtails de connexion dans les champs
appropris, dont :

le nom d'hte ou l'adresse IP de votre serveur de base de donnes (Host),

le numro du port d'coute (Port),

le nom de la base de donnes (Database),

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.

Configurer les donnes d'entre


1. Double-cliquez sur le composant tRowGenerator afin d'ouvrir l'diteur Row Generator.

Guide de rfrence des Composants de Talend Open Studio 849


Scnario 2 : Partager une connexion de base de donnes entre un Job pre et un Job fils

2. Cliquez sur le bouton [+] afin d'ajouter quatre colonnes puis dfinissez leurs proprits comme suit :

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,

city, de type String et d'une longueur de 15 caractres.

3. Dfinissez la fonction de chaque colonne :

Pour la colonne id, slectionnez Numeric.sequence dans la liste Function afin de gnrer des squences
de nombres.

Pour la colonne firstName, slectionnez TalendDataGenerator.getFirstName dans la liste Function afin


de gnrer des prnoms de manire alatoire.

Pour la colonne lastName, slectionnez TalendDataGenerator.getLastName dans la liste Function pour


gnrer des noms de famille de manire alatoire.

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.

Configurer la sortie de la base de donnes


1. Double-cliquez sur le tMysqlOutput afin d'ouvrir sa vue Basic settings.

850 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Partager une connexion de base de donnes entre un Job pre et un Job fils

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.

5. Dans la liste Action on data, slectionnez Insert.

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.

7. Appuyez sur Ctrl+S afin de sauvegarder votre Job.

Configurer le Job pre

Ajouter et relier les composants

1. Ajoutez les composants suivants en saisissant leur nom dans l'espace de modlisation graphique ou en les
dposant depuis la Palette :

un tRunJob, afin d'appeler le Job fils,

un tMysqlConnection, afin d'ouvrir la connexion la base de donnes MySQL,

un tMysqlInput, afin de lire les donnes crites dans la base de donnes MySQL par le Job fils,

un tLogRow, afin d'afficher les donnes dans la console,

un tMysqlCommit, afin de commiter les donnes lors de la transaction et fermer la connexion la base
de donnes.

2. Reliez le tRunJob au tMysqlConnection l'aide d'un lien Trigger > OnSubjobOk.

3. Reliez le tMysqlConnection au tMysqlInput l'aide d'un lien Trigger > OnSubjobOk.

4. Reliez le tMysqlInput au tLogRow l'aide d'un lien Row > Main.

5. Reliez le tMysqlInput au tMysqlCommit l'aide d'un lien Trigger > OnSubjobOk.

Guide de rfrence des Composants de Talend Open Studio 851


Scnario 2 : Partager une connexion de base de donnes entre un Job pre et un Job fils

Configurer les composants


1. Double-cliquez sur le tRunJob afin d'ouvrir sa vue Basic settings.

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.

Laissez les autres paramtres vides ou tels qu'ils sont.

852 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Partager une connexion de base de donnes entre un Job pre et un Job fils

4. Double-cliquez sur le tMysqlInput afin d'ouvrir sa vue Basic settings.

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.

Laissez les autres paramtres du tMysqlCommit tels qu'ils sont.

Excuter le Job

1. Appuyez sur Ctrl+S afin de sauvegarder votre Job.

Guide de rfrence des Composants de Talend Open Studio 853


Scnario 2 : Partager une connexion de base de donnes entre un Job pre et un Job fils

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.

854 Guide de rfrence des Composants de Talend Open Studio


tMysqlInput

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion crant
cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
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.
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.

Guide de rfrence des Composants de Talend Open Studio 855


Proprits du tMysqlInput

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 :

View schema : slectionnez cette option afin de voir le schma.

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 Query Saisissez votre requte de base de donnes en faisant attention ce que l'ordre des
champs corresponde celui dfini dans le schma.
Specify a data source Cochez cette case et spcifiez l'alias de la source de donnes cre dans Talend
alias 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.

Si vous utilisez la configuration de la base de donnes du composant, la


connexion votre source de donnes se ferme la fin du composant. Pour
empcher la fermeture de la connexion, utilisez une connexion partage
la base de donnes, avec l'alias de la source de donnes spcifi.

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.

Lorsque vous devez traiter des donnes au format date/heure 0000-00-00


00:00:00 utilisant ce composant, dfinissez les paramtres comme suit :

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.

856 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Ecrire des colonnes d'une base de donnes MySQL dans un fichier de sortie

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).

Scnario 1 : Ecrire des colonnes d'une base de


donnes MySQL dans un fichier de sortie
Dans ce scnario, vous allez lire des colonnes d'une base de donnes MySQL puis les crire dans une table d'un
fichier local de sortie.

Dposer et relier les composants


1. Dposez un composant tMysqlInput et un tFileOutputDelimited de la Palette dans l'espace de modlisation
graphique.

2. Reliez le tMysqlInput au tFileOutputDelimited l'aide d'un lien Row > Main.

Configurer les composants


1. Double-cliquez sur le composant tMysqlInput afin d'ouvrir l'onglet Basic settings de la vue Component.

Guide de rfrence des Composants de Talend Open Studio 857


Scnario 1 : Ecrire des colonnes d'une base de donnes MySQL dans un fichier de sortie

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.

L'diteur du schma s'ouvre :

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.

858 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Ecrire des colonnes d'une base de donnes MySQL dans un fichier de sortie

Cliquez sur OK pour fermer l'diteur du schma.

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.

7. Dans la liste Query Type, slectionnez Built-In.

8. Dans le champ Query, saisissez la requte permettant de rcuprer les colonnes souhaites de la table.

9. Double-cliquez sur le tFileOutputDelimited afin d'afficher sa vue Component.

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.

11. Sauvegardez le Job en appuyant sur les touches Ctrl+S.

Excuter le Job
Appuyez sur F6 pour excuter votre Job.

Guide de rfrence des Composants de Talend Open Studio 859


Scnario 2 : Utiliser des paramtres de contexte lors de la lecture d'une table d'une base de donnes MySQL

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.

Scnario 2 : Utiliser des paramtres de contexte


lors de la lecture d'une table d'une base de donnes
MySQL
Dans ce scnario, une table d'une base de donnes MySQL est lue, l'aide un paramtre de contexte rfrant au
nom de la table.

Dposer et relier les composants


1. Dposez un composant tMysqlInput et un tLogRow de la Palette dans l'espace de modlisation graphique.

2. Reliez le tMysqlInput au tLogRow l'aide d'un lien Row > Main.

Configurer les composants


1. Double-cliquez sur le tMysqlInput pour ouvrir la vue Basic settings.

860 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Utiliser des paramtres de contexte lors de la lecture d'une table d'une base de donnes MySQL

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.

L'diteur du schma s'ouvre :

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.

Cliquez sur OK pour fermer l'diteur du schma.

5. Placez votre souris sur le champ Table Name et appuyez sur F5 pour configurer les paramtres de contexte.

Guide de rfrence des Composants de Talend Open Studio 861


Scnario 2 : Utiliser des paramtres de contexte lors de la lecture d'une table d'une base de donnes MySQL

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.

7. Cliquez sur Finish pour valider.

Le paramtre de contexte context.TABLE apparat automatiquement dans le champ Table Name.

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.

862 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Lire des donnes dans des bases de donnes MySQL l'aide de connexions dynamiques bases sur les variables de contexte

10. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un meilleur affichage des
rsultats.

11. Sauvegardez le Job.

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.

Scnario 3 : Lire des donnes dans des bases de


donnes MySQL l'aide de connexions dynamiques
bases sur les variables de contexte
Dans ce scnario, vous allez lire des donnes depuis des tables de bases de donnes ayant la mme structure mais se
trouvant dans deux diffrentes bases de donnes MySQL nommes respectivement project_q1 et project_q2. Vous
allez spcifier dynamiquement les connexions ces bases de donnes au moment de l'excution, sans modifier
le Job.

Dposer et relier les composants


1. Dposez deux composants tMysqlConnection, un tMysqlInput, un tLogRow et un tMysqlClose dans
l'espace de modlisation graphique.

2. Reliez le premier tMysqlConnection au second tMysqlConnection et le second tMysqlConnection au


tMysqlInput l'aide de liens Trigger > On Subjob Ok.

3. Reliez le tMysqlInput au tLogRow l'aide d'un lien Row > Main.

Guide de rfrence des Composants de Talend Open Studio 863


Scnario 3 : Lire des donnes dans des bases de donnes MySQL l'aide de connexions dynamiques bases sur les variables de contexte

4. Reliez le tMysqlInput au tMysqlClose l'aide d'un lien Trigger > On Subjob Ok.

Crer une variable de contexte


Afin de pouvoir choisir dynamiquement une connexion la base de donnes au moment de l'excution, vous
devez dfinir une variable de contexte. Cette dernire est configure dans les paramtres Dynamic settings du
composant d'entre de la base de donnes.

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.

2. Dans le champ de la liste Type, slectionnez List Of Value.

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].

864 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Lire des donnes dans des bases de donnes MySQL l'aide de connexions dynamiques bases sur les variables de contexte

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.

Guide de rfrence des Composants de Talend Open Studio 865


Scnario 3 : Lire des donnes dans des bases de donnes MySQL l'aide de connexions dynamiques bases sur les variables de contexte

Configurer les composants


1. Double-cliquez sur le premier composant tMysqlConnection afin d'afficher sa vue Basic settings et saisissez
les informations de connexion. Pour plus d'informations concernant la configuration du tMysqlConnection,
consultez tMysqlConnection.

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.

3. Double-cliquez sur le tMysqlInput afin d'ouvrir sa vue Basic settings.

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.

866 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Lire des donnes dans des bases de donnes MySQL l'aide de connexions dynamiques bases sur les variables de contexte

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.

Guide de rfrence des Composants de Talend Open Studio 867


Scnario 3 : Lire des donnes dans des bases de donnes MySQL l'aide de connexions dynamiques bases sur les variables de contexte

9. Dans la vue Dynamic settings du tMysqlClose, procdez de la mme manire que dans la vue Dynamic
settings du tMysqlInput.

Sauvegarder et excuter le Job


1. Appuyez sur Ctrl+S pour sauvegarder votre Job. Appuyez sur F6 ou cliquez sur Run afin de l'excuter.

Une bote de dialogue s'affiche vous demander de spcifier le composant de connexion que vous souhaitez
utiliser.

2. Slectionnez le composant de connexion tMysqlConnection_1 et cliquez sur OK.

Les donnes lues depuis la base de donnes project_q1 s'affichent dans la console Run.

868 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Lire des donnes dans des bases de donnes MySQL l'aide de connexions dynamiques bases sur les variables de contexte

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.

Guide de rfrence des Composants de Talend Open Studio 869


tMysqlLastInsertId

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].
Component list Slectionnez le composant tMysqlConnection dans la liste s'il y a
plus d'une connexion dans votre Job.
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 NB_LINE : nombre de lignes traites. Cette variable est une variable After et retourne un entier.

870 Guide de rfrence des Composants de Talend Open Studio


Scnario : Rcuprer les ID des dernires entres ajoutes

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).

Scnario : Rcuprer les ID des dernires entres


ajoutes
Le scnario Java suivant permet d'ouvrir une connexion une base de donnes MySQL, d'y crire des donnes
spcifies et enfin de rcuprer les derniers ID ajouts la connexion existante.

Cliquez sur chacun des composants suivants et dposez-les dans l'diteur graphique : tMysqlConnection,
tMysqlCommit, tFileInputDelimited, tMysqlOutput, tMysqlLastInsertId, et tLogRow.

Reliez le tMysqlConnection au tFileInputDelimited l'aide d'un lien OnSubjobOk.

Reliez le tFileInputDelimited au tMysqlCommit l'aide d'un lien OnSubjobOk.

Reliez les trois derniers composants au tFileInputDelimited et entre eux l'aide de liens Row Main, comme
suit :

Guide de rfrence des Composants de Talend Open Studio 871


Scnario : Rcuprer les ID des dernires entres ajoutes

Slectionnez le tMysqlConnection en cliquant dessus partir de l'diteur graphique.

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.

Slectionnez le tFileInputDelimited en cliquant dessus partir de l'diteur graphique.

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.

872 Guide de rfrence des Composants de Talend Open Studio


Scnario : Rcuprer les ID des dernires entres ajoutes

Cliquez sur le bouton [...] ct de la mention Edit Schema pour dfinir les donnes passer au composant
suivant.

Sujets associs : consultez le Guide utilisateur du Studio Talend.

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.

Slectionnez le tMysqlOutput en cliquant dessus partir de l'diteur graphique.

Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).

Cochez la case Use an existing connection.

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.

Guide de rfrence des Composants de Talend Open Studio 873


Scnario : Rcuprer les ID des dernires entres ajoutes

Slectionnez le tMysqlLastInsertId en cliquant dessus partir de l'diteur graphique.

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.

874 Guide de rfrence des Composants de Talend Open Studio


Scnario : Rcuprer les ID des dernires entres ajoutes

Sauvegardez votre Job puis appuyez sur F6 pour l'excuter.

Le composant tMysqlLastInsertId affiche les dernires ID ajoutes pour chaque ligne de la connexion existante.

Guide de rfrence des Composants de Talend Open Studio 875


tMysqlOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
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.
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 :

Default : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

876 Guide de rfrence des Composants de Talend Open Studio


Proprits du tMysqlOutput

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear a table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de


Rollback.
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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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.

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 cochez 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
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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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

Guide de rfrence des Composants de Talend Open Studio 877


Proprits du tMysqlOutput

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 source Cochez cette case et spcifiez l'alias de la source de donnes cre dans Talend Runtime pour
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.

Si vous utilisez la configuration de la base de donnes du composant, la connexion


votre source de donnes se ferme la fin du composant. Pour empcher la fermeture
de la connexion, utilisez une connexion partage la base de donnes, avec l'alias
de la source de donnes spcifi.

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 /*+ */.

- POSITION : spcifiez la place de l'indicateur dans une instruction SQL.

- SQL STMT : slectionnez l'instruction SQL que vous souhaitez utiliser.


Enable debug mode Cochez cette case pour afficher chaque tape du processus d'criture dans la base de donnes.
Use duplicate key Met jour les valeurs des colonnes spcifies en cas de doublon de la cl primaire.
update mode insert
Column : Saisissez entre guillemets le nom de la colonne mettre jour.

878 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Ajouter une colonne et modifier les donnes

Value : Saisissez l'opration que vous souhaitez effectuer sur la colonne.

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).

Scnario 1 : Ajouter une colonne et modifier les


donnes
Ce scnario Java est un Job trois composants permettant de crer de manire alatoire des donnes de test l'aide
du composant tRowGenerator, dupliquer la colonne modifier l'aide du composant tMap et de modifier les
donnes insrer en utilisant une expression SQL dans le composant tMysqlOutput.

Cliquez et dposez les composants suivants dans l'diteur graphique : tRowGenerator, tMap et tMysqlOutput.

Connectez-les l'aide de liens Row Main.

Guide de rfrence des Composants de Talend Open Studio 879


Scnario 1 : Ajouter une colonne et modifier les donnes

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 OK pour fermer la bote de dialogue.

Cliquez sur le bouton [...] ct du champ RowGenerator Editor pour ouvrir l'diteur du tRowGenerator
pour paramtrer les donnes gnrer.

880 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Ajouter une colonne et modifier les donnes

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.

Guide de rfrence des Composants de Talend Open Studio 881


Scnario 1 : Ajouter une colonne et modifier les donnes

Cliquez sur OK pour fermer l'diteur.

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.

882 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Ajouter une colonne et modifier les donnes

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.

-Saisissez One_Month_Later dans la cellule Name.

-Dans la cellule SQL expression, saisissez la requte SQL ajoutant un mois, dans ce scnario :
"adddate(Random_date, interval 1 month)".

-Slectionnez Replace dans la liste Position.

-Slectionnez Random_date1 dans la liste Reference column.


Pour ce Job, vous dupliquez la colonne random_date_1 dans la table avant de la remplacer par la colonne One_Month_Later.
Le but de cette manipulation tait de voir les modifications apportes en amont.

Enregistrez le Job et appuyez sur F6 pour l'excuter.

La nouvelle colonne One_month_later remplace la colonne random_date1 dans la base de donnes et ajoute un
mois chaque date gnre alatoirement.

Guide de rfrence des Composants de Talend Open Studio 883


Scnario 2 : Effectuer des mises jour dans une base de donnes

Voir galement Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion
ODBC du composant tDBOutput.

Scnario 2 : Effectuer des mises jour dans une base


de donnes
Ce scnario Java est un Job deux composants permettant de mettre jour les donnes d'une table MySQL
partir d'un fichier dlimit.

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.

884 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Effectuer des mises jour dans une base de donnes

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 :

Guide de rfrence des Composants de Talend Open Studio 885


Scnario 2 : Effectuer des mises jour dans une base de donnes

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 Table, saisissez le nom de la table mettre jour.

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.

Enregistrez le Job puis appuyez sur F6 pour l'excuter.

886 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject

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.

Scnario 3 : Rcuprer les donnes errones l'aide


d'un lien Reject
Ce scnario dcrit un Job quatre composants effectuant une migration d'un fichier client vers la table d'une base
de donnes MySQL et redirigeant les donnes errones vers un fichier CSV l'aide d'un lien Reject.

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.

Guide de rfrence des Composants de Talend Open Studio 887


Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject

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.

Dans le Repository, dveloppez le nud Metadata et Db Connections, et slectionnez la mtadonne de


connexion la base de donnes dans laquelle vous souhaitez migrer vos donnes et glissez-la dans l'espace de
modlisation. Dans la bote de dialogue [Components], slectionnez tMysqlOutput et cliquez sur OK. Les
proprits de connexion la base de donnes seront automatiquement renseignes.

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.

Pour plus d'informations, consultez le Guide utilisateur du Studio Talend.

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.

Double-cliquez sur le composant customers 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 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.

Le schma se prsente comme suit :

888 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject

Double-cliquez sur le tMap afin d'ouvrir son diteur.

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.

Guide de rfrence des Composants de Talend Open Studio 889


Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject

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.

Cliquez sur OK.

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.

Dans la liste Action on data, slectionnez l'option Create table.

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.

890 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject

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.

Enregistrez votre Job et appuyez sur F6 pour l'excuter.

Guide de rfrence des Composants de Talend Open Studio 891


Scnario 3 : Rcuprer les donnes errones l'aide d'un lien Reject

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.

892 Guide de rfrence des Composants de Talend Open Studio


tMysqlOutputBulk

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.

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.

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.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/


Verifying+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en
mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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

Guide de rfrence des Composants de Talend Open Studio 893


Scnario : Insrer des donnes transformes dans une base MySQL

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 settings Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
Field separator Caractre, chane ou expression rgulire sparant les champs.
Text enclosure Caractres utiliss pour entourer le texte.
Create directory if does Cette case est coche par dfaut. Cette option permet de crer le dossier
not exist contenant le fichier de sortie s'il n'existe pas dj.
Custom the flush buffer Cochez cette case pour personnaliser la taille de la mmoire utilise pour
size stocker temporairement les donnes, et dans le champ Row number,
saisissez le nombre de lignes aprs lesquelles la mmoire est nouveau
libre.
Records contain NULL Cette case est coche par dfaut. Elle permet de prendre les champs de
value valeur NULL en compte. Si vous la dcochez, les valeurs NULL seront
remplaces par des valeurs vides.
Check disk space Cochez cette case afin de retourner une exception durant l'excution si
le disque est plein.
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.
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 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.

Scnario : Insrer des donnes transformes dans


une base MySQL
Ce scnario dcrit un Job contenant quatre composants dont le but est d'alimenter un base MySQL partir d'un
fichier paramtres contenant des donnes transformes. Deux tapes sont requises pour ce Job, d'une part pour crer

894 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes transformes dans une base MySQL

le fichier paramtres qui sera utilis dans un second temps. La premire tape inclut une phase de transformation
des donnes contenues dans le fichier.

Dposer et relier les composants


1. Glissez et dposez les composants suivants : tRowGenerator, tMap, tMysqlOutputBulk et
tMysqlBulkExec dans l'espace de modlisation.

2. Connectez le flux principal l'aide de connexions Row > Main.

3. Connectez le composant de dbut (tRowGenerator, dans cet exemple) au composant tMysqlBulkExec


l'aide d'une connexion Trigger de type OnSubjobOk.

Configurer les composants


1. Un composant tRowGenerator est utilis pour gnrer des donnes de faon alatoire. Double-cliquez sur
le composant tRowGenerator pour lancer l'diteur.

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).

Guide de rfrence des Composants de Talend Open Studio 895


Scnario : Insrer des donnes transformes dans une base MySQL

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.

Cliquez sur OK pour valider la transformation.

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.

896 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes transformes dans une base MySQL

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.

9. Cliquez sur OK pour valider la sortie.

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.

Sauvegarder et 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.

Guide de rfrence des Composants de Talend Open Studio 897


Scnario : Insrer des donnes transformes dans une base MySQL

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.

Voir galement Proprits du tMysqlOutputBulkExec.

898 Guide de rfrence des Composants de Talend Open Studio


tMysqlOutputBulkExec

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.

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.
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 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.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes
de la table slectionne :

None : n'effectue aucune action sur la table.

Drop and create table : supprime la table puis en crer une nouvelle.

Create table : cre une table qui n'existe pas encore.

Create table if not exists : cre la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe


dj, puis en crer une nouvelle.

Clear table : supprime le contenu de la table.


Table Nom de la table crire.

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.

Ce fichier est gnr sur la mme machine que le Studio Talend ou


que le Job contenant un tMysqlOutputBulkExec, puis charg dans
la base de donnes spcifie dans le champ Host.

Guide de rfrence des Composants de Talend Open Studio 899


Proprits du tMysqlOutputBulkExec

Append Cochez cette option pour ajouter de 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
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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
Advanced settings Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires
Parameters la connexion la base de donnes.

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.
Field separator Caractre, chane ou expression rgulire sparant les champs.
Text enclosure Caractres entourant les donnes.
Create directory if not exists Cette case est coche par dfaut. Cette option permet de crer le
dossier contenant le fichier de sortie s'il n'existe pas dj.
Custom the flush buffer size Cochez cette case pour personnaliser la taille de la mmoire utilise
pour stocker temporairement les donnes, et dans le champ Row
number, saisissez le nombre de lignes aprs lesquelles la mmoire
est nouveau libre.
Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la
table slectionne :

Insert records in table : Insre de nouveaux enregistrements dans


une table.

Replace records in table : Remplace les enregistrements existants


par de nouveaux.

Update records in table : Modifie les enregistrements existants.

Ignore records in table : Ignore les enregistrements existants ou


insre les nouveaux.

900 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes dans une base MySQL

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.

Scnario : Insrer des donnes dans une base MySQL


Ce scnario est un Job deux composants qui effectue le mme type d'opration d'alimentation que les composants
tMysqlOutputBulk (consultez tMysqlOutputBulk) et tMysqlBulkExec (consultez tMysqlBulkExec), mais sans
transformation de donnes.

Cliquez et dposez les composants suivants : tRowGenerator et tMysqlOutputBulkExec.

Connectez les composants via un lien de type Row > Main.

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.

A partir de l'espace de modlisation, double-cliquez sur le composant tMysqlOutputBulkExec pour afficher


la vue Component et paramtrer ses proprits.

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.

Pour plus d'informations, consultez le Guide utilisateur du Studio Talend.

Guide de rfrence des Composants de Talend Open Studio 901


Scnario : Insrer des donnes dans une base MySQL

Dans le champ Action on table, slectionnez l'option None puisque vous souhaitez insrer les donnes dans
une table dj existante.

Dans le champ Table, saisissez le nom de la table alimenter, ici, clients.

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.

Appuyez sur F6 pour excuter le Job

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.

902 Guide de rfrence des Composants de Talend Open Studio


tMysqlRollback

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).

Scnario : Annuler l'insertion de donnes dans des


tables mre/fille
En vous basant sur Scnario 1 : Insrer des donnes dans des tables mre/fille du composant tMysqlConnection,
insrez une opration de rollback (annulation) afin d'viter un commit inutile.

Guide de rfrence des Composants de Talend Open Studio 903


Scnario : Annuler l'insertion de donnes dans des tables mre/fille

1. Glissez-dposez un tMysqlRollback de la Palette dans l'espace de modlisation graphique.

2. Connectez le tFileList au tMysqlRollback l'aide d'un lien OnSubjobError.

3. Double-cliquez sur le tMysqlRollback afin d'ouvrir sa vue Basic settings.

4. Dans la liste Component List, slectionnez le composant de connexion utiliser.

Le tMysqlRollback assure que la transaction ne sera pas commite partiellement.

904 Guide de rfrence des Composants de Talend Open Studio


tMysqlRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

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.
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.
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.

Guide de rfrence des Composants de Talend Open Studio 905


Proprits du tMysqlRow

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 :

View schema : slectionnez cette option afin de voir le schma.

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 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.

Si vous utilisez la configuration de la base de donnes du composant, la


connexion votre source de donnes se ferme la fin du composant. Pour
empcher la fermeture de la connexion, utilisez une connexion partage la
base de donnes, avec l'alias de la source de donnes spcifi.

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 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
PreparedStatement base 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

906 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Supprimer et re-gnrer un index de table MySQL

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).

Scnario 1 : Supprimer et re-gnrer un index de table


MySQL
Le scnario suivant cre un Job quatre composants permettant de supprimer un index de table, effectuer un Insert
dans cette table avant de re-gnrer l'index.

Relier les composants


1. Slectionnez les composants suivants dans la Palette et dposez-le dans l'espace de modlisation : deux
tMysqlRow, un tRowGeneratoret un tMysqlOutput.

2. Connectez le premier composant tMysqlRow au tRowGenerator l'aide d'un lien OnComponentOk.

3. Reliez le tRowGenerator au tMysqlOutput l'aide d'un lien Row > Main.

Guide de rfrence des Composants de Talend Open Studio 907


Scnario 1 : Supprimer et re-gnrer un index de table MySQL

4. Connectez le composant tRowGenerator au second composant tMysqlRow l'aide d'une connexion


OnSubjobOk.

Configurer les composants


1. Slectionnez le composant tMysqlRow et renseignez les proprits de la base de donnes dans l'onglet Basic
settings.

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.

3. Propagez les informations de proprits et de schma aux autres composants du Job.

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>

5. Slectionnez le deuxime composant tMysqlRow, vrifiez ses proprits et son schma.

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.

7. Slectionnez le composant tMysqlOutput et renseignez les proprits de connexion la base de donnes


soit partir du Repository ou manuellement si les informations de connexion ne sont utilises que pour ce
Job. La table alimenter a pour nom : comprehensive.

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.

Aucune colonne supplmentaire n'est requise pour ce Job.

908 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Utiliser l'instance PreparedStatement pour faire une requte sur des donnes

Excuter le Job
1. Appuyez sur les touches Ctrl+S pour sauvegardez le Job.

2. Appuyez sur F6 pour excuter ce 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.

Voir galement tDBSQLRow.

Scnario 2 : Utiliser l'instance PreparedStatement


pour faire une requte sur des donnes
Le scnario suivant dcrit un Job quatre composants permettant de lier la colonne d'une table un fichier clients.
En effet, la table MySQL contient la liste de tous les Etats amricains avec leur identifiant, et le fichier contient
des informations sur vos clients avec l'identifiant de l'tat dans lequel ils rsident. L'objectif de ce scnario est de
rcuprer le nom de l'Etat pour chaque client l'aide d'une requte SQL. Afin de traiter un grand nombre de donnes
plus rapidement, utilisez l'objet PreparedStatement permettant de n'excuter qu'une seule fois la requte au lieu de
l'effectuer chaque ligne. Chaque ligne de donnes est envoye comme paramtre. Un objet PreparedStatement
peut galement tre utilis pour viter une injection SQL.

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.

A partir du Repository, dveloppez le nud Metadata et File delimited

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.

Guide de rfrence des Composants de Talend Open Studio 909


Scnario 2 : Utiliser l'instance PreparedStatement pour faire une requte sur des donnes

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.

A partir de la Palette, slectionnez les composants tMysqlRow, tParseRecordSet et tFileOutputDelimited


et glissez-les dans l'espace de modlisation.

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.

910 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Utiliser l'instance PreparedStatement pour faire une requte sur des donnes

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.

Guide de rfrence des Composants de Talend Open Studio 911


Scnario 2 : Utiliser l'instance PreparedStatement pour faire une requte sur des donnes

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.

Cliquez sur le bouton [+] pour ajouter un paramtre.

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.

912 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Utiliser l'instance PreparedStatement pour faire une requte sur des donnes

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.

Enregistrez votre Job et appuyez sur F6 pour l'excuter.

Guide de rfrence des Composants de Talend Open Studio 913


Scnario 3 : Combiner deux flux pour une sortie slective

Une colonne contenant le nom de l'Etat amricain correspondant chaque client a t ajoute au fichier.

Scnario 3 : Combiner deux flux pour une sortie


slective
Dans ce scnario, un flux gnr par un tFixedFlowInput est combin avec un flux de la base de donnes MySQL.
Le flux source contient les champs id et age alors que la table MySQL contient id et name. Vous allez rcuprer
les donnes age du flux source et les combiner avec les enregistrements id et name de la table MySQL partir de
la mise en correspondance avec id. Le schma d'entre est diffrent de celui de sortie, dans le tMysqlRow.

Relier les composants


1. Dposez un tFixedFlowInput, un tMysqlRow, un tParseRecordSet et un tLogRow de la Palette dans
l'espace de modlisation graphique.

2. Renommez le tFixedFlowInput en source_flow, le tMysqlRow en insert_recordset, le tParseRecordSet


en parse_recordset et le tLogRow en show_combined_flow.

3. Reliez le tFixedFlowInput au tMysqlRow l'aide d'un lien Row > Main.

4. Reliez le tMysqlRow au tParseRecordSet l'aide d'un lien Row > Main.

5. Connectez le tParseRecordSet au tLogRow l'aide d'un lien Row > Main.

Configurer les composants


1. Double-cliquez sur le tFixedFlowInput pour ouvrir sa vue Basic settings.

914 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Combiner deux flux pour une sortie slective

2. Slectionnez l'option Use Inline Content (delimited file) dans la zone Mode.

Dans le champ Content, saisissez les donnes transfrer :

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.

Cliquez sur OK pour fermer l'diteur.

4. Double-cliquez sur le tMysqlRow pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 915


Scnario 3 : Combiner deux flux pour une sortie slective

5. Dans les champs Host et Port, saisissez les informations de connexion.

Dans le champ Database, saisissez le nom de la base de donnes.

Dans les champs Username et Password, saisissez les informations d'authentification.

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=?".

Le point d'interrogation, "?" reprsente le paramtre configurer l'onglet Advanced settings.

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.

Cliquez sur OK pour fermer l'diteur.

8. Cliquez sur l'onglet Advanced settings afin de configurer les paramtres avancs.

916 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Combiner deux flux pour une sortie slective

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.

10. Cliquez sur le bouton [+] pour ajouter une ligne.

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.

Guide de rfrence des Composants de Talend Open Studio 917


Scnario 3 : Combiner deux flux pour une sortie slective

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.

Cliquez sur OK pour fermer l'diteur.

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".

13. Double-cliquez sur le tLogRow pour ouvrir sa vue Basic settings.

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.

2. Appuyez sur F6 pour excuter le Job.

918 Guide de rfrence des Composants de Talend Open Studio


Scnario 3 : Combiner deux flux pour une sortie slective

Guide de rfrence des Composants de Talend Open Studio 919


tMysqlSCD

tMysqlSCD

Le composant tMysqlSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus
d'informations, consultez tMysqlSCD.

920 Guide de rfrence des Composants de Talend Open Studio


tMysqlSCDELT

tMysqlSCDELT

Le composant tMysqlSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tMysqlSCDELT.

Guide de rfrence des Composants de Talend Open Studio 921


tMysqlSP

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.

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 connection Cochez cette case lorsque vous utilisez le composant
tMysqlConnection.
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 Password Informations d'authentification sur 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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

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].

922 Guide de rfrence des Composants de Talend Open Studio


Scnario : Trouver le libell State l'aide d'une procdure stocke

SP Name Saisissez le nom exact de la Procdure Stocke (SP).


Is Function / Return result in Cochez cette case, si une seule valeur doit tre retourne.

Slectionnez dans la liste la colonne du schma sur laquelle est base


la valeur obtenir.
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.

Slectionnez le Type de paramtre :

IN : paramtre d'entre (Input).

OUT : paramtre de sortie (Output)/valeur retourne.

IN OUT : les paramtres d'entre doivent tre retourns sous forme


de valeur, mme aprs modifications via la procdure (fonction).

RECORDSET : les paramtres d'entre doivent tre retourns 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.
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 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.

Scnario : Trouver le libell State l'aide d'une


procdure stocke
Le Job suivant a pour but de trouver les libells State en fonction des ID impairs de la colonne State d'une table
MySQL deux colonnes l'aide d'une procdure stocke.

Guide de rfrence des Composants de Talend Open Studio 923


Scnario : Trouver le libell State l'aide d'une procdure stocke

Cliquez et dposez les composants suivants dans l'espace de modlisation : tRowGenerator, tMysqlSP et
tLogRow.

Connectez les composants l'aide d'une connexion de type Row Main.

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).

Dans le champ Length, la longueur est de 2 chiffres au maximum.

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.

924 Guide de rfrence des Composants de Talend Open Studio


Scnario : Trouver le libell State l'aide d'une procdure stocke

Cliquez sur OK pour valider la configuration.

Puis slectionnez le composant tMysqlSP et paramtrez ses proprits.

Dans le champ Property type, slectionnez l'option Repository puis slectionnez l'entre correspondante dans
la liste. Les informations de connexion sont remplies automatiquement.

Sinon, paramtrez les informations de connexion manuellement.

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.

Slectionnez le type d'encodage dans la liste.

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.

Et enfin, paramtrez les proprits du composant tLogRow.

Guide de rfrence des Composants de Talend Open Studio 925


Scnarios associs

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.

Puis enregistrez votre Job et excutez-le.

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 :

Scnario : Rcuprer des informations personnelles l'aide d'une procdure stocke.

Scnario : Vrifier le format de numros l'aide d'une procdure stocke.

Scnario : Excuter une procdure stocke dans le hub MDM.

926 Guide de rfrence des Composants de Talend Open Studio


tMysqlTableList

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).

Guide de rfrence des Composants de Talend Open Studio 927


Scnario : Effectuer une opration d'itration sur des tables et en effacer le contenu grce un modle SQL dfini par l'utilisateur (SQL
Template)

Scnario : Effectuer une opration d'itration sur des


tables et en effacer le contenu grce un modle SQL
dfini par l'utilisateur (SQL Template)
Le scnario Java suivant dcrit un Job trois composants qui permet d'effectuer une opration d'itration, dans les
tables spcifies d'une base de donnes MySQL, en utilisant une clause de type WHERE. Le Job permet ensuite
d'effacer le contenu de ces tables directement sur le SGBD grce un modle SQL (SQL Template) dfini par
l'utilisateur.

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.

La bote de dialogue [Components] s'affiche l'cran.

Slectionnez le composant tMysqlConnection puis cliquez sur OK.

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.

928 Guide de rfrence des Composants de Talend Open Studio


Scnario : Effectuer une opration d'itration sur des tables et en effacer le contenu grce un modle SQL dfini par l'utilisateur (SQL
Template)

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.

A partir de cette liste de variables, slectionnez


((String)globalMap.get("tMysqlTableList_1_CURRENT_TABLE")).

Guide de rfrence des Composants de Talend Open Studio 929


Scnario : Effectuer une opration d'itration sur des tables et en effacer le contenu grce un modle SQL dfini par l'utilisateur (SQL
Template)

Comment crer votre propre modle SQL (SQL Template) :

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.

L'assistant [New SQLTemplate]s'affiche l'cran.

930 Guide de rfrence des Composants de Talend Open Studio


Scnario : Effectuer une opration d'itration sur des tables et en effacer le contenu grce un modle SQL dfini par l'utilisateur (SQL
Template)

Saisissez un nom pour le nouveau modle (SQL template) et remplissez les autres champs si ncessaire, puis
cliquez sur Finish pour fermer l'assistant.

L'diteur de modle SQL s'affiche dans l'diteur graphique.

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.

Guide de rfrence des Composants de Talend Open Studio 931


Scnario associ

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.

Assurez-vous que le modle de la seconde ligne est bien en mode Commit.

Enregistrez le Job et appuyez sur F6 pour l'excuter.

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.

932 Guide de rfrence des Composants de Talend Open Studio


tOleDbInput

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 :

View schema : slectionnez cette option afin de voir le schma.

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 Saisissez le nom de table traiter.
Query Type Slectionnez le type de requte Built-in ou Repository dans la liste droulante.

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.

Guide de rfrence des Composants de Talend Open Studio 933


Scnario associ

Trim column Cochez cette case dans la colonne Trim pour supprimer les espaces en dbut
et en fin de champ dans les colonnes correspondantes.

Ce champ apparat uniquement lorsque la case Trim all the String/Char


columns est dcoche.
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.

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.

934 Guide de rfrence des Composants de Talend Open Studio


tOleDbOutput

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.

Insert : insrer des donnes.

Update : mettre jour des donnes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec


la rfrence donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si


l'enregistrement n'existe pas, un nouvel enregistrement est insr.

Delete : supprimer des donnes.

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 cochez 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 table Cochez cette case pour supprimer les donnes dans la table dfinie avant toute
opration.
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 :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 935


Proprits du tOleDbOutput

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 settings Additional columns 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 des donnes dans les colonnes correspondantes.

Position : Slectionnez Before, After or Replace, en fonction de l'action


effectuer sur la colonne de rfrence.

Reference column : Saisissez une colonne de rfrence utilise pour situer


ou remplacer une nouvelle colonne ou celle modifier.

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.

Key in update : dfinir la cl primaire utiliser lors d'une opration de mise


jour.

Key in delete : dfinir la cl primaire utiliser lors d'une opration de


suppression.

Updatable : dfinir la ou les colonne(s) mettre jour.

Insertable : dfinir la ou les colonne(s) insrer.

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.

936 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez 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.

Guide de rfrence des Composants de Talend Open Studio 937


tOleDbRow

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 :

View schema : slectionnez cette option afin de voir le schma.

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.
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.

938 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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 PreparedStatement Cochez cette case pour utiliser une instance PreparedStatement afin de requter
votre base 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

Guide de rfrence des Composants de Talend Open Studio 939


tOracleBulkExec

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
Connection type Liste droulante des pilotes disponibles:

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.

940 Guide de rfrence des Composants de Talend Open Studio


Proprits du tOracleBulkExec

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.
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 :

None : n'effectuer aucune opration de table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de


Rollback.
Data file name Nom du fichier charger.

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.

Update : Mettre jour les entres existantes.

Append : Ajouter des lignes aux donnes dj existantes.

Replace : Ecraser des lignes de la table.

Truncate : Supprimer les entres correspondant au flux d'entre.

Il est ncessaire de spcifier au minimum une cl de recherche sur laquelle baser


les oprations d'Update. Il est possible de dfinir les colonnes qui agiront comme
cl de recherche partir du schma, pour une utilisation de base, ou partir
des options avances (Advanced settings) pour une utilisation optimise de ces
oprations.
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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Guide de rfrence des Composants de Talend Open Studio 941


Proprits du tOracleBulkExec

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Advanced Advanced separator (for Cochez cette option pour modifier les sparateurs utiliss pour les nombres :
settings numbers)
Thousands separator : dfinissez le sparateur utilis pour les milliers.

Decimal separator : dfinissez le sparateur utilis pour les dcimaux.


Use existing control file Cochez cette case si vous utilisez un fichier de contrle (.ctl) et spcifiez son chemin d'accs
dans le champ .ctl file name.
Record format Dfinissez le format de l'enregistrement :

Default : les paramtres du format sont dfinis par dfaut.

Stream : dterminez le sparateur de fin d'enregistrement.

Fixed : dterminez la longueur d'enregistrement.

Variable : dterminez la taille du champ spcifiant la longueur de l'enregistrement.


Specify .ctl file's INTO Cochez cette case pour renseigner manuellement la clause INTO TABLE du fichier de
TABLE clause manually contrle, directement dans le code.
Fields terminated by Caractre, chane ou expression rgulire sparant les champs :

None : aucun caractre de sparation.

Whitespace : le caractre de sparation est un espace.

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 :

Parameter : choisissez l'un des paramtres de chargement partir de la liste droulante.

Value : dfinissez la valeur attribuer au paramtre.


NLS Language A partir de la liste droulante, dfinissez la langue utilise pour les donnes qui ne sont pas
codes en Unicode.
Set Parameter Cochez cette case pour modifier les conventions d'appellation utilises pour la numrotation
NLS_TERRITORY des jours et des semaines. La valeur par dfaut est celle du systme d'exploitation.
Encoding Slectionnez l'encodage dans la liste ou saisissez-le entre guillemets doubles si le type
d'encodage utilis n'existe pas dans la liste. Ce champ est obligatoire pour la gestion de
donnes de bases de donnes.
Output Slectionnez la sortie utiliser pour rcuprer la sortie standard de la base Oracle :

to console : vers la console.

942 Guide de rfrence des Composants de Talend Open Studio


Scnario : Supprimer et insrer des donnes dans une base Oracle

to global variable : vers la variable globale.


Convert columns and Cochez cette case pour mettre le nom des colonnes et celui de la table en majuscules.
table names to
uppercase
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_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.

Scnario : Supprimer et insrer des donnes dans une


base Oracle
Ce scnario dcrit comment supprimer le contenu d'une base de donnes Oracle et insrer de nouvelles donnes
partir du contenu d'un fichier d'entre. Le Job est constitu de trois composants qui crent le contenu, le transfrent
dans un fichier qui sera ensuite charg dans la base Oracle aprs suppression des donnes de la table.

Construire le Job
1. Cliquez et dposez les composants suivants de la Palette dans l'espace de modlisation graphique :
tOracleInput, tFileOutputDelimited et tOracleBulkExec.

Guide de rfrence des Composants de Talend Open Studio 943


Scnario : Supprimer et insrer des donnes dans une base Oracle

2. Connectez le composant tOracleInput au tFileOutputDelimited l'aide d'un lien Row > Main.

3. Reliez le tOracleInput au tOracleBulkExec l'aide d'un lien OnSubjobOk.

Configurer les composants


1. Paramtrez les informations de connexion la base de donnes Oracle. Il est conseill de stocker ces
informations dans une mtadonne du Repository pour pouvoir les rutiliser par la suite dans tous vos Jobs.

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.

944 Guide de rfrence des Composants de Talend Open Studio


Scnario : Supprimer et insrer des donnes dans une base Oracle

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.

Guide de rfrence des Composants de Talend Open Studio 945


Scnario : Supprimer et insrer des donnes dans une base Oracle

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.

946 Guide de rfrence des Composants de Talend Open Studio


tOracleClose

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.

Pour un scnario associ au composant tOracleClose, consultez tMysqlConnection.

Guide de rfrence des Composants de Talend Open Studio 947


tOracleCommit

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.

Si vous utilisez un lien de type Row >Main pour relier le


tOracleCommit votre Job, vos donnes seront commites
ligne par ligne. Dans ce cas, ne cochez pas la case Close
connection car la connexion sera ferme avant la fin du
commit de votre premire ligne.
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 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.

948 Guide de rfrence des Composants de Talend Open Studio


tOracleConnection

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

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:

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.
Use tns file Cochez cette case pour utiliser les mtadonnes d'un contexte
contenu dans un fichier Tns.

Un mme fichier Tns peut contenir plusieurs contextes.

TNS File : Renseignez manuellement le chemin d'accs ou cliquez


sur le bouton [...] pour parcourir vos dossiers jusqu'au fichier Tns
utiliser.

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.

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

Guide de rfrence des Composants de Talend Open Studio 949


Scnario associ

mot de passe entre guillemets doubles, puis cliquez sur OK afin de


sauvegarder les paramtres.
Additional JDBC Spcifiez des informations supplmentaires de connexion la base
parameters de donnes cre.

Dans ce champ, vous pouvez paramtrer le type


d'encodage.
Use or register a shared DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
Specify a data source alias Cochez cette case et spcifiez l'alias de la source de donnes
cre dans 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.
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.

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus despace pour grer vos
transactions dans un Job, il est recommand d'utiliser un composant
Commit.
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement du
Job au niveau du Job ainsi qu'au niveau de chaque composant.
Utilisation Ce composant est gnralement utilis avec des composants Oracle, notamment les composants
tOracleCommit 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 tOracleConnection, consultez tMysqlConnection.

950 Guide de rfrence des Composants de Talend Open Studio


tOracleInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
Connection type Liste droulante des pilotes disponibles:

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.

Guide de rfrence des Composants de Talend Open Studio 951


Proprits du tOracleInput

Oracle schema Nom du schma Oracle.


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 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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Si vous utilisez la configuration de la base de donnes du composant, la connexion


votre source de donnes se ferme la fin du composant. Pour empcher la fermeture
de la connexion, utilisez une connexion partage la base de donnes, avec l'alias
de la source de donnes spcifi.

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.

952 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser les paramtres de contexte lors de la lecture d'une table d'une base de donnes Oracle

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.

Scnario : Utiliser les paramtres de contexte lors de


la lecture d'une table d'une base de donnes Oracle
Dans ce scnario, une table est lue dans une base de donnes Oracle, l'aide d'un paramtre de contexte pour
rfrer au nom de la table.

Dposer et relier les composants


1. Crez un nouveau Job et ajoutez les composants suivants en saisissant leur nom dans l'espace de modlisation
graphique et en les dposant depuis la Palette : un tOracleInput et un tLogRow.

2. Reliez le tOracleInput au tLogRow via un lien Row > Main.

Configurer les composants


1. Double-cliquez sur le tOracleInput pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 953


Scnario : Utiliser les paramtres de contexte lors de la lecture d'une table d'une base de donnes Oracle

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.

Dans les champs Username et Password, saisissez les informations d'authentification.

3. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir l'diteur du schma.

954 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser les paramtres de contexte lors de la lecture d'une table d'une base de donnes Oracle

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.

Guide de rfrence des Composants de Talend Open Studio 955


Scnario : Utiliser les paramtres de contexte lors de la lecture d'une table d'une base de donnes Oracle

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.

7. Clique sur Finish pour valider.

La paramtre de contexte context.TABLE apparat automatiquement dans le champ Table Name.

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

9. Double-cliquez sur le tLogRow afin d'ouvrir sa vue Basic settings.

10. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un meilleur affichage des
rsultats.

Sauvegarder et excuter le Job


1. Appuyez sur les touches Ctrl+S afin de sauvegarder le Job.

2. Appuyez sur F6 pour excuter le Job.

Comme affich dans la capture d'cran, les donnes dans la table de la base de donnes Oracle PERSON sont
affiches dans la console.

956 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Scnarios associs
Consultez les scnarios associs :

Scnario 1 : Afficher les donnes slectionnes partir d'une table du composant tDBInput.

Scnario 2 : Utiliser la variable StoreSQLQuery 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.

Guide de rfrence des Composants de Talend Open Studio 957


tOracleOutput

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 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
connection de la 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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion
crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion


travers diffrents niveaux de Jobs, consultez le Guide utilisateur du
Studio Talend.
Connection type Liste droulante des pilotes disponibles:

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.

958 Guide de rfrence des Composants de Talend Open Studio


Proprits du tOracleOutput

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 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.
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 :

Default : n'effectuer aucune opration de table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en
crer une nouvelle.

Clear table : supprimer le contenu de la table.

Truncate table : supprimer le contenu de la table, mais sans possibilit de


Rollback.

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 une option diffrente de Default dans la liste Action on
table, une instruction de commit est gnre automatiquement, avant
l'opration d'insertion/mise jour/suppression 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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la


rfrence donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si


l'enregistrement n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondant au flux d'entre.

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).

Guide de rfrence des Composants de Talend Open Studio 959


Proprits du tOracleOutput

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/


Verifying+default+values+in+a+retrieved+schema (en anglais).
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
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.

Si vous utilisez la configuration de la base de donnes du composant,


la connexion votre source de donnes se ferme la fin du
composant. Pour empcher la fermeture de la connexion, utilisez une
connexion partage la base de donnes, avec l'alias de la source
de donnes spcifi.

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.

Vous pouvez appuyer sur Ctrl+Espace afin d'accder une liste de


variables globales prdfinies.
Override any existing Cochez cette case pour craser les variables d'environnement NLS_LANG dj
NLS_LANG environment dfinies.
variable
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.
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

960 Guide de rfrence des Composants de Talend Open Studio


Proprits du tOracleOutput

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 /*+ */.

- POSITION : spcifiez o positionner le hint dans une instruction SQL.

- SQL STMT : slectionnez l'instruction SQL que vous devez utiliser.


Convert columns and Cochez cette case pour passer les noms de colonnes et de tables en majuscule.
table to uppercase
Enable debug mode Cochez cette case pour afficher chaque tape du processus de d'criture dans
la base de 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.
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.

Guide de rfrence des Composants de Talend Open Studio 961


Scnarios associs

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette 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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

962 Guide de rfrence des Composants de Talend Open Studio


tOracleOutputBulk

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.

Famille de composant Databases/Oracle


Fonction Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Oracle.
Objectif Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter 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.
File Name Nom du fichier gnrer.

Ce fichier est gnr sur la machine locale ou dans un


dossier partag sur le rseau local.
Create directory if not exists Cette option permet de crer le dossier contenant le fichier de
sortie s'il n'existe pas dj.
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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Guide de rfrence des Composants de Talend Open Studio 963


Scnarios associs

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.

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Advanced settings Advanced separator (for Cochez cette option pour modifier les sparateurs utiliss pour
numbers) les nombres :

Thousands separator : dfinissez le sparateur utilis pour les


milliers.

Decimal separator : dfinissez le sparateur utilis pour les


dcimaux.
Field separator Caractre, chane ou expression rgulire sparant les champs.
Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
Encoding Type 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.
Bulk file parameters Configurez les paramtres Buffer Size et StringBuilder Size afin
d'optimiser les performances selon la mmoire.
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 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 : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

964 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

Guide de rfrence des Composants de Talend Open Studio 965


tOracleOutputBulkExec

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion
crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion


travers diffrents niveaux de Jobs, consultez le Guide utilisateur du
Studio Talend.
Connection type Liste droulante des pilotes disponibles :

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 la base de donnes.

966 Guide de rfrence des Composants de Talend Open Studio


Proprits du tOracleOutputBulkExec

Seuls localhost, 127.0.0.1 ou l'adresse IP exacte de la machine locale permettent


un fonctionnement optimal. Le serveur de la base de donnes doit tre
install sur la mme machine que le Studio Talend ou le Job contenant un
tOracleOutputBulkExec.
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.
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 :

None : n'effectuer aucune opration de table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en
crer une nouvelle.

Clear table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans


possibilit de Rollback.
File Name Nom du fichier gnrer et charger.

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 :

Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte


des doublons.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la


rfrence donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si


l'enregistrement n'existe pas, un nouvel enregistrement est insr.

Truncate : Supprimer les entres correspondantes au flux d'entre.

Il est ncessaire de spcifier au minimum une cl de recherche sur


laquelle baser les oprations d'Update. Il est possible de dfinir les
colonnes qui agiront comme cl de recherche partir du schma,
pour une utilisation de base, ou partir des options avances
(Advanced settings) pour une utilisation optimise de ces oprations.
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.

Guide de rfrence des Composants de Talend Open Studio 967


Proprits du tOracleOutputBulkExec

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/


Verifying+default+values+in+a+retrieved+schema (en anglais).
Field separator Caractre, chane de caractres ou expression rgulire pour sparer les champs.
Advanced settings Advanced separator (for Cochez cette option pour modifier les sparateurs utiliss pour les nombres :
numbers)
Thousands separator : dfinissez le sparateur utilis pour les milliers.

Decimal separator : dfinissez le sparateur utilis pour les dcimaux.


Use existing control file Cochez cette case si vous utilisez un fichier de contrle (.ctl).
Record format Dfinissez le format de l'enregistrement :

Default : les paramtres du format sont dfinis par dfaut.

Stream : dterminez le sparateur de fin d'enregistrement.

Fixed : dterminez la longueur d'enregistrement.

Variable : dterminez la taille du champ spcifiant la longueur de


l'enregistrement.
Specify .ctl file's INTO Cochez cette case pour renseigner manuellement la clause INTO TABLE du
TABLE clause manually fichier de contrle, directement dans le code.
Fields terminated by Caractre, chane ou expression rgulire sparant les champs :

None : aucun caractre de sparation.

Whitespace : le caractre de sparation est un espace.

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.

968 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 :

Parameter : choisissez l'un des paramtres de chargement partir de la liste


droulante.

Value : dfinissez la valeur attribuer au paramtre.


NLS Language A partir de la liste droulante, dfinissez la langue utilise pour les donnes qui
ne sont pas codes en Unicode.
Set Parameter Cochez cette case pour modifier les conventions d'appellation utilises pour
NLS_TERRITORY la numrotation des jours et des semaines. La valeur par dfaut est celle du
systme d'exploitation.
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.
Oracle encoding type Slectionnez le type d'encodage spcifique Oracle pour le traitement des
donnes. Ce type d'encodage permet au tOracleOutputBulkExec de gnrer
correctement la commande Oracle de masse.
Output Slectionnez dans la liste droulante l'endroit o rediriger le flux de sortie :

to console : vers la console de log.

to global variable : vers une variable globale.


Convert columns and Cochez cette case pour mettre le nom des colonnes et celui de la table en
table names to uppercase majuscules.
Bulk file parameters Configurez les paramtres Buffer Size et StringBuilder Size afin d'optimiser
les performances selon la mmoire.
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 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 : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

Guide de rfrence des Composants de Talend Open Studio 969


tOracleRollback

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.

970 Guide de rfrence des Composants de Talend Open Studio


tOracleRow

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion
crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion


travers diffrents niveaux de Jobs, consultez le Guide utilisateur du
Studio Talend.
Connection type Liste droulante des pilotes disponibles:

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.

Guide de rfrence des Composants de Talend Open Studio 971


Proprits du tOracleRow

Database Nom de la base de donnes.


Schema Nom du schma Oracle.
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.
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 :

View schema : slectionnez cette option afin de voir le schma.

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.
Table name Nom de la table de base de donnes.
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.
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.

NONE : n'alimente pas la variable.

INSERTED : alimente la variable avec le nombre de lignes insres.

UPDATED : alimente la variable avec le nombre de lignes mises jour.

DELETED : alimente la variable avec le nombre de lignes supprimes.


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.

Si vous utilisez la configuration de la base de donnes du composant,


la connexion votre source de donnes se ferme la fin du
composant. Pour empcher la fermeture de la connexion, utilisez une
connexion partage la base de donnes, avec l'alias de la source
de donnes spcifi.

972 Guide de rfrence des Composants de Talend Open Studio


Proprits du tOracleRow

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.

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 PreparedStatement Cochez cette case pour utiliser une instance PreparedStatement afin de requter
votre base 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

Cette option est trs utile si vous devez effectuer de nombreuses


fois la mme requte. Elle permet un gain de performance. Vous
pouvez galement utiliser les PreparedStatement afin d'viter les
injections SQL. Pour un scnario utilisant cette fonctionnalit,
consultez Scnario 2 : Utiliser l'instance PreparedStatement pour
faire une requte sur des donnes.
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.

Guide de rfrence des Composants de Talend Open Studio 973


Scnario associ

Une variable Flow fonctionne durant l'excution d'un composant. Une variable After fonctionne aprs
l'excution d'un composant.

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace
pour accder la liste des variables. A partir de cette liste, vous pouvez 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 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du tMysqlRow.

Scnario 2 : Utiliser l'instance PreparedStatement pour faire une requte sur des donnes du tMysqlRow.

974 Guide de rfrence des Composants de Talend Open Studio


tOracleSCD

tOracleSCD

Le composant tOracleSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus
d'informations, consultez tOracleSCD.

Guide de rfrence des Composants de Talend Open Studio 975


tOracleSCDELT

tOracleSCDELT

Le composant tOracleSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tOracleSCDELT.

976 Guide de rfrence des Composants de Talend Open Studio


tOracleSP

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion
crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion


travers diffrents niveaux de Jobs, consultez le Guide utilisateur du
Studio Talend.
Connection type Liste droulante des pilotes disponibles:

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.
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.
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.

Guide de rfrence des Composants de Talend Open Studio 977


Proprits du tOracleSP

Username et Password Informations d'authentification sur 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.
Schema et Edit schema Dans une procdure stocke, le schma est un paramtre d'entre.

Un schma est une description de lignes, il dfinit le nombre de champs qui


sont traits et passs au composant suivant. Le schma 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 :

View schema : slectionnez cette option afin de voir le schma.

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
est rutilisable. Voir galement le Guide utilisateur du Studio Talend.
SP Name Saisissez le nom exact de la Procdure Stocke (SP).
Is Function / Return Cochez cette case, si une seule valeur doit tre retourne.
result in
Slectionnez dans la liste la colonne du schma sur laquelle est base la valeur
obtenir.
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.
Slectionnez le Type de paramtre :

IN : paramtre d'entre (Input).

OUT : paramtre de sortie (Output)/valeur retourne.

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.
Le type Custom Type est utilis quand une colonne du schma (Schema
Column) que vous souhaitez utiliser est dfinie par l'utilisateur. Deux types de
Custom sont disponibles dans le tableau Parameters.

Pour le premier type :

- Cochez la case quand la colonne du schma correspondant est dfinie par


l'utilisateur.

- Si toutes les colonnes du schma dans le tableau Parameters sont de type


personnalis, vous pouvez cocher la case devant Custom Type.

978 Guide de rfrence des Composants de Talend Open Studio


Scnario : Vrifier le format de numros l'aide d'une procdure stocke

Slectionnez un type de base de donnes dans la liste DB Type afin de mapper


le type de la base de donnes source vers le type de la base de donnes cible :

- Auto-Mapping : Mappe le type de la base de donnes source au type de la


base de donnes cible automatiquement (par dfaut).

- CLOB : Character large object.

- BLOB : Binary large object.

- DECIMAL : objet dcimal numrique.

- NUMERIC : caractre compris entre 0 et 9.


Dans la seconde colonne Custom Type, vous pouvez prciser le type de
personnalisation. Il peut tre

- STRUCT : utilis pour un lment.

- ARRAY : utilis pour plusieurs lments.


Dans la colonne Custom name, spcifiez le type de personnalisation.

Dans le tableau Parameters, si une colonne est de Type OUT,


assurez-vous que son type dans le schma est bien Object.
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.
NLS Language A partir de la liste droulante, dfinissez la langue utilise pour les donnes qui
ne sont pas codes en Unicode.
NLS Territory Cochez cette case pour modifier les conventions d'appellation utilises pour
la numrotation des jours et des semaines. La valeur par dfaut est celle du
systme d'exploitation.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi qu'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 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.

Scnario : Vrifier le format de numros l'aide d'une


procdure stocke
Le Job suivant permet de se connecter une base Oracle contenant des numros de scurit social et le nom de leur
propritaire, en appelant une procdure stocke qui vrifie le format des numros en fonction du format standard
###-##-####. Puis le rsultat de la vrification, 1 pour un format valide et 0 pour un format non valide, est affich
en sortie dans la console de la vue Run.

Guide de rfrence des Composants de Talend Open Studio 979


Scnario : Vrifier le format de numros l'aide d'une procdure stocke

Cliquez et dposez les composants suivants : tOracleConnection, tOracleInput, tOracleSP et tLogRow.

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.

Puis double-cliquez sur le composant tOracleInput et paramtrez ses proprits.

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.

980 Guide de rfrence des Composants de Talend Open Studio


Scnario : Vrifier le format de numros l'aide d'une procdure stocke

Dans le champ Query, saisissez la requte Select suivante ou slectionnez-la dans la liste si vous l'aviez stocke
dans le Repository.

select ID, NAME, CITY, SSNUMBER from SSN

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.

Puis slectionnez le type d'encodage adquat dans la liste Encoding type.

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.

La fonction de base utilise pour cet exemple est :

CREATE OR REPLACE FUNCTION is_ssn(string_in VARCHAR2)


RETURN PLS_INTEGER
IS
-- validating ###-##-#### format
BEGIN
IF TRANSLATE(string_in, '0123456789A', 'AAAAAAAAAAB') =
'AAA-AA-AAAA' THEN
RETURN 1;
END IF;
RETURN 0;
END is_ssn;
/

Comme un valeur retourne est attendue dans cet exemple, la procdure agit comme une fonction, ainsi cochez
la case Is function.

Guide de rfrence des Composants de Talend Open Studio 981


Scnario : Vrifier le format de numros l'aide d'une procdure stocke

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.

Puis enregistrez le Job et appuyez sur F6 pour l'excuter.

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 :

Scnario : Rcuprer des informations personnelles l'aide d'une procdure stocke.

Scnario : Trouver le libell State l'aide d'une procdure stocke.

Scnario : Excuter une procdure stocke dans le hub MDM.

982 Guide de rfrence des Composants de Talend Open Studio


Scnario : Vrifier le format de numros l'aide d'une procdure stocke

Guide de rfrence des Composants de Talend Open Studio 983


tOracleTableList

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).

984 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Scnario associ
Pour un scnario associ, consultez Scnario : Itrer une table de base de donnes et lister le nom des colonnes
de la table.

Guide de rfrence des Composants de Talend Open Studio 985


tPostgresqlBulkExec

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Liste des versions de la base de donnes.
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 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 et la table doit 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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

986 Guide de rfrence des Composants de Talend Open Studio


Proprits du tPostgresqlBulkExec

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle.

Clear a table : supprimer le contenu de la table.

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Advanced Action on data Slectionnez l'opration que vous voulez effectuer :
settings
Bulk insert : ajoute de nombreuses entres dans la table.

Bulk update : effectue des modifications simultanes dans diffrentes entres.


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
Escape char Caractre d'chappement de la ligne.
Text enclosure Caractres utiliss pour entourer le texte.
Use Activez la variable.
standard_conforming_string
ON

Guide de rfrence des Composants de Talend Open Studio 987


Scnarios associs

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 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 : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec,

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

988 Guide de rfrence des Composants de Talend Open Studio


tPostgresqlCommit

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.

Si vous utilisez un lien de type Row>Main pour relier


le tPostgresqlCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 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.

Guide de rfrence des Composants de Talend Open Studio 989


tPostgresqlClose

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.

Pour un scnario associ au composant tPostgresqlClose, consultez tMysqlConnection.

990 Guide de rfrence des Composants de Talend Open Studio


tPostgresqlConnection

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.

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 Liste des versions de la base de donnes.
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 DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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.

Guide de rfrence des Composants de Talend Open Studio 991


Scnario associ

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 Postgresql, notamment les composants
tPostgresqlCommit 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 un scnario associ au composant tPostgresqlConnection, consultez tMysqlConnection.

992 Guide de rfrence des Composants de Talend Open Studio


tPostgresqlInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Liste des versions de la base de donnes.
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 exact du schma.
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.

Guide de rfrence des Composants de Talend Open Studio 993


Proprits du tPostgresqlInput

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 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 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.
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 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).

994 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

Guide de rfrence des Composants de Talend Open Studio 995


tPostgresqlOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Liste des versions de la base de donnes.
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 exact du schma.
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 :

None : n'effectuer aucune opration de table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

996 Guide de rfrence des Composants de Talend Open Studio


Proprits du tPostgresqlOutput

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de


Rollback.
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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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.

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Use spatial Cette case est disponible lorsque vous slectionnez l'option de cration de table dans
options la liste Action on table et disparat si vous cochez la case Enable parallel execution
dans la vue Advanced settings.

Guide de rfrence des Composants de Talend Open Studio 997


Proprits du tPostgresqlOutput

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.

Pour plus d'informations concernant la base de donnes PostgreSQL, consultez http://


www.postgresql.org/about/.
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 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 tPostgresqlOutput
peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use save point Cochez cette case pour utiliser des points de sauvegarde au cours de la transaction. Cette case
est indisponible si vous cochez :

la case Die on error dans la vue Basic settings, ou

la case Use Batch Size dans la vue Advanced settings.

Cette case ne fonctionne pas si vous :

saisissez 0 dans le champ Commit every, ou

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.

998 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du tMysqlOutput.

Guide de rfrence des Composants de Talend Open Studio 999


tPostgresqlOutputBulk

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.

Famille de composant Databases/Postgresql


Fonction Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards
Postgresql.
Objectif Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une
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.
File Name Nom du fichier gnrer.

Le fichier est gnr sur la machine locale ou dans un


fichier partag sur le rseau local.
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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

1000 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Advanced settings Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
Field separator Caractre, chane ou expression rgulire sparant les champs.
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 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.

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 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 : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

Guide de rfrence des Composants de Talend Open Studio 1001


tPostgresqlOutputBulkExec

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.

Famille de composant Databases/Postgresql


Fonction Le tPostgresqlOutputBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tPostgresqlOutputBulkExec est un composant ddi qui permet un gain de performance
pendant les oprations d'Insert dans une 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.
DB Version Liste des versions de la base de donnes.
Host Adresse IP du serveur de base de donnes.

localhost, 127.0.0.1 et l'adresse IP exacte de la machine locale


permettent un bon fonctionnement. Le serveur de base de donnes
doit tre install sur la mme machine que le Studio Talend ou le Job
comprenant le tPostgresqlOutputBulkExec.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom exact 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.
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 :

None: n'effectuer aucune opration de table.

Drop and create table: supprimer la table puis en crer une


nouvelle.

Create table: crer une table qui n'existe pas encore.

Create table if not exists: crer la table si ncessaire.

Drop table if exists and create: supprimer la table si elle existe dj,
puis en crer une nouvelle.

1002 Guide de rfrence des Composants de Talend Open Studio


Proprits du tPostgresqlOutputBulkExec

Clear a table: supprimer le contenu de la table.


File Name Nom du fichier gnrer et charger.

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.
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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
Advanced settings Action on data Slectionnez l'opration que vous voulez effectuer :

Bulk insert : ajoute diffrentes entres la table. Si des doublons


sont trouvs, le Job s'arrte.

Bulk update : effectue des modifications simultanes dans


diffrentes entres.
Copy the OID for each row Rcupre les identifiants d'objet pour chaque ligne.
Contains a header line with Spcifiez que la table contient des lignes d'en-tte.
the names of each column in
the file
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.
File type Slectionnez le type de fichiers traiter.
Null string Chane de caractres affiche pour signifier que la valeur est nulle.
Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
Fields terminated by Caractre, chane ou expression rgulire sparant les champs.
Escape char Caractre d'chappement de la ligne.
Text enclosure Caractres utiliss pour entourer le texte.

Guide de rfrence des Composants de Talend Open Studio 1003


Scnarios associs

Activate Activez le paramtre standard_conforming_string pour traiter les


standard_conforming_string backslashs comme une chane ordinaire et non pas comme un
caractre d'chappement.
Force not null for columns Dfinissez la nullabilit des colonnes.

Force not null : Cochez la case correspondant la colonne


(Column) que vous souhaitez dfinir comme n'tant pas nulle.
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 base de donnes doit tre install sur la mme machine que le Studio Talend ou le
Job comprenant un tPostgresqlOutputBulkExec afin que le composant fonctionne correctement.

Scnarios associs
Pour un scnario associ au composant tPostgresqlOutputBulkExec, consultez :

Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.

Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

1004 Guide de rfrence des Composants de Talend Open Studio


tPostgresqlRollback

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.

Guide de rfrence des Composants de Talend Open Studio 1005


tPostgresqlRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Liste des versions de la base de donnes.
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 exact du schma.
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.

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

1006 Guide de rfrence des Composants de Talend Open Studio


Proprits du tPostgresqlRow

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.
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 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

Guide de rfrence des Composants de Talend Open Studio 1007


Scnarios associs

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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

1008 Guide de rfrence des Composants de Talend Open Studio


tPostgresqlSCD

tPostgresqlSCD

Le composant tPostgresqlSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tPostgresqlSCD.

Guide de rfrence des Composants de Talend Open Studio 1009


tPostgresqlSCDELT

tPostgresqlSCDELT

Le composant tPostgresqlSCDELT appartient deux familles diffrentes : Business Intelligence et Databases.


Pour plus d'informations, consultez tPostgresqlSCDELT.

1010 Guide de rfrence des Composants de Talend Open Studio


tSybaseBulkExec

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
Server Adresse IP 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.
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.

Guide de rfrence des Composants de Talend Open Studio 1011


Proprits du tSybaseBulkExec

Batch size Nombre de lignes dans chaque lot de traitement de donnes.


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 :

None : n'effectuer aucune opration sur la table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de


Rollback.
File Name Nom du fichier charger.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

Bulk Update : effectue des changements simultans aux multiples entres.


Field Terminator Caractre, chane ou expression rgulire sparant les champs.
Row Terminator Chane (ex : "\n" sous Unix) sparant les lignes.

1012 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Head row Nombre de lignes d'en-tte ignorer en dbut de fichier.


Encoding Slectionnez l'encodage dans la liste ou saisissez-le entre guillemets doubles si le type
d'encodage utilis n'existe pas dans la liste. Ce champ est obligatoire pour la gestion de donnes
de bases de donnes.
Output Slectionnez la sortie utiliser pour rcuprer la sortie standard de la base Sybase :

to console : vers la console.

to global variable : vers la variable globale.


tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du Job , ainsi qu'au niveau du
Statistics 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 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.

Guide de rfrence des Composants de Talend Open Studio 1013


Scnarios associs

1014 Guide de rfrence des Composants de Talend Open Studio


tSybaseClose

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.

Pour un scnario associ au composant tSybaseClose, consultez tMysqlConnection.

Guide de rfrence des Composants de Talend Open Studio 1015


tSybaseCommit

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.

Si vous utilisez un lien de type Row > Main pour


relier le tSybaseCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 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.

1016 Guide de rfrence des Composants de Talend Open Studio


tSybaseConnection

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.

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.
Table 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 DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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.

Guide de rfrence des Composants de Talend Open Studio 1017


Scnarios associs

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus despace pour grer vos
transactions dans un Job, il est recommand d'utiliser un composant
Commit.
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement du
Job au niveau du Job ainsi qu'au niveau de chaque composant.
Utilisation Ce composant est gnralement utilis avec des composants Sybase, notamment les composants
tSybaseCommit 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).
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.

1018 Guide de rfrence des Composants de Talend Open Studio


tSybaseInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
Sybase Nom exact du schma Sybase.
Schema
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.

Guide de rfrence des Composants de Talend Open Studio 1019


Proprits du tSybaseInput

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

1020 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Scnario associ
Pour un scnario associ, consultez les scnarios du composant tDBInput dans :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du tContextLoad.

Guide de rfrence des Composants de Talend Open Studio 1021


tSybaseIQBulkExec

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.

Pour Sybase IQ 12, le fichier de masse charger doit se situer sur la


mme machine que le serveur de Sybase IQ 12.

Pour Sybase IQ 15, le fichier de masse charger doit se trouver dans


une machine distante. Cependant, cela signifie de configurer le serveur
Sybase IQ 15. Pour plus d'informations, consultez Sybase IQ client-
side load support enhancements (en anglais).

Vous pouvez vous connecter la version Sybase IQ 15 via ODBC et via


JDBC pour la version Sybase IQ 12. Les champs renseigner dans la vue
Basic settings varient lgrement selon les versions.
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
Sybase IQ 12 dj dfinie.
uniquement.
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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion crant
cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

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.

Sybase IQ 12
uniquement.
Port Numro du port d'coute du serveur de base de donnes.

1022 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSybaseIQBulkExec

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 :

None : n'effectuer aucune opration sur la table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en crer
une nouvelle.

Clear a table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit


de Rollback.
Local filename Nom du fichier charger.
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 Built-in soit distant dans
le Repository.

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.
Advanced settings Lines terminated by Caractre, chane ou expression rgulire sparant les lignes.
Field Terminated by Caractre, chane ou expression rgulire sparant les champs.

Ce composant permet l'utilisation de sparateurs de champs/lignes


orients Sybase, comme \x09.
Use enclosed quotes Cochez cette case pour utiliser des caractres pour entourer les donnes.

Guide de rfrence des Composants de Talend Open Studio 1023


Scnario associ

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 : Charger en masse de donnes dans une base de donnes Sybase IQ 12 du


tSybaseIQOutputBulkExec.

Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulkExec.

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

1024 Guide de rfrence des Composants de Talend Open Studio


tSybaseIQOutputBulkExec

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.

Pour Sybase IQ 12, le fichier de masse charger doit se situer sur la


mme machine que le serveur de Sybase IQ 12.

Pour Sybase IQ 15, le fichier de masse charger doit se trouver dans


une machine distante. Cependant, cela signifie de configurer le serveur
Sybase IQ 15. Pour plus d'informations, consultez Sybase IQ client-
side load support enhancements (en anglais).

Vous pouvez vous connecter la version Sybase IQ 15 via ODBC et via


JDBC pour la version Sybase IQ 12. Les champs renseigner dans la
vue Basic settings varient lgrement selon les versions.
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
Sybase IQ 12 avez dj dfinie.
uniquement.
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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion crant
cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

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.

Sybase IQ 12
uniquement.
Port Numro du port d'coute du serveur de base de donnes.

Guide de rfrence des Composants de Talend Open Studio 1025


Proprits du tSybaseIQOutputBulkExec

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 :

None : n'effectuer aucune opration sur la table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Drop table if exists and create : supprimer la table si elle existe dj, puis en crer
une nouvelle.

Create table if doesn't exist : crer la table si ncessaire.

Clear a table : supprimer le contenu de la table.


File Name Nom du fichier gnrer et charger.
Append the file Cochez cette case pour ajouter des lignes la fin des enregistrements.
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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying


+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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

1026 Guide de rfrence des Composants de Talend Open Studio


Scnario : Charger en masse de donnes dans une base de donnes Sybase IQ 12

courant, slectionnez No et slectionnez nouveau la mtadonne du schma


dans la fentre [Repository Content].
Advanced settings Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires la connexion
parameters la base de donnes, afin de supporter des caractres spcifiques.
Fields terminated by Caractre, chane ou expression rgulire sparant les champs.

Ce composant tant une combinaison des tSybaseOutputBulk et


tSybaseIQBulkExec, il ne permet pas l'utilisation de sparateurs de
champs/lignes orients Sybase, tels que \x09. Pour obtenir l'effet
souhait, (par exemple afficher les champs sous forme de tableau) vous
devez utiliser le tSybaseOutputBulk et le tSybaseIQBulkExec ensemble
afin de remplacer le tSybaseOutputBulkExec, avec le sparateur \t
utilis dans le tSybaseOutputBulk et le sparateur \x09 utilis dans le
tSybaseIQBulkExec.
Lines terminated by Caractre, chane ou expression rgulire sparant les lignes.
Use enclose quotes Cochez cette case pour utiliser des caractres pour entourer les donnes.
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.
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 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).

Scnario : Charger en masse de donnes dans une


base de donnes Sybase IQ 12
Ce scnario sauvegarde des donnes provenant d'un tRowGenerator dans un fichier et les charge en masse dans
une base de donnes Sybase IQ 12.

Guide de rfrence des Composants de Talend Open Studio 1027


Scnario : Charger en masse de donnes dans une base de donnes Sybase IQ 12

Relier les composants


1. Dposer un composant tRowGenerator et un tSybaseIQOutputBulkExec dans l'espace de modlisation
graphique.

2. Reliez le tRowGenerator au tSybaseIQOutputBulkExec l'aide d'un lien a Row > Main.

Configurer les composants


1. Double-cliquez sur le tRowGenerator pour ouvrir l'diteur de schma.

2. Cliquez sur le bouton [+] pour ajouter deux colonnes et nommez-les id et name.

3. Slectionnez le type int pour la colonne id et String pour la colonne name.

4. Dfinissez la longueur pour les colonnes id et name, respectivement 4 et 30.

5. Slectionnez la fonction pour id et name, respectivement Numeric.sequence et


TalendDataGenerator.getFirstName.

6. Cliquez sur OK pour fermer l'diteur et cliquez sur Yes sur propager les modifications :

1028 Guide de rfrence des Composants de Talend Open Studio


Scnario : Charger en masse de donnes dans une base de donnes Sybase IQ 12

7. Double-cliquez sur le tSybaseIQOutputBulkExec pour ouvrir sa vue Basic settings.

8. Dans les champs Host et Port, saisissez les informations de connexion.

9. Dans le champ Database, saisissez le nom de la base de donnes.

10. Dans les champs Username et Password, saisissez les informations d'authentification.

11. Dans le champ Table, saisissez le nom de la table.

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.

2. Appuyez sur la touche F6 pour excuter le Job.

3. Dans la console Sybase Central, ouvrez la table staff afin de vrifier les donnes :

Guide de rfrence des Composants de Talend Open Studio 1029


Scnarios associs

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 : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

1030 Guide de rfrence des Composants de Talend Open Studio


tSybaseOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
Sybase Schema Nom exact du schma Sybase.
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 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 :

Default : n'effectuer aucune opration de table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Guide de rfrence des Composants de Talend Open Studio 1031


tSybaseOutput Properties

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Clear table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de


Rollback.
Turn on identity Cochez cette case pour utiliser votre propre squence sur les valeurs Identity des donnes
insert insres (plutt que de laisser le serveur SQL choisir les valeurs squentielles).
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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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
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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].

1032 Guide de rfrence des Composants de Talend Open Studio


tSybaseOutput Properties

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.

Guide de rfrence des Composants de Talend Open Studio 1033


Scnario associ

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du tMysqlOutput.

1034 Guide de rfrence des Composants de Talend Open Studio


tSybaseOutputBulk

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.

Famille de composant Databases/Sybase


Fonction Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Sybase.
Objectif Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter 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.
File Name Nom du fichier gnrer.

Ce fichier est gnr sur la machine locale ou dans un


dossier partag du rseau local.
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.

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.

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma
est en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 1035


Scnario associ

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 settings Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
Field separator Caractre, chane ou expression rgulire sparant les champs.

Cette option respecte la syntaxe Java et ne permet pas


l'utilisation de sparateurs de lignes/champs orients
Sybase, comme \x09.
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 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 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 : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

1036 Guide de rfrence des Composants de Talend Open Studio


tSybaseOutputBulkExec

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
Server Adresse IP du serveur de base de donnes.

Seuls localhost, 127.0.0.1 ou l'adresse IP exacte de la machine locale permettent un


fonctionnement optimal. Le serveur de la base de donnes doit tre install sur la mme
machine que le Studio Talend ou que le Job contenant un tSybaseOutputBulkExec.
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.
Bcp Utility Nom de l'utilitaire bcp utiliser pour copier les donnes sur le serveur Sybase.
Batch row number Nombre de lignes traiter dans chaque lot.
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 :

None : n'effectuer aucune opration de table.

Guide de rfrence des Composants de Talend Open Studio 1037


Proprits du tSybaseOutputBulkExec

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Clear a table : supprimer le contenu de la table.


File Name Nom du fichier gnrer et charger.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

Bulk Update : effectue des changements simultans aux multiples entres.


Field Terminator Caractre, chane ou expression rgulire sparant les champs.

Ce composant tant une combinaison des tSybaseOutputBulk et tSybaseBulkExec,


il ne permet pas l'utilisation de sparateurs de champs/lignes orients Sybase,
tels que \x09. Pour obtenir l'effet souhait, (par exemple afficher les champs sous
forme de tableau) vous devez utiliser le tSybaseOutputBulk et le tSybaseBulkExec
ensemble afin de remplacer le tSybaseOutputBulkExec, avec le sparateur \t utilis
dans le tSybaseOutputBulk et le sparateur \x09 utilis dans le tSybaseBulkExec.
DB Row Chane (ex : "\n" sous Unix) sparant les lignes dans la base de donnes.
Terminator
First row NO. of Nombre de lignes d'en-tte ignorer en dbut de fichier.
file

1038 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

to global variable : valeurs retournes partir de fichiers de log.


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 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 : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

Guide de rfrence des Composants de Talend Open Studio 1039


tSybaseRollback

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.

1040 Guide de rfrence des Composants de Talend Open Studio


tSybaseRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
Sybase schema Nom du schma Sybase.
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 name Nom de la table lire.
Turn on identity Cochez cette case pour utiliser votre propre squence sur les valeurs Identity des donnes
insert insres (plutt que de laisser le serveur SQL choisir les valeurs squentielles).
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 Saisissez votre requte en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.

Guide de rfrence des Composants de Talend Open Studio 1041


Proprits du tSybaseRow

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 :

View schema : slectionnez cette option afin de voir le schma.

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 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 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
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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

1042 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du tMysqlRow.

Guide de rfrence des Composants de Talend Open Studio 1043


tSybaseSCD

tSybaseSCD

Le composant tSybaseSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus
d'informations, consultez tSybaseSCD.

1044 Guide de rfrence des Composants de Talend Open Studio


tSybaseSCDELT

tSybaseSCDELT

Le composant tSybaseSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tSybaseSCDELT.

Guide de rfrence des Composants de Talend Open Studio 1045


tSybaseSP

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

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.
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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour passer le schma en mode
Built-In et effectuer des modifications locales.

1046 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSybaseSP

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.

Slectionnez le Type de paramtre :

IN : paramtre d'entre (Input)

OUT : paramtre de sortie (Output)/valeur retourne

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.

Guide de rfrence des Composants de Talend Open Studio 1047


Scnario associ

Scnario associ
Pour un scnario associ, consultez:

Scnario : Rcuprer des informations personnelles l'aide d'une procdure stocke.

Scnario : Trouver le libell State l'aide d'une procdure stocke.

Scnario : Vrifier le format de numros l'aide d'une procdure stocke.

Scnario : Excuter une procdure stocke dans le hub MDM.

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.

1048 Guide de rfrence des Composants de Talend Open Studio


tVerticaSCD

tVerticaSCD

Le composant tVerticaSCD appartient deux familles de composants : Business Intelligence et Databases. Pour
plus d'informations, consultez tVerticaSCD.

Guide de rfrence des Composants de Talend Open Studio 1049


Guide de rfrence des Composants de Talend Open Studio
Databases - Composants d'appliance et de
datawarehouse
Le chapitre Databases - Composants d'appliance et de datawarehouse dcrit les connecteurs de bases de donnes
spcialises dans le traitement de gros volumes de donnes. 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. Ces composants sont prsents dans la famille Databases de la Palette dans la perspective Integration du
Studio Talend. D'autres types de connecteurs de bases de donnes, tels que les connecteurs des bases de donnes
traditionnelles et de gestion de bases de donnes, sont documents dans le Databases - Composants traditionnels
et le Databases - Autres composants.

Guide de rfrence des Composants de Talend Open Studio


tGreenplumBulkExec

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

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.
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 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 et la table doit 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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

1052 Guide de rfrence des Composants de Talend Open Studio


Proprits du tGreenplumBulkExec

Create table if doesn't exist : crer la table si ncessaire.

Clear a table : supprimer le contenu de la table.


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.
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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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

Guide de rfrence des Composants de Talend Open Studio 1053


Scnarios associs

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.

1054 Guide de rfrence des Composants de Talend Open Studio


tGreenplumClose

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.

Pour un scnario associ au composant tGreenplumClose, consultez tMysqlConnection

Guide de rfrence des Composants de Talend Open Studio 1055


tGreenplumCommit

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.

Si vous utilisez un lien de type Row > Main pour relier


le tGreenplumCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 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 :

Scnario: Mapper les donnes l'aide d'une jointure implicite simple .

1056 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Scnario 1 : Insrer des donnes dans des tables mre/fille.

Guide de rfrence des Composants de Talend Open Studio 1057


tGreenplumConnection

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.

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 DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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.

1058 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 Greenplum, notamment les
composants tGreenplumCommit 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).

Scnarios associs
Pour un scnario associ au composant tGreenplumConnection, consultez :

Scnario: Mapper les donnes l'aide d'une jointure implicite simple .

tMysqlConnection.

Guide de rfrence des Composants de Talend Open Studio 1059


tGreenplumGPLoad

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

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.
Schema Nom exact 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.
Table Nom de la table dans laquelle les donnes doivent tre insres.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes
de la table slectionne, avant de charger les donnes :

None : n'effectuer aucune opration de table.

Clear table : supprimer le contenu de la table.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

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 et la (re)cre.

Truncate table : supprimer rapidement le contenu de la table, mais


sans possibilit de Rollback.
Action on data Vous pouvez effectuer diffrentes actions sur les donnes de la table
dfinie :

1060 Guide de rfrence des Composants de Talend Open Studio


Proprits du tGreenplumGPLoad

Insert : Ajouter de nouvelles entres la table. Si des doublons sont


trouvs, le Job s'arrte.

Update : Apporter des modifications aux entres existantes.

Merge : Mettre jour ou ajouter des donnes dans la table.

Il est ncessaire de spcifier au moins une colonne comme


tant une cl primaire sur laquelle baser les oprations
Update et Merge. Vous pouvez le faire en cliquant sur
Edit Schema et en cochant la (les) case(s) ct de la
(des) colonne(s) que vous souhaitez dfinir comme cl(s)
primaire(s). Pour configurer les options des oprations
Update et Merge, cochez les cases de la colonne Match
Column correspondant aux noms des colonnes que vous
souhaitez utiliser comme base pour les oprations Update
et Merge. Ensuite, cochez les cases de la colonne Update
Column correspondant aux noms des colonnes que vous
souhaitez mettre jour. Pour configurer le champ Update
condition, saisissez la condition qui sera utilise pour
mettre jour 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 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 :

View schema : slectionnez cette option afin de voir le schma.

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].
Data file Chemin d'accs complet au fichier de donnes utiliser. Si ce
composant est utilis seul (non connect un autre composant par un
flux d'entre), alors saisissez le nom d'un fichier existant charger
dans la base de donnes. S'il est connect un autre composant par un
flux d'entre, saisissez le nom du fichier gnrer et crire avec les
donnes d'entre, afin de l'utiliser plus tard avec gpload pour charger
dans la base de donnes. Ce champ est masqu lorsque la case Use
named-pipe est coche.
Use named-pipe Cochez cette case afin d'utiliser un tube nomm la place d'un
fichier de donnes. Cette option ne peut tre utilise que lorsque le
composant est connect un autre composant par un flux d'entre.
Quand la case est coche, aucun fichier de donnes n'est gnr, et
les donnes sont transfres l'utilitaire gpload via un tube nomm.
Cette option amliore grandement les performances sous Linux et
Windows.

Ce composant, en mode tube nomm, utilise une interface


JNI pour crer un tube nomm et crire dedans, dans toute
plateforme Windows. Le chemin d'accs associ au fichier

Guide de rfrence des Composants de Talend Open Studio 1061


Proprits du tGreenplumGPLoad

DLL JNI doit tre configur dans le chemin d'accs


la bibliothque Java. Le composant est automatiquement
fourni dans le Studio Talend avec deux DLL pour les
systmes d'exploitation de 32 et 64 bits.
Named-pipe name Spcifiez un nom pour le tube nomm utiliser. Vrifiez que le nom
saisi est valide.
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 Use existing control file Cochez cette case pour fournir un fichier de contrle utiliser avec
(YAML formatted) l'utilitaire gpload au lieu de spcifier explicitement toutes les options
dans le composant. Lorsque cette case est coche, l'option Data file
ainsi que les autres options lies l'utilitaire gpload ne s'appliquent
plus. Veuillez vous rfrer au manuel du gpload de Greenplum pour
plus d'informations concernant la cration d'un fichier de contrle.
Control file Saisissez le chemin d'accs au fichier de contrle utiliser, entre
guillemets doubles, ou cliquez sur le bouton [...] afin de parcourir
votre rpertoire jusqu'au fichier de contrle. Cette option est passe
l'utilitaire gpload via l'argument -f.
CSV mode Cochez cette case pour inclure des paramtres spcifiques au format
CSV, tels que Escape char et Text enclosure.
Field separator Caractre, chane de caractres ou expression rgulire utilis pour
sparer les champs.

Argument delim de l'utilitaire gpload. La valeur par dfaut


est |. Pour amliorer les performances, utilisez la valeur
par dfaut.
Escaped char Caractre d'chappement de la ligne.
Text enclosure Caractres utiliss pour entourer le texte.
Header (skips the first row of Cochez cette case pour ignorer la premire ligne du fichier de
data file) donnes.
Additional options Dfinissez les arguments gpload dans le tableau correspondant.
Cliquez sur le bouton [+] autant de fois que ncessaire afin d'ajouter
les arguments au tableau.

Cliquez sur le champ Parameter et choisissez l'argument souhait


dans la liste, puis cliquez sur le champ Value correspondant et
saisissez une valeur entre guillemets.
LOCAL_HOSTNAME : Nom de l'hte ou adresse IP de la machine
sur laquelle gpload fonctionne. Si cette machine est configure avec
plusieurs cartes rseau, vous pouvez spcifier le nom de l'hte ou
l'adresse IP de chaque carte rseau, afin de permettre au trafic
d'utiliser simultanment toutes les cartes rseau. Par dfaut, l'hte
local ou adresse IP principal(e) est utilis(e).
PORT (gpfdist port) : Numro du port spcifique devant tre utilis
par le programme de distribution du fichier gpfdist. Vous pouvez
galement renseigner PORT_RANGE afin de slectionner un port
disponible dans l'cart spcifi. Si PORT et PORT_RANGE sont
spcifis, PORT prvaut. Si aucun des deux n'est dfini, un port
disponible entre 8000 et 9000 est slectionn par dfaut. Si plusieurs
noms d'htes sont dclars dans LOCAL_HOSTNAME, le numro
du port est utilis pour tous les htes. Cette configuration est
souhaite si vous voulez utiliser toutes les cartes rseau pour charger
le mme fichier ou le mme ensemble de fichiers dans un rpertoire
donn.
PORT_RANGE : Peut tre utilis la place de PORT (gpfdist
port) afin de spcifier une plage de numros de ports parmi
lesquels gpload peut choisir un port disponible pour cette instance
du programme de distribution du fichier gpfdist.

1062 Guide de rfrence des Composants de Talend Open Studio


Proprits du tGreenplumGPLoad

NULL_AS : Chane de caractres reprsentant une valeur null.


La valeur par dfaut est \N en mode TEXT et une valeur vide
sans guillemet en mode CSV. Tout lment de donnes source
correspondant cette chane de caractres sera considr comme
valeur null.
FORCE_NOT_NULL : En mode CSV, traite chaque colonne
spcifie comme si elle tait entoure de guillemets et n'tait donc
pas une valeur NULL. Pour la chane de caractres null par dfaut
en mode CSV (aucun caractre entre deux dlimiteurs), cela cre des
valeurs manquantes valuer comme des chanes de caractres de
longueur zro.
ERROR_LIMIT (2 or higher) : Active le mode d'isolation d'une
ligne pour cette opration de chargement. Lorsqu'il est activ et que
le nombre maximal d'erreurs n'est pas atteint pour les instances de
segments Greenplum durant le traitement de l'entre, toutes les lignes
correctes sont charges et les lignes ayant des erreurs de format sont
rejetes ou enregistres dans la table ERROR_TABLE, si elle est
disponible.

Si le nombre limite d'erreurs est atteint, les lignes d'entre ayant des
erreurs de format arrtent l'opration de chargement.

Notez que l'isolation d'une ligne en erreur s'applique uniquement


aux lignes de donnes ayant des erreurs de format, par exemple, des
attributs manquants ou supplmentaires, des attributs d'un mauvais
type de donnes ou des squences d'encodage client invalides. Des
erreurs de contraintes, telles que les violations de cl primaire,
provoquent toujours l'arrt du chargement.

Lorsque cette option n'est pas active, l'opration de chargement


s'arrte la premire erreur rencontre.
ERROR_TABLE : Lorsque la limite ERROR_LIMIT est
dclare, spcifie une table d'erreur dans laquelle les lignes contenant
des erreurs de format sont enregistres lors de l'excution en mode
isolation d'une ligne. Vous pouvez observer cette table d'erreurs afin
de voir les lignes en erreur n'ayant pas t charges (s'il y en a).
Log file Parcourez votre systme ou saisissez le chemin d'accs votre fichier
de log.
Encoding Saisissez le type d'encodage dans le champ.
Specify gpload path Cochez cette case afin de spcifier le chemin d'accs complet
l'excutable gpload. Vous devez cocher cette case si le chemin
d'accs n'est pas spcifi dans la variable d'environnement PATH.
Full path to gpload Chemin d'accs complet l'excutable gpload sur la machine en
executable cours d'utilisation. Il est recommand de spcifier le chemin d'accs
dans la variable d'environnement PATH au lieu de slectionner cette
option.
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.

GPLOAD_OUTPUT : les informations de sortie lors de l'excution de l'utilitaire gpload. 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.

Guide de rfrence des Composants de Talend Open Studio 1063


Scnario associ

Utilisation Ce composant est principalement utilis lorsque des transformations particulires ne sont pas
requises sur les donnes charger dans la base de donnes.

Ce composant peut tre utilis en standalone ou en tant que 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).
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.

1064 Guide de rfrence des Composants de Talend Open Studio


tGreenplumInput

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.

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 connection Cochez cette case lorsque vous utilisez le composant
tGreenplumConnection.
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 exact 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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 1065


Scnarios associs

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 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 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 String/Char Cochez cette case pour supprimer les espaces en dbut et en fin de
columns champ dans toutes les colonnes contenant des chanes de caractres.
Trim column Supprimer les espaces en dbut et en fin de champ dans les colonnes
slectionnes.
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 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 :

1066 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Scnario: Mapper les donnes l'aide d'une jointure implicite simple .

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.

Guide de rfrence des Composants de Talend Open Studio 1067


tGreenplumOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom exact du schma.
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 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.

Create a table : crer une table qui n'existe pas encore.

1068 Guide de rfrence des Composants de Talend Open Studio


Proprits du tGreenplumOutput

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle.

Clear a table : supprimer le contenu de la table.


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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence donne


existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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

Guide de rfrence des Composants de Talend Open Studio 1069


Scnarios associs

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 :

1070 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Scnario: Mapper les donnes l'aide d'une jointure implicite simple .

Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
tDBOutput.

Scnario 1 : Ajouter une colonne et modifier les donnes du tMysqlOutput.

Guide de rfrence des Composants de Talend Open Studio 1071


tGreenplumOutputBulk

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.

Famille de composant Databases/Greenplum


Fonction Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards
Greenplum.
Objectif Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une
base de donnes Greenplum.
Basic settings Property type Either Built-in or 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.
File Name Nom du fichier gnrer.

Ce fichier est gnr sur la machine locale ou dans un


dossier partag sur le rseau local.
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.

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.

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma
est en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

1072 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 settings Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
Field separator Caractre, chane ou expression rgulire sparant les champs.
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 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 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.

Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Guide de rfrence des Composants de Talend Open Studio 1073


tGreenplumOutputBulkExec

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.

Famille de composant Databases/Greenplum


Fonction Le tGreenplumOutputBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tGreenplumOutputBulkExec 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.
Host Adresse IP du serveur de la base de donnes.

Seuls localhost, 127.0.0.1 ou l'adresse IP exacte de la machine locale


permettent un fonctionnement optimal. 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.
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.
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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une
nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe


dj, puis en crer un nouvelle.

Clear a table : supprimer le contenu de la table.

1074 Guide de rfrence des Composants de Talend Open Studio


Proprits du tGreenplumOutputBulkExec

File Name Non du fichier gnrer et charger.

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.
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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est
en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 settings Action on data Slectionnez l'opration que vous voulez effectuer :

Bulk insert ou Bulk update.

Les informations demandes seront diffrentes en fonction de


l'action choisie.
Copy the OID for each row Rcupre les identifiants d'objet pour chaque ligne.
Contains a header line with Spcifiez que la table contient des lignes d'en-tte.
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 terminated by Caractre, chane ou expression rgulire sparant les champs.
Escaped char Caractre d'chappement de la ligne.
Text enclosure Caractres utiliss pour entourer le texte.
Force not null for columns Dfinissez la nullabilit des colonnes

Force not null : Cochez la case correspondant la colonne


(Column) que vous souhaitez dfinir comme n'tant pas nulle.
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.

Guide de rfrence des Composants de Talend Open Studio 1075


Scnarios associs

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.

Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

1076 Guide de rfrence des Composants de Talend Open Studio


tGreenplumRollback

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.

Guide de rfrence des Composants de Talend Open Studio 1077


tGreenplumRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de lire


la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom exact du schma
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.
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 :

View schema : slectionnez cette option afin de voir le schma.

1078 Guide de rfrence des Composants de Talend Open Studio


Proprits du tGreenplumRow

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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

Guide de rfrence des Composants de Talend Open Studio 1079


Scnarios associs

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez 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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

1080 Guide de rfrence des Composants de Talend Open Studio


tGreenplumSCD

tGreenplumSCD

Le composant tGreenplumSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tGreenplumSCD.

Guide de rfrence des Composants de Talend Open Studio 1081


tIngresBulkExec

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.

Famille de composant Databases/Ingres


Fonction Le composant tIngresBulkExec effectue une action d'insertion (INSERT) sur les donnes fournies.
Objectif Le tIngresBulkExec vous permet d'insrer des donnes en masse dans une table du SGBD Ingres,
afin d'optimiser les performances.
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.
Table Nom de la table remplir.
VNode Nom du nud virtuel.
Database Nom de la base de donnes.
Action on table Actions pouvant tre effectues sur la table :

None : Aucune opration.

Truncate : Supprime toutes les lignes de la table et rend l'espace


du fichier au systme d'exploitation.
File name Nom du fichier charger.

Ce fichier doit se situer 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.
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.

1082 Guide de rfrence des Composants de Talend Open Studio


Proprits du tIngresBulkExec

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est
en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].
Delete Working Files After Use Cochez cette case pour supprimer les fichiers crs durant
l'excution.
Advanced settings Field Separator Saisissez le caractre, la chane de caractres ou l'expression
rgulire permettant de sparer les champs.
Row Separator Chane de caractres (ex : "\n" sous Unix) permettant de sparer
les lignes.
Null Indicator Valeur de l'indicateur null.
Session User Utilisateur de la session dfinie (connexion la base de donnes).
Rollback Activer ou dsactiver le rollback.
On Error Politique de gestion d'erreur :

Continue : Continuer l'excution.

Terminate : Terminer l'excution.


Reject Row File Chemin d'accs et nom du fichier contenant les lignes rejetes.

Disponible lorsque l'option Continue est slectionne dans la liste


On Error.
Error Count Nombre d'erreurs avant arrt de l'excution.

Disponible lorsque l'option Terminate est slectionne dans la liste


On Error.
Allocation Nombre de pages initialement alloues la table ou l'index.
Extend Nombre de pages tendant la table ou l'index.
Fill Factor Spcifiez le pourcentage (de 1 100) de chaque page principale de
donnes devant tre remplie de lignes, dans des conditions idales.
Par exemple, si vous spcifiez un facteur de remplissage de 40, le
serveur de SGBD remplit de lignes 40% de chaque page principale
dans la table restructure.
Min Pages/Max Pages Spcifiez le nombre minimum/maximum de pages principales
qu'une table de hachage doit possder. Ces nombres doivent tre
de 1 minimum.
Leaf Fill Une copie de masse peut spcifier une valeur leaffill. Cette clause
spcifie le pourcentage (de 1 100) de chaque index de page de
table B-tree devant tre remplie par des lignes durant la copie.
Cette clause peut tre utilise uniquement sur des tables ayant une
structure de stockage B-tree.
Non Leaf Fill Une copie de masse peut spcifier une valeur nonleaffill. Cette
clause spcifie le pourcentage (de 1 100) de chaque index de
page de table B-tree ne devant pas tre rempli par des lignes durant
la copie. Cette clause peut tre utilise uniquement sur des tables
ayant une structure de stockage B-tree.

Guide de rfrence des Composants de Talend Open Studio 1083


Scnario associ

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 :

to console : Ecrire le message dans la console.

to global variable : Ecrire le message dans une variable globale.


tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
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 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 :

Scnario : Charger des donnes dans une table du SGBD Ingres.

1084 Guide de rfrence des Composants de Talend Open Studio


tIngresClose

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.

Pour un scnario associ au composant tIngresClose, consulteztMysqlConnection

Guide de rfrence des Composants de Talend Open Studio 1085


tIngresCommit

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.

Si vous utilisez un lien de type Row > Main pour relier le


tIngresCommit votre Job, vos donnes seront commites
ligne par ligne. Dans ce cas, ne cochez pas la case Close
connection car la connexion sera ferme avant la fin du
commit de votre premire ligne.
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 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.

1086 Guide de rfrence des Composants de Talend Open Studio


tIngresConnection

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.

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.
Table 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 DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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.

Guide de rfrence des Composants de Talend Open Studio 1087


Scnario associ

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus despace pour grer vos
transactions dans un Job, il est recommand d'utiliser un composant
Commit.
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement du
Job au niveau du Job ainsi qu'au niveau de chaque composant.
Utilisation Ce composant est gnralement utilis avec des composants JDBC et notamment avec les
composants tIngresCommit 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).
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.

1088 Guide de rfrence des Composants de Talend Open Studio


tIngresInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de lire


la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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 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 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.

Guide de rfrence des Composants de Talend Open Studio 1089


Scnarios associs

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.

1090 Guide de rfrence des Composants de Talend Open Studio


tIngresOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
Port Numro de 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 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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Guide de rfrence des Composants de Talend Open Studio 1091


Proprits du tIngresOutput

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear a table : supprimer le contenu de la table.


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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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
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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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
Columns l'ayez pralablement supprime ou non). Cette option vous permet d'effectuer des actions

1092 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 :

Guide de rfrence des Composants de Talend Open Studio 1093


Scnarios associs

Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC du
composant tDBOutput.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

1094 Guide de rfrence des Composants de Talend Open Studio


tIngresOutputBulk

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.

Famille de composant Databases/Ingres


Fonction Le composant tIngresOutputBulk prpare un fichier avec le schma dfini et les donnes
provenant du composant prcdent.
Objectif Ce composant prpare le fichier dont les donnes sont insres en masse dans le SGBD Ingres afin
d'optimiser les performances.
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.
File Name Nom du fichier gnrer.

Ce fichier est gnr sur la machine locale ou dans un


dossier partag sur le rseau local.
Append the File Cochez cette case pour ajouter de 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.

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.

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est
en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 1095


Scnario associ

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 settings Field Separator Saisissez le caractre, la chane de caractres ou l'expression
rgulire permettant de sparer les champs.
Row Separator Chane de caractres (ex : "\n" sous Unix) permettant de sparer les
lignes.
Include Header Cochez cette case pour inclure l'en-tte de 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 des bases 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.

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 :

Scnario : Charger des donnes dans une table du SGBD Ingres,

1096 Guide de rfrence des Composants de Talend Open Studio


tIngresOutputBulkExec

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

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.
Table Nom de la table remplir.
VNode Nom du nud virtuel.

Le serveur de la base de donnes doit tre install sur la mme


machine que le Studio Talend ou que le Job contenant un
tIngresOutputBulkExec.
Database Nom de la base de donnes.
Action on table Actions pouvant tre effectues sur la table :

None : Aucune opration.

Truncate : Supprime toutes les lignes de la table et rend l'espace


du fichier au systme d'exploitation.
File name Nom du fichier gnrer et charger.

Ce fichier est gnr sur la machine spcifie dans le


champ VNode 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.
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

Guide de rfrence des Composants de Talend Open Studio 1097


tIngresOutputBulkExec

que les valeurs par dfaut ne sont pas entoures de guillemets. Si


c'est le cas, vous devez supprimer manuellement les guillemets.

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est
en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].
Delete Working Files After Cochez cette case pour supprimer les fichiers crs durant
Use l'excution.
Advanced settings Field Separator Saisissez le caractre, la chane de caractres ou l'expression
rgulire permettant de sparer les champs.
Row Separator Chane de caractres (ex : "\n" sous Unix) permettant de sparer les
lignes.
On Error Politique de gestion d'erreur :

Continue : Continuer l'excution.

Terminate : Terminer l'excution.


Reject Row File Chemin d'accs et nom du fichier contenant les lignes rejetes.

Disponible lorsque l'option Continue est slectionne dans la liste


On Error.
Error Count Nombre d'erreurs avant arrt de l'excution.

Disponible lorsque l'option Terminate est slectionne dans la liste


On Error.
Rollback Activer ou dsactiver le rollback.
Null Indicator Valeur de l'indicateur null.
Session User Utilisateur de la session dfinie (connexion la base de donnes).
Allocation Nombre de pages initialement alloues la table ou l'index.
Extend Nombre de pages tendant la table ou l'index.
Fill Factor Spcifiez le pourcentage (de 1 100) de chaque page principale de
donnes devant tre remplie de lignes, dans des conditions idales.
Par exemple, si vous spcifiez un facteur de remplissage de 40, le
serveur de SGBD remplit de lignes 40% de chaque page principale
dans la table restructure.
Min Pages/Max Pages Spcifiez le nombre minimum/maximum de pages principales
qu'une table de hachage doit possder. Ces nombres doivent tre de
1 minimum.
Leaf Fill Une copie de masse peut spcifier une valeur leaffill. Cette clause
spcifie le pourcentage (de 1 100) de chaque index de page de
table B-tree devant tre remplie par des lignes durant la copie.
Cette clause peut tre utilise uniquement sur des tables ayant une
structure de stockage B-tree.
Non Leaf Fill Une copie de masse peut spcifier une valeur nonleaffill. Cette
clause spcifie le pourcentage (de 1 100) de chaque index de page
de table B-tree ne devant pas tre rempli par des lignes durant la

1098 Guide de rfrence des Composants de Talend Open Studio


Scnario : Charger des donnes dans une table du SGBD Ingres

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 :

to console : Ecrire le message dans la console.

to global variable : Ecrire le message dans une variable globale.


tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Le composant tIngresOutputBulkExec est gnralement utilis avec le tIngresConnection et le
tIngresRow. Il prpare un fichier de sortis et l'alimente en masse avec des donnes dans le SGBD
Ingres, afin d'optimiser les performances.
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 tIngresOutputBulkExec, 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 : Charger des donnes dans une table du


SGBD Ingres
Dans ce scnario, un composant tIngresOutputBulkExec est utilis afin de prparer un fichier de sortie contenant
des donnes provenant d'un fichier .csv concernant des employs et utilise ensuite ce fichier de sortie afin
d'alimenter une table dans une base de donnes Ingres.

Dposer et relier les composants


1. Dposez un tIngresConnection, un tFileInputDelimited et un tIngresOutputBulkExec de la Palette dans
l'espace de modlisation graphique.

2. Renommez le tIngresOutputBulkExec en save_a_copy_and_load_to_DB.

3. Reliez le tIngresConnection au tFileInputDelimited l'aide d'un lien OnSubjobOk.

4. Reliez le tFileInputDelimited au tIngresOutputBulkExec l'aide d'un lien Row > Main.

Guide de rfrence des Composants de Talend Open Studio 1099


Scnario : Charger des donnes dans une table du SGBD Ingres

Configurer les composants


1. Double-cliquez sur le tIngresConnection pour ouvrir sa vue Component.

2. Dans le champ Server, saisissez l'adresse du serveur o se trouve le SGBD Ingres, par exemple "localhost".

Laissez la valeur du champ Port par dfaut.

3. Dans le champ Database, saisissez le nom de la base de donnes Ingres, par exemple "research".

4. Dans les champs Username et Password, saisissez les informations d'authentification.

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.

5. Double-cliquez sur le composant tFileInputDelimited pour ouvrir sa vue Component.

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.

1100 Guide de rfrence des Composants de Talend Open Studio


Scnario : Charger des donnes dans une table du SGBD Ingres

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 OK pour fermer l'diteur de schma.

Cliquez sur Yes dans la fentre qui s'ouvre afin d'accepter la propagation des modifications au composant
suivant.

Laissez les autres composants tels qu'ils sont.

9. Double-cliquez sur le tIngresOutputBulkExec pour ouvrir sa vue Component.

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.

2. Appuyez sur F6 pour excuter le Job.

Guide de rfrence des Composants de Talend Open Studio 1101


Scnarios associs

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,

Scnario 1 : Ajouter une colonne et modifier les donnes.

1102 Guide de rfrence des Composants de Talend Open Studio


tIngresRollback

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.

Guide de rfrence des Composants de Talend Open Studio 1103


tIngresRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de lire


la connexion enregistre.

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.
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 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 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 :

View schema : slectionnez cette option afin de voir le schma.

1104 Guide de rfrence des Composants de Talend Open Studio


Proprits du tIngresRow

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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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

Guide de rfrence des Composants de Talend Open Studio 1105


Scnarios associs

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 : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

1106 Guide de rfrence des Composants de Talend Open Studio


tIngresSCD

tIngresSCD

Le composant tIngresSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus
d'informations, consultez tIngresSCD.

Guide de rfrence des Composants de Talend Open Studio 1107


tNetezzaBulkExec

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

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.
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.
Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois et la table doit
exister pour que l'opration d'Insert soit autorise.
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 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.

1108 Guide de rfrence des Composants de Talend Open Studio


Proprits du tNetezzaBulkExec

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 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.

Guide de rfrence des Composants de Talend Open Studio 1109


Scnarios associs

Pour plus d'informations sur les niveaux 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 : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

1110 Guide de rfrence des Composants de Talend Open Studio


tNetezzaClose

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.

Pour un scnario associ au composant tNetezzaClose, consultez tMysqlConnection.

Guide de rfrence des Composants de Talend Open Studio 1111


tNetezzaCommit

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.

Si vous utilisez un lien de type Row > Main pour


relier le tNetezzaCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 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.

1112 Guide de rfrence des Composants de Talend Open Studio


tNetezzaConnection

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

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.
Table 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.
Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires
Parameters la connexion la base de donnes.
Use or register a shared DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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.

Guide de rfrence des Composants de Talend Open Studio 1113


Scnario associ

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus despace pour grer vos
transactions dans un Job, il est recommand d'utiliser un composant
Commit.
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement du
Job au niveau du Job ainsi qu'au niveau de chaque composant.
Utilisation Ce composant est gnralement utilis avec des composants Netezza, notamment les composants
tNetezzaCommit 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).
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.

1114 Guide de rfrence des Composants de Talend Open Studio


tNetezzaInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de lire


la connexion enregistre.

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.
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.
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 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.

Guide de rfrence des Composants de Talend Open Studio 1115


Proprits du tNetezzaInput

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

1116 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Scnarios associs
Consultez les scnarios du composant tNetezzaInput dans :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

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.

Guide de rfrence des Composants de Talend Open Studio 1117


tNetezzaNzLoad

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

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.
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 dans laquelle les donnes doivent tre insres.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes
de la table slectionne :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une
nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Clear a table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais


sans possibilit de Rollback.
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 pour ce composant
seulement. Voir galement le Guide utilisateur du Studio Talend.

1118 Guide de rfrence des Composants de Talend Open Studio


Proprits du tNetezzaNzLoad

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 :

View schema : slectionnez cette option afin de voir le schma.

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].
Data file Chemin d'accs complet au fichier de donnes utiliser. Si ce
composant est utilis seul (non connect un autre composant par un
flux d'entre), alors saisissez le nom d'un fichier existant charger
dans la base de donnes. S'il est connect un autre composant par un
flux d'entre, saisissez le nom du fichier gnrer et crire avec les
donnes d'entre, afin de l'utiliser plus tard avec nzload pour charger
dans la base de donnes.
Use named-pipe Cochez cette case afin d'utiliser un tube nomm la place d'un
fichier de donnes. Cette option ne peut tre utilise que lorsque le
composant est connect un autre composant par un flux d'entre.
Quand la case est coche, aucun fichier de donnes n'est gnr, et
les donnes sont transfres l'utilitaire nzload via un tube nomm.
Cette option amliore grandement les performances sous Linux et
Windows.

Ce composant, en mode tube nomm, utilise une interface


JNI pour crer un tube nomm et crire dedans, dans toute
plateforme Windows. Le chemin d'accs associ au fichier
DLL JNI doit tre configur dans le chemin d'accs
la bibliothque Java. Le composant est automatiquement
fourni dans le Studio Talend avec deux DLL pour les
systmes d'exploitation de 32 et 64 bits.
Named-pipe name Spcifiez un nom pour le tube nomm utiliser. Vrifiez que le nom
saisi est valide.
Advanced settings Use existing control file Cochez cette case pour fournir un fichier de contrle utiliser avec
l'utilitaire nzload au lieu de spcifier explicitement toutes les options
dans le composant. Lorsque cette case est coche, l'option Data file
ainsi que les autres options lies au nzload ne s'appliquent plus.
Veuillez vous rfrer au manuel du nzload de Netezza pour plus
d'informations concernant la cration d'un fichier de contrle.
Control file Saisissez le chemin d'accs au fichier de contrle utiliser, entre
guillemets doubles, ou cliquez sur le bouton [...] afin de parcourir
votre rpertoire jusqu'au fichier de contrle. Cette option est passe
l'utilitaire nzload via l'argument -cf.
Field separator Caractre, chane de caractres ou expression rgulire utilis pour
sparer les champs.

Argument delim de l'utilitaire nzload. Si vous n'utilisez pas


l'option Wrap quotes around fields, vous devez tre sr
que le dlimiteur n'est pas inclus dans les donnes insres
dans la base de donnes. La valeur par dfaut est \t ou
TAB. Pour amliorer les performances, utilisez la valeur
par dfaut.
Wrap quotes around fields Cette option ne s'applique qu'aux colonnes de type String, Byte,
Byte[], Char, et Object. Slectionnez soit :

None : n'entourez pas les valeurs des colonnes de guillemets.

Guide de rfrence des Composants de Talend Open Studio 1119


Proprits du tNetezzaNzLoad

Single quote : entourez les valeurs des colonnes de guillemets


simples.

Double quote : entourez les valeurs des colonnes de guillemets


doubles.

Si vous utilisez l'option Single quote ou Double quote, il


est ncessaire d'utiliser \ en tant que Escape char.
Advanced options Dfinissez les arguments nzload dans le tableau correspondant.
Cliquez sur le bouton [+] autant de fois que ncessaire afin d'ajouter
les arguments au tableau.

Cliquez sur le champ Parameter et choisissez l'argument souhait


dans la liste, puis cliquez sur le champ Value correspondant et
saisissez une valeur entre guillemets.
Parameter -If Nom du fichier de log gnrer. Les logs seront ajouts
la suite du fichier de log, s'il existe dj. Si le paramtre
n'est pas spcifi, le nom par dfaut du fichier de log
est '<table_name>.<db_name>.nzlog'. Il est gnr dans le
rpertoire de travail courant dans lequel le Job est excut.
-bf Nom du fichier de mauvais enregistrements gnrer. Le fichier
de mauvais enregistrements contient tous les enregistrements
ne pouvant tre chargs, cause d'une erreur interne Netezza.
Les enregistrements seront ajouts la suite si le fichier de
mauvais enregistrements existe dj. Si le paramtre n'est pas
spcifi, le nom par dfaut du fichier de mauvais enregistrements
est '<table_name>.<db_name>.nzbad'. Il est gnr dans le
rpertoire de travail courant, dans lequel le Job est excut.
-ouputDir Chemin d'accs au rpertoire dans lequel les fichiers de log et de
mauvais enregistrements sont gnrs. Si le paramtre n'est pas
spcifi, les fichiers seront gnrs sous le rpertoire courant dans
lequel le Job est excut.
-logFileSize Taille maximale du fichier de log. La valeur est en MB. La valeur
par dfaut est de 2000 ou 2GB. Pour conomiser de l'espace disque,
spcifiez un petite valeur si votre Job est souvent excut.
-compress Slectionnez cette option si le fichier de donnes est compresse. Les
valeurs valides sont "TRUE" et "FALSE". La valeur par dfaut est
"FALSE".

Cette option n'est valide que si ce composant est utilis par


lui-mme et non connect un autre composant via un flux
d'entre.
-skipRows <n> Nombre de lignes ignorer au dbut du fichier de donnes.
Paramtrez la valeur "1" si vous souhaitez ignorer la ligne d'en-tte
du fichier d'entre. La valeur par dfaut est "0".

Cette option ne doit tre slectionne que si le composant


est utilis par lui-mme et non connect un autre
composant via un flux d'entre.
-maxRows <n> Nombre de lignes charger partir du fichier d'entre.

Cette option ne doit tre slectionne que si le composant


est utilis par lui-mme et non connect un autre
composant via un flux d'entre.
-maxErrors Nombre maximal d'enregistrements d'erreurs autoriser avant de
terminer le processus de chargement. La valeur par dfaut est "1".
-ignoreZero Les zros contenus dans une source binaire gnreront des erreurs.
Paramtrez cette option "NO" pour gnrer des erreurs ou "YES"
pour ignorer les bits ayant la valeur zro. La valeur par dfaut est
"NO".
-requireQuotes Cette option ncessite que toutes les valeurs soient entoures de
guillemets. La valeur par dfaut est "FALSE".

1120 Guide de rfrence des Composants de Talend Open Studio


Proprits du tNetezzaNzLoad

Cette option ne fonctionne pas avec un flux d'entre pour


le moment. Utilisez cette option uniquement en mode
standalone avec un fichier existant.
-nullValue <token> Spcifiez le jeton pour indiquer une valeur null dans le fichier
de donnes. La valeur par dfaut est "NULL". Afin d'amliorer
lgrement les performances, vous pouvez configurer cette valeur
comme un champ vide en spcifiant la valeur : "\'\'".
-fillRecord Traite les derniers champs d'entre manquants comme des null. Vous
n'avez pas besoin de spcifier de valeur pour cette option dans le
champ du tableau. Cette option n'est pas active par dfaut, les
champs d'entre devront donc correspondre exactement toutes les
colonnes de la table par dfaut.

Les derniers champs d'entre doivent tre nullables dans


la base de donnes.
-ctrlChar Accepte les caractres de contrle dans les champs char/varchar
(vous devrez chapper les caractres NUL, CR et LF). Vous n'avez
pas besoin de spcifier de valeur pour cette option dans le champ de
valeur du tableau. Cette option est dsactive par dfaut.
-ctInString Accepte le caractre CR non chapp dans des champs char/varchar
(LF devient une fin de ligne). Vous n'avez pas besoin de spcifier de
valeur pour cette option dans le champ de valeur du tableau. Cette
option est dsactive par dfaut.
-truncString Tronque toute valeur de chane de caractres qui dpasse sa valeur
dclare de stockage char/varchar. Vous n'avez pas besoin de
spcifier de valeur pour cette option dans le champ de valeur du
tableau. Cette option est dsactive par dfaut.
-dateStyle Spcifiez le format de la date des donnes d'entre. Les valeurs
valides sont : "YMD", "Y2MD", "DMY", "DMY2", "MDY",
"MDY2", "MONDY", "MONDY2". La valeur par dfaut est
"YMD".

Le format de date dans la colonne du schma du composant


doit correspondre la valeur spcifie ici. Par exemple, si
vous souhaitez charger une colonne DATE, spcifiez ainsi
le format de date dans le schma du composant : "yyyy-
MM-dd" et paramtrez l'option -dateStyle "YMD".

Pour une description plus prcise du chargement de champs de dates


et de temps, consultez Charger des colonnes de type DATE, TIME
et TIMESTAMP.
-dateDelim Caractre dlimiteur entre les parties d'une date. La valeur par dfaut
est "-" pour tous les styles de date, sauf pour "MONDY[2]" pour
lequel elle est " " (espace vide).

Le format de date dans la colonne du schma du composant


doit correspondre la valeur spcifie ici.
-y2Base Premire anne exprimable via l'utilisation du style de date deux
chiffres (Y2).
-timeStyle Spcifiez le format du temps dans les donnes d'entre. Les valeurs
valides sont : "24HOUR" et "12HOUR". La valeur par dfaut est
"24HOUR". Pour amliorer lgrement les performances, gardez la
valeur par dfaut.

Le format de temps dans la colonne du schma du


composant doit correspondre la valeur spcifie ici.
Par exemple, si vous souhaitez charger une colonne de
type TIME, configurez le format de date dans le schma
du composant "HH:mm:ss" et l'option -timeStyle
"24HOUR".

Pour une description plus prcise du chargement de champs de dates


et de temps, consultez Charger des colonnes de type DATE, TIME
et TIMESTAMP.

Guide de rfrence des Composants de Talend Open Studio 1121


Proprits du tNetezzaNzLoad

-timeDelim Caractre dlimiteur entre les parties d'une donne de temps. La


valeur par dfaut est ":".

Le format de temps dans la colonne du schma du


composant doit correspondre la valeur spcifie ici.
-timeRoundNanos Autorise mais arrondit les nombres diffrents de zro plus petits
qu'une microseconde.
-boolStyle Spcifiez le format dans lequel les donnes de type Boolean sont
crites dans les donnes. Les valeurs valides sont : "1_0", "T_F",
"Y_N", "TRUE_FALSE", "YES". La valeur par dfaut est "1_0".
Pour amliorer lgrement les performances, gardez la valeur par
dfaut.
-allowRelay Permet de continuer le chargement malgr une ou plusieurs
rinitialisation(s) ou chec(s) des SPU (Snippet Processing Unit). Par
dfaut, ce comportement n'est pas autoris.
-allowRelay <n> Spcifiez le nombre de continuations du chargement autoris. La
valeur par dfaut est "1".
Encoding Slectionnez l'encodage partir de la liste.
Specify nzload path Cochez cette case afin de spcifier le chemin d'accs complet
l'excutable nzload. Vous devez cocher cette case si le chemin
d'accs n'est pas spcifi dans la variable d'environnement PATH.
Full path to nzload Chemin d'accs complet l'excutable nzload sur la machine en
executable cours d'utilisation. Il est recommand de spcifier le chemin d'accs
dans la variable d'environnement PATH au lieu de slectionner cette
option.
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 principalement utilis lorsque des transformations particulires ne sont pas
requises sur les donnes charger dans la base de donnes.

Ce composant peut tre utilis en standalone ou en tant que 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).
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.

1122 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Charger des colonnes de type DATE, TIME et TIMESTAMP


Lorsque ce composant est utilis avec un flux d'entre, le format de date spcifi dans le schma du composant
doit correspondre la valeur spcifie pour les options -dateStyle, -dateDelim, -timeStyle, et -timeDelim. Veuillez
vous rfrer aux exemples suivants :

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.

Guide de rfrence des Composants de Talend Open Studio 1123


tNetezzaOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

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.
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.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :

Default : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

1124 Guide de rfrence des Composants de Talend Open Studio


Proprits du tNetezzaOutput

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer
une nouvelle.

Clear a table : supprimer le contenu de la table.


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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si


l'enregistrement n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondant au flux d'entre.

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
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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying


+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

Guide de rfrence des Composants de Talend Open Studio 1125


Proprits du tNetezzaOutput

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.

1126 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

Guide de rfrence des Composants de Talend Open Studio 1127


tNetezzaRollback

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.

1128 Guide de rfrence des Composants de Talend Open Studio


tNetezzaRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
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.
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 :

Guide de rfrence des Composants de Talend Open Studio 1129


Proprits du tNetezzaRow

View schema : slectionnez cette option afin de voir le schma.

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 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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

1130 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL.

Guide de rfrence des Composants de Talend Open Studio 1131


tNetezzaSCD

tNetezzaSCD

Le composant tNetezzaSCD appartient deux familles de composants : Business Intelligence et Databases. Pour
plus d'informations sur ce composant, consultez tNetezzaSCD.

1132 Guide de rfrence des Composants de Talend Open Studio


tParAccelBulkExec

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

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.
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 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 et la table doit
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 :

None : n'effectuer aucune opration de table.

Guide de rfrence des Composants de Talend Open Studio 1133


Proprits du tParAccelBulkExec

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en crer
une nouvelle.

Clear table : supprimer le contenu de la table.


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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying


+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 settings Copy mode Slectionnez le mode de Copy que vous souhaitez utiliser.

Basic : Mode classique, sans optimisation.

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

1134 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

Guide de rfrence des Composants de Talend Open Studio 1135


tParAccelClose

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.

Pour un scnario associ au composant tParAccelClose, consultez tMysqlConnection.

1136 Guide de rfrence des Composants de Talend Open Studio


tParAccelCommit

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.

Si vous utilisez un lien de type Row >Main pour relier


le tParAccelCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 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.

Guide de rfrence des Composants de Talend Open Studio 1137


tParAccelConnection

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

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 DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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.

1138 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 ParAccel, notamment les composants
tParAccelCommit 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).
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.

Guide de rfrence des Composants de Talend Open Studio 1139


tParAccelInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom exact du schma
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 sera cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.

1140 Guide de rfrence des Composants de Talend Open Studio


Proprits du tParAccelInput

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 :

View schema : slectionnez cette option afin de voir le schma.

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
settings en une fois. Cette option permet d'optimiser les performances.
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.
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 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.

Guide de rfrence des Composants de Talend Open Studio 1141


Scnarios associs

Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tParAccelInput :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

1142 Guide de rfrence des Composants de Talend Open Studio


tParAccelOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom exact du schma.
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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Guide de rfrence des Composants de Talend Open Studio 1143


Proprits du tParAccelOutput

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear a table : supprimer le contenu de la table.


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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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

1144 Guide de rfrence des Composants de Talend Open Studio


Proprits du tParAccelOutput

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.

Guide de rfrence des Composants de Talend Open Studio 1145


Scnarios associs

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du tMysqlOutput.

1146 Guide de rfrence des Composants de Talend Open Studio


tParAccelOutputBulk

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.

Famille de composant Databases/ParAccel


Fonction Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards
ParAccel.
Objectif Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter 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.
File Name Nom du fichier gnrer.

Ce fichier est gnr sur la machine locale ou dans un


dossier partag sur le rseau local.
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.

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.

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma
est en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 1147


Scnarios associs

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 settings Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
Field separator Caractre, chane ou expression rgulire sparant les champs.
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 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 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 : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

1148 Guide de rfrence des Composants de Talend Open Studio


tParAccelOutputBulkExec

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.

Famille de composant Databases/ParAccel


Fonction Le tParAccelOutputBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tParAccelOutputBulkExec 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.
Host Adresse IP du serveur de la base de donnes.

Seuls localhost, 127.0.0.1 ou l'adresse IP exacte de la machine locale


permettent un fonctionnement optimal. 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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom exact 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.
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 :

None: n'effectuer aucune opration de table.

Drop and create table: supprimer la table puis en crer une


nouvelle.

Create table: crer une table qui n'existe pas encore.

Create table if not exists: crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe


dj, puis en crer une nouvelle.

Clear table: supprimer le contenu de la table.

Guide de rfrence des Composants de Talend Open Studio 1149


Proprits du 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.

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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est
en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].
Filename Nom du fichier gnrer et charger.

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.
Advanced settings Copy mode Slectionnez le mode de Copy que vous souhaitez utiliser.

Basic : Mode classique, sans optimisation.

Parallel : Mode permettant d'utiliser plusieurs API internes


ParAccel, afin d'amliorer les performances de chargement.
Filename Nom du fichier traiter et chemin d'accs.
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 Format Saisissez le format de date et heure qui sera utilis.
Additional COPY Options Saisissez l'option spcifique ParAccel et personnalise que vous
souhaitez utiliser.

1150 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

Guide de rfrence des Composants de Talend Open Studio 1151


tParAccelRollback

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.

1152 Guide de rfrence des Composants de Talend Open Studio


tParAccelRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom exact du schma
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.

Guide de rfrence des Composants de Talend Open Studio 1153


Proprits du tParAccelRow

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 lire.
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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

1154 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

Guide de rfrence des Composants de Talend Open Studio 1155


tParAccelSCD

tParAccelSCD

Le composant tParAccelSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tParAccelSCD.

1156 Guide de rfrence des Composants de Talend Open Studio


tRedshiftBulkExec

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.

Famille de composant Databases/Amazon


Redshift
Fonction Le tRedshiftBulkExec charge des donnes dans une table Amazon Redshift partir d'un fichier plat situ
dans Amazon S3.
Objectif Ce composant vous permet de charger des donnes dans partir d'un fichier 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 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 :

None : n'effectuer aucune opration sur la table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis
en crer une nouvelle.

Clear table : supprimer le contenu de la table.


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.

Guide de rfrence des Composants de Talend Open Studio 1157


Proprits du tRedshiftBulkExec

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 :

View schema : slectionnez cette option afin de voir le schma.

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].
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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ Secret


key, 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.
Bucket Saisissez le nom du bucket Amazon S3 dans lequel le fichier est situ.
Key Saisissez la cl d'objet assigne au fichier charger dans Amazon S3.
Advanced settings File type Slectionnez dans la liste le type de fichier dans Amazon S3 :

Delimited file or CSV : fichier dlimit/CSV.

JSON : fichier JSON.

Fixed width : fichier taille fixe.


Fields terminated by Saisissez le caractre utilis pour sparer les champs.

Ce champ est disponible uniquement lorsque l'option Delimited file or CSV


est slectionne dans la liste File type.
Enclosed by Slectionnez le caractre par lequel entourer les champs.

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.

s3://jsonpaths_file : mappe les donnes l'aide du fichier nomm


JSONPaths. Le paramtre doit tre une cl d'objet Amazon S3 entour
de guillemets doubles et faisant rfrence un fichier, par exemple,
s3://mybucket/jsonpaths.txt. Pour plus d'informations, consultez http://
docs.aws.amazon.com/redshift/latest/dg/r_COPY.html (en anglais).

Ce champ est disponible uniquement lorsque l'option JSON 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
le suivant :

1158 Guide de rfrence des Composants de Talend Open Studio


Proprits du tRedshiftBulkExec

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.

Ce champ est disponible uniquement lorsque l'option Fixed width est


slectionne dans la liste File type.
Compressed by Cochez cette case et, dans la liste affich, slectionnez le type de compression
du fichier source.
Decrypt Cochez cette case si le fichier est crypt du ct client l'aide de Amazon
S3. Pour plus d'informations, consultez Loading Encrypted Data Files from
Amazon S3 (en anglais).
Encryption key Spcifiez la cl de cryptage utilise pour crypter le fichier.

Ce champ apparat uniquement lorsque la case Decrypt est coche.


Encoding Slectionnez dans la liste le type d'encodage des donnes charger.
Date format Slectionnez l'un des lments suivants afin de spcifier le format de date dans
les donnes source :

NONE : aucun format de date n'est spcifi.

PATTERN : slectionnez cet lment et spcifiez le format de date dans le


champ affich. Le format de date par dfaut est YYYY-MM-DD.

AUTO : slectionnez cet lment si vous souhaitez que Amazon Redshift


reconnaisse et convertisse automatiquement le format de date.
Time format Slectionnez l'un des lments suivants dans la liste, afin de spcifier le format
de l'heure dans les donnes source :

NONE : aucun format d'heure n'est spcifi.

PATTERN : slectionnez cet lment et spcifiez le format de l'heure


dans le champ affich. Le format de l'heure par dfaut est YYYY-MM-DD
HH:MI:SS.

AUTO : slectionnez cet lment si vous souhaitez qu'Amazon Redshift


reconnaisse et convertisse le format de l'heure.

EPOCHSECS : slectionnez cet lment si les donnes source sont


reprsentes comme temps epoch, soit le nombre de secondes depuis Jan 1,
1970 00:00:00 UTC.

EPOCHMILLISECS : slectionnez cet lment si les donnes source sont


reprsentes comme temps epoch, soit le nombre de millisecondes depuis
Jan 1, 1970 00:00:00 UTC.
Settings Cliquez sur le bouton [+] sous la table afin de spcifier plus de paramtres pour
le chargement des donnes.

Parameter : cliquez sur la cellule et slectionnez un paramtre dans la liste


droulante.

Value : configurez la valeur du paramtre correspondant. Notez que


vous ne pouvez configurer la valeur d'un paramtre (par exemple
IGNOREBLANKLINES) ne ncessitant pas de valeur.

Pour plus d'informations concernant les paramtres, consultez http://


docs.aws.amazon.com/redshift/latest/dg/r_COPY.html (en anglais).
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

Guide de rfrence des Composants de Talend Open Studio 1159


Charger/retirer des donnes dans/de Amazon S3

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).

Charger/retirer des donnes dans/de Amazon S3


Ce scnario dcrit un Job gnrant un fichier dlimit, le chargeant le fichier dans S3, chargeant des donnes du
fichier de S3 dans Redshift et les affichant dans la console. Ce Job retire ensuite les donnes de Redshift, les ajoute
dans des fichiers S3 pour chaque slice du cluster Redshift puis liste et obtient les fichiers retirs dans S3.

1160 Guide de rfrence des Composants de Talend Open Studio


Charger/retirer des donnes dans/de Amazon S3

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.

redshift_host : URL de l'endpoint de connexion au cluster Redshift.

redshift_port : numro du port d'coute du serveur de la base de donnes.

redshift_database : nom de la base de donnes.

redshift_username : nom de l'utilisateur pour l'authentification la base de donnes.

redshift_password : mot de passe pour l'authentification la base de donnes.

redshift_schema : nom du schma.

s3_accesskey : cl d'accs Amazon S3.

s3_secretkey : cl secrte pour accder Amazon S3.

s3_bucket : nom du bucket Amazon S3.

Guide de rfrence des Composants de Talend Open Studio 1161


Charger/retirer des donnes dans/de Amazon S3

Notez que toutes les valeurs de contexte dans la capture d'cran ci-dessus ont pour seul objectif la dmonstration.

Ajouter et relier les composants


1. Crez un nouveau Job et appliquez au Job toutes les variables de contexte listes ci-dessus.

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.

3. Reliez le tRowGenerator au tRedshiftOutputBulk l'aide d'un lien Row > Main.

4. Rptez l'opration afin de relier le tRedshiftInput au tLogRow.

5. Reliez le tS3List au tS3Get l'aide d'un lien Row > Iterate.

6. Reliez le tRowGenerator au tRedshiftBulkExec l'aide d'un lien Trigger > On Subjob Ok.

7. Rptez l'opration pour relier le tRedshiftBulkExec au tRedshiftInput, le tRedshiftInput au


tRedshiftUnload et le tRedshiftUnload au tS3List.

Configurer les composants


Prparer un fichier et le charger dans S3
1. Double-cliquez sur le tRowGenerator afin d'ouvrir son diteur RowGenerator Editor.

1162 Guide de rfrence des Composants de Talend Open Studio


Charger/retirer des donnes dans/de Amazon S3

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.

6. Double-cliquez sur le tRedshiftOutputBulk pour ouvrir sa vue Basic settings.

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.

Charger les donnes du fichier de S3 dans Redshift

1. Double-cliquez sur le tRedshiftBulkExec pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 1163


Charger/retirer des donnes dans/de Amazon S3

2. Dans le champ Host, appuyez sur les touches Ctrl + Espace et, dans la liste, slectionnez
context.redshift_host afin de renseigner ce champ.

Rptez l'opration pour :

le champ Port avec la valeur context.redshift_port,

le champ Database avec la valeur context.redshift_database,

le champ Schema avec la valeur context.redshift_schema,

le champ Username avec la valeur context.redshift_username,

le champ Password avec la valeur context.redshift_password,

le champ Access Key avec la valeur context.s3_accesskey,

le champ Secret Key avec la valeur context.s3_secretkey et

le champ Bucket avec la valeur context.s3_bucket.

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.

1164 Guide de rfrence des Composants de Talend Open Studio


Charger/retirer des donnes dans/de Amazon S3

Rcuprer les donnes de la table dans Redshift

1. Double-cliquez sur le composant tRedshiftInput pour ouvrir sa vue Basic settings.

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.

"SELECT * FROM" + context.redshift_schema + "person ORDER BY \"ID\""

6. Double-cliquez sur le tLogRow pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 1165


Charger/retirer des donnes dans/de Amazon S3

7. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un affichage optimal des
rsultats.

Retirer des donnes de Redshift et les ajouter dans des fichiers S3


1. Double-cliquez sur le tRedshiftUnload pour ouvrir sa vue Basic settings.

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_.

Rcuprer les fichiers retirs de Amazon S3


1. Double-cliquez sur le composant tS3List pour ouvrir sa vue Basic settings.

1166 Guide de rfrence des Composants de Talend Open Studio


Charger/retirer des donnes dans/de Amazon S3

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_.

5. Double-cliquez sur le tS3Get pour ouvrir sa vue Basic settings.

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")).

Guide de rfrence des Composants de Talend Open Studio 1167


Charger/retirer des donnes dans/de Amazon S3

Sauvegarder et excuter le Job


1. Appuyez sur les touches Ctrl + S afin de sauvegarder votre Job.

2. Excutez le Job en appuyant sur F6 ou en appuyant sur le bouton Run de la vue Run.

1168 Guide de rfrence des Composants de Talend Open Studio


Charger/retirer des donnes dans/de Amazon S3

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.

Guide de rfrence des Composants de Talend Open Studio 1169


tRedshiftClose

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.

1170 Guide de rfrence des Composants de Talend Open Studio


tRedshiftCommit

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.

Si vous utilisez un lien de type Row >Main


pour relier le tRedshiftCommit votre Job, vos
donnes seront commites ligne par ligne. Dans ce
cas, ne cochez pas la case Close connection car
la connexion sera ferme avant la fin du commit
de votre premire ligne.
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 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.

Guide de rfrence des Composants de Talend Open Studio 1171


tRedshiftConnection

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.

Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion


partage.
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.

Notez que la fonctionnalit d'auto-commit permet de commiter chaque


instruction SQL comme transaction unique immdiatement aprs son excution
et que le composant de commit ne commite pas jusqu' ce que toutes les
instructions soient excutes. Pour cette raison, si vous avez besoin de plus

1172 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 1173


tRedshiftInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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 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 exact du schma.
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 sera cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.

1174 Guide de rfrence des Composants de Talend Open Studio


Proprits du tRedshiftInput

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 :

View schema : slectionnez cette option afin de voir le schma.

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 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.
Guess schema Cliquez sur ce bouton pour rcuprer le schma de la table.
Advanced Use cursor Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler
settings en une fois. Cette option permet d'optimiser les performances.
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 Supprime 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 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).

Guide de rfrence des Composants de Talend Open Studio 1175


Scnario : Manipuler des donnes avec Redshift

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 : Manipuler des donnes avec Redshift


Ce scnario dcrit un Job qui crit des informations personnelles dans Redshift puis rcupre ces informations et
les affiche dans la console.

The scnario utilise les six composants suivants :

un tRedshiftConnection, qui ouvre une connexion Redshift.

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 tRedshiftInput, qui lit les donnes depuis Redshift.

un tLogRow, qui affiche les donnes reues par le composant prcdent dans la console.

1176 Guide de rfrence des Composants de Talend Open Studio


Scnario : Manipuler des donnes avec Redshift

et un tRedshiftClose, qui ferme la connexion Redshift.

Dposer et relier les composants


1. Dposez les six composants lists prcdemment depuis la Palette dans l'espace de modlisation graphique.

2. Reliez le tFixedFlowInput au tRedshiftOutput l'aide d'un lien Row > Main.

3. Reliez le tRedshiftInput au tLogRow l'aide d'un lien Row > Main.

4. Reliez le tRedshiftConnection au tFixedFlowInput l'aide d'un lien Trigger > OnSubjobOk.

5. Reliez le tFixedFlowInput au tRedshiftInput et le tRedshiftInput au tRedshiftClose l'aide de liens


Trigger > OnSubjobOk.

Configurer les composants

Ouvrir une connexion Redshift

1. Double-cliquez sur le tRedshiftConnection afin d'ouvrir sa vue Basic settings.

2. Slectionnez Built-Indepuis la liste Property Type.

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.

Dfinir les donnes d'entre

1. Double-cliquez sur le tFixedFlowInput afin d'ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 1177


Scnario : Manipuler des donnes avec Redshift

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

Ecrire les donnes dans Redshift

1. Double-cliquez sur le composant tRedshiftOutput pour ouvrir sa vue Basic settings.

1178 Guide de rfrence des Composants de Talend Open Studio


Scnario : Manipuler des donnes avec Redshift

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.

5. Cliquez sur Sync columns afin de rcuprer le schma du composant prcdent.

Rcuprer les donnes de Redshift


1. Double-cliquez sur le tRedshiftInput pour ouvrir sa vue Basic settings.

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.

Afficher les informations dfinies


1. Double-cliquez sur le tLogRow pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 1179


Scnario : Manipuler des donnes avec Redshift

2. Dans la zone Mode, slectionnez Table (print values in cells of a table) pour un meilleur affichage des
rsultats.

Fermer la connexion Redshift


1. Double-cliquez sur le tRedshiftClose pour ouvrir sa vue Basic settings.

2. Dans la liste Component List, slectionnez la connexion prcdemment dfinie dans le


tRedshiftConnection.

Sauvegarder et excuter le Job


1. Appuyez sur les touches Ctrl+S afin de sauvegarder le Job.

2. Appuyez sur F6 pour l'excuter.

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.

1180 Guide de rfrence des Composants de Talend Open Studio


tRedshiftOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom exact du schma.
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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Guide de rfrence des Composants de Talend Open Studio 1181


Proprits du tRedshiftOutput

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear a table : supprimer le contenu de la table.


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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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
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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 Extend Insert Cochez cette case pour effectuer une insertion de masse d'un ensemble de lignes dfini et
settings non les insrer ligne par ligne. Le gain de performance est considrable.

1182 Guide de rfrence des Composants de Talend Open Studio


Proprits du tRedshiftOutput

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.

Guide de rfrence des Composants de Talend Open Studio 1183


Scnarios associs

Pour plus d'informations sur les niveaux 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.

1184 Guide de rfrence des Composants de Talend Open Studio


tRedshiftOutputBulk

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.

Famille de composant Databases/Amazon


Redshift
Fonction Le composant tRedshiftOutputBulk reoit des donnes du composant prcdent, gnre un fichier
dlimit/CSV et charge le fichier dans Amazon S3.
Objectif Ce composant vous permet de prparer un fichier dlimit/CSV pouvant tre utilis par le
tRedshiftBulkExec pour alimenter Amazon Redshift.
Basic settings Data file path at local Spcifiez le chemin d'accs local au fichier gnrer.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].
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.
Compress the data file Cochez cette case et slectionnez dans la liste un type de compression pour le
fichier de donnes.

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.

Guide de rfrence des Composants de Talend Open Studio 1185


Scnario associ

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ Secret


key, 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.
Bucket Saisissez le nom du bucket Amazon S3 dans lequel charger le fichier.
Key Saisissez la cl d'objet assigne au fichier charg dans Amazon S3.
Advanced settings Field Separator Saisissez le caractre utilis pour sparer les champs.
Text enclosure Slectionnez le caractre avec lequel entourer les champs.
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.
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.
Encoding Slectionnez un type d'encodage pour les donnes dans le fichier gnrer.
S3 Setting Config client Cochez cette case afin de configurer les paramtres clients pour Amazon S3.
Cliquez sur le bouton [+] sous la table pour ajouter autant de lignes que
ncessaire, chaque ligne pour un paramtre client et configurez les attributs
suivants pour chaque paramtre :

Client Parameter : cliquez dans la cellule et slectionnez un paramtre dans


la liste droulante.

Value : saisissez la valeur du paramtre client correspondant.


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 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 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.

1186 Guide de rfrence des Composants de Talend Open Studio


tRedshiftOutputBulkExec

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.

Famille de composant Databases/Amazon


Redshift
Fonction Le composant tRedshiftOutputBulkExec reoit des donnes du composant prcdent, gnre un fichier
dlimit/CSV, charge le fichier dans Amazon S3, puis charge les donnes d'Amazon S3 dans Redshift.
Objectif En tant que composant ddi, il permet un gain de performance pendant les oprations d'Insert dans
Amazon Redshift.
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.
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 :

None : n'effectuer aucune opration sur la table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis
en crer une nouvelle.

Clear table : supprimer le contenu de la table.

Guide de rfrence des Composants de Talend Open Studio 1187


Proprits du tRedshiftOutputBulkExec

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 :

View schema : slectionnez cette option afin de voir le schma.

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 Generate Setting Data file path at local Spcifiez le chemin d'accs local du fichier gnrer.

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ Secret


key, 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.
Bucket Saisissez le nom du bucket Amazon S3 dans lequel charger le fichier.
Key Saisissez la cl d'objet assigne au fichier charg dans Amazon S3.
Advanced settings Fields terminated by Saisissez le caractre utilis pour spare les champs.
Enclosed by Slectionnez le caractre avec lequel entourer les champs.
Compressed by Cochez cette case et slectionnez dans la liste un type de compression pour le
fichier de donnes.

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 :

NONE : aucun format de date n'est spcifi.

PATTERN : slectionnez cet lment et spcifiez le format de date dans le


champ affich. Le format de date par dfaut est YYYY-MM-DD.

AUTO : slectionnez cet lment si vous souhaitez que Amazon Redshift


reconnaisse et convertisse automatiquement le format de date.

1188 Guide de rfrence des Composants de Talend Open Studio


Proprits du tRedshiftOutputBulkExec

Time format Slectionnez l'un des lments suivants dans la liste, afin de spcifier le format
de l'heure dans les donnes source :

NONE : aucun format d'heure n'est spcifi.

PATTERN : slectionnez cet lment et spcifiez le format de l'heure


dans le champ affich. Le format de l'heure par dfaut est YYYY-MM-DD
HH:MI:SS.

AUTO : slectionnez cet lment si vous souhaitez qu'Amazon Redshift


reconnaisse et convertisse le format de l'heure.

EPOCHSECS : slectionnez cet lment si les donnes source sont


reprsentes comme temps epoch, soit le nombre de secondes depuis Jan 1,
1970 00:00:00 UTC.

EPOCHMILLISECS : slectionnez cet lment si les donnes source sont


reprsentes comme temps epoch, soit le nombre de millisecondes depuis
Jan 1, 1970 00:00:00 UTC.
Settings Cliquez sur le bouton [+] sous la table afin de spcifier plus de paramtres pour
le chargement des donnes.

Parameter : cliquez sur la cellule et slectionnez un paramtre dans la liste


droulante.

Value : configurez la valeur du paramtre correspondant. Notez que


vous ne pouvez configurer la valeur d'un paramtre (par exemple
IGNOREBLANKLINES) ne ncessitant pas de valeur.

Pour plus d'informations concernant les paramtres, consultez http://


docs.aws.amazon.com/redshift/latest/dg/r_COPY.html (en anglais).
S3 Setting Config client Cochez cette case afin de configurer les paramtres clients pour Amazon S3.
Cliquez sur le bouton [+] sous la table pour ajouter autant de lignes que
ncessaire, chaque ligne pour un paramtre client et configurez les attributs
suivants pour chaque paramtre :

Client Parameter : cliquez dans la cellule et slectionnez un paramtre dans


la liste droulante.

Value : saisissez la valeur du paramtre client correspondant.


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.

Guide de rfrence des Composants de Talend Open Studio 1189


Scnario associ

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.

1190 Guide de rfrence des Composants de Talend Open Studio


tRedshiftRollback

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.

Guide de rfrence des Composants de Talend Open Studio 1191


tRedshiftRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom exact 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.
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.

1192 Guide de rfrence des Composants de Talend Open Studio


Proprits du tRedshiftRow

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 :

View schema : slectionnez cette option afin de voir le schma.

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 lire.
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 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 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
PreparedStatement base 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

Guide de rfrence des Composants de Talend Open Studio 1193


Scnarios associs

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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL.

1194 Guide de rfrence des Composants de Talend Open Studio


tRedshiftUnload

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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Guide de rfrence des Composants de Talend Open Studio 1195


Proprits du tRedshiftUnload

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.

Pour saisir la cl secrte, cliquez sur le bouton [...] ct du champ Secret


key, 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.
Bucket Saisissez le nom du bucket Amazon S3 duquel retirer les donnes.
Key prefix Saisissez le prfixe du nom pour les fichiers retirer de Amazon S3. Par
dfaut, les fichiers retirs sont crits par slice du cluster Redshift et les noms
de fichiers sont crits au format <object_path>/<name_prefix><slice-
number>_part_<file-number>.
Advanced settings File type Slectionnez le type des fichiers retirs de Amazon S3 dans la liste :

Delimited file or CSV : fichier dlimit/CSV.

Fixed width : fichier taille fixe.


Fields terminated by Saisissez le caractre utilis pour sparer les champs.

Ce champ est disponible uniquement lorsque l'option Delimited file or CSV


est slectionne dans la liste File type.
Enclosed by Slectionnez le caractre par lequel entourer les champs.

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.

Ce champ est disponible uniquement lorsque l'option Fixed width est


slectionne dans la liste File type.
Compressed by Cochez cette case et, dans la liste qui s'affiche, slectionnez le type de
compression des fichiers.
Encrypt Cochez cette case pour crypter les fichiers retirs du ct client l'aide de
Amazon S3. Pour plus d'informations, consultez Unloading Encrypted Data
Files (en anglais).
Encryption key Saisissez la cl de cryptage utilise pour crypter les fichiers retirs.

Ce champ est disponible uniquement lorsque la case Encrypt est coche.


Specify null string Cochez cette case et, dans la liste qui s'affiche, slectionnez une chane de
caractres reprsentant une valeur nulle dans les fichiers retirs.
Escape Cochez cette case pour placer un caractre d'chappement (\) avant chaque
occurrence des caractres suivants pour les colonnes CHAR et VARCHAR
dans les fichiers dlimits retirs : interligne (\n), retour chariot (\r), le caractre
dlimiteur spcifi pour les donnes retires, le caractre d'chappement (\), un
guillemet (" ou ').
Overwrite s3 object if Cochez cette case pour craser les fichiers d'objets existant dans Amazon S3.
exist
Parallel Cochez cette case pour crire les donnes en parallle dans plusieurs fichiers
retirs dans Amazon S3 selon le nombre de slices dans le cluster Redshift.

1196 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 1197


tTeradataClose

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.

Pour un scnario associ au composant tTeradataClose, consultez tMysqlConnection.

1198 Guide de rfrence des Composants de Talend Open Studio


tTeradataCommit

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.

Si vous utilisez un lien de type Row > Main pour relier


le tTeradataCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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.
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.

Guide de rfrence des Composants de Talend Open Studio 1199


tTeradataConnection

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

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.
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.
Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires
parameters la connexion la base de donnes, afin de supporter des caractres
spcifiques. Exemple : CHARSET=KANJISIS_OS pour supporter
les caractres japonais.

Dans ce champ, vous pouvez paramtrer le type


d'encodage.
Use or register a shared DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
Advanced settings 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

1200 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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).
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.

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 au niveau du
composant.
Utilisation Ce composant est gnralement utilis avec des composants Teradata, notamment les composants
tTeradataCommit 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).
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.

Guide de rfrence des Composants de Talend Open Studio 1201


tTeradataFastExport

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.

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 platform Slectionnez le type de systme d'exploitation que vous utilisez.

Cette option est disponible en mode Use Commandline.


Host Adresse IP du serveur de base de donnes
Database name 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 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.
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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour


passer le schma en mode Built-In et effectuer des modifications
locales.

1202 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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].
Use query Cochez cette case afin d'afficher le champ Query o saisir
l'instruction SQL.

Cette option est disponible en mode Use Commandline.


Query Saisissez l'instruction SQL dans le champ Query.
Log database Nom de la base de donnes de log.

Cette option est disponible en mode Use Commandline.


Log table Nom de la table de log.

Cette option est disponible en mode Use Commandline.


Script generated folder Parcourez votre rpertoire et slectionnez la destination du fichier
qui sera cr.

Cette option est disponible en mode Use Commandline.


Exported file Nom et chemin d'accs au fichier qui sera cr.
Field separator Caractre, chane ou expression rgulire sparant les champs.
Row separator Chane de caractres (par exemple : "\n"sous Unix) pour sparer des
champs.

Cette option est disponible en mode Use Java API.


Error file Parcourez votre rpertoire et slectionnez la destination du fichier
dans lesquels seront enregistrs les messages d'erreur.

Cette option est disponible en mode Use Java API.


Advanced settings Output Deux options sont disponibles dans la liste :

Output error to file : crit en sortie l'erreur dans le fichier spcifi


dans le champ Error log et continue le traitement.

Output error to console : crit en sortie l'erreur dans la console et


arrte le traitement.

Disponible en mode Use Commandline.


tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
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 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.

Guide de rfrence des Composants de Talend Open Studio 1203


tTeradataFastLoad

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

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.
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 crer. Vous ne pouvez crer qu'une seule table
la fois.
Execute Batch every Nombre de lignes par lot charger.
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.
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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour


passer le schma en mode Built-In et effectuer des modifications
locales.

1204 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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 settings Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires
parameters la connexion 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_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.

Guide de rfrence des Composants de Talend Open Studio 1205


tTeradataFastLoadUtility

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

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 platform Slectionnez le type de systme d'exploitation que vous utilisez.
Host Nom de l'hte ou l'adresse IP du serveur de la base de donnes.
Database name 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 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.
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 :

View schema : slectionnez cette option afin de voir le schma.

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,

1206 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

slectionnez No et slectionnez nouveau la mtadonne du


schma dans la fentre [Repository Content].
Script generated folder Parcourez votre rpertoire et slectionnez la destination du fichier
qui sera cr.
Load file Entrez le nom du fichier partir duquel vous souhaitez charger les
donnes.
Field separator Caractre, chane ou expression rgulire sparant les champs.
Error file Parcourez votre rpertoire et slectionnez la destination du fichier
dans lesquels seront enregistrs les messages d'erreur.
Advanced settings Define character set Spcifiez l'encodage des caractres dont vous avez besoin pour
utiliser votre systme.
Check point Saisissez la valeur du point de validation.
Error files Saisissez le nom du fichier dans lequel les messages d'erreur sont
stocks. Par dfaut, le code saisi est ERRORFILES table_ERR1,
ce qui signifie que les deux tables table_ERR1 et table_ERR2 sont
utilises pour enregistrer les messages d'erreur.
Return fastload error Cochez cette case pour spcifier le code de retour partir duquel
retourner une erreur dans la console.
ERRLIMIT Saisissez le nombre limite d'erreurs dtectes durant la phase de
chargement. Le processus s'arrte lorsque la limite est atteinte.

Par dfaut, la valeur limite d'erreurs est de 1000000. Pour plus


d'informations, consultez la documentation Teradata FastLoad
Reference.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
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.

Guide de rfrence des Composants de Talend Open Studio 1207


tTeradataInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
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.

1208 Guide de rfrence des Composants de Talend Open Studio


Proprits du tTeradataInput

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

Guide de rfrence des Composants de Talend Open Studio 1209


Scnario associ

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, 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 : Charger des donnes dans une base de donnes Teradata.

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de paramtres de connexion
chargs dynamiquement.

1210 Guide de rfrence des Composants de Talend Open Studio


tTeradataMultiLoad

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.

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 platform Slectionnez le type de systme d'exploitation que vous utilisez.
Host Nom de l'hte ou l'adresse IP du serveur de la base de donnes.
Database name 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 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.
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 :

View schema : slectionnez cette option afin de voir le schma.

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,

Guide de rfrence des Composants de Talend Open Studio 1211


Proprits du tTeradataMultiLoad

slectionnez No et slectionnez nouveau la mtadonne du


schma dans la fentre [Repository Content].
Script generated folder Parcourez votre rpertoire et slectionnez la destination du fichier
qui sera cr.
Action to 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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si


l'enregistrement avec la rfrence donne existe dj, une mise jour
est effectue.

Delete : Supprimer les entres correspondantes au flux d'entre.

Il est ncessaire de spcifier au minimum une cl de


recherche sur laquelle baser les oprations Update et
Delete. Il est possible de dfinir les colonnes qui agiront
comme cl de recherche partir du schma, pour une
utilisation de base, ou partir des options avances
(Advanced settings) pour une utilisation optimise de ces
oprations.
Where condition in case Saisissez une condition, qui, si elle est vrifie, supprimera la ligne.
Delete
Ce champ apparat uniquement lorsque Delete est slectionn dans
la liste droulante Action to data.
Load file Entrez le nom du fichier partir duquel vous souhaitez charger les
donnes.
Field separator Caractre, chane ou expression rgulire sparant les champs.
Error file Parcourez votre rpertoire et slectionnez la destination du fichier
dans lesquels seront enregistrs les messages d'erreur.
Advanced settings Define Log table Cochez cette case pour dfinir la table de log que vous souhaitez
utiliser au lieu de celle par dfaut, savoir celle que vous avez dfinie
dans l'onglet Basic settings. La syntaxe requise pour dfinir la table
de log est databasename.logtablename.
BEGIN LOAD Ce champ vous permet de dfinir votre commande BEGIN LOAD
pour lancer ou relancer une tche TPump. Vous pouvez spcifiez le
nombre de sessions utiliser, la limite d'erreurs, ainsi que tout autre
paramtre ncessaire l'excution de la tche.

Pour plus d'informations, consultez la documentation Teradata


MultiLoad Reference.
Return mload error Cochez cette case pour spcifier le code de retour partir duquel
retourner une erreur dans la console.
Define character set Spcifiez l'encodage des caractres dont vous avez besoin pour
utiliser votre systme.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
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.

1212 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 1213


tTeradataOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

1214 Guide de rfrence des Composants de Talend Open Studio


Proprits du tTeradataOutput

Create table if doesn't exist : crer la table si ncessaire.

Clear a table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de


Rollback.
Create Elle n'est pas visible par dfaut, sauf si vous choisissez de crer une table partir de la liste
droulante Action on table. La table crer peut tre :

-SET TABLE: table ne permettant pas de dupliquer les lignes.

-MULTI SET TABLE : table permettant de dupliquer les lignes.


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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

Guide de rfrence des Composants de Talend Open Studio 1215


Proprits du tTeradataOutput

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 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.
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

1216 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

Guide de rfrence des Composants de Talend Open Studio 1217


tTeradataRollback

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.

1218 Guide de rfrence des Composants de Talend Open Studio


tTeradataRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 1219


Proprits du tTeradataRow

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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

1220 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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 :

Scnario : Charger des donnes dans une base de donnes Teradata.

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

Guide de rfrence des Composants de Talend Open Studio 1221


tTeradataTPTExec

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.

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 concernant la connexion la base de donnes sont
alors pr-remplis l'aide des donnes collectes.
Execution platform Slectionnez le type de systme d'exploitation utilis pour excuter
le Job, Windows ou Unix.
TDPID Spcifiez le Director program identifier de Teradata. Cela peut-tre
le nom ou l'adresse IP de la base de donnes Teradata laquelle vous
accdez.

Database name Saisissez dans ce champ le nom de la base de donnes Teradata.


Username et Password Spcifiez l'identifiant et mot de passe de l'utilisateur de la base de
donnes Teradata.

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.

Il est recommand de ne pas utiliser le mot-cl Teradata


Database comme nom de colonne de base de donnes. Si
vous y tes oblig, le nom de la colonne de base de donnes
doit alors tre entour par \". Par exemple, lorsque le mot-
cl id est utilis comme nom de colonne d'une base de
donnes, le champ Db Column doit tre renseign par \"id
\".
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 :

1222 Guide de rfrence des Composants de Talend Open Studio


Proprits du tTeradataTPTExec

View schema : slectionnez cette option afin de voir le schma.

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].
Consumer Operator Slectionnez un oprateur dans la liste droulante.

Load : charge un grand volume de donnes dans une table vide


dans la base de donnes Teradata l'aide de l'utilitaire Teradata
FastLoad utility.

Inserter : insre les donnes dans une table dfinie dans la base
de donnes Teradata.

Update : ralise des insertions, des mises jour ou des


suppressions dans une table nouvellement cre ou dj existante
de la base de donnes Teradata l'aide de l'utilitaire Teradata
MultiLoad utility.

Stream : ralise des insertions, des mises jour ou des


suppressions dans une table nouvellement cre ou dj existante
de la base de donnes Teradata l'aide de l'utilitaire Teradata
TPump.

Pour plus d'informations concernant cet oprateur, consultez http://


developer.teradata.com/sites/all/files/documentation/linked_docs/
html/online/B035-2436-088A/wwhelp/wwhimpl/js/html/
wwhelp.htm (en anglais).
Action on data Slectionnez dans la liste droulante une action effectuer sur les
donnes.

Insert : ajouter de nouvelles entres la table. Le Job s'arrte


lorsqu'il dtecte des doublons.

Update : mettre jour des entres dj existantes dans la table.

InsertOrUpdate : ajouter de nouvelles entres. Une mise jour


sera effectue si l'entre avec la rfrence donne existe dj.

Delete : Supprimer des entres correspondant au flux d'entre.

Ce champ apparat uniquement lorsque l'oprateur Update ou


Stream est slectionn dans la liste droulante Consumer
Operator.
Producer Operator Slectionnez un oprateur dans la liste droulante. Seul l'oprateur
DataConnector est actuellement support.

Pour plus d'informations concernant cet oprateur, consultez http://


developer.teradata.com/sites/all/files/documentation/linked_docs/
html/online/B035-2436-088A/wwhelp/wwhimpl/js/html/
wwhelp.htm (en anglais).
Table Spcifiez le nom de la table crire dans la base de donnes Teradata.
Notez que vous ne pouvez crire qu'une table la fois.
Script generated folder Spcifiez le rpertoire sous lequel le fichier script Teradata Parallel
Transporter sera cr durant l'excution du Job puis supprim avant
la fin du Job.
Load file Spcifiez le fichier contenant les donnes charger dans la base de
donnes Teradata.
Error file Spcifiez le fichier dans lequel les messages de log seront
enregistrs.

Guide de rfrence des Composants de Talend Open Studio 1223


Proprits du tTeradataTPTExec

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.

Ce champ apparat uniquement lorsque la case Set Script


Parameters est coche.
Data Connector Spcifiez le connecteur de donnes.

Ce champ apparat uniquement lorsque la case Set Script


Parameters est coche.
Job Name Spcifiez le nom du Job TPT (Teradata Parallel Transporter) dfini
via la commande Teradata tbuild.

Pour plus d'informations concernant la commande


tbuild, consultez http://developer.teradata.com/sites/all/files/
documentation/linked_docs/html/online/B035-2436-088A/wwhelp/
wwhimpl/js/html/wwhelp.htm (en anglais).

Ce champ apparat uniquement lorsque la case Set Script


Parameters est coche.
Layout Name(schema) Spcifiez un schma pour le chargement des donnes.

Ce champ apparat uniquement lorsque la case Set Script


Parameters est coche.
Return mload error Cochez cette case pour spcifier le code de retour partir duquel
retourner une erreur dans la console.
Define character set Cochez cette case pour spcifier l'encodage des caractres utiliser
dans votre systme.
Apply TPT consumer Cochez cette case afin de dfinir les attributs facultatifs pour
operator optional attributes l'oprateur du consommateur slectionn.

Pour plus d'informations concernant les attributs facultatifs


de chaque oprateur de consommateur, consultez le Guide
Teradata Parallel Transporter Reference (en anglais)
l'adresse suivante : http://developer.teradata.com/sites/all/files/
documentation/linked_docs/2436020A_TPT-Reference-13.10.pdf.
Optional attributes Cliquez sur le bouton [+] sous la table pour ajouter autant des
lignes que ncessaire pour chaque attribut facultatif. Configurez les
paramtres comme suit pour chaque attribut :

Name : cliquez dans la cellule et slectionnez un attribut


facultatif dans la liste droulante. La liste des attributs facultatifs
varie selon l'oprateur du consommateur slectionn. Pour
plus d'informations concernant les attributs facultatifs pour
chaque oprateur du consommateur, consultez Attributs facultatifs
supports pour chaque oprateur de consommateur.

Value : saisissez la valeur de l'attribut facultatif.

Pour plus d'informations concernant la dfinition


de la valeur d'un attribut, consultez le Guide
Teradata Parallel Transporter Reference (en anglais)
l'adresse suivante : http://developer.teradata.com/sites/all/files/
documentation/linked_docs/2436020A_TPT-Reference-13.10.pdf.

Cette table apparat uniquement lorsque la case Apply TPT


consumer operator optional attributes est coche.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.

1224 Guide de rfrence des Composants de Talend Open Studio


Proprits du tTeradataTPTExec

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.

Attributs facultatifs supports pour chaque oprateur de


consommateur
Cette section liste tous les attributs facultatifs supports pour chaque oprateur de consommateur.

Pour l'oprateur Load :

BufferSize, ErrorLimit, MaxSessions, MinSessions, TenacityHours, TenacitySleep, AccountId,


DataEncryption, DateForm, ErrorTable1, ErrorTable2, LogonMech, LogonMechData, NotifyExit,
NotifyExitlsDLL, NotifyLevel, NotifyMethod, LogSQL, NotifyString, PauseAcq, PrivateLogName,
QueryBandSessInfo, WildcardInsert, WorkingDatabase, TraceLevel.

Pour l'oprateur Inserter :

AccountId, DataEncryption, DateForm, LogonMech, LogonMechData, LogSQL, PrivateLogName,


QueryBandSessInfo, ReplicationOverride, TraceLevel, WorkingDatabase.

Pour l'oprateur Update :

PrivateLogName, BufferSize, ErrorLimit, MaxSessions, MinSessions, TenacityHours, TenacitySleep,


AccountId, AmpCheck, DataEncryption, DateForm, DeleteTask, DropErrorTable, DropLogTable,
DropWorkTable, ErrorTable1, ErrorTable2, LogonMech, LogonMechData, LogSQL, NotifyExit,
NotifyExitIsDLL, NotifyLevel, NotifyMethod, NotifyString, PauseAcq, QueryBandSessInfo,
QueueErrorTable, WorkingDatabase, WorkTable, TraceLevel.

Pour l'oprateur Stream :

Buffers, ErrorLimit, MaxSessions, MinSessions, Pack, Rate, Periodicity, TenacityHours, TenacitySleep,


AccountId, AppendErrorTable, ArraySupport, DataEncryption, DateForm, DropErrorTable, DropMacro,
ErrorTable, LogonMech, LogonMechData, MacroDatabase, OperatorCommandID, NotifyExit,
NotifyExitlsDLL, NotifyLevel, NotifyMethod, LogSQL, NotifyString, PackMaximum, PrivateLogName,
QueryBandSessInfo, QueueErrorTable, ReplicationOverrride, Robust, WorkingDatabase, TraceLevel.

Guide de rfrence des Composants de Talend Open Studio 1225


Scnario : Charger des donnes dans une base de donnes Teradata

Scnario : Charger des donnes dans une base de


donnes Teradata
Ce scnario dcrit un Job crant une table dans une base de donnes Teradata, crivant des donnes dans un fichier
dlimit, chargeant ces donnes du fichier dans la table, rcuprant les donnes de la table et les affichant dans
la console.

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. Reliez le tFixedFlowInput au tFileOutputDelimited l'aide d'un lien Row > Main.

3. Connectez le tTeradataInput au tLogRow avec le mme type de lien.

4. Reliez le tTeradataRow au tFixedFlowInput l'aide d'un lien Trigger > OnSubjobOk.

5. Connectez le tFixedFlowInput au TeradataTPTExec et le TeradataTPTExec au tTeradataInput l'aide


du mme type de lien.

1226 Guide de rfrence des Composants de Talend Open Studio


Scnario : Charger des donnes dans une base de donnes Teradata

Configurer les composants

Crer une nouvelle table d'une base de donnes Teradata

1. Double-cliquez sur le tTeradataRow pour ouvrir sa vue Basic settings.

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.

CREATE SET TABLE samples.person,


FALLBACK,
NO BEFORE JOURNAL,
NO AFTER JOURNAL
(
id INTEGER NOT NULL,
name VARCHAR(50),
sex VARCHAR(20)
)
UNIQUE PRIMARY INDEX (id)

Prparer les donnes source

1. Double-cliquez sur le composant tFixedFlowInput pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 1227


Scnario : Charger des donnes dans une base de donnes Teradata

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

6. Double-cliquez sur le tFileOutputDelimited pour ouvrir sa vue Basic settings.

1228 Guide de rfrence des Composants de Talend Open Studio


Scnario : Charger des donnes dans une base de donnes Teradata

7. Dans le champ File Name, spcifiez le fichier dans lequel crire les donnes d'entre. Dans cet exemple,
saisissez E:/person.csv.

Charger les donnes sources dans une table vide


1. Double-cliquez sur le TeradataTPTExec pour ouvrir sa vue Basic settings.

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.

Guide de rfrence des Composants de Talend Open Studio 1229


Scnario : Charger des donnes dans une base de donnes Teradata

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.

Cliquez sur OK pour valider ces modifications et fermer l'diteur du schma.

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.

Rcuprez les donnes de la table de base de donnes Teradata

1. Double-cliquez sur le tTeradataInput pour ouvrir sa vue Basic settings.

1230 Guide de rfrence des Composants de Talend Open Studio


Scnario : Charger des donnes dans une base de donnes Teradata

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.

7. Double-cliquez sur le tLogRow pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 1231


Scnario : Charger des donnes dans une base de donnes Teradata

8. Dans la zone Mode, slectionnez l'option Table (print values in cells of a table) pour un affichage optimal
des rsultats.

Sauvegarder et excuter le Job


1. Appuyez sur les touches Ctrl + S pou sauvegarder le Job.

2. Appuyez sur F6 pour l'excuter.

Les donnes crites dans la table de la bases de donnes Teradata spcifie sont affiches dans la console.

1232 Guide de rfrence des Composants de Talend Open Studio


tTeradataTPTUtility

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.

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 concernant la
connexion la base de donnes sont alors pr-remplis l'aide des
donnes collectes.
Execution platform Slectionnez le type de systme d'exploitation utilis pour excuter le
Job, Windows ou Unix.
TDPID Spcifiez le Director program identifier de Teradata. Cela peut-tre le
nom ou l'adresse IP de la base de donnes Teradata laquelle vous
accdez.
Database name Saisissez dans ce champ le nom de la base de donnes Teradata.
Username et Password Spcifiez l'identifiant et mot de passe de l'utilisateur de la base de
donnes Teradata.

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.

Il est recommand de ne pas utiliser le mot-cl Teradata


Database comme nom de colonne de base de donnes. Si
vous y tes oblig, le nom de la colonne de base de donnes
doit alors tre entour par \". Par exemple, lorsque le mot-cl

Guide de rfrence des Composants de Talend Open Studio 1233


Proprits du tTeradataTPTUtility

id est utilis comme nom de colonne d'une base de donnes,


le champ Db Column doit tre renseign par \"id\".
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 :

View schema : slectionnez cette option afin de voir le schma.

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].
Consumer Operator Slectionnez un oprateur dans la liste droulante.

Load : Charge un grand volume de donnes dans une table vide


dans la base de donnes Teradata l'aide de l'utilitaire Teradata
FastLoad utility.

Inserter : Insre les donnes dans une table dfinie dans la base de
donnes Teradata.

Update : Ralise des insertions, des mises jour ou des


suppressions dans une table nouvellement cre ou dj existante
de la base de donnes Teradata l'aide de l'utilitaire Teradata
MultiLoad utility.

Stream : Ralise des insertions, des mises jour ou des


suppressions dans une table nouvellement cre ou dj existante de
la base de donnes Teradata l'aide de l'utilitaire Teradata TPump.

Pour plus d'informations concernant cet oprateur,


consultez http://developer.teradata.com/sites/all/files/documentation/
linked_docs/html/online/B035-2436-088A/wwhelp/wwhimpl/js/
html/wwhelp.htm (en anglais).
Action on data Slectionnez dans la liste droulante une action effectuer sur les
donnes.

Insert : Ajouter de nouvelles entres la table. Le Job s'arrte


lorsqu'il dtecte des doublons.

Update : Mettre jour des entres dj existantes dans la table.

InsertOrUpdate : Ajouter de nouvelles entres. Une mise jour


sera effectue si l'entre avec la rfrence donne existe dj.

Delete : Supprimer des entres correspondant au flux d'entre.

Vous devez spcifier au moins une colonne comme cl


primaire sur laquelle baser l'opration Update ou Delete.
Cela est faisable en cliquant sur le bouton [...] ct du
champ Edit schema et en cochant la case de la (des)
colonne(s) dfinir comme cl(s) primaire(s).

Ce champ apparat uniquement lorsque l'oprateur Update ou Stream


est slectionn dans la liste droulante Consumer Operator.
Producer Operator Slectionnez un oprateur dans la liste droulante. Seul l'oprateur
DataConnector est actuellement support.

1234 Guide de rfrence des Composants de Talend Open Studio


Proprits du tTeradataTPTUtility

DataConnector : accde aux fichiers directement ou via un module


d'accs, puis les crit dans le flux de donnes.

Pour plus d'informations concernant cet oprateur,


consultez http://developer.teradata.com/sites/all/files/documentation/
linked_docs/html/online/B035-2436-088A/wwhelp/wwhimpl/js/
html/wwhelp.htm (en anglais).
Table Spcifiez le nom de la table crire dans la base de donnes Teradata.
Notez que vous ne pouvez crire qu'une table la fois.
Script generated folder Spcifiez le rpertoire sous lequel le fichier script Teradata Parallel
Transporter sera cr durant l'excution du Job puis supprim avant
la fin du Job.
Error file Spcifiez le fichier dans lequel les messages de log seront enregistrs.
Advanced settings Row separator Caractre, chane ou expression rgulire sparant les lignes.
Field separator Caractre, chane ou expression rgulire sparant les champs.
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.
Set Script Parameters Cochez cette case pour spcifier la valeur des paramtres Load
Operator, Data Connector, Job Name, et 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.

Ce champ apparat uniquement lorsque la case Set Script Parameters


est coche.
Data Connector Spcifiez le connecteur de donnes.

Ce champ apparat uniquement lorsque la case Set Script Parameters


est coche.
Job Name Spcifiez le nom du Job TPT (Teradata Parallel Transporter) dfini
via la commande Teradata tbuild.

Pour plus d'informations concernant la commande tbuild,


consultez http://developer.teradata.com/sites/all/files/documentation/
linked_docs/html/online/B035-2436-088A/wwhelp/wwhimpl/js/
html/wwhelp.htm (en anglais).

Ce champ apparat uniquement lorsque la case Set Script Parameters


est coche.
Layout Name(schema) Spcifiez un schma pour le chargement des donnes.

Ce champ apparat uniquement lorsque la case Set Script Parameters


est coche.
Define Log table Cochez cette case pour spcifiez le nom de table de log.
Return mload error Cochez cette case pour spcifier le code de retour partir duquel
retourner une erreur dans la console.
Define character set Cochez cette case pour spcifier l'encodage des caractres utiliser
dans votre systme.
Apply TPT consumer Cochez cette case afin de dfinir les attributs facultatifs pour
operator optional attributes l'oprateur du consommateur slectionn.

Pour plus d'informations concernant les attributs facultatifs


de chaque oprateur de consommateur, consultez le Guide
Teradata Parallel Transporter Reference (en anglais) l'adresse
suivante : http://developer.teradata.com/sites/all/files/documentation/
linked_docs/2436020A_TPT-Reference-13.10.pdf.
Optional attributes Cliquez sur le bouton [+] sous la table pour ajouter autant des
lignes que ncessaire pour chaque attribut facultatif. Configurez les
paramtres comme suit pour chaque attribut :

Guide de rfrence des Composants de Talend Open Studio 1235


Scnario associ

Name : cliquez dans la cellule et slectionnez un attribut facultatif


dans la liste droulante. La liste des attributs facultatifs varie selon
l'oprateur du consommateur slectionn. Pour plus d'informations
concernant les attributs facultatifs pour chaque oprateur du
consommateur, consultez Attributs facultatifs supports pour
chaque oprateur de consommateur.

Value : saisissez la valeur de l'attribut facultatif.

Pour plus d'informations concernant la dfinition de


la valeur d'un attribut, consultez le Guide Teradata
Parallel Transporter Reference (en anglais) l'adresse
suivante : http://developer.teradata.com/sites/all/files/documentation/
linked_docs/2436020A_TPT-Reference-13.10.pdf.

Cette table apparat uniquement lorsque la case Apply TPT consumer


operator optional attributes est coche.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
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 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.

1236 Guide de rfrence des Composants de Talend Open Studio


tTeradataTPump

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

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 platform Slectionnez le type de systme d'exploitation que vous utilisez.
Host Nom de l'hte ou l'adresse IP du serveur de la base de donnes.
Database name 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 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.
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 :

View schema : slectionnez cette option afin de voir le schma.

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,

Guide de rfrence des Composants de Talend Open Studio 1237


Proprits du tTeradataTPump

slectionnez No et slectionnez nouveau la mtadonne du


schma dans la fentre [Repository Content].
Script generated folder Parcourez votre rpertoire et slectionnez la destination du fichier
qui sera cr.
Action to 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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si


l'enregistrement avec la rfrence donne existe dj, une mise jour
est effectue.

Delete : Supprimer les entres correspondantes au flux d'entre.

Il est ncessaire de spcifier au minimum une cl de


recherche sur laquelle baser les oprations Update et
Delete. Il est possible de dfinir les colonnes qui agiront
comme cl de recherche partir du schma, pour une
utilisation de base, ou partir des options avances
(Advanced settings) pour une utilisation optimise de ces
oprations.
Where condition in case Saisissez une condition, qui, si elle est vrifie, supprimera la ligne.
Delete
Ce champ apparat uniquement lorsque Delete est slectionn dans
la liste droulante Action to data.
Load file Entrez le nom du fichier partir duquel vous souhaitez charger les
donnes.
Field separator Caractre, chane ou expression rgulire sparant les champs.
Error file Parcourez votre rpertoire et slectionnez la destination du fichier
dans lesquels seront enregistrs les messages d'erreur.
Advanced settings Define Log table Cochez cette case pour dfinir la table de log que vous souhaitez
utiliser au lieu de celle par dfaut, savoir celle que vous avez dfinie
dans l'onglet Basic settings. La syntaxe requise pour dfinir la table
de log est databasename.logtablename.
BEGIN LOAD Ce champ vous permet de dfinir votre commande BEGIN LOAD
pour lancer ou relancer une tche TPump. Vous pouvez spcifiez le
nombre de sessions utiliser, la limite d'erreurs, ainsi que tout autre
paramtre ncessaire l'excution de la tche. La valeur par dfaut
est :

SESSIONS 8 PACK 600 ARRAYSUPPORT ON CHECKPOINT 60


TENACITY 2 ERRLIMIT 1000.

Pour plus d'informations, consultez la documentation Teradata


Parallel Data Pump Reference.
Return tpump error Cochez cette case pour spcifier le code de retour partir duquel
retourner une erreur dans la console.
Define character set Spcifiez l'encodage des caractres dont vous avez besoin pour
utiliser votre systme.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
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.

1238 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes dans une table d'une base de donnes Teradata

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl
+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez 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 : Insrer des donnes dans une table d'une


base de donnes Teradata
Dans ce scnario, l'objectif est de crer un Job utilisant le composant tTeradataTPump pour insrer des donnes
clients dans une table d'une base de donnes Teradata et retourner la valeur de retour lorsqu'une erreur se produit.

Trois composants sont utiliss pour implmenter cette tche :

tRowGenerator : gnre autant de lignes que ncessaire, en utilisant au hasard des donnes clients prises dans
une liste.

tFileOutputDelimited : crit les donnes clients dans un fichier dlimit.

tTeradataTPump : insre les donnes clients dans la table de la base de donnes Teradata en mode Tpump.

Dposer les composants


1. Dposez les composants suivants de la Palette dans l'espace de modlisation graphique : tRowGenerator,
tFileOutputDelimited, tTeradataTPump.

2. Liez le tRowGenerator au tFileOutputDelimited l'aide d'un lien Row > Main.

3. Liez le tRowGenerator au tTeradataTPump l'aide d'un lien Trigger > OnSubjobOk.

Guide de rfrence des Composants de Talend Open Studio 1239


Scnario : Insrer des donnes dans une table d'une base de donnes Teradata

Configurer les composants


1. Double-cliquez sur le tRowGenerator pour ouvrir la fentre [RowGenerator Editor].

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.

1240 Guide de rfrence des Composants de Talend Open Studio


Scnario : Insrer des donnes dans une table d'une base de donnes Teradata

Cliquez sur Edit schema et vrifiez que le schma est retrouv partir du schma d'entre. Au besoin, cliquez
sur Sync Columns.

5. Double-cliquez sur le composant tTeradataTPump afin d'ouvrir sa vue Component.

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.

11. Dans le champ Action on data, slectionnez l'option Insert.

Guide de rfrence des Composants de Talend Open Studio 1241


Scnario : Insrer des donnes dans une table d'une base de donnes Teradata

Excuter le Job
1. Appuyez sur F6 pour excuter le Job.

2. La console de la vue Run s'affiche ainsi :

3. Double-cliquez sur le composant tTeradataTPump pour retourner sa vue Component.

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.

5. Appuyez sur F6 pour excuter le Job.

6. La console de la vue Run s'affiche ainsi :

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.

1242 Guide de rfrence des Composants de Talend Open Studio


tVectorWiseCommit

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.

Si vous utilisez un lien de type Row > Main pour relier


le tVectorWiseCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 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.

Guide de rfrence des Composants de Talend Open Studio 1243


tVectorWiseConnection

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

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.
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 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 DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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.

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement

1244 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

aprs son excution et que le composant de commit ne commite


pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 au niveau du
composant.
Utilisation Ce composant est gnralement utilis avec des composants VectorWise, notamment les
composants tVectorWiseCommit 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).
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.

Guide de rfrence des Composants de Talend Open Studio 1245


tVectorWiseInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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 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.

1246 Guide de rfrence des Composants de Talend Open Studio


Proprits du tVectorWiseInput

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 :

View schema : slectionnez cette option afin de voir le schma.

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 Saisissez le nom de la table.
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.
Guess Query Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de
votre table dans le champ Query.
Guess schema Cliquez sur le bouton pour rcuprer le schma de la table.
Advanced settings 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 Dans la colonne Column, saisissez le nom de la colonne dans laquelle 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
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 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.

Guide de rfrence des Composants de Talend Open Studio 1247


Scnario associ

Scnario associ
Pour un scnario associ, consultez les scnarios du composant gnrique tDBInput :

Scnario 1 : Afficher les donnes slectionnes partir d'une table

Scnario 2 : Utiliser la variable StoreSQLQuery

Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du tContextLoad.

1248 Guide de rfrence des Composants de Talend Open Studio


tVectorWiseOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de lire


la connexion enregistre.

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.
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.
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.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Guide de rfrence des Composants de Talend Open Studio 1249


Proprits du tVectorWiseOutput

Clear a table : supprimer le contenu de la table.


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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence donne


existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement n'existe
pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default+values


+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

1250 Guide de rfrence des Composants de Talend Open Studio


Proprits du tVectorWiseOutput

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.

Guide de rfrence des Composants de Talend Open Studio 1251


Scnario associ

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

1252 Guide de rfrence des Composants de Talend Open Studio


tVectorWiseRollback

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.

Guide de rfrence des Composants de Talend Open Studio 1253


tVectorWiseRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
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.
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 :

1254 Guide de rfrence des Composants de Talend Open Studio


Proprits du tVectorWiseRow

View schema : slectionnez cette option afin de voir le schma.

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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

Guide de rfrence des Composants de Talend Open Studio 1255


Scnario associ

Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus d'informations sur cette
fonctionnalit, consultez le Guide utilisateur du Studio Talend.

Pour plus d'informations sur les niveaux 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 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

1256 Guide de rfrence des Composants de Talend Open Studio


tVerticaBulkExec

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

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.
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 utiliser.
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.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table slectionne :

None : n'effectuer aucune opration de table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Guide de rfrence des Composants de Talend Open Studio 1257


Proprits du tVerticaBulkExec

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle.

Clear table : supprimer le contenu de la table.


Table Nom de la table crire. Notez qu'une seule table peut tre crite la fois.
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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

Bulk update : Effectuer des modifications simultanes sur diffrentes entres.


Write to ROS Cochez cette case pour stocker les donnes dans une mmoire physique, et ainsi optimiser la
(Read lecture de ces donnes, puisqu'elles seront compresses et pr-tries.
Optimized
Store)
Exit job if Le Job s'arrte automatiquement si aucune ligne n'a t charge.
no row was
loaded
Fields Caractre, chane ou expression rgulire sparant les champs.
terminated by
Null string Chane de caractres affiche pour signifier que la valeur est nulle.
Rejected data Spcifiez le fichier dans lequel vous souhaitez que soient crites les lignes rejetes.
file
Exception log Spcifiez le fichier dans lequel vous souhaitez que soit crite une explication pour chaque ligne
file rejete.
tStatCatcher Cochez cette case pour collecter les donnes de log au niveau du composant.
Statistics

1258 Guide de rfrence des Composants de Talend Open Studio


Conseils et techniques

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.

Guide de rfrence des Composants de Talend Open Studio 1259


tVerticaClose

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.

Pour un scnario associ au composant tVerticaClose, consultez tMysqlConnection.

1260 Guide de rfrence des Composants de Talend Open Studio


tVerticaCommit

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.

Si vous utilisez un lien de type Row > Main pour


relier le tVerticaCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 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).

Guide de rfrence des Composants de Talend Open Studio 1261


Scnario associ

Scnario associ
Pour plus d'informations relatives au fonctionnement du composant tVerticaCommit, consultez Scnario 1 :
Insrer des donnes dans des tables mre/fille.

1262 Guide de rfrence des Composants de Talend Open Studio


tVerticaConnection

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

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 dans la liste la version de Vertica 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.
Table 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.
Additional JDBC Ajoutez des paramtres JDBC supplmentaires ncessaires la
Parameters connexion la base de donnes.
Use or register a shared DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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

Guide de rfrence des Composants de Talend Open Studio 1263


Conseils et techniques

doivent tre commites de manire explicite l'aide du composant


correspondant de commit.

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 au niveau du
composant.
Utilisation Ce composant est gnralement utilis avec des composants Vertica, notamment les composants
tVerticaCommit 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).
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.

1264 Guide de rfrence des Composants de Talend Open Studio


tVerticaInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

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.
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.
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 sera cr et conserv pour ce composant seulement. Voir galement le
Guide utilisateur du Studio Talend.

Guide de rfrence des Composants de Talend Open Studio 1265


Proprits du tVerticaInput

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 :

View schema : slectionnez cette option afin de voir le schma.

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

1266 Guide de rfrence des Composants de Talend Open Studio


Conseils et techniques

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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

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.

Guide de rfrence des Composants de Talend Open Studio 1267


tVerticaOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Username Informations d'authentification de l'utilisateur de base de donnes
et
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 La liste Action on table est indisponible si vous cochez la case Enable parallel
table execution dans la vue Advanced settings.

Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table slectionne :

Default : n'effectuer aucune opration de table.

1268 Guide de rfrence des Composants de Talend Open Studio


Proprits du tVerticaOutput

Drop and create table : supprimer la table puis en crer une nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle.

Clear table : supprimer le contenu de la table.


Use "drop Cette case est disponible lorsque vous slectionnez l'option relative la suppression
cascade" de table dans la liste Action on table.

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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence donne


existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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

Guide de rfrence des Composants de Talend Open Studio 1269


Proprits du tVerticaOutput

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 Cette case est coche par dfaut et stoppe le Job en cas d'erreur. Dcochez cette case pour terminer
error 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.
Commit Nombre de lignes inclure dans le lot avant de commencer l'criture dans la base. Cette
every option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure
performance d'excution.
Paramtres Copy Abort on Cochez cette case afin d'arrter l'opration de copie (Copy) sur les donnes si une ligne est rejete
error et annule cette opration. Ainsi, aucune donne n'est traite.
Cette zone
est
uniquement
disponible
si vous avez
choisi Copy
dans la
liste Action
on data.
Pour des
informations
plus
dtailles
concernant
les
paramtres
Copy,
consultez
votre
Manuel de
Rfrence
Vertica
SQL.
Maximum Saisissez un nombre afin de configurer la commande REJECTMAX utilise par Vertica,
rejects qui indique la limite maximale du nombre d'enregistrements logiques rejeter avant qu'un
chargement n'choue. Si ce nombre n'est pas spcifi ou si sa valeur est 0, le nombre de rejets
autoriss est illimit.
No commit Cochez cette case pour empcher l'opration actuelle de commiter automatiquement.
Exception Saisissez le chemin d'accs, ou parcourez et slectionnez le fichier dans lequel sont crits les
file messages indiquant le nombre de lignes d'entre et la raison de chaque rejet d'enregistrement
de donnes.
Exception Indiquez quel est le nud du fichier d'exception. Si ce champ n'est pas renseign, le nud de
file node l'initiateur de la requte est choisi par dfaut.
Rejected Saisissez le chemin d'accs, ou parcourez et slectionnez le fichier dans lequel seront crites les
data file lignes rejetes. Ce fichier pourra ensuite tre modifi afin de rsoudre des problmes, et pourra
tre regnr.
Rejected Indiquez quel est le nud du fichier des donnes rejetes. Si ce champ n'est pas renseign, le
data file nud de l'initiateur de la requte est choisi par dfaut.
node
Use Batch Cochez cette case afin d'activer le mode batch pour le traitement des donnes. Dans le champ
mode 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.
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.

1270 Guide de rfrence des Composants de Talend Open Studio


Proprits du tVerticaOutput

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 tVerticaOutput 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
Support Cochez cette case afin d'autoriser les valeurs nulles dans l'instruction "SQL WHERE".
null in
"SQL
WHERE"
statement
Create Cochez cette case afin de crer une projection pour la table crer.
projection
when Cette case est disponible uniquement lorsque vous avez slectionn l'option de cration
create de table dans la liste Action on table de la vue Basic settings. Elle disparat lorsque
table vous cochez la case Enable parallel execution, dans la vue Advanced settings.
tStatCatcherCochez 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.

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.

Guide de rfrence des Composants de Talend Open Studio 1271


Conseils et techniques

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

1272 Guide de rfrence des Composants de Talend Open Studio


tVerticaOutputBulk

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.

Famille de composant Databases/Vertica


Fonction Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Vertica.
Objectif Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter 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.
File Name Nom du fichier gnrer.

Ce fichier est gnr sur la machine locale ou dans un dossier


partag sur le rseau local.
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
Schema 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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/


Verifying+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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

Guide de rfrence des Composants de Talend Open Studio 1273


Conseils et techniques

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 settings Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
Field separator Caractre, chane ou expression rgulire sparant les champs.
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
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 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.

Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

1274 Guide de rfrence des Composants de Talend Open Studio


tVerticaOutputBulkExec

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.

Famille de composant Databases/Vertica


Fonction Le composant tVerticaOutputBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tVerticaOutputBulkExec 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 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.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
DB Name 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 :

None : n'effectuer aucune opration de table.

Drop and create table : supprimer la table puis en crer une


nouvelle.

Create table : crer une table qui n'existe pas encore.

Create table if not exists : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe


dj, puis en crer une nouvelle.

Clear table : supprimer le contenu de la table.

Guide de rfrence des Composants de Talend Open Studio 1275


Proprits du 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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
File Name Nom du fichier gnrer et charger.

Ce fichier est gnr sur la mme machine que le Studio Talend ou


que le Job contenant le tVerticaOutputBulkExec puis est charg
dans la base de donnes spcifie dans le champ Host.
Append Cochez cette option pour ajouter des nouvelles lignes la fin du
fichier.
Advanced settings Additional JDBC Ajoutez des paramtres JDBC supplmentaires ncessaires la
Parameters connexion la base de donnes.

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.

1276 Guide de rfrence des Composants de Talend Open Studio


Conseils et techniques

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.

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 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.

Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Guide de rfrence des Composants de Talend Open Studio 1277


tVerticaRollback

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.

1278 Guide de rfrence des Composants de Talend Open Studio


tVerticaRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom exact du schma.
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.
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 :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 1279


Proprits du tVerticaRow

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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

1280 Guide de rfrence des Composants de Talend Open Studio


Conseils et techniques

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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du tMysqlRow.

Guide de rfrence des Composants de Talend Open Studio 1281


Guide de rfrence des Composants de Talend Open Studio
Databases - Autres composants
Le chapitre Databases - Autres composants dcrit les connecteurs donnant accs un ventail de bases de donnes
et fournissant les outils de gestion de bases de donnes. 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. Ces composants sont prsents dans la famille Databases de la Palette dans la perspective Integration
du Studio Talend.

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.

Guide de rfrence des Composants de Talend Open Studio


tCreateTable

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la vue


Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de lire


la connexion enregistre.

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.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
name
Schema Nom du schma. (DB2, Greenplum, Informix, Oracle, PostgresPlus, Postgresql, Vertica)
Username Informations d'authentification de l'utilisateur de base de donnes.
and
Password

1284 Guide de rfrence des Composants de Talend Open Studio


Proprits du tCreateTable

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default+values


+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

Guide de rfrence des Composants de Talend Open Studio 1285


Proprits du tCreateTable

Champs spcifiques certaines bases de donnes :

Access Access File Nom et chemin d'accs du fichier traiter.


Firebird Firebird File Nom et chemin d'accs du fichier traiter.
HSQLDb Running Mode Slectionnez dans la liste le type de serveur
correspondant aux paramtres de votre base
de donnes..
Use TLS/SSL Sockets Cochez cette case pour autoriser, si besoin,
le mode scuris.
DB Alias Nom de la base de donnes.
Case Sensitive Cochez cette case pour rendre sensible la
casse le nom de la table/colonne.
Interbase Interbase File Nom et chemin d'accs du fichier traiter.
JavaDb Framework Type Slectionnez dans la liste un framework
pour votre base de donnes.
Structure type Slectionnez dans la liste le type de
structure.
DB Root Path Parcourez votre systme jusqu' la racine
de votre base de donnes.
Mysql Temporary table Cochez cette case si vous souhaitez
sauvegarder temporairement la table cre.
ODBC ODBC Name Nom de la base de donnes.
Oracle Connection Type Liste droulante des pilotes disponibles:

Oracle SID : Slectionnez ce type de


connexion pour identifier exclusivement
une base de donnes spcifique sur un
systme.

Service Oracle : Slectionnez ce type


de connexion pour utiliser l'alias TNS
que vous fournissez lorsque vous vous
connectez la base de donnes distante.

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.

WALLET : Slectionnez ce type de


connexion pour stocker les informations
d'identification dans un portefeuille Oracle
(Oracle wallet).
SQLite SQLite File Nom et chemin d'accs au fichier traiter.

Pour plus d'informations, consultez le


Guide utilisateur du Studio Talend.
Teradata Create Slectionnez la table partir de la liste
droulante. La table crer peut tre :

-SET TABLE : table ne permettant pas de


dupliquer les lignes

-MULTI SET TABLE : table permettant


de dupliquer les lignes.

1286 Guide de rfrence des Composants de Talend Open Studio


Scnario : Crer une nouvelle table dans une base de donnes MySQL

Scnario : Crer une nouvelle table dans une base de


donnes MySQL
Le Job dcrit ci-dessous a t conu pour crer une nouvelle table dans une base de donnes, compose d'un schma
pris partir du schma d'un fichier dlimit stock dans le Repository. Ce Job est form d'un seul composant.

1. Cliquez et dposez un composant tCreateTable de la famille Databases de la Palette dans l'espace de


modlisation graphique.

2. Dans la liste Database type de l'onglet Basic settings de la vue Component, slectionnez Mysql.

3. Dans la liste droulante Table Action, slectionnez Create table.

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.

6. Dans le champ Table Name, saisissez le nom de la nouvelle table crer.

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.

Guide de rfrence des Composants de Talend Open Studio 1287


Scnario : Crer une nouvelle table dans une base de donnes MySQL

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.

10. Enregistrez votre Job et appuyez sur F6 pour l'excuter.

La table cre est vide mais elle contient toutes les colonnes dfinies dans le schma.

1288 Guide de rfrence des Composants de Talend Open Studio


tDBInput

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).

Pour des raisons de performances, prfrez toujours un composant Input spcifique au


composant gnrique.
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.
Database Nom de la source de donnes dfinie via l'assistant de configuration
de connexion une 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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 1289


Proprits du tDBInput

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 modifications
apportes aux donnes.
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.
Advanced settings Additional JDBC Spcifiez les proprits de connexion supplmentaires pour la
parameters connexion la base de donnes que vous crez.

Vous pouvez configurer les paramtres d'encodage dans


ce champ.
Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et en fin de
columns champ dans toutes les colonnes contenant des chanes de caractres.
Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes
slectionnes.
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.

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).

1290 Guide de rfrence des Composants de Talend Open Studio


Scnario 1 : Afficher les donnes slectionnes partir d'une table

Scnario 1 : Afficher les donnes slectionnes


partir d'une table
Le Job suivant, deux composants, lit les donnes d'une base via une requte et affiche dans la console (vue Run)
les donnes dlimites.

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.

7. Renseignez le nom de la table dans le champ Table Name.

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.

9. De la mme faon, cliquez sur le deuxime composant pour le dfinir.

10. Indiquez le sparateur de champs : il s'agit ici d'une barre verticale.

11. Passez sur la vue Run et cliquez sur le bouton Run pour excuter le Job.

Guide de rfrence des Composants de Talend Open Studio 1291


Scnario 2 : Utiliser la variable StoreSQLQuery

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.

Scnario 2 : Utiliser la variable StoreSQLQuery


La variable StoreSQLQuery peut tre utilise pour dboguer un scnario tDBInput qui ne s'excuterait pas
correctement. Elle permet d'alimenter la requte de votre composant tDBInput de manire dynamique.

1. Partez du scnario 1 dcrit ci-dessus, auquel vous ajouterez un composant tJava.

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.

4. Passez la vue appele Context.

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.

6. Cliquez sur le composant tJava et affichez la vue Component. Tapez la commande


System.Out.println("") pour afficher le contenu de la requte, puis, dans les parenthses, appuyez sur
Ctrl+Espace pour accder la liste des variables, et slectionnez la variable globale QUERY.

1292 Guide de rfrence des Composants de Talend Open Studio


Scnario 2 : Utiliser la variable StoreSQLQuery

7. Affichez la vue Run et excutez le Job.

8. La requte associe au composant tDBInput s'affiche dans la console (vue Run), la fin des rsultats du Job :

Guide de rfrence des Composants de Talend Open Studio 1293


tDBOutput

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.

Prfrez toujours un composant Output spcifique au composant gnrique.

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.
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.
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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si


l'enregistrement avec la rfrence donne existe dj, une mise jour
est effectue.

Update or insert : met jour l'enregistrement avec la rfrence


donne. Si l'enregistrement n'existe pas, un nouvel enregistrement
est insr.

1294 Guide de rfrence des Composants de Talend Open Studio


Proprits du tDBOutput

Delete : Supprimer les entres correspondantes au flux d'entre.

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 table Cochez cette case pour que les donnes soient supprimes de la table
slectionne avant toute action.
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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
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.
Cliquez sur Edit schema pour modifier le schma. Si le schma est
en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 settings Additional JDBC Spcifiez les proprits de connexion supplmentaires pour la
parameters connexion la base de donnes que vous crez.

Vous pouvez configurer les paramtres d'encodage dans


ce champ.
Commit every Nombre de lignes inclure dans le lot avant de commencer
l'criture dans la base. Cette option garantit la qualit de transaction

Guide de rfrence des Composants de Talend Open Studio 1295


Proprits du tDBOutput

(cependant pas de rollback) et surtout une meilleure performance des


excutions.
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.
Enable debug mode Cochez cette case pour afficher chaque tape du processus de
d'criture dans la base de donnes.
Use java.sql.Statement Cochez cette case pour utiliser l'objet Statement, si l'objet
PreparedStatement n'est pas support par votre SGBD.
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.

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).

1296 Guide de rfrence des Composants de Talend Open Studio


Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC

Scnario : Ecrire une ligne dans une table d'une base


de donnes MySQL via une connexion ODBC
Ce scnario efface les donnes dans une table d'une base de donnes MySQL puis ajoute une ligne cette table.

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.

1. Dposez un tDBOutput et un tRowGenerator de la Palette dans l'espace de modlisation graphique.

2. Connectez les composants l'aide d'un lien Row > Main.

3. Double-cliquez sur le tRowGenerator pour ouvrir son Schema editor.

4. Cliquez sur le bouton [+] pour ajouter une ligne.

Saisissez date comme nom de colonne.

Slectionnez Date dans la liste des types de donnes.

Slectionnez getCurrentDate dans la liste Functions.

Saisissez 1 dans le champ Number of Rows for RowGenerator, une seule ligne sera ajoute la table.

Cliquez sur OK pour fermer l'diteur et propager les modifications au tDBOutput.

5. Double-cliquez sur le tDBOutput pour ouvrir sa vue Basic settings.

Guide de rfrence des Composants de Talend Open Studio 1297


Scnario : Ecrire une ligne dans une table d'une base de donnes MySQL via une connexion ODBC

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.

11. Sauvegardez le Job et appuyez sur F6 pour l'excuter.

Comme affich ci-dessus, la table ne contient plus qu'une ligne concernant la date et l'heure courantes.

1298 Guide de rfrence des Composants de Talend Open Studio


tDBSQLRow

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 une question de performances, prfrez toujours un composant de base de donnes


spcifique au composant gnrique.
Objectif Selon la nature de la requte et de la base de donnes, tDBSQLRow 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.

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

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.
Datasource Nom de la source de donnes dfinie dans l'assistant de configuration
de la connexion 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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour


passer le schma en mode Built-In et effectuer des modifications
locales.

Guide de rfrence des Composants de Talend Open Studio 1299


Proprits du tDBSQLRow

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 modifier.
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 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 settings Additional JDBC Spcifiez les proprits de connexion supplmentaires pour la
parameters connexion la base de donnes que vous crez.

Vous pouvez configurer les paramtres d'encodage dans


ce champ.
Propagate QUERY's Cochez cette case pour insrer les rsultats de la requte dans une
recordset colonne du flux en cours. Slectionnez cette colonne dans la liste use
column.
Use PreparedStatement Cochez cette case pour utiliser une instance PreparedStatement
afin de requter votre base 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.

Parameter Index : Saisissez la position du paramtre dans


l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.
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.

1300 Guide de rfrence des Composants de Talend Open Studio


Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes

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).

Scnario : Rinitialiser l'auto-incrmentation d'une


base de donnes
Le Job suivant, un seul composant, permet de rinitialiser l'auto-incrmentation de la base de donnes (valeur
initiale = 1). Il ne permet pas de gnrer un flux en sortie car il est gnralement utilis avant l'excution d'un script.

Avant de reproduire ce Job, le pilote ODBC du SGBD correspondant doit avoir t install et la connexion ODBC
correspondante doit avoir t configure.

1. Glissez-dposez le composant tDBSQLRow de la Palette dans l'espace graphique de modlisation.

2. Double-cliquez sur le tBDSQLRow afin d'ouvrir sa vue Basic settings.

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.

Guide de rfrence des Composants de Talend Open Studio 1301


Scnario : Rinitialiser l'auto-incrmentation d'une base de 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.

L'auto-incrmentation de la base de donnes est rinitialise 1.

1302 Guide de rfrence des Composants de Talend Open Studio


tEXAInput

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

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 name Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur de base de donnes.
Schema name Saisissez le 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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour


passer le schma en mode Built-In et effectuer des modifications
locales.

Guide de rfrence des Composants de Talend Open Studio 1303


Scnarios associs

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 Saisissez le nom de la table.
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.
Guess schema Cliquez sur le bouton pour rcuprer le schma de la table.
Advanced settings Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires
parameters la connexion la base de donnes.
Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et en fin de
columns champ dans toutes les colonnes contenant des chanes de caractres.
Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes
slectionnes.
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.

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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

1304 Guide de rfrence des Composants de Talend Open Studio


tEXAOutput

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

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 de port d'coute du serveur.
Schema name Saisissez le 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.
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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une
nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe


dj, puis en crer une nouvelle.

Clear a table : supprimer le contenu de la table.


Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la
table slectionne :

Guide de rfrence des Composants de Talend Open Studio 1305


Proprits du tEXAOutput

Insert : Ajouter de nouvelles entres la table. Le Job s'arrte


lorsqu'il dtecte des doublons.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si


l'enregistrement avec la rfrence donne existe dj, une mise jour
est effectue.

Update or insert : met jour l'enregistrement avec la rfrence


donne. Si l'enregistrement n'existe pas, un nouvel enregistrement
est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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 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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est
en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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

1306 Guide de rfrence des Composants de Talend Open Studio


Proprits du tEXAOutput

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 Use commit control Cochez cette case afin de dfinir, dans le champ Commit every, qui
apparat alors, le nombre de lignes traiter avant de commiter.
Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires
parameters la connexion la base de donnes.

Vous pouvez appuyer sur Ctrl+Espace afin d'accder


une liste de variables globales prdfinies.
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 tEXAOutput 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 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.
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 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.

Guide de rfrence des Composants de Talend Open Studio 1307


Scnarios associs

Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.

Pour plus d'informations sur les niveaux 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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

1308 Guide de rfrence des Composants de Talend Open Studio


tEXARow

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

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.
Schema name Saisissez le 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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Guide de rfrence des Composants de Talend Open Studio 1309


Proprits du tEXARow

Table Name Nom de la table traiter.


Query type La requte 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.
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 Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires
parameters la connexion la base de donnes.
Propagate QUERY's Cochez cette case pour insrer les rsultats de la requte dans une
recordset colonne du flux en cours. Slectionnez cette colonne dans la liste use
column.
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.
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.

1310 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Scnarios associs
Pour un scnario associ, consultez :

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

Guide de rfrence des Composants de Talend Open Studio 1311


tEXistConnection

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.

Les utilisateurs peuvent spcifier un pilote diffrent, selon


leurs besoins.
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.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant est troitement li aux tEXistGet et tEXistPut. Une fois que vous avez dfini les
proprits de connexion du composant, vous pouvez rutiliser cette connexion sans avoir dfinir
nouveau les proprits pour chaque composant tEXist utilis dans le Job.

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.

1312 Guide de rfrence des Composants de Talend Open Studio


tEXistDelete

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement les
composants de connexion du Job du mme niveau.
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.

Les utilisateurs peuvent spcifier un pilote diffrent,


selon leurs besoins.
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.
Target Type Slectionnez le type de cible :

Resource(Ressource), Collection (Collection), ou All (Tous).


Files Cliquez sur le bouton [+] afin d'ajouter les lignes que vous
souhaitez utiliser comme filtres :

Filemask : saisissez le nom du fichier ou le masque de fichier,


en utilisant des caractres de remplacement (*) ou des expressions
rgulires.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables NB_FILE : Indique le nombre de fichiers traits. 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.

Guide de rfrence des Composants de Talend Open Studio 1313


Scnario associ

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.

1314 Guide de rfrence des Composants de Talend Open Studio


tEXistGet

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement
les composants de connexion du Job du mme niveau.
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.

Les utilisateurs peuvent spcifier un pilote diffrent,


selon leurs besoins.
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.
Local directory Chemin d'accs au fichier de destination.
Files Cliquez sur le bouton [+] afin d'ajouter les lignes que vous
souhaitez utiliser comme filtres :

Filemask : saisissez le nom du fichier ou le masque de fichier, en


utilisant des caractres de remplacement (*) ou des expressions
rgulires.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables NB_FILE : Indique le nombre de fichiers traits. 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.

Guide de rfrence des Composants de Talend Open Studio 1315


Scnario : Rcuprer des ressources partir d'un serveur distant de base de donnes eXist

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.

Scnario : Rcuprer des ressources partir d'un


serveur distant de base de donnes eXist
Ce scnario dcrit un Job un composant qui permet de rcuprer des donnes partir d'un serveur de base de
donnes eXist et de tlcharger les donnes dans un rpertoire local.

Ce Job simple ncessite un composant : le tEXistGet.

1. A partir de la Palette, dposez le composant tEXistGet dans l'espace de modlisation graphique.

2. Double-cliquez sur le composant tEXistGet pour dfinir ses proprits dans l'onglet Basic settings de sa
vue Component.

1316 Guide de rfrence des Composants de Talend Open Studio


Scnario : Rcuprer des ressources partir d'un serveur distant de base de donnes eXist

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.

5. Renseignez le champ Driver en saisissant le pilote de la base de donnes XML, org.exist.xmldb.DatabaseImpl


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 :

C:/Documents and Settings/galano/Desktop/ExistGet.

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.

9. Sauvegardez votre Job et appuyez sur F6 pour l'excuter.

Guide de rfrence des Composants de Talend Open Studio 1317


Scnario : Rcuprer des ressources partir d'un serveur distant de base de donnes eXist

Le fichier XML dictionary_en.xml est rcupr et tlcharg dans le rpertoire local dfini pralablement.

1318 Guide de rfrence des Composants de Talend Open Studio


tEXistList

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement les
composants de connexion du Job du mme niveau.
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.

Les utilisateurs peuvent spcifier un pilote diffrent,


selon leurs besoins.
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.
Files Cliquez sur le bouton [+] afin d'ajouter les lignes que vous
souhaitez utiliser comme filtres :

Filemask : saisissez le nom du fichier ou le masque de fichier,


en utilisant des caractres de remplacement (*) ou des expressions
rgulires.
Target Type Slectionnez le type de cible :

Resource(Ressource), Collection (Collection), ou All (Tous).


Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables NB_FILE : nombre de fichiers itrs. Cette variable est une variable After et retourne un nombre
entier.

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.

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.

Guide de rfrence des Composants de Talend Open Studio 1319


Scnario associ

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette liste, vous pouvez 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.

1320 Guide de rfrence des Composants de Talend Open Studio


tEXistPut

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement les
composants de connexion du Job du mme niveau.
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.

Les utilisateurs peuvent spcifier un pilote diffrent,


selon leurs besoins.
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.
Local directory Chemin d'accs au fichier de destination.
Files Cliquez sur le bouton [+] afin d'ajouter les lignes que vous
souhaitez utiliser comme filtres :

Filemask : saisissez le nom du fichier ou le masque de fichier,


en utilisant des caractres de remplacement (*) ou des expressions
rgulires.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables NB_FILE : Indique le nombre de fichiers traits. 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.

Guide de rfrence des Composants de Talend Open Studio 1321


Scnario associ

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.

1322 Guide de rfrence des Composants de Talend Open Studio


tEXistXQuery

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement les
composants de connexion du Job du mme niveau.
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.

Les utilisateurs peuvent spcifier un pilote diffrent,


selon leurs besoins.
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.
XQuery Input File Parcourez votre rpertoire jusqu'au fichier local contenant la
requte excuter.
Local Output Parcourez votre rpertoire jusqu' l'emplacement o les rsultats
de la requte doivent tre sauvegards.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables NB_FILE : Indique le nombre de fichiers traits. 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 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

Guide de rfrence des Composants de Talend Open Studio 1323


Scnario associ

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.

1324 Guide de rfrence des Composants de Talend Open Studio


tEXistXUpdate

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.

Lorsqu'un Job contient un Job parent et un Job


enfant, la liste Component list prsente uniquement les
composants de connexion du Job du mme niveau.
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.

Les utilisateurs peuvent spcifier un pilote diffrent,


selon leurs besoins.
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.
Update File Parcourez votre rpertoire jusqu'au fichier local utiliser pour
mettre jour les enregistrements de la base de donnes.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables NB_FILE : Indique le nombre de fichiers traits. 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 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

Guide de rfrence des Composants de Talend Open Studio 1325


Scnario associ

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.

1326 Guide de rfrence des Composants de Talend Open Studio


tFirebirdClose

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.

Pour un scnario associ au composant tFirebirdClose, consultez tMysqlConnection.

Guide de rfrence des Composants de Talend Open Studio 1327


tFirebirdCommit

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.

Si vous utilisez un lien de type Row > Main pour relier


le tFireBirdCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 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).

1328 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Scnario associ
Pour un scnario associ au composant tFirebirdCommit, consultez Scnario 1 : Insrer des donnes dans des
tables mre/fille.

Guide de rfrence des Composants de Talend Open Studio 1329


tFirebirdConnection

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

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.
Table 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 DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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.

1330 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 au niveau du
composant.
Utilisation Ce composant est gnralement utilis avec des composants Firebird, notamment les composants
tFirebirdCommit 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).
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.

Guide de rfrence des Composants de Talend Open Studio 1331


tFirebirdInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

1332 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 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 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 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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Guide de rfrence des Composants de Talend Open Studio 1333


Scnarios associs

Scnario 2 : Utiliser la variable StoreSQLQuery.

Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.

1334 Guide de rfrence des Composants de Talend Open Studio


tFirebirdOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la vue


Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de lire


la connexion enregistre.

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.
Port Numro de 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 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.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle.

Clear a table : supprimer le contenu de la table.


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.

Guide de rfrence des Composants de Talend Open Studio 1335


Proprits du tFirebirdOutput

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence donne


existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement n'existe
pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default+values


+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

1336 Guide de rfrence des Composants de Talend Open Studio


Proprits du tFirebirdOutput

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.

Guide de rfrence des Composants de Talend Open Studio 1337


Scnarios associs

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

1338 Guide de rfrence des Composants de Talend Open Studio


tFirebirdRollback

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.

Guide de rfrence des Composants de Talend Open Studio 1339


tFirebirdRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

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.
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 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 :

1340 Guide de rfrence des Composants de Talend Open Studio


Proprits du tFirebirdRow

View schema : slectionnez cette option afin de voir le schma.

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 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 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

Guide de rfrence des Composants de Talend Open Studio 1341


Scnarios associs

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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

1342 Guide de rfrence des Composants de Talend Open Studio


tHiveClose

tHiveClose

Le composant tHiveClose appartient deux familles diffrentes : Big Data et Databases. Pour plus d'informations,
consultez tHiveClose.

Guide de rfrence des Composants de Talend Open Studio 1343


tHiveConnection

tHiveConnection

Le composant tHiveConnection appartient deux familles diffrentes : Big Data et Databases. Pour plus
d'informations, consultez tHiveConnection.

1344 Guide de rfrence des Composants de Talend Open Studio


tHiveRow

tHiveRow

Le composant tHiveRow appartient deux familles diffrentes : Big Data et Databases. Pour plus d'informations,
consultez tHiveRow.

Guide de rfrence des Composants de Talend Open Studio 1345


tHSQLDbInput

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

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.
Running Mode Slectionnez dans la liste le type de serveur correspondant aux
paramtres de votre base de donnes, parmi les quatre proposs :

HSQLDb Server, HSQLDb WebServer, HSQLDb In Process


Persistent, HSQLDb In Memory.
Use TLS/SSL sockets Cochez cette case pour autoriser, si besoin, le mode scuris.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur.
Database Alias 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.
DB path Spcifiez le chemin d'accs la base de donnes laquelle vous
souhaitez vous connecter. Ce champ n'est disponible qu'en mode
d'excution HSQLDb In Process Persistent.

Par dfaut, si la base de donnes que vous spcifiez dans


ce champ n'existe pas, elle sera cre automatiquement.
Si vous souhaitez changer la configuration par dfaut,
modifiez le paramtre de connexion dfini dans le champ
Additional JDBC parameters dans la vue Advanced
settings.
Db name Saisissez le nom de la base de donnes laquelle vous souhaitez vous
connecter. Ce champ n'est disponible qu'avec les modes d'excution
HSQLDb In Process Persistent et HSQLDb In Memory.

1346 Guide de rfrence des Composants de Talend Open Studio


Proprits du tHSQLDbInput

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 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 :

View schema : slectionnez cette option afin de voir le schma.

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 crer. Vous ne pouvez crer qu'une seule table
la fois.
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.
Guess schema Cliquez sur le bouton pour rcuprer le schma de la table.
Query Saisissez votre requte en faisant particulirement attention l'ordre
des champs afin qu'ils correspondent la dfinition du schma.
Advanced settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base
parameters de donnes cre. Lorsque le mode d'excution est HSQLDb
In Process Persistent, vous pouvez configurer le paramtre de
connexion ifexists=true afin de permettre la connexion une
base de donnes existante uniquement et viter de crer une nouvelle
base de donnes.
Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et en fin de
columns champ dans toutes les colonnes contenant des chanes de caractres.
Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes
slectionnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant couvre toutes les possibilits de requtes SQL sur une base de donnes HSQLDb.
Connections Liens de sortie (de ce composant un autre) :

Row : Main, Iterate.

Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error.

Liens d'entre (d'un autre composant celui-ci) :

Row : Iterate.

Guide de rfrence des Composants de Talend Open Studio 1347


Scnarios associs

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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

1348 Guide de rfrence des Composants de Talend Open Studio


tHSQLDbOutput

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

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.
Running Mode Slectionnez dans la liste le type de serveur correspondant aux
paramtres de votre base de donnes, parmi les quatre proposs :

HSQLDb Server, HSQLDb WebServer, HSQLDb In Process


Persistent, HSQLDb In Memory.
Use TLS/SSL sockets Cochez cette case pour autoriser, si besoin, le mode scuris.
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 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.
DB path Spcifiez le chemin d'accs la base de donnes laquelle vous
souhaitez vous connecter. Ce champ n'est disponible qu'en mode
d'excution HSQLDb In Process Persistent.

Par dfaut, si la base de donnes que vous spcifiez dans


ce champ n'existe pas, elle sera cre automatiquement.
Si vous souhaitez changer la configuration par dfaut,
modifiez le paramtre de connexion dfini dans le champ
Additional JDBC parameters dans la vue Advanced
settings.
Db name Saisissez le nom de la base de donnes laquelle vous souhaitez vous
connecter. Ce champ n'est disponible qu'avec les modes d'excution
HSQLDb In Process Persistent et HSQLDb In Memory.

Guide de rfrence des Composants de Talend Open Studio 1349


Proprits du tHSQLDbOutput

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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une
nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe


dj, puis en crer une nouvelle.

Clear a table : supprimer le contenu de la table.


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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si


l'enregistrement avec la rfrence donne existe dj, une mise jour
est effectue.

Update or insert : met jour l'enregistrement avec la rfrence


donne. Si l'enregistrement n'existe pas, un nouvel enregistrement
est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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 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 :

View schema : slectionnez cette option afin de voir le schma.

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

1350 Guide de rfrence des Composants de Talend Open Studio


Proprits du tHSQLDbOutput

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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
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
parameters de donnes cre. Lorsque le mode dexcution est HSQLDb
In Process Persistent, cette proprit supplmentaire est dfinie
comme ifexists=true par dfaut, ce qui signifie que la base de
donnes sera automatiquement cre lorsque cest ncessaire.

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 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 tHSQLDbOutput 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 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.
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 HSQLDb. 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.
Connections Liens de sortie (de ce composant un autre) :

Row : Main, Iterate.

Guide de rfrence des Composants de Talend Open Studio 1351


Scnarios associs

Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error.

Liens d'entre (d'un autre composant celui-ci) :

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

1352 Guide de rfrence des Composants de Talend Open Studio


tHSQLDbRow

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

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.
Running Mode Slectionnez dans la liste le type de serveur correspondant aux
paramtres de votre base de donnes, parmi les quatre proposs :

HSQLDb Server, HSQLDb WebServer, HSQLDb In Process


Persistent, HSQLDb In Memory.
Use TLS/SSL sockets Cochez cette case pour autoriser, si besoin, le mode scuris.
Host Adresse IP du serveur de base de donnes.
Port Numro du port d'coute du serveur.
Database Alias 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.
DB path Spcifiez le chemin d'accs la base de donnes laquelle vous
souhaitez vous connecter. Ce champ n'est disponible qu'en mode
d'excution HSQLDb In Process Persistent.

Par dfaut, si la base de donnes que vous spcifiez dans


ce champ n'existe pas, elle sera cre automatiquement.
Si vous souhaitez changer la configuration par dfaut,
modifiez le paramtre de connexion dfini dans le champ
Additional JDBC parameters dans la vue Advanced
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.

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.

Guide de rfrence des Composants de Talend Open Studio 1353


Proprits du tHSQLDbRow

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 :

View schema : slectionnez cette option afin de voir le schma.

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 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 settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base
parameters de donnes cre. Lorsque le mode d'excution est HSQLDb
In Process Persistent, vous pouvez configurer le paramtre de
connexion ifexists=true afin de permettre la connexion une
base de donnes existante uniquement et viter de crer une nouvelle
base de donnes.
Propagate QUERY's Cochez cette case pour insrer les rsultats de la requte dans une
recordset colonne du flux en cours. Slectionnez cette colonne dans la liste use
column.
Use PreparedStatement Cochez cette case pour utiliser une instance PreparedStatement
afin de requter votre base 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.

Parameter Index : Saisissez la position du paramtre dans


l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

1354 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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) :

Row : Main,Reject, Iterate.

Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error.

Liens d'entre (d'un autre composant celui-ci) :

Row : Main, 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 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 :

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL.

Guide de rfrence des Composants de Talend Open Studio 1355


tInterbaseClose

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.

Pour un scnario associ au composant tInterbaseClose, consultez tMysqlConnection

1356 Guide de rfrence des Composants de Talend Open Studio


tInterbaseCommit

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.

Si vous utilisez un lien de type Row > Main pour relier


le tInterbaseCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 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.

Guide de rfrence des Composants de Talend Open Studio 1357


tInterbaseConnection

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

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.
Table 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 DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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.

1358 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 au niveau du
composant.
Utilisation Ce composant est gnralement utilis avec des composants Interbase, notamment les composants
tInterbaseCommit 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).
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.

Guide de rfrence des Composants de Talend Open Studio 1359


tInterbaseInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

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.
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.

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 :

1360 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

View schema : slectionnez cette option afin de voir le schma.

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 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 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 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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

Guide de rfrence des Composants de Talend Open Studio 1361


Scnarios associs

Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.

1362 Guide de rfrence des Composants de Talend Open Studio


tInterbaseOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la vue


Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de lire


la connexion enregistre.

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.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle.

Guide de rfrence des Composants de Talend Open Studio 1363


Proprits du tInterbaseOutput

Clear a table : supprimer le contenu de la table.


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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence donne


existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement n'existe
pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default+values


+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois options
sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

1364 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 :

Guide de rfrence des Composants de Talend Open Studio 1365


Scnarios associs

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.

1366 Guide de rfrence des Composants de Talend Open Studio


tInterbaseRollback

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.

Guide de rfrence des Composants de Talend Open Studio 1367


tInterbaseRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de lire


la connexion enregistre.

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 Name Nom de la table traiter.
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 :

View schema : slectionnez cette option afin de voir le schma.

1368 Guide de rfrence des Composants de Talend Open Studio


Proprits du tInterbaseRow

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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

Guide de rfrence des Composants de Talend Open Studio 1369


Scnarios associs

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette liste, vous pouvez 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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes associ au composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL associ au composant tMysqlRow.

1370 Guide de rfrence des Composants de Talend Open Studio


tJavaDBInput

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

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.
Framework Slectionnez dans la liste un framework pour votre base de donnes
Java.
Database Nom de la base de donnes.
DB root path Parcourez vos fichiers jusqu' la racine de votre 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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour


passer le schma en mode Built-In et effectuer des modifications
locales.

Guide de rfrence des Composants de Talend Open Studio 1371


Scnarios associs

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 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 Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et en fin de
columns champ dans toutes les colonnes contenant des chanes de caractres.
Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes
slectionnes.
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.

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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.

1372 Guide de rfrence des Composants de Talend Open Studio


tJavaDBOutput

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

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.
Framework Slectionnez dans la liste un framework pour votre base de donnes
Java.
Database Nom de la base de donnes.
DB root path Parcourez vos fichiers jusqu' la racine de votre 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 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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une
nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe


dj, puis en crer une nouvelle.

Clear a table : supprimer le contenu de la table.


Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la
table slectionne :

Guide de rfrence des Composants de Talend Open Studio 1373


Proprits du tJavaDBOutput

Insert : Ajouter de nouvelles entres la table. Le Job s'arrte


lorsqu'il dtecte des doublons.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si


l'enregistrement avec la rfrence donne existe dj, une mise jour
est effectue.

Update or insert : met jour l'enregistrement avec la rfrence


donne. Si l'enregistrement n'existe pas, un nouvel enregistrement
est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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 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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est
en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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

1374 Guide de rfrence des Composants de Talend Open Studio


Proprits du tJavaDBOutput

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 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 tJavaDBOutput 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 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.

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

Guide de rfrence des Composants de Talend Open Studio 1375


Scnarios associs

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

1376 Guide de rfrence des Composants de Talend Open Studio


tJavaDBRow

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

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.
Framework Type Slectionnez dans la liste un framework pour votre base de donnes
Java.
Database Nom de la base de donnes.
DB root path Parcourez vos fichiers jusqu' la racine de votre 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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Guide de rfrence des Composants de Talend Open Studio 1377


Proprits du tJavaDBRow

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 settings Propagate QUERY's Cochez cette case pour insrer les rsultats de la requte dans une
recordset colonne du flux en cours. Slectionnez cette colonne dans la liste use
column.
Use PreparedStatement Cochez cette case pour utiliser une instance PreparedStatement
afin de requter votre base 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.

Parameter Index : Saisissez la position du paramtre dans


l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.
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).

1378 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

Guide de rfrence des Composants de Talend Open Studio 1379


tJDBCColumnList

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.

Dcochez la case pour ignorer les lignes en erreur et terminer


le processus avec les lignes sans erreur. Lorsque les erreurs sont
ignores,vous pouvez rcuprer les lignes en erreur, si vous le
souhaitez. Pour cela, utilisez un lien Row > Reject.
Global Variables CURRENT_COLUMN : nom de la colonne sur laquelle se fait l'itration. Cette variable est une
variable Flow et retourne une chane de caractres.

CURRENT_COLUMN_TYPE : ID du type de colonne sur laquelle se fait l'itration. Cette


variable est une variable Flow et retourne un nombre entier.

CURRENT_COLUMN_TYPE_NAME : nom du type de colonne sur laquelle se fait l'itration.


Cette variable est une variable Flow et retourne une chane de caractres.

CURRENT_COLUMN_PRECISION : prcision de la colonne sur laquelle se fait l'itration.


Cette variable est une variable Flow et retourne un nombre entier.

CURRENT_COLUMN_SCALE : chelle de la colonne sur laquelle se fait l'itration. Cette


variable est une variable Flow et retourne un nombre entier.

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).

1380 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Scnario associ
Pour un scnario associ, consultez Scnario : Itrer une table de base de donnes et lister le nom des colonnes
de la table.

Guide de rfrence des Composants de Talend Open Studio 1381


tJDBCClose

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.

Pour un scnario associ au composant tJDBCClose, consultez tMysqlConnection

1382 Guide de rfrence des Composants de Talend Open Studio


tJDBCCommit

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.

Si vous utilisez un lien de type Row > Main pour relier le


tJDBCCommit votre Job, vos donnes seront commites
ligne par ligne. Dans ce cas, ne cochez pas la case Close
connection car la connexion sera ferme avant la fin du
commit de votre premire ligne.
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 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.

Guide de rfrence des Composants de Talend Open Studio 1383


tJDBCConnection

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.

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 DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
Specify a data source alias Cochez cette case et spcifiez l'alias de la source de donnes
cre dans 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.
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,

1384 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

la fonctionnalit d'auto-commit est dsactive et les modifications


doivent tre commites de manire explicite l'aide du composant
correspondant de commit.

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus despace pour grer vos
transactions dans un Job, il est recommand d'utiliser un composant
Commit.
Utilisation Ce composant est gnralement utilis avec des composants JDBC et notamment avec les
composants tJDBCCommit 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 plus d'informations relatives au fonctionnement du composant tJDBCConnection, consultez
tMysqlConnection.

Guide de rfrence des Composants de Talend Open Studio 1385


tJDBCInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
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.

1386 Guide de rfrence des Composants de Talend Open Studio


Proprits du tJDBCInput

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Si vous utilisez la configuration de la base de donnes du composant, la connexion


votre source de donnes se ferme la fin du composant. Pour empcher la fermeture
de la connexion, utilisez une connexion partage la base de donnes, avec l'alias
de la source de donnes spcifi.

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.

Pour plus d'informations concernant les fichiers de mappage de mtadonnes, consultez la


section sur la conversion de type du Guide Utilisateur duStudio Talend.
Mapping File Spcifiez le fichier de mappage de mtadonnes utiliser en slectionnant un type de base de
donnes dans la liste.

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.

Guide de rfrence des Composants de Talend Open Studio 1387


Le composant tJDBCInput dans les Jobs Talend Map/Reduce

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).

Le composant tJDBCInput dans les Jobs Talend Map/


Reduce
Les informations contenues dans cette section ne s'appliquent que pour les utilisateurs ayant souscrit l'une des solutions
Big Data de Talend. Elles ne s'appliquent pas aux utilisateurs de Talend Open Studio for Big Data.

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.

Famille de composant MapReduce/Input


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.
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 Bsaic 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.
JDBC URL Entrez le chemin d'accs la base de donnes. Par exemple, si la base
de donnes MySQL s'appelle Talend et est hberge sur une machine
dont l'adresse IP est XX.XX.XX.XX et le port est 3306, l'URL doit tre
jdbc:mysql://XX.XX.XX.XX:3306/Talend.
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 Dans le champ Class name, renseignez le nom de la classe
pour qu'elle soit indique dans le driver. Par exemple, pour
le pilote mysql-connector-java-5.1.2.jar, le nom saisir est
org.gjt.mm.mysql.Driver.
Username et Password Informations d'authentification de l'utilisateur de base de donnes.

1388 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.
Table Name Saisissez le nom de la table lire.
Die on error Cochez cette case pour arrter l'excution du Job lorsqu'une erreur
survient.

Dcochez la case pour ignorer les lignes en erreur et terminer


le processus avec les lignes sans erreur. Lorsque les erreurs sont
ignores,vous pouvez rcuprer les lignes en erreur, si vous le
souhaitez. Pour cela, utilisez un lien Row > Reject.
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.
Utilisation Dans un Job Talend Map/Reduce, ce composant est utilis comme composant de dbut et requiert
un composant de transformation comme lien de sortie. Les autres composants utiliss avec lui
doivent galement tre des composants Map/Reduce. Ils gnrent nativement du code Map/Reduce
pouvant tre directement excut 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.
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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.

Guide de rfrence des Composants de Talend Open Studio 1389


tJDBCOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
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.

1390 Guide de rfrence des Composants de Talend Open Studio


Proprits du tJDBCOutput

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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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
schema 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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

Si vous utilisez la configuration de la base de donnes du composant, la connexion


votre source de donnes se ferme la fin du composant. Pour empcher la fermeture
de la connexion, utilisez une connexion partage la base de donnes, avec l'alias
de la source de donnes spcifi.

Cette option est indisponible lorsque la case Use an existing connection est coche.

Guide de rfrence des Composants de Talend Open Studio 1391


Proprits du tJDBCOutput

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

1392 Guide de rfrence des Composants de Talend Open Studio


Le composant tJDBCOutput dans les Jobs Talend Map/Reduce

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).

Le composant tJDBCOutput dans les Jobs Talend


Map/Reduce
Les informations contenues dans cette section ne s'appliquent que pour les utilisateurs ayant souscrit l'une des solutions
Big Data de Talend. Elles ne s'appliquent pas aux utilisateurs de Talend Open Studio for Big Data.

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.

Famille de composant MapReduce/Output


Fonction Le composant tJDBCOutput crit les donnes d'une base de donnes connecte une API JDBC.
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.
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.
JDBC URL Entrez le chemin d'accs la base de donnes. Par exemple, si la base
de donnes MySQL s'appelle Talend et est hberge sur une machine
dont l'adresse IP est XX.XX.XX.XX et le port est 3306, l'URL doit tre
jdbc:mysql://XX.XX.XX.XX:3306/Talend.
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 Dans le champ Class name, renseignez le nom de la classe
pour qu'elle soit indique dans le driver. Par exemple, pour
le pilote mysql-connector-java-5.1.2.jar, le nom saisir est
org.gjt.mm.mysql.Driver.
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 name Nom de la table crire. Notez que cette table doit existe et qu'une
seule table ne peut tre crite 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.

Guide de rfrence des Composants de Talend Open Studio 1393


Le tJDBCOutput dans des Jobs Storm 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.
Advanced settings Use Batch Size Nombre de lignes dans chaque lot de traitement de donnes.
Utilisation Dans un Job Talend Map/Reduce, ce composant est utilis en tant que composant de fin et requiert
un composant de transformation comme lien d'entre. Les autres composants utiliss avec lui
doivent galement tre des composants Map/Reduce. Ils gnrent nativement du code Map/Reduce
pouvant tre directement excut dans Hadoop.

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.

Le tJDBCOutput dans des Jobs Storm Talend


Les informations contenues dans cette section ne s'appliquent que pour les utilisateurs ayant souscrit l'une des solutions
Big Data de Talend. Elles ne s'appliquent pas aux utilisateurs de Talend Open Studio for Big Data.

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.

Famille de composant Storm/Output


Fonction Le tJDBCOutput crit des entres de tout type dans la base de donnes connecte une API
JDBC.
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.
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.
JDBC URL Entrez le chemin d'accs la base de donnes. Par exemple, si la base
de donnes MySQL s'appelle Talend et est hberge sur une machine
dont l'adresse IP est XX.XX.XX.XX et le port est 3306, l'URL doit tre
jdbc:mysql://XX.XX.XX.XX:3306/Talend.

1394 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

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 Nom de la table crire. Notez qu'elle doit exister et qu'une seule
table peut tre crite 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.
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.
Utilisation Dans un Job Storm Talend, ce composant est utilis comme composant de fin. Les autres
composants utiliss avec celui-ci doivent galement tre des composants Storm. Ils gnrent
nativement du code Storm pouvant tre excut directement dans un systme Storm.

Ce composant et la famille Storm laquelle il appartient sont disponibles uniquement lorsque


vous crez un Job Storm.

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

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 :

Scnario 2 : Ddoublonner des entres en utilisant des composants Map/Reduce

Guide de rfrence des Composants de Talend Open Studio 1395


tJDBCRollback

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.

1396 Guide de rfrence des Composants de Talend Open Studio


tJDBCRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, 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 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 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
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 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.

Guide de rfrence des Composants de Talend Open Studio 1397


Proprits du tJDBCRow

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.
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 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 Cochez cette case et spcifiez l'alias de la source de donnes cre dans Talend Runtime
source 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.

Si vous utilisez la configuration de la base de donnes du composant, la connexion


votre source de donnes se ferme la fin du composant. Pour empcher la
fermeture de la connexion, utilisez une connexion partage la base de donnes,
avec l'alias de la source de donnes spcifi.

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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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

1398 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

Guide de rfrence des Composants de Talend Open Studio 1399


tJDBCSP

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.

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.

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 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 :

View schema : slectionnez cette option afin de voir le schma.

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 / Return result in Cochez cette case si une seule valeur doit tre retourne.

1400 Guide de rfrence des Composants de Talend Open Studio


Proprits du tJDBCSP

Slectionnez dans la liste la colonne du schma sur laquelle est base


la valeur obtenir.
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.

Slectionnez le Type de paramtre :

IN : paramtre d'entre (Input)

OUT : paramtre de sortie (Output)/valeur retourne

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 le composant 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.
Specify a data source alias Cochez cette case et spcifiez l'alias de la source de donnes
cre dans 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.

Si vous utilisez la configuration de la base de donnes


du composant, la connexion votre source de donnes se
ferme la fin du composant. Pour empcher la fermeture
de la connexion, utilisez une connexion partage la base
de donnes, avec l'alias de la source de donnes spcifi.

Cette option est indisponible lorsque la case Use an existing


connection est coche.
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 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.

Guide de rfrence des Composants de Talend Open Studio 1401


Scnarios associs

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.

1402 Guide de rfrence des Composants de Talend Open Studio


tJDBCTableList

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.

Ce champ est disponible lorsque la case Use filter est coche.


Filter criteria Slectionnez le critre permettant de filtrer le nom des 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).

Guide de rfrence des Composants de Talend Open Studio 1403


Scnario associ

Scnario associ
Pour un scnario associ, consultez Scnario : Itrer une table de base de donnes et lister le nom des colonnes
de la table.

1404 Guide de rfrence des Composants de Talend Open Studio


tLDAPAttributesInput

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

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 connection Cochez cette case et cliquez sur le composant tLDAPConnection
dans la liste Component List, afin de rutiliser les informations de
la connexion que vous avez prcdemment dfinie.
Host Adresse IP du serveur d'annuaire LDAP.
Port Numro du port d'coute du serveur.
Base DN Chemin d'accs l'arborescence de l'utilisateur autoris.
Protocol Slectionnez le type de protocole dans la liste.

LDAP : aucun codage n'est utilis.

LDAPS : LDAP scuris. Quand cette option est slectionne, la


case Advanced CA apparat. Une fois slectionn, le mode avanc
vous permet de spcifier le rpertoire et le mot de passe de la cl
secrte du certificat pour le stockage d'un CA spcifique. Cependant,
vous pouvez toujours dsactiver la validation du certificat, en
cochant la case Trust all certs.

TLS : le certificat est utilis. Quand cette option est slectionne,


la case Advanced CA apparat et est utilise de la mme faon que
pour le type LPDAPS.
Authentication User et Cochez Authentication si une connexion LDAP est ncessaire.
Password Notez que le login doit correspondre la syntaxe LDAP pour tre
valide. Par exemple : "cn=Directory Manager".

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.
Filter Saisissez le filtre comme attendu par l'annuaire LDAP db.
Multi valued field separator Saisissez le sparateur de valeur des champs valeurs multiples.
Alias dereferencing Slectionnez l'option dans la liste. Never permet l'amlioration des
performances de recherche si vous tes sr qu'aucun alias n'est
drfrenc. Par dfaut, utilisez Always :

Always : les alias sont toujours drfrencs.

Never : les alias ne sont jamais drfrencs.

Guide de rfrence des Composants de Talend Open Studio 1405


Proprits du tLDAPAttributesInput

Searching : cette option drfrence les alias uniquement aprs la


rsolution du nom.

Finding : cette option drfrence les alias uniquement lors de la


rsolution du nom.
Referral handling Slectionnez l'option dans la liste :

Ignore : ne tient pas compte des redirections des requtes

Follow : tient compte des redirections des requtes


Limit Cette option permet de limiter le nombre d'enregistrement lus, si
ncessaire.
Time Limit Cette option permet de limiter la dure de connexion l'annuaire.
Paging Spcifiez le nombre d'entres retournes en une fois par le serveur
LDAP.
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
> Reject.
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.

Comme ce composant sert lister les attributs associs


un lment LDAP, sont schma est prdfini. Conservez
ces colonnes dfinies, mme si vous avez besoin d'ajouter
de nouvelles colonnes. Pour cela, utilisez le mode Built-In.
Cliquez sur Edit schema pour modifier le schma. Si le schma est
en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].
Le schma prdfini comprend :

- objectclass : liste des classes d'lments

- mandatoryattributes : liste des attributs obligatoires pour ces


classes

- optionalattributes : liste des attributs facultatifs pour ces classes

- objectattributes : liste des attributs essentiels aux lments


analyss.
Advanced settings Class Definition Root Spcifiez la racine de l'espace de nom de l'lment Class definition.

1406 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 1407


tLDAPClose

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.

1408 Guide de rfrence des Composants de Talend Open Studio


tLDAPConnection

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

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 d'annuaire LDAP.
Port Numro du port d'coute du serveur.
Protocol Slectionnez le type de protocole dans la liste.

LDAP : aucun codage n'est utilis

LDAPS : LDAP scuris. Quand cette option est slectionne, la


case Advanced CA apparat. Une fois slectionn, le mode avanc
vous permet de spcifier le rpertoire et le mot de passe de la cl
secrte du certificat pour le stockage d'un CA spcifique. Cependant,
vous pouvez toujours dsactiver la validation du certificat, en
cochant la case Trust all certs.

TLS : le certificat est utilis. Quand cette option est slectionne,


la case Advanced CA apparat et est utilise de la mme faon que
pour le type LPDAPS.
Base DN Chemin d'accs l'arborescence de l'utilisateur autoris.
User et Password Renseignez les champs User et Password comme requis par
l'annuaire. Notez que le login doit correspondre la syntaxe LDAP
pour tre valide. Par exemple : "cn=Directory Manager".

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.
Alias dereferencing Slectionnez l'option dans la liste. Never permet l'amlioration des
performances de recherche si vous tes sr qu'aucun alias n'est
drfrenc. Par dfaut, utilisez Always :

Always : les alias sont toujours drfrencs.

Never : les alias ne sont jamais drfrencs.

Searching : cette option drfrence les alias uniquement aprs la


rsolution du nom.

Finding : cette option drfrence les alias uniquement lors de la


rsolution du nom.

Guide de rfrence des Composants de Talend Open Studio 1409


Scnario associ

Referral handling Slectionnez l'option dans la liste :

Ignore : ne tient pas compte des redirections des requtes.

Follow : tient compte des redirections des requtes.


Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Utilisation Ce composant doit tre utilis avec d'autres composants LDAP, notamment les composants
tLDAPInput et tLDAPOutput.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.

Pour plus d'informations sur les niveaux 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.

1410 Guide de rfrence des Composants de Talend Open Studio


tLDAPInput

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

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 de Studio Talend.
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.

Lorsqu'un Job contient un Job parent et un Job enfant, la


liste Component list prsente uniquement les composants
de connexion du Job du mme niveau.
Host Adresse IP du serveur d'annuaire LDAP.
Port Numro du port d'coute du serveur.
Base DN Chemin d'accs l'arborescence de l'utilisateur autoris.

Pour retrouver les informations compltes du


Distinguished Name, ajoutez un champ appel DN dans le
schma, en minuscules ou en majuscules.
Protocol Slectionnez le type de protocole dans la liste.

LDAP : aucun codage n'est utilis

LDAPS : LDAP scuris. Quand cette option est slectionne, la case


Advanced CA apparat. Une fois slectionn, le mode avanc vous
permet de spcifier le rpertoire et le mot de de passe de la cl secrte
du certificat pour le stockage d'un CA spcifique. Cependant, vous
pouvez toujours dsactiver la validation du certificat, en cochant la
case Trust all certs.

TLS : le certificat est utilis. Quand cette option est slectionne, la


case Advanced CA apparat et est utilise de la mme faon que pour
le type LPDAPS.
Authentication User et Cochez Authentication si une connexion LDAP est ncessaire.
Password Notez que le login doit correspondre la syntaxe LDAP pour tre
valide. Par exemple : "cn=Directory Manager".

Guide de rfrence des Composants de Talend Open Studio 1411


Proprits du tLDAPInput

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.
Filter Saisissez le filtre comme attendu par l'annuaire LDAP db.
Multi valued field separator Saisissez le sparateur de valeur des champs valeurs multiples.
Alias dereferencing Slectionnez l'option dans la liste. Never permet l'amlioration des
performances de recherche si vous tes sr qu'aucun alias n'est
drfrenc. Par dfaut, utilisez Always :

Always : les alias sont toujours drfrencs.

Never : les alias ne sont jamais drfrencs.

Searching : cette option drfrence les alias uniquement aprs la


rsolution du nom.

Finding : cette option drfrence les alias uniquement lors de la


rsolution du nom.
Referral handling Slectionnez l'option dans la liste :

Ignore : ne tient pas compte des redirections des requtes.

Follow : tient compte des redirections des requtes.


Limit Cette option permet de limiter le nombre d'enregistrement lus, si
ncessaire.
Time Limit Cette option permet de limiter la dure de connexion l'annuaire.
Paging Spcifiez le nombre d'entres retournes en une fois par le serveur
LDAP.
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
> Reject.
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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Seuls trois types de donnes sont supports : String, byte[]


et List. Vous pouvez utiliser un tMap pour effectuer une
conversion, si ncessaire.
Built-in : Le schma est cr et conserv ponctuellement pour ce
composant seulement. Voir galement le Guide utilisateur du Studio
Talend.

1412 Guide de rfrence des Composants de Talend Open Studio


Scnario : Afficher le contenu filtr d'un annuaire LDAP

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.
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, 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).

Scnario : Afficher le contenu filtr d'un annuaire


LDAP
Le Job dcrit ci-dessous filtre simplement l'annuaire LDAP et affiche le rsultat dans la console de la vue Run.

1. Cliquez et dposez les composants tLDAPInput et tLogRow.

2. Paramtrez les proprits du tLDAPInput.

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.

5. Aucune Base DN particulire ne doit tre paramtre.

Guide de rfrence des Composants de Talend Open Studio 1413


Scnario : Afficher le contenu filtr d'un annuaire LDAP

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.

11.Slectionnez Ignore dans le champ Referral handling.

12.Dans le champ Limit, dfinissez la limite 100 dans cet exemple.

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.

14.Dans le composant tLogRow, aucune configuration particulire n'est exige.

1414 Guide de rfrence des Composants de Talend Open Studio


Scnario : Afficher le contenu filtr d'un annuaire LDAP

Seule une entre de l'annuaire correspond aux critres du filtre dfini dans le composant tLDAPInput.

Guide de rfrence des Composants de Talend Open Studio 1415


tLDAPOutput

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.

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 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.

Lorsqu'un Job contient un Job parent et un Job enfant, la


liste Component list prsente uniquement les composants
de connexion du Job du mme niveau.
Host Adresse IP du serveur d'annuaire LDAP.
Port Numro de port d'coute du serveur.
Base DN Chemin d'accs l'arborescence de l'utilisateur autoris.
Protocol Slectionnez le type de protocole dans la liste.

LDAP : aucun codage n'est utilis

LDAPS : LDAP scuris. Quand cette option est slectionne, la


case Advanced CA apparat. Une fois slectionn, le mode avanc
vous permet de spcifier le rpertoire et le mot de passe de la cl
secrte du certificat pour le stockage d'un CA spcifique. Cependant,
vous pouvez toujours dsactiver la validation du certificat, en
cochant la case Trust all certs.

TLS : le certificat est utilis. Quand cette option est slectionne,


la case Advanced CA apparat et est utilise de la mme faon que
pour le type LPDAPS.
User et Password Renseignez les champs User (utilisateur) et Password (mot de
passe) conformment l'annuaire.

Notez que le login doit correspondre la syntaxe LDAP pour tre


valide. Par exemple : "cn=Directory Manager".

1416 Guide de rfrence des Composants de Talend Open Studio


Proprits du tLDAPOutput

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.
Multi valued field separator Saisissez le sparateur de valeurs dans les champs multi-valus.
Alias dereferencing Slectionnez l'option dans la liste. Never permet l'amlioration des
performances de recherche si vous tes sr qu'aucun alias n'est
drfrenc. Par dfaut, utilisez Always.

Always : les alias sont toujours drfrencs.

Never : les alias ne sont jamais drfrencs.

Searching : cette option drfrence les alias uniquement aprs la


rsolution du nom.

Finding : cette option drfrence les alias uniquement lors de la


rsolution du nom.
Referral handling Slectionnez l'option dans la liste :

Ignore : ne tient pas compte des redirections des requtes.

Follow : tient compte des redirections des requtes.


Insert mode Slectionnez l'action dans la liste :

Add : ajoute une valeur dans un attribut multi-valu Insert : insre


de nouvelles donnes

Update : met jour les donnes existantes

Delete : supprime les donnes slectionnes de l'annuaire

Insert or update : insre un nouvel enregistrement. Si


l'enregistrement avec la rfrence donne existe dj, une mise jour
est effectue.

Lorsque l'action Update est slectionne, allez dans la


vue Advanced settings et cochez la case Use Attribute
Options (for update mode) pour afficher la table Attribute
Options. Slectionnez l'attribut mettre jour dans la
colonne Attribute name et slectionnez Replace dans la
colonne Option.
DN Column Name Slectionnez, partir de la liste droulante, le type d'entre LDAP
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.

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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est
en mode Repository, trois options sont disponibles :

Guide de rfrence des Composants de Talend Open Studio 1417


Scnario : Editer des donnes dans un annuaire LDAP

View schema : slectionnez cette option afin de voir le schma.

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
> Reject.
Advanced settings Use Attribute Options (for Cochez cette case afin de slectionner l'attribut souhait (y compris
update mode) dn, dc, ou, objectClass, mail et uid) et l'opration correspondante
(notamment Add, Replace, Remove Attribute, et Remove Value)
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_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).

Scnario : Editer des donnes dans un annuaire LDAP


Le scnario suivant dcrit un Job qui lit un annuaire LDAP, met jour l'e-mail d'une entre slectionne et affiche
la sortie avant de mettre jour l'annuaire LDAP en sortie. C'est--dire qu'aucun alias n'est drfrenc et qu'aucune
requte n'est redirige. Ce scnario est bas sur le scnario du LDAPInput (cf. Scnario : Afficher le contenu filtr
d'un annuaire LDAP). Le rsultat obtenu est une entre simple, correspondant une personne organisationnelle
dont l'e-mail est mis jour.

La sortie prsente les champs suivants : dn, uid et mail, comme dfini dans le Job.

1418 Guide de rfrence des Composants de Talend Open Studio


Scnario : Editer des donnes dans un annuaire LDAP

Dposer les composants


1. Cliquez et dposez les composants tLDAPInput, tLDAPOutput, tMap et tLogRow dans l'espace de
modlisation.

2. Connectez le composant tLDAPInput au tMap l'aide d'un lien Row > Main.

3. Reliez le tMap au tLogRow l'aide d'un lien Row > Main.

4. Reliez le tLogRow au tLDAPOutput l'aide d'un lien Row > Main.

Configurer les composants


1. Dans la vue Component du tLDAPInput, paramtrez les informations de connexion au serveur d'annuaire
LDAP, ainsi que les filtres tel que dcrit dans Scnario : Afficher le contenu filtr d'un annuaire LDAP.

Simplifiez le schma en enlevant les champs suivants : dc, ou, objectclass.

2. Ouvrez le mapper pour dfinir les changements excuter.

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.

Cliquez sur OK pour valider les modifications.

Guide de rfrence des Composants de Talend Open Studio 1419


Scnario : Editer des donnes dans un annuaire LDAP

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.

9. Slectionnez le protocole utiliser : LDAP pour cet exemple.

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).

Le schma est rcupr du composant prcdent l'aide d'une opration de propagation.

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.

1420 Guide de rfrence des Composants de Talend Open Studio


Scnario : Editer des donnes dans un annuaire LDAP

Excuter le Job
1. Appuyez sur les touches Ctrl+S pour sauvegarder le Job.

2. Excutez le Job en appuyant sur la touche F6.

Guide de rfrence des Composants de Talend Open Studio 1421


tLDAPRenameEntry

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

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 connection Cochez cette case et cliquez sur le composant tLDAPConnection
dans la liste Component List, afin de rutiliser les informations de
la connexion que vous avez prcdemment dfinie.
Host Adresse IP du serveur d'annuaire LDAP.
Port Numro du port d'coute du serveur.
Base DN Chemin d'accs l'arborescence de l'utilisateur autoris.
Protocol Slectionnez le type de protocole dans la liste.

LDAP : aucun codage n'est utilis

LDAPS : LDAP scuris. Quand cette option est slectionne, la


case Advanced CA apparat. Une fois slectionn, le mode avanc
vous permet de spcifier le rpertoire et le mot de passe de la cl
secrte du certificat pour le stockage d'un CA spcifique. Cependant,
vous pouvez toujours dsactiver la validation du certificat, en
cochant la case Trust all certs.

TLS : le certificat est utilis. Quand cette option est slectionne,


la case Advanced CA apparat et est utilise de la mme faon que
pour le type LPDAPS.
User et Password Renseignez les informations d'authentification de l'utilisateur. Notez
que le login doit correspondre la syntaxe LDAP pour tre valide.
Par exemple : "cn=Directory Manager".

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.
Alias dereferencing Slectionnez l'option dans la liste. Never permet l'amlioration des
performances de recherche si vous tes sr qu'aucun alias n'est
drfrenc. Par dfaut, utilisez Always :

Always : les alias sont toujours drfrencs.

Never : les alias ne sont jamais drfrencs.

Searching : cette option drfrence les alias uniquement aprs la


rsolution du nom.

1422 Guide de rfrence des Composants de Talend Open Studio


Proprits du tLDAPRenameEntry

Finding : cette option drfrence les alias uniquement lors de la


rsolution du nom.
Referrals handling Slectionnez l'option dans la liste :

Ignore : ne tient pas compte des redirections des requtes.

Follow : tient compte des redirections des requtes.


Previous DN et New DN Slectionnez partir de la liste droulante la colonne du schma
portant l'ancien DN (Previous DN) et celle portant le nouveau DN
appliquer (New DN).
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 :

View schema : slectionnez cette option afin de voir le schma.

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.
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
> Reject.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau des
composants.
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 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.

Guide de rfrence des Composants de Talend Open Studio 1423


Scnarios associs

Pour plus d'informations sur les niveaux 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 :

Scnario : Afficher le contenu filtr d'un annuaire LDAP du composant tLDAPInput.

Scnario : Editer des donnes dans un annuaire LDAP du tLDAPOutput.

1424 Guide de rfrence des Composants de Talend Open Studio


tMaxDBInput

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

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 name 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 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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

Change to built-in property : slectionnez cette option pour


passer le schma en mode Built-In et effectuer des modifications
locales.

Guide de rfrence des Composants de Talend Open Studio 1425


Scnarios associs

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 Saisissez le nom de la table.
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.
Guess schema Cliquez sur le bouton pour rcuprer le schma de la table.
Advanced settings Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et en fin de
columns champ dans toutes les colonnes contenant des chanes de caractres.
Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes
slectionnes.
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.

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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

1426 Guide de rfrence des Composants de Talend Open Studio


tMaxDBOutput

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 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 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 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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop a table if exists and create : supprimer la table si elle existe dj, puis
en crer une nouvelle.

Clear a table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans


possibilit de Rollback.
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.

Update : Mettre jour les entres existantes.

Guide de rfrence des Composants de Talend Open Studio 1427


Proprits du tMaxDBOutput

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la


rfrence donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si


l'enregistrement n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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 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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/


Verifying+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode
Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 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.

1428 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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
tMaxDBOutput 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 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.

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

Guide de rfrence des Composants de Talend Open Studio 1429


tMaxDBRow

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

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 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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

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].

1430 Guide de rfrence des Composants de Talend Open Studio


Proprits du tMaxDBRow

Table name Saisissez le nom de la table.


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.
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.
Advanced settings Propagate QUERY's Cochez cette case pour insrer les rsultats de la requte dans une
recordset colonne du flux en cours. Slectionnez cette colonne dans la liste use
column.
Use PreparedStatement Cochez cette case pour utiliser une instance PreparedStatement
afin de requter votre base 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.

Parameter Index : Saisissez la position du paramtre dans


l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.
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.

Guide de rfrence des Composants de Talend Open Studio 1431


Scnarios associs

Pour plus d'informations sur les niveaux 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 : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

1432 Guide de rfrence des Composants de Talend Open Studio


tParseRecordSet

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.

Famille de composant Databases


Fonction Le composant tParseRecordSet analyse un ensemble d'enregistrements d'une table de donnes ou
d'une requte SQL et retourne ventuellement des enregistrements seuls.
Objectif Il permet d'analyser un ensemble d'enregistrements d'une table au lieu de les analyser
individuellement.
Basic settings Prev. Comp. Column list Slectionnez la colonne contenant l'ensemble d'enregistrements
analyser.
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 uniquement. 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 :

View schema : slectionnez cette option afin de voir le schma.

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].
Attribute table Paramtrez la valeur positionnelle de chaque colonne de chaque
enregistrement d'un ensemble d'enregistrements.
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.

Guide de rfrence des Composants de Talend Open Studio 1433


Scnario associ

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.

1434 Guide de rfrence des Composants de Talend Open Studio


tPostgresPlusBulkExec

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes


partager, dans la vue Basic settings du composant de connexion
crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de


connexion, afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion


travers diffrents niveaux de Jobs, consultez le Guide utilisateur du
Studio Talend.
DB Version Liste des versions de la base de donnes.
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 sur 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.
Action on table Vous pouvez effectuer l'une des oprations suivantes sur les donnes de la table
slectionne :

Guide de rfrence des Composants de Talend Open Studio 1435


Proprits du tPostgresPlusBulkExec

None: n'effectuer aucune opration de table.

Drop and create table: supprimer la table puis en crer une nouvelle.

Create table: crer une table qui n'existe pas encore.

Create table if not exists: crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en
crer une nouvelle.

Clear a table: supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans


possibilit de Rollback.
File Name 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.
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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/


Verifying+default+values+in+a+retrieved+schema (en anglais).
Advanced settings Action Slectionnez l'opration que vous voulez effectuer :

Bulk insert ou Bulk update. Les informations demandes seront diffrentes


en fonction de l'action choisie.
Field terminated by Caractre, chane ou expression rgulire sparant les champs.
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.

1436 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

Guide de rfrence des Composants de Talend Open Studio 1437


tPostgresPlusClose

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.

Pour un scnario associ au composant tPostgresPlusClose, consultez tMysqlConnection.

1438 Guide de rfrence des Composants de Talend Open Studio


tPostgresPlusCommit

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.

Si vous utilisez un lien de type Row > Main pour relier


le tPostgresPlusCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 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.

Guide de rfrence des Composants de Talend Open Studio 1439


tPostgresPlusConnection

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

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.
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 DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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.

1440 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 PostgresPlus et notamment avec les
composants tPostgresPlusCommit 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 tPostgresPlusConnection, consultez
tMysqlConnection.

Guide de rfrence des Composants de Talend Open Studio 1441


tPostgresPlusInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Liste des versions de la base de donnes.
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 exact du schma
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.

1442 Guide de rfrence des Composants de Talend Open Studio


Proprits du tPostgresPlusInput

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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).

Guide de rfrence des Composants de Talend Open Studio 1443


Scnarios associs

Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tPostgresPlusInput :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

1444 Guide de rfrence des Composants de Talend Open Studio


tPostgresPlusOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Liste des versions de la base de donnes.
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 exact du schma.
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 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 :

None : n'effectuer aucune opration de table.

Drop and create table : supprimer la table puis en crer une nouvelle.

Guide de rfrence des Composants de Talend Open Studio 1445


Proprits du tPostgresPlusOutput

Create table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une
nouvelle.

Clear table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de


Rollback.
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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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
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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
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.

1446 Guide de rfrence des Composants de Talend Open Studio


Proprits du tPostgresPlusOutput

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.

Guide de rfrence des Composants de Talend Open Studio 1447


Scnarios associs

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

1448 Guide de rfrence des Composants de Talend Open Studio


tPostgresPlusOutputBulk

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.

Famille de composant Databases/PostgresPlus


Fonction Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards
Postgresql.
Objectif Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une
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.
File Name Nom du fichier gnrer.

Ce fichier est gnr sur la machine locale ou dans un


dossier partag sur le rseau local.
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

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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Guide de rfrence des Composants de Talend Open Studio 1449


Scnarios associs

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.

Pour plus d'informations, consultez https://help.talend.com/


display/KB/Verifying+default+values+in+a+retrieved+schema
(en anglais).
Advanced settings Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
Field separator Caractre, chane ou expression rgulire sparant les champs.
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 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.

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches
Ctrl+Espace pour accder la liste des variables. A partir de cette 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 : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

1450 Guide de rfrence des Composants de Talend Open Studio


tPostgresPlusOutputBulkExec

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.

Famille de composant Databases/Postgresplus


Fonction Le tPostgresPlusOutputBulkExec effectue une action d'Insert sur les donnes fournies.
Objectif Le tPostgresPlusOutputBulkExec est un composant ddi qui permet un gain de performance
pendant les oprations d'Insert dans une base de donnes PostgresPlus.
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 Liste des versions de la base de donnes.
Host Adresse IP du serveur de la base de donnes.

Seuls localhost, 127.0.0.1 ou l'adresse IP exacte de la machine locale


permettent un fonctionnement optimal. Le serveur de la base de
donnes doit tre install sur la mme machine que le Studio Talend
ou le Job contenant un tPostgresPlusOutputBulkExec.
Port Numro du port d'coute du serveur de base de donnes.
Database Nom de la base de donnes.
Schema Nom exact 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.
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 :

None : n'effectuer aucune opration de table.

Drop and create the table : supprimer la table puis en crer une
nouvelle.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Clear a table : supprimer le contenu de la table.


File Name Nom du fichier gnrer et charger.

Guide de rfrence des Composants de Talend Open Studio 1451


Proprits du tPostgresplusOutputBulkExec

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.
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 :

View schema : slectionnez cette option afin de voir le schma.

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.

Pour plus d'informations, consultez https://help.talend.com/display/


KB/Verifying+default+values+in+a+retrieved+schema (en anglais).
Advanced settings Action Slectionnez l'opration que vous voulez effectuer :

Bulk insert ou Bulk update. Les informations demandes seront


diffrentes en fonction de l'action choisie.
File type Slectionnez le type de fichiers traiter.
Null string Chane de caractres affiche pour signifier que la valeur est nulle.
Row separator Chane (ex : "\n" sous Unix) sparant les lignes.
Fields terminated by Caractre, chane ou expression rgulire sparant les champs :

None : aucun caractre de sparation.

Whitespace : le caractre de sparation est un espace.

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.
Escape character Caractre d'chappement de la ligne.
Text enclosure Caractre utilis pour entourer le texte.
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.

1452 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Scnarios associs
Pour un scnario associ au composant tPostgresPlusOutputBulkExec, consultez :

Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulk.

Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

Guide de rfrence des Composants de Talend Open Studio 1453


tPostgresPlusRollback

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.

1454 Guide de rfrence des Composants de Talend Open Studio


tPostgresPlusRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Liste des versions de la base de donnes.
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 exact du schma
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.

Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 1455


Proprits du tPostgresPlusRow

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.
Table name Nom de la table de base lire.
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 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 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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

1456 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Pour renseigner un champ ou une expression l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour
accder la liste des variables. A partir de cette 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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Scnario : Rinitialiser l'auto-incrmentation d'une base de donnes du composant tDBSQLRow.

Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMysqlRow.

Guide de rfrence des Composants de Talend Open Studio 1457


tPostgresPlusSCD

tPostgresPlusSCD

Le composant tPostgresPlusSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour
plus d'informations, consultez tPostgresPlusSCD.

1458 Guide de rfrence des Composants de Talend Open Studio


tPostgresPlusSCDELT

tPostgresPlusSCDELT

Le composant tPostgresPlusSCDELT appartient deux familles diffrentes : Business Intelligence et Databases.


Pour plus d'informations, consultez tPostgresPlusSCDELT.

Guide de rfrence des Composants de Talend Open Studio 1459


tSAPHanaClose

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.

1460 Guide de rfrence des Composants de Talend Open Studio


tSAPHanaCommit

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.

Si vous utilisez un lien de type Row > Main pour relier


le tSAPHanaCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 avec le
tSAPHanaConnection et le tSAPHanaRollback.

Utilisez ce composant si l'option Auto Commit du tSAPHanaConnection est dcoche.


Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.

Pour plus d'informations sur les niveaux 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.

Guide de rfrence des Composants de Talend Open Studio 1461


tSAPHanaConnection

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.

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.
Additional JDBC Ajoutez des informations de connexion supplmentaires ncessaires
Parameters la connexion la base de donnes.
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.

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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 lors du traitement
du Job, aussi bien au niveau du Job qu'au niveau de chaque
composant.
Utilisation Ce composant est gnralement utilis avec d'autres composants SAP Hana, notamment le
tSAPHanaCommit et le tSAPHanaRollback, par exemple pour fermer une connexion la fin
d'une transaction.
Log4j L'activit de ce composant peut tre journalise avec la fonctionnalit log4j. Pour plus
d'informations sur cette fonctionnalit, consultez le Guide utilisateur du Studio Talend.

Pour plus d'informations sur les niveaux 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

1462 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Scnario associ
Aucun scnario n'est disponible pour ce composant.

Guide de rfrence des Composants de Talend Open Studio 1463


tSAPHanaInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Slectionnez la version de 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.
Schema Nom du schma de la base de donnes.
Username et Saisissez vos informations d'authentification 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.
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 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 :

View schema : slectionnez cette option afin de voir le schma.

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].

1464 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSAPHanaInput

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).

Guide de rfrence des Composants de Talend Open Studio 1465


Scnario associ

Scnario associ
Aucun scnario n'est disponible pour ce composant.

1466 Guide de rfrence des Composants de Talend Open Studio


tSAPHanaOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Slectionnez la version de 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 Saisissez vos informations d'authentification 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 Saisissez le nom de la table crire. Notez qu'une seule table peut tre crite la fois.
Action on table Sur la table dfinie, vous pouvez effectuer l'une des oprations suivantes :

None : Aucune opration n'est effectue.

Drop and create table : La table est supprime et cre nouveau.

Create table : La table n'existe pas et est cre.

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.

Clear table : Le contenu de la table est supprim.


Type of table Cette option n'est disponible que si vous crez (en supprimant ou pas) la table de la base de
storage donnes. Cette option vous permet de dfinir la manire dont les donnes sont stockes dans
la table. Les types d'organisation du stockage des donnes suivants sont disponibles :

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.

Guide de rfrence des Composants de Talend Open Studio 1467


Proprits du tSAPHanaOutput

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.

History column : Une table avec un type de session de transaction particulier,


HISTORY est cre. Les tables avec le type de session HISTORY supportent les
requtes de type time travel. Pour plus d'informations concernant HISTORY et les
requtes time travel, consultez http://help.sap.com/saphelp_hanaplatform/helpdata/en/20/
d56cd075191014b7ea9e4e77477aae/content.htm (en anglais).

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.

Update : Apporter des modifications des entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer des entres correspondant au flux d'entre.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].

1468 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSAPHanaOutput

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.

Key in delete : dfinir la cl primaire utiliser lors d'une opration de suppression.

Updatable : dfinir les colonnes mettre jour.

Insertable : dfinir les colonnes insrer.


Enable debug Cochez cette case pour afficher chaque tape durant le traitement des entres dans une base
mode de donnes.
Support null in Cochez cette case pour prendre en compte les valeurs nulls dans une instruction "SQL
"SQL WHERE" WHERE".
statement
Use Batch Size Lorsque cette case est coche, saisissez le nombre de lignes contenues dans chaque lot trait.

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.

Guide de rfrence des Composants de Talend Open Studio 1469


Scnario associ

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.

1470 Guide de rfrence des Composants de Talend Open Studio


tSAPHanaRollback

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.

Guide de rfrence des Composants de Talend Open Studio 1471


tSAPHanaRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin


de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
DB Version Slectionnez la version de SAP Hana Database (HDB) que vous utilisez.
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 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 :

1472 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSAPHanaRow

View schema : slectionnez cette option afin de voir le schma.

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 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 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

Guide de rfrence des Composants de Talend Open Studio 1473


Scnario associ

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.

1474 Guide de rfrence des Composants de Talend Open Studio


tSasInput

tSasInput

Assurez-vous d'installer au pralable les modules sas.core.jar, sas.intrnet.javatools.jar et sas.svc.connection.jar sous le


chemin lib > java dans votre build du Studio Talend pour pouvoir utiliser toutes les fonctionnalits des composants SAS.
Vous pouvez vrifier que ces modules ont bien t installs partir de la vue Modules de votre Studio Talend.

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

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 name Nom ou adresse IP du serveur SAS.
Port Port d'coute ouvrir.
Librefs Renseignez le nom du rpertoire physique dans lequel est contenue
la table lire, suivi de son chemin d'accs. Par exemple :

"TpSas C:/SAS/TpSas'"
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.
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 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 :

Guide de rfrence des Composants de Talend Open Studio 1475


Scnarios associs

View schema : slectionnez cette option afin de voir le schma.

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 Renseignez le nom de la table lire, prfix par le nom du
rpertoire physique dans lequel elle est contenue. Par exemple :
"TpSas.Customers".
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.
Query Saisissez votre requte, si elle n'est pas stocke dans le Repository,
en faisant particulirement attention l'ordre des champs afin qu'ils
correspondent la dfinition du schma.
Advanced settings 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.

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 :

Scnario 1 : Afficher les donnes slectionnes partir d'une table.

Scnario 2 : Utiliser la variable StoreSQLQuery.

1476 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Consultez galement Scnario : Lire des donnes partir de diffrentes bases de donnes MySQL l'aide de
paramtres de connexion chargs dynamiquement du composant tContextLoad.

Guide de rfrence des Composants de Talend Open Studio 1477


tSasOutput

tSasOutput

Assurez-vous d'installer au pralable les modules sas.core.jar, sas.intrnet.javatools.jar et sas.svc.connection.jar sous le


chemin lib > java dans votre build du Studio Talend pour pouvoir utiliser toutes les fonctionnalits des composants SAS.
Vous pouvez vrifier que ces modules ont bien t installs partir de la vue Modules de votre Studio Talend.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
SAS URL Entrez le chemin d'accs la base de donnes.
Driver JAR Slectionnez le driver JAR partir de la liste droulante ou cliquez sur les trois points
[...] pour ajouter un nouveau JAR la liste.
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.

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.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si


l'enregistrement n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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

1478 Guide de rfrence des Composants de Talend Open Studio


Proprits du tSasOutput

[...] 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 table Cochez cette case pour que les donnes soient supprimes de la table slectionne avant
toute action.
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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying


+default+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository,
trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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 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 tSasOutput
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.

Guide de rfrence des Composants de Talend Open Studio 1479


Scnarios associs

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.

Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

1480 Guide de rfrence des Composants de Talend Open Studio


tSQLiteClose

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.

Pour un scnario associ au composant tSQLiteClose, consultez tMysqlConnection.

Guide de rfrence des Composants de Talend Open Studio 1481


tSQLiteCommit

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.

Si vous utilisez un lien de type Row > Main pour


relier le tSQLiteCommit votre Job, vos donnes seront
commites ligne par ligne. Dans ce cas, ne cochez pas la
case Close connection car la connexion sera ferme avant
la fin du commit de votre premire ligne.
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 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.

1482 Guide de rfrence des Composants de Talend Open Studio


tSQLiteConnection

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

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 Nom de la base de donnes.
Table Schema Nom du schma.
Use or register a shared DB Cochez cette case pour partager votre connexion ou rcuprer une
Connection connexion 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.

Shared DB Connection Name : dfinissez ou saisissez le nom de


la connexion partage.
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.

Notez que la fonctionnalit d'auto-commit permet de commiter


chaque instruction SQL comme transaction unique immdiatement
aprs son excution et que le composant de commit ne commite
pas jusqu' ce que toutes les instructions soient excutes. Pour
cette raison, si vous avez besoin de plus 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.

Guide de rfrence des Composants de Talend Open Studio 1483


Scnarios associs

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.

1484 Guide de rfrence des Composants de Talend Open Studio


tSQLiteInput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans la


vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
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 :

View schema : slectionnez cette option afin de voir le schma.

Guide de rfrence des Composants de Talend Open Studio 1485


Scnario : Filtrer des donnes SQlite

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).

Scnario : Filtrer des donnes SQlite


Le scnario suivant dcrit un Job assez simple qui permet d'appliquer une requte donne utilisant un filtre pour
extraire des lignes partir d'une base de donnes SQLite source et alimenter une table SQLite en sortie.

1486 Guide de rfrence des Composants de Talend Open Studio


Scnario : Filtrer des donnes SQlite

Cliquez-dposez partir de la Palette les composants tSQLiteInput et tSQLiteOutput.

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.

Slectionnez les paramtres d'encodage correspondants.

Pour le composant tSQLiteOutput, dans le champ Database de l'onglet Basic settings, slectionnez le chemin
d'accs la base de donnes de sortie.

Guide de rfrence des Composants de Talend Open Studio 1487


Scnario : Filtrer des donnes SQlite

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.

Synchronisez le schma avec le schma d'entre.

Slectionnez l'encodage puis dfinissez la limite de commit.

Enregistrez le Job puis excutez-le en appuyant sur F6.

Les donnes slectionnes sont renvoyes vers le fichier SQLite dfini.

1488 Guide de rfrence des Composants de Talend Open Studio


tSQLiteOutput

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager, dans


la vue Basic settings du composant de connexion crant cette connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion, afin de


lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers diffrents


niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
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.
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.

Create a table : crer une table qui n'existe pas encore.

Create table if doesn't exist : crer la table si ncessaire.

Clear a table : supprimer le contenu de la table.

Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de


Rollback.
Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne :

Guide de rfrence des Composants de Talend Open Studio 1489


Proprits du tSQLiteOutput

Insert : Ajouter de nouvelles entres la table. Le Job s'arrte lorsqu'il dtecte des doublons.

Update : Mettre jour les entres existantes.

Insert or update : insre un nouvel enregistrement. Si l'enregistrement avec la rfrence


donne existe dj, une mise jour est effectue.

Update or insert : met jour l'enregistrement avec la rfrence donne. Si l'enregistrement


n'existe pas, un nouvel enregistrement est insr.

Delete : Supprimer les entres correspondantes au flux d'entre.

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.

Pour plus d'informations, consultez https://help.talend.com/display/KB/Verifying+default


+values+in+a+retrieved+schema (en anglais).
Cliquez sur Edit schema pour modifier le schma. Si le schma est en mode Repository, trois
options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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.

1490 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Reference column : Saisissez une colonne de rfrence que le composant tSQLiteOutput


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
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 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.

Guide de rfrence des Composants de Talend Open Studio 1491


tSQLiteRollback

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.

1492 Guide de rfrence des Composants de Talend Open Studio


tSQLiteRow

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
Database Chemin d'accs au fichier de la base de donnes SQLite.
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 :

View schema : slectionnez cette option afin de voir le schma.

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,

Guide de rfrence des Composants de Talend Open Studio 1493


Proprits du tSQLiteRow

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.

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 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
PreparedStatement base 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.

Parameter Index : Saisissez la position du paramtre dans l'instruction SQL.

Parameter Type : Saisissez le type du paramtre.

Parameter Value : Saisissez la valeur du paramtre.

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.

1494 Guide de rfrence des Composants de Talend Open Studio


Scnario : Mettre jour des lignes SQLite

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 : Mettre jour des lignes SQLite


Le scnario suivant dcrit un Job qui permet de mettre jour un fichier de base de donne SQLite en utilisant une
requte prdfinie et un fichier dlimit.

Cliquez-dposez les composants tFileInputDelimited et tSQLiteRow.

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.

Modifiez le schma s'il n'est pas stock dans le Repository.

Assurez-vous que la longueur et le type dfinissent correctement les colonnes.

Dans l'espace de modlisation graphique, double-cliquez sur le composant tSQLiteRow pour afficher sa vue
Component.

Guide de rfrence des Composants de Talend Open Studio 1495


Scnario : Mettre jour des lignes SQLite

Dans l'onglet Basic settings du composant tSQLiteRow, renseignez le champ Database avec le chemin d'accs
au fichier mettre jour.

Le schma est en mode read-only puisqu'il doit correspondre au schma d'entre.

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 :

"Update download set type_os=? where id=?"

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.

Renseignez le champ Commit every.

Enregistrez le Job et appuyez sur F6 pour l'excuter.

1496 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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 :

Scnario 3 : Combiner deux flux pour une sortie slective.

Guide de rfrence des Composants de Talend Open Studio 1497


Guide de rfrence des Composants de Talend Open Studio
Composants DotNET
Ce chapitre contient les composants que vous pouvez trouver dans la famille DotNET de la Palette dans la
perspective Integration du Studio Talend.

La famille DotNET comprend les connecteurs les plus frquemment utiliss pour communiquer avec des
objets .NET.

Guide de rfrence des Composants de Talend Open Studio


tDotNETInstantiate

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.

La/les valeur(s) valide(s) doi(ven)t tre les paramtres requis par la


classe utiliser.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
composant.
Global Variables INSTANCE : instance d'un objet .NET. Cette variable est une variable After et retourne un object.

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.

1500 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

Scnario associ
Pour un scnario associ, consultez Scnario : Utiliser .NET dans Talend du composant tDotNETRow.

Guide de rfrence des Composants de Talend Open Studio 1501


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).

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.
Use a static method Cochez cette case pour invoquer une mthode statique dans .NET.
Cela dsactivera la case Use an existing instance.
Propagate a data to output Cochez cette case afin de propager des donnes transformes vers
la sortie
Use an existing instance Cochez cette case pour rutiliser une instance existante d'un
objet .NET dans la liste Existing instance to use.

Existing instance to use : Slectionnez une instance existante


d'objets .NET crs par d'autres composants .NET de la liste.

Cette case est dsactive si vous avez coch Use


a static method. Cochez cette case dsactivera les
champs Dll to load, Fully qualified class name(i.e.
ClassLibrary1.NameSpace2.Class1) et Value(s) to pass
to the constructor.
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).
Method name Renseignez ce champ en saisissant le nom de la mthode invoquer
dans .NET.
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.

La/les valeur(s) valide(s) doi(ven)t tre les paramtres requis par la


classe utiliser.
Method Parameters Cliquez sur le bouton [+] pour ajouter une ou plusieurs ligne(s) de
paramtres passer la mthode.

1502 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser .NET dans Talend

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.

Scnario : Utiliser .NET dans Talend


Ce scnario dcrit un Job trois composants utilisant une bibliothque DLL contenant une classe appele
Test1.Class1. On invoque une mthode de cette classe qui traite la valeur et crit les donnes dans la console.

Guide de rfrence des Composants de Talend Open Studio 1503


Scnario : Utiliser .NET dans Talend

Prrequis
Avant de reproduire ce scnario, vous devez d'abord construire votre environnement d'excution.

Crez le DLL charger par le tDotNETInstantiate

Cette classe d'exemple construite dans .NET se prsente comme suit :

using System;
using System.Collections.Generic;
using System.Text;

namespace Test1
{
public class Class1
{
string s = null;
public Class1(string s)
{
this.s = s;
}

public string getValue()


{
return "Return Value from Class1: " + 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.

Le DLL d'excution est compatible avec le DLL charger.

Relier les composants


1. Dposez les composants suivants de la Palette dans l'espace de modlisation graphique :
tDotNETInstantiate, tDotNETRow et tLogRow.

2. Connectez le tDotNETInstantiate au tDotNETRow l'aide d'un lien Trigger > OnSubjobOk.

3. Reliez le tDotNETRow au tLogRow l'aide d'un lien Row > Main.

Configurer le tDotNETInstantiate
1. Double-cliquez sur le tDotNETInstantiate pour afficher sa vue Basic settings et dfinir ses proprits de
base.

1504 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser .NET dans Talend

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.

Dans cet exemple, saisissez :

"Hello world"

Configurer le composant tDotNETRow


1. Double-cliquez sur le composant tDotNETRow afin d'afficher sa vue Basic settings et dfinir ses proprits
de base.

Guide de rfrence des Composants de Talend Open Studio 1505


Scnario : Utiliser .NET dans Talend

2. Cochez la case Propagate data to output.

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.

6. Slectionnez newColumn dans la liste Output value target column.

7. Laissez les autres paramtres tels qu'ils sont.

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.

3. Slectionnez Table dans la zone Mode.

Sauvegardez votre Job et appuyez sur la touche F6 pour l'excuter.

1506 Guide de rfrence des Composants de Talend Open Studio


Scnario : Utiliser .NET dans Talend

Vous pouvez constater, dans les rsultats, que le texte Return Value from Class1 est ajout devant la valeur
rcupre Hello world.

Guide de rfrence des Composants de Talend Open Studio 1507


Guide de rfrence des Composants de Talend Open Studio
Composants ELT
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille ELT de la Palette
dans la perspective Integration du Studio Talend.

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.

Guide de rfrence des Composants de Talend Open Studio


tAccessConnection

tAccessConnection

Le composant AccessConnection appartient deux familles diffrentes : Databases et ELT. Pour plus
d'informations, consultez tAccessConnection.

1510 Guide de rfrence des Composants de Talend Open Studio


tAS400Connection

tAS400Connection

Le composant tAS400Connection appartient deux familles diffrentes diffrentes : Databases et ELT. Pour plus
d'informations, consultez tAS400Connection.

Guide de rfrence des Composants de Talend Open Studio 1511


tCombinedSQLAggregate

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns afin de rcuprer le schma


du composant prcdent.
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 dans divers projets et Jobs.
Voir galement le Guide utilisateur du Studio Talend.
Group by Dfinit les ensembles d'agrgation, dont les valeurs sont utilises
pour les calculs.
Output Column : Slectionnez le libell de colonne dans la liste
fournie, base sur la structure de schma que vous avez dfinie.
Vous pouvez ajouter autant de colonnes de sortie que vous le
souhaitez afin d'affiner les agrgations.
Input Column : Slectionnez les libells des colonnes d'entre
afin de les faire correspondre au contenu attendu des colonnes de
sortie, dans le cas o vous souhaitez que les libells du schma de
sortie soient diffrents du schma d'entre.
Operations Slectionnez le type d'opration et la valeur utiliser pour le calcul
et le champ de sortie.
Output Column : Slectionnez le champ de destination dans la
liste.
Function : Slectionnez l'une des oprations suivantes effectuer
sur les donnes : count, min, max, avg, sum, first, last, distinct
et count (distinct).

1512 Guide de rfrence des Composants de Talend Open Studio


Scnario : Filtrer et agrger des colonnes d'une table directement sur le SGBD

Input column : Slectionnez la colonne d'entre partir de


laquelle vous souhaitez collecter les valeurs agrger.
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 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 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 : Filtrer et agrger des colonnes d'une table


directement sur le SGBD
Le scnario suivant cre un Job ouvrant une connexion une base de donnes MySQL et :

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.

Pour filtrer et agrger les colonnes d'une table de base de donnes :

Dposez les composants suivants de la Palette dans l'espace de modlisation graphique : tMysqlConnection,
tCombinedSQLInput, tCombinedSQLFilter, tCombinedSQLAggregate, tCombinedSQLOutput et
tMysqlCommit.

Connectez les composants tMysqlConnection, tCombinedSQLInput et tMysqlCommit l'aide de liens


OnSubjobOk.

Connectez les composants tCombinedSQLInput, tCombinedSQLFilter, tCombinedSQLAggregate et


tCombinedSQLOutput l'aide d'un lien Combine.

Guide de rfrence des Composants de Talend Open Studio 1513


Scnario : Filtrer et agrger des colonnes d'une table directement sur le SGBD

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.

1514 Guide de rfrence des Composants de Talend Open Studio


Scnario : Filtrer et agrger des colonnes d'une table directement sur le SGBD

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.

Dans l'espace de modlisation graphique, double-cliquez sur le composant tCombinedSQLAggregate 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 [...].

Guide de rfrence des Composants de Talend Open Studio 1515


Scnario : Filtrer et agrger des colonnes d'une table directement sur le SGBD

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.

Cliquez dans la ligne Function et slectionnez l'opration effectuer.

Dans l'espace de modlisation graphique, double-cliquez sur le tCombinedSQLOutput afin d'afficher sa vue
Component et dfinir ses proprits de base.

1516 Guide de rfrence des Composants de Talend Open Studio


Scnario : Filtrer et agrger des colonnes d'une table directement sur le SGBD

Dans la liste Database type, slectionnez la base de donnes correspondante.

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 ce scnario, le composant tCombinedSQLOutput instancie sept colonnes provenant du composant


prcdent dans le Job (tCombinedSQLAggregate) : state, empl_count, avg_salary, min_salary, max_salary,
oldest_empl et youngest_empl.

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.

Sauvegardez votre Job et appuyez sur F6 pour l'excuter.

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.

Guide de rfrence des Composants de Talend Open Studio 1517


tCombinedSQLFilter

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.

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 :

View schema : slectionnez cette option afin de voir le schma.

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 dans divers projets et Jobs.
Voir galement le Guide utilisateur du Studio Talend.
Logical operator between Slectionnez l'oprateur logique ajouter entre les conditions de
conditions filtre dfinies dans le tableau Conditions.

Les deux oprateurs disponibles sont : Or et And.


Conditions Cliquez sur le bouton [+] pour ajouter autant de conditions que
voulu. Les conditions sont excutes les unes aprs les autres pour
chaque ligne.
Input Column : Slectionnez la colonne filtrer.
Operator : Slectionnez le type de clause WHERE : =, < >, >, <,
>=, <=, LIKE, IN, NOT IN, et EXIST IN.
Value : Saisissez les valeurs utiliser dans la clause WHERE.
Negate : Cochez cette case pour activer la condition contraire
celle dfinie.
Use custom SQL Cochez cette case afin de personnaliser une clause WHERE en
ditant le code dans le champ SQL Condition.
Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du
Job ainsi qu'au niveau de chaque composant.

1518 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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 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.

Guide de rfrence des Composants de Talend Open Studio 1519


tCombinedSQLInput

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.

Renseignez ce champ si vous utilisez Oracle.


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 :

View schema : slectionnez cette option afin de voir le schma.

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 du Guide utilisateur du Studio
Talend.
Repository : Le schma existe dj et est stock dans le
Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs.
Voir galement le Guide utilisateur du Studio Talend.
Add additional columns Cette option vous permet d'effectuer des actions sur les colonnes,
l'exception des actions d'insertion, de mise jour, de suppression
ou qui ncessitent un prtraitement particulier.
Name : Saisissez le nom de la colonne du schma devant tre
modifie.
SQL expression : Saisissez l'expression SQL excuter pour
modifier les donnes dans la colonne correspondante.
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 Flow et retourne un entier.

1520 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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 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.

Guide de rfrence des Composants de Talend Open Studio 1521


tCombinedSQLOutput

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.

Renseignez ce champ si vous utilisez Oracle.


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 :

View schema : slectionnez cette option afin de voir le schma.

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].

Cliquez sur le bouton Sync columns afin de rcuprer le schma


du composant prcdent.
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 dans divers projets et Jobs.
Voir galement le Guide utilisateur du Studio Talend.
Action on data Slectionnez INSERT dans la liste afin d'insrer les
enregistrements du flux d'entre dans la table cible de la base de
donnes.
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 Flow et retourne un entier.

QUERY : requte SQL traite. Cette variable est une variable Flow et retourne une chane de
caractres.

1522 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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 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.

Guide de rfrence des Composants de Talend Open Studio 1523


tDB2Connection

tDB2Connection

Le composant tDB2Connection appartient deux familles diffrentes : Databases et ELT. Pour plus
d'informations, consultez tDB2Connection.

1524 Guide de rfrence des Composants de Talend Open Studio


tELTGreenplumInput

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.

Famille de composants ELT/Map/Greenplum


Fonction Fournit le schma de table utiliser pour la requte SQL excuter.
Objectif Le composant tELTGreenplumInput vous permet d'ajouter autant de tables d'entre (input) que
ncessaire pour les requtes Insert les plus complexes.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit la nature le nombre
de champs traiter. 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 :

View schema : slectionnez cette option afin de voir le schma.

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 dans divers projets et Jobs. Voir
galement le Guide utilisateur duStudio Talend.
Default Table Name Saisissez le nom de la table par dfaut, entre guillemets doubles.
Default Schema Name Saisissez le nom du schma par dfaut, entre guillemets doubles.
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.

Guide de rfrence des Composants de Talend Open Studio 1525


Scnarios associs

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 :

Scnario: Mapper les donnes l'aide d'une jointure implicite simple

Scnario 1 : Agrger les colonnes d'une table et appliquer un filtre

Scnario 2 : ELT utilisant une table Alias

1526 Guide de rfrence des Composants de Talend Open Studio


tELTGreenplumMap

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
ELT Greenplum L'diteur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de
Map Editor construire graphiquement la commande SQL excuter. Le nom des colonnes du schma
peut tre diffrent du nom des colonnes dans la base de donnes.
Style link Slectionnez le type d'affichage des liens.

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.

Guide de rfrence des Composants de Talend Open Studio 1527


Proprits du tELTGreenplumMap

Database Nom de la base de donnes


Username et Donnes 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.
Advanced settings Additional JDBC Spcifiez des informations supplmentaires de connexion la base de donnes cre.
parameters Cette 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 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.

Ajouter des clauses WHERE et d'autres clauses


Vous pouvez galement restreindre une requte Select l'aide d'une clause WHERE et/ou l'aide d'autres clauses
telles que GROUP BY, ORDER BY, etc., en cliquant sur le bouton Add filter row situ en haut de la table de
sortie dans l'diteur de map.

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.

1528 Guide de rfrence des Composants de Talend Open Studio


Scnario: Mapper les donnes l'aide d'une jointure implicite simple

Veillez ce que les composants d'entre soient tous lis correctement au composant ELT Map pour garantir que
les inclusions, jointures et clauses fonctionnent.

Scnario: Mapper les donnes l'aide d'une jointure


implicite simple
Dans ce scnario, un composant tELTGreenplumMap est utilis afin de rcuprer les donnes de la table source
employee_by_statecode, comparer sa colonnestatecode la table statecode et enfin mapper les colonnes dsires
partir des deux tables vers la table de sortie employee_by_state.

Avant l'excution du Job, les trois tables employee_by_statecode, statecode et employee_by_state ressemblent
ceci :

Dposer les composants


1. Dposez les composants suivants de la Palette dans l'espace de modlisation
graphique : un tGreenplumConnection, deux tELTGreenplumInput, un tELTGreenplumMap,
untELTGreenplumOutput, un tGreenplumCommit, untGreenplumInput et un tLogRow.

2. Renommez le composant tGreenplumConnection en connect_to_greenplum_host, les deux


tELTGreenplumInput en employee+statecode et statecode, le tELTGreenplumMap en match+map,
le tELTGreenplumOutput en map_data_output, le tGreenplumCommit en commit_to_host, le
tGreenplumInput en read_map_output_table et le tLogRow en show_map_data

3. Reliez le composant tGreenplumConnection au tELTGreenplumMap l'aide d'un lien OnSubjobOk.

Reliez le composant tELTGreenplumMap au tGreenplumCommit l'aide d'un lien OnSubjobOk.

Reliez le composant tGreenplumCommit au tGreenplumInput l'aide d'un lien OnSubjobOk.

4. Reliez le composant tGreenplumInput au tLogRow l'aide d'une connexion Row > Main.

Les deux tELTGreenplumInput et le composant tELTGreenplumOutput seront connects plus tard au


tELTGreenplumMap, une fois les tables correspondantes dfinies.

Guide de rfrence des Composants de Talend Open Studio 1529


Scnario: Mapper les donnes l'aide d'une jointure implicite simple

Configurer les composants


1. Double-cliquez sur le composant tGreenplumConnection pour ouvrir sa vue Basic settings.

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.

1530 Guide de rfrence des Composants de Talend Open Studio


Scnario: Mapper les donnes l'aide d'une jointure implicite simple

Cliquez sur le bouton [+] pour ajouter trois colonnes et appelez-les id, name et statecode, avec pour type
respectivement INT4, VARCHAR, et INT4.

Cliquez sur OK pour fermer l'diteur de schma.

Reliez le employee+statecode au tELTGreenplumMap en utilisant le composant de sortie


employee_by_statecode.

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.

Guide de rfrence des Composants de Talend Open Studio 1531


Scnario: Mapper les donnes l'aide d'une jointure implicite simple

Cliquez sur OK pour fermer l'diteur de schma.

Reliez le statecode au tELTGreenplumMap en utilisant la sortie statecode.

5. Cliquez le composant tELTGreenplumMap pour ouvrir sa vue Basic settings dans l'onglet Component.

Cochez la case Use an existing connection.

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.

1532 Guide de rfrence des Composants de Talend Open Studio


Scnario: Mapper les donnes l'aide d'une jointure implicite simple

Slectionnez les tables employee_by_statecode et statecode dans la liste et cliquez sur Ok.

Les tables apparaissent sur le panneau gauche de l'diteur.

8. Dans le coin en haut droite, cliquez sur le bouton [+] pour ajouter la table de sortie nomme
employee_by_state.

Cliquez sur OK pour fermer l'diteur de map.

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.

Guide de rfrence des Composants de Talend Open Studio 1533


Scnario: Mapper les donnes l'aide d'une jointure implicite simple

Cliquez sur le bouton [+] pour ajouter trois colonnes et appelez-les respectivement id, name et state, avec
pour type respectivement INT4, VARCHAR, et VARCHAR .

Cliquez sur OK pour fermer l'diteur de schma.

Reliez le composant tELTGreenplumMap au tELTGreenplumOutput en utilisant la table de sortie


employee_by_state.

Cliquez sur OK dans la fentre pop-up pour rcuprer le schma du tELTGreenplumOutput.

La table de sortie employee_by_state partage maintenant le mme schma que celui du


tELTGreenplumOutput.

11. Double-cliquez sur le composant tELTGreenplumMap pour ouvrir l'diteur de map.

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.

Cliquez sur OK pour fermer l'diteur de mapping.

12. Double-cliquez sur le tGreenplumInput pour ouvrir sa vue Basic settings dans l'onglet Component.

Cochez la case Use an existing connection.

Dans le champ Table name, saisissez le nom de la table source, appele employee_by_state.

Dans le champ Query, saisissez la commande "SELECT * FROM \"employee_by_state\"".

13. Double-cliquez sur le composant tLogRow pour ouvrir sa vue Basic settings dans l'onglet Component.

1534 Guide de rfrence des Composants de Talend Open Studio


Scnario associ

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.

2. Appuyez sur F6 pour excuter le 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 :

Scnario 1 : Agrger les colonnes d'une table et appliquer un filtre.

Scnario 2 : ELT utilisant une table Alias.

Pour un scnario expliquant les sous-requtes, consultez Scnario : Mapper des donnes l'aide d'une sous-
requte.

Guide de rfrence des Composants de Talend Open Studio 1535


tELTGreenplumOutput

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.

Famille du composant ELT/Map/Greenplum


Fonction Excute les actions sur la table spcifie et insre les donnes selon le schma de sortie dfini dans
le ELT Mapper.
Objectif Excute les requtes SQL Insert, Update et Delete dans la base de donnes Greenplum.
Basic settings Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les
oprations suivantes :

Insert : Ajoute de nouvelles lignes la table. Si des doublons sont


identifis, le Job s'arrte.

Update : Met jour des lignes existantes.

Delete : Supprime les entres correspondantes au flux d'entre.


Schema et Edit schema Un schma est une description de lignes, il dfinit la nature le nombre
de champs traiter. 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 :

View schema : slectionnez cette option afin de voir le schma.

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 dans divers projets et Jobs. Voir
galement le Guide utilisateur duStudio Talend.
Where clauses for (for Saisissez la clause permettant de filtrer les donnes mettre jour
UPDATE and DELETE ou supprimer lors des oprations de mise jour ou de suppression.
only)
Default Table Name Saisissez le nom de la table par dfaut, entre guillemets doubles.
Default Schema Name Saisissez le nom du schma par dfaut, entre guillemets doubles.
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.

1536 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 :

Scnario: Mapper les donnes l'aide d'une jointure implicite simple

Scnario 1 : Agrger les colonnes d'une table et appliquer un filtre

Scnario 2 : ELT utilisant une table Alias

Guide de rfrence des Composants de Talend Open Studio 1537


tELTJDBCInput

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.

Famille de composant ELT/Map/JDBC


Fonction Fournit le schma de la table d'entre la commande SQL qui sera excute.
Objectif Permet d'ajouter autant de tables que ncessaires dans une commande Insert qui peut tre complexe.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits. Le schma est soit local (built-in) soit distant
dans le Repository. Le schma dfini est ensuite pass au composant
ELT Mapper afin de l'utiliser dans la commande SQL Insert.

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 :

View schema : slectionnez cette option afin de voir le schma.

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 dans divers projets et Jobs. Voir
galement le Guide utilisateur du Studio Talend.
Default Table Name Saisissez le nom de la table par dfaut.
Default Schema Name Saisissez le nom du schma par dfaut.
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.

1538 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

Utilisation L'utilisation du composant tELTJDBCInput est troitement lie celle du 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.

Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTJDBCInput, consultez les scnarios suivants du
composant tELTMysqlMap :

Scnario 1 : Agrger les colonnes d'une table et appliquer un filtre.

Scnario 2 : ELT utilisant une table Alias.

Guide de rfrence des Composants de Talend Open Studio 1539


tELTJDBCMap

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.

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
ELT JDBC Map L'diteur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de
Editor construire graphiquement la commande SQL excuter. Le nom des colonnes du
schma peut tre diffrent du nom des colonnes dans la base de donnes.
Style link Slectionnez le type d'affichage des liens.

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.

1540 Guide de rfrence des Composants de Talend Open Studio


Proprits du tELTJDBCMap

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.
parameters Cette 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 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 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.

Ajouter des clauses WHERE et d'autres clauses


Vous pouvez galement restreindre une requte Select l'aide d'une clause WHERE et/ou l'aide d'autres clauses
telles que GROUP BY, ORDER BY, etc., en cliquant sur le bouton Add filter row situ en haut de la table de
sortie dans l'diteur de map.

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.

Guide de rfrence des Composants de Talend Open Studio 1541


Scnarios associs

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 :

Scnario 1 : Agrger les colonnes d'une table et appliquer un filtre.

Scnario 2 : ELT utilisant une table Alias.

Pour un scnario expliquant les sous-requtes, consultez Scnario : Mapper des donnes l'aide d'une sous-
requte.

1542 Guide de rfrence des Composants de Talend Open Studio


tELTJDBCOutput

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.

Famille du composant ELT/Map/JDBC


Fonction Effectue l'action sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini
dans le Mapper ELT.
Objectif Excute la requte Insert dans la base de donnes JDBC.
Basic settings Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les
oprations suivantes :

Insert : Ajoute de nouvelles lignes la table. Si des doublons sont


identifis, le Job s'arrte.

Update : Met jour des lignes existantes.

Delete : Supprime les entres correspondantes au flux d'entre.


Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits. 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 :

View schema : slectionnez cette option afin de voir le schma.

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 dans divers projets et Jobs. Voir
galement le Guide utilisateur du Studio Talend.
Where clauses for (for Saisissez la clause permettant de filtrer les donnes mettre jour
UPDATE and DELETE ou supprimer lors des oprations de mise jour ou de suppression.
only)
Default Table Name Saisissez le nom de la table par dfaut, entre guillemets doubles.
Default Schema Name Saisissez le nom du schma par dfaut, entre guillemets doubles.

Guide de rfrence des Composants de Talend Open Studio 1543


Scnarios associs

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 :

Scnario 1 : Agrger les colonnes d'une table et appliquer un filtre.

Scnario 2 : ELT utilisant une table Alias.

1544 Guide de rfrence des Composants de Talend Open Studio


tELTMSSqlInput

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.

Famille de composant ELT/Map/MSSql


Fonction Fournit le schma de la table d'entre la commande SQL qui sera excute.
Objectif Permet d'ajouter autant de tables que ncessaires dans une commande Insert qui peut tre complexe.
Basic settings Schema et Edit schema Un schma est une description de lignes, il dfinit le nombre de
champs qui sont traits. Le schma est soit local (built-in) soit distant
dans le Repository. Le schma dfini est ensuite pass au composant
ELT Mapper afin de l'utiliser dans la commande SQL Insert

Cliquez sur Edit schema pour modifier le schma. Si le schma est


en mode Repository, trois options sont disponibles :

View schema : slectionnez cette option afin de voir le schma.

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].

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 dans divers projets et Jobs. Voir
galement le Guide utilisateur du Studio Talend.
Default Table Name Saisissez le nom de la table par dfaut.
Default Schema Name Saisissez le nom du schma par dfaut.
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.

Guide de rfrence des Composants de Talend Open Studio 1545


Scnarios associs

Utilisation L'utilisation du composant tELTMSSqlInput est troitement lie celle du tELTMSSqlMap.


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 scnarios utilisant un composant semblable au tELTMSSqlInput, consultez les scnarios suivants du
composant tELTMysqlMap dans :

Scnario 1 : Agrger les colonnes d'une table et appliquer un filtre.

Scnario 2 : ELT utilisant une table Alias.

1546 Guide de rfrence des Composants de Talend Open Studio


tELTMSSqlMap

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 :

1. Au niveau parent, enregistrer la connexion la base de donnes partager,


dans la vue Basic settings du composant de connexion crant cette
connexion.

2. Au niveau enfant, utiliser un composant ddi la cration de connexion,


afin de lire la connexion enregistre.

Pour plus d'informations concernant le partage d'une connexion travers


diffrents niveaux de Jobs, consultez le Guide utilisateur du Studio Talend.
ELT MSSql Map L'diteur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire
Editor graphiquement la commande SQL excuter. Le nom des colonnes du schma peut tre
diffrent du nom des colonnes dans la base de donnes.
Style link Slectionnez le type d'affichage des liens.

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

Guide de rfrence des Composants de Talend Open Studio 1547


Proprits du tELTMSSqlMap

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.

Ajouter des clauses WHERE et d'autres clauses


Vous pouvez galement restreindre une requte Select l'aide d'une clause WHERE et/ou l'aide d'autres clauses
telles que GROUP BY, ORDER BY, etc., en cliquant sur le bouton Add filter row situ en haut de la table de
sortie dans l'diteur de map.

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.

1548 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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 :

Scnario 1 : Agrger les colonnes d'une table et appliquer un filtre.

Scnario 2 : ELT utilisant une table Alias.

Pour un scnario expliquant les sous-requtes, consultez Scnario : Mapper des donnes l'aide d'une sous-
requte.

Guide de rfrence des Composants de Talend Open Studio 1549


tELTMSSqlOutput

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.

Famille du composant ELT/Map/MSSql


Fonction Effectue l'action sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini
dans le Mapper ELT.
Objectif Excute la requte Insert dans la base de donnes MSSql.
Basic settings Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les
oprations suivantes :

Insert : Ajoute de nouvelles lignes la table. Si des doublons sont


identifis, le Job s'arrte.

Update : Met jour des lignes existantes.

Delete : Supprime les entres correspondantes au flux 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
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 :

View schema : slectionnez cette option afin de voir le schma.

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 dans divers projets et Jobs. Voir
galement le Guide utilisateur duStudio Talend.
Where clauses for (for Saisissez la clause permettant de filtrer les donnes mettre jour
UPDATE and DELETE ou supprimer lors des oprations de mise jour ou de suppression.
only)
Default Table Name Saisissez le nom de la table par dfaut, entre guillemets doubles.
Default Schema Name Saisissez le nom du schma par dfaut, entre guillemets doubles.

1550 Guide de rfrence des Composants de Talend Open Studio


Scnarios associs

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.

Вам также может понравиться