Vous êtes sur la page 1sur 1380

Talend Open Studio Composants

4.X

Guide de rfrence

Intentionally Blank

ii

Composants Talend Open Studio

Creative Commons License

Version 4.0_b
Convient pour lutilisation de Talend Open Studio v4.0.x. Annule et remplace toute version antrieure du Guide de rfrence.

Copyright
Cette documentation est mise disposition selon les termes du Contrat Public Creative Commons (CPCC). Pour plus dinformations concernant votre utilisation de cette documentation en accord avec le contrat CPCC, consultez : http://creativecommons.org/licenses/by-nc-sa/2.0/fr

Creative Commons License

Composants Talend Open Studio

iii

iv

Composants Talend Open Studio

Creative Commons License

Talend Open Studio Composants Guide de rfrence ..................... i

Prface .....................................................................xxiii Objectif ..............................................................xxiii Public vis ..........................................................xxiii Conventions typographiques ..............................xxiii Historique des versions .......................................... xxiv Remarques et Support ............................................ xxv

Composants Business Intelligence ............. 1


tDB2SCD ...................................................................... 2 Proprits du tDB2SCD .......................................... 2 Scnario associ ...................................................... 3 tDB2SCDELT .............................................................. 4 Proprits du tDB2SCDELT ................................... 4 Scnario associ ...................................................... 6 tGreenplumSCD .......................................................... 7 Proprits du tGreenplumSCD ................................ 7 Scnario associ ...................................................... 8 tInformixSCD .............................................................. 9 Proprits du tInformixSCD .................................... 9 Scnario associ .................................................... 10 tIngresSCD ................................................................ 11 Proprits du tIngresSCD ...................................... 11 Scnario associ .................................................... 12 tMondrianInput ........................................................ 13 Proprits du tMondrianInput ............................... 13 Scnario : Tables en jointure croise ..................... 14 tMSSqlSCD ................................................................ 17 Proprits du tMSSqlSCD ..................................... 17 Scnario associ .................................................... 18 tMysqlSCD ................................................................. 19 Proprits du tMysqlSCD ...................................... 19 Mthodologie de gestion du SCD ...................... 20 Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 ............................ 23 tMysqlSCDELT ......................................................... 32 Proprits du tMysqlSCDELT .............................. 32 Scnario associ .................................................... 34 tOracleSCD ................................................................ 35 Proprits du tOracleSCD ..................................... 35 Scnario associ .................................................... 36 tOracleSCDELT ........................................................ 37 Proprits du tOracleSCDELT .............................. 37 Scnario associ .................................................... 39 tParAccelSCD ............................................................ 40 Creative Commons License

Proprits du tParAccelSCD ..................................40 Scnario associ .....................................................41 tPostgresPlusSCD ......................................................42 Proprits du tPostgresPlusSCD ............................42 Scnario associ .....................................................43 tPostgresPlusSCDELT ..............................................44 Proprits du tPostgresPlusSCDELT .....................44 Scnario associ .....................................................46 tPostgresqlSCD ..........................................................47 Proprits du tPostgresqlSCD ................................47 Scnario associ .....................................................48 tPostgresqlSCDELT ..................................................49 Proprits du tPostgresqlSCDELT ........................49 Scnario associ .....................................................51 tSPSSInput .................................................................52 Proprits du tSPSSInput ......................................52 Scnario : Afficher le contenu dun fichier SPSS .52 tSPSSOutput ..............................................................56 Proprits du tSPSSOutput ...................................56 Scnario : Ecrire des donnes dans un fichier .sav 56 tSPSSProperties .........................................................59 Proprits du tSPSSProperties ..............................59 Scnario associ .....................................................59 tSPSSStructure ..........................................................60 Proprits du tSPSSStructure ................................60 Scnario associ .....................................................60 tSybaseSCD ................................................................61 Proprits du tSybaseSCD .....................................61 Scnario associ .....................................................62 tSybaseSCDELT ........................................................63 Proprits du tSybaseSCDELT .............................63 Scnario associ ....................................................65

Composants Business ................................67


tAlfrescoOutput .........................................................68 Proprits du tAlfrescoOutput ...............................68 Procdure dinstallation ......................................70 Dmatrialisation, tAlfrescoOutput et Gestion de Contenu ........................................................................73 Scnario : Crer des documents sur un serveur Alfresco .................................................................................74 tCentricCRMInput ....................................................80 Proprits du tCentricCRMInput ...........................80 Scnario associ .....................................................80 tCentricCRMOutput .................................................81 Proprits du tCentricCRMOutput .......................81 Scnario associ ....................................................81 tHL7Input ...................................................................82 tHL7Input Properties .............................................82 Scnario : Retrouver des informations concernant les patients et les vnements partir dun fichier HL7. ..83 tMicrosoftCRMInput ................................................86 v

Composants Talend Open Studio

Proprits du tMicrosoftCRMInput ...................... 86 Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques ................. 87 tMicrosoftCRMOutput ............................................. 94 Proprits du tMicrosoftCRMOutput ................... 94 Scnario associ ................................................... 95 tMSAXInput .............................................................. 96 Proprits du tMSAXInput ................................... 96 Scnario associ .................................................... 96 tMSAXOutput ........................................................... 97 Proprits du tMSAXOutput ................................ 97 Scnario : Insrer des donnes dans une table dfinie sur le serveur Microsoft AX ....................................... 98 Scnario 2 : Effacer des donnes dune table prcise sur le serveur MicrosoftAX. ...................................... 101 tOpenbravoERPInput ............................................ 104 Proprits du tOpenbravoERPInput ................... 104 Scnario associ ................................................. 105 tOpenbravoERPOutput .......................................... 106 Proprits du tOpenbravoERPOutput ................ 106 Scnario associ ................................................. 106 tSalesforceBulkExec ................................................ 107 Proprits du tSalesforceBulkExec ..................... 107 Scnario associ .................................................. 108 tSalesforceConnection ............................................ 109 Proprits du tSalesforceConnection ................... 109 Scnario associ .................................................. 109 tSalesforceGetDeleted ............................................. 110 Proprits du tSalesforceGetDeleted ................... 110 Scnario : Rcuprer les donnes supprimes du serveur Salesforce ..................................................... 111 tSalesforceGetServerTimestamp ........................... 113 Proprits du tSalesforceGetServerTimestamp ... 113 Scnario associ .................................................. 113 tSalesforceGetUpdated ........................................... 114 Proprits du tSalesforceGetUpdated .................. 114 Scnario associ .................................................. 115 tSalesforceInput ...................................................... 116 Proprits du tSalesforceInput ............................. 116 Scnarios associs ............................................... 117 tSalesforceOutput .................................................... 118 Proprits du tSalesforceOutput .......................... 118 Scnario : Supprimer des donnes de lobjet Account 119 tSalesforceOutputBulk ........................................... 122 Proprits du tSalesforceOutputBulk .................. 122 Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com ......................................... 122 tSalesforceOutputBulkExec ................................... 128 Proprits du tSalesforceOutputBulkExec .......... 128 Scnario : Insrer des donnes de masse dans votre Salesforce.com .......................................................... 129 vi

tSAPCommit ............................................................133 Proprits du tSAPCommit ..................................133 Scnario associ ...................................................133 tSAPConnection .......................................................134 Proprits du tSAPConnection ............................134 Scnario associ ...................................................134 tSAPInput .................................................................135 Proprits du tSAPInput ......................................135 Scnario 1 : Rcuprer les mtadonnes dun systme SAP ............................................................................136 Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE .........................142 tSAPOutput ..............................................................148 Proprits du tSAPOutput ....................................148 Scnarios associs ................................................149 tSAPRollback ...........................................................150 Proprits du tSAPRollback ................................150 Scnario associ ...................................................150 tSugarCRMInput .....................................................151 Proprits du tSugarCRMInput ...........................151 Scnario: Extraire les donnes dun compte partir de SugarCRM .................................................................151 tSugarCRMOutput ..................................................154 Proprits du tSugarCRMOutput ........................154 Scnario associ ..................................................154 tVtigerCRMInput ....................................................155 Proprits du tVtigerCRMInput ..........................155 Scnario associ ..................................................155 tVtigerCRMOutput .................................................156 Proprits du tVtigerCRMOutput .......................156 Scnario associ ...................................................156

Composants Custom Code .......................157


tGroovy .....................................................................158 Proprits du tGroovy ..........................................158 Scnarios associs ................................................158 tGroovyFile ...............................................................159 Proprits du tGroovyFile ....................................159 Scnario : Appeler du code Groovy contenu dans un fichier .........................................................................159 tJava ..........................................................................161 Proprits du tJava ...............................................161 Scnario : Imprimer le contenu dune variable ....161 tJavaFlex ...................................................................164 Proprits du tJavaFlex ........................................164 Scnario 1 : Gnrer un flux de donnes .............165 Scnario 2 : Traiter des lignes de donnes avec le tJavaFlex ....................................................................167 tJavaRow ..................................................................171 Proprits du tJavaRow ........................................171 Scnario associ ..................................................171 tLibraryLoad ...........................................................172 Creative Commons License

Composants Talend Open Studio

Proprits du tLibraryLoad ................................. 172 Scnario : Vrifier le format dune adresse e-mail .... 172

Composants Data Quality ...................... 175


tAddCRCRow .......................................................... 176 Proprits du tAddCRCRow ............................... 176 Scnario : Ajouter une cl de substitution un fichier 176 tExtractRegexFields ............................................... 179 tFuzzyMatch ............................................................ 180 Proprits du tFuzzyMatch .................................. 180 Scnario 1 : Distance de Levenshtein de 0 pour les prnoms ..................................................................... 181 Scnario 2 : Distance de Levenshtein de 1 ou 2 pour les prnoms ............................................................... 183 Scnario 3 : Distance mtaphonique pour les prnoms 184 tIntervalMatch ........................................................ 186 Scnario : Identifier le pays partir de lIP (Perl et Java) .............................................................................. 187 tParseAddress .......................................................... 191 Proprits du tParseAddress ................................ 191 Scnario associ .................................................. 192 tParseName .............................................................. 193 Proprits du tParseName ................................... 193 Scnario associ .................................................. 194 tReplaceList ............................................................. 195 Proprits du tReplaceList ................................... 195 Scnario : Remplacement partir dun fichier de rfrence .................................................................... 196 tSchemaComplianceCheck ..................................... 199 Proprits du tSchemaComplianceCheck ........... 199 Scnario : Valider les dates en fonction dun schma (java) ......................................................................... 200 tUniqRow ................................................................. 204 Proprits du tUniqRow ...................................... 204 Scnario : Ddoublonner des donnes ................. 204

Composants Databases ........................... 207


tAccessInput ............................................................ 208 Proprits du tAccessInput .................................. 208 Scnarios associs ............................................... 209 tAccessOutput .......................................................... 210 Proprits du tAccessOutput ............................... 210 Scnarios associs ............................................... 212 tAccessRow .............................................................. 213 Proprits du tAccessRow ................................... 213 Scnarios associs ............................................... 214 tAS400Commit ........................................................ 215 Proprits du tAS400Commit ............................. 215 Creative Commons License

Scnario associ ...................................................215 tAS400Close .............................................................216 Proprits du tAS400Close ..................................216 Scnario associ ...................................................216 tAS400Connection ...................................................217 Proprits du tAS400Connection .........................217 Scnario associ ...................................................218 tAS400Input .............................................................219 Proprits du tAS400Input ...................................219 Scnarios associs ................................................220 tAS400LastInsertId .................................................221 Proprits du tAS400LastInsertId ........................221 Scnario associ ...................................................221 tAS400Output ..........................................................222 Proprits du tAS400Output ................................222 Scnarios associs ................................................224 tAS400Rollback .......................................................226 Proprits du tAS400Rollback ............................226 Scnario associ ...................................................226 tAS400Row ...............................................................227 Proprits du tAS400Row ....................................227 Scnarios associs ................................................229 tCreateTable .............................................................230 Proprits du tCreateTable ...................................230 Scnario : Crer une nouvelle table dans une base de donnes MySQL ........................................................233 tDB2BulkExec ..........................................................235 Proprits du tDB2BulkExec ..............................235 Scnario associ ...................................................237 tDB2Close .................................................................238 Proprits du tDB2Close ......................................238 Scnario associ ...................................................238 tDB2Commit ............................................................239 Proprits du tDB2Commit ..................................239 Scnario associ ...................................................239 tDB2Connection .......................................................240 Proprits du tDB2Connection ...........................240 Scnarios associs ...............................................241 tDB2Input .................................................................242 Proprits du tDB2Input ......................................242 Scnarios associs ................................................244 tDB2Output ..............................................................245 Proprits du tDB2Output ....................................245 Scnarios associs ................................................248 tDB2Rollback ...........................................................249 Proprits du tDB2Rollback ...............................249 Scnario associ ...................................................249 tDB2Row ...................................................................250 Proprits du tDB2Row .......................................250 Scnarios associs ................................................252 tDB2SCD ..................................................................253 tDB2SCDELT ..........................................................254 tDB2SP ......................................................................255 vii

Composants Talend Open Studio

Proprits du tDB2SP .......................................... 255 Scnario associ .................................................. 256 tDBInput ................................................................. 257 Proprits du tDBInput ........................................ 257 Scnario 1 : Afficher les donnes slectionnes partir dune table ....................................................... 258 Scnario 2 : Utiliser la variable StoreSQLQuery 260 tDBOutput ............................................................... 262 Proprits du tDBOutput ..................................... 262 Scnario : Afficher la base de donnes en sortie 264 tDBSQLRow ............................................................ 267 Proprits du tDBSQLRow ................................. 267 Scnario : Rinitialiser lauto-incrmentation dune base de donnes ......................................................... 269 tEXAInput ............................................................... 271 Proprits du tEXAInput ..................................... 271 Scnarios associs ............................................... 272 tEXAOutput ............................................................ 273 Proprits du tEXAOutput .................................. 273 Scnarios associs ............................................... 275 tEXARow ................................................................. 277 Proprits du tEXARow ...................................... 277 Scnarios associs ............................................... 278 tEXistConnection .................................................... 279 Proprits du tEXistConnection .......................... 279 Scnario associ ................................................. 279 tEXistDelete ............................................................. 280 Proprits du tEXistDelete .................................. 280 Scnario associ .................................................. 281 tEXistGet .................................................................. 282 tEXistGet properties ............................................ 282 Scnario associ .................................................. 283 tEXistList ................................................................. 284 Proprits du tEXistList ...................................... 284 Scnario associ ................................................. 285 tEXistPut .................................................................. 286 Proprits du tEXistPut ....................................... 286 Scnario associ .................................................. 287 tEXistXQuery .......................................................... 288 Proprits du tEXistXQuery ................................ 288 Scnario associ .................................................. 289 tEXistXUpdate ........................................................ 290 Proprits du tEXistXUpdate .............................. 290 Scnario associ .................................................. 291 tFirebirdClose .......................................................... 292 Proprits du tFirebirdClose ................................ 292 Scnario associ .................................................. 292 tFirebirdCommit ..................................................... 293 Proprits du tFirebirdCommit ............................ 293 Scnario associ .................................................. 293 tFirebirdConnection ............................................... 294 Proprits du tFirebirdConnection ..................... 294 Scnario associ ................................................. 295 viii

tFirebirdInput ..........................................................296 Proprits du tFirebirdInput .................................296 Scnarios associs ................................................297 tFirebirdOutput .......................................................298 Proprits du tFirebirdOutput ..............................298 Scnarios associs ................................................300 tFirebirdRollback ....................................................301 Proprits du tFirebirdRollback ..........................301 Scnario associ ...................................................301 tFirebirdRow ............................................................302 Proprits du tFirebirdRow ..................................302 Scnarios associs ................................................304 tGreenplumBulkExec ..............................................305 Proprits du tGreenplumBulkExec ....................305 Scnarios associs ................................................307 tGreenplumClose .....................................................308 Proprits du tGreenplumClose ...........................308 Scnario associ ...................................................308 tGreenplumCommit ................................................309 Proprits du tGreenplumCommit .......................309 Scnario associ ...................................................309 tGreenplumConnection ...........................................310 Proprits du tGreenplumConnection .................310 Scnarios associs ...............................................311 tGreenplumInput .....................................................312 Proprits du tGreenplumInput ............................312 Scnarios associs ................................................313 tGreenplumOutput ..................................................314 Proprits du tGreenplumOutput .........................314 Scnarios associs ................................................317 tGreenplumOutputBulk ..........................................318 Proprits du tGreenplumOutputBulk .................318 Scnarios associs ................................................319 tGreenplumOutputBulkExec .................................320 Proprits du tGreenplumOutputBulkExec .........320 Scnarios associs ................................................321 tGreenplumRollback ...............................................322 Proprits du tGreenplumRollback .....................322 Scnario associ ...................................................322 tGreenplumRow .......................................................323 Proprits du tGreenplumRow .............................323 Scnarios associs ................................................325 tGreenplumSCD ......................................................326 tHiveClose .................................................................327 Proprits du tHiveClose .....................................327 Scnario associ ...................................................327 tHiveConnection ......................................................328 Proprits du tHiveConnection ...........................328 Scnarios associs ...............................................329 tHiveRow ..................................................................330 Proprits du tHiveRow .......................................330 Scnarios associs ................................................332 tHSQLDbInput ........................................................333 Creative Commons License

Composants Talend Open Studio

Proprits du tHSQLDbInput .............................. 333 Scnarios associs ............................................... 334 tHSQLDbOutput ..................................................... 335 Proprits du tHSQLDbOutput ........................... 335 Scnarios associs ............................................... 338 tHSQLDbRow ......................................................... 339 Proprits du tHSQLDbRow ............................... 339 Scnarios associs ............................................... 341 tInformixBulkExec .................................................. 342 Proprits du tInformixBulkExec ....................... 342 Scnario associ .................................................. 344 tInformixClose ......................................................... 345 Proprits du tInformixClose .............................. 345 Scnario associ .................................................. 345 tInformixCommit .................................................... 346 Proprits du tInformixCommit .......................... 346 Scnario associ .................................................. 346 tInformixConnection .............................................. 347 Proprits du tInformixConnection .................... 347 Scnarios associs .............................................. 348 tInformixInput ........................................................ 349 Proprits du tInformixInput ............................... 349 Scnarios associs ............................................... 350 tInformixOutput ...................................................... 351 Proprits du tInformixOutput ............................ 351 Scnarios associs ............................................... 354 tInformixOutputBulk ............................................. 355 Proprits du tInformixOutputBulk ..................... 355 Scnarios associs ............................................... 356 tInformixOutputBulkExec ..................................... 357 Proprits du tInformixOutputBulkExec ............. 357 Scnarios associs ............................................... 359 tInformixRollback ................................................... 360 Proprits du tInformixRollback ........................ 360 Scnario associ .................................................. 360 tInformixRow .......................................................... 361 Proprits du tInformixRow ................................ 361 Scnarios associs ............................................... 363 tInformixSCD .......................................................... 364 tInformixSP ............................................................. 365 Proprits du tInformixSP ................................... 365 Scnarios associs ............................................... 367 tIngresClose ............................................................. 368 Proprits du tIngresClose ................................... 368 Scnario associ .................................................. 368 tIngresCommit ........................................................ 369 Proprits du tIngresCommit .............................. 369 Scnario associ ................................................. 369 tIngresConnection ................................................... 370 Proprits du tIngresConnection ........................ 370 Scnario associ ................................................. 370 tIngresInput ............................................................. 371 Proprits du tIngresInput ................................... 371 Creative Commons License

Scnarios associs ................................................372 tIngresOutput ...........................................................373 Proprits du tIngresOutput .................................373 Scnarios associs ................................................375 tIngresRollback ........................................................376 Proprits du tIngresRollback .............................376 Scnario associ ...................................................376 tIngresRow ...............................................................377 Proprits du tIngresRow .....................................377 Scnarios associs ................................................378 tIngresSCD ...............................................................379 tInterbaseClose ........................................................380 Proprits du tInterbaseClose ..............................380 Scnario associ ...................................................380 tInterbaseCommit ....................................................381 Proprits du tInterbaseCommit .........................381 Scnario associ ..................................................381 tInterbaseConnection ..............................................382 Proprits du tInterbaseConnection ....................382 Scnarios associs ...............................................383 tInterbaseInput ........................................................384 Proprits du tInterbaseInput ...............................384 Scnarios associs ................................................385 tInterbaseOutput .....................................................386 Proprits du tInterbaseOutput ............................386 Scnarios associs ................................................388 tInterbaseRollback ..................................................390 Proprits du tInterbaseRollback ........................390 Scnario associ ...................................................390 tInterbaseRow ..........................................................391 Proprits du tInterbaseRow ................................391 Scnarios associs ................................................393 tJavaDBInput ...........................................................394 Proprits du tJavaDBInput .................................394 Scnarios associs ................................................395 tJavaDBOutput ........................................................396 Proprits du tJavaDBOutput ..............................396 Scnarios asoocis ...............................................398 tJavaDBRow .............................................................399 Proprits du tJavaDBRow ..................................399 Scnarios associs ................................................400 tJDBCColumnList ...................................................402 Proprits du tJDBCColumnList .........................402 Scnario associ ...................................................402 tJDBCClose ..............................................................403 Proprits du tJDBCClose ...................................403 Scnario associ ...................................................403 tJDBCCommit .........................................................404 Proprits du tJDBCCommit ...............................404 Scnario associ ...................................................404 tJDBCConnection ....................................................405 Proprits du tJDBCConnection ..........................405 Scnario associ ...................................................406 ix

Composants Talend Open Studio

tJDBCInput ............................................................. 407 Proprits du tJDBCInput ................................... 407 Scnarios associs ............................................... 409 tJDBCOutput .......................................................... 410 Proprits du tJDBCOutput ................................. 410 Scnarios associs ............................................... 413 tJDBCRollback ........................................................ 414 Proprits du tJDBCRollback ............................. 414 Scnario associ .................................................. 414 tJDBCRow ............................................................... 415 Proprits du tJDBCRow .................................... 415 Scnarios associs ............................................... 417 tJDBCSP .................................................................. 418 Proprits du tJDBCSP ....................................... 418 Scnarios associs ............................................... 419 tJDBCTableList ...................................................... 420 Proprits du tJDBCTableList ............................. 420 Scnario associ .................................................. 420 tLDAPAttributesInput ........................................... 421 Proprits du tLDAPAttributesInput ................... 421 Scnario associ .................................................. 423 tLDAPInput ............................................................. 424 Proprits du tLDAPInput ................................... 424 Scnario : Afficher le contenu filtr dun annuaire LDAP ........................................................................ 426 tLDAPOutput .......................................................... 428 Proprits du tLDAPOutput ................................ 428 Scnario : Editer des donnes dans un annuaire LDAP 430 tLDAPRenameEntry .............................................. 433 Proprits du tLDAPRenameEntry ..................... 433 Scnarios associs .............................................. 434 tMaxDBInput .......................................................... 435 Proprits du tMaxDBInput ................................ 435 Scnarios associs ............................................... 436 tMaxDBOutput ........................................................ 437 Proprits du tMaxDBOutput .............................. 437 Scnarios associs ............................................... 439 tMaxDBRow ............................................................ 440 Proprits du tMaxDBRow ................................. 440 Scnarios associs ............................................... 441 tMSSqlBulkExec ..................................................... 442 Proprits du tMSSqlBulkExec ........................... 442 Scnarios associs ............................................... 444 tMSSqlClose ............................................................ 445 Proprits du tMSSqlClose ................................. 445 Scnario associ .................................................. 445 tMSSqlColumnList ................................................. 446 Proprits du tMSSqlColumnList ....................... 446 Scnario associ .................................................. 446 tMSSqlCommit ........................................................ 447 Proprits du tMSSqlCommit ............................. 447 Scnario associ .................................................. 447 x

tMSSqlConnection ...................................................448 Proprits du tMSSqlConnection .........................448 Scnario associ ...................................................449 tMSSqlInput .............................................................450 Proprits du tMSSqlInput ...................................450 Scnarios associs ................................................452 tMSSqlLastInsertId .................................................453 Proprits du tMSSqlLastInsertId ........................453 Scnario associ ...................................................453 tMSSqlOutput ..........................................................454 Proprits du tMSSqlOutput ................................454 Scnarios associs ................................................458 tMSSqlOutputBulk ..................................................459 Proprits du tMSSqlOutputBulk ........................459 Scnarios associs ................................................460 tMSSqlOutputBulkExec .........................................461 Proprits du tMSSqlOutputBulkExec ................461 Scnarios associs ................................................463 tMSSqlRollback .......................................................464 Proprits du tMSSqlRollback .............................464 Scnario associ ...................................................464 tMSSqlRow ...............................................................465 Proprits du tMSSqlRow ....................................465 Scnarios associs ................................................467 tMSSqlSCD ..............................................................468 tMSSqlSP ..................................................................469 Proprits du tMSSqlSP .......................................469 Scnarios associs ................................................471 tMSSqlTableList ......................................................472 Proprits du tMSSqlTableList ............................472 Scnario associ ..................................................472 tMysqlBulkExec .......................................................473 Proprits du tMysqlBulkExec ............................473 Scnarios associs ................................................475 tMysqlClose ..............................................................476 Proprits du tMysqlClose ...................................476 Scnario associ ...................................................476 tMysqlColumnList ...................................................477 Proprits du tMysqlColumnList .........................477 Scnario : Itrer une table de base de donnes et lister le nom des colonnes de la table .................................477 tMysqlCommit .........................................................481 Proprits du tMysqlCommit ...............................481 Scnario associ ...................................................481 tMysqlConnection ....................................................482 Proprits du tMysqlConnection ..........................482 Scnario : Insrer des donnes dans des tables mre/fille ....................................................................483 tMysqlInput ..............................................................487 Proprits du tMysqlInput ....................................487 Scnarios associs ................................................489 tMysqlLastInsertId ..................................................490 Proprits du tMysqlLastInsertId .........................490 Creative Commons License

Composants Talend Open Studio

Scnario : Rcuprer les ID des dernires entres ajoutes ...................................................................... 490 tMysqlOutput .......................................................... 495 Proprits du tMysqlOutput ................................ 495 Scnario 1 : Ajouter une colonne et modifier les donnes ............................................................................ 499 Scnario 2 : Effectuer des mises jour dans une base de donnes ................................................................. 504 Scnario 3 : Rcuprer les donnes errones laide dun lien Reject ......................................................... 507 tMysqlOutputBulk ................................................. 514 Proprits du tMysqlOutputBulk ......................... 514 Scnario : Insrer des donnes transformes dans une base MySQL ............................................................. 515 tMysqlOutputBulkExec .......................................... 520 Proprits du tMysqlOutputBulkExec ................. 520 Scnario : Insrer des donnes dans une base MySQL 521 tMysqlRollback ....................................................... 524 Proprits du tMysqlRollback ............................. 524 Scnario : Annuler linsertion de donnes dans des tables mre/fille ............................................................ 524 tMysqlRow ............................................................... 526 Proprits du tMysqlRow .................................... 526 Scnario 1 : Supprimer et re-gnrer un index de table MySQL ...................................................................... 528 Scnario 2 : Utiliser linstance PreparedStatement pour faire une requte sur des donnes ..................... 530 tMysqlSCD ............................................................... 536 tMysqlSCDELT ....................................................... 537 tMysqlSP .................................................................. 538 Proprits du tMysqlSP ....................................... 538 Scnario : Trouver le libell State laide dune procdure stocke ...................................................... 539 tMysqlTableList ...................................................... 543 Proprits du tMysqlTableList ............................ 543 Scnario : Effectuer une opration ditration sur des tables et en effacer le contenu grce un modle SQL dfini par lutilisateur (SQL Template) ................... 543 Scnario associ .................................................. 547 tNetezzaBulkExec .................................................... 548 Proprits du tNetezzaBulkExec ........................ 548 Scnarios associs .............................................. 550 tNetezzaClose ........................................................... 551 Proprits du tNetezzaClose ................................ 551 Scnario associ .................................................. 551 tNetezzaCommit ...................................................... 552 Proprits du tNetezzaCommit ........................... 552 Scnario associ ................................................. 552 tNetezzaConnection ................................................ 553 Proprits du tNetezzaConnection ..................... 553 Scnario associ ................................................. 554 tNetezzaInput .......................................................... 555 Creative Commons License

Proprits du tNetezzaInput .................................555 Scnarios associs ................................................557 tNetezzaOutput ........................................................558 Proprits du tNetezzaOutput ..............................558 Scnarios associs ................................................561 tNetezzaRollback .....................................................562 Proprits du tNetezzaRollback ..........................562 Scnario associ ..................................................562 tNetezzaRow .............................................................563 Proprits du tNetezzaRow .................................563 Scnario associ ..................................................565 tOracleBulkExec ......................................................566 Proprits du tOracleBulkExec ............................566 Scnario : Supprimer et insrer des donnes dans une base Oracle ................................................................569 tOracleClose .............................................................573 Proprits du tOracleClose ..................................573 Scnario associ ...................................................573 tOracleCommit ........................................................574 Proprits du tOracleCommit ..............................574 Scnario associ ...................................................574 tOracleConnection ...................................................575 Proprits du tOracleConnection .........................575 Scnario associ ...................................................576 tOracleInput .............................................................577 Proprits du tOracleInput ...................................577 Scnarios associs ................................................579 tOracleOutput ..........................................................580 Proprits du tOracleOutput ................................580 Scnarios associs ................................................584 tOracleOutputBulk ..................................................585 Proprits du tOracleOutputBulk .........................585 Scnarios associs ................................................586 tOracleOutputBulkExec .........................................587 Proprits du tOracleOutputBulkExec .................587 Scnarios associs ................................................590 tOracleRollback .......................................................591 Proprits du tOracleRollback .............................591 Scnario associ ...................................................591 tOracleRow ...............................................................592 Proprits du tOracleRow ....................................592 Scnario associ ...................................................594 tOracleSCD ..............................................................595 tOracleSCDELT ......................................................596 tOracleSP ..................................................................597 Proprits du tOracleSP .......................................597 Scnario : Vrifier le format de numros laide dune procdure stocke ............................................599 tOracleTableList ......................................................604 Proprits du tOracleTableList ............................604 Scnario associ ...................................................604 tParAccelBulkExec ..................................................605 Proprits du tParAccelBulkExec ........................605 xi

Composants Talend Open Studio

Scnarios associs ............................................... 607 tParAccelClose ........................................................ 608 Proprits du tParAccelClose .............................. 608 Scnario associ .................................................. 608 tParAccelCommit .................................................... 609 Proprits du tParAccelCommit .......................... 609 Scnario associ .................................................. 609 tParAccelConnection .............................................. 610 Proprits du tParAccelConnection ..................... 610 Scnario associ .................................................. 611 tParAccelInput ........................................................ 612 Proprits du tParAccelInput ............................... 612 Scnarios associs ............................................... 614 tParAccelOutput ..................................................... 615 Proprits du tParAccelOutput ............................ 615 Scnarios associs ............................................... 618 tParAccelOutputBulk ............................................. 619 Proprits du tParAccelOutputBulk .................... 619 Scnarios associs ............................................... 620 tParAccelOutputBulkExec ..................................... 621 Proprits du tParAccelOutputBulkExec ............ 621 Scnarios associs ............................................... 622 tParAccelRollback .................................................. 624 Proprits du tParAccelRollback ........................ 624 Scnario associ ................................................. 624 tParAccelRow .......................................................... 625 Proprits du tParAccelRow ............................... 625 Scnarios associs ............................................... 627 tParAccelSCD .......................................................... 628 tParseRecordSet ...................................................... 629 Proprits du tParseRecordSet ............................ 629 Scnario associ .................................................. 629 tPostgresPlusBulkExec ........................................... 630 Proprits du tPostgresPlusBulkExec ................ 630 Scnario associ .................................................. 631 tPostgresPlusClose .................................................. 633 Proprits du tPostgresPlusClose ........................ 633 Scnario associ .................................................. 633 tPostgresPlusCommit .............................................. 634 Proprits du tPostgresPlusCommit .................... 634 Scnario associ .................................................. 634 tPostgresPlusConnection ........................................ 635 Proprits du tPostgresPlusConnection ............... 635 Scnario associ .................................................. 636 tPostgresPlusInput .................................................. 637 Proprits du tPostgresPlusInput ......................... 637 Scnarios associs ............................................... 639 tPostgresPlusOutput ............................................... 640 Proprits du tPostgresPlusOutput ...................... 640 Scnarios associs ............................................... 643 tPostgresPlusOutputBulk ....................................... 644 Proprits du tPostgresPlusOutputBulk .............. 644 Scnarios associs ............................................... 645 xii

tPostgresPlusOutputBulkExec ...............................646 Proprits du tPostgresplusOutputBulkExec .......646 Scnarios associs ................................................647 tPostgresPlusRollback .............................................648 Proprits du tPostgresPlusRollback ..................648 Scnario associ ..................................................648 tPostgresPlusRow ....................................................649 Proprits du tPostgresPlusRow ..........................649 Scnarios associs ................................................651 tPostgresPlusSCD ....................................................652 tPostgresPlusSCDELT ............................................653 tPostgresqlBulkExec ................................................654 Proprits du tPostgresqlBulkExec ......................654 Scnarios associs ................................................656 tPostgresqlClose .......................................................657 Proprits du tPostgresqlClose ............................657 Scnario associ ...................................................657 tPostgresqlCommit ..................................................658 Proprits du tPostgresqlCommit ........................658 Scnario associ ...................................................658 tPostgresqlConnection .............................................659 Proprits du tPostgresqlConnection ...................659 Scnario associ ...................................................660 tPostgresqlInput .......................................................661 Proprits du tPostgresqlInput .............................661 Scnarios associs ................................................663 tPostgresqlOutput ....................................................664 Proprits du tPostgresqlOutput ..........................664 Scnarios associs ................................................667 tPostgresqlOutputBulk ..........................................668 Proprits du tPostgresqlOutputBulk ...................668 Scnarios associs ................................................669 tPostgresqlOutputBulkExec ...................................670 Proprits du tPostgresqlOutputBulkExec ...........670 Scnarios associs ................................................671 tPostgresqlRow ........................................................673 Proprits du tPostgresqlRow ..............................673 Scnarios associs ................................................675 tPostgresqlRollback .................................................676 Proprits du tPostgresqlRollback .......................676 Scnario associ ...................................................676 tPostgresqlSCD ........................................................677 tPostgresqlSCDELT ................................................678 tSASInput .................................................................679 Proprits du tSASInput ......................................679 Scnarios associs ................................................680 tSASOutput ..............................................................681 Proprits du tSASOutput ....................................681 Scnarios associs ................................................683 tSQLiteClose ............................................................685 Proprits du tSQLiteClose ..................................685 Scnario associ ...................................................685 tSQLiteCommit ........................................................686 Creative Commons License

Composants Talend Open Studio

Proprits du tSQLiteCommit ............................. 686 Scnario associ .................................................. 686 tSQLiteConnection .................................................. 687 Proprits du tSQLiteConnection ........................ 687 Scnarios associs .............................................. 688 tSQLiteInput ............................................................ 689 Proprits du tSQLiteInput .................................. 689 Scnario : Filtrer des donnes SQlite .................. 691 tSQLiteOutput ......................................................... 693 Proprits du tSQLiteOutput ............................... 693 Scnario associ .................................................. 696 tSQLiteRollback ...................................................... 697 Proprits du tSQLiteRollback ........................... 697 Scnario associ .................................................. 697 tSQLiteRow ............................................................. 698 Proprits du tSQLiteRow ................................... 698 Scnario : Mettre jour des lignes SQLite .......... 700 tSybaseBulkExec ..................................................... 702 Proprits du tSybaseBulkExec ........................... 702 Scnarios associs ............................................... 704 tSybaseClose ............................................................ 705 Proprits du tSybaseClose ................................. 705 Scnario associ .................................................. 705 tSybaseCommit ........................................................ 706 Proprits du tSybaseCommit ............................ 706 Scnario associ ................................................. 706 tSybaseConnection .................................................. 707 Proprits du tSybaseConnection ....................... 707 Scnarios associs .............................................. 708 tSybaseInput ............................................................ 709 Proprits du tSybaseInput .................................. 709 Scnario associ .................................................. 711 tSybaseIQBulkExec ................................................ 712 Proprits du tSybaseIQBulkExec ..................... 712 Scnario associ .................................................. 714 tSybaseIQOutputBulkExec .................................... 715 Proprits du tSybaseIQOutputBulkExec .......... 715 Scnarios associs .............................................. 717 tSybaseOutput ......................................................... 718 tSybaseOutput Properties .................................... 718 Scnario associ .................................................. 721 tSybaseOutputBulk ................................................. 722 Proprits du tSybaseOutputBulk ....................... 722 Scnario associ .................................................. 723 tSybaseOutputBulkExec ......................................... 724 Proprits du tSybaseOutputBulkExec ............... 724 Scnarios associs ............................................... 726 tSybaseRollback ...................................................... 727 Proprits du tSybaseRollback ........................... 727 Scnario associ ................................................. 727 tSybaseRow .............................................................. 728 Proprits du tSybaseRow ................................... 728 Scnario associ .................................................. 730 Creative Commons License

tSybaseSCD ..............................................................731 tSybaseSCDELT ......................................................732 tSybaseSP .................................................................733 Proprits du tSybaseSP ......................................733 Scnario associ ...................................................735 tTeradataClose .........................................................736 Proprits du tTeradataClose ...............................736 Scnario associ ...................................................736 tTeradataCommit ....................................................737 Proprits du tTeradataCommit ...........................737 Scnario associ ...................................................737 tTeradataConnection ...............................................738 Proprits du tTeradataConnection ......................738 Scnario associ ...................................................739 tTeradataFastExport ...............................................740 Proprits du tTeradataFastExport .......................740 Scnario associ ...................................................741 tTeradataFastLoad ..................................................742 Proprits du tTeradataFastLoad .........................742 Scnario associ ...................................................743 tTeradataFastLoadUtility .......................................744 Proprits du tTeradataFastLoadUtility ...............744 Scnario associ ...................................................745 tTeradataInput .........................................................746 Proprits du tTeradataInput ................................746 Scnario associ ...................................................748 tTeradataMultiLoad ................................................749 Proprits du tTeradataMultiLoad .......................749 Scnario associ ...................................................750 tTeradataOutput ......................................................751 Proprits du tTeradataOutput .............................751 Scnario associ ...................................................755 tTeradataRollback ...................................................756 Proprits du tTeradataRollback .........................756 Scnario associ ..................................................756 tTeradataRow ..........................................................757 Proprits du tTeradataRow .................................757 Scnario associ ...................................................759 tTeradataTPump .....................................................760 Proprits du tTeradataTPump ............................760 Scnario associ ...................................................761 tVerticaBulkExec .....................................................762 Proprits du tVerticaBulkExec ...........................762 Scnarios associs ...............................................764 tVerticaClose ............................................................765 Proprits du tVerticaClose .................................765 Scnario associ ...................................................765 tVerticaCommit .......................................................766 Proprits du tVerticaCommit .............................766 Scnario associ ...................................................766 tVerticaConnection ..................................................767 Proprits du tVerticaConnection ........................767 Scnario associ ...................................................768 xiii

Composants Talend Open Studio

tVerticaInput ........................................................... 769 Proprits du tVerticaInput ................................. 769 Scnarios associs .............................................. 771 tVerticaOutput ........................................................ 772 Proprits du tVerticaOutput ............................... 772 Scnarios associs .............................................. 775 tVerticaOutputBulk ................................................ 776 Proprits du tVerticaOutputBulk ....................... 776 Scnarios associs ............................................... 777 tVerticaOutputBulkExec ........................................ 778 Proprits du tVerticaOutputBulkExec ............... 778 Scnarios associs .............................................. 779 tVerticaRollback ..................................................... 780 Proprits du tVerticaRollback .......................... 780 Scnario associ ................................................. 780 tVerticaRow ............................................................. 781 Proprits du tVerticaRow .................................. 781 Scnario associ .................................................. 783

Composants ELT .................................... 785


tELTAggregate ........................................................ 786 Proprits du tELTAggregate .............................. 786 Scnario : Filtrer et agrger les colonnes dune table directement dans le SGBD ........................................ 788 tELTCommit ........................................................... 793 Proprits du tELTCommit ................................. 793 Scnario associ .................................................. 794 tELTFilterColumns ................................................ 795 Proprits du tELTFilterColumns ....................... 795 Scnario associ .................................................. 796 tELTFilterRows ...................................................... 797 Proprits du tELTFilterRows ............................. 797 Scnario associ .................................................. 798 tELTJDBCInput ..................................................... 799 Proprits de tELTJDBCInput ............................ 799 Scnarios associs ............................................... 799 tELTJDBCMap ....................................................... 801 Proprits de tELTJDBCMap ............................. 801 Scnarios associs ............................................... 802 tELTJDBCOutput .................................................. 803 Proprits de tELTJDBCOutput .......................... 803 Scnarios associs ............................................... 804 tELTMSSqlInput .................................................... 805 Proprits de tELTMSSqlInput ........................... 805 Scnarios associs ............................................... 805 tELTMSSqlMap ...................................................... 807 Proprits de tELTMSSqlMap ............................ 807 Scnarios associs ............................................... 808 tELTMSSqlOutput ................................................. 809 Proprits de tELTMSSqlOutput ........................ 809 Scnarios associs ............................................... 810 tELTMysqlInput ..................................................... 811 xiv

Proprits de tELTMysqlInput ............................811 Scnarios associs ................................................811 tELTMysqlMap .......................................................812 Proprits de tELTMysqlMap ..............................812 Connecter les composants ELT ........................813 Tables de jointure et de correspondance ..........813 Ajouter des clauses Where ...............................813 Gnrer la requte SQL ....................................814 Scnario 1 : Agrger les colonnes dune table et appliquer un filtre ..........................................................814 Scnario 2 : ELT utilisant une table Alias ...........817 tELTMysqlOutput ...................................................821 Proprits de tELTMysqlOutput ..........................821 Scnarios associs ................................................822 tELTOracleInput .....................................................823 Proprits de tELTOracleInput ............................823 Scnario associ ...................................................823 tELTOracleMap ......................................................824 Proprits de tELTOracleMap .............................824 Connecter les composants ELT ........................826 Tables de jointure et de correspondance ..........826 Ajouter des clauses Where ...............................826 Gnrer la requte SQL ....................................826 Scnario : Mettre jour les lignes dune base Oracle 826 tELTOracleOutput ..................................................829 Proprits de tELTOracleOutput .........................829 Scnario : Utiliser la fonction MERGE dOracle pour mettre jour et insrer simultanment des donnes ..830 tELTPostgresqlInput ...............................................837 Proprits de tELTPostgresqlInput ......................837 Scnarios associs ................................................837 tELTPostgresqlMap ................................................839 Proprits de tELTPostgresqlMap .......................839 Scnarios associs ................................................840 tELTPostgresqlOutput ............................................841 Proprits de tELTPostgresqlOutput ...................841 Scnarios associs ................................................842 tELTRollback ...........................................................843 Proprits du tELTRollback ...............................843 Scnario associ ...................................................844 tELTSybaseInput .....................................................845 Proprits de tELTSybaseInput ...........................845 Scnarios associs ................................................845 tELTSybaseMap ......................................................847 Proprits de tELTSybaseMap ............................847 Scnarios associs ................................................848 tELTSybaseOutput ..................................................849 Proprits de tELTSybaseOutput .........................849 Scnarios associs ................................................850 tELTTeradataInput .................................................851 Proprits de tELTTeradataInput .........................851 Scnarios associs ................................................851 Creative Commons License

Composants Talend Open Studio

tELTTeradataMap .................................................. 852 Proprits de tELTTeradataMap ......................... 852 Connecter les composants ELT ........................ 853 Tables de jointure et de correspondance .......... 853 Ajouter des clauses Where ............................... 853 Gnrer la requte SQL .................................... 853 Scnarios associs ............................................... 853 tELTTeradataOutput ............................................. 854 Proprits de tELTTeradataOutput ..................... 854 Scnarios associs ............................................... 855

Composants File ...................................... 857


tAdvancedFileOutputXML .................................... 858 tApacheLogInput .................................................... 859 Proprits du tApacheLogInput ........................... 859 Scnario : Lire un fichier de log daccs Apache ..... 860 tCreateTemporaryFile ........................................... 862 Proprits du tCreateTempraryFile ..................... 862 Scnario : Crer un fichier temporaire et y crire des donnes ...................................................................... 862 tFileArchive ............................................................. 867 Proprits du tFileArchive ................................... 867 Scnario : Zipper des fichiers laide dun tFileArchive .............................................................................. 868 tFileCompare ........................................................... 870 Proprits du tFileCompare ................................. 870 Scnario : Comparer des fichiers dzipps .......... 870 tFileCopy .................................................................. 873 Proprits du tFileCopy ....................................... 873 Scnario : Rcuprer un fichier de la corbeille ... 873 tFileDelete ................................................................ 875 Proprits du tFileDelete ..................................... 875 Scnario : Supprimer des fichiers ........................ 875 tFileExist .................................................................. 877 Proprits du tFileExist ....................................... 877 Scnario : Vrifier lexistence dun fichier et le crer sil nexiste pas .......................................................... 877 tFileInputARFF ....................................................... 882 Proprits du tFileInputARFF ............................. 882 Scnario : Afficher le contenu dun fichier ARFF .... 883 tFileInputDelimited ................................................. 886 Proprits du tFileInputDelimited ....................... 886 Scnario 1 : Afficher le contenu dun fichier dlimit 888 Scnario 2 : Lire les donnes dun fichier distant en mode stream .............................................................. 889 tFileInputMSDelimited .......................................... 893 Proprits du tFileInputMSDelimited ................. 893 Lditeur de schmas Multi Schema Editor ..... 893 Scnario : Lecture dun fichier dlimit Creative Commons License

multi structure ............................................................895 tFileInputEBCDIC ..................................................900 Proprits du tFileInputEBCDIC .........................900 Scnario : Extraire les donnes dun fichier EBCDIC et alimenter une base de donnes ..............................900 tFileInputExcel ........................................................906 Proprits du tFileInputExcel .............................906 Scnario associ ...................................................908 tFileInputFullRow ..................................................909 Proprits du tFileInputFullRow ..........................909 Scnario : Lire des lignes compltes dans un fichier dlimit ......................................................................909 tFileInputJSON .......................................................912 Proprits du tFileInputJSON .............................912 Scnario : Extraire les donnes des champs dun fichier au format JSON ...................................................913 tFileInputLDIF .......................................................915 Proprits du tFileInputLDIF ...............................915 Scnario associ ...................................................916 tFileInputMail ..........................................................917 Proprits du tFileInputMail ................................917 Scnario : Extraire des champs cls dun email ...918 tFileInputPositional .................................................920 Proprits du tFileInputPositional ........................920 Scnario : Transformer un fichier positionnel en XML ..........................................................................922 tFileInputMSPositional ..........................................925 Proprits du tFileInputMSPositional ..................925 Scnario associ ...................................................926 tFileInputProperties ................................................927 Proprits du tFileInputProperties .......................927 Scnario : Lire et mapper la cl et les valeurs de fichiers properties et alimenter un glossaire ....................927 tFileInputRegex .......................................................931 Proprits du tFileInputRegex .............................931 Scnario : Transformer en fichier Regex en Positional 932 tFileInputXML .........................................................935 tFileInputMSXML ...................................................936 Proprits du tFileInputMSXML .........................936 Scnario : Lecture dun fichier XML multi structur 937 tFileList ....................................................................940 Proprits du tFileList ..........................................940 Scnario : Itration sur un rpertoire ...................940 tFileOutputARFF ....................................................944 Proprits du tFileOutputARFF ...........................944 Scnario associ ...................................................945 tFileOutputDelimited ..............................................946 Proprits du tFileOutputDelimited .....................946 Scnario : Ecrire des donnes dans un fichier dlimit 947 tFileOutputMSDelimited .......................................952 xv

Composants Talend Open Studio

Proprits du tFileOutputMSDelimited .............. 952 Scnario associ .................................................. 953 tFileOutputEBCDIC ............................................... 954 Proprits du tFileOutputEBCDIC ...................... 954 Scnario : Crer un fichier EBCDIC partir de deux fichiers dlimits ....................................................... 954 tFileOutputExcel ..................................................... 957 Proprits du tFileOutputExcel ........................... 957 Scnario associ .................................................. 958 tFileOutputLDIF ..................................................... 959 Proprits du tFileOutputLDIF ........................... 959 Scnario : Ecrire des donnes dans un fichier LDIF . 960 tFileOutputPositional .............................................. 963 Proprits du tFileOutputPositional .................... 963 Scnario associ : ............................................... 964 tFileOutputMSPositional ....................................... 965 Proprits du tFileOutputMSPositional ............... 965 Scnario associ .................................................. 965 tFileOutputProperties ............................................. 966 Proprits du tFileOutputProperties .................... 966 Scnario associ .................................................. 966 tFileOutputXML ..................................................... 967 tFileOutputMSXML ............................................... 968 Proprits du tFileOutputMSXML ...................... 968 Dfinir un arbre XML Multischma ................ 968 Mapping de donnes XML partir de sources multischma .................................................................... 971 Dfinir le statut du noeud ................................. 972 Scnario associ .................................................. 973 tFileProperties ......................................................... 974 Proprits du tFileProperties ............................... 974 Scnario : Afficher les proprits dun fichier trait . 974 tFileRowCount ........................................................ 976 Proprits du tFileRowCount .............................. 976 Scnario associ : ................................................ 976 tFileTouch ................................................................ 977 Proprits du tFileTouch ..................................... 977 Scnario associ : ............................................... 977 tFileUnarchive ......................................................... 978 Proprits du tFileUnarchive ............................... 978 Scnario associ .................................................. 978 tPivotToColumnsDelimited .................................... 979 Proprits du tPivotToColumnsDelimited .......... 979 Scnario : Utiliser une colonne pivot pour agrger des donnes ...................................................................... 979

Composants Internet ............................... 983


tFileFetch ................................................................. 984 Proprits du tFileFetch ....................................... 984 Scnario 1 : Rcuprer des donnes partir dun proxvi

tocole HTTP ..............................................................985 Scnario 2 : Lire les donnes dun fichier distant en mode stream ...............................................................986 tFileInputJSON ........................................................987 tFTPConnection .......................................................988 Proprits du tFTPConnection .............................988 Scnarios associs ................................................989 tFTPDelete ................................................................990 Proprits du tFTPDelete .....................................990 Scnarios associs ................................................991 tFTPFileExist ...........................................................992 Proprits du tFTPFileExist .................................992 Scnarios associs ................................................993 tFTPFileList ............................................................994 Proprits du tFTPFileList ..................................994 Scnario : Itration sur un rpertoire distant .......995 tFTPFileProperties ..................................................999 Proprits du tFTPFileProperties .........................999 Scnario associ .................................................1000 tFTPGet ..................................................................1001 Proprits du tFTPGet ........................................1001 Scnario associ .................................................1002 tFTPPut ..................................................................1003 Proprits du tFTPPut ........................................1003 Scnario : Copier des fichiers sur un serveur FTP distant ...........................................................................1004 tFTPRename ..........................................................1007 Proprits du tFTPRename ................................1007 Scnario associ .................................................1008 tFTPTruncate .........................................................1009 Proprits du tFTPTruncate ...............................1009 Scnario associ .................................................1010 tJMSInput ..............................................................1011 Proprits du tJMSInput ....................................1011 Scnario associ : ..............................................1012 tJMSOutput ...........................................................1013 Proprits du tJMSOutput ..................................1013 Scnario associ : ..............................................1013 tMomInput .............................................................1014 Proprits du tMomInput ...................................1014 Scnario : Communication asynchrone via un serveur MOM .......................................................................1015 tMomMessageIdList ..............................................1018 Proprits du tMomMessageIdList ...................1018 Scnario associ ................................................1018 tMomOutput ..........................................................1019 Proprits du tMomOutput ................................1019 Scnario associ .................................................1019 tPOP ........................................................................1020 Proprits du tPOP .............................................1020 Scnario : Rcuprer une slection de-mails partir dun compte de messagerie .....................................1021 tRSSInput ...............................................................1024 Creative Commons License

Composants Talend Open Studio

Proprits du tRSSInput ................................... 1024 Scnario : Rcuprer les billets frquemment mis jour sur un blog ....................................................... 1024 tRSSOutput ............................................................ 1027 Proprits du tRSSOutput ................................ 1027 Scnario 1 : Crer un flux RSS et stocker les fichiers sur un serveur FTP ................................................ 1028 Scnario 2 : Crer un flux RSS contenant des mtadonnes .................................................................. 1031 tSCPConnection .................................................... 1035 Proprits du tSCPConnection .......................... 1035 Scnarios associs ............................................. 1035 tSCPDelete ............................................................. 1036 Proprits du tSCPDelete .................................. 1036 Scnario associ ................................................ 1036 tSCPFileExists ....................................................... 1037 Proprits du tSCPFileExists ............................. 1037 Scnario associ ................................................ 1037 tSCPFileList ........................................................... 1038 Proprits du tSCPFileList ................................ 1038 Scnario associ ................................................ 1038 tSCPGet .................................................................. 1039 Proprits du tSCPGet ....................................... 1039 Scnario : Rcuprer des fichiers dun serveur SCP distant ...................................................................... 1039 tSCPPut .................................................................. 1041 Proprits du tSCPPut ....................................... 1041 Scnario associ ................................................ 1041 tSCPRename .......................................................... 1042 Proprits du tSCPRename ............................... 1042 Scnario associ ................................................ 1042 tSCPTruncate ........................................................ 1043 Proprits du tSCPRename ............................... 1043 Scnario associ ................................................ 1043 tSendMail ............................................................... 1044 Proprits du tSendMail .................................... 1044 Scnario : Envoyer un e-mail lors dune erreur 1045 tSocketInput .......................................................... 1049 Proprits du tSocketInput ................................ 1049 Scnario : Transfrer des donnes vers un port dcoute (Java) ........................................................ 1051 tSocketOutput ........................................................ 1054 Proprits du tSocketOutput .............................. 1054 Scnario associ ................................................ 1055 tWebServiceInput ................................................. 1056 Proprits du tWebServiceInput ........................ 1056 Scnario 1 : Extraire des images laide dun Webservice ..................................................................... 1058 Scnario 2 : Lire des donnes publies dans un service Web, en utilisant les fonctions avances du tWebServiceInput (Java) ................................................. 1059 tXMLRPCInput .................................................... 1065 Proprits du tXMLRPCInput ........................... 1065 Creative Commons License

Scnario : Chercher le nom dun Etat via une mthode XMLRPC .................................................................1065

Composants Logs & Errors ...................1069


tAssert .....................................................................1070 Proprits du tAssert ..........................................1070 1070 Scnario : Paramtrer une condition assertive pour lexcution dun Job ................................................1070 tAssertCatcher .......................................................1076 Proprits du tAssertCatcher ..............................1076 Scnario associ .................................................1077 tChronometerStart ................................................1078 Proprits du tChronometerStart ........................1078 Scnario associ .................................................1078 tChronometerStop .................................................1079 Proprits du tChronometerStop ........................1079 Scnario : Mesurer la dure de traitement dun sous-Job ou dune partie dun sous-Job ...................1079 tDie ..........................................................................1084 Proprits du tDie ..............................................1084 Scnarios associs ..............................................1084 tFlowMeter .............................................................1085 Proprits du tFlowMeter ..................................1085 Scnario associ .................................................1085 tFlowMeterCatcher ...............................................1086 Proprits du tFlowMeterCatcher ......................1086 Scnario : Mesurer le flux dun Job ...................1087 tLogCatcher ...........................................................1091 Proprits du tLogCatcher ................................1091 Scnario 1 : Avertissement & log lors de la cration dentres ...................................................................1091 Scnario 2 : Monitorer & arrter un Job ............1093 tLogRow ................................................................1095 Proprits du tLogRow ......................................1095 Scnarios associs ..............................................1095 tStatCatcher ...........................................................1096 Proprits du tStatCatcher ..................................1096 Scnario : Afficher les statistiques du Job .........1096 tWarn ......................................................................1099 Proprits du tWarn ...........................................1099 Scnarios associs ..............................................1099

Composants Misc ....................................1101


tAddLocationFromIP ...........................................1102 Proprits du tAddLocationFromIP ...................1102 Scnario : Identifier la localisation gographique dune adresse IP .......................................................1103 tBufferInput ...........................................................1106 Proprits du tBufferInput .................................1106 Scnario : Rcuprer les donnes mises en tampon xvii

Composants Talend Open Studio

(Java) ....................................................................... 1106 tBufferOutput ........................................................ 1109 Proprits du tBufferOutput .............................. 1109 Scnario 1 : Mettre des donnes en tampon (Java) ... 1109 Scnario 2 : Mettre les donnes de sortie en mmoire tampon du serveur dapplication Web .................... 1112 Scnario 3 : Appeler un Job contenant des variables de contexte partir de votre navigateur Web ......... 1116 Scnario 4 : Appeler un Job export en tant que service Web dans un autre Job ..................................... 1117 tContextDump ....................................................... 1120 Proprits du tContextDump ............................. 1120 Scnario associ ............................................... 1120 tContextLoad ......................................................... 1121 Proprits du tContextLoad ............................... 1121 Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL ................ 1122 tFixedFlowInput .................................................... 1125 Proprits du tFixedFlowInput .......................... 1125 Scnarios associs ............................................. 1125 tMsgBox ................................................................ 1127 Proprits du tMsgBox ...................................... 1127 Scnario : Test de type Hello world! .............. 1127 tRowGenerator ..................................................... 1129 Proprits du tRowGenerator ............................ 1129 Dfinition du schma ..................................... 1129 Dfinition dune fonction ............................... 1130 Scnario : Gnration alatoire de fichiers de test .... 1131

Proprits du tPrejob ..........................................1147 Scnario associ .................................................1147 tReplicate ................................................................1148 Proprits du tReplicate .....................................1148 Scnario associ .................................................1148 tRunJob ..................................................................1149 tSleep .......................................................................1150 Proprits du tSleep ...........................................1150 Scnario associ .................................................1150 tUnite .......................................................................1151 Proprits du tUnite ...........................................1151 Scnario : Itration sur des fichiers et fusion de contenu ..........................................................................1151 tWaitForFile ...........................................................1155 Proprits du tWaitForFile .................................1155 Scnario : Attendre la suppression dun fichier 1156 tWaitForSocket ......................................................1159 Proprits du tWaitForSocket ............................1159 Scnario associ ................................................1159 tWaitForSqlData ...................................................1160 Proprit du tWaitForSqlData ............................1160 Scnario : Attendre lajout de lignes dans une table . 1161

Composants Processing .........................1165


tAggregateRow .......................................................1166 Proprits du tAggregateRow ............................1166 Scnario : Agrger des valeurs et trier des donnes .. 1168 tAggregateSortedRow ...........................................1172 Proprits du tAggregateSortedRow ..................1172 Scnario associ .................................................1173 tConvertType .........................................................1174 Proprits du tConvertType ...............................1174 Scnario : Convertir des types de donnes Java 1174 tDenormalize ..........................................................1179 Proprits du tDenormalize ................................1179 Scnario 1 : Dnormaliser une colonne .............1180 Scnario 2 : Dnormaliser plusieurs colonnes ...1181 tDenormalizeSortedRow .......................................1184 Proprits du tDenormalizeSortedRow ..............1184 Scnario : Regrouper des lignes tries ...............1184 tEmptyToNull ........................................................1188 Proprits du tEmptyToNull .............................1188 Scnario : Remplacer des champs vides par des champs non-dfinis (NULL) ..................................1188 tExternalSortRow ..................................................1192 Proprits du tExternalSortRow ........................1192 Scnario associ .................................................1193 tExtractDelimitedFields ........................................1194 Proprits du tExtractDelimitedFields ...............1194 Scnario : Extraire des champs partir dun fichier Creative Commons License

Composants Orchestration ................... 1133


tFileList ................................................................. 1134 tFlowToIterate ....................................................... 1135 Proprits du tFlowToIterate ............................. 1135 Scnario : Transformer un flux de donnes en liste .. 1135 tInfiniteLoop .......................................................... 1139 Proprits du tInfiniteLoop ............................... 1139 Scnario associ ................................................ 1139 tIterateToFlow ....................................................... 1140 Proprits du tIterateToFlow ............................. 1140 Scnario : Transformer une liste de fichiers en flux de donnes .................................................................... 1140 tLoop ...................................................................... 1143 Proprits du tLoop ........................................... 1143 Scnario : Excuter un Job partir dune boucle ...... 1143 tPostjob .................................................................. 1146 Proprits du tPostjob ........................................ 1146 Scnario associ ................................................ 1146 tPrejob .................................................................... 1147 xviii

Composants Talend Open Studio

dlimit par des virgules ......................................... 1195 tExtractPositionalFields ....................................... 1199 Proprits du tExtractPositionalFields .............. 1199 Scnario associ ................................................ 1200 tExtractRegexFields .............................................. 1201 Proprits du tExtractRegexFields .................... 1201 Scnario : Extraire des noms, des domaines et domaines de premier niveau partir dadresses e-mail ...... 1202 tExtractXMLField ................................................ 1205 tFilterColumns ...................................................... 1206 Proprits du tFilterColumns ............................. 1206 Scnario associ ................................................ 1206 tFilterRow .............................................................. 1207 Proprits du tFilterRow ................................... 1207 Scnario : Filtrer une liste de noms et faire une recherche dans la liste ....................................................... 1208 tMap ....................................................................... 1211 Proprits du tMap ............................................ 1211 Scnario 1 : Mapping simple avec filtre et jointure explicite ...................................................................... 1211 Scnario 2 : Mapping avec rejet Inner join ....... 1216 Scnario 3 : Mapping de jointure en cascade .... 1220 Scnario 4 : Mapping avanc avec filtres, jointures explicites et rejet Inner join ..................................... 1221 Scnario 5 : Mapping avanc avec filtres et vrification des lignes .......................................................... 1226 Scnario 6 : Mapping avanc avec rechargement de la base de rfrence chaque ligne ............................. 1229 1235 Scnario 7 : Mapping avec des tables de sortie . 1235 tNormalize .............................................................. 1239 Proprits du tNormalize ................................... 1239 Scnario : Normaliser des donnes ................... 1239 tPerl ........................................................................ 1242 Proprits du tPerl ............................................. 1242 Scnario : Afficher le nombre de lignes traites ...... 1242 tPivotToRows ........................................................ 1245 Proprits du tPivotToRows ............................. 1245 Scnario : Concatner une liste de colonnes partir dune table en utilisant les autres colonnes comme pivot 1246 tReplace .................................................................. 1249 Proprits du tReplace ....................................... 1249 Scnario : Remplacement mutliple et filtrage de colonnes ....................................................................... 1250 tSampleRow ........................................................... 1254 Proprits du tSampleRow ................................ 1254 Scnario : Filtrer des lignes et des groupes de lignes 1254 tSortRow ................................................................ 1257 Proprits du tSortRow ..................................... 1257 Creative Commons License

Scnario : Trier des donnes ..............................1258

Composants System ...............................1263


tRunJob ..................................................................1264 Proprits du tRunJob ........................................1264 Scnario : Excuter un Job fils ..........................1265 tSetEnv ....................................................................1271 Proprits du tSetEnv .........................................1271 Scnario : Modifier la variable Date lors de lexcution dun Job ...........................................................1271 tSSH ........................................................................1275 Proprits du tSSH .............................................1275 Scnario : Accder aux informations du systme distant via SSH ............................................................1275 tSystem ....................................................................1277 Proprits du tSystem ........................................1277 Scnario : Echo Hello World! .........................1278

Composants Talend MDM ....................1281


tMDMDelete ...........................................................1282 Proprits du tMDMDelete ................................1282 Scnario : Supprimer des donnes de rfrence dun hub MDM ................................................................1283 tMDMInput ............................................................1288 Proprits du tMDMInput ..................................1288 Scnario : Lire les donnes de rfrence dun hub MDM .......................................................................1289 tMDMOutput .........................................................1293 Proprits du tMDMOutput ...............................1293 Scnario : Ecrire des donnes de rfrence dans un hub MDM ................................................................1295 tMDMReceive ........................................................1301 Proprits du tMDMReceive .............................1301 Scnario associ ................................................1302

Composants XML ...................................1303


tAdvancedFileOutputXML ...................................1304 Proprits du tAdvancedFileOutputXML ..........1304 Dfinir un arbre XML ....................................1306 Mapping de donnes XML .............................1307 Dfinir le statut du noeud ...............................1308 Scnario : Crer un fichier XML laide dune boucle 1310 tDTDValidator .......................................................1315 Proprits du tDTDValidator .............................1315 Scnario : Valider un fichier XML ....................1315 tExtractXMLField .................................................1318 Proprits du tExtractXMLField ........................1318 Scnario 1 : Extraire les donnes XML dun champ

Composants Talend Open Studio

xix

dune table de base de donnes .............................. 1319 Scnario 2 : Extraire les donnes valides et les donnes errones partir dun champ XML dans fichier dlimit ................................................................... 1322 tFileInputXML ...................................................... 1326 Proprits du tFileInputXML ............................ 1326 Scnario 1 : Extraire des adresses XML .......... 1328 Scnario 2 : Extraire les donnes XML errones dans un flux de rejet ........................................................ 1330 tFileOutputXML ................................................... 1334 Proprits de tFileOutputXML .......................... 1334 Scnario : Utiliser un format de sortie XML ..... 1335

tWriteXMLField ....................................................1336 Proprits du tWriteXMLField ..........................1336 Scnario : Extraire la structure dun fichier XML et linsrer dans les champs dune base de donnes ....1337 tXSDValidator .......................................................1342 Proprits du tXSDValidator .............................1342 Scnario associ .................................................1342 tXSLT .....................................................................1343 Proprits du tXSLT ..........................................1343 Scnario : Transformer un fichier XML en HTML laide dune feuille de style XSL .............................1343

xx

Composants Talend Open Studio

Creative Commons License

Creative Commons License

Composants Talend Open Studio

xxi

xxii

Composants Talend Open Studio

Creative Commons License

Prface
Objectif
Ce Guide de rfrence dtaille les principaux composants accessibles partir de chacun des diffrents groupes de la Palette de Talend Open Studio.
Le Guide de rfrence des composants de Talend Open Studio 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 sappliquent aux versions 4.0.x de Talend Open Studio.

Public vis
Ce guide sadresse aux utilisateurs et aux administrateurs de Talend Open Studio.
Dans ce document, linterface prsente par le biais des captures dcran peut tre lgrement diffrente de la vtre.

Conventions typographiques
Ce guide utilise les conventions typographiques suivantes : texte en gras : boutons et champs dune fentre ou dune 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 lutilisateur ; 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.

Dans la section de proprits des composants, une icne composant est disponible en Java et/ou en Perl. Licne

ou

indique si le

introduit un paragraphe apportant une information supplmentaire sur un point

important. Elle introduit galement les commentaires relatifs un tableau ou une image. Licne introduit un message apportant une information relative aux modalits

dexcution, ou des recommandations particulires. Elle est galement utilise pour attirer lattention de lutilisateur sur certaines informations ou situations particulirement importantes.

Creative Commons License

Composants Talend Open Studio

xxiii

Historique des versions


Le tableau ci-dessous liste les modifications apportes au Guide de Rfrence de Talend Open Studio depuis la version 3.0.
Version v3.0_c Date 17/12/08 Historique Les mises jour du Guide de Rfrence de Talend Open Studio comprennent : -La mise jour des proprits avances (Advanced settings) des composants DB input et output. -La mise jour concernant lditeur SCD Editor des composants de type SCD. Les mises jour du Guide de Rfrence de Talend Open Studio comprennent : -La mise jour des proprits avances (Advanced settings) des composants de type Row. -La traduction en franais de la quasi-totalit des composants Databases. -Les nouveaux composants : tAlfrescoOutput, tMysqlTableList, tFileInputEBCDIC, tFileOutputEBCDICainsi que les composants Multischema. Il ny a aucune mise jour du Guide de Rfrence de Talend Open Studio. Les mises jour du Guide de rfrence de Talend Open Studio comprennent : - la traduction des familles de composants suivantes est termine : Databases, File, Logs & Error, Misc, Orchestration. - lajout de nouveaux composants dans les familles Business, File, Misc, Xml, Internet. Les mises jour du Guide de rfrence de Talend Open Studio comprennent : - Nouveaux composants dans les familles File, Internet, Processing, Databases, Business Intelligence. - Mises jour des proprits et des scnarios de beaucoup de composants afin de correspondre aux modifications de linterface de Talend Open Studio. - Mise jour de tSAPInput et ajout dun scnario. - Mise jour de tRunJob et de son scnario. Les mises jour dans le Guide de rfrence Talend Open Studio comprennent : -Nouveaux composants dans les familles File, Databases, Business et Data quality. -Modifications dans les paramtres et scnarios de nombreux composants afin de correspondre aux modifications de linterface. -Modifications dans le tMap + un nouveau scnario. - Suppression du chapitre Multischema du book et ajout des composants multischema dans le fichier File.

v3.1_a

04/05/09

v3.1_b v3.1_c

13/05/09 17/06/09

v3.2_a

20/10/2009

v4.0_a

23/04/2010

xxiv

Composants Talend Open Studio

Creative Commons License

Version v4.0_b

Date 31/05/2010

Historique Les mises jour du Guide de Rfrence Talend Open Studio comprennent : -De nouveaux composants dans les chapitres File, Databases, Business, Internet et MDM. -Les composants EXist ont t ajouts au chapitre Databases. -Des modifications ont t apportes aux proprits et aux scnarios de nombreux composants, afin de correspondre aux changements de linterface.

Remarques et Support
Votre opinion nous intresse, nhsitez 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 ladresse : http://talendforge.org/forum

Creative Commons License

Composants Talend Open Studio

xxv

xxvi

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


Ce chapitre passe en revue les principaux composants prsents dans le groupe Business Intelligence de la Palette de Talend Open Studio. La famille BI regroupe tous les connecteurs couvrant des besoins tels que la lecture et lcriture de bases de donnes multidimensionnelles ou OLAP, la gnration de rapports Jasper, le suivi des modifications de bases de donnes laide de tables Slow Changing Dimension, etc.

Composants Business Intelligence


tDB2SCD

tDB2SCD
Proprits du tDB2SCD
Famille du composant Databases/Business Intelligence/DB2 Le composant tDB2SCD reflte et traque les modifications dune table DB2 SCD ddie. Le tDB2SCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. 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 laide des donnes collectes. Host Port Database Table schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes.

Fonction Objectif

Basic settings

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tDB2SCD

Username et Password Table Schema et Edit Schema

Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.

SCD Editor

Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 20. Cochez cette case pour amliorer les performances du systme.

Use memory saving Mode Advanced settings

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Enable debug mode Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

Creative Commons License

Composants Talend Open Studio

Composants Business Intelligence


tDB2SCDELT

tDB2SCDELT
Proprits du tDB2SCDELT
Famille du composant Databases/Business Intelligence/DB2 Le composant tDB2SCDELT reflte et traque les modifications dune table DB2 SCD ddie. Le tDB2SCDELT adresse 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. 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 laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tDB2Connection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Source table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table contenant les donnes filtrer.

Fonction Objectif

Basic settings

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tDB2SCDELT

Table

Nom de la table crire. Notez quune seule table peut tre crire la fois pour que lopration dinsert soit autorise. 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. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Action on table

Schema et Edit Schema

Surrogate Key Creation Source Keys

Slectionnez dans la liste une colonne utiliser comme cl de substitution. Slectionnez la mthode utiliser pour gnrer la cl de substitution. Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes.

Use SCD Type 1 fields Utilisez le type 1 si vous navez pas besoin de traquer les modifications, pour des corrections typographiques par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour les modifications.

Creative Commons License

Composants Talend Open Studio

Composants Business Intelligence


tDB2SCDELT

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 lune des colonnes dentre 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 loption 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 settings Encoding Type Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

Enable debug mode

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. 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 les proprits du tDB2SCD, page 2, ainsi que le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tGreenplumSCD

tGreenplumSCD
Proprits du tGreenplumSCD
Famille du composant Databases/Business Intelligence/Greenplu m Le composant tGreenplumSCD reflte et traque les modifications dune table Greenplum SCD ddie. Le tGreenplumSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. 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 laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez un tGreenplumConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes. Informations dauthentification de lutilisateur de la base de donnes.

Fonction Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

Composants Business Intelligence


tGreenplumSCD

Table Schema et Edit Schema

Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.

SCD Editor

Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 20. Cochez cette case pour amliorer les performances du systme.

Use memory saving Mode Advanced settings

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Enable debug mode Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tInformixSCD

tInformixSCD
Proprits du tInformixSCD
Component family Databases/Business Intelligence/Informix Le composant tInformixSCD reflte et traque les modifications dune table Informix SCD ddie. Le tInformixSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. 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 laide des donnes collectes. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes.

Fonction Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

Composants Business Intelligence


tInformixSCD

Username et Password Instance

Informations dauthentification de lutilisateur de la base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.

Table Schema et Edit Schema

SCD Editor

Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 20. Cochez cette case pour amliorer les performances du systme. Dcochez cette case lorsque la base de donnes est configure en mode NO_LOG.

Use memory saving Mode Use Transaction Advanced settings

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 dcriture dans la base de donnes.

Usage

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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23 du composant tMysqlSCD.

10

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tIngresSCD

tIngresSCD
Proprits du tIngresSCD
Component family Databases/Business Intelligence/Ingres Le composant tIngresSCD reflte et traque les modifications dune table Ingres SCD ddie. Le tIngresSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. 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 laide des donnes collectes. Server Port Database Username et Password Table Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio. SCD Editor Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 20. Cochez cette case pour amliorer les performances du systme.

Fonction Objectif

Basic settings

Use memory saving Mode Advanced settings

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Creative Commons License

Composants Talend Open Studio

11

Composants Business Intelligence


tIngresSCD

Debug mode Usage

Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23 du composant tMysqlSCD.

12

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tMondrianInput

tMondrianInput
Proprits du tMondrianInput
Famille du composant Business Intelligence/OLAP Cube Le composant tMondrianInput lit des donnes partir de bases relationnelles et produit des groupes de donnes multidimensionnels reposant sur une requte MDX. 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 laide dun lien de type Row Main. DB type Property type Slectionnez le type de relation appropri pour relier les bases de donnes. 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 laide des donnes collectes. Datasource Username et Password Schema et Edit Schema Chemin daccs et nom du fichier contenant les donnes. Informations dauthentification de lutilisateur de la base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Catalog MDX Query Chemin daccs au catalogue (structure de lentrept de donnes). Saisissez votre requte MDX en faisant attention ce que lordre des champs corresponde celui dfini dans le schma et dans la structure de lentrept de donnes. Slectionnez le type dencodage partir de la liste ou choisissez loption Custom pour le dfinir manuellement. Ce champ doit obligatoirement tre renseign.

Fonction

Objectif

Basic settings

Encoding Type

Creative Commons License

Composants Talend Open Studio

13

Composants Business Intelligence


tMondrianInput

Advanced settings Utilisation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant couvre toutes les possibilits des requtes MDX pour des groupes de donnes multidimensionnels.

Scnario : Tables en jointure croise


Le prsent Job permet dextraire des groupes de donnes multidimensionnels partir de tables de bases de donnes relationnelles stockes dans une base MySql. Les donnes sont rcupres laide dune expression multidimensionnelle (requte MDX). Il est clair que vous devez connatre la structure de vos donnes, ou du moins disposer dune description de la structure (catalogue) comme rfrence du groupe de donnes rcuprer dans ces diffrentes dimensions.

A partir de la Palette, cliquez-dposez un composant tMondrianInput (famille Business Intelligence) ainsi quun composant de sortie tLogRow (famille Logs & Errors). Reliez le tMondrianInput au composant de sortie laide dun lien de type Row Main. Slectionnez le composant tMondrianInput puis cliquez sur la vue Component.

Dans le champ DB Type, slectionnez la base de donnes relationnelle utiliser avec Mondrian.

14

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tMondrianInput

Slectionnez lentre 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. Remplissez les dtails de connexion votre base de donnes : Host, Port, Database, User Name et Password. 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).

La base de donnes relationnelle que lon veut interroger contient cinq colonnes : media, drink, unit_sales, store_cost et store_sales. 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 lexemple ci-dessous :

A partir de longlet Basic settings du composant tMondrianInput, renseignez le chemin daccs au catalogue de lentrept de donnes dans le champ Catalog. Ce catalogue dcrit la structure de lentrept.

Creative Commons License

Composants Talend Open Studio

15

Composants Business Intelligence


tMondrianInput

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])" Slectionnez enfin le type dencodage partir de la liste du champ Encoding Type. Slectionnez le composant tLogRow puis cochez loption Print header pour afficher le nom des colonnes sur la console. Enregistrez le Job puis appuyez sur F6 pour lexcuter.

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.

16

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tMSSqlSCD

tMSSqlSCD
Proprits du tMSSqlSCD
Famille de composant Databases/Business Intelligence/MSSQL Server Le composant tMSSqlSCD reflte et traque les modifications dune table SCD MSSQL ddie. Le tMSSqlSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. 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 laide des donnes collectes. Server Port Schema Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom du schma de la base de donnes. Nom de la base de donnes.

Fonction Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

17

Composants Business Intelligence


tMSSqlSCD

Username et Password Table Schema et Edit Schema

Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.

SCD Editor

Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 20. Cochez cette case pour amliorer les performances du systme. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.

Use memory saving Mode Advanced settings Additional JDBC parameters

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Debug mode Utilisation Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

18

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tMysqlSCD

tMysqlSCD
Proprits du tMysqlSCD
Famille de composant Databases/Business Intelligence/MySQL Le composant tMysqlSCD reflte et traque les modifications dune table SCD MySQL ddie. Le tMysqlSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. 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 laide des donnes collectes. Host Port Database Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de la base de donnes.

Fonction Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

19

Composants Business Intelligence


tMysqlSCD

Table Action on table

Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist: :crer la table si ncessaire. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.

Schema et Edit Schema

SCD Editor

Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 20. Cochez cette case pour amliorer les performances du systme. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.

Use memory saving Mode Advanced settings Additional JDBC parameters

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Debug mode Utilisation Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

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. Lditeur SCD permet de construire de manire simple le flux de sortie des donnes SCD. Dans lditeur 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 lditeur SCD.

20

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tMysqlSCD

Cls SCD Vous devez slectionner une ou plusieurs colonnes qui serviront de cls permettant dassurer lunicit 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 dentre 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. Lditeur utilise ce mapping pour localiser lenregistrement dans la table SCD et pour dterminer si un enregistrement est nouveau ou sil 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 didentifier 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 lunicit des donnes entrantes.

Creative Commons License

Composants Talend Open Studio

21

Composants Business Intelligence


tMysqlSCD

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 dentre. Routine : vous pouvez accder aux fonctions de base via le raccourci Ctrl+ Espace. Table max +1 : la valeur maximum de la table SCD est incrmente pour crer une cl de substitution. Types de SCD Il existe quatre types de dimensions volution lente (Slowly Changing Dimensions) : du Type 0 au Type 3. Vous pouvez, dun simple glisser-dposer, appliquer nimporte quel type de SCD nimporte quelle colonne de la table source. Type 0 : ce type de SCD nest pas beaucoup utilis. Certaines donnes dimensionnelles peuvent tre crases et dautres peuvent rester inchanges au cours du temps. Ce type de SCD convient lorsque aucun effort na t mis en place pour grer les dimensions caractre volutif. Type 1 : aucun historique nest stock dans la base de donnes. Les nouvelles donnes crase les anciennes. Utilisez ce type si vous navez pas besoin de traquer les changements. Ce type de SCD convient lorsque vous corrigez certaines fautes, par exemple lorthographe des mots.

22

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tMysqlSCD

Type2 : lintgralit de lhistorique est stocke dans la base de donnes. Ce type de SCD traque les donnes dhistorique en enregistrant un nouvel enregistrement dans la table de dimension avec une nouvelle cl chaque fois quun changement est effectu. Ce type de SCD convient lorsque lon traque les mises jour, par exemple. Le principe du SCD Type 2 rside dans le fait quun nouvel enregistrement est ajout la table SCD lorsquun 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 dun enregistrement. Vous pouvez slectionner une des colonnes du schma dentre comme date de dpart pour la table SCD. -end : ajoute une colonne au schma de la table SCD contenant la date de fin dun enregistrement. Lorsque lenregistrement 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 lanne fictive dans la cellule d cot pour viter davoir une valeur nulle dans le champ end. -version : ajoute une colonne au schma de la table SCD contenant le numro de version de lenregistrement. -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 lancienne valeur dune 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 lon traque les valeurs prcdentes dune colonne qui change.

Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3
Ce scnario Java constitu de cinq composants dcrit un Job traquant les modifications effectues dans quatre des colonnes du fichier dlimit source et crit ces modifications, ainsi que lhistorique des modifications dans une table SCD. 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, lentreprise 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 dassurer lunicit des donnes.

Creative Commons License

Composants Talend Open Studio

23

Composants Business Intelligence


tMysqlSCD

Nous souhaitons que les changements de statut marital crasent les anciens statuts enregistrs. Ce type de changement correspond un changement SCD Type 1. Nous souhaitons insrer un nouvel enregistrement dans la table dimensionnelle avec une cl diffrente chaque fois quune personne change dentreprise. Ce type de changement correspond un changement SCD Type 2. Nous ne souhaitons rcuprer que lancienne ville et lancienne adresse dune personne. Ce type de changement correspond un changement SCD Type 3. Pour raliser ce type de scnario, il est prfrable de le sparer en trois tapes principales : la dfinition du flux principal du Job, le paramtrage de lditeur SCD et la cration de la table de modification dans la base de donnes. Etape 1 : Dfinir le flux principal du Job Cliquez et dposez les composants suivants dans lditeur graphique : tMysqlConnection, tFileInputDelimited, tLogRow, tMysqlSCD, tMysqlCommit. Connectez les composants tFileInputDelimited, tLogRow et tMysqlSCD laide dun lien Row Main. Ce sous-Job correspond au flux principal du Job. Connectez le tMysqlConnection au tFileInputDelimited et le tMysqlSCD au tMysqlCommit laide de liens OnComponentOk.

24

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tMysqlSCD

Dans lditeur graphique, double-cliquez sur le composant tMysqlConnection pour afficher ces proprits de base dans longlet 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 llment Metadata souhait dans lditeur graphique et les informations de connexion la base de donnes apparatront automatiquement dans les champs correspondant. Pour plus dinformations sur les mtadonnes, consultez Dfinition des schmas de mtadonnes du Guide Utilisateur de Talend Open Studio.

Dans ce scnario, nous souhaitons nous connecter la table SCD dans laquelle toutes les modifications apportes au fichier dlimit seront traques.

Dans lditeur graphique, double-cliquez sur le composant tFileInputDelimited pour afficher la vue Basic settings.

Cliquez sur le bouton [...] cot du champ File Name pour slectionner le chemin daccs au fichier dlimit dataset.csv source contenant les informations personnelles. 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.

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.

Creative Commons License

Composants Talend Open Studio

25

Composants Business Intelligence


tMysqlSCD

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 : firstname, lastname, address, city, company, age, status et id. Dans longlet Basic settings du 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 dtre traites par composant SCD. Dans lditeur graphique, double-cliquez sur le composant tMysqlSCD pour paramtrer ses proprits.

Dans longlet Basic settings, cochez la case Use an existing connection pour rutiliser les informations de connexion dfinies dans les proprits du composant tMysqlConnection. Dans le champ Table, saisissez le nom de la table SCD dans laquelle les changements seront stocks. Cliquez sur Sync columns pour rcuprer toutes les colonnes du fichier dlimit. Si ncessaire, cliquez sur Edit schema pour vrifier la structure des donnes en sortie du composant tMysqlSCD.

26

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tMysqlSCD

Dans lditeur graphique, double-cliquez sur le composant tMysqlCommit pour paramtrer ses proprits. Dans la liste Component list, slectionnez la connexion adquate sil y a plusieurs composants de connexion dans le Job. Etape 2 : Paramtrer lditeur SCD Dans longlet Basic settings du composant tMysqlSCD, cliquez sur le bouton [...] cot du champ SCD Editor pour ouvrir lditeur SCD editor et construire le flux de donnes en sortie du SCD.

Toutes les colonnes du fichier dlimit source, provenant du composant prcdent et nayant pas encore t utilises, apparaissent dans le panneau Unused de lditeur SCD. Tous les autres panneaux de lditeur sont vides.

Creative Commons License

Composants Talend Open Studio

27

Composants Business Intelligence


tMysqlSCD

A partir de la liste Unused, glissez la colonne id vers le panneau Source keys pour tre utilise comme cl permettant dassurer lunicit des donnes entrantes. Dans le panneau Surrogate keys, donnez un nom la cl de substitution (surrogate key) dans le champ Name, SK1 pour ce scnario. Dans la liste Creation, slectionnez la mthode utiliser pour gnrer la cl de substitution, Auto-increment pour ce scnario. Dans la liste Unused, glissez les colonnes firstname et lastname vers le panneau Type 0, les changements effectus dans ces colonnes ne nous intressent pas. Glissez la colonne status vers le panneau Type 1. Lancienne valeur sera crase par la nouvelle. Glissez la colonne company vers le panneau Type 2. A chaque fois quune personne change dentreprise, 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 quun 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, nous slectionnons Fixed Year Value dans la colonne end et saisissez une anne fictive pour viter davoir une valeur nulle dans le champ de date de fin. -cochez le case version pour conserver le numro de version de lenregistrement. -cochez la case active pour ajouter la colonne Status contenant les statuts True ou False des enregistrements. True correspond lenregistrement en cours et False correspond lenregistrement modifi. Glissez les colonnes address et city vers le panneau Type 3 pour ne rcuprer que les informations sur les anciennes valeurs des adresses et des villes. Pour plus dinformations sur les types de SCD, consultez Mthodologie de gestion du SCD page 20..

28

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tMysqlSCD

Cliquez sur Ok pour valider votre configuration et fermer lditeur SCD. 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 lditeur SCD editor.

Creative Commons License

Composants Talend Open Studio

29

Composants Business Intelligence


tMysqlSCD

Etape 3 : Crer la table SCD Dans la base de donnes, vous devez crer la table SCD rcuprant les changements comme dfinis dans le composant tMysqlSCD. La table SCD doit tre compose du schma du fichier dlimit et du schma de sortie SCD. Dans ce scnario, la table SCD est structure selon le schma suivant : firstname, lastname, address, city, company, age, status, id, SK1, previous_address, previuos city, scd_active, scd_end, scd version et scd_date. Pour crire les changements et lhistorique de ces changements dans la table SCD slectionne, enregistrez votre Job et appuyez sur F6 pour lexcuter.

La console affiche le contenu du fichier dlimit dentre. Janet divorce, dmnage Adelanto au 355 Golf Rd et travaille maintenant Greenwood. Adam sest marri, a dmnag Belmont au 2505 Alisson ct. et travaille Scoop. Mettez jour le fichier dlimit avec ces informations et appuyez sur F6 pour excuter le Job.

30

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tMysqlSCD

La console affiche les changements apports aux informations personnelles et la table SCD affiche lhistorique de ces changements, ainsi que leur statut et leur numro de version.

Creative Commons License

Composants Talend Open Studio

31

Composants Business Intelligence


tMysqlSCDELT

tMysqlSCDELT
Proprits du tMysqlSCDELT
Famille du composant Databases/Business Intelligence/MySQL Le composant tMysqlSCDELT reflte et traque les modifications dune table MySQL SCD ddie. Le tMysqlSCDELT adresse 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. 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 laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tMysqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Source table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table contenant les donnes filtrer.

Fonction Objectif

Basic settings

32

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tMysqlSCDELT

Table

Nom de la table crire. Notez quune seule table peut tre crire la fois pour que lopration dinsert soit autorise. 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. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Action on table

Schema et Edit Schema

Source Keys

Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes.

Use SCD Type 1 fields Utilisez le type 1 si vous navez pas besoin de traquer les modifications, pour des corrections typographiques par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour les modifications.

Creative Commons License

Composants Talend Open Studio

33

Composants Business Intelligence


tMysqlSCDELT

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 lune des colonnes dentre 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 loption 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. 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 les proprits du tMysqlSCD, page 19, ainsi que le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

34

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tOracleSCD

tOracleSCD
Proprits du tOracleSCD
Famille de composant Databases/Business Intelligence/Oracle Le composant tOracleSCD reflte et traque les modifications dune table SCD Oracle ddie. Le tOracleSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. 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 laide des donnes collectes. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection type DB Version Host Port Liste droulante des pilotes disponibles. Slectionnez la version dOracle que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes.

Fonction Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

35

Composants Business Intelligence


tOracleSCD

Database Schema Username et Password Table Schema et Edit Schema

Nom de la base de donnes. Nom du schma de la base de donnes. Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.

SCD Editor

Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 20. Cochez cette case pour amliorer les performances du systme.

Use memory saving Mode Advanced settings

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 dcriture dans la base de donnes.

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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

36

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tOracleSCDELT

tOracleSCDELT
Proprits du tOracleSCDELT
Famille du composant Databases/Business Intelligence/Oracle Le composant tOracleSCDELT reflte et traque les modifications dune table Oracle SCD ddie. Le tOracleSCDELT adresse 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. 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 laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tOracleConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Source table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table contenant les donnes filtrer.

Fonction Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

37

Composants Business Intelligence


tOracleSCDELT

Table

Nom de la table crire. Notez quune seule table peut tre crire la fois pour que lopration dinsert soit autorise. 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. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Action on table

Schema et Edit Schema

Surrogate Key Creation Source Keys

Slectionnez dans la liste une colonne utiliser comme cl de substitution. Slectionnez la mthode utiliser pour gnrer la cl de substitution. Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes.

Use SCD Type 1 fields Utilisez le type 1 si vous navez pas besoin de traquer les modifications, pour des corrections typographiques par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour les modifications.

38

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tOracleSCDELT

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 lune des colonnes dentre 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 loption 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 settings Encoding Type Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

Enable debug mode

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. 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 les proprits du tOracleSCD, page 35, ainsi que le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

Creative Commons License

Composants Talend Open Studio

39

Composants Business Intelligence


tParAccelSCD

tParAccelSCD
Proprits du tParAccelSCD
Famille du composant Databases/Business Intelligence/ParAccel Le composant tParAccelSCD reflte et traque les modifications dune table ParAccel SCD ddie. Le tParAccelSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. 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 laide des donnes collectes. Use an existing connection Cochez cette case si vous utilisez un tParAccelConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes. Informations dauthentification de lutilisateur de la base de donnes.

Fonction Objectif

Basic settings

40

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tParAccelSCD

Table Schema et Edit Schema

Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.

SCD Editor

Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 20. Cochez cette case pour amliorer les performances du systme.

Use memory saving Mode Advanced settings

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 dcriture dans la base de donnes.

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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

Creative Commons License

Composants Talend Open Studio

41

Composants Business Intelligence


tPostgresPlusSCD

tPostgresPlusSCD
Proprits du tPostgresPlusSCD
Famille de composant Databases/Business Intelligence/Postgresp lus Server Le composant tPostgresPlusSCD reflte et traque les modifications dune table SCD PostgresPlus ddie. Le tPostgresPlusSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. 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 laide des donnes collectes. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes.

Fonction Objectif

Basic settings

42

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tPostgresPlusSCD

Username et Password Table Schema et Edit Schema

Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.

SCD Editor

Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 20. Cochez cette case pour amliorer les performances du systme.

Use memory saving Mode Advanced settings

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Enable debug mode Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

Creative Commons License

Composants Talend Open Studio

43

Composants Business Intelligence


tPostgresPlusSCDELT

tPostgresPlusSCDELT
Proprits du tPostgresPlusSCDELT
Famille du composant Databases/Business Intelligence/PostgresP lus Le composant tPostgresPlusSCDELT reflte et traque les modifications dune table PostgresPlus SCD ddie. Le tPostgresPlusSCDELT adresse 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. 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 laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tPostgresPlusConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes.

Fonction Objectif

Basic settings

44

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tPostgresPlusSCDELT

Source table Table

Nom de la table contenant les donnes filtrer. Nom de la table crire. Notez quune seule table peut tre crire la fois pour que lopration dinsert soit autorise. 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. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Action on table

Schema et Edit Schema

Surrogate Key Creation Source Keys

Slectionnez dans la liste une colonne utiliser comme cl de substitution. Slectionnez la mthode utiliser pour gnrer la cl de substitution. Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes.

Use SCD Type 1 fields Utilisez le type 1 si vous navez pas besoin de traquer les modifications, pour des corrections typographiques par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour les modifications.

Creative Commons License

Composants Talend Open Studio

45

Composants Business Intelligence


tPostgresPlusSCDELT

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 lune des colonnes dentre 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 loption 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 settings Encoding Type Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

Enable debug mode

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. 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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

46

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tPostgresqlSCD

tPostgresqlSCD
Proprits du tPostgresqlSCD
Famille de composant Databases/Business Intelligence/Postgresq l Server Le composant tPostgresqlSCD reflte et traque les modifications dune table SCD Postgresql ddie. Le tPostgresqlSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. 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 laide des donnes collectes. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes.

Fonction Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

47

Composants Business Intelligence


tPostgresqlSCD

Username et Password Table Schema et Edit Schema

Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.

SCD Editor

Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 20. Cochez cette case pour amliorer les performances du systme.

Use memory saving Mode Advanced settings

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Enable debug mode Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

48

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tPostgresqlSCDELT

tPostgresqlSCDELT
Proprits du tPostgresqlSCDELT
Famille du composant Databases/Business Intelligence/Postgresq l Le composant tPostgresqlSCDELT reflte et traque les modifications dune table Postgresql SCD ddie. Le tPostgresqlSCDELT adresse 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. 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 laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tPostgresqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Source table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table contenant les donnes filtrer.

Fonction Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

49

Composants Business Intelligence


tPostgresqlSCDELT

Table

Nom de la table crire. Notez quune seule table peut tre crire la fois pour que lopration dinsert soit autorise. 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. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Action on table

Schema et Edit Schema

Surrogate Key Creation Source Keys

Slectionnez dans la liste une colonne utiliser comme cl de substitution. Slectionnez la mthode utiliser pour gnrer la cl de substitution. Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes.

Use SCD Type 1 fields Utilisez le type 1 si vous navez pas besoin de traquer les modifications, pour des corrections typographiques par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour les modifications.

50

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tPostgresqlSCDELT

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 lune des colonnes dentre 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 loption 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 settings Encoding Type Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

Enable debug mode

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. 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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

Creative Commons License

Composants Talend Open Studio

51

Composants Business Intelligence


tSPSSInput

tSPSSInput
Avant de pouvoir utiliser toutes les fonctionnalits des composants SPSS, assurez-vous de 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 navez pas encore install SPSS, copiez le lib SPSS IO spssio32.dll partir du CD dinstallation et copiez-le dans votre rpertoire system32.

Proprits du tSPSSInput
Famille du composant Business Intelligence

Fonction Objectif Basic settings

Le composant tSPSSInput lit les donnes de fichiers SPSS (.sav). Le tSPSSInput envoie des donnes SPSS pour les crire, dans un autre fichier par exemple. Sync schema Schema et Edit Schema Cliquez sur ce bouton pour synchroniser le schma avec les colonnes du fichier SPSS dentre. Pour ce composant, le schma des mtadonnes est directement rcupr partir du fichier SPSS dentre, cest pourquoi il est en lecture seule. Vous pouvez cliquer sur Edit schema pour voir les mtadonnes qui ont t rcupres. Indiquez le nom ou le chemin daccs au fichier SPPS lire. Cochez cette case pour traduire les tiquettes (labels) des valeurs stockes. Si vous cochez cette case, vous devrez nouveau rcuprer les mtadonnes.

File name Translate labels

Advanced settings Utilisation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est utilis comme composant de dbut. Il requiert un composant de sortie.

Scnario : Afficher le contenu dun fichier SPSS


Le scnario suivant cre un Job deux composants qui permet de lire chaque ligne dun fichier SPSS (.sav) et de les afficher en sortie dans la console de log de la vue Run. A partir de la Palette, dposez les composants tSPSSInput et tLogRow dans lespace graphique.

52

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tSPSSInput

Cliquez-droit sur le composant tPSSInput et connectez-le au tLogRow laide dun lien de type Main Row. Double-cliquez sur le composant tSPSSInput pour afficher la vue Basic settings et configurer ses paramtres.

Cliquez sur le bouton [...] ct du champ Filename pour parcourir vos dossiers jusquau fichier SPSS que vous voulez lire. Cliquez sur le bouton [...] ct du champ Sync schema. Un message apparat lcran pour vous inviter rcuprer le schma du fichier SPSS slectionn.

Cliquez sur le bouton Yes pour fermer le message. Si ncessaire, cliquez sur le bouton [...] ct du champ Edit schema pour visualiser la structure de donnes prdfinie dans le fichier SPSS source.

Creative Commons License

Composants Talend Open Studio

53

Composants Business Intelligence


tSPSSInput

Cliquez sur le bouton OK pour fermer la bote de dialogue. Sauvegardez votre Job, et appuyez sur F6 afin de lexcuter. Le fichier SPSS est lu ligne par ligne, et les champs extraits sont affichs dans la console.

Afin deffectuer des traductions sur les valeurs stockes, procdez comme suit : Dans la vue Basic settings, cochez la case Translate label si vous voulez traduire les tiquettes (labels) des valeurs stockes. 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. Cliquez sur Yes (Oui) pour fermer le message et procder ltape suivante. Un second message souvre et vous demande si vous souhaitez propager les modifications. Cliquez sur Yes (Oui) afin de fermer le message et passer ltape suivante. Enregistrez le Job puis appuyez sur la touche F6 pour lexcuter. Le fichier SPSS est lu ligne par ligne et les champs extraits sont affichs sur la console de log de la vue Run, aprs traduction des valeurs stockes.

54

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tSPSSInput

Creative Commons License

Composants Talend Open Studio

55

Composants Business Intelligence


tSPSSOutput

tSPSSOutput
Avant de pouvoir utiliser toutes les fonctionnalits des composants SPSS, assurez-vous de 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 navez pas encore install SPSS, copiez le lib SPSS IO spssio32.dll partir du CD dinstallation et copiez-le dans votre rpertoire system32.

Proprits du tSPSSOutput
Famille du composant Business Intelligence

Fonction Objectif Basic settings

Le composant tSPSSOutput crit des donnes dans un fichier SPSS (.sav). Le tSPSSOutput crit ou ajoute des donnes un fichier SPSS. Il cre les fichiers SPSS directement ou crase ceux qui existent dj. Sync schema Schema et Edit Schema Cliquez sur ce bouton pour synchroniser le schma avec les colonnes du fichier SPSS dentre. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Filename Write Type Nom ou chemin daccs du fichier SPSS crire. Slectionnez dans la liste le type daction effectuer : Write: crit simplement les nouvelles donnes. Append: crit les nouvelles donnes la suite de celles existantes.

Advanced settings Utilisation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant ne peut tre utilis comme composant de dbut. Il ncessite un flux dentre.

Scnario : Ecrire des donnes dans un fichier .sav


Ce scnario dcrit un Job trs simple qui crit des donnes dentre dans un fichier .sav. Glissez-dposez de la Palette dans lespace de modlisation graphique un tRowGenerator et un tSPSSOutput.

56

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tSPSSOutput

Cliquez-droit sur le tRowGenerator, et connectez-le au tSPSSOutput, laide dun lien Row Main.

Dans lespace de modlisation graphique, double-cliquez sur le tRowGenerator afin dafficher sa vue Basic settings et ouvrir son diteur. Vous pouvez dfinir votre schma.

Cliquez sur le bouton [+] afin dajouter les colonnes que vous voulez crire dans le fichier .sav. 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 derreur saffichera lors de la contruction du Job.

Cliquez sur OK afin de valider votre schma et fermer lditeur. Double-cliquez sur le tSPSSOutput afin dafficher sa vue Component et dfinir ses proprits.

Creative Commons License

Composants Talend Open Studio

57

Composants Business Intelligence


tSPSSOutput

Cliquez sur le bouton [...] ct du champ Filename, et parcourez votre rpertoire jusquau fichier SPSS .sav dans lequel vous souhaitez crire les donnes. 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. Si ncessaire, cliquez sur le bouton Edit schema pour voir/diter le schma dfini. Dans la liste Write Type, slectionnez Write (crire) ou Append (crire la suite), pour simplement crire les donnes dentre dans le fichier .sav, ou bien les crire la fin de ce mme fichier. Sauvegardez votre Job, et appuyez sur F6 pour lexcuter. Les donnes gnres par le tRowGenerator sont crites dans le fichier .sav dfini.

58

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tSPSSProperties

tSPSSProperties
Pour pouvoir utiliser toutes les fonctionnalits des composants SPSS, assurez-vous de 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 navez pas encore install SPSS, copiez le lib SPSS IO spssio32.dll partir du CD dinstallation et copiez-le dans votre rpertoire system32.

Proprits du tSPSSProperties
Famille du composant Business Intelligence

Fonction Objectif Basic settings

Le composant tSPSSProperties dcrit les proprits dun fichier SPSS (.sav) dfini. Le tSPSSProperties permet dobtenir des informations sur les proprits principales dun fichier SPSS dfini. Schema et Edit Schema Pour ce composant, le schma des mtadonnes est prdfini, cest pourquoi il est en lecture seule. Vous pouvez cliquer sur Edit schema pour voir les mtadonnes prdfinies. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Filename Nom ou chemin daccs au fichier SPSS traiter.

Advanced settings Utilisation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est utilis comme composant de dbut. Il requiert un composant de sortie.

Scnario associ
Pour des scnarios associs, consultez : Scnario : Afficher le contenu dun fichier SPSS, page 52 Scnario : Ecrire des donnes dans un fichier .sav, page 56

Creative Commons License

Composants Talend Open Studio

59

Composants Business Intelligence


tSPSSStructure

tSPSSStructure
Avant de pouvoir utiliser toutes les fonctionnalits des composants SPSS, assurez-vous de 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 navez pas encore install SPSS, copiez le lib SPSS IO spssio32.dll partir du CD dinstallation et copiez-le dans votre rpertoire system32.

Proprits du tSPSSStructure
Famille du composant Business Intelligence

Fonction Purpose

Le composant tSPSSStructure rcupre les informations sur les variables contenues dans le fichier SPSS (.sav). 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. Schema et Edit Schema Pour ce composant, le schma des mtadonnes est prdfini, cest pourquoi il est en lecture seule. Il correspond la convention interne SPSS. Vous pouvez cliquer sur Edit schema pour voir les mtadonnes prdfinies. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Filename Nom ou chemin daccs au fichier SPSS traiter.

Basic settings

Utilisation

Ce composant est utilis comme composant de dbut. Il requiert un composant de sortie.

Scnario associ
Pour des scnarios associs, consultez : Scnario : Afficher le contenu dun fichier SPSS, page 52 Scnario : Ecrire des donnes dans un fichier .sav, page 56

60

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tSybaseSCD

tSybaseSCD
Proprits du tSybaseSCD
Famille du composant Databases/Business Intelligence/Sybase Le composant tSybaseSCD reflte et traque les modifications dune table SCD Sybase ddie. Le tSybaseSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. 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 laide des donnes collectes. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de la base de donnes.

Fonction Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

61

Composants Business Intelligence


tSybaseSCD

Table Schema et Edit Schema

Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.

SCD Editor

Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 20. Cochez cette case pour amliorer les performances du systme.

Use memory saving Mode Advanced settings

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Enable debug mode Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

62

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tSybaseSCDELT

tSybaseSCDELT
Proprits du tSybaseSCDELT
Famille du composant Databases/Business Intelligence/Sybase Le composant tSybaseSCDELT reflte et traque les modifications dune table Sybase SCD ddie. Le tSybaselSCDELT adresse 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. 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 laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tSybaseConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Source table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table contenant les donnes filtrer.

Fonction Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

63

Composants Business Intelligence


tSybaseSCDELT

Table

Nom de la table crire. Notez quune seule table peut tre crire la fois pour que lopration dinsert soit autorise. 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. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Action on table

Schema et Edit Schema

Surrogate Key Creation Source Key

Slectionnez dans la liste une colonne utiliser comme cl de substitution. Slectionnez la mthode utiliser pour gnrer la cl de substitution. Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes.

Use SCD Type 1 fields Utilisez le type 1 si vous navez pas besoin de traquer les modifications, pour des corrections typographiques par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour les modifications.

64

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence


tSybaseSCDELT

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 lune des colonnes dentre 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 loption 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. 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 le composant tMysqlSCD, page 19 et son Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 23.

Creative Commons License

Composants Talend Open Studio

65

Composants Business Intelligence


tSybaseSCDELT

66

Composants Talend Open Studio

Creative Commons License

Composants Business
Ce composant passe en revue les principaux composants prsents dans le groupe Business de la Palette of Talend Open Studio. La famille Business regroupe les connecteurs couvrant des besoins scifiques, tels que la lecture et lcriture de base de donnes de type CRM ou ERP et la lecture et lcriture de systme SAP.

Composants Business
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. Ce composant permet de crer et de grer des documents sur un serveur Alfresco. URL Login et Password Base Saisissez lURL pour vous connecter lapplication Web Alfresco. Entrez les donnes didentification de lutilisateur au serveur Alfresco. Saisissez le chemin daccs de lemplacement o stocker le document, ou Cochez la case Map... puis choisissez, partir de la liste droulante Column, lemplacement darrive. Lorsque vous entrez le nom de lemplacement, assurez-vous de le protger par des doubles barres obliques inverses (\\). 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 sil nexiste pas pralablement. Notez cependant quun message derreur apparatra si vous essayez de crer un document qui existe dj. Create or update : permet de crer un document qui nexiste pas encore ou de mettre jour un document existant. 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 quun message derreur apparatra si vous essayez de mettre jour un document qui nexiste pas. Create or update : permet de crer un dossier de destination sil nexiste pas au pralable, ou de mettre jour un dossier existant.

Objectif Basic settings

Container Mode

68

Composants Talend Open Studio

Creative Commons License

Composants Business
tAlfrescoOutput

Define Document Type

Cliquez sur les trois points [...] pour afficher lditeur tAlfrescoOutput. Cet diteur vous permet : - de slectionner le fichier dans lequel vous avez dfini les mtadonnes pour servir de cadre lors de lenregistrement du document sur Alfresco - de dfinir le type du document - de slectionner, partir de la liste droulante available aspects, lun des aspects du modle, puis de cliquer sur le bouton [+] pour ajouter cet aspect la liste de gauche. Affiche les paramtres renseigns dans lditeur tAlfrescoOutput, selon lesquels le document sera cr sur le serveur Alfresco. Notez que vous pouvez modifier nimporte lequel des schmas dentre de la zone Property Mapping. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour effectuer des changements sur le schma. Notez que le schma devient automatiquement local (Built-in) lorque vous effectuez des changements.

Property Mapping

Schema et Edit schema

Result Log File Name Permet de parcourir le fichier dans lequel vous voulez enregistrer les logs lis lexcution du Job. Advanced settings Configure Target Location Container Permet de configurer le type par dfaut des conteneurs. 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. Lorsque cette case est coche, loption permet de configurer manuellement les droits daccs aux conteneurs et aux documents. Cochez la case Inherit Permissions pour synchroniser les droits daccs 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 dutilisateurs dans les colonnes User or group et User or group column. Slectionnez le type dencodage partir de la liste ou choisissez loption Custom pour le dfinir manuellement. Ce champ doit obligatoirement tre renseign.

Configure Permissions

Encoding Type

Creative Commons License

Composants Talend Open Studio

69

Composants Business
tAlfrescoOutput

Association Target Mapping

Permet de crer de nouveaux documents sur Alfresco qui contiennent des liens associs des documents dj existants sur ce serveur, pour faciliter le processus de navigation par exemple. Pour crer des associations : -Ouvrez lditeur tAlfresco. -Cliquez sur le bouton Add puis slectionnez un modle pour lequel vous avez dj dfini des aspects contenant des associations. -Cliquez sur la liste droulante, en haut de la fentre de lditeur, et slectionnez le type de document correpondant. -Cliquez sur OK pour fermer lditeur et afficher lassociation ainsi cre dans la liste Association Target Mapping.

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation/Conditions pralables Ce composant est gnralement utilis en tant que composant de sortie et requiert un composant de dbut. Pour pouvoir utiliser le composant tAlfrescoOutput, il est ncessaire dinstaller certaines ressources utiles. Pour plus dinformations, consultez la sous-section Procdure dinstallation.

Procdure dinstallation
Pour pouvoir utiliser le composant tAlfrescoOutput dans Talend Open Studio, vous devez tout dabord 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 dinstallation. Conditions pralables Commencez par excuter les oprations suivantes : Tlchargez le fichier alfresco-community-tomcat-2.1.0.zip Dzippez-le dans un dossier dinstallation, par exemple : C:\Program Files\Java\jdk1.50_16 Installez JDK 1.5.0+ Effectuez une mise jour de la variable JAVA_HOME (JAVA_HOME= C:\alfresco) A partir du dossier dinstallation (C:\alfresco), lancez le serveur Alfresco en utilisant le script alf_start.bat
Assurez-vous que le serveur Alfresco est bien lanc avant dutiliser le composant tAlfrescoOutput.

Installation du module Talend Alfresco Notez que le fichier talendalfresco_20081014.zip est propos avec le composant tAlfrescoOutput dans Talend Open Studio.

70

Composants Talend Open Studio

Creative Commons License

Composants Business
tAlfrescoOutput

Pour installer le module Talend Alfresco : 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:\alfredsco\tomcat\webapps\alfresco\WEB-INF\lib Ajoutez le filtre didentification des commandes au fichier web.xml situ au chemin daccs C:\alfredsco\tomcat\webapps\alfresco\WEB-INF son WEB-INF/, daprs le modle de lexemple situ dans le dossier talendalfresco_20081014/alfresco du fichier zipp talendalfresco_20081014.zip Les captures dcran ci-dessous montrent la partie ajouter (lignes en bleu) au fichier web.xml alfresco.

Creative Commons License

Composants Talend Open Studio

71

Composants Business
tAlfrescoOutput

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:/alfredsco/tomcat/shared/classes/alfresco/extension 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 quune modification de type Alfresco les rtablira. Contenu : Ne confondez pas le chemin daccs au fichier dont vous voulez crer le contenu et celui de son emplacement cible sur Alfresco. Noubliez pas lURL ! 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. Nutilisez jamais la double barre oblique inverse (\\) dans le chemin daccs cible (chappement automatique), moins que vous nentriez le chemin directement dans les proprits de base (Basic settings) du composant tAlfrescoOutput ou que vous neffectuiez une concatnation, dans lditeur tMap par exemple.

72

Composants Talend Open Studio

Creative Commons License

Composants Business
tAlfrescoOutput

Proprits multiples ou associations : Il est possible de nen crer quune 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 imput 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 sagit dune list (object) et non dune simple list ! Rfrences (documents et dossiers) : Les rfrences sont cres par mapping dune ou plusieurs rfrences de noeud existantes (xpath ou namepath), en type String ou List(object). Une erreur dans lassociation ou la proprit de type rfrence nempche pas la cration du noeud qui la porte. Les proprits de type rfrence sont cres dans longlet des proprits standards (Basic Settings). Les associations sont cres dans longlet 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 dune utilisation de documentation physique des systmes de Gestion de Contenu lectroniques. Un systme de Gestion de Contenu permet de grer un large ventail de documents, allant des plus basiques aux certificats dactions 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 dutiliser des technologies diverses. Scanner les documents papier, crer des interfaces pour capter les documents lectroniques dautres applications, convertir les documents images en documents textes lisibles et modifiables par une machine... Ceci nest quun 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.

Creative Commons License

Composants Talend Open Studio

73

Composants Business
tAlfrescoOutput

Les mtadonnes de support, qui permettent didentifier 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 dun document en mme temps que ses mtadonnes associes, pour quil 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. A partir de la Palette, cliquez-dposez les composants tFileInputDelimited et tAlfrescoOutput sur lditeur graphique. Reliez ces deux composant laide dun lien Row Main.

74

Composants Talend Open Studio

Creative Commons License

Composants Business
tAlfrescoOutput

Dans lditeur graphique, double-cliquez sur le tFileInputDelimited pour en afficher les paramtres de base (Basic settings). Renseignez le chemin daccs au fichier dans le champ File Name ainsi que toutes les autres proprits. Notez cependant que si vous avez dj stock vos schmas dentre en local dans le Repository, vous pouvez tout simplement rcuprer le fichier choisi partir du noeud Metadata et le dposer sur lditeur graphique. Les paramtres du fichier dlimit safficheront alors automatiquement dans les champs concerns de longlet Basic settings du composant concern. Pour plus dinformations sur les mtadonnes, consultez la section Configurer un schma File Delimited du Guide Utilisateur de Talend Open Studio.

Dans ce scnario, le fichier dlimit prsente les mtadonnes et le chemin daccs de deux documents que nous voulons crer sur le serveur Alfresco. Le schma dentre des documents de dcompose en quatre colonnes : file_name, destination_folder name, source_path, et author.

Le schma dentre du fichier dlimit sera donc comme suit :

Creative Commons License

Composants Talend Open Studio

75

Composants Business
tAlfrescoOutput

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

Dans la partie Alfresco Server, saisissez lURL du serveur Alfresco ainsi que les donnes didentification de lutilisateur dans les champs correspondants.

76

Composants Talend Open Studio

Creative Commons License

Composants Business
tAlfrescoOutput

Dans la partie TargetLocation, vous pouvez soit saisir le nom de lemplacement du serveur o vous voulez stocker le document, soit cocher la case Map... puis choisir lemplacement cible partir de la liste droulante Column, soit destination_folder_name dans ce scnario.
Lorsque vous renseignez le nom de lemplacement, assurez vous de bien utiliser le caractre dchappement double barre oblique inverse (\\).

Dans la liste droulante Document Mode, slectionnez le mode que vous voulez utiliser pour la cration de vos documents. Dans la liste droulante Container Mode, slectionnez le mode que vous voulez utiliser pour le dossier de destination sur Alfresco. Cliquez sur le bouton [...] de loption Define Document Type pour ouvrir lditeur tAlfrescoOutput.

Creative Commons License

Composants Talend Open Studio

77

Composants Business
tAlfrescoOutput

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 saffichent 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 naurez plus besoin de ce dossier.

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, nous voulons que le nom de lauteur fasse partie des mtadonnes enregistres sur Alfresco. Cliquez sur la liste droulante, situe en haut de la fentre de lditeur, pour slectionner le type donner aux documents crs sur Alfresco. Dans cet exemple, il sagit de Content. Tous les aspects dfinis, utiliss pour slectionner les mtadonnes crire sur Alfresco, saffichent dans la liste Property Mapping de longlet Basic Settings du composant tAlfrescoOutput. Dans ce scnario, il sagit de trois aspects, deux aspects de base pour le type Content (content et name) ainsi quun aspect aditionnel (author). Cliquez sur Sync columns pour propager automatiquement toutes les colonnes du fichier dlimit. Si ncessaire, cliquez sur Edit schema pour avoir un aperu de la structure des donnes du tAlfrescoOutput en sortie.

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. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.

78

Composants Talend Open Studio

Creative Commons License

Composants Business
tAlfrescoOutput

Les deux documents sont crs sur Alfresco grce aux mtadonnes des schmas dentre.

Creative Commons License

Composants Talend Open Studio

79

Composants Business
tCentricCRMInput

tCentricCRMInput
Proprits du tCentricCRMInput
Famille du composant Business/CentricCR M Le composant tCentricCRMInput se connecte un module de la base de donnes CentricCRM via le service Web adquat. Le tCentricCRMInput permet dextraire les donnes dune base de donnes Centric CRM laide dune requte. CentricCRM URL Module Server UserID et Password Schema et Edit Schema Saisissez lURL du service Web permettant de se connecter la base de donnes CentricCRM. Slectionnez le module adquat dans la liste. Saisissez ladresse IP du serveur de base de donnes. Saisissez les informations dauthentification de lutilisateur au service Web. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits 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. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn. Saisissez la requte permettant de slectionner les donnes extraire.

Fonction Objectif Basic settings

Query condition Utilisation Limitation

Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie est ncessaire. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

80

Composants Talend Open Studio

Creative Commons License

Composants Business
tCentricCRMOutput

tCentricCRMOutput
Proprits du tCentricCRMOutput
Famille du composant Business/CentricCR M Le composant tCentricCRMOutput crit dans un module de la base de donnes CentricCRM via le service Web adquat. Le tCentricCRMOutput permet dcrire des donnes dans une base de donnes CentricCRM. CentricCRM URL Module Server UserID et Password Action Saisissez lURL du service Web permettant de se connecter la base de donnes CentricCRM. Slectionnez le module adquat dans la liste. Saisissez ladresse IP du serveur de base de donnes. Saisissez les informations dauthentification de lutilisateur au service Web. Vous pouvez effectuer lune des oprations suivantes sur les donnes du module CentricCRM : Insert : insrer les donnes. Update : mettre les donnes jour. Delete : supprimer les donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits 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. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn.

Fonction Objectif Basic settings

Schema et Edit Schema

Utilisation Limitation

Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

Creative Commons License

Composants Talend Open Studio

81

Composants Business
tHL7Input

tHL7Input
tHL7Input Properties
Component family Business

Fonction Objectif

Lit un fichier de structure HL7 et extrait des donnes ligne par ligne. Ce composant lit un fichie HL7 structur ou un flux de donnes ligne par ligne pour le scinder en champs et envoie les champs tel que dfinis dans le schma au composant suivant du Job via une connexion Row. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant connexion de base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Multi Schemas Editor Lditeur [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 dentre. 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 lditeur. Cochez cette case si vous ne souhaitez pas valider les messgaes HL7. Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Slectionnez le type dencodage partir de la liste ou choisissez loption Custom pour le dfinir manuellement. Ce champ doit obligatoirement tre renseign.

Basic settings

Not Validate HL7 Message Advanced settings Advanced separator (for numbers)

Encoding Type

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

82

Composants Talend Open Studio

Creative Commons License

Composants Business
tHL7Input

Usage Limitation

Gnralement utilis en tant que composant dentre. Un composant de sortie est requis. n/a

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.

A partir de la Palette, glissez-dposez un composant tHL7Input, et trois tLogRow dans lespace de modlisation graphique. Double-cliquez sur le composant tHL7Input afin douvrir son diteur.

Creative Commons License

Composants Talend Open Studio

83

Composants Business
tHL7Input

Dans le champ File path, cliquez sur [Browse...], parcourez votre rpertoire, et slectionnez votre fichier HL7. 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). Dans la zone Schema View, dans la liste Segment(As Schema), slectionnez MSH. Glissez-dposez les segments MSH-3(1)[HD] et MSH-7(1)[TS] de la zone Message View dans la zone Schema View.

Dans la zone Schema View, dans la liste Segment(As Schema), slectionnez EVN. 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.

84

Composants Talend Open Studio

Creative Commons License

Composants Business
tHL7Input

Dans la zone Schema View, dans la liste Segment(As Schema), slectionnez PID. 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-5(1)-7-1[ID]. Cliquez sur Ok afin de fermer lditeur. Reliez le tHL7Input aux trois tLogRow, en utilisant respectivement les liens MSH, EVN et PID. Sauvegardez votre Job, et appuyez sur F6 pour lexcuter.

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.

Creative Commons License

Composants Talend Open Studio

85

Composants Business
tMicrosoftCRMInput

tMicrosoftCRMInput
Proprits du tMicrosoftCRMInput
Famille de composant Business

Fonction Objectif Basic settings

Le composant tMicrosoftCRMInput se connecte une entit de la base de donnes MicrosoftCRM via le service Web adquat. Ce composant permet dextraire les donnes dune base MicrosoftCRM selon certaines conditions dfinies dans des colonnes spcifiques. 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 laide des donnes collectes. Microsoft Webservice URL Organizename Saisissez lURL du service Web permettant de se connecter la base de donnes Microsoft CRM. Renseignez le nom de lutilisateur ou de lorganisme, dfini par un administrateur, qui veut accder la base de donnes MicrosoftCRM. Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez le nom de domaine du serveur sur lequel est hberge la base MicrosoftCRM. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nombre de secondes dcoute du port avant sa fermeture. Slectionnez lentit adquate partir de la liste droulante. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Si vous effectuez des modifications, le schma passera automatiquement en built-in. Pour ce composant, le schma correspond lentit slectionne. Si vous souhaitez combiner le filtrage simple et le mode avanc, slectionnez loprateur permettant de combiner les deux modes.

Username et Password Domain Host Port Time out (seconds) Entity Schema et Edit Schema

Logical operators used to combine conditions

86

Composants Talend Open Studio

Creative Commons License

Composants Business
tMicrosoftCRMInput

Conditions

Les conditions sont excutes les unes aprs les autres pour chaque ligne. Input column : Cliquez dans la cellule et slectionnez la colonne du schma dentre laquelle attribuer la condition. Operator : Cliquez dans la cellule et slectionnez loprateur pour relier la valeur la colonne du schma. Value : Saisissez la valeur filtre entre guillemets, si ncessaire. Cliquez sur le bouton [+] pour ajouter autant de conditions que vous le souhaitez.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie est ncessaire. n/a

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 lcriture des donnes dun fichier dlimit en entre dans une entit personnalise dune base de donnes MicrosoftCRM . Le Job permet ensuite dextraire des lignes spcifiques jusque dans un fichier de sortie, en utilisant les conditions dfinies sur certaines colonnes dentre.
Si vous voulez crire dans une Entit Personnalise dune base de donnes MicrosoftCRM, assurez-vous de nommer les colonnes conformment aux rgles de syntaxe Microsoft, savoir name_columnname en minuscules.

A partir de la Palette, dposez les composants suivants dans lditeur graphique : tFileInputdelimited, tFileOutputDelimited, tMicrosoftCRMInput, et tMicrosoftCRMOutput.

Creative Commons License

Composants Talend Open Studio

87

Composants Business
tMicrosoftCRMInput

Connectez le composant tFileInputDelimited au tMicrosoftCRMOutput laide dun lien de type Row Main. Connectez le composant tMicrosoftCRMIntput au tFileOutputDelimited laide dun lien de type Row Main. Connectez le composant tFileInputDelimited au tMicrosoftCRMInput laide dun lien de type OnSubjobOk. Double-cliquez sur le composant tFileInputDelimited pour afficher la vue Basic settings et configurer ses paramtres de base.

Slectionnez le mode Repository partir de la liste droulante Property Type si vous avez stock les paramtres du fichier dentre sous le noeud Metadata de larborescence 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. Cliquez sur le bouton [...] ct du champ File Name/Input Stream et parcourez vos dossiers jusquau fichier dlimit contenant les donnes dentre. Dans cet exemple, le fichier dentre comprend les colonnes suivantes : new_id, new_status, new_firstname, new_email, new_city, new_initial et new_zipcode.

Dans le champ Row separator, dfinissez le sparateur de lignes permettant didentifier les fins de ligne. De mme, pour Field separator, dfinissez le sparateur de champs permettant de dlimiter les diffrents champs pour chaque ligne.

88

Composants Talend Open Studio

Creative Commons License

Composants Business
tMicrosoftCRMInput

Dfinissez, si ncessaire, le nombre de lignes den-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. Cliquez sur Edit schema pour ouvrir une bote de dialogue dans laquelle vous pouvez dfinir le schma dentre que vous voulez crire dans la base de donnes MicrosoftCRM.

Cliquez sur OK pour fermer la bote de dialogue. Double-cliquez sur le composant tMicrosoftCRMOutput pour afficher la vue Basic settings et configurer ses paramtres de base.

Dans le champ Microsoft Web Service URL, saisissez lURL du serveur Web Microsoft. Renseignez ensuite le nom (Username) ainsi que le mot de passe (Password) correspondants.
Creative Commons License Composants Talend Open Studio 89

Composants Business
tMicrosoftCRMInput

Dans le champ OrganizeName, saisissez lidentifiant qui porte les droits daccs la base de donnes MicrosoftCRM. Dans le champ Domain, renseignez le nom de domaine du serveur sur lequel la base de donnes MicrosoftCRM est hberge. Saisissez ensuite ladresse IP (Host) et le numro de port dcoute (Port) du serveur. A partir de la liste droulante Action, slectionnez lopration que vous voulez effectuer. Dans cet exemple, le but est dinsrer (Insert) des donnes dans une entit personnalise sur la base MicrosoftCRM. Dans le champ Time out, dfinissez la limite de temps (en secondes) aprs laquelle le Job sarrte automatiquement. Dans la liste Entity, slectionnez lune des options proposes. Dans cet exemple, cest loption CustomEntity qui est slectionne.
Lorsque loption CustomEntity est slectionne, le champ Custom Entity Name apparat, dans lequel vous devez saisir le nom de lentit personnalise.

Le Schema est alors dfini de manire automatique, en fonction de lentit 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 navez pas besoin en sortie. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent.

Double-cliquez sur le composant tMicrosoftCRMInput pour afficher la vue Basic settings et configurer ses paramtres de base.

90

Composants Talend Open Studio

Creative Commons License

Composants Business
tMicrosoftCRMInput

Slectionnez le mode Repository partir de la liste droulante Property Type si vous avez stock les paramtres du fichier dentre sous le noeud Metadata de larborescence 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. Dans le champ Microsoft Web Service URL, saisissez lURL du serveur Web Microsoft. Renseignez ensuite le nom (Username) ainsi que le mot de passe (Password) correspondants. Dans le champ OrganizeName, saisissez lidentifiant qui porte les droits daccs la base de donnes MicrosoftCRM. Dans le champ Domain, renseignez le nom de domaine du serveur sur lequel la base de donnes MicrosoftCRM est hberge. Saisissez ensuite ladresse IP (Host) et le numro de port dcoute (Port) du serveur. Dans le champ Time out, dfinissez la limite de temps (en secondes) aprs laquelle le Job sarrte automatiquement. Dans la liste Entity, slectionnez lune des options proposes. Dans cet exemple, cest loption CustomEntity qui est slectionne.
Creative Commons License Composants Talend Open Studio 91

Composants Business
tMicrosoftCRMInput

Le Schema est alors dfini de manire automatique, en fonction de lentit slectionne, mais vous pouvez le modifier si ncessaire. Dans cet exemple, pour accder lentit 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.

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. Dans la vue Basic settings, slectionnez loprateur logique And ou Or utiliser pour combiner les conditions dfinies dans les colonnes dentre. Dans cet exemple, pour dfinir deux conditions sur deux colonnes dentre diffrentes, il faut utiliser loprateur logique And. 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 dextraire toutes les lignes concernant les clients dont la ville correspond New York et dont lidentifiant est suprieur 2. Cliquez dans chaque ligne et slectionnez, partir de la liste droulante Operator, loprateur utiliser pour relier la colonne dentre avec sa valeur associe. Dans cet exemple, loprateur Equal est slectionn pour la colonne new_city et Greater Than pour new_id. Cliquez dans chaque ligne et dfinissez, dans la colonne Value, la valeur des colonnes dentre : New York pour la colonne new_city et 2 pour new_id dans cet exemple. Il est possible dutiliser une valeur fixe aussi bien quune valeur de contexte dans ce champ. Double-cliquez sur le composant tFileOutputdelimited pour afficher la vue Basic settings et configurer ses paramtres de base.

92

Composants Talend Open Studio

Creative Commons License

Composants Business
tMicrosoftCRMInput

Slectionnez le mode Built-In partir de la liste droulante Property Type puis cliquez sur le bouton [...] ct du champ pour parcourir vos dossiers jusquau fichier de sortie. Dfinissez les sparateurs de lignes (Row separator) et de champs (Field separator). Cochez la case Append pour ajouter des lignes la fin des entres de la base de donnes. Cochez la case Include Header si le fichier de sortie comprend un en-tte. Cliquez sur le bouton Sync columns pour rcuprer le schma partir du composant prcdent. Enregistrez votre Job puis cliquez sur F6 pour lexcuter.

Seuls les clients habitant la ville de New York, et dont lidentifiant est suprieur 2, apparaissent dans la liste du fichier de sortie stock en local.

Creative Commons License

Composants Talend Open Studio

93

Composants Business
tMicrosoftCRMOutput

tMicrosoftCRMOutput
Proprits du tMicrosoftCRMOutput
Famille de composant Business

Fonction Objectif Basic settings

Le composant tMicrosoftOutput crit dans un objet de la base de donnes MicrosoftCRM via le service Web adquat. Ce composant permet dcrire des donnes dans une base de donnes MicrosoftCRM. Microsoft Webservice URL Organizename Username et Password Domain Host Port Action Saisissez lURL du service Web permettant de se connecter la base de donnes MicrosoftCRM. Renseignez le nom de lorganisme qui veut accder la base de donnes MicrosoftCRM. Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez le nom de domaine du serveur qui installe MicrosoftCRM. Adresse IP du serveur de base de donnes MicrosoftCRM. Numro du port dcoute du serveur de la base de donnes MicrosoftCRM. Vous pouvez effectuer lune des oprations suivantes sur les donnes MicrosoftCRM : Insert : insrer les donnes. Update : mettre les donnes jour. Delete : supprimer les donnes. Nombre de secondes dcoute du port avant sa fermeture. Slectionnez lentit adquate partir de la liste droulante. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent.

Time out (seconds) Entity Schema et Edit Schema

Advanced settings Usage Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a

94

Composants Talend Open Studio

Creative Commons License

Composants Business
tMicrosoftCRMOutput

Scnario associ
Pour un scnario associ, consultez le Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques, page 87.

Creative Commons License

Composants Talend Open Studio

95

Composants Business
tMSAXInput

tMSAXInput
Proprits du tMSAXInput
Famille de composant Business/ Microsoft AX Le composant tMSAXInput se connecte au serveur MicrosoftAX. Ce composant permet de lire les donnes dun serveur MicrosoftAX et d'effectuer des requtes sur ces donnes. 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 laide des donnes collectes. Host Domain Username et Password Schema et Edit Schema Adresse IP du serveur. Saisissez le nom de domaine sur lequel est hberg le serveur MicrosoftAX. Saisissez les informations dauthentification de lutilisateur. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. iSi vous effectuez des modifications, le schma passera automatiquement en built-in. Nom de la table lire. Saisissez votre requte SQL en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.

Fonction Objectif Basic settings

Table Name Query

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie est ncessaire. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

96

Composants Talend Open Studio

Creative Commons License

Composants Business
tMSAXOutput

tMSAXOutput
Proprits du tMSAXOutput
Famille de composant Business/ Microsoft AX Le composant tMSAXOutput se connecte au serveur MicrosoftAX. Ce composant permet dcrire les donnes dun serveur MicrosoftAX. 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 laide des donnes collectes. Host Domain Username et Password Table Name Action on data Adresse IP du serveur. Saisissez le nom de domaine sur lequel est hberg le serveur MicrosoftAX. Saisissez les informations dauthentification de lutilisateur. Nom de la table crire. Vous pouvez effectuer nimporte quelle opration sur les donnes dun serveur MicrosoftAX. Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. iSi vous effectuez des modifications, le schma passera automatiquement en built-in.

Fonction Objectif Basic settings

Creative Commons License

Composants Talend Open Studio

97

Composants Business
tMSAXOutput

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cette option vous permet dutiliser des expressions locales afin deffectuer 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 dautres 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 loprateur que vous souhaitez utiliser avec la clause WHERE. Cette colonne nest pas disponible quand vous utilisez Insert comme action sur les donnes. Data type : type de donnes. Local expression : type dexpression locale qui sera excut afin de modifier ou insrer la colonne de donnes correspondante, par 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 laction 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.

Additional columns

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis en tant que composant de sortie. Un composant de dbut est ncessaire. n/a

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.

98

Composants Talend Open Studio

Creative Commons License

Composants Business
tMSAXOutput

Ce scnario Java dcrit un Job deux composants qui utilise le composant tMSAXOutput afin dinsrer une ligne dans une table dfinie stocke sur un serveur Microsoft AX et modifie ensuite les valeurs dans lune des colonnes insre.

Glissez le composant tFixedFlowInput ainsi que le tMSAXOutput de la Palette dans lespace de modlisation. Connectez les composants laide dun lien Row de type Main. Double-cliquez sur le tFixedFlowInput afin dafficher la vue Component et de dfinir ses proprits.

Slectionnez le mode Built-In dans le champ Schema Type et cliquez sur le bouton [...] du champ Edit schema afin dafficher une bote de dialogue qui vous permettra de dfinir le schma dentre. Cliquez sur le bouton Plus vert pour ajouter des colonnes dans le schma dentre, trois dans cet exemple, name, city et street (nom, ville et rue). Cliquez sur OK pour fermer la bote de dialogue. Une nouvelle bote de dialogue souvre et vous demande si vous voulez propager les modifications, cliquez sur Yes (Oui). Les colonnes du schma saffichent automatiquement dans le tableau Values. Cliquez sur la colonne Value et saisissez une valeur pour chaque colonne dentre. Double-cliquez sur le tMSAXOutput pour ouvrir la vue Component et dfinir ses proprits.

Creative Commons License

Composants Talend Open Studio

99

Composants Business
tMSAXOutput

Slectionnez le mode Built-In dans le champ Property Type. Dans le champ Host, saisissez ladresse IP du serveur MicrosoftAX Dans le champ Domain, saisissez le nom du domaine qui hberge le serveur MicrosoftAX. Entrez votre nom dutilisateur et votre mot de passe de connexion au serveur dans les champs correspondants. Dans le champ Table Name, saisissez le nom de la table dans la quelle vous souhaitez crire des donnes. Dans la liste Action on data, slectionnez laction que vous dsirez excuter, Delete dans cet exemple. Cliquez sur Sync columns pour retrouver le schma du composant prcdent. Dans cet exemple, nous voulons retrouver les trois colonnes dentre : name, city et street (nom, ville et rue). Si ncessaire, cliquez sur le bouton [...] du champ Edit schema afin douvrir une bote de dialogue qui vous permettra de vrifier le schma retourn. Dans le tableau Additional columns, cliquez sur le bouton [+] afin dajouter une ligne dans laquelle vous pouvez utiliser une expression locale pour modifier les donnes que vous voulez crire dans une colonne spcifique. 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 ladresse du Bryant park. La colonne address de cet exemple contiendra donc la chane de caractres suivante : New York-Midtown Manhattan.

100

Composants Talend Open Studio

Creative Commons License

Composants Business
tMSAXOutput

Sauvegardez votre Job et appuyez sur F6 pour lexcuter. Le tMSAXOutput insre dans la table ADDRESS du serveur MicrosoftAX une ligne contenant les trois colonnes dentre 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.

Scnario 2 : Effacer des donnes dune 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 Java dcrit un Job deux composants qui utilise le tMSAXOutput dans le but deffacer toutes les lignes dune table dfinie qui ne correspondent pas aux donnes contenues dans la colonne cl sur un serveur MicrosoftAX. Dans cet exemple, le schma dentre que nous utilisons est une colonne address (adresse) qui contient les donnes suivantes : New York-Midtown Manhattan. Nous voulons effacer du serveur MicrosoftAX toutes les adresses qui ne sont pas identiques celle-ci.

Glissez les composants tFixedFlowInput et tMSAXOutput de la Palette dans lespace de modlisation. Connectez les deux composants laide dun lien Row de type Main. Double-cliquez sur le tFixedFlowInput pour afficher sa vue Component et dfinir ses proprits.

Slectionnez le mode Built-In dans le champ Schema Type et cliquez sur le bouton [...] du champ Edit schema pour ouvrir une bote de dialogue o vous pourrez dfinir le schma. Cliquez sur le bouton [+] et ajoutez les colonnes dentre du schma, address dans cet exemple.

Creative Commons License

Composants Talend Open Studio

101

Composants Business
tMSAXOutput

Cliquez sur OK pour fermer la bote de dialogue. Les colonnes du schma saffichent automatiquement dans la list Values. Cliquez sur la colonne Value et saisissez une valeur pour la colonne dentre. Double-cliquez sur le tMSAXOutput pour ouvrir sa vue Component et dfinir ses proprits.

Slectionnez le mode Built-In dans le champ Property Type. Dans le champ Host, saisissez ladresse IP du serveur MicrosoftAX. Dans le champ Domain, entrez le nom du domaine qui hberge le serveur MicrosoftAX. Saisissez votre nom dutilisateur et votre mot de passe de connexion au serveur dans les champs correspondants. Dans le champ Table Name, saisissez le nom de la table dans laquelle vous voulez crire des donnes. Dans la liste Action on data, slectionnez laction que vos souhaitez excuter, Delete dans cet exemple. Cliquez sur Sync columns pour retourner le schma du composant prcdent. Dans cet exemple, nous voulons rcuprer la colonne dentre zipcode (code postal). Cliquez sur le bouton [...] du champ Edit Schema pour ouvrir la bote de dialogue dans laquelle vous pouvez vrifier le schma rcupr.

102

Composants Talend Open Studio

Creative Commons License

Composants Business
tMSAXOutput

Dans le schma de sortie, cochez la case Key (cl) ct du nom de la colonne.


Quand vous slectionnez une option diffrente de Insert, vous devez toujours dfinir la Reference column (colonne de rfrence) comme colonne cl.

Cliquez sur OK pour valider les changements et fermer la bote de dialogue. Dans le tableau Additional columns, cliquez sur le bouton [+] pour ajouter une ligne et dfinir les paramtres que le composant utilisera comme base pour lopration deffacement. 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 dajouter. Dans cet exemple, nous souhaitons effacer de la table ADDRESS du serveur MicrosoftAX toutes les lignes dans lesquelles la colonne Address nest pas identique ladresse dans la colonne cl address : New York-Midtown Manhattan.
Quand vous slectionnez une action autre que Insert ,dans le champ Action on data vous devez toujours slectionner Replace dans la colonne Position.

Sauvegardez votre Job et appuyez sur F6 pour lexcuter. 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.

Creative Commons License

Composants Talend Open Studio

103

Composants Business
tOpenbravoERPInput

tOpenbravoERPInput
Proprits du tOpenbravoERPInput
Famille de composant Business

Fonction Objectif Basic settings

Le composant tOpenbravoERPInput se connecte une entit de la base de donnes OpenbravoERP via le service Web adquat. Ce composant permet dextraire les donnes dune base OpenBravoERP selon certaines conditions dfinies dans des colonnes spcifiques. Openbravo REST WebService URL Username et Password Entity Schema et Edit Schema Saisissez lURL du service Web permettant de se connecter la base de donnes OpenbravoERP. Saisissez les informations dauthentification de lutilisateur au service Web. Slectionnez lentit adquate partir de la liste droulante. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Si vous effectuez des modifications, le schma passera automatiquement en built-in. Pour ce composant, le schma correspond lentit slectionne. Saisissez votre clause WHERE. Cochez cette case afin de slectionner comment ordonner les rsultats (les lments de la liste droulante dpendent de lentit slectionne). Sort : Dans cette liste, vous pouvez choisir de trier vos rsultats de manire ascendante (Ascending) ou descendante (Descending). Saisissez le numro de la ligne que vous souhaitez rcuprer en premier. Saisissez le nombre maximal de rsultats que vous souhaitez rcuprer. Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux.

WHERE Clause Order by

First result Max result Advanced settings Advanced separator (for numbers)

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie est ncessaire. n/a

104

Composants Talend Open Studio

Creative Commons License

Composants Business
tOpenbravoERPInput

Scnario associ
Pour un scnario associ, consultez le Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques, page 87.

Creative Commons License

Composants Talend Open Studio

105

Composants Business
tOpenbravoERPOutput

tOpenbravoERPOutput
Proprits du tOpenbravoERPOutput
Famille de composant Business

Fonction Objectif Basic settings

Le composant tOpenbravoERPOutput crit dans un objet de la base de donnes OpenbravoERP via le service Web adquat. Ce composant permet dcrire des donnes dans une base de donnes OpenbravoERP. Openbravo REST Webservice URL Username et Password Action on data Saisissez lURL du service Web permettant de se connecter la base de donnes OpenbravoERP. Saisissez les informations dauthentification de lutilisateur au service Web. Slectionnez dans la liste si vous souhaitez mettre jour ou crer des donnes (Update/Create), ou si vous prfrez en supprimer (Remove). Cochez cette case afin de slectionner votre fichier en parcourant votre rpertoire. Slectionnez lentit adquate partir de la liste droulante. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent.

Use existing data file Entity Schema et Edit Schema

Advanced settings Usage Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a

Scnario associ
Pour un scnario associ, consultez le Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques, page 87.

106

Composants Talend Open Studio

Creative Commons License

Composants Business
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. Lintrt 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

Fonction Objectif

Le composant tSalesforceBulkExec excute les actions dfinies sur les donnes de chargement de masse prpares. En tant que composant ddi, le tSalesforceBulkExec vous permet doptimiser les performances lors des excutions doprations dfinies dans votre Salesforce.com. Use an existing connection Cochez cette case pour utiliser une connexion tablie partir du tSalesforceConnection. Une fois coche, la liste Component List apparat, et vous permet de slectionner le composant tSalesforceConnection devant tre utilis. Pour plus dinformations, consultez la section Proprits du tSalesforceConnection, page 109.

Basic settings

Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Bulk file path Action Saisissez les informations dauthentification de lutilisateur au service Web. Rpertoire o sont stockes les donnes de masse que vous devez traiter. Vous pouvez effectuer les oprations suivantes sur les donnes de lobjet Salesforce : Insert : insrer des donnes. Update : mettre jour des donnes. Upsert : mettre jour et insrer des donnes. Slectionnez lobjet adquat dans la liste. Custom Object : cette option fait apparatre le champ Costum Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter.

Module

Creative Commons License

Composants Talend Open Studio

107

Composants Business
tSalesforceBulkExec

Schema et Edit Schema

Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Saisissez le nombre de lignes devant tre traites par lot de donnes. Saisissez le nombre doctets par lot de donnes devant tre traits. Cochez cette case si vous souhaitez utiliser un proxy.

Advanced settings

Rows to commit Bytes to commit Use Socks Proxy

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. Les donnes de masse traiter doivent tre au format .csv.

Scnario associ
Pour un scnario associ, consultez Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com, page 122.

108

Composants Talend Open Studio

Creative Commons License

Composants Business
tSalesforceConnection

tSalesforceConnection

Proprits du tSalesforceConnection
Famille de composant Business

Fonction Objectif Basic settings

Le composant tSalesforceConnection ouvre une connexion vers un systme Salesforce afin deffectuer une transaction. Ce composant permet de vous connecter Salesforce. Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Use Socks Proxy Use Soap Compression Saisissez les informations dauthentification de lutilisateur au service Web. Cochez cette case si vous souhaitez utiliser un proxy. Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec les composants Salesforce. n/a

Scnario associ
Pour plus dinformations relatives au fonctionnement du composant tSalesforceConnection, consultez tMysqlConnection page 482.

Creative Commons License

Composants Talend Open Studio

109

Composants Business
tSalesforceGetDeleted

tSalesforceGetDeleted
Proprits du tSalesforceGetDeleted
Famille de composant Business

Fonction Objectif Basic settings

Le composant tSalesforceGetDeleted rcupre les donnes supprimes dun objet Salesforce sur une priode donne. Ce composant rcupre les donnes supprimes de lobjet Salesforce spcifi sur une priode spcifie. Use an existing connection Cochez cette case pour utiliser une connexion tablie partir du tSalesforceConnection. Une fois coche, la liste Component List apparat, et vous permet de slectionner le composant tSalesforceConnection devant tre utilis. Pour plus dinformations, consultez la section Proprits du tSalesforceConnection, page 109.

Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Timeout (milliseconds) Module Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez le dlai avant suspension de la requte sur Salesforce.com. Slectionnez lobjet adquat dans la liste. Custom Object : cette option fait apparatre le champ Costum Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Saisissez entre guillemet la date laquelle vous voulez commencer la recherche. Pour cela, utilisez le format de date suivant : yyy-MM-dd HH:mm:ss. Vous ne pouvez effectuer la recherche que sur les 30 derniers jours. Saisissez entre guillemet la date laquelle vous voulez terminer la recherche. Pour cela, utilisez le format de date suivant : yyy-MM-dd HH:mm:ss. Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance.

Schema et Edit Schema

Start Date

End Date

Advanced settings

Use Soap Compression

110

Composants Talend Open Studio

Creative Commons License

Composants Business
tSalesforceGetDeleted

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a

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.

Cliquez et dposez les composants tSalesforceGetDeleted et tLogRow de la Palette dans le Job Designer. Reliez-les via un lien de type Row > Main. Double-cliquez sur le composant tSalesforceGetDeleted pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :

Dans le champ Salesforce WebService URL, laissez lURL du service Web Salesforce par dfaut ou saisissez lURL laquelle vous souhaitez accder. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au service Web. Dans la liste Module, slectionnez lobjet auquel vous souhaitez accder. Dans ce scnario, nous souhaitons accder lobjet Account.

Creative Commons License

Composants Talend Open Studio

111

Composants Business
tSalesforceGetDeleted

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 navez pas enregistr le schma dans les mtadonnes du repository, slectionnez Built-in dans la liste Schema et cliquez sur le bouton [...] cot du champ Edit schema et paramtrer le schma manuellement. 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, nous cherchons les donnes supprimes dans les cinq derniers jours. Double-cliquez sur le composant tLogRow pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits : Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Dans la zone Mode, slectionnez loption Vertical pour faire apparatre le rsultat dans sous forme de tableau dans la console. Enregistrez votre Job et appuyez sur F6 pour lexcuter.

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

112

Composants Talend Open Studio

Creative Commons License

Composants Business
tSalesforceGetServerTimestamp

tSalesforceGetServerTimestamp
Proprits du tSalesforceGetServerTimestamp
Famille de composant Business

Fonction Objectif Basic settings

Le composant tSalesforceGetServerTimestamp rcupre la date actuelle du serveur Salesforce. Ce composant rcupre la date actuelle sous forme de timestamp du serveur Salesforce. Use an existing connection Cochez cette case pour utiliser une connexion tablie partir du tSalesforceConnection. Une fois coche, la liste Component List apparat, et vous permet de slectionner le composant tSalesforceConnection devant tre utilis. Pour plus dinformations, consultez la section Proprits du tSalesforceConnection, page 109.

Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Schema et Edit Schema Saisissez les informations dauthentification de lutilisateur au service Web. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Cochez cette case si vous souhaitez utiliser un proxy. Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance.

Advanced settings

Use Socks Proxy Use Soap Compression

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

Creative Commons License

Composants Talend Open Studio

113

Composants Business
tSalesforceGetUpdated

tSalesforceGetUpdated
Proprits du tSalesforceGetUpdated
Famille de composant Business

Fonction Objectif Basic settings

Le composant tSalesforceGetUpdated rcupre les donnes mises jour dun objet Salesforce sur une priode donne. Ce composant rcupre les donnes mises jour de lobjet Salesforce spcifi sur une priode spcifie. Use an existing connection Cochez cette case pour utiliser une connexion tablie partir du tSalesforceConnection. Une fois coche, la liste Component List apparat, et vous permet de slectionner le composant tSalesforceConnection devant tre utilis. Pour plus dinformations, consultez la section Proprits du tSalesforceConnection, page 109.

Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Timeout (milliseconds) Module Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez le dlai avant suspension de la requte sur Salesforce.com. Slectionnez lobjet adquat dans la liste. Custom Object : cette option fait apparatre le champ Costum Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Saisissez entre guillemet la date laquelle vous voulez commencer la recherche. Pour cela, utilisez le modle de date suivant : yyy-MM-dd HH:mm:ss. Vous ne pouvez effectuer la recherche que sur les 30 derniers jours. Saisissez entre guillemets la date laquelle vous voulez terminer la recherche. Pour cela, utilisez le modle de date suivant : yyy-MM-dd HH:mm:ss. Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance.

Schema et Edit Schema

Start Date

End Date

Advanced settings

Use Soap Compression

114

Composants Talend Open Studio

Creative Commons License

Composants Business
tSalesforceGetUpdated

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

Creative Commons License

Composants Talend Open Studio

115

Composants Business
tSalesforceInput

tSalesforceInput
Proprits du tSalesforceInput
Famille de composant Business

Fonction Objectif Basic settings

Le composant tSalesforceInput se connecte un objet de la base de donnes Salesforce via le service Web adquat. Ce composant permet dextraire les donnes dune base de donnes Salesforce laide dune requte. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant connexion de base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies.

Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Timeout (milliseconds) Module Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez le dlai avant suspension de la requte sur Salesforce.com. Slectionnez lobjet adquat dans la liste. Use Custom Object : cette option fait apparatre le champ Costum Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter.

116

Composants Talend Open Studio

Creative Commons License

Composants Business
tSalesforceInput

Schema et Edit Schema

Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits 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. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn. Saisissez la requte permettant de slectionner les donnes extraire. Exemple : account_name= Talend Cochez cette case pour saisir manuellement la requte Salesforce que vous souhaitez effectuer dans le champ Query. Nombre denregistrements dans chaque lot rcupr. Cochez cette case si vous souhaitez utiliser un proxy. Caractre, chane ou expression rgulire utilis pour normaliser les donnes collectes laide de requtes effectues sur les relations hirarchiques entre les diffrents objets Salesforce. Caractre, chane ou expression rgulire utilis pour sparer le nom de lobjet parent du nom de lobjet fils lorsque vous effectuez une requte sur les relations hirarchiques entre les diffrents objets Salesforce. Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance, notamment lors des oprations de batch.

Query condition

Manual input of SOQL query Advanced settings Batch Size Use Socks Proxy Normalize delimited (for child relationship) Column name delimiter (for child relationship) Use Soap Compression

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie est ncessaire. n/a

Scnarios associs
Pour un scnario associ, consultez le Scnario : Supprimer des donnes de lobjet Account, page 119. Lopration est similaire que celle utilise pour se connecter SugarCRM, par consquent consultez le scnario du composant tSugarCRMInput, page 151 pour plus dinformations.

Creative Commons License

Composants Talend Open Studio

117

Composants Business
tSalesforceOutput

tSalesforceOutput
Proprits du tSalesforceOutput
Famille de composant Business

Fonction Objectif Basic settings

Le composant tSalesforceOutput crit dans un objet de la base de donnes Salesforce via le service Web adquat. Ce composant permet dcrire des donnes dans une base de donnes Salesforce. Use an existing connection Cochez cette case pour utiliser une connexion tablie partir du tSalesforceConnection. Une fois coche, la liste Component List apparat, et vous permet de slectionner le composant tSalesforceConnection devant tre utilis. Pour plus dinformations, consultez la section Proprits du tSalesforceConnection, page 109.

Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Timeout (milliseconds) Action Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez le dlai avant suspension de la requte sur Salesforce.com. Vous pouvez effectuer lune des oprations suivantes sur les donnes de lobjet Salesforce : Insert : insrer les donnes. Update : mettre les donnes jour. Delete : supprimer les donnes. Upsert : mettre jour et insrer les donnes. Slectionnez lobjet adquat dans la liste. Custom Object : cette option fait apparatre le champ Costum Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. 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.

Module

Schema et Edit Schema

Advanced settings

Extended Output

118

Composants Talend Open Studio

Creative Commons License

Composants Business
tSalesforceOutput

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Renseignez ce champ si vous souhaitez crer un fichier contenant les logs derreur. Pour cela, cliquez sur le bouton [...] cot de ce champ pour dfinir le chemin daccs et le nom du fichier Cochez cette case si vous souhaitez utiliser un proxy. Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance. Cochez cette case afin de permettre Salesforce.com de retourner lID 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 laction Insert, mais non en mode batch, cest--dire sans loption Extended Output.

Error logging file

Use Socks Proxy Use Soap Compression Retrieve inserted ID

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a

Scnario : Supprimer des donnes de lobjet Account


Ce scnario dcrit un Job deux composants permettant de supprimer une entre de lobjet Account.

Cliquez et dposez les composants tSalesforceInput et tSalesforceOutput de la Palette dans le Job Designer. Reliez-les via un lien de type Row > Main. Double-cliquez sur le composant tSalesforceInput pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :

Creative Commons License

Composants Talend Open Studio

119

Composants Business
tSalesforceOutput

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 navez pas stock la connexion dans les mtadonnes, slectionnez Built-in dans la liste et renseignez les champs manuellement. Dans le champ Salesforce WebService URL, laissez lURL du service Web Salesforce par dfaut ou saisissez lURL laquelle vous souhaitez accder. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au service Web. Dans la liste Module, slectionnez lobjet auquel vous souhaitez accder. Dans ce scnario, nous souhaitons accder lobjet Account. 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 navez pas enregistr le schma dans les mtadonnes du repository, slectionnez Built-in dans la liste Schema et cliquez sur le bouton [...] cot du champ Edit schema et paramtrer le schma manuellement. Dans le champ Query Condition, saisissez la requte que vous souhaitez appliquer. Pour ce scnario, nous souhaitons rcuprer le ou les clients dont le nom est sForce., ainsi, saisissez la requte : name=sForce. Pour une requte plus avance, cochez la case Manual input of SOQL query et saisissez-la manuellement. Double-cliquez sur le composant tSalesforceOutput pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :

120

Composants Talend Open Studio

Creative Commons License

Composants Business
tSalesforceOutput

Dans le champ Salesforce WebService URL, laissez lURL du service Web Salesforce par dfaut ou saisissez lURL laquelle vous souhaitez accder. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au service Web. Dans la liste Action, slectionnez laction que vous souhaitez effectuer. Ici, slectionnez Delete pour supprimer le compte sForce slectionn dans le composant prcdent. Dans la liste Module, slectionnez lobjet auquel vous souhaitez accder. Dans ce scnario, nous souhaitons accder lobjet Account. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Enregistrez le Job et appuye sur F6 pour lexcuter. Consultez le contenu de lobjet Account et vrifez que le compte sForce a t supprim du serveur.

Creative Commons License

Composants Talend Open Studio

121

Composants Business
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. Lintrt 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

Fonction Objectif Basic settings

Le composant tSalesforceOutputBulk gnre des fichiers dans un format appropri au traitement de masse. Ce composant prpare le fichier devant tre trait par le tSalesForceBulkExec afin dexcuter des actions sur Salesforce.com. File Name Append Schema et Edit Schema Parcourez le rpertoire o stocker les fichiers gnrs. Cochez cette case afin dcrire la suite des donnes existantes. Sinon, les donnes seront crases. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent.

Advanced settings Utilisation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est utilis avec le tSalesforceBulkExec. Ils permettent doptimiser les performances dalimentation ou de modification des informations sur Salesforce.com. n/a

Limitation

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 lexcution du Job dans la console.

122

Composants Talend Open Studio

Creative Commons License

Composants Business
tSalesforceOutputBulk

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 dutilisation, le fichier est sforcebulk.txt, il contient des informations relatives aux clients. Afin de crer et excuter ce Job, procdez comme suit : Glissez-dposez de la Palette dans lespace de modlisation graphique les composants tFileInputDelimited, tMap, tSalesforceOutputBulk, tSalesforceBulkExec et deux tLogRow. Utilisez un lien Row > Main afin de connecter le tFileInputDelimited au tMap, et le lien Row > out1 du tMap au tSalesforceOutputBulk. Utilisez un lien Row > Main et un lien Row > Reject pour connecter le tSalesforceBulkExec aux deux tLogRow respectivement. Utilisez un lien Trigger > OnSubjobOk afin de connecter le composant tFileInputDelimited au tSalesforceBulkExec. Double-cliquez sur le tFileInputDelimited afin dafficher sa vue Component et dfinir ses proprits.

Creative Commons License

Composants Talend Open Studio

123

Composants Business
tSalesforceOutputBulk

Dans la liste Property Type, slectionnez Repository si vous avez dj stock votre connexion Salesforce sous le noeud Metadata dans la vue Repository. Les proprits sont automatiquement remplies. Si vous navez 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 dinformations propos des mtadonnes, consultez le chapitre Gestion des mtadonnes. A ct du champ File name/Stream, cliquez sur le bouton afin de parcourir votre rpertoire jusqu votre fichier, dans cet exemple sforcebulk.txt. Dans la liste Schema, slectionnez Repository, puis cliquez sur le bouton [...] afin douvrir la bote de dialogue dans laquelle vous pourrez slectionner le schma du Repository utiliser pour ce composant. Si vous navez 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 douvrir 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.

Selon votre fichier dentre, paramtrez les autres champs, comme Row Separator, Field Separator... Double-cliquez sur le composant tMap afin douvrir son diteur et dfinir la transformation. Glissez-dposez toutes les colonnes de la table dentre dans la table de sortie.

124

Composants Talend Open Studio

Creative Commons License

Composants Business
tSalesforceOutputBulk

Ajoutez .toUpperCase() la fin de la colonne Name. Cliquez sur OK afin de valider la transformation. Double-cliquez sur le tSalesforceOutputBulk afin dafficher sa vue Component et dfinir ses proprits.

Dans le champ File Name, parcourez votre rpertoire jusqu lemplacement o vous souhaitez stocker les donnes .csv gnres pour un traitement de masse. Cliquez sur le bouton Sync columns afin dimporter le schma du composant prcdent. Double-cliquez sur le tSalesforceBulkExect afin dafficher sa vue Component et dfinir ses proprits.

Utilisez lURL par dfaut du service Web Salesforce, ou saisissez lURL laquelle vous souhaitez accder. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au service Web.

Creative Commons License

Composants Talend Open Studio

125

Composants Business
tSalesforceOutputBulk

Dans le champ Bulk file path, parcourez votre rpertoire jusqu lemplacement o est stock le fichier .csv gnr par le tSalesforceOutputBulk. Dans la liste Action, slectionnez laction que vous voulez effectuer sur les donnes de masse. Dans cet exemple, slectionnez insert. Dans la liste Module, slectionnez llment auquel vous souhaitez accder, Account dans cet exemple. Dans la liste Schema, slectionnez Repository et cliquez sur le bouton [...] afin douvrir une bote de dialogue dans laquelle vous pourrez slectionner le schma du Repository utiliser pour ce composant. Si vous navez 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 douvrir une bote de dialogue dans laquelle vous pourrez dfinir votre schma manuellement. Dans cet exemple, dfinissez-le comme le schma prcdent. Double-cliquez sur le tLogRow_1 afin dafficher sa vue Component et dfinir ses proprits.

Cliquez sur le bouton Sync columns afin de rcuprer le schma du composant prcdent. Slectionnez le mode Table afin dafficher les rsultats dexcution dans un tableau. Rptez lopration avec le tLogRow_2. Sauvegardez votre Job, et appuyez sur F6 pour lexcuter. Dans la console de la vue Run, vous pouvez vrifier les rsultats dexcution.

126

Composants Talend Open Studio

Creative Commons License

Composants Business
tSalesforceOutputBulk

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 dune incompatibilit avec les lments Account auxquels vous avez accd. Tous les noms de clients sont crits en majuscules.

Creative Commons License

Composants Talend Open Studio

127

Composants Business
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. Lintrt 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

Fonction Objectif

Le composant tSalesforceOutputBulkExec excute les actions dfinies sur les donnes .csv pour Salesforce.com. En tant que composant ddi, le tSalesforceOutpuBulkExec permet doptimiser les performances lors des oprations dfinies sur les donnes, dans votre Salesforce.com. Use an existing connection Cochez cette case pour utiliser une connexion tablie partir du tSalesforceConnection. Une fois coche, la liste Component List apparat, et vous permet de slectionner le composant tSalesforceConnection devant tre utilis. Pour plus dinformations, consultez la section Proprits du tSalesforceConnection, page 109.

Basic settings

Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Bulk file path Action Saisissez les informations dauthentification de lutilisateur au service Web. Chemin daccs au rpertoire o sont stockes les donnes de masse traiter. Vous pouvez effectuer lune des oprations suivantes sur les donnes de lobjet Salesforce : Insert : insrer les donnes. Update : mettre les donnes jour. Upsert : mettre jour et insrer les donnes. Slectionnez lobjet adquat dans la liste. Custom Object : cette option fait apparatre le champ Costum Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent.

Module

Schema et Edit Schema

128

Composants Talend Open Studio

Creative Commons License

Composants Business
tSalesforceOutputBulkExec

Advanced settings

Rows to commit Bytes to commit Use Socks Proxy

Saisissez le nombre de lignes devant tre traites par lot de donnes. Saisissez le nombre doctets par lot de donnes devant tre traits. 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.

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a

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 dexcution du Job dans la console.

Avant de raliser ce Job, vous devez prparer votre fichier dentre, contenant les donnes devant tre traites par le Job. De cet exemple, le fichier sforcebulk.txt, contient des informations relatives aux clients. Afin de crer et excuter le Job, procdez comme suit : Glissez-dposez de la Palette dans lespace de modlisation graphique un composant tFileInputDelimited, un tSalesforceOutputBulkExec, et deux tLogRow. Utilisez un lien Row > Main pour connecter le tFileInputDelimited au tSalesforceOutputBulkExec. Utilisez un lien Row > Main et un lien Row > Reject afin de connecter le tSalesforceOutputBulkExec aux deux tLogRow respectifs.

Creative Commons License

Composants Talend Open Studio

129

Composants Business
tSalesforceOutputBulkExec

Double-cliquez sur le tFileInputDelimited afin dafficher sa vue Component et dfinir ses proprits.

Dans la liste Property Type, slectionnez Repository si vous avez dj stock votre connexion au serveur Salesforce dans le noeud Metadata de la vue Repository. Les proprits sont automatiquement renseignes. Si vous navez pas dfini la connexion au serveur localement dans le Repository, remplissezl es champs manuellement, aprs avoir slectionn Built-in dans la liste Property Type. Pour plus dinformations concernant les mtadonnes, consultez le chapitre Gestion des mtadonnes. A ct du champ File name/Stream, cliquez sur le bouton fichier dentre, par exemple sforcebulk.txt. afin de slectionner votre

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

Configurez les autres proprits selon votre fichier dentre, comme Row Separator, Field Separator... Double-cliquez sur le composant tSalesforceOutputBulkExec afin dafficher sa vue Component et dfinir ses proprits.

130

Composants Talend Open Studio

Creative Commons License

Composants Business
tSalesforceOutputBulkExec

Dans le champ Salesforce WebService URL, utilisez lURL par dfaut du service Web Salesforce, ou saisissez lURL laquelle vous souhaitez accder. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au service Web. Dans le champ Bulk file path, parcourez votre rpertoire jusqu lemplacement o vous stockez les donnes .csv devant tre traites.
Le fichier de masse traiter doit tre au format .csv.

Dans la liste Action, slectionnez laction effectuer sur les donnes de masse, insert dans cet exemple. Dans la liste Module, slectionnez llement auquel vous souhaitez accder, Account dans cet exemple. Dans la liste Schema, slectionnez Repository, puis cliquez sur le bouton [...] afin douvrir une bote de dialogue dans laquelle vous pourrez slectionner le schma du Repository utiliser pour ce composant. Si vous navez 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 douvrir une bote de dialogue o vous pourrez dfinir manuellement le schma. Dans cet exemple, dfinissez le schma comme prcdemment. Double-cliquez sur le tLogRow_1 afin dafficher sa vue Component et dfinir ses proprits.

Cliquez sur le bouton Sync columns afin de rcuprer le schma du composant prcdent.

Creative Commons License

Composants Talend Open Studio

131

Composants Business
tSalesforceOutputBulkExec

Slectionnez le mode Table afin dafficher les rsultats dexcution dans un tableau. Rptez lopration pour le tLogRow_2. Sauvegardez votre Job et appuyez sur F6 afin de lexcuter. Dans la console de la vue Run, vous pouvez vrifier les rsultats dexcution.

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 dune incompatibilit avec les lments Account auxquels vous avez accd. Si vous souhaitez transformer les donnes dentre avant de les charger, vous devez utiliser un tSalesforceOutputBulk et un tSalesforceBulkExec pour raliser le Job complet. Pour plus dinformations propos de lutilisation de ces deux composants, consultez Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com, page 122.

132

Composants Talend Open Studio

Creative Commons License

Composants Business
tSAPCommit

tSAPCommit
Proprits du tSAPCommit
Ce composant est troitement li aux composants tSAPConnection et tSAPRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Business/SAP

Fonction Objectif

Valide les donnes traites dans un Job, via un serveur connect. 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. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tSAPConnection dans la liste. 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 composan 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.

Basic settings

Release Connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants SAP et notamment avec les composants tSAPConnection et tSAPRollback.. n/a

Scnario associ
Ce composant est troitement li aux composants tSAPConnection et tSAPRollback. Ils sont gnralement utiliss ensemble lors de transactions, avec un tSAPConnection permettant douvrir une connexion pour la transaction en cours. Pour un scnario associ au tSAPCommit, consultez tMysqlConnection page 482.

Creative Commons License

Composants Talend Open Studio

133

Composants Business
tSAPConnection

tSAPConnection
Proprits du tSAPConnection
Famille de composant Business

Fonction Objectif Basic settings

Le composant tSAPConnection ouvre une connexion vers un systme SAP afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers un systme SAP. 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 laide des donnes collectes. Connection configuration Client type : Saisissez votre code de connexion SAP habituel. Userid : Saisissez lidentifiant de connexion utilisateur. Password : Saisissez le mot de passe. Language : Spcifiez la langue. Host name : Saisissez ladresse IP du systme SAP. System number : Saisissez le numro du systme.

Advanced settings

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Utilisation Limitation

Ce composant est gnralement utilis avec les composants SAP. n/a

Scnario associ
Pour un scnario associ, consultez les Scnario 1 : Rcuprer les mtadonnes dun systme SAP, page 136.

134

Composants Talend Open Studio

Creative Commons License

Composants Business
tSAPInput

tSAPInput
Proprits du tSAPInput
Famille de composant Business

Fonction Objectif Basic settings

Le composant tSAPInput se connecte un systme SAP via ladresse IP du systme. Il permet dextraire des donnes dun systme SAP nimporte quel niveau en faisant appel des fonctions RFC ou BAPI. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant connexion de base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Client : Saisissez votre code de connexion SAP habituel. Userid : Saisissez lidentifiant de connexion utilisateur. Password : Saisissez le mot de passe. Language : Spcifiez la langue. Host name : Saisissez ladresse IP du systme SAP. System number : Saisissez le numro du systme. Saisissez le nom de la fonction que vous souhaitez utiliser pour rcuprer les donnes. Configurez les paramtres dentre. Parameter Value : Saisissez entre guillemets les valeurs correspondant au paramtre dfini dans la colonne Parameter Name. Type : Slectionnez le type dentre rcuprer. 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. 135

Connection configuration

Function name Initialize input

Creative Commons License

Composants Talend Open Studio

Composants Business
tSAPInput

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.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis en tant que composant de dbut et requiert un composant de sortie. n/a

Scnario 1 : Rcuprer les mtadonnes dun systme SAP


Les composants SAP (tSAPInput et tSAPOutput) ainsi que lassistant SAP sont bass sur des bibliothques valides et fournies par SAP (JCO) permettant lutilisateur dappeler les fonctions RFC ou BAPI et de rcuprer les donnes du systme SAP au niveau des tables, RFC ou BAPI.
Ce scnario utilise lassistant SAP guidant lutilisateur travers les diffrentes tapes de cration de connexions SAP et des fonctions RFC et BAPI. Lassistant SAP est uniquement disponible pour les utilisateurs Talend Integration Suite. Si vous tes utilisateur de Talend Open Studio ou Talend On Demand, vous devez configurer les proprits du composant tSAPInput manuellement.

Ce scnario Java utilise un assistant SAP pour crer une connexion au systme SAP, appelle une fonction BAPI pour rcuprer les informations dune entreprise stockes dans le systme SAP et les affiche dans Talend Open Studio. Les figures ci-dessous affiche les paramtres du systme SAP permettant daccder aux informations sur lentreprise que nous souhaitons lire dans Talend Open Studio laide du composant tSAPInput.

136

Composants Talend Open Studio

Creative Commons License

Composants Business
tSAPInput

Crez une connexion au systme SAP laide de lassistant SAP. Dans ce scnario, la connexion SAP est appele sap. Appelez la fonction BAPI appele BAPI_COMPANY_GETDETAIL laide de lassistant SAP pour accder au document html BAPI stock dans le systme SAP et consultez les informations sur lentreprise. Dans le champ Name filter, saisissez BAPI* et cliquez sur le bouton Search pour afficher toutes les fonctions BAPI disponibles. Slectionnez BAPI_COMPANY_GETDETAIL pour afficher le schma dcrivant les informations de lentreprise. La vue droite de lassistant 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.

Creative Commons License

Composants Talend Open Studio

137

Composants Business
tSAPInput

La vue Parameter fournit les informations sur les paramtres dentre et de sortie ncessaire la fonction BAPI_COMPANY_GETDETAIL pour retourner les valeurs. Dans la vue Parameter, cliquez sur longlet Input pour lister le ou les paramtre(s) dentre. Dans ce scnario, il ny a quun seul paramtre dentre requis par la fonction BAPI_COMPANY_GETDETAIL. Ce paramtre sappelle COMPANYID.

Dans la vue Parameter, cliquez sur longlet 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.

Chacun des paramtres de structure est compos de nombreux paramtres single.

138

Composants Talend Open Studio

Creative Commons License

Composants Business
tSAPInput

La vue Test it permet dajouter ou de supprimer des paramtres dentre en fonction de la fonction appele. Dans ce scnario, nous souhaitons rcuprer les mtadonnes du paramtre structure appel COMPANY_DETAIL qui est compos de 14 paramtres single.

Dans la colonne Value de la ligne COMPANYID du premier tableau, saisissez 000001 afin de retourner les donnes correspondant lentreprise dont lidentifiant est 000001. Dans la liste Output type en bas de lassistant, slectionnez output.table. Cliquez sur Launch en bas de la vue pour afficher la valeur de chaque paramtre single retourn par la fonction BAPI_COMPANY_GETDETAIL. Cliquez sur Finish pour fermer lassistant et crer la connexion. La connexion sap et la fonction BAPI_COMPANY_GETDETAIL apparaissent sous le noeud SAP Connections du Repository. Pour rcuprer les diffrents schmas de la fonction BAPI_COMPANY_GETDETAIL : Cliquez-droit sur BAPI_COMPANY_GETDETAIL dans le Repository. Slectionnez Retrieve schema dans le menu. Dans lassistant qui souvre, slectionnez les schmas que vous souhaitez rcuprer. Ici, nous slectionnons les deux schmas : COMPANY_DETAIL et RETURN. Cliquez sur Next pour afficher ces diffrents schmas. Cliquez sur Finish. Les deux schmas apparaissent sous la fonction BAPI_COMPANY_GETDETAIL dans le Repository.
Creative Commons License Composants Talend Open Studio 139

Composants Business
tSAPInput

Dans ce scnario, nous souhaitons rcuprer les donnes correspondant lentreprise dont lidentifiant est 000001 pour les rcuprer et les afficher dans Talend Open Studio : Dans le Repository, slectionnez la connexion SAP que vous venez de crer et glissez-la dans lespace 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. Double-cliquez sur le tSAPConnection pour afficher la vue Component :

Si vous avez utiliser 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 nutilisez pas les mtadonnes, slectionnez le mode Built-In et renseignez les champs suivants manuellement. Dans le Repository, slectionnez le schma BAPI_COMPANY_GETDETAIL dans le dossier sap, et glissez-le dans lespace de modlisation, slectionnez tSAPInput dans la liste de composants et cliquez sur OK. Cliquez et dposez les composants tFilterColumns et tLogRow dans lespace de modlisation. Connectez le tSAPConnection au tSAPInput via un lien Trigger > OnSubJobOk. 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.

140

Composants Talend Open Studio

Creative Commons License

Composants Business
tSAPInput

Dans lespace 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 lassistant SAP.

Dans la vue Component, 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. Dans la zone Initialize input, nous pouvons voir les paramtres dentre ncessaires la fonction BAPI_COMPANY_GETDETAIL. Dans la zone Outputs, nous pouvons voir les diffrents schmas de la fonction BAPI_COMPANY_GETDETAIL, notamment le schma COMPANY_DETAIL que nous rcuprons en sortie. Dans lespace de modlisation, slectionnez le composant tLogRow et cliquez sur la vue Component pour paramtrer ses proprits. Pour plus dinformations, consultez tLogRow page 1095 Enregistrez le Job et appuyez sur F6 pour lexcuter.

Creative Commons License

Composants Talend Open Studio

141

Composants Business
tSAPInput

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 lassistant SAP sont bass sur des bibliothques valides et fournies par SAP (JCO) permettant lutilisateur dappeler les fonctions RFC ou BAPI et de rcuprer les donnes du systme SAP au niveau des tables, RFC ou BAPI.
Ce scnario utilise lassistant SAP guidant lutilisateur travers les diffrentes tapes de cration de connexions SAP et des fonctions RFC et BAPI. Lassistant SAP est uniquement disponible pour les utilisateurs Talend Integration Suite. Si vous tes utilisateur de Talend Open Studio ou Talend On Demand, vous devez configurer les proprits du composant tSAPInput manuellement.

Ce scnario Java utilise lassistant 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 Talend Open Studio les diffrentes structures de la table SFLIGHT stocke dans le systme SAP. Crez une connexion au systme SAP laide de lassistant SAP. Dans ce scnario, la connexion SAP est appele sap. Appelez la fonction RFC appele RFC_READ_TABLE laide de lassistant SAP pour accder la table du systme SAP et pour visualiser sa structure. Dans le champ Name filter, saisissez RFC* et cliquez sur le bouton Search pour afficher toutes les fonctions RFC disponibles.

142

Composants Talend Open Studio

Creative Commons License

Composants Business
tSAPInput

Slectionnez RFC_READ_TABLE pour afficher les schmas de cette fonction. La vue droite de lassistant affiche les mtadonnes de la fonction RFC_READ_TABLE et permet de dfinir les paramtres ncessaires. Longlet Document affiche le document html SAP de la fonction RFC_READ_TABLE. Longlet Parameter fournit les informations sur les paramtres requis par la fonction RFC_READ_TABLE pour pouvoir retourner les valeurs des paramtres. Dans la vue Parameter, cliquez sur longlet Table pour obtenir une description de la structure des diffrentes tables de la fonction RFC_READ_TABLE.

Creative Commons License

Composants Talend Open Studio

143

Composants Business
tSAPInput

La vue Test it vous permet dajouter ou de supprimer des paramtres dentre en fonction de la fonction appele. Dans ce scnario, nous voulons rcuprer les diffrentes structures de la table SFLIGHT.

Dans la colonne Value de la ligne DELIMITER du premier tableau, saisissez ; comme sparateur de champ. Dans la colonne Value de la ligne QUERY_TABLE, saisissez SFLIGHT comme table requter. Dans la liste Output type en bas de lassistant, slectionnez output.table. Dans la liste Constructure|Table, slectionnez DATA.

144

Composants Talend Open Studio

Creative Commons License

Composants Business
tSAPInput

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. Cliquez sur Finish pour fermer lassistant et crer la connexion. La connexion sap et la fonction RFC_READ_TABLE apparaissent sous le noeud SAP Connections du Repository. Pour rcuprer les diffrents schmas de la fonction RFC_READ_TABLE : Cliquez-droit sur RFC_READ_TABLE dans le Repository, et slectionnez Retrieve schema dans le menu. Dans lassistant qui souvre, slectionnez les schmas que vous souhaitez rcuprer. Ici, nous slectionnons les trois schmas : DATA, FIELDS et OPTIONS. Cliquez sur Next pour afficher ces diffrents schmas. Cliquez sur Finish. Les trois schmas apparaissent sous la fonction RFC_READ_TABLE dans le Repository.

Dans ce scnario, nous souhaitons rcuprer les donnes et le nom des colonnes de la table SFLIGHT pour les rcuprer et les afficher dans Talend Open Studio. Ainsi, nous nous intressons uniquement au schma DATA et FIELDS : Dans le Repository, slectionnez la fonction RFC_READ_TABLE de la connexion sap et glissez-la dans lespace de modlisation, slectionnez tSAPInput dans la liste de composants et cliquez sur OK. Cliquez et dposez deux composants tLogRow dans lespace de modlisation. Pour connecter les composants entre eux : Cliquez-droit sur le tSAPInput, slectionnez Row puis row_DATA_1 dans le menu et cliquez sur le premier composant tLogRow. Cliquez-droit sur le tSAPInput, slectionnez Row puis row_FIELDS_1 dans le menu et cliquez sur le deuxime composant tLogRow.

Creative Commons License

Composants Talend Open Studio

145

Composants Business
tSAPInput

Dans lespace 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 lassistant SAP. Dans la zone Initialize input, nous pouvons voir les paramtres dentre ncessaires pour la fonction RFC_READ_TABLE, savoir le sparateur de champ ; et le nom de la table SFLIGHT. Dans la zone Outputs, nous pouvons voir les diffrents schmas de la table SFLIGHT, notamment FIELDS et DATA qui sont chacun dirigs vers des flux de sortie diffrents.

146

Composants Talend Open Studio

Creative Commons License

Composants Business
tSAPInput

Dans lespace de modlisation, slectionnez les composants tLogRow et cliquez sur la vue Component pour paramtrer leurs proprits. Pour plus dinformations, consultez tLogRow page 1095 Enregistrez votre Job et appuyez sur F6 pour lexcuter.

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.

Creative Commons License

Composants Talend Open Studio

147

Composants Business
tSAPOutput

tSAPOutput
Proprits du tSAPOutput
Famille de composant Business

Fonction Objectif Basic settings

Le composant tSAPOutput crit dans un systme SAP. Il permet dcrire des donnes dans un systme SAP. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant connexion de base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Client type : Saisissez votre code de connexion SAP habituel. Userid : Saisissez lidentifiant de connexion utilisateur. Password : Saisissez le mot de passe. Language : Spcifiez la langue. Host name : Saisissez ladresse IP du systme SAP. System number : Saisissez le numro du systme. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous effectuez des modifications, le schma passera automatiquement en built-in. Saisissez le nom de la fonction que vous souhaitez utiliser pour rcuprer les donnes. Configurez les paramtres afin de slectionner les donnes crire dans le systme SAP.

Connection configuration

Schema et Edit Schema

Function name Mapping Utilisation

Ce composant est gnralement utilis en tant que composant de sortie et requiert un composant dentre.

148

Composants Talend Open Studio

Creative Commons License

Composants Business
tSAPOutput

Limitation

n/a

Scnarios associs
Pour des scnarios associs, consultez les Scnario 1 : Rcuprer les mtadonnes dun systme SAP, page 136 et Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE, page 142.

Creative Commons License

Composants Talend Open Studio

149

Composants Business
tSAPRollback

tSAPRollback
Proprits du tSAPRollback
Ce composant est troitement li aux composants tSAPCommit et tSAPConnection. Ils sont gnralement utiliss ensemble lors de transactions..
Component family Business/SAP

Function Purpose Basic settings

tSAPRollback annule la transaction dans le SAP connect. tSAPRollback vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tSAPConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case afin de continuer utiliser la connexion slectionne, une fois que le composan a excut sa tche.

Release Connection

Advanced settings Usage Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants SAP et notamment avec les composants tSAPConnection et tSAPCommit. n/a

Scnario associ
Pour un scnario associ au tSAPRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524 du composant tMysqlRollback.

150

Composants Talend Open Studio

Creative Commons License

Composants Business
tSugarCRMInput

tSugarCRMInput
Proprits du tSugarCRMInput
Famille du composant Business

Fonction Objectif Basic settings

Le tSugarCRMInput se connecte un module de la base de donnes SugarCRM via le service Web adquat. Le tSugarCRMInput permet dextraire les donnes dune base de donnes SugarCRM laide dune requte. SugarCRM Webservice URL Module Saisissez lURL du service Web permettant de se connecter la base de donnes SugarCRM. 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 saffichent sont automatiquement remplis avec les noms correspondants. Saisissez les informations dauthentification de lutilisateur au service Web. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits 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. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn. Saisissez la requte permettant de slectionner les donnes extraire. Exemple : account_name= Talend

Username et Password Schema et Edit Schema

Query condition

Utilisation Limitation

Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie est ncessaire. n/a

Scnario: Extraire les donnes dun compte partir de SugarCRM


Ce scnario dcrit un Job deux composants visant extraire les informations dun compte partir dune base de donnes SugarCRM vers un fichier de sortie Excel.

Creative Commons License

Composants Talend Open Studio

151

Composants Business
tSugarCRMInput

A partir de la Palette, cliquez-dposez un composant tSugarCRMInput et un composant tFileOutputExcel. Connectez les composants dentre et de sortie laide dun lien de type Row Main. Dans la vue Component du tSugarCRMInput, remplissez les informations de connexion dans les champs SugarCRM Web Service URL, Username et Password. Slectionnez ensuite le module adquat parmi ceux proposs dans la liste Module. Dans cet exemple, cest 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 navez pas besoin en sortie. 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 Slectionnez ensuite le composant tFileOutputExcel.

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. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.

152

Composants Talend Open Studio

Creative Commons License

Composants Business
tSugarCRMInput

Les donnes filtres sont inscrites en sortie dans la feuille de calcul du fichier Excel spcifi.

Creative Commons License

Composants Talend Open Studio

153

Composants Business
tSugarCRMOutput

tSugarCRMOutput
Proprits du tSugarCRMOutput
Famille du composant Business

Fonction Objectif Basic settings

Le composant tSugarCRMOutput crit dans un module de la base de donnes SugarCRM via le service Web adquat. Le tSugarCRMOutput permet dcrire des donnes dans une base de donnes SugarCRM. SugarCRM Webservice URL Module Saisissez lURL du service Web permettant de se connecter la base de donnes SugarCRM. 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 saffichent sont automatiquement remplis avec les noms correspondants. Saisissez les informations dauthentification de lutilisateur au service Web. Vous pouvez effectuer lune des oprations suivantes sur les donnes du module SugarCRM : Insert : insrer les donnes. Update : mettre les donnes jour. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits 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. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn.

Username et Password Action

Schema et Edit Schema

Utilisation Limitation

Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

154

Composants Talend Open Studio

Creative Commons License

Composants Business
tVtigerCRMInput

tVtigerCRMInput
Proprits du tVtigerCRMInput
Famille du composant Business/tVtigerCR M Le tVtigerCRMInput se connecte un module de la base de donnes vTigerCRM via le service Web adquat. Le tVtigerCRMInput permet dextraire les donnes dune base de donnes tVtigerCRM. Server Address Port Username et Password Version Module Method Saisissez ladresse IP du serveur tVtigerCRM. Saisissez le numro de port daccs au serveur. Saisissez les informations dauthentification de lutilisateur au service Web. Renseignez la version de tVtigerCRM que vous utilisez. Slectionnez le module adquat dans la liste. Slectionnez la mthode adquate dans la liste. Cette mthode permet de dterminer laction appliquer au module tVtigerCRM slectionn. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits 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. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn.

Fonction Objectif Basic settings

Schema et Edit Schema

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie est ncessaire. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

Creative Commons License

Composants Talend Open Studio

155

Composants Business
tVtigerCRMOutput

tVtigerCRMOutput
Proprits du tVtigerCRMOutput
Famille du composant Business/vTigerCRM

Fonction Objectif Basic settings

Le composant tVtigerCRMOutput crit dans un module de la base de donnes vTigerCRM via le service Web adquat. Le tVtigerCRMOutput permet dcrire des donnes dans une base de donnes tVtigerCRM. Server Address Port Username et Password Version Module Method Saisissez ladresse IP du serveur tVtigerCRM. Saisissez le numro de port daccs au serveur. Saisissez les informations dauthentification de lutilisateur au service Web. Renseignez la version de tVtigerCRM que vous utilisez. Slectionnez le module adquat dans la liste. Slectionnez la mthode adquate dans la liste. Cette mthode permet de dterminer laction appliquer au module tVtigerCRM slectionn. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits 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. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn.

Schema et Edit Schema

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

156

Composants Talend Open Studio

Creative Commons License

Composants Custom Code


Ce chapitre passe en revue les principaux composants prsents dans la famille Custom Code de la Palette de Talend Open Studio. La famille Custom Code regroupe tous les composants rpondant un besoin spcifique de cration de code la vole.

Composants Custom Code


tGroovy

tGroovy
Proprits du tGroovy
Famille de composant Custom Code

Fonction Objectif Basic settings

Le tGroovy permet de saisir du code personnalis afin de lintgrer dans le programme Talend. Ce code est excut une seule fois. Le tGroovy permet dtendre les fonctionnalits du Job Talend grce au langage Groovy, qui est une syntaxe simplifie du Java.. Groovy Script Variables Saisissez le code Groovy que vous souhaitez excuter. Ce tableau comprend deux colonnes : Name : nom de la variable appele dans le code. Value : valeur associe cette variable. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

Ce composant peut tre utilis en standalone, ou en tant que sous-job un seul composant. Il est ncessaire de connatre le langage Groovy.

Scnarios associs
Pour un scnario utilisant du Code Groovy, consultez le Scnario : Appeler du code Groovy contenu dans un fichier, page 159. Pour un exemple dutilisation proche dans le mode de fonctionnement, consultez le Scnario : Imprimer le contenu dune variable, page 161 du composant tJava.

158

Composants Talend Open Studio

Creative Commons License

Composants Custom Code


tGroovyFile

tGroovyFile
Proprits du tGroovyFile
Famille de composant Custom Code

Fonction Objectif Basic settings

Le tGroovyFile permet dappeler un script existant dvelopp en Groovy. Le tGroovyFile permet dtendre les fonctionnalits du Job Talend grce au langage Groovy, qui est une syntaxe simplifie du Java.. Groovy File Variables Nom et chemin daccs au fichier contenant votre code Groovy. Ce tableau comprend deux colonnes : Name : nom de la variable appele dans le code. Value : valeur associe cette variable. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

Ce composant peut tre utilis en standalone, ou en tant que sous-job un seul composant. Il est ncessaire de connatre le langage Groovy.

Scnario : Appeler du code Groovy contenu dans un fichier


Ce scnario comprend un composant unique, le tGroovyFile, utilis en standalone. Le Job a pour but dappeler un fichier contenant du code Groovy, afin de retourner dans la Console les informations contenues dans ce fichier. Il se prsente comme suit :

Dans la Palette, ouvrez le dossier Custom_Code, puis glissez-dposez un composant tGroovyFile dans lespace de modlisation graphique. Double-cliquez sur le composant afin dafficher sa vue Component.

Creative Commons License

Composants Talend Open Studio

159

Composants Custom Code


tGroovyFile

Dans le champ Groovy File, saisissez le chemin daccs au fichier contenant votre Code Groovy, ou parcourez votre rpertoire. Dans le tableau Variables, ajoutez une ligne, en appuyant sur le bouton [+]. Dans la colonne Name, saisissez age, puis, dans, la colonne Value, saisissez 50, comme dans la capture dcran.

Appuyez sur F6 pour sauvegarder et excuter votre Job. La Console affiche les informations contenues dans le fichier dentre, auxquelles sajoute le rsultat de la variable.

160

Composants Talend Open Studio

Creative Commons License

Composants Custom Code


tJava

tJava
Proprits du tJava
Famille de composant Custom Code

Fonction Objectif Basic settings

Le tJava permet de saisir du code personnalis afin de lintgrer dans le programme Talend. Ce code est excut une seule fois. Le tJava permet dtendre les fonctionnalits du Job Talend grce au langage Java. Code Saisissez le code Java que vous souhaitez excuter. Pour plus dinformations concernant la syntaxe des fonctions Java spcifiques Talend, consultez laide en ligne de Talend Open Studio dans le menu Help Contents > Developer Guide > API Reference. Pour la rfrence Java complte, allez sur : http://java.sun.com/javaee/6/docs/api/

Utilisation Limitation

Ce composant est gnralement utilis en tant que sous-job un seul composant. Il est ncessaire de connatre le langage Java.

Scnario : Imprimer le contenu dune variable


Le scnario suivant est une simple dmonstration de lapplication possible du composant tJava. Lobjectif de ce Job est dimprimer les lignes traites laide dune commande Java et des variables globales fournies dans Talend Open Studio.

Cliquez et dposez les composants dans lespace de modlisation : tFileInputDelimited, tFileOutputExcel, tJava. Connectez le composant tFileInputDelimited au tFileOutputExcel laide dune 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.
Creative Commons License Composants Talend Open Studio 161

Composants Custom Code


tJava

Ensuite, connectez le composant tFileInputDelimited au composant tJava laide dun lien de type Then Run. Ce lien met en place un squenage ordonnant au tJava de se lancer la fin du processus principal. Dfinissez les paramtres du composant tFileInputDelimited dans longlet Basic settings de la vue Component. Le fichier dentre utilis en exemple est un simple fichier texte deux colonnes : Name (des noms de personnes) et leur Emails respectifs.

Pour cet exemple, le schma na pas t centralis dans le rfrentiel, vous devez donc configurer manuellement le schma de ces deux colonnes. Cliquez sur le bouton Edit Schema.

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 naurez donc pas dfinir le schma de nouveau. Paramtrez le fichier de sortie afin quil reoive le contenu du fichier dentre sans modifications. Si le fichier nexiste 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. Puis slectionnez le composant tJava pour dfinir la commande Java excuter.
162 Composants Talend Open Studio Creative Commons License

Composants Custom Code


tJava

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, nous utilisons la variable NB_Line. Pour accder la liste des variables globales, appuyez sur Ctrl + Espace de votre clavier et slectionnez la variable globale correspondante. Enregistrez le Job et appuyez sur F6 pour lexcuter.

Le contenu est donc transmis au fichier Excel spcifi et le nombre de lignes traites est affich dans la console Run.

Creative Commons License

Composants Talend Open Studio

163

Composants Custom Code


tJavaFlex

tJavaFlex
Proprits du tJavaFlex
Famille de composant Custom Code

Fonction

Le tJavaFlex permet de saisir du code personnalis afin de lintgrer 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 dexcuter une opration souhaite et non disponible dans les actuels composants Talend. Le tJavaFlex permet dtendre les fonctionnalits du Job Talend grce au langage Java. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Data Auto Propagate Cochez cette case pour propager automatiquement les donnes au composant suivant. Lorsque vous cochez cette case, les donnes rcupres ne peuvent tre transformes a posteriori dans le champ Main code Saisissez le code Java qui va tre appel lors de la phase dinitialisation. Saisissez le code Java qui va tre appliqu pour chaque ligne du flux. Saisissez le code Java qui va tre appel lors de la phase de clture. Saisissez le code Java permettant dimporter, si ncessaire, la librairie externe utilise dans le champ Main code de longlet Basic settings. Cochez cette case pour collecter les donnes de log au niveau du composant.

Objectif Basic settings

Start code Main code End code Advanced settings Import

tStatCatcher Statistics

164

Composants Talend Open Studio

Creative Commons License

Composants Custom Code


tJavaFlex

Utilisation Limitation

Ce composant peut tre utilis en tant que composant de dbut, de milieu et de fin de Job, ainsi quen tant que sous-job un seul composant. 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.

Cliquez-glissez un composant tJavaFlex de la famille Custom Code et un composant tLogRow de la famille Logs & Errors dans le Job Designer. Connectez-les via un lien Row Main. Double-cliquez sur le composant tJavaFlex pour paramtrer ses proprits.

Dans la liste Schema Type, slectionnez le mode Built-in et cliquez sur le bouton [...] cot du champ Edit schema pour dcrire manuellement la structure des donnes passer au composant suivant.

Creative Commons License

Composants Talend Open Studio

165

Composants Custom Code


tJavaFlex

Cliquez sur le bouton [+] pour ajouter deux colonnes : key de type Integer et value de type String. Cliquez Ok pour valider les changements et fermer la bote de dialogue. Dans les proprits du tJavaFlex, cochez la case Data Auto Propagate pour propager automatiquement les donnes au composant suivant. Dans cet exemple, nous neffectuons pas de transformation sur les donnes rcupres. Dans le champ Start code, saisissez le code qui sera excut lors de la phase dinitialisation. Ici, le code indique linitialisation 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++) {

Dans le champ Main code, saisissez le code qui sera appliqu pour chaque ligne de donnes. Ici, nous souhaitons retourner chaque cl (key) avec sa valeur : row1.key = i; row1.value = valueArray[i];
Dans le champ Main code, row1 correspond au nom du lien qui sort du tJavaFlex. Si vous renommez ce lien, il faut penser modifier le code de ce champ.

166

Composants Talend Open Studio

Creative Commons License

Composants Custom Code


tJavaFlex

Dans le champ End code, saisissez le code qui sera excut lors de la phase de clture. Ici, laccolade ferme la boucle et le code indique la fin de lexcution du tJavaFlex en affichant le message END : } System.out.println("#\n## END"); Assurez-vous que le schma a bien t propag au tLogRow. Enregistrez le Job et appuyez sur F6 pour lexcuter.

La console affiche les trois civilits, ainsi que leur cls correspondantes.

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.

Cliquez-glissez un composant tRowGenerator de la famille Misc et un composant tJavaFlex de la famille Custom Code dans le Job Designer. Connectez-les via un lien Row Main. Double-cliquez sur le composant tRowGenerator pour ouvrir son diteur.

Creative Commons License

Composants Talend Open Studio

167

Composants Custom Code


tJavaFlex

Dans lditeur, cliquez sur le bouton [+] pour ajouter quatre colonnes : number, txt, date et flag. Dfinissez le schma en paramtrant ces quatres colonnes conformment la capture dcran prcdente. Dans la colonne Functions, slectionnez la fonction [...] dans la liste de chaque colonne. 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 lexcution du tRowGenerator. Cliquez sur OK. Double-cliquez sur le composant tJavaFlex pour paramtrer ses proprits.

Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Dans le champ Start code, saisissez le code qui sera excut lors de la phase dinitialisation. Ici, le code indique linitialisation 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;

168

Composants Talend Open Studio

Creative Commons License

Composants Custom Code


tJavaFlex

Dans le champ Main code, saisissez le code qui sera appliqu pour chaque ligne de donnes. Ici, nous souhaitons indiquer le numro de la ligne en partant de 0, puis afficher le numro et le texte alatoire que nous mettons en majuscules et la date alatoire dfinis dans le tRowGenerator. Ensuite, nous crons une condition affichant si le status est true (vrai) ou false (faux) et nous incrmentons 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.

Dans le champ End code, saisissez le code qui sera excut lors de la phase de clture. Ici, le code indique la fin de lexcution du composant tJavaFlex en affichant le message END : System.out.println("#\n## END"); Enregistrez votre Job et appuyez sur F6 pour lexcuter.

Creative Commons License

Composants Talend Open Studio

169

Composants Custom Code


tJavaFlex

La console affiche les donnes gnres alatoirement et modifies laide du code Java dans le tJavaFlex.

170

Composants Talend Open Studio

Creative Commons License

Composants Custom Code


tJavaRow

tJavaRow

Proprits du tJavaRow
Famille de composant Custom Code

Fonction

Le tJavaRow permet de saisir du code personnalis afin de lintgrer dans le programme Talend. Avec le tJavaRow, vous pouvez saisir le code Java qui va tre appliqu pour chaque ligne du flux. Le tJavaRow permet dtendre les fonctionnalits du Job Talend grce au langage Java. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Code Saisissez le code Java qui va tre appliqu pour chaque ligne du flux. Saisissez le code Java permettant dimporter, si ncessaire, la librairie externe utilise dans le champ Main code de longlet Basic settings. Cochez cette case pour collecter les donnes de log au niveau du composant.

Objectif Basic settings

Advanced settings

Import

tStatCatcher Statistics Utilisation Limitation

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. Il est ncessaire de connatre le langage Java.

Scnario associ
Aucun scnario nest disponible pour ce composant.

Creative Commons License

Composants Talend Open Studio

171

Composants Custom Code


tLibraryLoad

tLibraryLoad

Proprits du tLibraryLoad
Famille de composant Custom Code

Fonction Objectif Basic settings

Le tLibraryLoad permet dimporter une librairie. Le tLibraryLoad permet de charger des librairies Java utilisables dans un Job. 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. Lib Paths : Saisissez entre guillemets le chemin daccs votre librairie. Saisissez le code Java permettant dimporter, si ncessaire, la librairie externe utilise dans le champ Main code de longlet Basic settings. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings

Dynamic Libs Import

tStatCatcher Statistics Utilisation Limitation

Ce composant peut tre utilis en standalone, mais il est plus logique de lutiliser dans un Job. n/a

Scnario : Vrifier le format dune adresse e-mail


Ce scnario comprend deux composants, un tLibraryLoad et un tJava. Le but de ce scnario est de vrifier le format dune adresse e-mail et de retourner si elle est valide ou non.

Dans la Palette, ouvrez le dossier Custom_Code, puis glissez-dposez les composants tLibraryLoad et tJava dans lespace de modlisation graphique.
172 Composants Talend Open Studio Creative Commons License

Composants Custom Code


tLibraryLoad

Reliez le tLibraryLoad au tJava laide dun lien Trigger > OnSubjobOk. Double-cliquez sur le tLibraryLoad pour afficher sa vue Basic settings. Dans la liste Library, slectionnez jakarta-oro-2.0.8.jar. Dans le champ Import, de longlet Advanced settings, saisissez import org.apache.oro.text.regex.*;

Double-cliquez sur le composant tJava pour afficher sa vue Component. Dans longlet des Basic settings, saisissez votre code, comme dans la capture dcran. Ce code permet de vrifier si une chane de caractres correspond une adresse e-mail, en se basant sur lexpression rgulire suivante : "^[\\w_.-]+@[\\w_.-]+\\.[\\w]+$".

Appuyez sur F6 afin denregistrer et dexcuter votre Job.

Creative Commons License

Composants Talend Open Studio

173

Composants Custom Code


tLibraryLoad

La Console affiche false, cest--dire que ladresse e-mail nest pas valide. En effet, son format nest pas correct.

174

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille Data Quality de la Palette de Talend Open Studio. La famille Data Quality regroupe les composants vous permettant damliorer la qualit de vos donnes. Ces composants couvrent divers besoin dont la comparaison de colonnes afin den extraire des donnes spcifiques.

Composants Data Quality


tAddCRCRow

tAddCRCRow
Proprits du tAddCRCRow
Famille de composant Data Quality

Fonction Objectif Basic settings

Ce composant calcule une cl de substitution base sur une ou plusieurs colonne(s) et lajoute au schma dfini. Fournir un ID unique afin damliorer la qualit des donnes traites. Schema et Edit Schema Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Implication Cochez la case correspondant aux colonnes dfinir comme cl de substitution et vrifier l'intgrit de leurs donnes. Slectionnez la longueur CRC. Plus le CRC est long, moins il y aura de risque derreur. Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.

Advanced settings

CRC type tStatCatcher Statistics

Utilisation Limitation

Ce composant est une tape intermdiaire. Cela requiert un flux entrant et une sortie. n/a

Scnario : Ajouter une cl de substitution un fichier


Ce scnario dcrit un Job ajoutant une cl de substitution un schma de fichier dlimit.

Glissez les composants suivants dans lespace de modlisation: tFileInputDelimited, tAddCRCRow et tLogRow.

176

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tAddCRCRow

Connectez-les en utilisant un lien de type Main row. Dans la vue Component du tFileInputDelimited, renseignez le champ File Name en saisissant le chemin daccs votre fichier, ainsi que toutes les proprits en rapport, au cas o elles ne soient pas stockes dans le Repository.

Crez le schma en cliquant sur le bouton Edit Schema, si le schma nest pas encore stock dans le Repository. En Java, vrifiez la colonne du type de donnes, et pour remplir le Date pattern, visitez http://java.sun.com/j2se/1.5.0/docs/api/index.html. Dans la vue Component du composant tAddCRCRow, slectionnez les cases de la colonne du flux entrant utiliser pour calculer le CRC.

Notez quune colonne CRC (en lecture seule) a t ajoute la fin du schma. Dans les Advanced Settings, slectionnez CRC32 comme CRC Type pour avoir une cl de substitution plus longue.

Dans la vue du tLogRow des Basic settings, slectionnez la case Print values in cells of a table pour afficher les donnes de sortie dans une table de la Console.

Creative Commons License

Composants Talend Open Studio

177

Composants Data Quality


tAddCRCRow

Sauvegardez votre Job et appuyer sur F6 pour lexcuter.

Une colonne CRC supplmentaire a t ajoute au schma, calcule daprs toutes les colonnes prcdemment slectionnes (dans ce cas toutes les colonnes du schma).

178

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tExtractRegexFields

tExtractRegexFields
Le tExtractRegexFields appartient deux familles : Data Quality et Processing. Pour plus dinformations concernant le composant tExtractRegexField, consultez tExtractRegexFields, page 1201.

Creative Commons License

Composants Talend Open Studio

179

Composants Data Quality


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. Le tFuzzyMatch permet dassurer la qualit des donnes de nimporte quelle source de donnes en la comparant avec une source de donnes de rfrence. Schema et Edit Schema Un schma est une description de lignes, i.e., 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. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Matching type Slectionnez lalgorithme de correspondance appropri parmi les suivants : Levenshtein : Bas sur la thorie de la distance ddition. Il calcule le nombre dinsertion, de suppression ou de substitution ncessaire pour correspondre la rfrence. Metaphone : Bas sur la phontique. Tout dabord, 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 lalgorithme phontique Metaphone, qui produit des rsultats plus prcis que lalgorithme original. Il peut retourner la fois un code primaire et secondaire pour une chane de caractres. Pour viter toute ambigut que le Metaphone naurait pas pu dtecter, utilisez cette option.

Objectif

Basic settings

180

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tFuzzyMatch

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. (Levenshtein uniquement) Dfinissez le nombre maximum de modificiations pouvant correspondre la rfrence. Slectionnez la colonne du flux principal qui doit tre compare avec la colonne cl du flux de rfrence (Lookup). Cochez cette case pour obtenir la meilleure correspondance possible, si plusieurs correspondances sont disponibles. Si plusieurs correspondances sont disponibles, elles seront toutes affiches sauf si la case Unique match est coche. Dfinissez le dlimiteur entre chaque correspondance.

Max Distance

Matching Column

Unique Matching

Matching item separator

Utilisation Limitation/Conditions requises

Ce composant nest pas un composant de dbut (fond vert) et il ncessite deux composants dentre et un composant de sortie. Utilisateurs Perl : Assurez-vous que le package correspondant est install sur votre ordinateur. Consultez la vue Module pour connatre les modules installer.

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 ddition comprise entre les colonnes First Name (prnom) dun fichier dentre 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.

Cliquez et dposez les composants suivants de la Palette dans lespace de modlisation : tFileInputDelimited (x2), tFuzzyMatch et tFileOutputDelimited. Paramtrez les proprits du composant tFileInputDelimited partir de longlet Basic settings. Parcourez votre rpertoire et slectionnez le fichier dentre analyser. Mais surtout dfinissez le schma utiliser par le flux vrifier. Dans le schma, dfinissez le Type de donnes en version Java, surtout si vous tes en mode Built-in.

Creative Commons License

Composants Talend Open Studio

181

Composants Data Quality


tFuzzyMatch

Connectez ce composant dentre au tFuzzyMatch laide dune connexion de type Main Row. Dfinissez le deuxime composant tFileInputDelimited de la mme manire.
Assurez-vous que la colonne de rfrence a bien t dfinie comme colonne cl dans le schma du flux de rfrence (lookup).

Puis connectez le deuxime composant dentre au tFuzzyMatch laide dune connexion main row (qui apparat comme une connexion Lookup row dans lespace de modlisation). Dfinissez les proprits du tFuzzyMatch dans longlet Basic settings. Le Schma doit correspondre celui du flux dentre 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. 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. Ensuite dfinissez la distance. Dans cette mthode, la distance est le nombre de caractres modifis (insertion, suppression ou substitution) pour que lentre principale corresponde exactement lentre de rfrence.

182

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tFuzzyMatch

Dans ce scnario, nous souhaitons que la distance soit de 0 en minimum et en maximum dans les champs Min. distance et Max. distance. Ce qui signifie que seule une correspondance exacte sera redirige en flux de sortie. Dcochez la case Case sensitive pour ne pas prendre en compte la casse. Et dans le champ Matching column, slectionnez la colonne du flux principal qui doit tre vrifie. Dans cet exemple, le prnom (First name). Ne cochez pas la case Unique matching et ne modifiez pas le sparateur. Connectez le tFuzzyMatch un composant de sortie standard type tLogRow. Ne dfinissez aucun autre paramtre que le dlimiteur pour ce scnario. Enregistrez le Job et appuyez sur la touche F6 pour excuter le Job.

Comme la distance ddition 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 page 183.

Scnario 2 : Distance de Levenshtein de 1 ou 2 pour les prnoms


Ce scnario est bas sur le scnario 1 dcrit ci-dessus. Seuls les paramtres distance min. et max. du composant tFuzzyMatch sont modifis, ce qui modifiera la sortie affiche. Dans la vue Component du tFuzzyMatch, modifiez la distance min. de 0 1. Ceci exclut directement les correspondances exactes (qui ont une distance de 0). Maintenant mettez une distance max. de 2 puisque la distance max. ne peut tre infrieure la distance min. La sortie correspond toutes les donnes mises en correspondance contenant une diffrence de 2 caractres au plus.

Creative Commons License

Composants Talend Open Studio

183

Composants Data Quality


tFuzzyMatch

Aucune autre modification de paramtres nest ncessaire. Assurez-vous que le sparateur de champs (Matching item separator) est bien dfini, vu que plusieurs entres de rfrence peuvent correspondre lentre du flux principal. Enregitrez votre nouveau Job et appuyez sur F6 pour lexcuter.

Etant donn que la distance ddition a t dfinie 2, certaines entres du flux principal correspondent plusieurs entres de rfrence (lookup). Vous pouvez utiliser une autre mthode, la Mtaphone, pour valuer la distance entre le flux principal et le flux de rfrence.

Scnario 3 : Distance mtaphonique pour les prnoms


Ce scnario est bas sur le scnario 1 dcrit plus haut.

Modifiez le champ Matching type avec loption Metaphone. Aucune distance minimum et aucune distance maximum ne sont dfinir puisque cette mthode est base sur les diffrences de phontique avec la rfrence.

184

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tFuzzyMatch

Enregistrez le Job et appuyez sur F6. La valeur phontique est affiche avec les correspondances possibles.

Creative Commons License

Composants Talend Open Studio

185

Composants Data Quality


tIntervalMatch

tIntervalMatch
Proprits du tIntervalMatch
Famille de composant Data Quality

Fonction

Le composant tIntervalMatch permet dtablir une jointure entre un flux principal et un flux de rfrence (en Java) ou un fichier de rfrence (en Perl). 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. Il aide retourner une valeur laide dune jointure. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous effectuez des modifications, le schma passera automatiquement en Built-in. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Java only Search column Slectionnez la colonne du flux principal contenant les valeurs qui doivent tre mises en correspondance avec lintervalle de valeurs.

Objectif Basic settings

Column (LOOKUP) Slectionnez la colonne du flux lookup contenant les valeurs qui doivent tre retournes quand la jointure est ok. Lookup Column min/ bounds strictly (min) Lookup Column max/ bounds strictly (max) Utilisation Limitation Slectionnez la colonne contenant la valeur minimale de lintervalle. Cliquez sur la case si la limite est stricte. Slectionnez la colonne contenant la valeur maximale de lintervalle. Cliquez sur la case si la limite est stricte

Ce composant manipule un flux de donnes, il requiert donc un Input et un Output, et ncessite la dfinition dune tape intermdiaire. n/a

Les proprits en Perl sont trop diffrentes de celles en Java, elles sont donc dcrites dans le tableau ci-dessous..
PERL basic settings

186

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tIntervalMatch

Basic settings

Schema et Edit Schema

Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous effectuez des modifications, le schma passera automatiquement en Built-in. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.

Perl only

File Name

Saisissez le nom du fichier contenant lintervalle de donnes. Cela fonctionne comme un flux lookup. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) sparant les lignes. Position de la colonne min dans le fichier lookup: 0 pour la premire colonne, 1 pour la seconde colonne, etc. Vrifiez que les colonnes min et max de lintervalle soient adjacentes. Slectionnez la colonne du flux principal contenant les valeurs qui doivent tre mises en correspondance avec lintervalle de valeurs.

Field separator Row separator Lookup index Column

Search column

Usage Limitation

Ce composant manipule un flux de donnes, il requiert donc un Input et un Output, et ncessite la dfinition dune tape intermdiaire. . Pour le moment, la version Perl du tIntervalMatch naccepte pas un vrai flux lookup (mais seulement un fichier de rfrence dans les paramtres actuels du composant).

Scnario : Identifier le pays partir de lIP (Perl et Java)


Le scnario suivant dcrit un Job conu paralllement dans les deux langages, Perl et Java. Dans ce Job, un flux principal entrant transmet un schma deux colonnes: Documents et IP, contenant des donnes factices. Un second fichier est utilis comme flux lookup en Java, comme fichier de rfrence en Perl, et contient une liste classe dintervalles dIP ainsi que le pays qui leur correspond. Ce Job a pour but de retrouver les pays de chaque document partir de la valeur de leur IP, en dautres termes, de crer une jointure entre le flux principal et le flux de rfrence.

Creative Commons License

Composants Talend Open Studio

187

Composants Data Quality


tIntervalMatch

En Perl, le Job requiert un tFileInputDelimited, un tIntervalMatch et un tLogRow.

En Java, le Job requiert un tFileInputDelimited supplmentaire, un tIntervalMatch et un tLogRow. Glissez le composant dans lespace de modlisation. Configurez les paramtres de base dans la vue Component du tFileInputDelimited.

Le schma se compose de deux colonnes, respectivement Document et IP. (En Java uniquement) Configurez la colonne Type en String pour la colonne Document et en Integer pour la colonne IP. (En Java uniquement) Configurez maintenant les proprits du deuxime tFileInputDelimited.

188

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tIntervalMatch

(En Java uniquement) Noubliez pas de dfinir le Type des donnes. (En Java et en Perl) Propagez le schma du flux principal entrant au composant tIntervalMatch.

(En Java et en Perl) Notez que le schma Output du composant tIntervalMatch est en lecture seule et est compos du schma de lInput ainsi que dune colonne supplmentaire lookup qui redirigera en sortie les donnes lookup demandes. Configurez les autres proprits du composant tIntervalMatch. (En Perl uniquement), le fichier lookup est dfini directement dans les proprits du tIntervalMatch.

(En Perl uniquement) Dans le champ File Name, renseignez le chemin daccs au fichier lookup. Renseignez le Row et le Field separator du fichier lookup. (En Perl uniquement) Dans le champ Lookup column index, paramtrez la limite infrieure de lintervalle des donnes. Cela correspond la position de la colonne contenant la valeur minimum de lintervalle (0 pour la premire colonne). (En Perl uniquement) Il ny a pas besoin de configurer les valeurs lookup retourner puisque toutes les valeurs du fichier lookup seront transmises en sortie.

Creative Commons License

Composants Talend Open Studio

189

Composants Data Quality


tIntervalMatch

(En Java uniquement) Configurez les autres proprits du tIntervalMatch, notamment les colonnes min et max correspondant aux limites de lintervalle.

(En Java uniquement) Dans le champ Column Lookup, slectionnez la colonne dans laquelle les valeurs devront tre retournes. (En Java et en Perl) Dans le champ Search column, slectionnez la colonne du flux principal contenant les valeurs qui devront correspondre aux valeurs de lintervalle. (En Java et en Perl) Le composant tLogRow ne requiert pas de configuration particulire pour ce Job. Les Jobs en Perl et en Java crivent le mme rsultat avec des lgres diffrences dans la prsentation.

Le rsultat en Perl inclut lintervalle de valeurs alors que la sortie Java inclut seulement les valeurs demandes retournes (pays).

190

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tParseAddress

tParseAddress
Proprits du tParseAddress
Famille de composant Data Quality

Fonction Objectif Basic settings

Ce composant analyse les adresses dans une colonne dfinie du schma et les dcoupe par types de champs. Dcouper les donnes en diffrentes colonnes pour trier les diffrentes parties afin damliorer la qualit des donnes traites. Schema et Edit Schema Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Column to parse Country Slectionnez la colonne dont vous souhaitez analyser et dcomposer les donnes. Slectionnez le pays do proviennent les clients. Cochez cette case pour que le composant corrige la casse, cest--dire quil mette, au besoin, une majuscule en dbut de nom, et le reste en minuscules. Cochez cette case pour commencer par supprimer les caractres non alphanumriques avant d'essayer de dcomposer les adresses. Cochez cette case pour abrger automatiquement le nom des rgions ou provinces. Si le nom est dj sous sa forme abrg, il ne sera pas modifi. Cochez cette case pour nautoriser que les noms de rgions ou provinces abrgs. Le traitement des donnes sera plus rapide et vrifiera que ladresse correspond bien aux standards postaux. Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.

Advanced settings

Correct case

Auto clean

Abbreviate subcountry Allow only abbreviated subcountry tStatCatcher Statistics Utilisation Limitation

Ce composant est une tape intermdiaire. Cela requiert un flux entrant et une sortie. n/a

Creative Commons License

Composants Talend Open Studio

191

Composants Data Quality


tParseAddress

Scnario associ
Aucun scnario nest disponible pour ce composant.

192

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tParseName

tParseName
Proprits du tParseName
Famille de composant Data Quality

Fonction Objectif

Ce composant rcupre des noms sous diffrentes formes et en extrait chaque lment en fonction de son type. Analyser un fichier contenant des noms et en extraire les lments selon leur type, afin damliorer la qualit des donnes traites, en rejetant les lments errons. Schema et Edit Schema Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Column to parse Slectionnez la colonne dont vous souhaitez extraire les diffrents lments. Cochez cette case pour ignorer les donnes contenant des noms joints. Cocher cette option permet un gain de rapidit. Dcochez-la pour que ces donnes soient retournes et dcoupes par type. Cochez cette case pour que les noms entrs en ordre invers soient traits. Le composant remet le nom dans lordre, et effectue lanalyse normale. Notez que si le nom peut tre analys, son ordre originel nest pas enregistr comme proprit. Cochez cette case afin de pouvoir utiliser tous les titres possibles. Si vous la dcochez, vous ne pourrez utiliser que les titres standards. Cochez cette case pour que le composant corrige la casse, cest--dire quil mette, au besoin, une majuscule en dbut de nom, et le reste en minuscules. Cochez cette case pour commencer par supprimer les caractres non alphanumriques avant d'essayer de dcomposer les adresses.

Basic settings

Advanced settings

Ignore joint names. Mr John Smith and Ms Mary Jones -> Mr John Smith Allow reversed. Smith, Mr AB -> Mr AB Smith

Extend titles

Correct case

Auto clean

Creative Commons License

Composants Talend Open Studio

193

Composants Data Quality


tParseName

tStatCatcher Statistics Utilisation Limitation

Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.

Ce composant est une tape intermdiaire. Cela requiert un flux entrant et une sortie. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

194

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tReplaceList

tReplaceList
Proprits du tReplaceList
Famille de composant Data Quality

Fonction Objectif Basic settings

Le tReplaceList effectue un rechercher/remplacer dans les colonnes dentre spcifies en fonction des donnes de rfrence (lookup). Ce composant permet de nettoyer tous les fichiers avant un traitement futur. Schema et Edit Schema Un schma est une description de lignes, i.e., 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, Value et Match sont automatiquement ajouts au schma de sortie. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Lookup search column Saisissez le numro de la colonne sur laquelle effectuer la recherche dans le schma de lookup. 0 : la premire colonne lue 1 : la deuxime colonne lue n : numro de la colonne dans le schma lu.

Afin de sassurer que les valeurs cherches sont uniques, assurez-vous que la colonne soit dfinie comme cl dans votre schma de lookup. Lookup replacement Saisissez le numro de la colonne dans laquelle column les valeurs de remplacement sont stockes. 0 : la premire colonne lue 1 : la deuxime colonne lue n : numro de la colonne dans le schma lu Column options Utilisation Slectionnez les colonnes du flux principal dans lequel le remplacement est effectu.

Ce composant est un composant intermdiaire, il ncessite un composant dentre et un composant de sortie.

Creative Commons License

Composants Talend Open Studio

195

Composants Data Quality


tReplaceList

Scnario : Remplacement partir dun fichier de rfrence


Le Job suivant effectue un rechercher/remplacer sur une liste dEtats avec leur code correspondant. Les codes correspondant sont extraits dun fichier de rfrence plac en flux Lookup dans le Job. Le flux principal est dupliqu et les deux sorties sont affiches dans la console, pour constater ltat du flux principal avant et aprs remplacement.

Cliquez et dposez les composants suivants de la Palette : tMysqlInput, tFileInputDelimited, tReplicate, tReplaceList et tLogRow (x2). Notez que si vos schmas dentre sont dj centraliss sur le Repository, vous pouvez, dun simple cliquer-dposer, les faire passer du noeud correspondant du rpertoire Metadata du Repository vers lespace de modlisation. Cela permettra de rcuprer automatiquement les proprits des composants dentre. Pour plus dinformations, consultez Dposer des composants du rpertoire Metadata du Guide utilisateur de Talend Open Studio. Connectez les composants laide de liens Main Row via un clic-droit sur chaque composant. Notez que le lien de type main row provenant du flux de rfrence (tFileInputDelimited) se nomme lookup row. Slectionnez le composant tMysqlInput et dfinissez les paramtres du flux dentre.

Le schma dentre est compos de deux colonnes : Names, States. La colonne States regroupe le nom des Etats des Etats-Unis qui seront remplacs par leur code respectif.
196 Composants Talend Open Studio Creative Commons License

Composants Data Quality


tReplaceList

Dans le champ Query, assurez-vous que la colonne State est incluse dans la dclaration Select. Dans cet exemple, toutes les colonnes sont slectionnes. Vrifiez les paramtres du composant tReplicate. Le schma est simplement divis en deux flux identiques, mais aucun changement na t effectu sur le schma. Puis double-cliquez sur le composant tFileInputDelimited, pour paramtrer le fichier de rfrence.

Le fichier comporte deux colonnes : Postal et State. Postal correspond au code postal de lEtat de la colonne State correspondante. Les champs sont dlimits par des point-virgules et les lignes par des retours charriot. Modifiez le schma du flux lookup.

Assurez-vous que la colonne lookup sur laquelle est effectue la recherche (dans cet exemple : State) est dfinie comme cl, pour sassurer que les donnes cherches sont uniques. Slectionnez le composant tReplaceList et paramtrez lopration effectuer. Le schma est rcupr partir du composant prcdent dans le flux principal.

Creative Commons License

Composants Talend Open Studio

197

Composants Data Quality


tReplaceList

Dans le champ Lookup search index, renseignez la position de la colonne sur laquelle est effectue la recherche. Dans cet exemple, State est la deuxime colonne du fichier dentre lookup. Ainsi, saisissez 1 dans ce champ. Dans le champ Lookup replacement index, renseignez le numro de la colonne contenant les valeurs de remplacement, dans cet exemple : Postal pour le code postal de lEtat. Dans le tableau Column options, slectionnez la colonne States puisque dans cet exemple le nom des Etats doit tre remplac par leur code correspondant. Pour les deux composants tLogRow, cochez la case Print values in table cells pour que les sorties soient plus claires. Enregistrez le Job et excutez-le.

Le premier flux de sortie affiche la colonne States avec les noms des Etats puisquil provient du flux dentre principal. Le deuxime flux affiche la colonne States aprs que le nom des Etats aient t remplacs par leur codes postaux respectifs.

198

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tSchemaComplianceCheck

tSchemaComplianceCheck
Proprits du tSchemaComplianceCheck
Famille de composant Fonction Data Quality

Ce composant valide toutes les lignes dentre en fonction du schma de rfrence ou vrifie le type, la nullabilit, la longueur de la ligne en fonction des valeurs de rfrence. Cette validation peut tre applique lensemble des lignes ou une partie seulement. Le tSchemaComplianceCheck permet dassurer la qualit des donnes de nimporte quelle source de donnes en les comparant aux donnes de rfrence. Base Schema et Edit Schema Un schma est une description de lignes, i.e., 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. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur Talend Open Studio. Java uniquemen t Use another schema for compliance check Dfinissez un schma de rfrence en donnant aux donnes les proprits quelles sont censes avoir. Ainsi, les donnes non conformes seront rejetes. Ces proprits peuvent correspondre au type de donnes, aux valeurs nulles, et/ou la longueur des donnes. Pour la validation du format de date du type 25 Dec 2007, utilisez le champ Date Language et pour distinguer lordre daffichage du mois et du jour, utilisez le champ Date format. Cochez cette case, si vous souhaitez effectuer la vrification sur toutes les colonnes du schma de base. En Perl, cochez la case de la colonne dont vous souhaitez vrifier les donnes en fonction du schma de base dfini. En Java, slectionnez les proprits que les donnes doivent avoir. Cette validation est obligatoire pour toutes les colonnes. Cochez la case pour vrifier la nullabilit dune colonne en fonction de la dfinition du schma de base. Cochez la case pour vrifier la longueur des donnes en fonction de la longueur dfinie dans le schma de base.

Objectif Basic settings

Perl uniquemen t

Date language/ Date format

Check all columns from schema Type

Null (empty or zero) Max length

Creative Commons License

Composants Talend Open Studio

199

Composants Data Quality


tSchemaComplianceCheck

Utilisation

Ce composant est un composant intermdiaire permettant dexclure les donnes non conformes du flux principal. Ce composant ne peut tre utilis comme composant de dbut puisquil requiert un flux dentre. 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 dinformations, consultez Rejects du Guide utilisateur de Talend Open Studio.

Scnario : Valider les dates en fonction dun schma (java)


Ce scnario trs basique permet de vrifier le type, la nullabilit et la longueur des donnes du flux dentre en fonction du schma de rfrence dfini. Le flux dentre provient dun 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 les colonnes nacceptant pas de valeurs nulles en contiennent.

La sortie est duplique : les donnes valides sont regroupes dans un mme fichier dlimit, alors que les donnes rejetes sont affiches dans la console.

Cliquez et dposez les composants suivants : tFileInputDelimited, tSchemaComplianceCheck, tFileOutputDelimited, tLogRow. Cliquez-droit sur le tFileInputDelimited pour le connecter au composant tSchemaComplianceCheck via une connexion Row Main. Cliquez-droit sur le composant tSchemaComplianceCheck et slectionnez Row > Main pour le connecter au composant tFileOutputDelimited. Ce flux de sortie ne contiendra que les donnes valides.

200

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tSchemaComplianceCheck

Cliquez-droit une deuxime fois sur le composant tSchemaComplianceCheck et cette fois slectionnez Row > Rejects pour le connecter au composant tLogRow. Cette deuxime sortie regroupera toutes les donnes non conformes. Slectionnez le lien Rejects que vous venez de connecter, vous remarquerez que le schma transmis au tLogRow contient deux nouvelles colonnes : ErrorCode et ErrorMessage. Ces deux colonnes sont en lecture seule et fournissent des informations sur les donnes rejetes, afin de faciliter le traitement et la correction de erreurs, si ncessaire. Maintenant dfinissez les proprits de chaque composant.

Dans la vue Component du composant tFileInputDelimited, laissez les paramtres par dfaut du fichier dlimit et renseignez le chemin daccs au fichier dentre dans le champ File Name. Dans cet exemple : in.csv. Cliquez sur Edit Schema pour dcrire la structure de donnes de ce fichier dentre. Le schma est compos de six colonnes : id, Col2Label, Col3Label, Date, Val et Str_Nullable.

Laissez le champ Type aussi permissif que possible (particulirement en Java). Vous dfinirez le type de donnes rel dans la vue Component du composant tSchemaComplianceCheck. La colonne Str_nullable est la seule colonne contenant des donnes de valeur nulle. Ainsi, cochez la case adquate. Les colonnes Col2Label et Col3Label ont respectivement une longueur de 30 et 40 caractres. Puis double-cliquez sur le composant tSchemaComplianceCheck pour configurer les paramtres de validation.
Creative Commons License Composants Talend Open Studio 201

Composants Data Quality


tSchemaComplianceCheck

Le champ Base schema devrait tre renseign par les donnes propages partir du composant dentre. Si cela nest pas le cas, cliquez sur le bouton Sync columns. Dans cet exemple, nous utilisons le tableau Checked columns pour configurer les paramtres de validation. Mais vous pouvez aussi cocher la case Use another schema for compliance check et dfinir le schma des donnes attendues. Cochez la case Check all columns from schema si vous souhaitez vrifier tous les paramtres de toutes les colonnes (type, valeurs nulles et longueur). Dans le tableau Checked Columns, dfinissez les vrifications effectuer. Vous trouverez ci-dessous les paramtres pour la cration du Job dans Talend Open Studio avec Java comme langage de gnration : - Slectionnez Int comme Type de donnes de la colonne Id. - Cochez la case Length afin que les longueurs des colonnes Col2Label et Col3Label soient vrifies. - Slectionnez Date comme Type de donnes de la colonne Date. - Cochez la case null de la colonne Val afin que les valeurs nulles soient vrifies (car elles ne devraient pas tre nulles). - Cochez aussi la case null de la colonne Str_nullable afin que les valeurs nulles soient vrifies (car elles peuvent tre nulles). En Perl, cochez la case Type correspondant la colonne dont le type doit tre vrifi (Date). Dfinissez aussi le format de date dans la liste droulante Date format et la langue dans laquelle la date apparatra dans la liste droulante Date language. Puis configurez les paramtres des composants de sortie. La schma est automatiquement propag du composant tSchemaComplianceCheck aux composants de sortie. Renseignez le chemin daccs au fichier de sortie dans les proprits du composant tFileOutputDelimited. Puis dans la vue Run, cochez la case Statistics pour afficher les taux de rpartition des flux avant de lancer lexcution.

202

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tSchemaComplianceCheck

Vous remarquerez que trois lignes du flux dentre ont t valides et donc envoyes au composant tFileOutputDelimited. De plus, sept lignes ne sont pas conformes avec le schma de rfrence et ont donc t rediriges vers la console.

Vous remarquerez que les colonnes de sortie supplmentaires du lien Rejects fournissent les informations error code et error message, notamment : 2|Date:Date format not valid or 2|id:wrong type afin de faciliter lidentification de lerreur.

Creative Commons License

Composants Talend Open Studio

203

Composants Data Quality


tUniqRow

tUniqRow
Proprits du tUniqRow
Famille de composant Data Quality

Fonction Objectif Basic settings

Le composant tUniqRow compare les entres et supprime les doublons du flux dentre. Ce composant assure une qualit de donnes des flux dentre et de sortie du Job. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous effectuez des modifications, le schma passera automatiquement en built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent dans le Job. Si vous souhaitez supprimer les doublons sur des colonnes en particulier, paramtrez-les dans le schma. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement ; Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Case sensitive Cochez cette case pour tenir compte des majuscules et des minuscules.

Utilisation

Ce composant est un composant intermdiaire puisquil sert traiter un flux de donnes. Ainsi, il ncessite un composant dentre et un composant de sortie. n/a

Limitation

Scnario : Ddoublonner des donnes


Ce scnario est bas sur celui du tSortRow, le composant tUniqRow est ajout au Job afin de supprimer les doublons dans le flux de sortie. En effet, comme les donnes en entre sont cres de manire alatoire, des doublons sont forcment crs.

204

Composants Talend Open Studio

Creative Commons License

Composants Data Quality


tUniqRow

Dans longlet Basic settings de la vue Component du composant tUniqRow, cliquez sur Edit Schema... pour dfinir le champ Names comme cl et ainsi supprimer les doublons du flux de sortie sur ce critre. Cochez la case Case Sensitive pour tenir compte de la casse. Appuyez sur F6 pour excuter le Job. La console affiche les rsultats tris et sans doublons.

Creative Commons License

Composants Talend Open Studio

205

Composants Data Quality


tUniqRow

206

Composants Talend Open Studio

Creative Commons License

Composants Databases
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille Databases de la Palette de Talend Open Studio. La famille Databases 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. Plus de 40 SGBDR sont supports.

Composants Databases
tAccessInput

tAccessInput
Proprits du tAccessInput
Famille de composant Databases/Access

Fonction Objectif

Le composant tAccessInput lit une base de donnes et en extrait des champs laide de requtes. 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). 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Database Username et Password Schema et Edit Schema Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant (Repository). Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.

Basic settings

208

Composants Talend Open Studio

Creative Commons License

Composants Databases
tAccessInput

Advanced settings

Encoding

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Trim all the String/Char columns Trim column

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.

Scnarios associs
Pour un scnario associ, consultez les scnarios tDBInput : le Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258. le Scnario 2 : Utiliser la variable StoreSQLQuery, page 260. Pour plus dinformations sur les contextes dynamiques dans le cadre dune utilisation de base de donnes, consultez le composant tContextLoad, page 1121.

Creative Commons License

Composants Talend Open Studio

209

Composants Databases
tAccessOutput

tAccessOutput
Proprits du tAccessOutput
Famille de composant Databases/Access

Fonction Objectif Basic settings

Le composant tAccessOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tAccessOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio . Database Username et Password Table Action on table Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes Nom de la table crer. Vous ne pouvez crer quune seule table la fois. 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.

210

Composants Talend Open Studio

Creative Commons License

Composants Databases
tAccessOutput

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 sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.

Advanced settings

Encoding Type

Creative Commons License

Composants Talend Open Studio

211

Composants Databases
tAccessOutput

Commit every

Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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.

Additional Columns

Use field options Enable debug mode

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus de dcriture 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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ, consultez : Le Scnario : Afficher la base de donnes en sortie, page 264 du tDBOutput. Le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du tMySQLOutput.

212

Composants Talend Open Studio

Creative Commons License

Composants Databases
tAccessRow

tAccessRow
Proprits du tAccessRow
Famille de composant Databases/Access

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. 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. 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 laide des donnes collectes. DB Version Database Username et Password Schema et Edit Schema Slectionnez la version dAccess que vous utilisez. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Query type Nom de la table traiter. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement. Query Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Composants Talend Open Studio 213

Objectif

Basic settings

Creative Commons License

Composants Databases
tAccessRow

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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.

Advanced settings

Propagate QUERYs recordset Use PreparedStatement

Encoding Type

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

Commit every

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 de requtes SQL.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du tMySQLRow.

214

Composants Talend Open Studio

Creative Commons License

Composants Databases
tAS400Commit

tAS400Commit
Proprits du tAS400Commit
Ce composant est troitement li aux composants tAS400Connection et tAS400Rollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/AS400

Fonction Objectif

Le composant tAS400Commit valide les donnes traites dans un Job partir dune base de donnes connecte. 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. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tAS400Connection dans la liste. 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.

Basic settings

Close connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants AS400 et notamment avec les composants tAS400Connection et tAS400Rollback. n/a

Scnario associ
Ce composant est troitement li aux composants tAS400Connection et tAS400Rollback. Ils sont gnralement utiliss avec un composant tAS400Connection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tAS400Commit, consultez Proprits du tMysqlConnection page 482

Creative Commons License

Composants Talend Open Studio

215

Composants Databases
tAS400Close

tAS400Close
Proprits du tAS400Close
Famille de composant Databases/AS400

Fonction Objectif Basic settings

Le composant tAS400Close ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes AS400. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tAS400Connection dans la liste.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a

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 tAS400Close, consultez tMysqlConnection page 482

216

Composants Talend Open Studio

Creative Commons License

Composants Databases
tAS400Connection

tAS400Connection
Proprits du tAS400Connection
Ce composant est troitement li aux composants tAS400Commit et tAS400Rollback. Ils sont gnralement utiliss avec un composant tAS400Connection car il permet douvrir une connexion pour la transaction en cours.
Famille de composant Databases/AS400

Fonction Objectif Basic settings

Le composant tAS400Connection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. 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 laide des donnes collectes. DB Version Host Database Table Schema Username et Password Encoding Type Slectionnez la version dAS400 que vous utilisez. Adresse IP du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour partager votre connexion ou rcuprer une 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.. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.

Use or register a shared DB Connection

Utilisation Limitation

Ce composant est gnralement utilis avec des composants AS400 et notamment avec les composants tAS400Commit et tAS400Rollback. n/a

Creative Commons License

Composants Talend Open Studio

217

Composants Databases
tAS400Connection

Scnario associ
Ce composant est troitement li aux composants tAS400Commit et tAS400Rollback. Ils sont gnralement utiliss avec un composant tAS400Connection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tAS400Connection, consultez tMysqlConnection page 482

218

Composants Talend Open Studio

Creative Commons License

Composants Databases
tAS400Input

tAS400Input
Proprits du tAS400Input
Famille de composant Databases/AS400

Fonction Objectif

Le composant tAS400Input lit une base de donnes et en extrait des champs laide de requtes. 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). 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. DB Version Host Port Database Username et Password Schema et Edit Schema Slectionnez la version dAS400 que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Basic settings

Creative Commons License

Composants Talend Open Studio

219

Composants Databases
tAS400Input

Query type et Query

Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Advanced settings

Additional JDBC parameters

Encoding Type

Trim all the String/Char columns Trim column

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.

Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260 Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1122 du composant tContextLoad.

220

Composants Talend Open Studio

Creative Commons License

Composants Databases
tAS400LastInsertId

tAS400LastInsertId
Proprits du tAS400LastInsertId
Famille de composant Databases/AS400

Fonction Objectif Basic settings

tAS400LastInsertId affiche les derniers ID ajouts une table partir dune connexion AS400 spcifie. tMysqlLastInsertId permet de rcuprer les cls primaires des entres dernirement ajoutes par un utilisateur une table AS400. Schema et Edit Schema Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Component list Slectionnez le composant tAS400Connection dans la liste sil y a plus dune connexion dans votre Job.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est un composant intermdiaire. n/a

Scnario associ
Pour un scnario associ, consultez le Scnario : Rcuprer les ID des dernires entres ajoutes, page 490 du composant tMysqlLastInsertId.

Creative Commons License

Composants Talend Open Studio

221

Composants Databases
tAS400Output

tAS400Output
Proprits du tAS400Output
Famille de composant Databases/DB2

Fonction Objectif Basic settings

Le composant tAS400Output crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tAS400Output excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio . DB Version Host Port Database Username et Password Table Action on table Slectionnez la version dAS400 que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois. 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.

222

Composants Talend Open Studio

Creative Commons License

Composants Databases
tAS400Output

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 sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.

Advanced settings

Additional JDBC parameters

Creative Commons License

Composants Talend Open Studio

223

Composants Databases
tAS400Output

Encoding Type

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour accder au champ Commit every et dfinir les oprations de commit. Commit every : nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de transaction (cependant pas de rollback) et surtout une meilleure performance des excutions.

Use commit control

Additional Columns

Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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 Enable debug mode

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus dcriture 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 dune table dune base de donnes AS400. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ, consultez :

224

Composants Talend Open Studio

Creative Commons License

Composants Databases
tAS400Output

le Scnario : Afficher la base de donnes en sortie, page 264 du composant tDBOutput le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du composant tMySQLOutput.

Creative Commons License

Composants Talend Open Studio

225

Composants Databases
tAS400Rollback

tAS400Rollback
Proprits du tAS400Rollback
Ce composant est troitement li aux composants tAS400Commit et tAS400Connection. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/AS400

Fonction Objectif Basic settings

Le tAS400Rollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tAS400Connection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.

Close Connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants AS400, notamment avec le tAS400Connection et le tAS400Commit. n/a

Scnario associ
Pour un scnario associ au tAS400Rollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524 du composant tMySQLRollback.

226

Composants Talend Open Studio

Creative Commons License

Composants Databases
tAS400Row

tAS400Row
Proprits du tAS400Row
Famille de composant Databases/AS400

Fonction

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. 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. Use an existing connection Cochez cette case et slectionnez le composant tAS400Connection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinie. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. 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 laide des donnes collectes. DB Version Host Port Slectionnez la version dAS400 que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur.

Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

227

Composants Databases
tAS400Row

Database Username et Password Schema et Edit Schema

Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Table Name Query type

Nom de la table traiter. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.

Query

Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column.

Die on error

Advanced settings

Additional JDBC parameters

Propagate QUERYs recordset

228

Composants Talend Open Studio

Creative Commons License

Composants Databases
tAS400Row

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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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.

Encoding Type

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

Commit every

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log lors du traitement du Job, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes SQL.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du composant tMySQLRow.

Creative Commons License

Composants Talend Open Studio

229

Composants Databases
tCreateTable

tCreateTable
Proprits du tCreateTable
Ce composant se trouve la racine de la famille Databases de la Palette de Talend Open Studio. Le composant tCreateTable couvre des besoins indirectement lis lutilisation des bases de donnes de tout type.
Famille de composant Databases

Fonction Objectif Basic settings

Le tCreateTable cre, supprime ou supprime et recre une table spcifique. Ce composant spcifique Java permet de crer ou de supprimer nimporte quelle table dune base de donnes 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 laide des donnes collectes. Database Type Slectionnez le type de SGBD dans la liste propose. Les proprits peuvent diffrer lgrement en fonction du type de base de donnes slectionn. Les champs additionnels sont dfinis dans ce tableau, la suite des proprits gnrales. Table Action Slectionnez laction effectuer sur la base de donnes : Create table : lorsque vous savez que la table nexiste 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. Cochez cette case pour enregistrer la table cre de manire temporaire.

Mysql

Temporary Table

230

Composants Talend Open Studio

Creative Commons License

Composants Databases
tCreateTable

MSSQLServer, MySQL, Oracle, PostgresPlus, Postgresql, Teradata

Use an existing connection

Cochez cette case si vous utilisez un composant de connexion, par exemple : tMysqlConnection ou tOracleConnection, etc. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.

Oracle Access

Connection Type Access File

Liste droulante des pilotes disponibles. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Slectionnez dans la liste un framework pour votre base de donnes Java. Slectionnez dans la liste le type de serveur correspondant aux paramtres de votre base de donnes. Cochez cette case pour autoriser, si besoin, le mode scuris.

Firebird

Firebird File

Interbase

Interbase File

SQLite

SQLite File

Java Db HSQLDb

Framework Type Running Mode

HSQLDb

Use TLS/SSL Sockets

Creative Commons License

Composants Talend Open Studio

231

Composants Databases
tCreateTable

AS400/Oracle

DB Version

Slectionnez dans la liste droulante la version correspondant la base de donne slectionne. Adresse IP du serveur de base de donnes.

Tous les types de bases Host de donnes, excepts Access, JavaDb, SQLite et ODBC Tous les types de bases de donnes, excepts Access, Firebird, HSQLDb, SQLite et ODBC JavaDb Tous les types de bases de donnes, excepts Access, AS400, Firebird, Interbase, JavaDb, SQLite et ODBC HSQLDb Informix ODBC Database Name

Nom de la base de donnes.

DB Root Path Port

Parcourez vos fichiers jusqu la racine de votre base de donnes. Numro du port dcoute du serveur de base de donnes.

DB Alias DB Server ODBC Name UserName et Password Table name Schema et Edit Schema

Nom de la base de donnes. Nom du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Saisissez le nom de la nouvelle table entre guillemets. Un schma est une description de lignes, i.e., 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. Rinitialisez le type de base de donnes en cliquant sur le bouton correspondant afin de vous assurer que le type de donnes est correct. Built-in : Le schma est cr et conserv pour ce composant uniquement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.

Advanced settings

Encoding

Slectionnez lencodage dans la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour le traitement des donnes dune base de donnes.

232

Composants Talend Open Studio

Creative Commons License

Composants Databases
tCreateTable

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log lors du traitement du Job, aussi bien au niveau du Job quau niveau de chaque composant. AS400/ MSSQL Server Additional JDBC Parameters Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes.

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 dentre de type base de donnes.

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 dun schma pris partir du schma dun fichier dlimit stock dans le Repository. Ce Job est compos dun seul composant.

Cliquez et dposez un composant tCreateTable de la famille Databases de la Palette. Dans la liste Database type de longlet Basic settings de la vue Component, slectionnez MySQL.

Dans la liste droulante Table Action, slectionnez Create table. Ne cochez la case Use Existing Connection uniquement si vous utilisez un composant avec une connexion ddie, consultez tMysqlConnection page 482 Nous nutiliserons pas cette option pour cet exemple. Dans la liste droulante Property type, slectionnez Repository, ainsi tous les champs de connexion la base de donnes sont renseigns automatiquement. Si vous navez 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 dans la liste droulante Property type. Dans le champ Table Name, saisissez le nom de la nouvelle table crer.
Creative Commons License Composants Talend Open Studio 233

Composants Databases
tCreateTable

Si vous souhaitez rcuprer le schma dune mtadonne (sans que celle-ci ne soit une connexion une base de donnes), slectionnez Repository puis la mtadonne souhaite. 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 le bouton Reset DB Types si la colonne DB type est vide ou affiche des marques de diffrence (couleur orange). Cela permet de donner nimporte quel type de donnes, le type de donnes adquat. Cliquez sur OK. Enregistrez votre Job appuyez sur F6 pour lexcuter. La table cre est vide mais elle contient toutes les colonnes dfinies dans le Schma.

234

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDB2BulkExec

tDB2BulkExec
Proprits du tDB2BulkExec
Famille de composant Databases/DB2

Fonction Objectif Basic settings

Le composant tDB2BulkExec excute des oprations dInsert sur les donnes fournies. Le tDB2BulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes DB2. 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 laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tJDBCConnection adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Table Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma.

Creative Commons License

Composants Talend Open Studio

235

Composants Databases
tDB2BulkExec

Username et Password Table Action on table

Informations dauthentification sur lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois. 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. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Schema et Edit Schema

Data file

Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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.

Action on data

236

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDB2BulkExec

Advanced settings

Field terminated by Date Format Time Format Timestamp Format

Caractre, chane ou expression rgulire sparant les champs. Utilisez ce champ pour dfinir lordre des mois et des jours. Utilisez ce champ pour dfinir lordre des heures, minutes et secondes. Utilisez ce champ pour dfinir lordre de la date et de lheure.

Remove Load Pending Quand la case est coche, dbloque la table en tat Pending, aprs un chargement massif. Load options Cliquez sur le bouton [+] afin dajouter des options de chargement des donnes. Parameter : dans la liste, slectionnez un paramtre de chargement. Value : saisissez une valeur pour le paramtre slectionn.

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

Scnario associ
Pour un scnario associ au composant tDB2BulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.

Creative Commons License

Composants Talend Open Studio

237

Composants Databases
tDB2Close

tDB2Close
Proprits du tDB2Close
Famille de composant Databases/DB2

Fonction Objectif Basic settings

Le composant tDB2Close ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes DB2. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tDB2Connection dans la liste.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a

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 page 482

238

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDB2Commit

tDB2Commit
Proprits du tDB2Commit
Ce composant est troitement li aux composants tDB2Connection et tDB2Rollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/DB2

Fonction Objectif

Le composant tDB2Commit valide les donnes traites dans un Job partir dune base de donnes connecte. 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. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tDB2Connection dans la liste. 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.

Basic settings

Close connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants DB2 et notamment tDB2Connection et tDB2Rollback. n/a

Scnario associ
Ce composant est troitement li aux composants tDB2Connection et tDB2Rollback. Ils sont gnralement utiliss avec un composant tDB2Connection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tDB2Commit, consultez tMysqlConnection page 482

Creative Commons License

Composants Talend Open Studio

239

Composants Databases
tDB2Connection

tDB2Connection
Proprits du tDB2Connection
Ce composant est troitement li aux composants tDB2Commit et tDB2Rollback. Ils sont gnralement utiliss avec un composant tDB2Connection car il permet douvrir une connexion pour la transaction en cours.
Famille de composant Databases/DB2

Fonction Objectif Basic settings

Le composant tDB2Connection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier une fois quil est valid en une seule transaction vers une base de donnes de sortie. 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 laide des donnes collectes. Host Port Database Table Schema Username et Password Encoding Type Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour partager votre connexion ou rcuprer une 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. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.

Use or register a shared DB Connection

Utilisation Limitation

Ce composant est gnralement utilis avec des composants DB2, notamment les composants tDB2Commit et tDB2Rollback. n/a

240

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDB2Connection

Scnarios associs
Pour un scnario associ au composant tDB2Connection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.

Creative Commons License

Composants Talend Open Studio

241

Composants Databases
tDB2Input

tDB2Input
Proprits du tDB2Input
Famille de composant Databases/DB2

Fonction Purpose

Le composant tDB2Input lit une base de donnes et en extrait des champs laide de requtes. 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). 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.

Basic settings

242

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDB2Input

Use an existing connection

Cochez cette case lorsque vous utilisez un composant tDB2Input.

Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Schema et Edit Schema Adresse IP du serveur dannuaire DB2. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.

Advanced settings

Encoding Type

Creative Commons License

Composants Talend Open Studio

243

Composants Databases
tDB2Input

Trim all the String/Char columns Trim column

Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. 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 requte SQL dans les bases de donnes DB2.

Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260 Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1122 du composant tContextLoad.

244

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDB2Output

tDB2Output
Proprits du tDB2Output
Famille de composant Databases/DB2

Fonction Objectif Basic settings

Le composant tDB2Output crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tDB2Output excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.

Creative Commons License

Composants Talend Open Studio

245

Composants Databases
tDB2Output

Use an existing connection

Cochez cette case lorsque vous utilisez un composant tDB2Output.

Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Table Action on table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois. 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.

246

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDB2Output

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 sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.

Advanced settings

Encoding Type

Creative Commons License

Composants Talend Open Studio

247

Composants Databases
tDB2Output

Commit every

Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de transaction (cependant pas de rollback) et surtout une meilleure performance des excutions. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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.

Additional Columns

Use field options Enable debug mode

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus de dcriture 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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ au composant tDB2Output, consultez : le Scnario : Afficher la base de donnes en sortie, page 264 du tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du tMySQLOutput.

248

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDB2Rollback

tDB2Rollback
Proprits du tDB2Rollback
Ce composant est troitement li aux composants tDB2Commit et tDB2Connection. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/DB2

Fonction Objectif Basic settings

Le tDB2Rollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tDB2Connection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.

Close Connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants DB2, notamment avec le tDB2Connection et le tDB2Commit. n/a

Scnario associ
Pour un scnario associ au tDB2Rollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524 du composant tMySQLRollback.

Creative Commons License

Composants Talend Open Studio

249

Composants Databases
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. 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. Use an existing connection Cochez cette case et slectionnez le composant tDB2Connection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinie. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. 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 laide des donnes collectes. Host Port Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur.

Objectif

Basic settings

250

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDB2Row

Database Username et Password Schema et Edit Schema

Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Table Name Query type

Nom de la table traiter. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.

Query

Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

Die on error

Advanced settings

Propagate QUERYs recordset Encoding Type

Commit every

Creative Commons License

Composants Talend Open Studio

251

Composants Databases
tDB2Row

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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes SQL.

Scnarios associs
Pour un scnario associ au composant tDB2Row, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du composant tMySQLRow.

252

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDB2SCD

tDB2SCD
Le composant tDB2SCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tDB2SCD, page 2.

Creative Commons License

Composants Talend Open Studio

253

Composants Databases
tDB2SCDELT

tDB2SCDELT
Le composant tDB2SCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tDB2SCDELT, page 4.

254

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDB2SP

tDB2SP
Proprits du tDB2SP
Famille de composant Databases/DB2

Fonction Objectif Basic settings

Le composant tDB2SP appelle une procdure stocke de base de donnes. Le tDB2SP permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les appeler plus facilement. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier des proprits du composant. Les champs suivants sont alors pr-remplis. Host Port Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification sur lutilisateur de base de donnes. Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., 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. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est rutilisable. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. SP Name Is Function / Return result in Saisissez le nom exact de la Procdure Stocke (SP). 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.

Creative Commons License

Composants Talend Open Studio

255

Composants Databases
tDB2SP

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 quil ny a de paramtres utiliss dans la procdure. Slectionnez le Type de paramtre : IN : paramtre dentre (Input) OUT : paramtre de sortie (Output)/valeur retourne IN OUT : les paramtres dentre doivent tre retournes sous forme de valeur, mme aprs modifications via la procdure (fonction). RECORDSET : les paramtres dentre doivent tre retournes sous forme densemble de valeurs, au lieu dune valeur unique. Consultez le composant tParseRecordSet si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.

Encoding Type

Utilisation Limitation

Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls les paramtres dentre sont autoriss. La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.

Scnario associ
Pour un scnario associ, consultez le Scnario : Trouver le libell State laide dune procdure stocke, page 539 du composant tMysqlSP. Consultez galement le composant tParseRecordSet, page 629 si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.

256

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDBInput

tDBInput
Proprits du tDBInput
Famille de composant Databases/DB Generic Le composant tDBInput lit une base de donnes et en extrait des champs laide de requtes. 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). Prfrez toujours un composant Input spcifique au composant gnrique 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Connection type Database Username et Password Schema et Edit Schema Liste droulante des pilotes disponibles. Nom de la base de donnes Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Fonction Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

257

Composants Databases
tDBInput

Query

Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Advanced settings

Encoding Type

Trim all the String/Char columns Trim column

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 grce une connexion gnrique ODBC.

Scnario 1 : Afficher les donnes slectionnes partir dune table


Le Job suivant, deux composants, lit les donnes dune base via une requte et affiche dans la console (vue Run) les donnes dlimites.

Cliquez et dposez les composants tDBInput et tLogRow dans lditeur graphique. Cliquez droit sur le tDBInput et, en gardant le bouton droit enfonc, glissez jusquau tLogRow pour crer une connexion de type Main Row. Slectionnez nouveau le tDBInput pour que la vue Component apparaisse puis renseignez les proprits du composant :

258

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDBInput

Dans ce scnario, le champ Property Type est en mode Built-In. Renseignez les informations de connexion la base de donnes dans les champs Database, Username et Password. Le champ Schema est en mode Built-In, ce qui implique que le schma ne sera utilisable que pour ce Job et sur ce poste. Cliquez sur le bouton Edit Schema et rpertoriez les codes des magasins dans une colonne et les ventes dans une autre. Renseignez le nom de la table dans le champ Table Name. 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 dutiliser lastrisque. De la mme faon, cliquez sur le deuxime composant pour le dfinir. Indiquez quel est le sparateur de champs : il sagit ici dune barre verticale. Passez sur la vue Run et cliquez sur le bouton Run pour excuter le Job. La base de donnes est alors analyse. Les donnes recherches sont extraites et sont affiches directement sur la console (vue Run), o vous pouvez les voir.

Creative Commons License

Composants Talend Open Studio

259

Composants Databases
tDBInput

Scnario 2 : Utiliser la variable StoreSQLQuery


La variable StoreSQLQuery peut tre utilise pour dboguer un scnario tDBInput qui ne sexcuterait pas correctement. Elle permet dalimenter la requte de votre composant tDBInput de manire dynamique. Partez du scnario 1 dcrit ci-dessus, auquel vous ajouterez un composant tJava. Reliez les composants tDBInput et tJava via une connexion Trigger de type OnComponentOk. Dans le cas prsent, on veut que la commande du tDBInput sexcute avant la commande du tJava.

Configurez les composants tDBInput et tLogRow comme dans le scnario 1 dcrit plus haut. Passez la vue appele Context. 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. 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.

260

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDBInput

Affichez la vue Run et excutez les Jobs. La requte associe au composant tDBInput saffiche dans la console (vue Run), la fin des rsultats du Job :

Creative Commons License

Composants Talend Open Studio

261

Composants Databases
tDBOutput

tDBOutput
Proprits du tDBOutput
Famille de composant Databases

Fonction Objectif

Le composant tDBOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tDBOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Prfrez toujours un composant Output spcifique au composant gnrique. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Connection type Database Username et Password Table Action on table Liste des pilotes disponibles. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois. 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.

Basic settings

262

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDBOutput

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 sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.

Advanced settings

Encoding Type

Creative Commons License

Composants Talend Open Studio

263

Composants Databases
tDBOutput

Commit every

Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de transaction (cependant pas de rollback) et surtout une meilleure performance des excutions. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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.

Additional Columns

Use field options Enable debug mode

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus de dcriture 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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Scnario : Afficher la base de donnes en sortie


Le Job suivant, form de trois composants, permet de crer une nouvelle table dans une base de donne dtermine et de lalimenter. Le composant tFileInputdelimited passe le flux entrant au composant tDBoutput. En outre, le composant tLogRow est utilis ici pour afficher les rsultats directement dans la console de la vue Run.

264

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDBOutput

Cliquez et dposez les trois composants ncessaires pour ce Job. Dfinissez les paramtres dentre pour le composant tFileInputDelimited, dans longlet Basic settings. Dans cet exemple, le fichier contient les identifiants des propritaires, les rfrences des marques, des couleurs et des immatriculations des voitures. Ces informations sont organises comme suit : un point-virgule comme sparateur de champ et un retour chariot comme sparateur de ligne. Le fichier dentre comprend une ligne den-tte prendre en compte dans le schma. Si ce fichier est dj dcrit dans vos mtadonnes, vous pouvez en rcuprer les proprits en slectionnant lentre correspondante dans le Repository.

Si votre schma est dj stock dans le Repository, slectionnez loption Repository dans le champ Schema puis choisissez les mtadonnes appropries partir de la liste. Si vous navez encore dfini aucun schma, renseignez la structure des donnes dans un schma que vous crerez en mode built-in. Pour ce cas de figure, rduisez lextraction 10 lignes. Dfinissez ensuite le composant tDBOutput pour configurer le flux de sortie. Slectionnez la base de donnes laquelle se connecter. Vous pouvez stocker lensemble des dtails de connexion aux bases de donnes via diffrentes variables de contexte. Pour plus dinformations sur la manire de crer et dutiliser les variables de contexte, consultez Dfinition des Contextes et des Variables.

Creative Commons License

Composants Talend Open Studio

265

Composants Databases
tDBOutput

Renseignez le nom de la table dans le champ Table, puis choisissez les oprations effectuer : Dans le champ Action on table, slectionnez loption Drop and create table partir de la liste, ce qui vous permettra dcraser la table, si elle existe, avec les nouvelles donnes choisies. Vous pouvez galement ajouter des lignes supplmentaires dans une table dj existante, mais notez que la gestion des doublons nest pas supporte nativement. Consultez la section Proprits du tUniqRow, page 204 pour plus dinformations. Dans le champ Action on data, slectionnez loption Insert. Le flux de donnes entrant sera alors ajout la table slectionne. Pour visualiser plus facilement le flux sortant, connectez le composant tDBOuput un composant tLogRow. Dfinissez le symbole barre verticale comme sparateur de champ. Appuyez sur F6 pour excuter le Job. Le traitement peut prendre un peu de temps avant que le tLogRow n'affiche le rsultat. Pour afficher le suivi du traitement, activez la fonction Statistics sur la console de la vue Run.

Sujet associ : Proprits du tMysqlOutput, page 495

266

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDBSQLRow

tDBSQLRow
Proprits du tDBSQLRow
Famille de composant Databases/DB Generic 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. 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. 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 laide des donnes collectes. Datasource Nom de la source de donnes ODBC crer au pralable pour pouvoir se connecter la base de donnes Pour plus dinformations, consultez le prrequis de ce tableau. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Query type Nom de la table de base de donnes modifier. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder.

Fonction

Objectif

Basic settings

Username et Password Schema et Edit Schema

Creative Commons License

Composants Talend Open Studio

267

Composants Databases
tDBSQLRow

Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement. Query Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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. Encoding Type Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

Advanced settings

Propagate QUERYs recordset Use PreparedStatement

Commit every

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 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 dadministration > Sources de donnes (OBCD) puis renseignez les proprits de la source partir de lassistant.

268

Composants Talend Open Studio

Creative Commons License

Composants Databases
tDBSQLRow

Scnario : Rinitialiser lauto-incrmentation dune base de donnes


Le Job suivant, un seul composant, permet de rinitialiser lauto-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 lexcution dun script.

Glissez-dposez le composant tDBSQLRow sur lespace graphique de modlisation. Dans la vue Basic settings, renseignez les proprits de la connexion la source de donnes (datasource) ODBC.
Pour plus dinformations sur les sources de donnes OBCD, consultez la section concernant les prrequis dans le tableau des proprits.

Dans le champ Property Type, slectionnez Repository pour rcuprer les informations connexion stockes dans le Repository. Dans le champ Datasource, saisissez le nom de la source de donnes ODBC laquelle est relie la base de donnes contenant la table dont vous voulez rinitialiser lauto-incrmentation. Dans les champs Username et Password, renseignez si ncessaire vos identifiant et mot de passe de connexion la source de donnes. Dans le champ Schema Type, slectionnez le mode Built-in et dcrivez la structure de la base de donnes Talend. Le schma nest pas important dans notre cas particulier puisque nous souhaitons rinitialiser lauto-incrmentation de la table et que nous ne touchons pas aux donnes.

Creative Commons License

Composants Talend Open Studio

269

Composants Databases
tDBSQLRow

Dans le champ Table Name, renseignez le nom de la table dont vous voulez rinitialiser lauto-incrmentation. Dans le champ Query type, laissez loption Built-in. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir le SQLbuilder. Sinon, saisissez le code suivant : Alter table <TableName> auto_increment = 1 directement dans le champ Query. Enregistrez le Job et appuyez sur F6 pour lexcuter. Lauto-incrmentation de la base de donnes est rinitialise. Voir galement : Proprits du tMysqlRow, page 526.

270

Composants Talend Open Studio

Creative Commons License

Composants Databases
tEXAInput

tEXAInput
Proprits du tEXAInput
Famille de composant Databases/EXA

Fonction Objectif

Le composant tEXAInput lit une base de donnes et en extrait des champs laide de requtes. 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). 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host name Port Schema name Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Saisissez le nom du schma. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Saisissez le nom de la table.

Basic settings

Creative Commons License

Composants Talend Open Studio

271

Composants Databases
tEXAInput

Query type et Query

Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Cliquez sur le bouton pour rcuprer le schma de la table. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Guess Query

Guess schema Advanced settings Additional JDBC parameters Encoding Type

Trim all the String/Char columns Trim column

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

Scnarios associs
Consultez les scnarios associs au composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260

272

Composants Talend Open Studio

Creative Commons License

Composants Databases
tEXAOutput

tEXAOutput
Proprits du tEXAOutput
Famille de composant Databases/EXA

Fonction Objectif Basic settings

Le composant tEXAOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tEXAOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Port Schema name Username et Password Table Action on table Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Saisissez le nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. 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.

Creative Commons License

Composants Talend Open Studio

273

Composants Databases
tEXAOutput

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 sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cochez cette case afin de dfinir, dans le champ Commit every, qui apparat alors, le nombre de lignes traiter avant de commiter.

Advanced settings

Use commit control

274

Composants Talend Open Studio

Creative Commons License

Composants Databases
tEXAOutput

Additional JDBC parameters Encoding Type

Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de transaction (cependant pas de rollback) et surtout une meilleure performance des excutions. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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.

Commit every

Additional Columns

Use field options Enable debug mode

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus de dcriture 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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ, consultez :

Creative Commons License

Composants Talend Open Studio

275

Composants Databases
tEXAOutput

le Scnario : Afficher la base de donnes en sortie, page 264 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du composant tMySQLOutput.

276

Composants Talend Open Studio

Creative Commons License

Composants Databases
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. 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. 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 laide des donnes collectes. Host Port Schema name Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Saisissez le nom du schma. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Query type Nom de la table traiter. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.

Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

277

Composants Databases
tEXARow

Guess Query

Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

Query

Die on error

Advanced settings

Additional JDBC parameters Propagate QUERYs recordset Encoding Type

Commit every

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 de requtes SQL.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du composant tMySQLRow.

278

Composants Talend Open Studio

Creative Commons License

Composants Databases
tEXistConnection

tEXistConnection
Proprits du tEXistConnection
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.
Famille de composant Databases/eXist

Fonction Objectif

Le tEXistConnection ouvre une connexion une base de donnes eXist afin deffectuer une transaction. Ouvrir une connexion une base de donnes eXist afin deffectuer une transaction. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins. Informations dauthentification de lutilisateur de base de donnes.

Driver

Username et Password Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec dautres composants tEXist,comme le tEXistGet et le tEXistPut. n/a

Scnario associ
Pour un scnario associ au composant tEXistConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.

Creative Commons License

Composants Talend Open Studio

279

Composants Databases
tEXistDelete

tEXistDelete
Proprits du tEXistDelete
Famille de composant Databases/eXist

Fonction Objectif Basic settings

Ce composant supprime des ressources dune base de donnes eXist. Le tEXistDelete supprime des ressources spcifies dans une base de donnes eXist distante. Use an existing Cochez cette case et slectionnez le composant connection/Compon tEXistConnection adquat partir de la liste ent List Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins. Informations dauthentification de lutilisateur de base de donnes. Slectionnez le type de cible : Resource(Ressource), Collection (Collection), ou All (Tous).

Driver

Username et Password Target Type

280

Composants Talend Open Studio

Creative Commons License

Composants Databases
tEXistDelete

Files

Cliquez sur le bouton [+] afin dajouter 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

Ce composant est utilis en tant que sous-job ou comme composant de sortie. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

Creative Commons License

Composants Talend Open Studio

281

Composants Databases
tEXistGet

tEXistGet
tEXistGet properties
Famille de composant Databases/eXist

Fonction Objectif Basic settings

Ce composant rcupre des ressources partir dun serveur distant de base de donnes. Le tEXistGet tlcharge les ressources slectionnes partir dun serveur distant de base de donnes dans un rpertoire local. Use an existing Cochez cette case et slectionnez le composant connection/Compon tEXistConnection adquat partir de la liste ent List Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins. Informations dauthentification de lutilisateur de base de donnes. Chemin daccs au fichier de destination.

Driver

Username et Password Local directory

282

Composants Talend Open Studio

Creative Commons License

Composants Databases
tEXistGet

Files

Cliquez sur le bouton [+] afin dajouter 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

Ce composant est utilis en tant que sous-job ou comme composant de sortie. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

Creative Commons License

Composants Talend Open Studio

283

Composants Databases
tEXistList

tEXistList
Proprits du tEXistList
Famille de composant Databases/eXist

Fonction Objectif Basic settings

Ce composant liste les ressources stockes sur un serveur distant de base de donnes. Le tEXistList liste les ressources stockes sur un serveur distant de base de donnes. Use an existing Cochez cette case et slectionnez le composant connection/Compon tEXistConnection adquat partir de la liste ent List Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins. Informations dauthentification de lutilisateur de base de donnes.

Driver

Username et Password

284

Composants Talend Open Studio

Creative Commons License

Composants Databases
tEXistList

Files

Cliquez sur le bouton [+] afin dajouter 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. Slectionnez le type de cible : Resource(Ressource), Collection (Collection), ou All (Tous). Cochez cette case pour collecter les donnes de log au niveau du composant.

Target Type

Advanced settings Utilisation Limitation

tStatCatcher Statistics

Ce composant est gnralement utilis avec un tEXistGet afin de rcuprer les fichiers lists, par exemple. n/a

Scnario associ
Pour un scnario associ au tEXistList, consultez le Scnario : Itration sur un rpertoire distant, page 995.

Creative Commons License

Composants Talend Open Studio

285

Composants Databases
tEXistPut

tEXistPut
Proprits du tEXistPut
Famille de composant Databases/eXist

Fonction Objectif Basic settings

Ce composant charge des ressources dans un serveur de base de donnes. Le tEXistPut charge des fichiers spcifis dun rpertoire local dfini sur un serveur distant de base de donnes. Use an existing Cochez cette case et slectionnez le composant connection/Compon tEXistConnection adquat partir de la liste ent List Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins. Informations dauthentification de lutilisateur de base de donnes. Chemin daccs au fichier de destination.

Driver

Username et Password Local directory

286

Composants Talend Open Studio

Creative Commons License

Composants Databases
tEXistPut

Files

Cliquez sur le bouton [+] afin dajouter 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

Ce composant est utilis en tant que sous-job ou comme composant de sortie. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

Creative Commons License

Composants Talend Open Studio

287

Composants Databases
tEXistXQuery

tEXistXQuery
Proprits du tEXistXQuery
Famille de composant Databases/eXist

Fonction

Ce composant utilise des fichiers locaux contenant des requtes XPath afin dinterroger des fichiers XML stocks dans une base de donnes distante. 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. Use an existing Cochez cette case et slectionnez le composant connection/Compon tEXistConnection adquat partir de la liste ent List Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins. Informations dauthentification de lutilisateur de base de donnes.

Objectif

Basic settings

Driver

Username et Password

288

Composants Talend Open Studio

Creative Commons License

Composants Databases
tEXistXQuery

XQuery Input File Local Output

Parcourez votre rpertoire jusquau fichier local contenant la requte excuter. Parcourez votre rpertoire jusqu lemplacement o les rsultats de la requte doivent tre sauvegards. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

Ce composant est utilis en tant que composant unique dun Job mais peut galement tre utilis dans un Job plus complexe. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

Creative Commons License

Composants Talend Open Studio

289

Composants Databases
tEXistXUpdate

tEXistXUpdate
Proprits du tEXistXUpdate
Famille de composant Databases/eXist

Fonction Objectif Basic settings

Ce composant traite des fichiers XML et met jour les enregistrements sur un serveur de base de donnes. Le tEXistXUpdate traite des fichiers XML et met jour les enregistrements existants sur un serveur de base de donnes. Use an existing Cochez cette case et slectionnez le composant connection/Compon tEXistConnection adquat partir de la liste ent List Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins. Informations dauthentification de lutilisateur de base de donnes.

Driver

Username et Password

290

Composants Talend Open Studio

Creative Commons License

Composants Databases
tEXistXUpdate

Update File

Parcourez votre rpertoire jusquau fichier local utiliser pour mettre jour les enregistrements de la base de donnes. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

Ce composant est utilis en tant que composant unique dun Job mais peut galement tre utilis dans un Job plus complexe. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

Creative Commons License

Composants Talend Open Studio

291

Composants Databases
tFirebirdClose

tFirebirdClose
Proprits du tFirebirdClose
Famille de composant Databases/Firebird

Fonction Objectif Basic settings

Le composant tFirebirdClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Firebird. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tFirebirdConnection dans la liste.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a

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 page 482

292

Composants Talend Open Studio

Creative Commons License

Composants Databases
tFirebirdCommit

tFirebirdCommit
Proprits du tFirebirdCommit
Ce composant est troitement li aux composants tFirebirdConnection et tFirebirdRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Firebird

Fonction Objectif

Le composant tFirebirdCommit valide les donnes traites dans un Job partir dune base de donnes connecte. 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. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tFirebirdConnection dans la liste. 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.

Basic settings

Close connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Firebird et notamment avec les composants tFirebirdConnection et tFirebirdRollback. n/a

Scnario associ
Ce composant est troitement li aux composants tFirebirdConnection et tFirebirdRollback. Ils sont gnralement utiliss avec un composant tFirebirdConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tFirebirdCommit, consultez tVerticaConnection page 767.

Creative Commons License

Composants Talend Open Studio

293

Composants Databases
tFirebirdConnection

tFirebirdConnection
Proprits du tFirebirdConnection
Ce composant est troitement li aux composants tFirebirdCommit et tFirebirdRollback. Ils sont gnralement utiliss avec un composant tFirebirdConnection car il permet douvrir une connexion pour la transaction en cours.
Famille de composant Databases/Firebird

Fonction Objectif Basic settings

Le composant tFirebirdConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier une fois quil est valid en une seule transaction vers une base de donnes de sortie. 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 laide des donnes collectes. Host Port Database Table Schema Username et Password Encoding Type Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour partager votre connexion ou rcuprer une 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. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.

Use or register a shared DB Connection

Utilisation Limitation

Ce composant est gnralement utilis avec des composants Firebird, notamment les composants tFirebirdCommit et tFirebirdRollback. n/a

294

Composants Talend Open Studio

Creative Commons License

Composants Databases
tFirebirdConnection

Scnario associ
Pour un scnario associ au composant tFirebirdConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.

Creative Commons License

Composants Talend Open Studio

295

Composants Databases
tFirebirdInput

tFirebirdInput
Proprits du tFirebirdInput
Famille de composant Databases/Firebird

Fonction Objectif

Le composant tFirebirdInput lit une base de donnes et en extrait des champs laide de requtes. 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). 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 laide des donnes collectes. Host Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Nom de la base de donnes Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.

Basic settings

Advanced settings

Additional JDBC parameters Encoding Type

296

Composants Talend Open Studio

Creative Commons License

Composants Databases
tFirebirdInput

Enable stream

Cochez cette case pour dterminer avec quelles lignes vous souhaitez travailler. Cette option permet damliorer les performances. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Trim all the String/Char columns Trim column

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

Scnarios associs
Pour un scnario associ, consultez les scnarios associs au composant gnrique tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260 Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1122 du composant tContextLoad.

Creative Commons License

Composants Talend Open Studio

297

Composants Databases
tFirebirdOutput

tFirebirdOutput
Proprits du tFirebirdOutput
Famille de composant Databases/Firebird

Fonction Objectif Basic settings

Le composant tFirebirdOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tFirebirdOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. 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 laide des donnes collectes. Host Port Database Username et Password Table Action on table Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. 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.

298

Composants Talend Open Studio

Creative Commons License

Composants Databases
tFirebirdOutput

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 sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.

Advanced settings

Encoding Type

Creative Commons License

Composants Talend Open Studio

299

Composants Databases
tFirebirdOutput

Commit every

Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de transaction (cependant pas de rollback) et surtout une meilleure performance des excutions. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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.

Additional Columns

Use field options Enable debug mode

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus de dcriture 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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Afficher la base de donnes en sortie, page 264 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du composant tMySQLOutput.

300

Composants Talend Open Studio

Creative Commons License

Composants Databases
tFirebirdRollback

tFirebirdRollback
Proprits du tFirebirdRollback
Ce composant est troitement li aux composants tFirebirdCommit et tFirebirdConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Firebird

Fonction Objectif Basic settings

Le tFirebirdRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tFirebirdConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.

Close Connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants Firebird, notamment avec le tFirebirdConnection et le tFirebirdCommit. n/a

Scnario associ
Pour un scnario associ au tFirebirdRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524 du composant tMysqlRollback.

Creative Commons License

Composants Talend Open Studio

301

Composants Databases
tFirebirdRow

tFirebirdRow
Proprits du tFirebirdRow
Famille de composant Databases/Firebird

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. 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. 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 laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tFirebirdConnection adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Database Adresse IP du serveur de base de donnes. Nom de la base de donnes.

Objectif

Basic settings

302

Composants Talend Open Studio

Creative Commons License

Composants Databases
tFirebirdRow

Username et Password Schema et Edit Schema

Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Table Name Query type

Nom de la table traiter. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.

Query

Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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.

Die on error

Advanced settings

Propagate QUERYs recordset Use PreparedStatement

Creative Commons License

Composants Talend Open Studio

303

Composants Databases
tFirebirdRow

Encoding Type

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

Commit every

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 de requtes SQL.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du composant tMySQLRow.

304

Composants Talend Open Studio

Creative Commons License

Composants Databases
tGreenplumBulkExec

tGreenplumBulkExec

Proprits du tGreenplumBulkExec
Les composants tGreenplumOutputBulk et tGreenplumBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tGreenplumOutputBulkExec, dtaill dans une section spare. Lintrt 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/Greenplum

Fonction Objectif

Le composant tGreenplumBulkExec effectue une action dInsert sur les donnes fournies. Le tGreenplumBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Greenplum. 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 laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tGreenplumConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Adresse IP du serveur de base de donnes.

Basic settings

Creative Commons License

Composants Talend Open Studio

305

Composants Databases
tGreenplumBulkExec

Port Database Schema Username et Password Table

Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit exister pour que lopration dInsert soit autorise. 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. Clear a table : supprimer le contenu de la table. Nom du fichier traiter. Un schma est une description de lignes, i.e., 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. Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Les informations demandes seront diffrentes en fonction de laction choisie.

Action on table

File Name Schema et Edit Schema

Advanced settings

Action on data

Copy the OID for each Rcupre les identifiants dobjet pour chaque ligne. row Contains a header line Spcifiez que la table contient des lignes den-tte. with the names of each column in the file File type Null string Fields terminated by Escaped char Text enclosure Force not null for columns Slectionnez le type de fichiers traiter. Chane de caractres affiche pour signifier que la valeur est nulle. Caractre, chane ou expression rgulire sparant les champs. Caractre dchappement de la ligne. Caractres utiliss pour entourer le texte. Dfinissez la nullabilit des colonnes Force not null : Cochez la case correspondant la colonne (Column) que vous souhaitez dfinir comme ntant pas nulle.

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

306

Composants Talend Open Studio

Creative Commons License

Composants Databases
tGreenplumBulkExec

Utilisation

Ce composant est gnralement utilis avec un composant tGreenplumOutputBulk. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes Greenplum. n/a

Limitation

Scnarios associs
Pour plus dinformations relatives au fonctionnement de tGreenplumBulkExec, consultez les scnarios suivants : le Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 521 du composant tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du composant tOracleBulkExec.

Creative Commons License

Composants Talend Open Studio

307

Composants Databases
tGreenplumClose

tGreenplumClose
Proprits du tGreenplumClose
Famille de composant Databases/Greenplum

Fonction Objectif Basic settings

Le composant tGreenplumClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Greenplum. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tGreenplumConnection dans la liste.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a

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 page 482

308

Composants Talend Open Studio

Creative Commons License

Composants Databases
tGreenplumCommit

tGreenplumCommit

Proprits du tGreenplumCommit
Ce composant est troitement li aux composants tGreenplumConnection et tGreenplumRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Greenplum

Fonction Objectif

Le composant tGreenplumCommit valide les donnes traites dans un Job partir dune base de donnes connecte. 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. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tGreenplumConnection dans la liste. 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.

Basic settings

Close connection

Advanced settings Utilisation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Greenplum et notamment avec les composants tGreenplumConnection et tGreenplumRollback. n/a

Limitation

Scnario associ
Ce composant est troitement li aux composants tGreenplumConnection et tGreenplumRollback. Ils sont gnralement utiliss avec un composant tGreenplumConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tGreenplumCommit, consultez tMysqlConnection page 482.

Creative Commons License

Composants Talend Open Studio

309

Composants Databases
tGreenplumConnection

tGreenplumConnection
Proprits du tGreenplumConnection
Ce composant est troitement li aux composants tGreenplumCommit et tGreenplumRollback. Ils sont gnralement utiliss avec un composant tGreenplumConnection car il permet douvrir une connexion pour la transaction en cours.
Famille de composant Databases/Greenplum

Fonction Objectif Basic settings

Le composant tGreenplumConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier une fois quil est valid en une seule transaction vers une base de donnes de sortie. 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 laide des donnes collectes. Host Port Database Schema Username et Password Encoding Type Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour partager votre connexion ou rcuprer une 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. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration.

Use or register a shared DB Connection

Advanced settings

Auto commit

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant.

310

Composants Talend Open Studio

Creative Commons License

Composants Databases
tGreenplumConnection

Utilisation Limitation

Ce composant est gnralement utilis avec des composants Greenplum, notamment les composants tGreenplumCommit et tGreenplumRollback. n/a

Scnarios associs
Pour un scnario associ au composant tGreenplumConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.

Creative Commons License

Composants Talend Open Studio

311

Composants Databases
tGreenplumInput

tGreenplumInput

Proprits du tGreenplumInput
Famille de composant Databases/ Greenplum Le composant tGreenplumInput lit une base de donnes et en extrait des champs laide de requtes. 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). 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Host Port Database Schema Username et Password Schema et Edit Schema Cochez cette case lorsque vous utilisez le composant tGreenplumConnection. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio.

Fonction Objectif

Basic settings

312

Composants Talend Open Studio

Creative Commons License

Composants Databases
tGreenplumInput

Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en une fois. Cette option permet doptimiser les performances. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Advanced settings

Encoding Type

Use cursor

Trim all the String/Char columns Trim column

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

Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tGreenplumInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260

Creative Commons License

Composants Talend Open Studio

313

Composants Databases
tGreenplumOutput

tGreenplumOutput

Proprits du tGreenplumOutput
Famille de composant Databases/Greenplum

Fonction Objectif

Le composant tGreenplumOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tGreenplumOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.

Basic settings

314

Composants Talend Open Studio

Creative Commons License

Composants Databases
tGreenplumOutput

Use an existing connection

Cochez cette case lorsque vous utilisez le composant tGreenplumConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.

Host Port Database Schema Username et Password Table Action on table

Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma. Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. 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.

Creative Commons License

Composants Talend Open Studio

315

Composants Databases
tGreenplumOutput

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 sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.

Advanced settings

Encoding Type

316

Composants Talend Open Studio

Creative Commons License

Composants Databases
tGreenplumOutput

Commit every

Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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.

Additional Columns

Use field options

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les 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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ au composant tGreenplumOutput consultez : le Scnario : Afficher la base de donnes en sortie, page 264 du tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du tMySQLOutput.

Creative Commons License

Composants Talend Open Studio

317

Composants Databases
tGreenplumOutputBulk

tGreenplumOutputBulk
Proprits du tGreenplumOutputBulk
Les composants tGreenplumOutputBulk et tGreenplumBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tGreenplumOutputBulkExec, dtaill dans une section spare. Lintrt 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 Objectif Basic settings

Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Greenplum. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Greenplum. 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 laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Append Schema et Edit Schema

Advanced settings

Row separator Field separator Include header

Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Cochez cette case pour inclure len-tte des colonnes dans le fichier.

318

Composants Talend Open Studio

Creative Commons License

Composants Databases
tGreenplumOutputBulk

Encoding Type

Slectionnez lencodage 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 gnralement utilis avec le composant tGreenplumBulkExec. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes Greenplum.

Scnarios associs
Pour un scnario associ au tGreenplumOutputBulk, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 521 du tMysqlOutputBulkExec.

Creative Commons License

Composants Talend Open Studio

319

Composants Databases
tGreenplumOutputBulkExec

tGreenplumOutputBulkExec
Proprits du tGreenplumOutputBulkExec
Famille de composant Databases/Greenplum

Fonction Objectif

Le tGreenplumOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tGreenplumOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Greenplum. 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 laide des donnes collectes. Host Port Database Schema Username et Password Table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crire la fois et la table doit dj exister pour que lopration dinsert soit autorise. 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. Clear a table : supprimer le contenu de la table. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Un schma est une description de lignes, i.e., 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.

Basic settings

Action on table

File Name

Schema et Edit Schema

320

Composants Talend Open Studio

Creative Commons License

Composants Databases
tGreenplumOutputBulkExec

Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Advanced settings Action on data Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Les informations demandes seront diffrentes en fonction de laction choisie.

Copy the OID for each Rcupre les identifiants dobjet pour chaque ligne. row Contains a header line Spcifiez que la table contient des lignes den-tte. with the names of each column in the file File type Null string Fields terminated by Escaped char Text enclosure Force not null for columns Slectionnez le type de fichiers traiter. Chane de caractres affiche pour signifier que la valeur est nulle. Caractre, chane ou expression rgulire sparant les champs. Caractre dchappement de la ligne. Caractres utiliss pour entourer le texte. Dfinissez la nullabilit des colonnes Force not null : Cochez la case correspondant la colonne (Column) que vous souhaitez dfinir comme ntant pas nulle.

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est principalement utilis lorsquaucune transformation particulire nest requise sur les donnes charger dans la base de donnes. n/a

Scnarios associs
Pour un scnario associ au tGreenplumOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 521 du tMysqlOutputBulkExec.

Creative Commons License

Composants Talend Open Studio

321

Composants Databases
tGreenplumRollback

tGreenplumRollback
Proprits du tGreenplumRollback
Ce composant est troitement li aux composants tGreenplumCommit et tGreenplumConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Greenplum

Fonction Objectif Basic settings

Le tGreenplumRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tGreenplumConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.

Close Connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants Greenplum, notamment avec le tGreenplumConnection et le tGreenplumCommit. n/a

Scnario associ
Pour un scnario associ au tGreenplumRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524 du composant tMysqlRollback.

322

Composants Talend Open Studio

Creative Commons License

Composants Databases
tGreenplumRow

tGreenplumRow
Proprits du tGreenplumRow
Famille de composant Databases/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. 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. 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 laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tGreenplumConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma

Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

323

Composants Databases
tGreenplumRow

Username et Password Schema et Edit Schema

Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.

Table Name Query type

Nom de la table lire. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide 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. Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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.

Query

Die on error

Advanced settings

Propagate QUERYs recordset Use PreparedStatement

324

Composants Talend Open Studio

Creative Commons License

Composants Databases
tGreenplumRow

Encoding Type

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

Commit every

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 de requtes SQL.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du composant tMySQLRow.

Creative Commons License

Composants Talend Open Studio

325

Composants Databases
tGreenplumSCD

tGreenplumSCD
Le composant tGreenplumSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tGreenplumSCD, page 7.

326

Composants Talend Open Studio

Creative Commons License

Composants Databases
tHiveClose

tHiveClose
Proprits du tHiveClose
Famille de composant Databases/Hive

Fonction Objectif Basic settings

Le composant tHiveClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Hive. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tHiveConnection dans la liste.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a

Scnario associ
Ce composant est troitement li au composant tHiveConnection. Il est gnralement utilis avec un composant tHiveConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tHiveClose, consultez tMysqlConnection page 482

Creative Commons License

Composants Talend Open Studio

327

Composants Databases
tHiveConnection

tHiveConnection
Proprits du tHiveConnection
Famille de composant Databases/Hive

Fonction Objectif Basic settings

Le composant tHiveConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier une fois quil est valid en une seule transaction vers une base de donnes de sortie. 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 laide des donnes collectes. Host Port Database Username et Password Encoding Type Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour partager votre connexion ou rcuprer une 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. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.

Use or register a shared DB Connection

Advanced settings

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant. Ce composant est gnralement utilis avec des composants Hive, notamment le composant tHiveClose. n/a

Utilisation Limitation

328

Composants Talend Open Studio

Creative Commons License

Composants Databases
tHiveConnection

Scnarios associs
Pour un scnario associ au composant tHiveConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.

Creative Commons License

Composants Talend Open Studio

329

Composants Databases
tHiveRow

tHiveRow
Proprits du tHiveRow
Famille de composant Databases/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. 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. 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 laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tHiveConnection adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur.

Objectif

Basic settings

330

Composants Talend Open Studio

Creative Commons License

Composants Databases
tHiveRow

Database Username et Password Schema et Edit Schema

Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Table Name Query type

Nom de la table traiter. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide 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. Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.

Query

Die on error

Advanced settings

Propagate QUERYs recordset Encoding Type

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 de requtes Hive QL.

Creative Commons License

Composants Talend Open Studio

331

Composants Databases
tHiveRow

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du composant tMySQLRow.

332

Composants Talend Open Studio

Creative Commons License

Composants Databases
tHSQLDbInput

tHSQLDbInput
Proprits du tHSQLDbInput
Famille de composant Databases/HSQLDb

Fonction Objectif

Le composant tHSQLDbInput lit les donnes dune base de donnes et extrait les champs selon la requte excute. 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 laide dun lien Main row. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. 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. Cochez cette case pour autoriser, si besoin, le mode scuris. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio.

Basic settings

Use TLS/SSL sockets Host name Port Database Alias Username et Password Schema et Edit Schema

Creative Commons License

Composants Talend Open Studio

333

Composants Databases
tHSQLDbInput

Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Query type Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement. Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Cliquez sur le bouton pour rcuprer le schma de la table. Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Guess Query

Guess schema Query

Advanced settings

Trim all the String/Char columns Trim column

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.

Scnarios associs
Pour des scnarios associs, consultez : le Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258. le Scnario 2 : Utiliser la variable StoreSQLQuery, page 260.

334

Composants Talend Open Studio

Creative Commons License

Composants Databases
tHSQLDbOutput

tHSQLDbOutput
Proprits du tHSQLDbOutput
Famille de composant Databases/HSQLDb

Fonction Objectif Basic settings

Le composant tHSQLDbOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tHSQLDbOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. 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. Cochez cette case pour autoriser, si besoin, le mode scuris. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois.

Use TLS/SSL sockets Host Port Database Username et Password Table

Creative Commons License

Composants Talend Open Studio

335

Composants Databases
tHSQLDbOutput

Action on table

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. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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).

Action on data

Schema et Edit Schema

Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

336

Composants Talend Open Studio

Creative Commons License

Composants Databases
tHSQLDbOutput

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitementprtraitement 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 laction 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.

Advanced settings

Encoding Type

Commit every

Additional Columns

Use field options Enable debug mode

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus dcriture 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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Creative Commons License

Composants Talend Open Studio

337

Composants Databases
tHSQLDbOutput

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Afficher la base de donnes en sortie, page 264 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du composant tMySQLOutput.

338

Composants Talend Open Studio

Creative Commons License

Composants Databases
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. 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. 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 laide 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. Cochez cette case pour autoriser, si besoin, le mode scuris. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Query type Peut tre Built-in ou Repository.

Objectif

Basic settings

Use TLS/SSL sockets Host Port Database Alias Username et Password Schema et Edit Schema

Creative Commons License

Composants Talend Open Studio

339

Composants Databases
tHSQLDbRow

Built-in : Saisissez manuellement votre requte ou construisez-la laide 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. Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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. Encoding Type Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

Query

Die on error

Advanced settings

Propagate QUERYs recordset Use PreparedStatement

Commit every

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 de requtes SQL.

340

Composants Talend Open Studio

Creative Commons License

Composants Databases
tHSQLDbRow

Scnarios associs
Pour des scnarios associs, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528.

Creative Commons License

Composants Talend Open Studio

341

Composants Databases
tInformixBulkExec

tInformixBulkExec
Proprits du tInformixBulkExec
Famille de composant Databases/Informix

Fonction Objectif

Le composant tInformixBulkExec excute des oprations dInsert sur les donnes fournies. Le tInformixBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Informix. 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 laide des donnes collectes. Execution Platform Use an existing connection Slectionnez le type de systme dexploitation que vous utilisez. Cochez cette case et slectionnez le composant tInformixConnection adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes.

Basic settings

342

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInformixBulkExec

Database Schema Username et Password Instance

Nom de la base de donnes. Nom du schma. Informations dauthentification sur lutilisateur de base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Nom de la table crire. Notez quune seule table peut tre crite la fois. 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 table : supprimer le contenu de la table. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Table Action on table

Schema et Edit Schema

Informix Directory Data file

Spcifiez le chemin daccs votre rpertoire Informix. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio.

Creative Commons License

Composants Talend Open Studio

343

Composants Databases
tInformixBulkExec

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 sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 parameters

Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.. Caractre, chane ou expression rgulire sparant les champs. Quand vous cochez cette case, vous pouvez dfinir votre sparateur dcimal dans le champ Decimal separator. Slectionnez le format de date que vous souhaitez appliquer. Saisissez le nombre de lignes traiter avant commit. Saisissez le nombre de lignes derreur avant arrt du Job.

Field terminated by Set DBMONEY

Set DBDATE Rows Before Commit Bad Rows Before Abort

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Output Utilisation Slectionnez lemplacement de la sortie.

Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes DB2.

Scnario associ
Pour un scnario associ au composant tInformixBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.

344

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInformixClose

tInformixClose
Proprits du tInformixClose
Famille de composant Databases/Informix

Fonction Objectif Basic settings

Le composant tInformixClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Informix. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tInformixConnection dans la liste.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a

Scnario associ
Ce composant est troitement li aux composants tInformixConnection et tInformixRollback. Ils sont gnralement utiliss avec un composant tInformixConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tInformixClose, consultez tMysqlConnection page 482

Creative Commons License

Composants Talend Open Studio

345

Composants Databases
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 Objectif

Le composant tInformixCommit valide les donnes traites dans un Job partir dune base de donnes connecte. 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. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tInformixConnection dans la liste. 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.

Basic settings

Close connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Informix et notamment tInformixConnection et tInformixRollback. n/a

Scnario associ
Ce composant est troitement li aux composants tInformixConnection et tInformixRollback. Ils sont gnralement utiliss avec un composant tInformixConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tInformixCommit, consultez tMysqlConnection page 482

346

Composants Talend Open Studio

Creative Commons License

Composants Databases
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 douvrir une connexion pour la transaction en cours.
Famille de composant Databases/Informix

Fonction Objectif Basic settings

Le composant tInformixConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier une fois quil est valid en une seule transaction vers une base de donnes de sortie. 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 laide des donnes collectes. Host Port Database Schema Username et Password Instance Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une 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. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Dcochez cette case lorsque la base de donnes est configure en mode NO_LOG. Si la case est coche, vous pouvez choisir dactiver ou non loption Auto Commit.

Additional JDBC parameters Use or register a shared DB Connection

Advanced settings

Use Transaction

Creative Commons License

Composants Talend Open Studio

347

Composants Databases
tInformixConnection

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est gnralement utilis avec des composants Informix, notamment les composants tInformixCommit et tInformixRollback. n/a

Scnarios associs
Pour un scnario associ au composant tInformixConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.

348

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInformixInput

tInformixInput
Proprits du tInformixInput
Famille de composant Databases/Informix

Fonction Objectif

Le composant tInformixInput lit une base de donnes et en extrait des champs laide de requtes. 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). 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez cette case et slectionnez le composant adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Un schma est une description de lignes, i.e., 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.

Basic settings

Host name Port Database Schema Username et Password Instance

Schema et Edit Schema

Creative Commons License

Composants Talend Open Studio

349

Composants Databases
tInformixInput

Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Cliquez sur le bouton pour rcuprer le schma de la table. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Guess Query

Guess schema Advanced settings Additional JDBC parameters

Trim all the String/Char columns Trim column

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

Scnarios associs
Consultez les scnarios associs au composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260 Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1122 du composant tContextLoad.

350

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInformixOutput

tInformixOutput
Proprits du tInformixOutput
Famille de composant Databases/Informix

Fonction Objectif Basic settings

Le composant tInformixOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tInformixOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez cette case et slectionnez le composant adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Nom de la table crer. Vous ne pouvez crer quune seule table la fois.

Host Port Database Schema Username et Password Instance

Table

Creative Commons License

Composants Talend Open Studio

351

Composants Databases
tInformixOutput

Action on table

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. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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).

Action on data

Schema et Edit Schema

Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio.

352

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInformixOutput

Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Die on error Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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 Enable debug mode Batch size Optimize the batch insertion Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus dcriture dans la base de donnes. Nombre de lignes dans chaque lot de traitement de donnes. Cocher cette case optimise linsertion de donnes par lots.

Advanced settings

Additional JDBC parameters

Commit every

Additional Columns

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Creative Commons License

Composants Talend Open Studio

353

Composants Databases
tInformixOutput

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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ au composant tInformixOutput, consultez : le Scnario : Afficher la base de donnes en sortie, page 264 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du composant tMySQLOutput.

354

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInformixOutputBulk

tInformixOutputBulk
Proprits du tInformixOutputBulk
Les composants tInformixOutputBulk et tInformixBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tInformixOutputBulkExec, dtaill dans une section spare. Lintrt 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 Objectif Basic settings

Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Informix. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Informix. 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 laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Append Schema et Edit Schema

Advanced settings

Row separator Field separator

Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs.

Creative Commons License

Composants Talend Open Studio

355

Composants Databases
tInformixOutputBulk

Set DBMONEY

Quand vous cochez cette case, vous pouvez dfinir votre sparateur dcimal dans le champ Decimal separator. Slectionnez le format de date que vous souhaitez appliquer.

Set DBDATE

Create directory if not Cette case est coche par dfaut. Cette option permet exists de crer le dossier contenant le fichier de sortie sil nexiste 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. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.

Encoding Type

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec le composant tInformixBulkExec. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes Informix.

Scnarios associs
Pour un scnario associ au tInformixOutputBulk, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 521 du tMysqlOutputBulkExec.

356

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInformixOutputBulkExec

tInformixOutputBulkExec
Proprits du tInformixOutputBulkExec
Famille de composant Databases/Informix

Fonction Objectif

Le tInformixOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tInformixOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Informix. 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 laide des donnes collectes. Execution platform Use an existing connection Slectionnez le type de systme dexploitation que vous utilisez. Cochez cette case et slectionnez le composant tInformixConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.

Basic settings

Creative Commons License

Composants Talend Open Studio

357

Composants Databases
tInformixOutputBulkExec

Schema Username et Password Instance

Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Nom de la table crire. Notez quune seule table peut tre crire la fois et la table doit dj exister pour que lopration dinsert soit autorise. 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. Clear table : supprimer le contenu de la table. Un schma est une description de lignes, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Table

Action on table

Schema et Edit Schema

Informix Directory Data file

Spcifiez le chemin daccs votre rpertoire Informix. Nom du fichier traiter. Voir galement :Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Les informations demandes seront diffrentes en fonction de laction choisie. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Chane (ex : \n sous Unix) sparant les lignes.

Append Action on data

Advanced settings

Additional JDBC parameters

Row separator

358

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInformixOutputBulkExec

Fields terminated by Set DBMONEY

Caractre, chane ou expression rgulire sparant les champs. Quand vous cochez cette case, vous pouvez dfinir votre sparateur dcimal dans le champ Decimal separator. Slectionnez le format de date que vous souhaitez appliquer. Saisissez le nombre de lignes traiter avant commit. Saisissez le nombre de lignes derreur avant arrt du Job.

Set DBDATE Rows Before Commit Bad Rows Before Abort

Create directory if not Cette case est coche par dfaut. Cette option permet exists de crer le dossier contenant le fichier de sortie sil nexiste 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. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.

Encoding Type

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Output Utilisation Limitation Slectionnez lemplacement de la sortie.

Ce composant est principalement utilis lorsquaucune transformation particulire nest requise sur les donnes charger dans la base de donnes. n/a

Scnarios associs
Pour un scnario associ au tInformixOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 521 du tMysqlOutputBulkExec.

Creative Commons License

Composants Talend Open Studio

359

Composants Databases
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 Objectif Basic settings

Le tInformixRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tInformixConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.

Close Connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants Informix, notamment avec le tInformixConnection et le tInformixCommit. n/a

Scnario associ
Pour un scnario associ au tInformixRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524 du composant tMysqlRollback.

360

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInformixRow

tInformixRow
Proprits du tInformixRow
Famille de composant Databases/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. 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. 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 laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tInformixConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur.

Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

361

Composants Databases
tInformixRow

Database Schema Username et Password Instance

Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Schema et Edit Schema

Table Name Query type

Nom de la table. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.

Query

Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Dcochez cette case lorsque la base de donnes est configure en mode NO_LOG. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column.

Guess Query

Die on error

Use Transaction Advanced settings Additional JDBC parameters

Propagate QUERYs recordset

362

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInformixRow

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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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 lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

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 de requtes SQL.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du composant tMySQLRow.

Creative Commons License

Composants Talend Open Studio

363

Composants Databases
tInformixSCD

tInformixSCD
Le composant tInformixSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tInformixSCD, page 9.

364

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInformixSP

tInformixSP
Proprits du tInformixSP
Famille de composant Databases/Informix

Fonction Objectif Basic settings

Le composant tInformixSP appelle une procdure stocke de base de donnes. Le tInformixSP permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les appeler plus facilement. 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 laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tInformixConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Username et Password Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes.

Creative Commons License

Composants Talend Open Studio

365

Composants Databases
tInformixSP

Instance

Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., 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. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est rutilisable. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Schema et Edit Schema

SP Name Is Function / Return result in

Saisissez le nom exact de la Procdure Stocke (SP). 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. 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 quil ny a de paramtres utiliss dans la procdure. Slectionnez le Type de paramtre : IN : paramtre dentre (Input) OUT : paramtre de sortie (Output)/valeur retourne IN OUT : les paramtres dentre doivent tre retournes sous forme de valeur, mme aprs modifications via la procdure (fonction). RECORDSET : les paramtres dentre doivent tre retournes sous forme densemble de valeurs, au lieu dune valeur unique. Consultez le composant tParseRecordSet si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL. Dcochez cette case lorsque la base de donnes est configure en mode NO_LOG. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.

Parameters

Use Transaction Advanced settings Additional JDBC parameters

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls les paramtres dentre sont autoriss.

366

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInformixSP

Limitation

La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Trouver le libell State laide dune procdure stocke, page 539 du composant tMysqlSP. le Scnario : Vrifier le format de numros laide dune procdure stocke, page 599 du composant tOracleSP. Consultez galement le composant tParseRecordSet, page 629 si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.

Creative Commons License

Composants Talend Open Studio

367

Composants Databases
tIngresClose

tIngresClose
Proprits du tIngresClose
Famille de composant Databases/Ingres

Fonction Objectif Basic settings

Le composant tIngresClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Ingres. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tIngresConnection dans la liste.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a

Scnario associ
Ce composant est troitement li aux composants tIngresConnection et tIngresRollback. Ils sont gnralement utiliss avec un composant tIngresConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tIngresClose, consultez tMysqlConnection page 482

368

Composants Talend Open Studio

Creative Commons License

Composants Databases
tIngresCommit

tIngresCommit
Proprits du tIngresCommit
Ce composant est troitement li aux composants tIngresConnection et tIngresRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Ingres

Fonction Objectif

Le composant tIngresCommit valide les donnes traites dans un Job partir dune base de donnes connecte. 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. Component list Slectionnez le composant tIngresConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. 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.

Basic settings

Close Connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants JDBC et notamment avec les composants tIngresConnection et tIngresRollback. n/a

Scnario associ
Pour un scnario associ au tIngresCommit, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.

Creative Commons License

Composants Talend Open Studio

369

Composants Databases
tIngresConnection

tIngresConnection
Proprits du tIngresConnection
Ce composant est troitement li aux composants tIngresCommit et tIngresRollback. Ils sont gnralement utiliss avec un composant tIngresConnection car il permet douvrir une connexion pour la transaction en cours.
Famille de composant Databases/Ingres

Fonction Objectif Basic settings

Le composant tIngresConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. 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 laide des donnes collectes. Server Port Database Table Schema Username et Password Use or register a shared DB Connection Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une 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. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.

Utilisation Limitation

Ce composant est gnralement utilis avec des composants JDBC et notamment avec les composants tIngresCommit et tIngresRollback. n/a

Scnario associ
Pour un scnario associ au tIngresConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.

370

Composants Talend Open Studio

Creative Commons License

Composants Databases
tIngresInput

tIngresInput
Proprits du tIngresInput
Famille de composant Databases/Ingres

Fonction Objectif

Le composant tIngresInput lit une base de donnes et en extrait des champs laide de requtes. 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). 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Server Port Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Basic settings

Creative Commons License

Composants Talend Open Studio

371

Composants Databases
tIngresInput

Query type et Query

Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Advanced settings

Trim all the String/Char columns Trim column

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

Scnarios associs
Consultez les scnarios associs au composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260 Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1122 du composant tContextLoad.

372

Composants Talend Open Studio

Creative Commons License

Composants Databases
tIngresOutput

tIngresOutput
Proprits du tIngresOutput
Famille de composant Databases/Ingres

Fonction Objectif Basic settings

Le composant tIngresOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tIngresOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Port Database Username et Password Table Action on table Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. 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.

Creative Commons License

Composants Talend Open Studio

373

Composants Databases
tIngresOutput

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 sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.

Advanced settings

Encoding Type

374

Composants Talend Open Studio

Creative Commons License

Composants Databases
tIngresOutput

Commit every

Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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.

Additional Columns

Use field options Enable debug mode

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus dcriture 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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Afficher la base de donnes en sortie, page 264 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du composant tMySQLOutput.

Creative Commons License

Composants Talend Open Studio

375

Composants Databases
tIngresRollback

tIngresRollback
Proprits du tIngresRollback
Ce composant est troitement li aux composants tIngresCommit et tIngresConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Ingres

Fonction Objectif Basic settings

Le tIngresRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tIngresConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.

Close Connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants Ingres, notamment avec le tIngresConnection et le tIngresCommit. n/a

Scnario associ
Pour un scnario associ au tIngresRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524 du composant tMysqlRollback.

376

Composants Talend Open Studio

Creative Commons License

Composants Databases
tIngresRow

tIngresRow
Proprits du tIngresRow
Famille de composant Databases/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. 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. 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 laide des donnes collectes. Host Port Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Query type Nom de la table traiter. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.

Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

377

Composants Databases
tIngresRow

Query

Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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.

Die on error

Advanced settings

Propagate QUERYs recordset Use PreparedStatement

Encoding Type

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

Commit every

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 de requtes SQL.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du composant tMySQLRow.

378

Composants Talend Open Studio

Creative Commons License

Composants Databases
tIngresSCD

tIngresSCD
Le composant tIngresSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tIngresSCD, page 11.

Creative Commons License

Composants Talend Open Studio

379

Composants Databases
tInterbaseClose

tInterbaseClose
Proprits du tInterbaseClose
Famille de composant Databases/Interbase

Fonction Objectif Basic settings

Le composant tInterbaseClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Interbase. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tInterbaseConnection dans la liste.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a

Scnario associ
Ce composant est troitement li aux composants tInterbaseConnection et tInterbaseRollback. Ils sont gnralement utiliss avec un composant tInterbaseConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tInterbaseClose, consultez tMysqlConnection page 482

380

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInterbaseCommit

tInterbaseCommit
Proprits du tInterbaseCommit
Ce composant est troitement li aux composants tInterbaseConnection et tInterbaseRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Interbase

Fonction Objectif

Le composant tInterbaseCommit valide les donnes traites dans un Job partir dune base de donnes connecte. 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. Component list Slectionnez le composant tInterbaseConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. 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.

Basic settings

Close Connection

Advanced settings Utilisation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Interbase et notamment avec les composants tInterbaseConnection et tInterbaseRollback. n/a

Limitation

Scnario associ
Pour un scnario associ au tInterbaseCommit, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.

Creative Commons License

Composants Talend Open Studio

381

Composants Databases
tInterbaseConnection

tInterbaseConnection
Proprits du tInterbaseConnection
Ce composant est troitement li aux composants tInterbaseCommit et tInterbaseRollback. Ils sont gnralement utiliss avec un composant tInterbaseConnection car il permet douvrir une connexion pour la transaction en cours.
Famille de composant Databases/Interbase

Fonction Objectif Basic settings

Le composant tInterbaseConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier une fois quil est valid en une seule transaction vers une base de donnes de sortie. 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 laide des donnes collectes. Host Port Database Table Schema Username et Password Encoding Type Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour partager votre connexion ou rcuprer une 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. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.

Use or register a shared DB Connection

Utilisation Limitation

Ce composant est gnralement utilis avec des composants Interbase, notamment les composants tInterbaseCommit et tInterbaseRollback. n/a

382

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInterbaseConnection

Scnarios associs
Pour un scnario associ au composant tInterbaseConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.

Creative Commons License

Composants Talend Open Studio

383

Composants Databases
tInterbaseInput

tInterbaseInput
Proprits du tInterbaseInput
Famille de composant Databases/Interbase

Fonction Objectif

Le composant tInterbaseInput lit une base de donnes et en extrait des champs laide de requtes. 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). 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.

Basic settings

384

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInterbaseInput

Advanced settings

Encoding Type

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Trim all the String/Char columns Trim column

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

Scnarios associs
Consultez les scnarios associs au composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260 Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1122 associ au composant tContextLoad.

Creative Commons License

Composants Talend Open Studio

385

Composants Databases
tInterbaseOutput

tInterbaseOutput
Proprits du tInterbaseOutput
Famille de composant Databases/Interbase

Fonction Objectif Basic settings

Le composant tInterbaseOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tInterbaseOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Database Username et Password Table Action on table Adresse IP du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. 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.

386

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInterbaseOutput

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 sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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. Un schma est une description de lignes, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Schema et Edit Schema

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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.

Creative Commons License

Composants Talend Open Studio

387

Composants Databases
tInterbaseOutput

Advanced settings

Encoding Type

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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.

Commit every

Additional Columns

Use field options Enable debug mode

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus dcriture 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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Afficher la base de donnes en sortie, page 264 associ au composant tDBOutput.

388

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInterbaseOutput

le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 associ au composant tMySQLOutput.

Creative Commons License

Composants Talend Open Studio

389

Composants Databases
tInterbaseRollback

tInterbaseRollback
Proprits du tInterbaseRollback
Ce composant est troitement li aux composants tInterbaseCommit et tInterbaseConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Interbase

Fonction Objectif Basic settings

Le tInterbaseRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tInterbaseConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.

Close Connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants Interbase, notamment avec le tInterbaseConnection et le tInterbaseCommit. n/a

Scnario associ
Pour un scnario associ au tInterbaseRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524 du composant tMySQLRollback.

390

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInterbaseRow

tInterbaseRow
Proprits du tInterbaseRow
Famille de composant Databases/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. 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. 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 laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tInterbaseConnection adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Database Adresse IP du serveur de base de donnes. Nom de la base de donnes.

Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

391

Composants Databases
tInterbaseRow

Username et Password Table Name Schema et Edit Schema

Informations dauthentification de lutilisateur de base de donnes. Nom de la table traiter. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Query type

Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.

Query

Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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.

Die on error

Advanced settings

Propagate QUERYs recordset Use PreparedStatement

392

Composants Talend Open Studio

Creative Commons License

Composants Databases
tInterbaseRow

Encoding Type

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

Commit every

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 de requtes SQL.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 associ au composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 associ au composant tMySQLRow.

Creative Commons License

Composants Talend Open Studio

393

Composants Databases
tJavaDBInput

tJavaDBInput
Proprits du tJavaDBInput
Famille de composant Databases/JavaDB

Fonction Objectif

Le composant tJavaDBInput lit une base de donnes et en extrait des champs laide de requtes. 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). 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Framework Database DB root path Username et Password Schema et Edit Schema Slectionnez dans la liste un framework pour votre base de donnes Java. Nom de la base de donnes. Parcourez vos fichiers jusqu la racine de votre base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Basic settings

394

Composants Talend Open Studio

Creative Commons License

Composants Databases
tJavaDBInput

Query type et Query

Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Advanced settings

Encoding Type

Trim all the String/Char columns Trim column

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

Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260 Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1122 du composant tContextLoad.

Creative Commons License

Composants Talend Open Studio

395

Composants Databases
tJavaDBOutput

tJavaDBOutput
Proprits du tJavaDBOutput
Famille de composant Databases/JavaDB

Fonction Objectif Basic settings

Le composant tJavaDBOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tJavaDBOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Framework Database DB root path Username et Password Table Action on table Slectionnez dans la liste un framework pour votre base de donnes Java. Nom de la base de donnes. Parcourez vos fichiers jusqu la racine de votre base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. 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.

396

Composants Talend Open Studio

Creative Commons License

Composants Databases
tJavaDBOutput

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 sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.

Advanced settings

Encoding Type

Creative Commons License

Composants Talend Open Studio

397

Composants Databases
tJavaDBOutput

Commit every

Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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.

Additional Columns

Use field options Enable debug mode

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus dcriture 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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Scnarios asoocis
Pour un scnario associ, consultez : le Scnario : Afficher la base de donnes en sortie, page 264 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du composant tMySQLOutput.

398

Composants Talend Open Studio

Creative Commons License

Composants Databases
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. 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. 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 laide des donnes collectes. Framework Type Database DB root path Username et Password Schema et Edit Schema Slectionnez dans la liste un framework pour votre base de donnes Java. Nom de la base de donnes. Parcourez vos fichiers jusqu la racine de votre base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Query type Nom de la table traiter. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder.

Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

399

Composants Databases
tJavaDBRow

Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement. Query Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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. Encoding Type Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

Die on error

Advanced settings

Propagate QUERYs recordset Use PreparedStatement

Commit every

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 de requtes SQL.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du composant tDBSQLRow.

400

Composants Talend Open Studio

Creative Commons License

Composants Databases
tJavaDBRow

le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du composant tMySQLRow.

Creative Commons License

Composants Talend Open Studio

401

Composants Databases
tJDBCColumnList

tJDBCColumnList
Proprits du tJDBCColumnList
Famille de composants Databases/JDBC

Fonction Objectif Basic settings

Le composant tJDBCColumList effectue une opration ditration dans toutes les colonnes dune table donne, grce une connexion JDBC dfinie. Le tJDBCColumList permet de faire une liste des libells des colonnes dune table JDBC donne. Component list Slectionnez le composant tJDBCConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Nom de la table lire.

Table name Utilisation Limitation

Il faut utiliser ce composant en association avec les autres composants JDBC, notamment avec le tJDBCConnection. n/a

Scnario associ
Pour un scnario associ, consultez le Scnario : Itrer une table de base de donnes et lister le nom des colonnes de la table, page 477.

402

Composants Talend Open Studio

Creative Commons License

Composants Databases
tJDBCClose

tJDBCClose
Proprits du tJDBCClose
Famille de composant Databases/JDBC

Fonction Objectif Basic settings

Le composant tJDBCClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes JDBC. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tJDBCConnection dans la liste.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a

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 page 482

Creative Commons License

Composants Talend Open Studio

403

Composants Databases
tJDBCCommit

tJDBCCommit
Proprits du tJDBCCommit
Ce composant est troitement li aux composants tJDBCConnection et tJDBCRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/JDBC

Fonction Objectif

Le composant tJDBCCommit valide les donnes traites dans un Job partir dune base de donnes connecte. 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. Component list Slectionnez le composant tJDBCConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. 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.

Basic settings

Close connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants JDBC et notamment avec les composants tJDBCConnection et tJDBCRollback. n/a

Scnario associ
Ce composant est troitement li aux composants tJDBCConnection et tJDBCRollback. Ils sont gnralement utiliss avec un composant tJDBCConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tJDBCCommit, consultez tMysqlConnection page 482.

404

Composants Talend Open Studio

Creative Commons License

Composants Databases
tJDBCConnection

tJDBCConnection
Proprits du tJDBCConnection
Ce composant est troitement li aux composants tJDBCCommit et tJDBCRollback. Ils sont gnralement utiliss avec un composant tJDBCConnection car il permet douvrir une connexion pour la transaction en cours.
Famille de composant Databases/JDBC

Fonction Objectif Basic settings

Le composant tJDBCConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie.

JDBC URL

Entrez lURL 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. Slectionnez le driver disponible voulu partir de la liste droulante Driver JAR ou tlchargez-le partir dun rpertoire local en cliquant sur le bouton [...]. 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. Entrez les informations dauthentification de lutilisateur de base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour partager votre connexion ou rcuprer une 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. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case afin dafficher la case Auto Commit. Si vous la cochez, elle activera le mode auto-commit. Une fois la case Use Auto-Commit dcoche, la case Auto-Commit ne sera plus visible.

Driver JAR

Driver Class

Username et Password Encoding type

Use or register a shared DB Connection

Advanced settings

Use Auto commit

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, au niveau de chaque composant.

Creative Commons License

Composants Talend Open Studio

405

Composants Databases
tJDBCConnection

Utilisation Limitation

Ce composant est gnralement utilis avec des composants JDBC et notamment avec les composants tJDBCCommit et tJDBCRollback. n/a

Scnario associ
Ce composant est troitement li aux composants tJDBCCommit et tJDBCRollback. Ils sont gnralement utiliss avec un composant tJDBCConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tJDBCConnection, consultez tMysqlConnection page 482.

406

Composants Talend Open Studio

Creative Commons License

Composants Databases
tJDBCInput

tJDBCInput
Proprits du tJDBCInput
Famille de composant Databases/JDBC

Fonction Objectif

Le composant tJDBCInput lit toute base de donnes via une API JDBC et en extrait des champs laide de requtes. 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). 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 laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tJDBCConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.

Basic settings

Creative Commons License

Composants Talend Open Studio

407

Composants Databases
tJDBCInput

Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. JDBC URL Driver JAR Entrez le chemin daccs la base de donnes. Slectionnez le driver JAR partir de la liste droulante ou cliquez sur les trois points [...] pour ajouter un nouveau JAR la liste. Dans le champ Class name, renseignez le nom de la classe pour quelle soit indique dans le driver. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Query type et Query Nom de la table lire. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en une fois. Cette option permet doptimiser les performances. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Class Name Username et Password Schema et Edit Schema

Advanced settings

Encoding Type

Use cursor

Trim all the String/Char columns Trim column

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

408

Composants Talend Open Studio

Creative Commons License

Composants Databases
tJDBCInput

Utilisation

Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes utilisant une connection JDBC.

Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258. Scnario 2 : Utiliser la variable StoreSQLQuery, page 260. Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1122 du composant tContextLoad.

Creative Commons License

Composants Talend Open Studio

409

Composants Databases
tJDBCOutput

tJDBCOutput
Proprits du tJDBCOutput
Famille de composant Databases/JDBC

Fonction Objectif Basic settings

Le composant tJDBCOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tJDBCOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. JDBC URL Use an existing connection Entrez le chemin daccs la base de donnes. Cochez cette case et slectionnez le composant tJDBCConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio . Driver JAR Slectionnez le driver JAR partir de la liste droulante ou cliquez sur les trois points [...] pour ajouter un nouveau JAR la liste.

410

Composants Talend Open Studio

Creative Commons License

Composants Databases
tJDBCOutput

Class Name Username et Password Table Action on data

Dans le champ Class name, renseignez le nom de la classe pour quelle soit indique dans le driver. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Creative Commons License

Composants Talend Open Studio

411

Composants Databases
tJDBCOutput

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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.

Advanced settings

Encoding Type

Commit every

Additional Columns

Use field options Enable debug mode Use Batch Size

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus dcriture dans la base de donnes. Nombre de lignes dans chaque lot de traitement 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 dune table dune base de donnes JDBC. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

412

Composants Talend Open Studio

Creative Commons License

Composants Databases
tJDBCOutput

Scnarios associs
Pour un scnario associ au tJDBCOutput, consultez : le Scnario : Afficher la base de donnes en sortie, page 264 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du composant tMySQLOutput.

Creative Commons License

Composants Talend Open Studio

413

Composants Databases
tJDBCRollback

tJDBCRollback
Proprits du tJDBCRollback
Ce composant est troitement li aux composants tJDBCCommit et tJDBCConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/JDBC

Fonction Objectif Basic settings

Le tJDBCRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tJDBCConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.

Close connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants Oracle, notamment avec le tOracleConnection et le tOracleCommit. n/a

Scnario associ
Ce composant est troitement li aux composants tJDBCConnection et tJDBCCommit. Ils sont gnralement utiliss avec un composant tJDBCConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tJDBCRollback, consultez tMysqlConnection page 482.

414

Composants Talend Open Studio

Creative Commons License

Composants Databases
tJDBCRow

tJDBCRow
Proprits du tJDBCRow
Famille de composant Databases/JDBC

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. 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. Use an existing connection Cochez cette case et slectionnez le composant tJDBCConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. JDBC URL Driver JAR Entrez le chemin daccs la base de donnes. Slectionnez le driver JAR partir de la liste droulante ou cliquez sur les trois points [...] pour ajouter un nouveau JAR la liste. Renseignez le nom de la classe pour quelle soit indique dans le driver. Informations dauthentification de lutilisateur de base de donnes.

Objectif

Basic settings

Class Name Username et Password

Creative Commons License

Composants Talend Open Studio

415

Composants Databases
tJDBCRow

Schema et Edit Schema

Un schma est une description de lignes, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Query type

Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.

Query

Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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.

Die on error

Advanced settings

Propagate QUERYs recordset Use PreparedStatement

Encoding Type

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.

416

Composants Talend Open Studio

Creative Commons License

Composants Databases
tJDBCRow

Commit every

Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

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

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du composant tMySQLRow.

Creative Commons License

Composants Talend Open Studio

417

Composants Databases
tJDBCSP

tJDBCSP
Proprits du tJDBCSP
Famille de composant Databases/JDBC

Fonction Objectif Basic settings

Le composant tJDBCSP appelle une procdure stocke de base de donnes. Le tJDBCSP permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les appeler plus facilement. JDBC URL Driver JAR Entrez le chemin daccs la base de donnes. Slectionnez le driver JAR partir de la liste droulante ou cliquez sur les trois points [...] pour ajouter un nouveau JAR la liste. Dans le champ Class name, renseignez le nom de la classe pour quelle soit indique dans le driver. Informations dauthentification de lutilisateur de base de donnes. Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., 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. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est rutilisable. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. SP Name Is Function / Return result in Saisissez le nom exact de la Procdure Stocke (SP). 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.

Class Name Username et Password Schema et Edit Schema

418

Composants Talend Open Studio

Creative Commons License

Composants Databases
tJDBCSP

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 quil ny a de paramtres utiliss dans la procdure. Slectionnez le Type de paramtre : IN : paramtre dentre (Input) OUT : paramtre de sortie (Output)/valeur retourne IN OUT : les paramtres dentre doivent tre retournes sous forme de valeur, mme aprs modifications via la procdure (fonction). RECORDSET : les paramtres dentre doivent tre retournes sous forme densemble de valeurs, au lieu dune valeur unique. Consultez le composant tParseRecordSet si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.

Advanced settings

Encoding Type

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls les paramtres dentre sont autoriss. La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Trouver le libell State laide dune procdure stocke, page 539 du composant tMysqlSP. le Scnario : Vrifier le format de numros laide dune procdure stocke, page 599 du composant tOracleSP. Consultez galement le composant tParseRecordSet, page 629 si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.

Creative Commons License

Composants Talend Open Studio

419

Composants Databases
tJDBCTableList

tJDBCTableList
Proprits du tJDBCTableList
Famille de composant Databases/JDBC

Fonction Objectif Basic settings

Le composant tJDBCTableList effectue une opration ditration sur toutes les tables dune base de donnes, grce une connexion JDBC dfinie. Le composant tJDBCTableList permet de lister les noms des tables JDBC grce aux commandes SELECT et WHERE. Component list Slectionnez le composant de connexion tJDBCConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours.

Where clause for table Saisissez la commande WHERE permettant name selection didentifier les tables sur lesquelles effectuer lopration ditration. Utilisation Limitation Il faut utiliser ce composant en association avec les autres composants JDBC, notamment avec le tJDBCConnection. n/a

Scnario associ
Pour un scnario associ, consultez le Scnario : Itrer une table de base de donnes et lister le nom des colonnes de la table, page 477.

420

Composants Talend Open Studio

Creative Commons License

Composants Databases
tLDAPAttributesInput

tLDAPAttributesInput
Proprits du tLDAPAttributesInput
Famille de composant Databases/LDAP

Fonction Objectif

Le composant tLDAPAttributesInput analyse chaque lment trouv via une requte LDAP et liste une srie dattributs associs lobjet. 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. 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 laide des donnes collectes. Host Port Base DN Protocol Adresse IP du serveur dannuaire LDAP. Numro du port dcoute du serveur. Chemin daccs larborescence de lutilisateur autoris. Slectionnez le type de protocole dans la liste. LDAP : aucun codage nest 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 dun 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. Cochez Authentication si une connexion LDAP est ncessaire. Notez que le login doit correspondre la syntaxe LDAP pour tre valide. Par exemple : cn=Directory Manager. Saisissez le filtre comme attendu par lannuaire LDAP db. Saisissez le sparateur de valeur des champs valeurs multiples.

Basic settings

Authentication User et Password

Filter Multi valued field separator

Creative Commons License

Composants Talend Open Studio

421

Composants Databases
tLDAPAttributesInput

Alias dereferencing

Slectionnez loption dans la liste. Never permet lamlioration des performances de recherche si vous tes sr quaucun alias nest 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. Slectionnez loption dans la liste : Ignore : ne tient pas compte des redirections des requtes Follow : tient compte des redirections des requtes Cette option permet de limiter le nombre denregistrement lus, si ncessaire. Cette option permet de limiter la dure de connexion lannuaire. Spcifiez le nombre dentres retournes en une fois par le serveur LDAP. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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.

Referral handling

Limit Time Limit Paging Die on error

Schema et Edit Schema Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Comme ce composant sert lister les attributs associs un lment LDAP, sont schma est prdfini. Conservez ces colonnes dfinies, mme si vous avez besoin dajouter de nouvelles colonnes. Pour cela, utilisez le mode Built-In.

422

Composants Talend Open Studio

Creative Commons License

Composants Databases
tLDAPAttributesInput

Le schma prdfini comprend : - objectclass : liste des classes dlments - 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 tStatCatcher Statistics Utilisation Spcifiez la racine de lespace de nom de llment Class definition. Cochez cette case pour collecter les donnes de log au niveau du composant.

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.

Scnario associ
Le composant tLDAPAttributesInput fonctionne de manire similaire au tLDAPInput. Vous pouvez donc consulter le Scnario : Afficher le contenu filtr dun annuaire LDAP, page 426

Creative Commons License

Composants Talend Open Studio

423

Composants Databases
tLDAPInput

tLDAPInput
Proprits du tLDAPInput
Famille de composant Databases/LDAP

Fonction Objectif

Le composant tLDAPInput lit un rpertoire et extrait les donnes en fonction dun filtre dfini. 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. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio . Host Port Base DN Protocol Adresse IP du serveur dannuaire LDAP. Numro du port dcoute du serveur. Chemin daccs larborescence de lutilisateur autoris. Slectionnez le type de protocole dans la liste. LDAP : aucun codage nest 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 dun 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. Cochez Authentication si une connexion LDAP est ncessaire. Notez que le login doit correspondre la syntaxe LDAP pour tre valide. Par exemple : cn=Directory Manager.

Basic settings

Authentication User et Password

424

Composants Talend Open Studio

Creative Commons License

Composants Databases
tLDAPInput

Filter Multi valued field separator Alias dereferencing

Saisissez le filtre comme attendu par lannuaire LDAP db. Saisissez le sparateur de valeur des champs valeurs multiples. Slectionnez loption dans la liste. Never permet lamlioration des performances de recherche si vous tes sr quaucun alias nest 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. Slectionnez loption dans la liste : Ignore : ne tient pas compte des redirections des requtes Follow : tient compte des redirections des requtes Cette option permet de limiter le nombre denregistrement lus, si ncessaire. Cette option permet de limiter la dure de connexion lannuaire. Spcifiez le nombre dentres retournes en une fois par le serveur LDAP. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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.

Referral handling

Limit Time Limit Paging Die on error

Schema et Edit Schema Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. 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.

Creative Commons License

Composants Talend Open Studio

425

Composants Databases
tLDAPInput

Scnario : Afficher le contenu filtr dun annuaire LDAP


Le Job dcrit ci-dessous filtre simplement lannuaire LDAP et affiche le rsultat dans la console Run Job.

Cliquez et dposez les composants tLDAPInput et tLogRow. Paramtrez les proprits du tLDAPInput. Slectionnez Repository dans le champ Property type si vous avez stock les informations de connexion LDAP dans le Metadata Manager du Repository. Puis slectionnez lentre adquate dans la liste. En mode Built-In, renseignez manuellement les champs Host et Port. Host peut tre ladresse IP du serveur de lannuaire LDAP ou son nom DNS. Aucune Base DN particulire ne doit tre paramtre.

Puis dans le champ Protocol, slectionnez le protocole adquat dans la liste. Dans cet exemple : un protocole LDAP simple est utilis.

426

Composants Talend Open Studio

Creative Commons License

Composants Databases
tLDAPInput

Cochez la case Authentication et renseignez les informations de connexion pour lire lannuaire, si ncessaire. Dans ce scnario, aucune authentification nest ncessaire. 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)). Renseignez le champ Multi-valued field separator avec une virgule, puisque certains champs contiennent plus dune valeur spare par une virgule. Comme nous ne savons pas si des alias sont utiliss dans lannuaire LDAP, slectionnez Always dans la liste. Slectionnez Ignore dans le champ Referral handling. Dans le champ Limit, dfinissez la limite 100 dans cet exemple.

Dfinissez le Schma tel quil est requis par lannuaire LDAP. Dans cet exemple, le schma est compos de 6 colonnes dont les colonnes objectClass et uid qui seront filtres. Dans le composant tLogRow, aucune configuration particulire nest exige.

Seule une entre de lannuaire correspond aux critres du filtre dfini dans le composant tLDAPInput.

Creative Commons License

Composants Talend Open Studio

427

Composants Databases
tLDAPOutput

tLDAPOutput
Proprits du tLDAPOutput
Famille de composant Databases/LDAP

Fonction Objectif

Le composant tLDAPOutput crit dans un annuaire LDAP. 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. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Port Base DN Protocol Adresse IP du serveur dannuaire LDAP. Numro de port dcoute du serveur. Chemin daccs larborescence de lutilisateur autoris. Slectionnez le type de protocole dans la liste. LDAP : aucun codage nest 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 dun 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. Renseignez les champs User (utilisateur) et Password (mot de passe) conformment lannuaire. Notez que le login doit correspondre la syntaxe LDAP pour tre valide. Par exemple : cn=Directory Manager. Caractre, chane ou expression rgulire sparant les informations dans un champ multi-valu.

Basic settings

User et Password

Multi valued field separator

428

Composants Talend Open Studio

Creative Commons License

Composants Databases
tLDAPOutput

Alias dereferencing

Slectionnez loption dans la liste. Never permet lamlioration des performances de recherche si vous tes sr quaucun alias nest 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. Slectionnez loption dans la liste : Ignore : ne tient pas compte des redirections des requtes. Follow : tient compte des redirections des requtes. Slectionnez laction 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 lannuaire Insert or Update : insre et met jour les donnes Slectionnez, partir de la liste droulante, le type dentre LDAP utilis. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Referral handling

Insert mode

DN Column Name Schema et Edit Schema

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation

tStatCatcher Statistics

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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Creative Commons License

Composants Talend Open Studio

429

Composants Databases
tLDAPOutput

Scnario : Editer des donnes dans un annuaire LDAP

Le scnario suivant dcrit un Job qui lit un annuaire LDAP, met jour lemail dune entre slectionne et affiche la sortie avant de mettre jour lannuaire LDAP en sortie. Cest--dire quaucun alias nest drfrenc et quaucune requte nest redirige. Ce scnario est bas sur le scnario du LDAPInput (cf. Scnario : Afficher le contenu filtr dun annuaire LDAP, page 426). Le rsultat obtenu est une entre simple, correspondant une personne organisationnelle dont lemail est mis jour.

Cliquez et dposez les composants tLDAPInput, tLDAPOutput, tMap et tLogRow dans lespace de modlisation. Connectez le composant dentre au tMap puis au tLogRow puis au composant de sortie. Dans la vue Component du tLDAPInput, paramtrez les informations de connexion au serveur dannuaire LDAP, ainsi que les filtres tel que dcrit dans le Scnario : Afficher le contenu filtr dun annuaire LDAP, page 426. Simplifiez le schma en enlevant les champs suivants : dc, ou, objectclass.

Puis ouvrez le mapper pour dfinir les changements excuter. Glissez et dposez la colonne uid de la table dentre (input) la table de sortie (output) puisque aucune modification nest ncessaire pour cette colonne.

Dans le champ Expression de la colonne dn de la table de sortie (output), saisissez lexpression exacte attendue par le serveur LDAP afin quil atteigne larborescence souhaite et permette dcrire dans lannuaire, condition que vous nayez pas dj renseign le champ Base DN du composant tLDAPOutput.

430

Composants Talend Open Studio

Creative Commons License

Composants Databases
tLDAPOutput

Dans cet exemple, la variable globale GetResultName est utilise pour rcuprer automatiquement le chemin daccs. Appuyez sur Ctrl+Espace pour accder la liste de variable et slectionnez tLDAPInput_1_RESULT_NAME. Dans le champ Expression de la colonne mail, saisissez ladresse email qui remplacera celle obsolte dans lannuaire LDAP. Dans cet exemple, le nouvel email est : Pierre.Dupont@talend.com. Cliquez sur OK pour valider les modifications. Le composant tLogRow ne ncessite pas de paramtrage particulier. Puis slectionnez le composant tLDAPOutput pour dfinir les proprits dcriture dans lannuaire.

Dfinissez manuellement les champs Port et Host si ces informations ne sont pas stockes dans le Repository. Dans le champ Base DN, dfinissez la plus haute arborescence laquelle vous avez accs. Si vous navez 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. Slectionnez le protocole utiliser : LDAP pour cet exemple. Puis renseignez les champs User et Password attendus par lannuaire LDAP. Laissez les paramtres par dfaut des champs Alias Dereferencing et Referral Handling, cest--dire respectivement Always et Ignore. Dans le champ Insert mode, slectionnez loption Update pour cet exemple (ladresse email). Le schma est rcupr du composant prcdent laide dune opration de propagation. Enregistrez le Job et excutez-le en appuyant sur la touche F6.

Creative Commons License

Composants Talend Open Studio

431

Composants Databases
tLDAPOutput

La sortie montre les champs suivants : dn, uid et mail comme dfini dans le Job.

432

Composants Talend Open Studio

Creative Commons License

Composants Databases
tLDAPRenameEntry

tLDAPRenameEntry
Proprits du tLDAPRenameEntry
Famille de composant Databases/LDAP

Fonction Objectif Basic settings

Le composant tLDAPRenameEntry renomme des entres dans un annuaire LDAP. Le tLDAPRenameEntry permet de renommer une ou des entre(s) dans un annuaire LDAP slectionn. 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 laide des donnes collectes. Host Port Base DN Protocol Adresse IP du serveur dannuaire LDAP. Numro du port dcoute du serveur. Chemin daccs larborescence de lutilisateur autoris. Slectionnez le type de protocole dans la liste. LDAP : aucun codage nest utilis LDAPS : LDAP scuris TLS : le certificat est utilis Renseignez les informations dauthentification de lutilisateur. Notez que le login doit correspondre la syntaxe LDAP pour tre valide. Par exemple : cn=Directory Manager. Slectionnez loption dans la liste. Never permet lamlioration des performances de recherche si vous tes sr quaucun alias nest 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. Slectionnez loption dans la liste : Ignore : ne tient pas compte des redirections des requtes Follow : tient compte des redirections des requtes

User et Password

Alias dereferencing

Referrals handling

Previous DN et New DN Slectionnez partir de la liste droulante la colonne du schma portant lancien DN (Previous DN) et celle portant le nouveau DN appliquer (New DN).

Creative Commons License

Composants Talend Open Studio

433

Composants Databases
tLDAPRenameEntry

Schema et Edit Schema Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Die on error Cette case est coche par dfaut et stoppe le Job en cas derreur. 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.

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 dautres composants. Note : Appuyez sur Ctrl + Espace pour accder la liste des variables globales, inclus la variable GetResultName permettant de rcuprer automatiquement la base correspondante.

Scnarios associs
Pour un scnario associ au composant tLDAPRenameEntry, consultez : le Scnario : Afficher le contenu filtr dun annuaire LDAP, page 426 du composant tLDAPInput. le Scnario : Editer des donnes dans un annuaire LDAP, page 430 du tLDAPOutput.

434

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMaxDBInput

tMaxDBInput
Proprits du tMaxDBInput
Famille de composant Databases/MaxDB

Fonction Objectif

Le composant tMaxDBInput lit une table de base de donnes et en extrait des champs laide de requtes. 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). 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio . Host name Port Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table name Entrez le nom de la table.

Basic settings

Creative Commons License

Composants Talend Open Studio

435

Composants Databases
tMaxDBInput

Query type et Query

Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Cliquez sur le bouton pour rcuprer le schma de la table. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Guess Query

Guess schema Advanced settings Trim all the String/Char columns Trim column

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.

Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260

436

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMaxDBOutput

tMaxDBOutput
Proprits du tMaxDBOutput
Famille de composant Databases/MaxDB

Fonction Objectif Basic settings

Le composant tMaxDBOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tMaxDBOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Port Database Username et Password Table Action on table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. 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. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback.

Creative Commons License

Composants Talend Open Studio

437

Composants Databases
tMaxDBOutput

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 sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. 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 longlet 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, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Dfinissez-le manuellement lencodage. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.

Advanced settings

Encoding

438

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMaxDBOutput

Commit every

Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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.

Additional Columns

Use field options Enable debug mode

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus dcriture 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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Afficher la base de donnes en sortie, page 264 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du composant tMySQLOutput.

Creative Commons License

Composants Talend Open Studio

439

Composants Databases
tMaxDBRow

tMaxDBRow
Proprits du tMaxDBRow
Famille de composant Databases/MaxDB0

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. 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. 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 laide des donnes collectes. Host Port Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table name Query type Entrez le nom de la table. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.

Objectif

Basic settings

440

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMaxDBRow

Query

Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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.

Die on error

Advanced settings

Propagate QUERYs recordset Use PreparedStatement

Encoding Type

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

Commit every

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 de requtes SQL.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du composant tMySQLRow.

Creative Commons License

Composants Talend Open Studio

441

Composants Databases
tMSSqlBulkExec

tMSSqlBulkExec
Proprits du tMSSqlBulkExec
Les composants tMSSqlOutputBulk et tMSSqlBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tMSSqlOutputBulkExec, dtaill dans une section spare. Lintrt 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 Objectif

Effectue une action dInsert sur les donnes fournies. Le composant tMSSqlBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes MSSql. 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 laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tMSSqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes.

Basic settings

442

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlBulkExec

Database Schema Username et Password Table

Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit exister pour que lopration dInsert soit autorise. 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. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Action on table

Schema et Edit Schema

Remote File Name

Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Bcp query out Les informations demandes seront diffrentes en fonction de laction choisie. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Caractre, chane ou expression rgulire sparant les champs. Caractre, chane ou expression rgulire sparant les lignes.

Advanced settings

Action

Bulk insert & Bulk update

Additional JDBC parameters

Fields terminated Rows terminated

Creative Commons License

Composants Talend Open Studio

443

Composants Databases
tMSSqlBulkExec

First row Code page

Saisissez le numro du rang partir duquel vous voulez dmarrer laction. Cette valeur peut prendre plusieurs formes : OEM (valeur par dfaut) ACP RAW Personnalise par lutilisateur Slectionnez le type de donnes traiter. 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.

Data file type Output

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Bcp query out Fields terminated Rows terminated Data file type Output Caractre, chane ou expression rgulire sparant les champs. Caractre, chane ou expression rgulire sparant les lignes. Slectionnez le type de donnes traiter. 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. Utilisation Ce composant est gnralement utilis avec un composant tMSSqlOutputBulk. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes MSSql.

Scnarios associs
Pour un scnario associ au composant tMSSqlBulkExec, consultez les scnarios suivants : le Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 521 du tMysqlOutputBulkExec.

444

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlClose

tMSSqlClose
Proprits du tMSSqlClose
Famille de composant Databases/MSSql

Fonction Objectif Basic settings

Le composant tMSSqlClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes MSSql. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tMSSqlConnection dans la liste.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a

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 page 482

Creative Commons License

Composants Talend Open Studio

445

Composants Databases
tMSSqlColumnList

tMSSqlColumnList
Proprits du tMSSqlColumnList
Famille de composant Databases/MS SQL

Fonction

Le composant tMSSqlColumList effectue une opration ditration dans toutes les colonnes dune table donne, grce une connexion MS SQL dfinie. Le tMSSqlColumList permet de faire une liste des libells des colonnes dune table MS SQL donne. Component list Slectionnez le composant tMSSqlConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Entrez le nom de la table.

Objectif Basic settings

Table name Utilisation Limitation

Il faut utiliser ce composant en association avec les autres composants MS SQL, notamment avec le tMSSqlConnection. n/a

Scnario associ
Pour un scnario associ, consultez le Scnario : Itrer une table de base de donnes et lister le nom des colonnes de la table, page 477.

446

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlCommit

tMSSqlCommit

Proprits du tMSSqlCommit
Ce composant est troitement li aux composants tMSSqlConnection et tMSSqlRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/MSSql

Fonction Objectif

Le composant tMSSqlCommit valide les donnes traites dans un Job partir dune base de donnes connecte. 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. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tMSSqlConnection dans la liste. 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.

Basic settings

Close connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants MSSql et notamment avec les composants tMSSqlConnection et tMSSqlRollback. n/a

Scnario associ
Ce composant est troitement li aux composants tMSSqlConnection et tMSSqlRollback. Ils sont gnralement utiliss avec un composant tMSSqlConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tMSSqlCommit, consultez tMysqlConnection page 482.

Creative Commons License

Composants Talend Open Studio

447

Composants Databases
tMSSqlConnection

tMSSqlConnection

Proprits du tMSSqlConnection
Ce composant est troitement li aux composants tMSSqlCommit et tMSSqlRollback. Ils sont gnralemet utiliss avec un composant tMSSqlConnection car il permet douvrir une connexion pour la transaction en cours.
Famille de composant Databases/MSSQL

Fonction Objectif Basic settings

Le composant tMSSqlConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. 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 laide des donnes collectes. Host Port Schema Database Username et Password Encoding type Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom du schma. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une 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. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration.

Additional JDBC parameters Use or register a shared DB Connection

Advanced settings

Auto commit

448

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlConnection

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Limitation Ce composant est gnralement utilis avec des composants MSSql, notamment les composants tMSSqlCommit et tMSSqlRollback. n/a

Scnario associ
Ce composant est troitement li aux composants tMSSqlCommit et tMSSqlRollback. Ils sont gnralement utiliss avec un composant tMSSqlConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tMSSqlConnection, consultez tMysqlConnection page 482.

Creative Commons License

Composants Talend Open Studio

449

Composants Databases
tMSSqlInput

tMSSqlInput
Proprits du tMSSqlInput
Famille de composant Databases/MS SQL Server Le composant tMSSqlInput lit une base de donnes et en extrait des champs laide de requtes. 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). Use an existing connection Cochez cette case lorsque vous utilisez le composant tMSSqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. 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 laide des donnes collectes.

Fonction Objectif

Basic settings

450

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlInput

Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Port Database Schema Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant (Repository). Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table name Query type et Query Nom de la table lire. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Advanced settings

Additional JDBC parameters

Encoding Type

Trim all the String/Char columns Trim column

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Creative Commons License

Composants Talend Open Studio

451

Composants Databases
tMSSqlInput

Utilisation

Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes MS Sql.

Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260 Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1122 du tContextLoad.

452

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlLastInsertId

tMSSqlLastInsertId
Proprits du tMSSqlLastInsertId
Famille de composant Databases/MS SQL server tMSSqlLastInsertId affiche les dernires ID ajoutes une table partir dune connexion MSSql spcifie. tMSSqlLastInsertId permet de rcuprer les cls primaires des entres dernirement ajoutes par un utilisateur une table MSSql. Schema et Edit Schema Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Component list Advanced settings Utilisation Slectionnez le composant tMSSqlConnection dans la liste sil y a plus dune connexion dans votre Job.

Fonction Objectif Basic settings

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL.

Scnario associ
Pour un scnario associ au composant tMSSqlLastInsertId, consultez Scnario : Rcuprer les ID des dernires entres ajoutes page 490.

Creative Commons License

Composants Talend Open Studio

453

Composants Databases
tMSSqlOutput

tMSSqlOutput
Proprits du tMSSqlOutput
Famille de composant Databases/MS SQL server Le composant tMSSqlOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tMSSqlOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez cette case lorsque vous utilisez le composant tMSSqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Adresse IP du serveur de base de donnes.

Fonction Objectif Basic settings

454

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlOutput

Port Database Schema Username et Password Table Action on table

Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes Nom de la table crer. Vous ne pouvez crer quune seule table la fois. 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. 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).

Creative Commons License

Composants Talend Open Studio

455

Composants Databases
tMSSqlOutput

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 sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre.. 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 longlet 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 personnaliser lincrmentation : Identity field : slectionnez la colonne incrmenter. Start value : dfinissez la valeur dincrmentation de dpart. Step : dfinissez la valeur incrmenter chaque ligne. Un schma est une description de lignes, i.e., 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 pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Schema et Edit Schema

456

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlOutput

Die on error

Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, 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 laction 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.

Advanced settings

Additional JDBC parameters

Encoding Type

Commit every

Additional Columns

Use field options Enable debug mode Support null in SQL WHERE statement

Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus dcriture dans la base de donnes. Cochez cette case pour prendre en compte les valeurs Null dune table 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.

Creative Commons License

Composants Talend Open Studio

457

Composants Databases
tMSSqlOutput

Use Batch Size Utilisation

Nombre de lignes dans chaque lot de traitement de donnes.

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 dune table dune 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 dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ au composant tMSSqlOutput, consultez : le Scnario : Afficher la base de donnes en sortie, page 264 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du composant tMySQLOutput.

458

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlOutputBulk

tMSSqlOutputBulk
Proprits du tMSSqlOutputBulk
Les composants tMSSqlOutputBulk et tMSSqlBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tMSSqlOutputBulkExec, dtaill dans une section spare. Lintrt 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 Objectif Basic settings

Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards MSSql. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes MSSQL. 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 laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Append Schema et Edit Schema

Advanced settings

Row separator Field separator Include header

Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Cochez cette case pour inclure len-tte des colonnes dans le fichier.

Creative Commons License

Composants Talend Open Studio

459

Composants Databases
tMSSqlOutputBulk

Encoding Type

Slectionnez lencodage 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 gnralement utilis avec le composant tMSSQlBulkExec. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes MSSQL.

Scnarios associs
Pour un scnario associ au tMSSqlOutputBulk, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 521 du tMysqlOutputBulkExec.

460

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlOutputBulkExec

tMSSqlOutputBulkExec
Proprits du tMSSqlOutputBulkExec
Famille de composant Databases/MSSql

Fonction Objectif

Le tMSSqlOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tMSSqlOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes MSSQL. Action Property Type Permet de choisir entre les options Bulk Insert et Bulk update. 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 laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tMSSqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma.

Basic settings

Creative Commons License

Composants Talend Open Studio

461

Composants Databases
tMSSqlOutputBulkExec

Username et Password Table

Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crire la fois et la table doit dj exister pour que lopration dinsert soit autorise. 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. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., 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 sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Action on table

Schema et Edit Schema

File Name

Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) sparant les lignes. Saisissez le numro du rang partir duquel vous voulez dmarrer laction. Cochez cette case pour inclure len-tte des colonnes dans le fichier. Slectionnez le type de donnes traiter.

Append Advanced settings Additional JDBC parameters

Field separator Row separator First row Include header Data file type

462

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlOutputBulkExec

Encoding Type

Slectionnez lencodage 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 Limitation Ce composant est principalement utilis lorsquaucune transformation particulire nest requise sur les donnes charger dans la base de donnes. n/a

Scnarios associs
Pour un scnario associ au tMSSqlOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 521 du tMysqlOutputBulkExec.

Creative Commons License

Composants Talend Open Studio

463

Composants Databases
tMSSqlRollback

tMSSqlRollback

Proprits du tMSSqlRollback
Ce composant est troitement li aux composants tMSSqlCommit et tMSSqlConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Famille de composant Databases

Fonction Objectif Basic settings

Le tMSSqlRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Close connection Slectionnez le composant tMSSqlConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.

Advanced settings Utilisation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce component est gnralement utilis avec dautres composants MSSql, notamment les composants tMSSqlConnection et tMSSqlCommit components. n/a

Limitation

Scnario associ
Pour un scnario associ, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524.

464

Composants Talend Open Studio

Creative Commons License

Composants Databases
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. 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. Use an existing connection Cochez cette case lorsque vous utilisez le composant tMSSqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. 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 laide des donnes collectes. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma.

Objectif

Basic settings

Creative Commons License

Composants Talend Open Studio

465

Composants Databases
tMSSqlRow

Username et Password Schema et Edit Schema

Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., 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 : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Table Name

Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit exister pour que lopration dInsert 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 Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement. Query Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. 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. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column.

Die on error

Advanced settings

Additional JDBC parameters

Propagate QUERYs recordset

466

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlRow

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 linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction 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.

Encoding Type

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.

Commit every

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 de requtes SQL.

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du tMySQLRow.

Creative Commons License

Composants Talend Open Studio

467

Composants Databases
tMSSqlSCD

tMSSqlSCD
Le composant tMSSqlSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tMSSqlSCD, page 17.

468

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlSP

tMSSqlSP
Proprits du tMSSqlSP
Famille de composant Databases/MSSql

Fonction Objectif Basic settings

Le composant tMSSqlSP appelle une procdure stocke de base de donnes. Le tMSSqlSP permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les appeler plus facilement. Property type Peut tre Built-in ou Repository. 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 tMSSqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification sur lutilisateur de base de donnes.

Creative Commons License

Composants Talend Open Studio

469

Composants Databases
tMSSqlSP

Schema et Edit Schema

Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., 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. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est rutilisable. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

SP Name Is Function / Return result in

Saisissez le nom exact de la Procdure Stocke (SP). 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. 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 quil ny a de paramtres utiliss dans la procdure. Slectionnez le Type de paramtre : IN : paramtre dentre (Input) OUT : paramtre de sortie (Output)/valeur retourne IN OUT : les paramtres dentre doivent tre retournes sous forme de valeur, mme aprs modifications via la procdure (fonction). RECORDSET : les paramtres dentre doivent tre retournes sous forme densemble de valeurs, au lieu dune valeur unique. Consultez le composant tParseRecordSet si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.

Parameters

Advanced settings

Additional JDBC parameters

Encoding Type

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls les paramtres dentre sont autoriss. La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.

470

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMSSqlSP

Scnarios associs
Pour un scnario associ, consultez : le Scnario : Trouver le libell State laide dune procdure stocke, page 539 du composant tMysqlSP. le Scnario : Vrifier le format de numros laide dune procdure stocke, page 599 du tOracleSP. Consultez galement le composant tParseRecordSet, page 629 si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.

Creative Commons License

Composants Talend Open Studio

471

Composants Databases
tMSSqlTableList

tMSSqlTableList
Proprits du tMSSqlTableList
Famille de composant Databases/MS SQL

Fonction Objectif Basic settings

Le composant tMSSqlTableList effectue une opration ditration sur toutes les tables dune base de donnes, grce une connexion MS SQL dfinie. Le composant tMSSqlTableList permet de lister les noms des tables MS SQL grce aux commandes SELECT et WHERE. Component list Slectionnez le composant tMSSqlConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours..

Where clause for table Saisissez la commande WHERE permettant name selection didentifier les tables sur lesquelles effectuer lopration ditration. Advanced settings Utilisation Limitation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec les autres composants MS SQL, notamment avec le tMSSqlConnection. n/a

Scnario associ
Pour un scnario associ, consultez le Scnario : Itrer une table de base de donnes et lister le nom des colonnes de la table, page 477.

472

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMysqlBulkExec

tMysqlBulkExec
Proprits du tMysqlBulkExec
Les composants tMysqlOutputBulk et tMysqlBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tMysqlOutputBulkExec, dtaill dans une section spare. Lintrt 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/Mysql

Fonction Objectif

Le composant tMysqlBulkExec effectue une action dInsert sur les donnes fournies. Le tMysqlBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes MySQL. 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 laide des donnes collectes. DB Version Use an existing connection Slectionnez la version de MySQL que vous utilisez. Cochez cette case lorsque vous utilisez le composant tMysqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Adresse IP du serveur de base de donnes.

Basic settings

Creative Commons License

Composants Talend Open Studio

473

Composants Databases
tMysqlBulkExec

Port Database Username et Password Action on table

Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer 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 nexiste pas encore. Create table if doesnt 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. Nom de la table crire.

Table

Une seule table peut tre crite la fois et cette table doit dj exister pour que lopration dInsert soit autorise.
Local File Name Chemin daccs et nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Un schma est une description de lignes, i.e., 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. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Caractre ou suite de caractres utiliss pour sparer les lignes. Caractre, chane ou expression rgulire sparant les champs. Caractres entourant les donnes. 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.

Schema et Edit Schema

Advanced settings

Additional JDBC parameters Lines terminated by Fields terminated by Enclosed by Action on data

474

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMysqlBulkExec

Records contain NULL value

Cochez cette case si vous souhaitez rcuprer les valeurs nulles du flux dentre. Si vous ne cochez pas cette case, les valeurs nulles en entre seront considres comme des champs vides dans le flux de sortie. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.

Encoding Type

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec un composant tMysqlOutputBulk. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes MySQL. n/a

Limitation

Scnarios associs
Pour plus dinformations relatives au fonctionnement de tMysqlBulkExec, consultez les scnarios suivants : le Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 521 du composant tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du composant tOracleBulkExec.

Creative Commons License

Composants Talend Open Studio

475

Composants Databases
tMysqlClose

tMysqlClose
Proprits du tMysqlClose
Famille de composant Databases/Mysql

Fonction Objectif Basic settings

Le composant tMysqlClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Mysql. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tMysqlConnection dans la liste.

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a

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 page 482

476

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMysqlColumnList

tMysqlColumnList
Proprits du tMysqlColumnList
Famille de composants Databases/MySQL

Fonction Purpose Basic settings

Le composant tMysqlColumList effectue une opration ditration dans toutes les colonnes dune table donne, grce une connexion MySQL dfinie. Le tMysqlColumList permet de faire une liste des libells des colonnes dune table MySQL donne. Component list Slectionnez le composant tMysqlConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Entrez le nom de la table.

Table name Usage Limitation

Il faut utiliser ce composant en association avec les autres composants MySQL, notamment avec le tMysqlConnection. n/a

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 ditrer une table donne partir dune 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 lespace de modlisation : tMysqlConnection, tMysqlTableList, tMysqlColumnList, tFixedFlowInput et tLogRow. Reliez le tMysqlConnection au tMysqlTableList par le biais dun lien OnSubJobOk. Reliez les composants tMysqlTableList, tMysqlColumnList et tFixedFlowInput laide de liens Iterate. Reliez le tFixedFlowInput au tLogRow par le biais dun lien Row Main.

Creative Commons License

Composants Talend Open Studio

477

Composants Databases
tMysqlColumnList

Dans lespace de modlisation, slectionnez le composant tMysqlConnection et cliquez sur la vue Component pour dfinir les paramtres de base. Dans longlet Basic settings, entrez manuellement les proprits de connexion la base de donnes ou slectionnez-les partir de la liste des variables de contexte : appuyez simultanment sur les touches Ctrl+Espace puis cliquez sur le champ correspondant si vous avez stock les informations en local sous le noeud DB Connections du rpertoire Metadata. Pour plus dinformations sur les mtadonnes, veuillez consulter la section Dfinition des schmas de mtadonnes du Guide Utilisateur de Talend Open Studio.

Dans cet exemple, on veut se connecter une base de donnes MySQL appele customers. Dans lespace de modlisation, slectionnez le composant tMysqlTableList et cliquez sur la vue Component pour dfinir ses paramtres de base.

478

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMysqlColumnList

Dans le champ Component list, slectionnez le composant de connexion MySQL adquat si vous utilisez plus dune connexion. Renseignez la condition 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, on veut itrer la table appele customer. Dans lespace 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 dune connexion. Dans le champ Table name, saisissez le nom de la table dont vous souhaitez lister les libells de colonnes. Dans ce scnario, nous souhaitons lister les libells des colonnes de la table customer. Dans lespace de modlisation, slectionnez le composant tFixedFlowInput et cliquez sur la vue Component pour paramtrer ses proprits de base. Dans le champ Schema, slectionnez loption 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.
Creative Commons License Composants Talend Open Studio 479

Composants Databases
tMysqlColumnList

Dans la liste des variables globales, selectionnez : ((String)globalMap.get("tMysqlTableList_1_CURRENT_TABLE")) pour la colonne TableName et ((String)globalMap.get("tMysqlColumnList_1_COLUMN_NAME")) pour la colonne ColumnName.

Dans lespace 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 lexcuter.

Le nom de la table MySQL et le libell de ses colonnes sont affichs dans la console.

480

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMysqlCommit

tMysqlCommit
Proprits du tMysqlCommit
Ce composant est troitement li aux composants tMysqlConnection et tMysqlRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/MySQL

Fonction Objectif

Le composant tMysqlCommit valide les donnes traites dans un Job partir dune base de donnes connecte. 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. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tMysqlConnection dans la liste. 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.

Basic settings

Close connection

Advanced settings Utilisation Limitation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants MySQL et notamment avec les composants tMysqlConnection et tMysqlRollback. n/a

Scnario associ
Ce composant est troitement li aux composants tMysqlConnection et tMysqlRollback. Ils sont gnralement utiliss avec un composant tMysqlConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tMysqlCommit, consultez tMysqlConnection page 482.

Creative Commons License

Composants Talend Open Studio

481

Composants Databases
tMysqlConnection

tMysqlConnection
Proprits du tMysqlConnection
Ce composant est troitement li aux composants tMysqlCommit et tMysqlRollback. Ils sont gnralemet utiliss avec un composant tMysqlConnection car il permet douvrir une connexion pour la transaction en cours.
Famille de composant Databases/MySQL

Fonction Objectif Basic settings

Le composant tMysqlConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. 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 laide des donnes collectes. Host Port Database Table Schema Username et Password Encoding type Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour partager votre connexion ou rcuprer une 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. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.

Use or register a shared DB Connection

Utilisation Limitation

Ce composant est gnralement utilis avec des composants MySQL, notamment les composants tMysqlCommit et tMysqlRollback. n/a

482

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMysqlConnection

Scnario : 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 laide de lid dune table parent qui alimentera une table enfant. Avant de crer ce Job, suivez les tapes dcrites ci-dessous pour crer les tables ncessaires, laide dun gestionnaire de table tel que innodb. Dans un diteur de ligne de commande, connectez-vous votre serveur MySQL. 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; Puis crez la deuxime table : create table baby (id_baby int not null, years int) engine=innodb; Dans Talend Open Studio, le Job est constitu de sept composants, tMysqlConnection et tMysqlCommit inclus.

Cliquez et dposez les composants suivants de la Palette : tFileList, tFileInputDelimited, tMap, tMysqlOutput (x2). Connectez le composant tFileList au composant dentre tFileInputDelimited laide dune 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 deux composants de sortie tMysqlOutput. 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 tMysqlConnection et connectez-le au composant de dpart de ce Job, (dans cet exemple, le composant tFileList) laide dune connexion OnComponentOk afin de dfinir lordre dexcution.

Creative Commons License

Composants Talend Open Studio

483

Composants Databases
tMysqlConnection

Dans la vue Component du composant tMysqlConnection, 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 dinformation concernant les Mtadonnes, consultez Dfinition des schmas de mtadonnes du Guide Utilisateur de Talend Open Studio. Dans longlet Basic settings du composant tFileInputDelimited, appuyez sur la touche Ctrl+Espace pour accder la liste des variables. Dfinissez le champ File Name avec la variable globale : tFileList_1.CURRENT_FILEPATH

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 laide 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. Modifiez lencodage sil ne correspond pas celui de votre fichier. Dans la zone Output du tMap, ajoutez deux tables de sortie, une que vous nommerez mum pour la table parent et une deuxime que vous nommerez baby pour la table enfant. Cliquez sur la colonne Name de la zone Input et glissez-la dans la table mum. Cliquez sur la colonne Years de la zone Input et glissez-la dans la table baby.

Assurez-vous que la table mum est bien au dessus de la table baby car lordre des tables dtermine la squence des flux et ainsi linsertion de base de donnes est excute correctement.

484

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMysqlConnection

Puis slectionnez une connexion de sortie de type Row pour acheminer correctement le flux vers le composant Database de sortie correspondant. Dans longlet Basic settings des deux composants tMysqlOutput, cochez la case Use an existing connection pour rcuprer les informations du composant tMysqlConnection. En version Perl, le champ Commit every napparat plus puisque vous utilisez le composant tMysqlCommit au lieu de grer les commits de transaction globale. En version Java, ignorez ce champ puisque cette commande sera annule par le composant tMysqlCommit.

Nommez votre table dans le champ Table en vous assurant que vous saisissez la bonne table. Dans cet exemple, la table est soit f1090_mum, soit f1090_baby. 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 (tMysqlOutput). Cliquez sur le bouton Sync columns pour rcuprer le schma dfini dans le tMap. Modifiez le type dencodage si ncessaire. Dans la zone Additional columns de longlet Advanced settings du composant tMysqlOutput correspondant la table enfant (f1090_baby), dfinissez la colonne id_baby de manire ce que lid de la table parent soit rutilis. Dans le champ SQL expression, saisissez : '(Select Last_Insert_id())' Dans la colonne Position, slectionnez loption Before et dans Reference column, loption years. Ajoutez le composant tMysqlCommit votre Job et connectez-le au composant tFileList laide dune connexion de type OnComponentOk afin que votre Job se termine avec un commit de transaction. Dans la vue Component du tMysqlCommit, slectionnez dans la liste la connexion utiliser. Enregistrez votre Job et appuyez sur F6 pour lexcuter.

Creative Commons License

Composants Talend Open Studio

485

Composants Databases
tMysqlConnection

Lid de la table parent a t rutilis pour alimenter la colonne id_baby.

486

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMysqlInput

tMysqlInput
Proprits du tMysqlInput
Famille de composant Databases/MySQL

Fonction Objectif

Le composant tMysqlInput lit une base de donnes et en extrait des champs laide de requtes. 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). 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 laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant 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 dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.

Basic settings

Creative Commons License

Composants Talend Open Studio

487

Composants Databases
tMysqlInput

Use an existing connection

Cochez cette case lorsque vous utilisez le composant tMySQLConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.

Host Port Database Username et Password Schema et Edit Schema

Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant (Repository). Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.

Table Name Query type et Query

Nom de la table lire. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.

488

Composants Talend Open Studio

Creative Commons License

Composants Databases
tMysqlInput

Advanced settings

Additional JDBC parameters

Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection 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&zeroDateTimeBehavior=convertToNull.

Encoding Type

Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour dterminer avec quelles lignes vous souhaitez travailler. Cette option permet damliorer les performances. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Enable stream

Trim all the String/Char columns Trim column

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

Scnarios associs
Voir galement les scnarios du tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258. Scnario 2 : Utiliser la variable StoreSQLQuery, page 260. Voir galement le scnario du tContextLoad, Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1122.

Creative Commons License

Composants Talend Open Studio

489

Composants Databases
tMysqlLastInsertId

tMysqlLastInsertId
Proprits du tMysqlLastInsertId
Famille de composant Databases/MySQL

Fonction Objectif Basic settings

tMysqlLastInsertId affiche les derniers ID ajouts une table partir dune connexion MySQL spcifie. tMysqlLastInsertId permet de rcuprer les cls primaires des entres dernirement ajoutes par un utilisateur une table MySQL. Schema et Edit Schema Un schma est