TalendOpenStudio Components RG 40b FR

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
iii
iv
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
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
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
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
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
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
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
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
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
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
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
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
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
(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
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
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
xxi
xxii
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.
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
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
xxv
xxvi
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.

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

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.

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

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.

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.

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

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
Utilisation
Scnario associ

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

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

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

tIngresSCD
Debug mode Usage
Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.
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

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
13

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

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

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

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
17

tMSSqlSCD
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.
Scnario associ
18

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
19

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

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

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

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

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

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

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

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

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

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

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

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

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

tMysqlSCDELT
Table
Action on table
Source Keys
Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes.
33

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

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
35

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
Utilisation
Scnario associ
36

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
37

tOracleSCDELT
Table
Action on table
38

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

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

tParAccelSCD
SCD Editor
Utilisation
Scnario associ
41

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

tPostgresPlusSCD
SCD Editor
Utilisation
Scnario associ
43

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

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
45

tPostgresPlusSCDELT
Enable debug mode
Scnario associ
46

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
47

tPostgresqlSCD
SCD Editor
Utilisation
Scnario associ
48

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
49

tPostgresqlSCDELT
Table
Action on table
50

tPostgresqlSCDELT
Enable debug mode
Scnario associ
51

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

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

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

tSPSSInput
55

tSPSSOutput
tSPSSOutput
Proprits du tSPSSOutput
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.
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

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

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

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

tSPSSStructure
tSPSSStructure
Proprits du tSPSSStructure
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

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
61

tSybaseSCD
SCD Editor
Utilisation
Scnario associ
62

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
63

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
Surrogate Key Creation Source Key
64

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

tSybaseSCDELT
66
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 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
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 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.
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 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.
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 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 :
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 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.
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 Business
tAlfrescoOutput
Les deux documents sont crs sur Alfresco grce aux mtadonnes des schmas dentre.
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.
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 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.
Utilisation Limitation
Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a
Scnario associ
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
82
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.
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 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.
85
Composants Business
tMicrosoftCRMInput
tMicrosoftCRMInput
Proprits du tMicrosoftCRMInput
Famille de composant Business
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 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.
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 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 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.
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 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.
93
Composants Business
tMicrosoftCRMOutput
tMicrosoftCRMOutput
Proprits du tMicrosoftCRMOutput
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 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.
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.
Table Name Query
Scnario associ
96
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.
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
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 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.
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 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.
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 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.
103
Composants Business
tOpenbravoERPInput
tOpenbravoERPInput
Proprits du tOpenbravoERPInput
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 Business
tOpenbravoERPInput
Scnario associ
105
Composants Business
tOpenbravoERPOutput
tOpenbravoERPOutput
Proprits du tOpenbravoERPOutput
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
Scnario associ
106
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
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
107
Composants Business
tSalesforceBulkExec
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 Business
tSalesforceConnection
tSalesforceConnection
Proprits du tSalesforceConnection
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.
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.
109
Composants Business
tSalesforceGetDeleted
Proprits du tSalesforceGetDeleted
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.
Start Date
End Date
Advanced settings
Use Soap Compression
110
Composants Business
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.
111
Composants Business
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 Business
tSalesforceGetServerTimestamp
tSalesforceGetServerTimestamp
Proprits du tSalesforceGetServerTimestamp
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
Scnario associ
113
Composants Business
tSalesforceGetUpdated
Proprits du tSalesforceGetUpdated
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.
Start Date
End Date
Advanced settings
Use Soap Compression
114
Composants Business
Scnario associ
115
Composants Business
tSalesforceInput
tSalesforceInput
Proprits du tSalesforceInput
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 Business
tSalesforceInput
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.
117
Composants Business
tSalesforceOutput
tSalesforceOutput
Proprits du tSalesforceOutput
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
Advanced settings
Extended Output
118
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
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 :
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 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.
121
Composants Business
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
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.
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 Business
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.
123
Composants Business
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 Business
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.
125
Composants Business
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 Business
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.
127
Composants Business
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
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
128
Composants Business
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.
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.
129
Composants Business
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 Business
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.
131
Composants Business
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 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
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.
133
Composants Business
tSAPConnection
tSAPConnection
Proprits du tSAPConnection
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
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 Business
tSAPInput
tSAPInput
Proprits du tSAPInput
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
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.
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 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.
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 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.
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 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.
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 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.
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 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.
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 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.
147
Composants Business
tSAPOutput
tSAPOutput
Proprits du tSAPOutput
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
Function name Mapping Utilisation
Ce composant est gnralement utilis en tant que composant de sortie et requiert un composant dentre.
148
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.
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
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 Business
tSugarCRMInput
tSugarCRMInput
Proprits du tSugarCRMInput
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
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.
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 Business
tSugarCRMInput
Les donnes filtres sont inscrites en sortie dans la feuille de calcul du fichier Excel spcifi.
153
Composants Business
tSugarCRMOutput
tSugarCRMOutput
Proprits du tSugarCRMOutput
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
Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a
Scnario associ
154
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.
Scnario associ
155
Composants Business
tVtigerCRMOutput
tVtigerCRMOutput
Proprits du tVtigerCRMOutput
Famille du composant Business/vTigerCRM
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.
Scnario associ
156
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.

tGroovy
tGroovy
Proprits du tGroovy
Famille de composant Custom Code
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.
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

tGroovyFile
tGroovyFile
Proprits du tGroovyFile
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.
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.
159

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

tJava
tJava
Proprits du tJava
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/
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.

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

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

tJavaFlex
tJavaFlex
Proprits du tJavaFlex
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.
Start code Main code End code Advanced settings Import
164

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

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

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

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

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

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

tJavaRow
tJavaRow
Proprits du tJavaRow
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.
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
171

tLibraryLoad
tLibraryLoad
Proprits du tLibraryLoad
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
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.

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

tLibraryLoad
La Console affiche false, cest--dire que ladresse e-mail nest pas valide. En effet, son format nest pas correct.
174
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.

tAddCRCRow
tAddCRCRow
Proprits du tAddCRCRow
Famille de composant Data Quality
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
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

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

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

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

tFuzzyMatch
tFuzzyMatch
Proprits du tFuzzyMatch
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

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

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

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

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

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

tIntervalMatch
tIntervalMatch
Proprits du tIntervalMatch
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.
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

tIntervalMatch
Basic settings
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.
187

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

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

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

tParseAddress
tParseAddress
Proprits du tParseAddress
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
191

tParseAddress
Scnario associ
192

tParseName
tParseName
Proprits du tParseName
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
193

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

tReplaceList
tReplaceList
Proprits du tReplaceList
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.
195

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.

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

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

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.
Perl uniquemen t
Date language/ Date format
Check all columns from schema Type
Null (empty or zero) Max length
199

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

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.

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

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

tUniqRow
tUniqRow
Proprits du tUniqRow
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

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

tUniqRow
206
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.
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
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.
209
tAccessOutput
tAccessOutput
Proprits du tAccessOutput
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
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).
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
211
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
tAccessRow
tAccessRow
Proprits du tAccessRow
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
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
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
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
215
tAS400Close
tAS400Close
Proprits du tAS400Close
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.
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
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.
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
Ce composant est gnralement utilis avec des composants AS400 et notamment avec les composants tAS400Commit et tAS400Rollback. n/a
217
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
tAS400Input
tAS400Input
Proprits du tAS400Input
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
219
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
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
tAS400LastInsertId
tAS400LastInsertId
Proprits du tAS400LastInsertId
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.
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.
221
tAS400Output
tAS400Output
Proprits du tAS400Output
Famille de composant Databases/DB2
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
tAS400Output
Action on data
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
223
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.
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
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.
225
tAS400Rollback
tAS400Rollback
Proprits du tAS400Rollback
Ce composant est troitement li aux composants tAS400Commit et tAS400Connection. Ils sont gnralement utiliss ensemble lors de transactions.
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
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
tAS400Row
tAS400Row
Proprits du tAS400Row
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
227
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
Propagate QUERYs recordset
228
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
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.
229
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
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
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
231
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
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.
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
tDB2BulkExec
tDB2BulkExec
Proprits du tDB2BulkExec
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.
235
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.
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
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.
237
tDB2Close
tDB2Close
Proprits du tDB2Close
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.
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
tDB2Commit
tDB2Commit
Proprits du tDB2Commit
Ce composant est troitement li aux composants tDB2Connection et tDB2Rollback. Ils sont gnralement utiliss ensemble lors de transactions.
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
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
239
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.
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.
Ce composant est gnralement utilis avec des composants DB2, notamment les composants tDB2Commit et tDB2Rollback. n/a
240
tDB2Connection
Scnarios associs
Pour un scnario associ au composant tDB2Connection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.
241
tDB2Input
tDB2Input
Proprits du tDB2Input
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
tDB2Input
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
243
tDB2Input
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
244
tDB2Output
tDB2Output
Proprits du tDB2Output
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.
245
tDB2Output
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
tDB2Output
Action on data
Die on error
Advanced settings
Encoding Type
247
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
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
tDB2Rollback
tDB2Rollback
Proprits du tDB2Rollback
Ce composant est troitement li aux composants tDB2Commit et tDB2Connection. Ils sont gnralement utiliss ensemble lors de transactions.
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
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.
249
tDB2Row
tDB2Row
Proprits du tDB2Row
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
tDB2Row
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
251
tDB2Row
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
tDB2SCD
tDB2SCD
Le composant tDB2SCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tDB2SCD, page 2.
253
tDB2SCDELT
tDB2SCDELT
Le composant tDB2SCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tDB2SCDELT, page 4.
254
tDB2SP
tDB2SP
Proprits du tDB2SP
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.
255
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
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
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
257
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
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
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.
259
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
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 :
261
tDBOutput
tDBOutput
Proprits du tDBOutput
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
tDBOutput
Action on data
Die on error
Advanced settings
Encoding Type
263
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
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
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.
265
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
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
267
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
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
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.
269
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
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
271
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
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
tEXAOutput
tEXAOutput
Proprits du tEXAOutput
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.
273
tEXAOutput
Action on data
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
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
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 :
275
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
tEXARow
tEXARow
Proprits du tEXARow
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
277
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
Scnarios associs
278
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.
279
tEXistDelete
tEXistDelete
Proprits du tEXistDelete
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
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.
Ce composant est utilis en tant que sous-job ou comme composant de sortie. n/a
Scnario associ
281
tEXistGet
tEXistGet
tEXistGet properties
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
tEXistGet
Files
Scnario associ
283
tEXistList
tEXistList
Proprits du tEXistList
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
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
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.
285
tEXistPut
tEXistPut
Proprits du tEXistPut
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
tEXistPut
Files
Scnario associ
287
tEXistXQuery
tEXistXQuery
Proprits du tEXistXQuery
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
288
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.
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
289
tEXistXUpdate
tEXistXUpdate
Proprits du tEXistXUpdate
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
290
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.
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
291
tFirebirdClose
tFirebirdClose
Proprits du tFirebirdClose
Famille de composant Databases/Firebird
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.
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
tFirebirdCommit
tFirebirdCommit
Proprits du tFirebirdCommit
Ce composant est troitement li aux composants tFirebirdConnection et tFirebirdRollback. Ils sont gnralement utiliss ensemble lors de transactions.
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
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.
293
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.
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.
Ce composant est gnralement utilis avec des composants Firebird, notamment les composants tFirebirdCommit et tFirebirdRollback. n/a
294
tFirebirdConnection
Scnario associ
Pour un scnario associ au composant tFirebirdConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.
295
tFirebirdInput
tFirebirdInput
Proprits du tFirebirdInput
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
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.
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.
297
tFirebirdOutput
tFirebirdOutput
Proprits du tFirebirdOutput
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
tFirebirdOutput
Action on data
Die on error
Advanced settings
Encoding Type
299
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
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
tFirebirdRollback
tFirebirdRollback
Proprits du tFirebirdRollback
Ce composant est troitement li aux composants tFirebirdCommit et tFirebirdConnection. Ils sont gnralement utiliss ensemble lors de transactions.
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
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.
301
tFirebirdRow
tFirebirdRow
Proprits du tFirebirdRow
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
tFirebirdRow
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
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
303
tFirebirdRow
Encoding Type
Commit every
Scnarios associs
304
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
305
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.
306
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.
307
tGreenplumClose
tGreenplumClose
Proprits du tGreenplumClose
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.
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
tGreenplumCommit
tGreenplumCommit
Proprits du tGreenplumCommit
Ce composant est troitement li aux composants tGreenplumConnection et tGreenplumRollback. Ils sont gnralement utiliss ensemble lors de transactions.
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
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.
309
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.
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.
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
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.
311
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
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
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
313
tGreenplumOutput
tGreenplumOutput
Proprits du tGreenplumOutput
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
tGreenplumOutput
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.
315
tGreenplumOutput
Action on data
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
Advanced settings
Encoding Type
316
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.
317
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.
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
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.
319
tGreenplumOutputBulkExec
Proprits du tGreenplumOutputBulkExec
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
320
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.
321
tGreenplumRollback
tGreenplumRollback
Proprits du tGreenplumRollback
Ce composant est troitement li aux composants tGreenplumCommit et tGreenplumConnection. Ils sont gnralement utiliss ensemble lors de transactions.
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
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
tGreenplumRow
tGreenplumRow
Proprits du tGreenplumRow
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
323
tGreenplumRow
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.
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
324
tGreenplumRow
Encoding Type
Commit every
Scnarios associs
325
tGreenplumSCD
tGreenplumSCD
Le composant tGreenplumSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tGreenplumSCD, page 7.
326
tHiveClose
tHiveClose
Proprits du tHiveClose
Famille de composant Databases/Hive
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.
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
327
tHiveConnection
tHiveConnection
Proprits du tHiveConnection
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.
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
328
tHiveConnection
Scnarios associs
Pour un scnario associ au composant tHiveConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.
329
tHiveRow
tHiveRow
Proprits du tHiveRow
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
tHiveRow
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.
331
tHiveRow
Scnarios associs
332
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
333
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
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
tHSQLDbOutput
tHSQLDbOutput
Proprits du tHSQLDbOutput
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
335
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
336
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
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.
337
tHSQLDbOutput
Scnarios associs
338
tHSQLDbRow
tHSQLDbRow
Proprits du tHSQLDbRow
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
339
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
Commit every
340
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.
341
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
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
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.
343
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
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
tInformixClose
tInformixClose
Proprits du tInformixClose
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.
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
345
tInformixCommit
tInformixCommit
Proprits du tInformixCommit
Ce composant est troitement li aux composants tInformixConnection et tInformixRollback. Ils sont gnralement utiliss ensemble lors de transactions.
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
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
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.
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
347
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
tInformixInput
tInformixInput
Proprits du tInformixInput
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
349
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
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
tInformixOutput
tInformixOutput
Proprits du tInformixOutput
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
351
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
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
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
Commit every
Additional Columns
353
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
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.
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.
Advanced settings
Row separator Field separator
Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs.
355
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
tInformixOutputBulkExec
Proprits du tInformixOutputBulkExec
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
357
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
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
Row separator
358
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.
359
tInformixRollback
tInformixRollback
Proprits du tInformixRollback
Ce composant est troitement li aux composants tInformixCommit et tInformixConnection. Ils sont gnralement utiliss ensemble lors de transactions.
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
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
tInformixRow
tInformixRow
Proprits du tInformixRow
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
361
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.
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
362
tInformixRow
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.
Scnarios associs
363
tInformixSCD
tInformixSCD
Le composant tInformixSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tInformixSCD, page 9.
364
tInformixSP
tInformixSP
Proprits du tInformixSP
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.
365
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.
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
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.
367
tIngresClose
tIngresClose
Proprits du tIngresClose
Famille de composant Databases/Ingres
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.
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
tIngresCommit
tIngresCommit
Proprits du tIngresCommit
Ce composant est troitement li aux composants tIngresConnection et tIngresRollback. Ils sont gnralement utiliss ensemble lors de transactions.
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
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.
369
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.
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.
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
tIngresInput
tIngresInput
Proprits du tIngresInput
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
371
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
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
tIngresOutput
tIngresOutput
Proprits du tIngresOutput
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.
373
tIngresOutput
Action on data
Die on error
Advanced settings
Encoding Type
374
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
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
375
tIngresRollback
tIngresRollback
Proprits du tIngresRollback
Ce composant est troitement li aux composants tIngresCommit et tIngresConnection. Ils sont gnralement utiliss ensemble lors de transactions.
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
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
tIngresRow
tIngresRow
Proprits du tIngresRow
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
377
tIngresRow
Query
Die on error
Advanced settings
Encoding Type
Commit every
Scnarios associs
378
tIngresSCD
tIngresSCD
Le composant tIngresSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tIngresSCD, page 11.
379
tInterbaseClose
tInterbaseClose
Proprits du tInterbaseClose
Famille de composant Databases/Interbase
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.
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
tInterbaseCommit
tInterbaseCommit
Proprits du tInterbaseCommit
Ce composant est troitement li aux composants tInterbaseConnection et tInterbaseRollback. Ils sont gnralement utiliss ensemble lors de transactions.
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
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.
381
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.
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.
Ce composant est gnralement utilis avec des composants Interbase, notamment les composants tInterbaseCommit et tInterbaseRollback. n/a
382
Scnarios associs
Pour un scnario associ au composant tInterbaseConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.
383
tInterbaseInput
tInterbaseInput
Proprits du tInterbaseInput
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
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.
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.
385
tInterbaseOutput
tInterbaseOutput
Proprits du tInterbaseOutput
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
tInterbaseOutput
Action on data
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.
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.
387
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
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
tInterbaseOutput
le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 associ au composant tMySQLOutput.
389
tInterbaseRollback
tInterbaseRollback
Proprits du tInterbaseRollback
Ce composant est troitement li aux composants tInterbaseCommit et tInterbaseConnection. Ils sont gnralement utiliss ensemble lors de transactions.
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
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
tInterbaseRow
tInterbaseRow
Proprits du tInterbaseRow
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
391
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
Die on error
Advanced settings
392
tInterbaseRow
Encoding Type
Commit every
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.
393
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
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
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
395
tJavaDBOutput
tJavaDBOutput
Proprits du tJavaDBOutput
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
tJavaDBOutput
Action on data
Die on error
Advanced settings
Encoding Type
397
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
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
398
tJavaDBRow
tJavaDBRow
Proprits du tJavaDBRow
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
399
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
Commit every
Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 269 du composant tDBSQLRow.
400
tJavaDBRow
le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528 du composant tMySQLRow.
401
tJDBCColumnList
tJDBCColumnList
Proprits du tJDBCColumnList
Famille de composants Databases/JDBC
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
tJDBCClose
tJDBCClose
Proprits du tJDBCClose
Famille de composant Databases/JDBC
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.
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
403
tJDBCCommit
tJDBCCommit
Proprits du tJDBCCommit
Ce composant est troitement li aux composants tJDBCConnection et tJDBCRollback. Ils sont gnralement utiliss ensemble lors de transactions.
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
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
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.
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
Advanced settings
Use Auto commit
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, au niveau de chaque composant.
405
tJDBCConnection
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
tJDBCInput
tJDBCInput
Proprits du tJDBCInput
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
407
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
408
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.
409
tJDBCOutput
tJDBCOutput
Proprits du tJDBCOutput
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
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).
411
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
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.
413
tJDBCRollback
tJDBCRollback
Proprits du tJDBCRollback
Ce composant est troitement li aux composants tJDBCCommit et tJDBCConnection. Ils sont gnralement utiliss ensemble lors de transactions.
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
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
tJDBCRow
tJDBCRow
Proprits du tJDBCRow
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
415
tJDBCRow
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
Die on error
Advanced settings
Encoding Type
416
tJDBCRow
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 toute base de donnes utilisant une connexion JDBC et couvre toutes les possibilits de requtes SQL.
Scnarios associs
417
tJDBCSP
tJDBCSP
Proprits du tJDBCSP
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
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.
419
tJDBCTableList
tJDBCTableList
Proprits du tJDBCTableList
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
420
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
421
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
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
423
tLDAPInput
tLDAPInput
Proprits du tLDAPInput
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
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.
425
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
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.
427
tLDAPOutput
tLDAPOutput
Proprits du tLDAPOutput
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
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.
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.
429
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
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.
431
tLDAPOutput
La sortie montre les champs suivants : dn, uid et mail comme dfini dans le Job.
432
tLDAPRenameEntry
tLDAPRenameEntry
Proprits du tLDAPRenameEntry
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).
433
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
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
435
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
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
tMaxDBOutput
tMaxDBOutput
Proprits du tMaxDBOutput
Famille de composant Databases/MaxDB
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.
437
tMaxDBOutput
Action on data
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
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
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
439
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
tMaxDBRow
Query
Die on error
Advanced settings
Encoding Type
Commit every
Scnarios associs
441
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
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
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
Fields terminated Rows terminated
443
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
tMSSqlClose
tMSSqlClose
Proprits du tMSSqlClose
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.
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
445
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.
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
446
tMSSqlCommit
tMSSqlCommit
Proprits du tMSSqlCommit
Ce composant est troitement li aux composants tMSSqlConnection et tMSSqlRollback. Ils sont gnralement utiliss ensemble lors de transactions.
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
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.
447
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
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
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.
449
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
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
Encoding Type
451
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
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.
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.
453
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.
454
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).
455
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.
456
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
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.
457
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
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.
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.
Advanced settings
459
tMSSqlOutputBulk
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 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
tMSSqlOutputBulkExec
Proprits du tMSSqlOutputBulkExec
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
461
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
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
Encoding Type
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.
463
tMSSqlRollback
tMSSqlRollback
Proprits du tMSSqlRollback
Ce composant est troitement li aux composants tMSSqlCommit et tMSSqlConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
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.
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
tMSSqlRow
tMSSqlRow
Proprits du tMSSqlRow
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
465
tMSSqlRow
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
466
tMSSqlRow
Encoding Type
Commit every
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.
467
tMSSqlSCD
tMSSqlSCD
Le composant tMSSqlSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tMSSqlSCD, page 17.
468
tMSSqlSP
tMSSqlSP
Proprits du tMSSqlSP
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.
469
tMSSqlSP
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.
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
Encoding Type
470
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.
471
tMSSqlTableList
tMSSqlTableList
Proprits du tMSSqlTableList
Famille de composant Databases/MS SQL
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
472
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
473
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.
Advanced settings
Additional JDBC parameters Lines terminated by Fields terminated by Enclosed by Action on data
474
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.
475
tMysqlClose
tMysqlClose
Proprits du tMysqlClose
Famille de composant Databases/Mysql
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.
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
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.
477
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
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.
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
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
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.
481
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.
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.
Ce composant est gnralement utilis avec des composants MySQL, notamment les composants tMysqlCommit et tMysqlRollback. n/a
482
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.
483
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
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.
485
tMysqlConnection
Lid de la table parent a t rutilis pour alimenter la colonne id_baby.
486
tMysqlInput
tMysqlInput
Proprits du tMysqlInput
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
487
tMysqlInput
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
tMysqlInput
Advanced settings
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
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.
489
tMysqlLastInsertId
tMysqlLastInsertId
Proprits du tMysqlLastInsertId
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 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 tMysqlConnection dans la liste sil y a plus dune connexion dans votre Job.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est un composant intermdiaire. Si vous utilisez ce composant avec un tMysqlOutput, vrifiez que la case Extend Insert de l'onglet Advanced settings est bien dcoche. En effet, Extend Insert permet de faire un chargement par lot, ainsi seul l'ID de la dernire ligne du dernier lot sera retourn.
Limitation
n/a
Scnario : Rcuprer les ID des dernires entres ajoutes

Le scnario Java suivant permet douvrir une connexion une base de donnes MySQL, dy crire des donnes spcifies et enfin de rcuprer les derniers ID ajouts la connexion existante. Cliquez sur chacun des composants suivants et dposez-les dans lditeur graphique : tMySqlConnection, tMySqlCommit, tFileInputDelimited, tMySqlOutput, tMysqlLastInsertId, et tLogRow. Reliez le tMySqlConnection au tFileInputDelimited laide dun lien OnSubJobOk. Reliez le tFileInputDelimited au tMySqlCommit laide dun lien OnSubJobOk.
490
tMysqlLastInsertId
Reliez les trois derniers composants au tFileInputDelimited et entre eux laide de liens Row Main, comme suit :
Slectionnez le tMysqlConnection en cliquant dessus partir de lditeur graphique. Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Dans longlet Basic settings, entrez les paramtres de connexion manuellement ou slectionnez-les partir dune liste de variables de contexte, si vous les avez stockes localement sous le noeud DB connections de la partie Metadata (Mtadonnes) du Repository. Vous accderez cette liste en cliquant dans le champ renseigner puis en appuyant sur Ctrl+Espace. Pour plus dinformation sur les Mtadonnes, consultez le chapitre Dfinition des schmas de mtadonnes du Guide Utilisateur de Talend Open Studio.
Slectionnez le tMysqlCommit en cliquant dessus partir de lditeur graphique, puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Dans le champ Component list, slectionnez le composant tMysqlConnection appropri si vous effectuez un Job plusieurs connexions.
491
tMysqlLastInsertId
Slectionnez le tFileInputDelimited en cliquant dessus partir de lditeur graphique. Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
Dans la liste Property Type, slectionnez loption Built-In. Renseignez le chemin daccs au fichier traiter dans le champ File Name. Dans cet exemple, le nom du fichier est Customers. Dans le champ Row separator, dfinissez le sparateur de lignes permettant didentifier les fins de ligne. De mme, pour Field separator, dfinissez le sparateur de champs permettant de dlimiter les diffrents champs pour chaque ligne. Dfinissez, si ncessaire, le nombre de lignes den-tte et de pied-de-page ignorer, ainsi que le nombre maximum de lignes que vous souhaitez traiter. Dans cet exemple, le fichier comporte une ligne den-tte. Dans la liste Schema, slectionnez loption Built-In, puis cliquez sur les trois points [...] ct de la mention Edit Schema pour dfinir les donnes passer au composant suivant. Sujets associs : consultez les chapitres Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
492
tMysqlLastInsertId
Dans ce scnario, le schma se compose de deux colonnes, name et age. La premire colonne comprend le nom des employs et la seconde comporte leurs ges respectifs. Slectionnez le tMySqlOutput en cliquant dessus partir de lditeur graphique. Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
Cochez la case Use an existing connection. Dans le champ Table, renseignez le nom de la table dans laquelle vous voulez crire la liste des employs. Dans cet exemple, il sagit de la table employee. Slectionnez les actions effectuer dans les champs Action on table et Action on data, partir des listes proposes. Dans cet exemple, on ne veut effectuer aucune action sur la table elle-mme mais excuter une action Insert sur les donnes. Dans la liste Schema, slectionnez loption Built-In puis cliquez sur le bouton Sync columns pour synchroniser les colonnes par rapport au composant prcdent. Dans cet exemple, le schma reproduire dans la table de la base de donnes MySQL se compose des deux colonnes name et age.
Slectionnez le tMySqlLastInsertId en cliquant dessus partir de lditeur graphique. Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
493
tMysqlLastInsertId
Dans le champ Component list, slectionnez le composant tMysqlConnection appropri si vous effectuez un Job plusieurs connexions. Dans la liste Schema, slectionnez loption Built-In puis cliquez sur le bouton Sync columns pour synchroniser les colonnes par rapport au composant prcdent. Dans le schma de sortie du tMySqlLastInsertId, vous pouvez voir la colonne last_insert_id qui indique les dernires ID ajoutes la connexion existante.
Slectionnez le tLogRow en cliquant dessus partir de lditeur graphique, puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations, consultez le tLogRow, page 1095. Sauvegardez votre Job puis appuyez sur F6 pour lexcuter.
Le composant tMysqlLastInsertId affiche les dernires ID ajoutes pour chaque ligne de la connexion existante.
494
tMysqlOutput
tMysqlOutput
Proprits du tMysqlOutput
Le composant tMysqlOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tMysqlOutput 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. Java uniquement DB Version Slectionnez la version de MySQL que vous utilisez.
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.
495
tMysqlOutput
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 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. 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.
496
tMysqlOutput
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 or update on duplicate key or unique index : Ajouter des entres si la valeur insre n'existe pas ou mettre jour les entres si la valeur insre existe dj et quun risque de violation dune cl unique se prsente. Insert ignore : Ajouter uniquement de nouvelles lignes afin dempcher les erreurs de doublons de cls. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur 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).
497
tMysqlOutput
Java uniquement
Die on error
Advanced settings
Additional JDBC parameters Java uniquemen t Extend Insert
Cochez cette case pour insrer un ensemble de lignes dfinies au lieu dinsrer les lignes une par une. Cette option permet un important gain de performance. Number of rows per insert : saisissez le nombre de lignes insrer en un bloc. Notez que si vous slectionnez un nombre important de lignes, cela peut augmenter la quantit de mmoire utilise et donc diminuer les performances. Cette option nest pas compatible avec le lien Reject. Vous devez donc la dcocher si vous utilisez un lien Reject en sortie du composant. Si vous utilisez ce composant avec un tMysqlLastInsertID, vrifiez que la case Extend Insert de l'onglet Advanced settings est bien dcoche. En effet, Extend Insert permet de faire un chargement par lot, ainsi seul l'ID de la dernire ligne du dernier lot sera retourn.
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.
Commit every
Additional Columns
498
tMysqlOutput
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 tMysqlOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier. Use field options Java uniquement Use Hint Options Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour activer la zone de configuration des indicateurs (ou Hints) permettant doptimiser lexcution dune requte. Dans cette zone, les paramtres sont : - HINT : spcifiez lindicateur dont vous avez besoin, en utilisant la syntaxe /*+ */. - POSITION : spcifiez la place de lindicateur dans une instruction SQL. - SQL STMT : slectionnez linstruction SQL que vous souhaitez utiliser. Cochez cette case pour afficher chaque tape du processus dcriture dans la base de donnes. Cochez cette case pour effectuer une action de insertion ou mise jour (Insert or update) en mode Extend Insert. Pour utiliser cette option, vous devez pralablement slectionner le mode Insert dans la liste Action on data de la vue Basic settings et slectionnez le mode Extend Insert dans la vue Advanced settings. 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. Ce composant doit tre utilis en tant que composant de sortie. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes MySQL. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507.
Java uniquement Java uniquement
Enable debug mode
Use duplicate key update mode insert
Scnario 1 : Ajouter une colonne et modifier les donnes

Ce scnario Java est un Job trois composants permettant de crer de manire alatoire des donnes de test laide du composant tRowGenerator, dupliquer la colonne modifier laide du composant tMap et de modifier les donnes insrer en utilisant une expression SQL dans le composant tMysqlOutput.
499
tMysqlOutput
Cliquez et dposez les composants suivants dans lditeur graphique : tRowGenerator, tMap et tMySQLOutput. Connectez-les laide de liens Row Main.
Dans lditeur graphique, double-cliquez sur le tRowGenerator pour afficher longlet Basic settings.
Dans la liste Schema, slectionnez loption Built-In. Cliquez sur le bouton [...] ct du champ Edit schema pour dfinir les donnes transmettre au composant tMap, dans ce scnario, les deux colonnes name et random_date.
Cliquez sur OK pour fermer la bote de dialogue. Cliquez sur le bouton [...] ct du champ RowGenerator Editor pour ouvrir lditeur du tRowGenerator pour paramtrer les donnes gnrer.
500
tMysqlOutput
Cliquez dans le champ Functions correspondant et slectionnez une fonction pour chacune des deux colonnes, getFirstName pour la colonne name et getrandomDate pour la colonne random_date. Dans le champ Number of Rows for Rowgenerator, saisissez 10 pour ne gnrer que dix lignes de prnoms et cliquez sur Ok pour fermer lditeur. Double-cliquez sur le composant tMap pour ouvrir lditeur du tMap. Lditeur souvre et affiche les donnes dentre du composant tRowGenerator.
Dans le panneau Schema editor de lditeur du tMap, cliquez sur le bouton [+] de la table de sortie pour ajouter deux lignes et nommez la premire colonne random_date et la deuxime random_date1.
501
tMysqlOutput
Dans ce scnario, nous souhaitons dupliquer la colonne random_date et adapter le schma afin de modifier les donnes transfrer dans le composant de sortie. Dans lditeur du tMap, glissez la ligne random_date de la table dentre vers les lignes random_date et random_date1 de la table de sortie.
Cliquez sur OK pour fermer lditeur. Dans lditeur graphique, double-cliquez sur le composant tMysqlOutput pour afficher longlet Basic settings et paramtrer ses proprits.
502
tMysqlOutput
Dans la liste Property Type, slectionnez loption Repository et cliquez sur le bouton [...] pour ouvrir la bote de dialogue [Repository content] et slectionnez la connexion la base de donnes adquate. Les informations de connexion sont renseignes automatiquement.
Si vous navez pas stock de connexion votre base de donnes sous le noeud DB connections sous le noeud Metadata du Repository, slectionnez loption Built-in dans la liste Property Type et renseignez les informations de connexion manuellement.
Cliquez sur le bouton [...] ct du champ Table et slectionnez la table modifier : la table Dates dans ce scnario. Dans la liste Action on table, slectionnez loption Drop table if exists and create et slectionnez Insert dans la liste Action on data. Si ncessaire, cliquez sur Sync columns pour rcuprer le schma de colonnes du composant tMap. Cliquez sur longlet Advanced settings pour afficher la vue correspondante et dfinir les paramtres avancs du composant.
503
tMysqlOutput
Dans la zone Additional Columns, paramtrez les modifications appliquer aux colonnes. Dans ce scnario, la colonne One_month_later remplace la colonne random_date_1 et les donnes aussi sont modifies laide dune requte SQL ajoutant un mois la date gnre alatoirement dans la colonne random_date_1. Par exemple : 2007-08-12 devient 2007-09-12. -Saisissez One_Month_Later dans la cellule Name. -Dans la cellule SQL expression, saisissez la requte SQL ajoutant un mois, dans ce scnario : adddate(Random_date, interval 1 month). -Slectionnez Replace dans la liste Position. -Slectionnez Random_date1 dans la liste Reference column.
Pour ce Job, nous dupliquons la colonne random_date_1 dans le table avant de la remplacer par la colonne One_Month_Later. Le but de cette manipulation tait de voir les modifications apportes en amont.
Enregistrez le Job et appuyez sur F6 pour lexcuter. La nouvelle colonne One_month_later remplace la colonne random_date1 dans la base de donnes et ajoute un mois chaque date gnre alatoirement.
Voir galement : le Scnario : Afficher la base de donnes en sortie, page 264 du composant tDBOutput.
Scnario 2 : Effectuer des mises jour dans une base de donnes

Ce scnario Java est un Job deux composants permettant de mettre jour les donnes dune table MySQL partir dun fichier dlimit. A partir de la Palette, cliquez et dposez les composants tFileInputDelimited et tMySQLOutput dans lditeur graphique puis connectez-les laide dun lien Row Main.
Dans lditeur graphique, double-cliquez sur le tFileInputDelimited pour afficher longlet Basic settings.
504
tMysqlOutput
Dans le champ Property Type, slectionnez le mode Repository si vous avez stock les informations du fichier dlimit sous le noeud Metadata du Repository ou slectionnez le mode Built-In pour les dfinir manuellement. Dans ce scnario, on utilise le mode Built-In.
Dans le champ File Name, renseignez manuellement le chemin daccs au fichier contenant les mises jour propager dans la base de donnes ou cliquez sur le bouton [...] pour parcourir vos dossiers jusqu ce fichier. Dans cet exemple, on utilise le fichier customer_update, qui comporte quatre colonnes, id, CustomerName, CustomerAddress et idState.
Dfinissez si ncessaire les sparateurs de lignes (Row separator) et de champs (Field separator), len-tte (Header) et le pied-de-page (Footer), ainsi que le nombre de lignes traiter (Limit). La premire ligne, qui porte le nom des colonnes, est ignore dans cet exemple, cest pourquoi le champ Header est dfini 1. Dans le champ Schema, slectionnez le mode Built in puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes passer au composant suivant. Dans cet exemple, le schma est constitu de quatre colonnes, id, CustomerName, CustomerAddress et idState.
505
tMysqlOutput
Devant le nom de chaque colonne se trouve une case Key. Cochez cette case pour la ou les colonne(s) que vous voulez dfinir comme cl.
Vous devez obligatoirement dfinir au moins une cl pour que le Job sexcute. Dans le cas contraire, le Job sarrte automatiquement et un message derreur saffiche dans la console de log.
Dans lditeur graphique, double-cliquez sur le composant tMysqlOutput pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] ct du champ Edit schema pour consulter le schma et vrifier quau moins une colonne a t dfinie comme cl. Dans le champ Property Type, slectionnez Repository si vous avez stock les informations de connexion la base de donnes sous le noeud Metadata du Repository ou slectionnez le mode Built-In, puis renseignez manuellement les champs suivants : Host, Port, Database, Username et Password. Dans le champ Table, saisissez le nom de la table mettre jour. Dans le champ Action on table, slectionnez lopration que vous souhaitez effectuer sur la table. Pour ce scnario, slectionnez None car la table existe dj. Dans le champ Action on data, slectionnez lopration que vous souhaitez effectuer sur les donnes. Pour ce scnario, slectionnez loption Update pour mettre la table jour. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
506
tMysqlOutput
A partir de votre explorateur de base de donnes, vous pouvez vrifier que la table customers a bien t mise jour. Comme avant sa mise jour, elle se prsente sous la forme des quatre colonnes id, CustomerName, CustomerAddress et idState, mais certains champs ont t modifis selon les donnes du fichier dlimit customer_update.
Scnario 3 : Rcuprer les donnes errones laide dun lien Reject

Ce scnario dcrit un Job quatre composants effectuant une migration dun fichier client vers la table dune base de donnes MySQL et redirigeant les donnes errones vers un fichier CSV laide dun lien Reject.
Dans le Repository, slectionnez la mtadonne correspondant au fichier client que vous souhaitez migrer et glissez-la dans lespace de modlisation. Dans la bote de dialogue [Components], slectionnez tFileInputDelimited et cliquez sur OK. Les proprits du composant seront automatiquement renseignes.
tMysqlOutput
Si vous navez pas enregistr les informations concernant votre fichier client sous le noeud Metadata du Repository. Glissez un composant tFileInputDelimited de la famille File > Input de la Palette et renseignez ses proprits manuellement dans la vue Component. A partir de la Palette, glissez un composant tMap de la famille Processing dans lespace de modlisation. Dans le Repository, dveloppez le noeud Metadata et Db Connections, et slectionnez la mtadonne de connexion la base de donnes dans laquelle vous souhaitez migrer vos donnes et glissez-la dans lespace de modlisation. Dans la bote de dialogue [Components], slectionnez tMysqlOutput et cliquez sur OK. Les proprits de connexion la base de donnes seront automatiquement renseignes. Si vous navez pas enregistr les informations de connexion votre base de donnes sous le noeud Db Connections du Repository. Glissez un composant tMysqlOutput de la famille Databases de la Palette et renseignez ses proprits manuellement dans la vue Component. Pour plus dinformations, consultez Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio. A partir de la Palette, slectionnez un composant tFileOutputDelimited de la famille File > Output et glissez-le dans lespace de modlisation. Reliez les composant customers et tMap, et les composants tMap et Localhost laide dun lien de type Row Main. Vous nommerez ce deuxime lien out. Reliez le composant Localhost au tFileOutputDelimited laide dun lien de type Row > Reject. Double-cliquez sur le composant customers pour afficher la vue Component correspondante.
Dans la liste Property Type, slectionnez le mode Repository puis cliquez sur le bouton [...] correspondant pour slectionner la mtadonne contenant la connexion votre fichier. Sinon, slectionnez le mode Built-in et paramtrez manuellement les champs suivants. Cliquez sur le bouton [...] ct du champ File Name, et indiquez le chemin daccs et le nom du fichier utiliser.
508
tMysqlOutput
Dans les champs Row et Field Separator, saisissez entre guillemets les sparateurs de lignes et de champs utiliss dans le fichier. Dans les champs Header, Footer et Limit, saisissez le nombre de ligne den-tte et de pied-de-page ignorer, ainsi que le nombre de ligne limite traiter. Dans la liste Schema, slectionnez Repository et cliquez sur le bouton [...] correspondant pour slectionner le schma de votre fichier, sil est stock sous le noeud Metadata du Repository. Sinon cliquez sur le bouton [...] correspondant au champ Edit schema et dfinissez manuellement le schma de votre fichier. Le schma se prsente comme suit :
Double-cliquez sur le tMap afin douvrir son diteur.
509
tMysqlOutput
Slectionnez les colonnes id, CustomerName, CustomerAddress, idSate, id2, RegTime, RegisterTime de la zone de gauche et glissez-les dans la table out de la zone de droite.
Dans la zone Schema editor en bas de lditeur du tMap, dans le tableau droite, changez la longueur de la colonne CustomerName en 28 afin de crer une erreur. Ainsi, les donnes dont la longueur est suprieure 28 creront des erreurs qui pourront tre rcupres grce au lien Reject. Cliquez sur OK. Dans lespace de modlisation, double-cliquez sur le composant de sortie Localhost pour afficher la vue Component correspondante.
510
tMysqlOutput
Dans la liste Property Type, slectionnez le mode Repository puis cliquez sur le bouton [...] correspondant pour slectionner la mtadonne de connexion la base de donnes. Les informations de connexion sont renseignes automatiquement. Sinon, slectionnez le mode Built-in et paramtrez ces champs manuellement. Dans le champ Table, saisissez le nom de la table crer. Dans ce scnario, nous lappelons customers_data. Dans la liste Action on data, slectionnez loption Create table. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Assurez-vous que la case Die on error est bien dcoche, afin que le Job sexcute malgr lerreur que vous venez de crer. Cliquez sur longlet Advanced settings de la vue Component pour paramtrer les paramtres avancs du composant.
511
tMysqlOutput
Dcochez la case Extend Insert permettant dinsrer des lignes par bloc car cette option nest pas compatible avec le lien Reject. Double-cliquez sur le composant tFileOutputDelimited pour paramtrer ses proprits dans la vue Component.
Cliquez sur le bouton [...] ct du champ File Name pour indiquer le rpertoire de destination et le nom du fichier de sortie. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
512
tMysqlOutput
Les donnes en erreur sont envoyes dans le fichier dlimit, ainsi que le type derreur rencontre. Ici, nous avons affaire des donnes tronques : Data truncation.
513
tMysqlOutputBulk
tMysqlOutputBulk
Proprits du tMysqlOutputBulk
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 chargement des donnes dans la base de donnes.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards MySQL. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter 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. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) sparant les lignes. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Cochez cette case pour inclure len-tte des colonnes dans le 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.
Field separator Row separator Append Include header Schema et Edit Schema
514
tMysqlOutputBulk
Encoding Type
Utilisation
Ce composant est gnralement utilis avec le composant tMySQlBulkExec. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes MySQL.
Scnario : Insrer des donnes transformes dans une base MySQL

Ce scnario dcrit un Job contenant quatre composants dont le but est dalimenter un base MySQL partir dun fichier paramtres contenant des donnes transformes. Deux tapes sont requises pour ce Job, dune part pour crer le fichier paramtres qui sera utilis dans un second temps. La premire tape inclut une phase de transformation des donnes contenues dans le fichier.
Glissez et dposez les composants suivants : tRowGenerator, tMap, tMysqlOutputBulk et tMysqlBulkExec dans lespace de modlisation. Connectez le flux principal laide de connexions Row > Main. Et connectez le composant de dbut (tRowgenerator, dans cet exemple) au composant tMysqlBulkExec laide dune connexion trigger de type OnSubjobOk. Un composant tRowGenerator est utilis pour gnrer des donnes de faon alatoire. Double-cliquez sur le composant tRowGenerator pour lancer lditeur. Dfinissez le schma des lignes gnrer et la nature des donnes gnrer. Dans cet exemple, le fichier clients crer contient les colonnes suivantes : ID, First Name, Last Name, Address, City qui sont toutes de type chane de caractres (string) lexception de lID qui est de type entier (integer).
515
tMysqlOutputBulk
Certaines informations du schma nont pas ncessairement besoin dtre affiches. Pour les dissimuler, cliquez sur le bouton Columns dans la barre doutils et dcochez les colonnes cacher, par exemple : Precision ou Parameters. Utilisez le bouton [+] pour ajouter autant de colonnes que possible votre schma. Cliquez sur le bouton Refresh en haut droite de lditeur pour visualiser un aperu des lignes gnres en sortie dans longlet Preview en bas de lditeur. Cliquez sur OK pour valider. Dans lespace de modlisation, double-cliquez sur le composant tMap pour ouvrir son diteur et paramtrer la transformation. Faites glisser toutes les colonnes de la table dentre (row1) vers la table de sortie (clients).
Appliquez la transformation sur la colonne LastName en ajoutant .toUpperCase() la fin. Cela mettra les noms des clients en majuscule. Cliquez sur OK pour valider la transformation.
516
tMysqlOutputBulk
Dans lespace de modlisation, double-cliquez sur le composant tMysqlOutputBulk pour afficher sa vue Component et paramtrer ses proprits.
Dfinissez le chemain daccs et le nom du fichier produire dans le champ File Name. Si les proprits du fichier dlimit sont conserves dans le Repository, slectionnez lentre correspondante dans le champ Property type afin de les rcuprer. Dans cet exemple, le nom de fichier est clients.txt. Le schma est propag partir du composant tMap, si vous cliquez sur Yes lorsque la bote de dialogue vous demande de confirmer la propagation. Sinon, cliquez sur le bouton Sync columns pour rcuprer le schma. Dans lespace de modlisation, double-cliquez sur le composant tMysqlBulkExec pour paramtrer la requte INSERT excuter.
Dfinissez les informations de connexion la base de donnes. Nous vous recommandons de conserver ce type dinformations dans le Repository, afin de pouvoir les rcuprer tout moment et pour tous vos Jobs. Pour rcuprer la mtadonne de connexion la base de donnes, slectionnez Repository dans le champ Property Type puis slectionnez la connexion adquate dans le champ adjacent. Les champs suivants seront renseigns automatiquement. Dans le champs Action on table, slectionnez None puisque vous souhaitez insrer des nouvelles donnes dans une table dj existante. Dans le champ Table, saisissez le nom de la table alimenter, ici, clients. Dans le champ Local filename, slectionnez le fichier clients.txt contenant les donnes charger dans la table.
tMysqlOutputBulk
Cliquez sur le bouton [...] du champ Edit schema et dfinissez le schma de la manire suivante :
Cliquez sur le bouton [+] pour ajouter le nombre de lignes ncessaire et paramtrez-les. Cliquez sur le bouton Reset DB Types (icne de base de donnes) afin de renseigner la colonne DB Type. Cliquez sur OK. A partir de la vue Component, cliquez sur longlet Advanced settings pour paramtrer les proprits avances.
Dans la liste Action on data, slectionnez loption Insert records in table pour insrer les donnes dans la table clients. Assurez-vous que lencodage correspond celui des donnes manipules. Puis appuyez sur F6 pour excuter le Job.
518
tMysqlOutputBulk
La table de la base clients est alimente avec les donnes du fichier notamment les donnes transformes dans la colonne Last name. Pour une simple opration dInsert ne ncessitant pas de transformation, lutilisation du composant tMysqlOutputBulkExec permet dconomiser une tape dans le processus et ainsi de gagner en performance. Voir galement les Proprits du tMysqlOutputBulkExec, page 520.
519
tMysqlOutputBulkExec
Proprits du tMysqlOutputBulkExec
Fonction Objectif
Le tMysqlOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tMysqlOutputBulkExec 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 Host Port Database Username et Password Action on table Slectionnez la version de MySQL que vous utilisez. 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. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectue aucune action sur la table. Drop and create the table : supprime la table puis en crer une nouvelle. Create a table : cre une table qui nexiste pas encore. Create table if doesnt exist : cre la table si ncessaire. Clear a table : supprime le contenu de la table. Nom de la table crire.
Basic settings
Table
Une seule table peut tre crite la fois et cette table doit dj exister pour que lopration dInsert soit autorise.
Local 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 de nouvelles lignes la fin du fichier.
Append
520
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. Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Caractres entourant les donnes. Cette case est coche par dfaut. Cette option permet de crer le dossier contenant le fichier de sortie sil nexiste pas dj. 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. 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. Cette case est coche par dfaut. Elle permet de prendre les champs de valeur NULL en compte. Si vous la dcochez, les valeurs NULL seront remplaces par des valeurs vides. 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.
Advanced settings
Additional JDBC Parameters Row separator Field separator Text enclosure Create directory if not exists Custom the flush buffer size
Action on data
Records contain NULL value
Encoding Type
Scnario : Insrer des donnes dans une base MySQL

Ce scnario est un Job deux composants qui effectue le mme type dopration dalimentation que les composants tMysqlOutputBulk, page 514 et tMysqlBulkExec, page 473, mais sans transformation de donnes.
Cliquez et dposez les composants suivants : tRowGenerator et tMysqlOutputBulkExec. Connectez les composants via un lien de type Row > Main. Paramtrez le tRowGenerator de la mme manire que dans le Scnario : Insrer des donnes transformes dans une base MySQL, page 515. Le schma est constitu de plusieurs colonnes notamment : ID, First Name, Last Name, Address et City. A partir de lespace de modlisation, double-cliquez sur le composant tMysqlOutputBulkExec pour afficher la vue Component et paramtrer ses proprits.
Paramtrez la connexion la base de donnes si ncessaire, en suivant les recommandations du Scnario : Insrer des donnes transformes dans une base MySQL, page 515, concernant la conservation des informations de connexion dans la partie Metadata du Repository. Pour cela, slectionnez Repository dans le champ Property Type et slectionnez la connexion adquate dans le champ adjacent. Les champs suivants seront renseigns automatiquement. Pour plus dinformations, consultez les sections Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Dans le champ Action on table, slectionnez loption None puisque vous souhaitez insrer les donnes dans une table dj existante. Dans le champ Table, saisissez le nom de la table alimenter, ici, clients. Dans le champ Local filename, indiquez le chemin daccs et le nom du fichier contenant les donnes charger dans la table, ici, clients.txt. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Cliquez sur longlet Advanced settings pour paramtrer les proprits avances du composant.
522
Dans la liste Action on data, slectionnez loption Insert records in table pour insrer ces nouvelles donnes dans la table. Appuyez sur F6 pour excuter le Job Le rsultat devrait tre relativement identique celui obtenu dans le Scnario : Insrer des donnes transformes dans une base MySQL, page 515. Cependant les donnes elles-mmes peuvent diffrer lgrement puisque les donnes sont regnres de faon alatoire chaque excution.
523
tMysqlRollback
tMysqlRollback
Proprits du tMysqlRollback
Ce composant est troitement li aux composants tMysqlCommit et tMysqlConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tMysqlRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Close connection Slectionnez le composant tMysqlConnection 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.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce component est gnralement utilis avec dautres composants MySQL, notamment les composants tMysqlConnection et tMysqlCommit components. n/a
Limitation
Scnario : Annuler linsertion de donnes dans des tables mre/fille

En vous basant sur le Scnario : Insrer des donnes dans des tables mre/fille, page 483 du composant tMysqlConnection, insrez une opration de rollback (annulation) afin dviter un commit inutile.
Cliquez et dposez un composant tMysqlRollback et connectez-le au composant de dbut.
524
tMysqlRollback
Paramtrez lunique champ du Rollback avec la connexion la base de donnes adquate. Ce nouvel lment ajout au Job assure que la transaction ne sera pas commite partiellement.
525
tMysqlRow
tMysqlRow
Proprits du tMysqlRow
Fonction
tMysqlRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tMysqlRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. 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 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.
Objectif
Basic settings
526
tMysqlRow
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. 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.
Query
Die on error
Advanced settings
527
tMysqlRow
Encoding Type
Commit every
Scnario 1 : Supprimer et re-gnrer un index de table MySQL

Le scnario suivant cre un Job quatre composants permettant de supprimer un index de table, effectuer un Insert dans cette table avant de re-gnrer lindex.
Slectionnez les composants suivants dans la Palette et dposez-le dans lespace de modlisation : tMysqlRow (x2), tRowGenerator, tMysqlOutput.
tMysqlRow
Connectez le composant tMysqlIntput au tRowGenerator. Puis laide dune connexion OnComponentOk, connectez le premier composant tMysqlRow au tMysqlInput. Connectez le composant tRowGenerator au second composant tMysqlRow laide dune connexion OnSubjobOk. Slectionnez le composant tMysqlRow et renseignez les proprits de la base de donnes dans longlet Basic settings. Dans les champs Property type et Schema, slectionnez la base de donnes approprie dans la liste. Les dtails de connexion la base de donnes ainsi que le schma de la table sont renseigns automatiquement. Propagez les informations de proprits et de schma aux autres composants du Job. La requte tant conserve dans les Metadata du Repository, vous pouvez galement slectionner Repository dans le champ Query type et cliquer sur la requte correspondante. Si vous ne conservez pas vos requtes dans le Repository, saisissez la dclaration SQL suivante : drop index <index_name> on <table_name> Puis slectionnez le deuxime composant tMysqlRow, vrifiez les proprits et le schma de base de donnes. Puis saisissez la dclaration SQL permettant de recrer un index laide de la formulation suivante : create index <index_name> on <table_name> (<column_name>); Le composant tRowGenerator permet de gnrer automatiquement les colonnes ajouter la table de sortie dfinie. Slectionnez le composant tMysqlOutput et renseignez les proprits de connexion la base de donnes soit partir du Repository ou manuellement si les informations de connexion ne sont utilises que pour ce Job. La table alimenter a pour nom : comprehensive. Le schma est automatiquement hrit du flux de donnes du tLogRow. Editez le schma et vrifiez que sa structure correspond au schma attendu par la table de base de donnes spcifie. Dans le champ Action on table, slectionnez None et dans le champ Action on data, slectionnez Insert. Aucune colonne supplmentaire nest requise pour ce Job. Appuyez sur F6 pour excuter ce Job. Si vous avez la possibilit dobserver laction sur la base de donnes, remarquez que lindex a t supprim en dbut de Job puis recr la fin de laction dInsert. Voir galement : les proprits du tDBSQLRow, page 267.
529
tMysqlRow
Scnario 2 : Utiliser linstance PreparedStatement pour faire une requte sur des donnes
Le scnario suivant dcrit un Job quatre composants permettant de mettre en correspondance la colonne dune table avec un fichier clients. En effet, la table MySQL contient la liste de tous les Etats amricains avec leur identifiant et le fichier contient des informations sur vos clients avec lidentifiant de ltat dans lequel ils rsident, et nous souhaitons rcuprer le nom de lEtat pour chaque client laide dune requte SQL. Afin de traiter un grand nombre de donnes plus rapidement, nous utilisons linstance PreparedStatement permettant de nexcuter quune seule fois la requte au lieu de leffectuer chaque ligne, puis chaque ligne de donnes est envoy en paramtre. Pour ce scnario, nous utilisons un fichier et une base de donnes dont nous avons pralablement stock la connexion et les proprits dans des mtadonnes du Repository. Pour plus dinformations concernant la cration de mtadonnes de fichiers dlimits, consultez la section Configurer un schma File Delimited, pour plus dinformations concernant la cration de mtadonnes de connexion une base de donnes, consultez la section Configurer une connexion DB, et pour plus dinformations sur lutilisation de ces mtadonnes, consultez la section Paramtrer un schma du Repository du Guide Utilisateur des composants Talend Open Studio.
A partir du Repository, dveloppez le noeud Metadata et File delimited Slectionnez la mtadonne correspondant au fichier clients que vous souhaitez utiliser dans ce Job. Ici, nous utilisons la mtadonne customers. Glissez cette mtadonne dans lespace de modlisation et double-cliquez sur tFileInputDelimited dans la bote de dialogue Components afin de crer un composant tFileInputDelimited dj paramtr.
Dans la liste Schema, slectionnez Built-in afin de modifier le schma de votre composant. Puis, cliquez sur le bouton [...] ct du champ Edit schema pour ajouter la colonne dans laquelle insrer le nom de lEtat.
530
tMysqlRow
Cliquez sur le bouton [+] pour ajouter une colonne au schma. Renommez cette colonne LabelStateRecordSet, et elle est de type objet, donc slectionnez Object dans la liste Type. Cliquez sur OK pour enregistrer vos modifications. A partir de la Palette, slectionnez les composants tMysqlRow, tParseRecordSet et tFileOutputDelimited et glissez-les dans lespace de modlisation. Reliez les quatre composants via des liens de type Row > Main. Double-cliquez sur le composant tMysqlRow pour paramtrer ses proprits dans longlet Basic settings de la vue Component.
531
tMysqlRow
Dans la liste Property Type, slectionnez Repository et cliquez sur le bouton [...] pour slectionner la connexion la base de donnes centralise dans les mtadonnes du Repository. Les champs DB Version, Host, Port, Database, Username et Password sont renseigns automatiquement. Si vous tes en mode Built-in, renseignez ces champs manuellement. Dans la liste Schema, slectionnez Built-in pour paramtrer le schma manuellement et ajouter la colonne LabelStateRecordSet, ou cliquez directement sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Dans le champ Query, saisissez la requte SQL utiliser. Ici, nous souhaitons rcuprer les noms des Etats amricains contenus dans la colonne LabelState de la table MySQL us_state : "SELECT LabelState FROM us_state WHERE idState=?". Le point dinterrogation ? reprsente le paramtre dfinir dans longlet Advanced settings. Cliquez sur longlet Advanced settings pour paramtrer les proprits avances du composant.
532
tMysqlRow
Cochez la case Propagate QUERYs recordset et slectionnez la colonne LabelStateRecordSet dans la liste use column pour insrer le rsultat de la requte dans cette colonne. Cochez la case Use PreparedStatement et dfinissez le paramtre utilis dans la requte dans le tableau Set PreparedStatement Parameters. Cliquez sur le bouton [+] pour ajouter un paramtre. Dans la cellule Parameter Index, saisissez la position du paramtre dans linstruction SQL. Saisissez 1 tant donn que nous nutilisons quun seul paramtre dans notre exemple. Dans la cellule Parameter Type, saisissez le type du paramtre. Ici, le paramtre est de type entier, donc slectionnez Int dans la liste. Dans la cellule Parameter Value, saisissez la valeur du paramtre. Ici, nous souhaitons rcuprer le nom de lEtat en fonction de leur ID pour chaque client du fichier dentre, donc saisissez row1.idState. Double-cliquez sur le composant tParseRecordSet pour paramtrer ses proprits dans longlet Basic settings de la vue Component.
533
tMysqlRow
Dans la liste Prev. Comp. Column list, slectionnez la colonne du composant prcdent analyser. Dans cet exemple, slectionnez la colonne LabelStateRecordSet. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent et le tableau Attribute table est automatiquement renseign avec les colonnes du schma. Dans le tableau Attribute table, dans le champ Value correspondant la colonne LabelStateRecordSet, saisissez entre guillemets le nom de la colonne contenant le nom des Etats rcuprer et mettre en correspondance avec chaque client. Dans cet exemple, saisissez LabelState. Double-cliquez sur le composant tFileOutputDelimited pour paramtrer ses proprits dans longlet Basic settings de la vue Component.
Dans le champ File Name, renseignez le chemin daccs et le nom du fichier de sortie. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
534
tMysqlRow
Une colonne contenant le nom de lEtat amricain correspondant chaque client a t ajoute au fichier.
535
tMysqlSCD
tMysqlSCD
Le composant tMysqlSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tMysqlSCD page 19.
536
tMysqlSCDELT
tMysqlSCDELT
Le composant tMysqlSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tMysqlSCDELT, page 32.
537
tMysqlSP
tMysqlSP
Proprits du tMysqlSP
Familles de composant Databases/Mysql
Le composant tMysqlSP appelle une procdure stocke de base de donnes. Le tMysqlSP 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 Host Port Database Username et Password Encoding Cochez cette case lorsque vous utilisez le composant tMysqlConnection. 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. 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. 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.
538
tMysqlSP
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.
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 : Trouver le libell State laide dune procdure stocke

Le Job suivant a pour but de trouver les libells State en fonction des ID impairs de la colonne State dune table MySQL deux colonnes laide dune procdure stocke.
Cliquez et dposez les composants suivants dans lespace de modlisation : tRowGenerator, tMysqlSP et tLogRow. Connectez les composants laide dune connexion de type Row Main. Le tRowGenerator est utilis pour gnrer des ID impairs. Double-cliquez sur le composant pour lancer lditeur.
Cliquez sur le bouton [+] pour ajouter une colonne au schma gnrer.
539
tMysqlSP
Cochez la case Key pour dfinir lentre comme tant une cl primaire et dfinissez le Type en Int (entier). Dans le champ Length, la longueur est de 2 chiffres au maximum. Utilisez la fonction prtablie appele sequence mais modifiez les paramtres dans la partie infrieure de la fentre.
Modifiez la valeur (Value) de step : de 1 2 pour cet exemple. Mais la valeur de dpart (start value) reste 1. Dans le champ Number of generated rows, dfinissez le nombre de lignes gnrer 25, afin que tous les ID impairs de State (il y a 50 Etats) soient gnrs. Cliquez sur OK pour valider la configuration. Puis slectionnez le composant tMysqlSP et paramtrez ses proprits.
540
tMysqlSP
Dans le champ Property type, slectionnez loption Repository puis slectionnez lentre correspondante dans la liste. Les informations de connexion sont remplies automatiquement. Sinon, paramtrez les informations de connexion manuellement. Cliquez sur Sync Column pour rcuprer le schma gnr du composant prcdent. Puis cliquez sur Edit Schema et ajoutez une colonne supplmentaire contenant les libells des Etats (State) obtenir en sortie, en plus de lID. Slectionnez le type dencodage dans la liste. Dans le champ SP Name, saisissez le nom de la procdure comme il a t dfini dans la base de donnes (ici, getstate). La procdure excuter correspond : DROP PROCEDURE IF EXISTS `talend`.`getstate` $$ CREATE DEFINER=`root`@`localhost` PROCEDURE `getstate`(IN pid INT, OUT pstate VARCHAR(50)) BEGIN SELECT LabelState INTO pstate FROM us_states WHERE idState = pid; END $$ Dans la zone Parameters, cliquez sur le bouton (+) pour ajouter une ligne la table. Dfinissez le champ Column en ID, et le champ Type en IN, ainsi il sera considr comme paramtre dentre dans la procdure. Ajoutez une deuxime ligne et dfinissez le champ Column en State et le champ Type en Out, ainsi il sera considr comme le paramtre de sortie a retourne. Et enfin, paramtrez les proprits du composant tLogRow.
Synchronisez le schma avec celui du composant prcdent en cliquant sur le bouton Sync columns. Et cochez la case Print values in cells of a table pour un meilleur confort de lecture. Puis enregistrez votre Job et excutez-le.
La sortie affiche les diffrents Etats (State) avec leur ID impair comme dfini dans la procdure.
tMysqlSP
Consultez galement le composant tParseRecordSet, page 629 si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.
542
tMysqlTableList
tMysqlTableList
Proprits du tMysqlTableList
Le composant tMysqlTableList effectue une opration ditration sur toutes les tables dune base de donnes, grce une connexion MySQL dfinie. Le composant tMysqlTableList permet de lister les noms des tables MySQL grce aux commandes SELECT et WHERE. Component list Slectionnez le composant tMysqlConnection 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 MySQL, notamment avec le tMysqlConnection. n/a
Scnario : Effectuer une opration ditration sur des tables et en effacer le contenu grce un modle SQL dfini par lutilisateur (SQL Template)
Le scnario Java suivant dcrit un Job trois composants qui permet deffectuer une opration ditration, dans les tables spcifies dune base de donnes MySQL, en utilisant une clause de type WHERE. Le Job permet ensuite deffacer le contenu de ces tables directement sur le SGBD grce un modle SQL (SQL Template) dfini par lutilisateur. Pour une utilisation avance, commencez par crer une connexion la base de donnes qui contient les tables que vous voulez vider de leur contenu. Dans la vue en arborescence du Repository, dveloppez le noeud Metadata puis cliquez droit sur DB Connections pour crer une connexion la base de donnes de travail et stocker les informations de connexion en local. Pour plus dinformations sur les mtadonnes (metadata), consultez le chapitre Dfinition des schmas de mtadonnes du Guide Utilisateur de Talend Open Studio. Sinon, dposez un composant tMySQLConnection dans lditeur graphique et renseignez les paramtres de connexion manuellement. A partir du Repository, dposez dans lditeur graphique la connexion que vous venez de crer. La bote de dialogue [Components] saffiche lcran.
543
tMysqlTableList
Slectionnez le composant tMySQLConnection puis cliquez sur OK. Le composant tMySQLConnection apparait alors dans lditeur graphique et les paramtres de connexion, accessibles depuis la vue Basic settings, sont automatiquement renseigns. A partir de la Palette, cliquez-dposez les composants tMysqlTableList et tELT dans lditeur graphique. Reliez les composants tMysqlConnection et tMysqlTableList laide dun lien Trigger de type OnSubJobOk.
Reliez les composants tMysqlTableList et tELT laide dun lien de type Iterate. Double-cliquez sur le tMysqlConnection pour afficher la vue Basic settings du composant si vous voulez en vrifier les paramtres de connexion.
Dans cet exemple, on veut se connecter une base de donnes MySQL appele examples. Dans lditeur graphique, double-cliquez sur le composant tMysqlTableList pour en afficher les paramtres de bases et les dfinir (vue Basic settings).
Slectionnez la connexion MySQL approprie partir de la liste droulante Component list, dans le cas o vous utilisez plus dune connexion.
544
tMysqlTableList
Renseignez la clause de type WHERE dans le champ appropri, en veillant utiliser la bonne syntaxe, pour effectuer une itration sur la ou les tables dont vous voulez effacer le contenu. Dans ce scnario, on veut oprer litration sur toutes les tables dont le nom commence par ex. Dans lditeur graphique, double-cliquez sur le composant tELT pour en afficher les paramtres de base et les dfinir (vue Basic settings).
Dans le champ Database Name, renseignez le nom de la base de donnes o se trouvent les tables sur lesquelles vous voulez travailler. Slectionnez la connexion MySQL approprie partir de la liste droulante Component list, dans le cas o vous utilisez plus dune connexion. Cliquez dans le champ Table name et appuyez sur Ctrl+Espace pour atteindre la liste gnrale des variables. A partir de cette liste de variables, slectionnez ((String)globalMap.get("tMysqlTableList_1_CURRENT_TABLE")). Comment crer votre propre modle SQL (SQL Template) : Dans la vue en arborescence du Repository, dveloppez successivement les noeuds SQL Templates et MySQL.
Cliquez-droit sur le noeud UserDefined et slectionnez loption Create SQLTemplate partir de la liste. Lassistant New SQLTemplate saffiche lcran.
545
tMysqlTableList
Saisissez un nom pour le nouveau modle (SQL template) et remplissez les autres champs si ncessaire, puis cliquez sur Finish pour fermer lassistant. Lditeur de modle SQL saffiche dans lditeur graphique. Supprimez le code existant et saisissez le code permettant dexcuter laction voulue, cest--dire, ici, effacer le contenu de toutes les tables dont les noms commencent par ex.
Dans un code SQL template, il est impratif dutiliser le nom exact de la variable, en association avec le paramtre dsignant le nom de la table (__TABLE-NAME__ dans cet exemple). Pour afficher le nom de la variable utilise, positionnez votre curseur sur le champ Table Name de la vue Basic Settings du composant tELT.
Appuyez sur Ctrl+S pour sauvegarder le nouveau modle que vous venez de dfinir. La prochaine tape consiste ajouter ce nouveau modle SQL template la liste de modles du mme type dans le composant tELT.
546
tMysqlTableList
Comment ajouter votre propre modle SQL la liste de modles du mme type : Dans la vue Component du composant tELT, cliquez sur longlet SQL Templates pour afficher la liste de modles SQLTemplate List.
Cliquez sur le bouton Add et ajoutez deux lignes de modles SQL template. Cliquez sur la premire ligne pour afficher un menu droulante puis cliquez sur la flche de ce menu pour drouler la liste des modles.
Dans la liste, slectionnez le modle SQL template que vous venez de crer. Assurez-vous que le modle de la seconde ligne est bien en mode Commit. Enregistrez le Job et appuyez sur F6 pour lexcuter. Toutes les tables de la base de donnes MySQL examples dont le nom commence par ex sont alors vides de leur contenu.
Scnario associ
547
tNetezzaBulkExec
tNetezzaBulkExec
Proprits du tNetezzaBulkExec
Famille de composant Databases/Netezza
Fonction Objectif
Le composant tNetezzaBulkExec effectue une action dInsert sur les donnes fournies. Le tNetezzaBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Netezza. 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 tNetezzaConnection. 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 base de donnes.
Basic settings
548
tNetezzaBulkExec
Table
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. 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.
File Name
Nom du fichier traiter. Voir galement :Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Caractre, chane ou expression rgulire sparant les champs. Cochez cette case pour utiliser des caractres pour entourer les donnes. Chane (ex : \n sous Unix) sparant les lignes. Caractre dchappement de la ligne. Date format : Utilisez ce champ pour reprsenter lordre des mois, des jours et des annes sous forme de chane de caractres. Date delimiter : Utilisez ce champ pour dfinir llment sparateur entre les valeurs. Time format : Utilisez ce champ pour reprsenter le format de lheure sous forme de chane de caractres. Time delimiter : Utilisez ce champ pour dfinir llment sparateur entre les valeurs. 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. Saisissez le nombre maximal derreurs possibles avant que le processus ne sarrte. Renseignez le nombre de lignes ignorer.
Advanced settings
Field Separator Require quotes () around data files Row Separator Escape character Date format / Date delimiter
Time format/ Time delimiter
Encoding
Max Errors Skip Rows
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant couvre toutes les possibilits de requte dans les bases de donnes Netezza. n/a
549
tNetezzaBulkExec
Scnarios associs
Pour des scnarios associs au composant tNetezzaBulkExec, consultez : 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. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.
550
tNetezzaClose
tNetezzaClose
Proprits du tNetezzaClose
Le composant tNetezzaClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Netezza. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tNetezzaConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tNetezzaConnection et tNetezzaRollback. Il est gnralement utilis avec un composant tNetezzaConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tNetezzaClose, consultez tMysqlConnection page 482
551
tNetezzaCommit
tNetezzaCommit
Proprits du tNetezzaCommit
Ce composant est troitement li aux composants tNetezzaConnection et tNetezzaRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tNetezzaCommit 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 tNetezzaConnection 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 tNetezzaCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Netezza et notamment avec les composants tNetezzaConnection et tNetezzaRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tNetezzaConnection et tNetezzaRollback. Ils sont gnralement utiliss avec un composant tNetezzaConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tNetezzaCommit, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.
552
tNetezzaConnection
tNetezzaConnection
Proprits du tNetezzaConnection
Ce composant est troitement li aux composants tNetezzaCommit et tNetezzaRollback. Ils sont gnralemet utiliss avec un composant tNetezzaConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tNetezzaConnection 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 Additional JDBC Parameters 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. 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 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.
Ce composant est gnralement utilis avec des composants Netezza, notamment les composants tNetezzaCommit et tNetezzaRollback. n/a
553
tNetezzaConnection
Scnario associ
Pour un scnario associ au composant tNetezzaConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.
554
tNetezzaInput
tNetezzaInput
Proprits du tNetezzaInput
Fonction Objectif
Le composant tNetezzaInput lit une base de donnes et en extrait des champs laide de requtes. Le tNetezzaInput excute une requte de base de donnes dans laquelle lordre doit strictement correspondre lordre dfini dans le schma. Puis la liste des champs est transmise au composant via une connexion Main row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionne 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
555
tNetezzaInput
Cochez cette case lorsque vous utilisez un 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.
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 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 de base de donnes. 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
556
tNetezzaInput
Use cursor
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.
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 Netezza.
Scnarios associs
Consultez les scnarios du composant tNetezzaInput : le Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258. le Scnario 2 : Utiliser la variable StoreSQLQuery, page 260. Pour un scnario associ, consultez le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1122 du composant tContextLoad.
557
tNetezzaOutput
tNetezzaOutput
Proprits du tNetezzaOutput
Le composant tNetezzaOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tNetezzaOutput 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 un composant tNetezzaConnection. 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.
558
tNetezzaOutput
Port Database Username et Password Table Action on table
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. 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 correspondant 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
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.
559
tNetezzaOutput
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. 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 un ensemble de lignes dfinies au lieu dinsrer les lignes une par une. Cette option permet un important gain de performance. Number of rows per insert: : saisissez le nombre de lignes insrer en un bloc. Notez que si vous slectionnez un nombre important de lignes, cela peut augmenter la quantit de mmoire utilise et donc diminuer les performances. 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.
Advanced settings
Extend Insert
Commit every
Additional Columns
560
tNetezzaOutput
Reference column : Saisissez une colonne de rfrence que le composant tNetezzaOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier. Use field options Cochez cette case pour personnaliser une requte, surtout 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 Netezza. 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 tNetezzaOutput, 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.
561
tNetezzaRollback
tNetezzaRollback
Proprits du tNetezzaRollback
Ce composant est troitement li aux composants tNetezzaCommit et tNetezzaConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tNetezzaRollback annule la transaction dans une base de donnes connecte. Ce composant permet dviter le commit de transaction involontaire. Component list Slectionnez le composant tNetezzaConnection 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.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce component est gnralement utilis avec dautres composants Netezza, notamment les composants tNetezzaConnection et tNetezzaCommit components. n/a
Limitation
Scnario associ
Pour un scnario associ au composant tNetezzaRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524.
562
tNetezzaRow
tNetezzaRow
Proprits du tNetezzaRow
Fonction
tNetezzaRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tNetezzaRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. 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 tNetezzaConnection. 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.
Objectif
Basic settings
563
tNetezzaRow
Query
Die on error
Advanced settings
564
tNetezzaRow
Encoding Type
Commit every
Scnario associ
Pour un scnario associ au composant tNetezzaRow, consultez le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 528.
565
tOracleBulkExec
tOracleBulkExec
Proprits du tOracleBulkExec
Famille de composant Databases/Oracle
Le composant tOracleBulkExec insre, ajoute, remplace ou supprime les donnes dune base de donnes Oracle. Le tOracleBulkExec est un composant ddi, il permet un gain de performance lors du traitement des donnes de la base de donnes Oracle. 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 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. Connection type DB Version Host Port Database Schema Liste droulante contenant les 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 Nom de la base de donnes. Nom du schma.
566
tOracleBulkExec
Perl uniquement
Service Name
Nom du service ou SID de la base de donnes Oracle. Dans les projets Java, les informations de connexion doivent tre compltes. 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. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. 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 : Insre des lignes dans une table vide. Le Job sarrte en cas de doublons. Update : Met jour les entres existantes. Append : Ajoute des lignes aux donnes dj existantes. Replace : Ecrase des lignes de la table. Truncate : Supprimer les entres correspondant au flux dentre. Il est ncessaire de spcifier au minimum une cl de recherche sur laquelle baser les oprations dUpdate. 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.
Data file name
Action on data
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.
567
tOracleBulkExec
Advanced settings
Advanced separator (for numbers)
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. Cochez cette case si vous utilisez un fichier de contrle (.ctl) et spcifiez son chemin daccs dans le champ .ctl file name. Dfinissez le format de lenregistrement : Default : les paramtres du format sont dfinis par dfaut. Stream : dterminez le sparateur de fin denregistrement. Fixed : dterminez la longueur denregistrement. Variable : dterminez la taille du champ spcifiant la longueur de lenregistrement.
Use existing control file Record format
Specify .ctl files INTO Cochez cette case pour renseigner manuellement la TABLE clause clause INTO TABLE du fichier de contrle, manually directement dans le code. Fields terminated by Caractre, chane ou expression rgulire sparant les champs : None : aucun caractre de sparation. Whitespace : le caractre de sparation est un espace. EOF (used for loading LOBs from lobfile) : la sparation est constitue dun caractre de fin de fichier (End Of File). Other terminator : la sparation est constitue dun caractre autre que ceux prcdemment noncs. Cochez cette case si vous voulez utiliser des caractres pour entourer le texte : Fields enclosure (left part) : caractre dlimitant les champs sur la gauche. Field enclosure (right part) : caractre dlimitant les champs sur la droite. Cochez cette case pour utiliser le modle de date contenu dans le schma pour remplir le champ concernant la date.
Use fields enclosure
Use schemas Date Pattern to load Date field
Specify field condition Cochez cette case pour dfinir une condition de chargement des donnes. Preserve blanks Trailing null columns Load options Cochez cette case pour conserver les espaces vides. Cochez cette case pour charger des donnes avec des colonnes vides. Cliquez sur le bouton [+] afin dajouter des options de chargement des donnes : Parameter : choisissez lun des paramtres de chargement partir de la liste droulante. Value : dfinissez la valeur attribuer au paramtre. A partir de la liste droulante, dfinissez la langue utilise pour les donnes qui ne sont pas codes en Unicode.
NLS Language
568
tOracleBulkExec
Set Parameter NLS_TERRITORY
Cochez cette case pour modifier les conventions d'appellation utilises pour la numrotation des jours et des semaines. La valeur par dfaut est celle du systme d'exploitation. 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. Slectionnez la sortie utiliser pour rcuprer la sortie standard de la base Oracle : to console : vers la console. to global variable : vers la variable globale. Cochez cette case pour mettre le nom des colonnes et celui de la table en majuscules.
Encoding Type
Output
Convert columns and table names to uppercase
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Perl uniquement Perl uniquement Perl uniquement Fields terminated by Fields optionnally enclosed by Encoding Caractre, chane ou expression rgulire sparant les champs. Caractres entourant les donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes dune base de donnes.
Utilisation
Ce composant ddi offre performance et flexibilit lors de requtes sur les bases de donnes Oracle.
Scnario : Supprimer et insrer des donnes dans une base Oracle

Ce scnario dcrit comment supprimer le contenu dune base de donnes Oracle et dinsrer de nouvelles donnes partir du contenu dun fichier dentre. Le Job est constitu de trois composants qui crent le contenu, le transfert dans un fichier qui sera ensuite charg dans la base Oracle aprs que les donnes de la table aient t supprimes.
569
tOracleBulkExec
Cliquez et dposez les composants suivants : tOracleInput, tFileOutputDelimited, tOracleBulkExec. Connectez le composant tOracleInput au tFileOutputDelimited laide dun lien Row main. Et connectez le tOracleInput au tOracleBulkExec laide dun lien OnSubjobOk. Paramtrez les informations de connexion la base de donnes Oracle. Nous vous conseillons de stocker ces informations dans une mtadonne du Repository pour pouvoir les rutiliser par la suite dans tous vos Job.
Paramtrez le schma, sil nest pas conserv dans le Repository. Dans cet exemple, le schma est comme suit : ID_Contract, ID_Client, Contract_type, Contract_Value. Dans le champ Encoding Type, slectionnez loption Custom et dfinissez AL32UTF8 comme encodage. Dans le champ Basic settings du composant tFileOutputDelimited, paramtrez ses proprits, notamment les champs File Name, Row separator et Fields separator avec respectivement le chemin daccs et le nom du fichier, le sparateur de lignes et de champs. Dans le champ Encoding, saisissez le mme encodage que celui saisi dans les proprits du composant tOracleInput. Double-cliquez ensuite sur le composant tOracleBulkExec pour dfinir les proprits dalimentation de la base de donnes.
570
tOracleBulkExec
Dans le champ Property Type, slectionnez le mode Repository si vous avez stock les informations de connexion la base de donnes sous le noeud Metadata du Repository ou slectionnez le mode Built-In pour les dfinir manuellement. Dans ce scnario, on utilise le mode Built-In. Dfinissez si ncessaire les paramtres de connexion dans les champs Host, Port, Database, Schema, Username et Password. Dans le champ Table, renseignez le nom de la Table alimenter et dans le champ Action on data, slectionnez laction effectuer, ici : Insert Dans le champ Schema, slectionnez le mode Built in puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes passer au composant suivant. Cliquez sur la vue Advanced settings pour configurer les paramtres avancs du composant.
571
tOracleBulkExec
Cochez la case Use an existing control file si vous avez stock les informations relatives ltat de la base de donnes dans un fichier de contrle (.ctl). Sinon, renseignez si ncessaire les champs suivants manuellement : Record format, Specify .ctl files INTO TABLE clause manually, Field terminated by, Use field enclosure, Use schemas Date Pattern to load Date field, Specify field condition, Preserve blanks, Trailing null columns, Load options, NLS Language et Set Parameter NLS_TERRITORY en fonction de votre base de donnes. Dans le champ Encoding, paramtrez lencodage comme dans les tapes prcdentes. Et dans le champ Output, slectionnez loption to console, ainsi la sortie standard de la base sera affiche dans la console. Appuyez sur F6 pour excuter le Job. La sortie de log apparat dans la vue Run et la table est alimente par les donnes du fichier paramtr. Voir galement : Scnario : Insrer des donnes dans une base MySQL, page 521
572
tOracleClose
tOracleClose
Proprits du tOracleClose
Le composant tOracleClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Oracle. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tOracleConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tOracleConnection et tOracleRollback. Il est gnralement utilis avec un composant tOracleConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tOracleClose, consultez tMysqlConnection page 482
573
tOracleCommit
tOracleCommit
Proprits du tOracleCommit
Ce composant est troitement li aux composants tOracleCommit et tOracleRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tOracleCommit 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 tOracleConnection 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 tOracleCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Oracle et notamment tOracleConnection et tOracleRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tOracleConnection et tOracleRollback. Ils sont gnralement utiliss avec un composant tOracleConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tOracleCommit, consultez tMysqlConnection page 482
574
tOracleConnection
tOracleConnection
Proprits du tOracleConnection
Ce composant est troitement li aux composants tOracleCommit et tOracleRollback. Ils sont gnralement utiliss avec un composant tOracleConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tOracleConnection 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. Connection type DB Version Use tns file Liste droulante des pilotes disponibles. Slectionnez la version dOracle que vous utilisez. Cochez cette case pour utiliser les mtadonnes dun contexte contenu dans un fichier tns. Un mme fichier Tns peut contenir plusieurs contextes. TNS File : Renseignez manuellement le chemin daccs ou cliquez sur le bouton [...] pour parcourir vos dossiers jusquau fichier Tns utiliser. Select a DB Connection in Tns File : Cliquez sur le bouton [...] pour afficher tous les contextes du fichier Tns et slectionner celui utiliser. Host 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.
575
tOracleConnection
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.
Ce composant est gnralement utilis avec des composants Oracle, notamment les composants tOracleCommit et tOracleRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tOracleCommit et tOracleRollback. Ils sont gnralement utiliss avec un composant tOracleConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tOracleConnection, consultez tMysqlConnection page 482
576
tOracleInput
tOracleInput
Proprits du tOracleInput
Fonction Objectif
Le composant tOracleInput lit une base de donnes et en extrait des champs laide de requtes. Le tOracleInput excute une requte de base de donnes dans laquelle lordre doit strictement correspondre lordre dfini dans le schma. Puis la liste des champs est transmise au composant via une connexion Main row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionne 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
577
tOracleInput
Cochez cette case lorsque vous utilisez un 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.
Connection type DB Version Host Port Database Oracle schema Username et Password Schema et Edit Schema
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. Nom de la base de donnes. Nom du schma Oracle. 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.
Nom de la table de base de donnes. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.
578
tOracleInput
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. 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 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.
Use cursor
Trim all the String/Char columns Trim column Utilisation
Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Oracle.
Scnarios associs
Consultez les scnarios du composant tOracleInput : le Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258. le Scnario 2 : Utiliser la variable StoreSQLQuery, page 260. Pour un scnario associ, consultez le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1122 du composant tContextLoad.
579
tOracleOutput
tOracleOutput
Proprits du tOracleOutput
Le composant tOracleOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tOracleOutput 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.
580
tOracleOutput
Cochez cette case lorsque vous utilisez le composant tOracleConnection. Lorsque vous la dcochez, une case (coche par dfaut, suivie dun champ) apparat dans les Advanced settings, Batch Size, qui vous permet de saisir le nombre de lignes dans chaque lot de traitement de donnes. 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 Java uniquement DB Version
Liste droulante des pilotes disponibles. Slectionnez la version dOracle que vous utilisez.
Host Port Database Perl uniquement Oracle 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 Oracle
Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois.
581
tOracleOutput
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 correspondant 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
582
tOracleOutput
Java uniquement
Die on error
Advanced settings
Additional JDBC parameters Java uniquemen t
Perl uniquement
Override any existing NLS_LANG environment variable Encoding Type
Cochez cette case afin dcraser les variables prcdemment dfinies dans un environnement au langage NLS. 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.
Commit every
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. 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 tOracleOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier. Java uniquement Use field options Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes.
583
tOracleOutput
Java uniquement
Use Hint Options
Cochez cette case pour ajouter des indicateurs (ou Hints) permettant doptimiser le plan dexcution de la requte afin dobtenir les meilleurs performances possibles. Cochez cette case pour passer les noms de colonnes et de tables en majuscule. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. Nombre de lignes dans chaque lot de traitement de donnes. Si cette case napparat pas, vrifiez que la case Use an existing connection dans les Basic settings est dcoche.
Java uniquement Java uniquement Java uniquement
Convert columns and table to uppercase Enable debug mode
Use Batch Size
Java uniquement Utilisation
Support null in SQL WHERE statement
Cochez cette case pour prendre en compte les valeurs Null lors dune instruction WHERE.
Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Ce composant doit tre utilis en tant que composant de sortie. Il permet de faire des actions sur une table ou les donnes 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.
Scnarios associs
Pour un scnario associ au composant tOracleOutput, 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.
584
tOracleOutputBulk
tOracleOutputBulk
Proprits du tOracleOutputBulk
Les composants tOracleOutputBulk et tOracleBulkExec 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 tOracleOutputBulkExec, 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.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Oracle. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Oracle. 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.
Create directory if not Cette option permet de crer le dossier contenant le exists fichier de sortie sil nexiste pas dj. Append Schema et Edit Schema 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.
585
tOracleOutputBulk
Advanced settings
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. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) sparant les lignes. 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.
Field separator Row separator Encodind 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 tOracleBulkExec. Ensemble ils offrent un gain de performance important pour lalimentation dune base de donnes Oracle.
Scnarios associs
Pour des scnarios associs au composant tOracleOutputBulk, consultez les scnarios suivants : Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du tMysqlOutputBulk. Scnario : Insrer des donnes dans une base MySQL, page 521 du tMysqlOutputBulkExec. Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.
586
tOracleOutputBulkExec
Proprits du tOracleOutputBulkExec
Le tOracleOutputBulkExec effectue une action dInsert sur les donnes fournies. Ce composant est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Oracle. 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. Connection type DB Version Host Port Database Schema 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. Nom de la base de donnes. Nom du schma.
587
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 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. Nom du fichier traiter. Voir galement :Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cette case est coche par dfaut. Cette option permet de crer un rpertoire o stocker la table de sortie si elle nexiste pas. Cochez cette case afin dajouter de nouvelles lignes la fin de lenregistrement. 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. Truncate : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une cl de recherche sur laquelle baser les oprations dUpdate. 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 table
File Name
Create directory if not exists Append Action on data
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.
588
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. Advanced settings Advanced separator (for numbers) 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. Cochez cette case si vous utilisez un fichier de contrle (.ctl). Dfinissez le format de lenregistrement : Default : les paramtres du format sont dfinis par dfaut. Stream : dterminez le sparateur de fin denregistrement. Fixed : dterminez la longueur denregistrement. Variable : dterminez la taille du champ spcifiant la longueur de lenregistrement.
Use existing control file Record format
Specify .ctl files INTO Cochez cette case pour renseigner manuellement la TABLE clause clause INTO TABLE du fichier de contrle, manually directement dans le code. Fields terminated by Caractre, chane ou expression rgulire sparant les champs : None : aucun caractre de sparation. Whitespace : le caractre de sparation est un espace. EOF (used for loading LOBs from lobfile) : la sparation est constitue dun caractre de fin de fichier (End Of File). Other terminator : la sparation est constitue dun caractre autre que ceux prcdemment noncs. Cohez cette case si vous voulez utiliser des caractres pour entourer le texte : Fields enclosure (left part) : caractre dlimitant les champs sur la gauche. Field enclosure (right part) : caractre dlimitant les champs sur la droite. Cochez cette case pour utiliser le modle de date contenu dans le schma pour remplir le champ concernant la date.
Use fields enclosure
Use schemas Date Pattern to load Date field
Specify field condition Cochez cette case pour dfinir une condition de chargement des donnes. Preserve blanks Cochez cette case pour conserver les espaces vides.
589
Trailing null columns Load options
Cochez cette case pour charger des donnes avec des colonnes vides. Cliquez sur le bouton [+] afin dajouter des options de chargement des donnes : Parameter : choisissez lun des paramtres de chargement partir de la liste droulante. Value : dfinissez la valeur attribuer au paramtre. A partir de la liste droulante, dfinissez la langue utilise pour les donnes qui ne sont pas codes en Unicode. Cochez cette case pour modifier les conventions d'appellation utilises pour la numrotation des jours et des semaines. La valeur par dfaut est celle du systme d'exploitation. 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. Slectionnez dans la liste droulante lendroit o rediriger le flux de sortie : to console : ver la console de log. to global variable : vers une variable globale. Cochez cette case pour mettre le nom des colonnes et celui de la table en majuscules.
NLS Language
Set Parameter NLS_TERRITORY
Encoding Type
Output
Convert columns and table names to uppercase
Scnarios associs
Pour des scnarios associs au composant tOracleOutputBulkExec, consultez les scnarios suivants : Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du tMysqlOutputBulk. Scnario : Insrer des donnes dans une base MySQL, page 521 du tMysqlOutputBulkExec. Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.
590
tOracleRollback
tOracleRollback
Proprits du tOracleRollback
Ce composant est troitement li aux composants tOracleCommit et tOracleConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tOracleRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Close connection Slectionnez le composant tOracleConnection 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.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec dautres composants Oracle, notamment les composants tOracleConnection et tOracleCommit. n/a
Scnario associ
Ce composant est troitement li aux composants tOracleConnection et tOracleCommit. Ils sont gnralement utiliss ensemble lors dune transaction. Pour un scnario associ au composant tOracleRollback, consultez tMysqlRollback page 524.
591
tOracleRow
tOracleRow
Proprits du tOracleRow
Fonction
Le tOracleRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tOracleRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. 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. 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.
Objectif
Basic settings
592
tOracleRow
Database Schema Username et Password Schema et Edit Schema
Nom de la base de donnes. Nom du schma Oracle. 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. 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
Die on error
Advanced settings
593
tOracleRow
Encoding Type
Commit every
Scnario associ
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.
594
tOracleSCD
tOracleSCD
Le composant tOracleSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tOracleSCD page 35.
595
tOracleSCDELT
tOracleSCDELT
Le composant tOracleSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tOracleSCDELT, page 37.
596
tOracleSP
tOracleSP
Proprits du tOracleSP
Le composant tOracleSP appelle une procdure stocke de base de donnes. Ce composant permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les appeler plus facilement. Use an existing connection Cochez cette case et slectionnez le composant tOracleConnection 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. Connection type Le type de connexion peut tre : - Oracle SID - Oracle Service Name - Oracle OCI 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. DB Version Host Port 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.
Property type
597
tOracleSP
Database Schema Username et Password Schema et Edit Schema
Nom de la base de donnes. Nom du schma. 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.
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. Le type Custom Type est utilis quand une colonne du schma (Schema Column) que vous souhaitez utiliser est dfinie par lutilisateur. Deux types de Custom sont disponibles dans le tableau Parameters. Pour le premier type : - Cochez la case quand la colonne du schma correspondant est dfinie par lutilisateur. - Si toutes les colonnes du schma dans le tableau Parameters sont de type personnalis, vous pouvez cocher la case devant Custom Type.
Parameters
598
tOracleSP
Dans la seconde colonne Custom Type, vous pouvez prciser le type de personnalisation. Il peut tre - STRUCT : utilis pour un lment. - ARRAY : utilis pour plusieurs lments. Dans la colonne Custom name, spcifiez le type de personnalisation. Dans le tableau Parameters, si une colonne est de Type OUT, assurez-vous que son type dans le schma est bien Object. Advanced settings Additional JDBC 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. 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. A partir de la liste droulante, dfinissez la langue utilise pour les donnes qui ne sont pas codes en Unicode. Cochez cette case pour modifier les conventions d'appellation utilises pour la numrotation des jours et des semaines. La valeur par dfaut est celle du systme d'exploitation.
Encoding Type
NLS Language
NLS Territory
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. Quand le paramtre dfini dans ce composant est personnalis (Custom Type), les composants de la famille tJava doivent tre placs avant le tOracleSP, afin que les utilisateurs puissent dfinir des valeurs pour les paramtres personnaliss, ou bien aprs le tOracleSP, pour lire et crire les paramtres personnaliss de type OUT.
Scnario : Vrifier le format de numros laide dune procdure stocke

Le Job suivant permet de se connecter une base Oracle contenant des numros de scurit social et le nom de leur propritaire, en appelant une procdure stocke qui vrifie le format des numros en fonction du format standard ###-##-####. Puis le rsultat de la vrifiaction, 1 pour un format valide et 0 pour un format non valide, est affich en sortie dans la console de la vue Run.
599
tOracleSP
Cliquez et dposez les composants suivants : tOracleConnection, tOracleInput, tOracleSP et tLogRow. Reliez le composant tOracleConnection au tOracleInput laide dun lien Then Run puisquaucune donne nest traite ici. Et connectez les autres composants laide de liens Row Main puisque des lignes sont transmises comme paramtres au composant SP et la console. Dans longlet Basic settings du composant tOracleConnection, paramtrez les informations de connexion la base de donnes correspondante. Vous pourrez donc rutiliser cette information dans tout autre composant li aux bases de donnes. Puis double-cliquez sur le composant tOracleInput et paramtrez ses proprits.
Cochez la case Use an existing connection et slectionnez le composant tOracleConnection dans la liste pour rutiliser les informations de connexion dj paramtres. Slectionnez loption Repository dans le champ Property type puisque le schma Oracle est dfini dans une mtadonne du dossier Db Connections du Repository. Si vous navez pas enregistr de mtadonne contenant les informations de connexion la base de donnes Oracle dans le Repository, renseignez le nom du schma manuellement. Puis slectionnez loption Repository dans le champ Schema, et rcuprez le schma correspondant la table de la base de donnes Oracle.
600
tOracleSP
Dans cet exemple, la table contenant le numro de scurit social contient un schma quatre colonnes dont : ID, NAME, CITY et SSNUMBER. Dans le champ Query, saisissez la requte Select suivante ou slectionnez-la dans la liste si vous laviez stocke dans le Repository. select ID, NAME, CITY, SSNUMBER from SSN Puis slectionnez le tOracleSP et paramtrez ses proprits dans longlet Basic settings.
Comme pour le composant tOracleInput, slectionnez loption Repository dans le champ Property type et cochez la case Use an existing connection, puis slectionnez lentre adquate dans la liste Component List. Le schma utilis pour le composant tOracleSP diffre lgrement du schma dentre. En effet, une colonne supplmentaire (SSN_Valid) est ajoute au schma dentre. Cette colonne contiendra le statut de validit (1 ou 0) gnr par la procdure.
601
tOracleSP
Puis slectionnez le type dencodage adquat dans la liste Encoding type. Dans le champ SP Name, saisissez le nom exact de la procdure stocke (ou de la fonction) telle quelle est appele dans la base de donnes. Dans cet exemple, le nom de la procdure stocke est is_ssn. La fonction de base utilise pour cet exemple est : CREATE OR REPLACE FUNCTION is_ssn(string_in VARCHAR2) RETURN PLS_INTEGER IS -- validating ###-##-#### format BEGIN IF TRANSLATE(string_in, '0123456789A', 'AAAAAAAAAAB') = 'AAA-AA-AAAA' THEN RETURN 1; END IF; RETURN 0; END is_ssn; / Comme un valeur retourne est attendue dans cet exemple, la procdure agit comme une fonction, ainsi cochez la case Is function. La seule valeur retourne attendue est base sur la colonne ssn_valid. Ainsi, slectionnez lentre correspondante dans la liste. Dans la zone Parameters, dfinissez les paramtres dentre et de sortie utiliss dans la procdure. Dans cet exemple, seule la colonne SSNumber du schma est utilise dans la procdure. Cliquez sur le signe [+] pour ajouter un nouvelle ligne la table et slectionnez la colonne adquate (SSNumber) et son type (IN). Puis slectionnez le composant tLogRow et cliquez sur Sync Column pour rcuprer le schma du composant prcdent (tOracleSP).
Cochez la case Print values in cells of a table pour faciliter la lecture de la sortie. Puis enregistrez le Job et appuyez sur F6 pour lexcuter.
602
tOracleSP
Dans la console, vous pouvez lire les rsultats en sortie. Toutes les colonnes du schma dentre sont affiches mme si elles ne sont pas utilises comme paramtres dans la procdure stocke. La colonne finale affiche la valeur retourne attendue, i.e. que le numro de scurit social vrifi soit valide ou non. Consultez galement le composant tParseRecordSet, page 629 si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.
603
tOracleTableList
tOracleTableList
Proprits du tOracleTableList
Le composant tOracleTableList effectue une opration ditration sur toutes les tables dune base de donnes, grce une connexion Oracle dfinie. Le composant tOracleTableList permet de lister les noms des tables Oracle grce aux commandes SELECT et WHERE. Component list Slectionnez le composant de connexion tOracleConnection 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 Oracle, notamment avec le tOracleConnection. n/a
Scnario associ
604
tParAccelBulkExec
tParAccelBulkExec
Proprits du tParAccelBulkExec
Les composants tParAccelOutputBulk et tParAccelBulkExec 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 tParAccelOutputBulkExec, 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/ParAccel
Fonction Objectif
Le composant tParAccelBulkExec effectue une action dInsert sur les donnes fournies. Le tParAccelBulkExec 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 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 Adresse IP du serveur de base de donnes.
Basic settings
605
tParAccelBulkExec
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. 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 le mode de Copy que vous souhaitez utiliser. Basic : Mode classique, sans optimisation. Parallel : Mode permettant dutiliser plusieurs API internes ParAccel, afin damliorer les performances de chargement. Nom du fichier traiter et chemin daccs. Slectionnez dans la liste le type de fichier. Slectionnez dans la liste la disposition du fichier. Caractre, chane ou expression rgulire sparant les champs (si vous chargez un fichier dlimit). LID sera assign directement par la base de donnes ou est dj prsent dans le fichier charger. Cochez cette case afin de retirer les guillemets de votre fichier charger. Saisissez le nombre maximal derreurs avant que votre Job ne sarrte. Saisissez le format de date qui sera utilis. Saisissez le format de date et heure qui sera utilis. Saisissez loption spcifique ParAccel et personnalise que vous souhaitez utiliser. Saisissez le chemin daccs votre fichier de log, ou parcourez votre rpertoire.
Action on table
Advanced settings
Copy mode
Filename File Type Field Layout Field separator Explicit IDs Remove Quotes Max. Errors Date Format Time/Timestamp Format Additional COPY Options Log file
606
tParAccelBulkExec
Logging level
Slectionnez le niveau de verbose retourner.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec un composant tParAccelOutputBulk. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes ParAccel. n/a
Limitation
Scnarios associs
Pour plus dinformations relatives au fonctionnement de tParAccelBulkExec, 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.
607
tParAccelClose
tParAccelClose
Proprits du tParAccelClose
Le composant tParAccelClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes ParAccel. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tParAccelConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tParAccelConnection et tParAccelRollback. Il est gnralement utilis avec un composant tParAccelConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tParAccelClose, consultez tMysqlConnection page 482
608
tParAccelCommit
tParAccelCommit
Proprits du tParAccelCommit
Ce composant est troitement li aux composants tParAccelCommit et tParAccelRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tParAccelCommit 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 tParAccelConnection 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 tParAccelCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants ParAccel et notamment tParAccelConnection et tParAccelRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tParAccelConnection et tParAccelRollback. Ils sont gnralement utiliss avec un composant tParAccelConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tParAccelCommit, consultez tMysqlConnection page 482
609
tParAccelConnection
tParAccelConnection
Proprits du tParAccelConnection
Ce composant est troitement li aux composants tParAccelCommit et tParAccellRollback. Ils sont gnralement utiliss avec un composant tParAccelConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tParAccelConnection 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 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.
Advanced settings
Auto commit
610
tParAccelConnection
Ce composant est gnralement utilis avec des composants ParAccel, notamment les composants tParAccelCommit et tParAccelRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tParAccelCommit et tParAccelRollback. Ils sont gnralement utiliss avec un composant tParAccelConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tParAccelConnection, consultez tMysqlConnection page 482
611
tParAccelInput
tParAccelInput
Proprits du tParAccelInput
Famille de composant Databases/ ParAccel
Fonction Objectif
Le composant tParAccelInput lit une base de donnes et en extrait des champs laide de requtes. Le tParAccelInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). 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
612
tParAccelInput
Cochez cette case lorsque vous utilisez le composant 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 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 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. 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.
613
tParAccelInput
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 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.
Use cursor
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 ParAccel.
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tParAccelInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260
614
tParAccelOutput
tParAccelOutput
Proprits du tParAccelOutput
Le composant tParAccelOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tParAccelOutput 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 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.
615
tParAccelOutput
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. 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
616
tParAccelOutput
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 tParAccelOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Advanced settings
Encoding Type
Commit every
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. Creative Commons License Composants Talend Open Studio 617
tParAccelOutput
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 ParAccel. 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 tParAccelOutput 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.
618
tParAccelOutputBulk
tParAccelOutputBulk
Proprits du tParAccelOutputBulk
Les composants tParAccelOutputBulk et tParAccelBulkExec 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 tParAccelOutputBulkExec, 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.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards ParAccel. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes ParAccel. 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.
Advanced settings
Row separator Field separator
Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs.
619
tParAccelOutputBulk
Include header Encoding Type
Cochez cette case pour inclure len-tte des colonnes dans le fichier. 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 tParAccelBulkExec. Ensemble ils offrent un gain de performance important pour lalimentation dune base de donnes ParAccel.
Scnarios associs
Pour un scnario associ au composant tParAccelOutputBulk, consultez : 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. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.
620
tParAccelOutputBulkExec
Proprits du tParAccelOutputBulkExec
Fonction Objectif
Le tParAccelOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tParAccelOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes ParAccel. 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 exact 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 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. 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
Action on table
621
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. File Name Nom du fichier traiter. Voir galement :Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Slectionnez le mode de Copy que vous souhaitez utiliser. Basic : Mode classique, sans optimisation. Parallel : Mode permettant dutiliser plusieurs API internes ParAccel, afin damliorer les performances de chargement. Nom du fichier traiter et chemin daccs. Slectionnez dans la liste le type de fichier. Slectionnez dans la liste la disposition du fichier. Caractre, chane ou expression rgulire sparant les champs (si vous chargez un fichier dlimit). LID sera assign directement par la base de donnes ou est dj prsent dans le fichier charger. Cochez cette case afin de retirer les guillemets de votre fichier charger. Saisissez le nombre maximal derreurs avant que votre Job ne sarrte. Saisissez le format de date qui sera utilis. Saisissez le format de date et heure qui sera utilis. Saisissez loption spcifique ParAccel et personnalise que vous souhaitez utiliser. Saisissez le chemin daccs votre fichier de log, ou parcourez votre rpertoire. Slectionnez le niveau de verbose retourner.
Advanced settings
Copy mode
Filename File Type Field Layout Field separator Explicit IDs Remove Quotes Max. Errors Date Format Time/Timestamp Format Additional COPY Options Log file Logging level
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est principalement utilis lorsquaucune transformation particulire nest requise sur les donnes charger dans la base de donnes.
Scnarios associs
Pour un scnario associ au composant tParAccelOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 515 du tMysqlOutputBulk.
622
le Scnario : Insrer des donnes dans une base MySQL, page 521 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.
623
tParAccelRollback
tParAccelRollback
Proprits du tParAccelRollback
Ce composant est troitement li aux composants tParAccelCommit et tParAccelConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tParAccelRollback annule la transaction dans une base de donnes connecte. Ce composant permet dviter le commit de transaction involontaire. Component list Slectionnez le composant tParAccelConnection 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.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce component est gnralement utilis avec dautres composants ParAccel, notamment les composants tParAccelConnection et tParAccelCommit components. n/a
Limitation
Scnario associ
Pour un scnario associ au composant tParAccelRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524.
624
tParAccelRow
tParAccelRow
Proprits du tParAccelRow
Fonction
Le tParAccelRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tParAccelRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. 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 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 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
625
tParAccelRow
Nom de la table de base 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.
Query
Die on error
Advanced settings
626
tParAccelRow
Encoding Type
Commit every
Scnarios associs
627
tParAccelSCD
tParAccelSCD
Le composant tParAccelSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tParAccelSCD, page 40.
628
tParseRecordSet
tParseRecordSet
Proprits du tParseRecordSet
Ce composant se trouve la racine de la famille Databases de la Palette de Talend Open Studio. Le composant tParseRecordSet couvre des besoins indirectement lis lutilisation des bases de donnes de tout type.
Fonction
Le composant tParseRecordSet analyse un ensemble denregistrements dune table de donnes ou dune requte SQL et retourne ventuellement des enregistrements seuls. Il permet danalyser un ensemble denregistrements dune table au lieu de les analyser individuellement. Prev. Comp. Column list Schema et Edit Schema Slectionnez la colonne contenant lensemble denregistrements analyser. 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 uniquement. 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. Attribute table Paramtrez la valeur positionnelle de chaque colonne de chaque enregistrement dun ensemble denregistrements.
Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls les paramtres dentre sont autoriss. Ce composant est principalement utilis avec la fonctionnalit Recordset dun composant SP.
Scnario associ
Pour un exemple dutilisation du tParseRecordSet, consultez le Scnario 2 : Utiliser linstance PreparedStatement pour faire une requte sur des donnes, page 530.
629
tPostgresPlusBulkExec
Proprits du tPostgresPlusBulkExec
Famille de composant Databases/PostgresPl us Le composant PostgresPlusBulkExec excute des oprations dInsert sur les donnes fournies. Le tPostgresPlusBulkExec 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 tPostgresqlConnection 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 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.
630
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. Clear a table: supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. 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. 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
Advanced settings
Action
Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Les informations demandes seront diffrentes en fonction de laction choisie. Caractre, chane ou expression rgulire sparant les champs.
Field terminated by
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 Postgresplus.
Scnario associ
Pour un scnario associ au composant tPostgresPlusBulkExec, consultez :
631
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.
632
tPostgresPlusClose
tPostgresPlusClose
Proprits du tPostgresPlusClose
Famille de composant Databases/PostgresPl us Le composant tPostgresPlusClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes PostgresPlus. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tPostgresPlusConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tPostgresPlusConnection et tPostgresPlusRollback. Il est gnralement utilis avec un composant tPostgresPlusConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tPostgresPlusClose, consultez tMysqlConnection page 482
633
tPostgresPlusCommit
tPostgresPlusCommit
Proprits du tPostgresPlusCommit
Ce composant est troitement li aux composants tpostgresPlusConnection et tPostgresPlusRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/PostgresPl us Le composant tPostgresPlusCommit 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 tPostgresPlusConnection 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 tPostgresPlusCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants PostgresPlus et notamment avec les composants tPostgresPlusConnection et tPostgresPlusRollback. n/a
Fonction Objectif
Basic settings
Close connection
Limitation
Scnario associ
Ce composant est troitement li aux composants tPostgresPlusConnection et tPostgresPlusRollback. Ils sont gnralement utiliss avec un composant tPostgresPlusConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tPostgresPlusCommit, consultez tMysqlConnection page 482.
634
tPostgresPlusConnection
Proprits du tPostgresPlusConnection
Ce composant est troitement li aux composants tPostgresPlusCommit et tPostgresPlusRollback. Ils sont gnralement utiliss avec un composant tPostgresPlusConnection car il permet douvrir une connexion pour la transaction en cours.
Famille de composant Databases/PostgresPl us Le composant tPostgresPlusConnection 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. 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.
Advanced settings
Auto commit
635
Utilisation
Ce composant est gnralement utilis avec des composants PostgresPlus et notamment avec les composants tPostgresPlusCommit et tPostgresPlusRollback. n/a
Limitation
Scnario associ
Ce composant est troitement li aux composants tPostgresPlusCommit et tPostgresPlusRollback. Ils sont gnralement utiliss avec un composant tPostgresPlusConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tPostgresPlusConnection, consultez tMysqlConnection page 482
636
tPostgresPlusInput
tPostgresPlusInput
Proprits du tPostgresPlusInput
Famille de composant Databases/ PostgresPlus Le composant tPostgresPlusInput lit une base de donnes et en extrait des champs laide de requtes. Le tPostgresPlusInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). 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.
Fonction Objectif
Basic settings
637
tPostgresPlusInput
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.
638
tPostgresPlusInput
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 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.
Use cursor
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 PostgresPlus.
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tPostgresPlusInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260
639
tPostgresPlusOutput
tPostgresPlusOutput
Proprits du tPostgresPlusOutput
Famille de composant Databases/PostgresPl us Le tPostgresPlusOutput crit, met jour, effectue les changements ou supprime les entres dans une base de donnes. Le tPostgresPlusOutput excute laction dfinie sur la table et/ou sur les donnes contenues dans la table, partir du flux entrant du composant prcdent dans le Job. 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.
Fonction Objectif
Basic settings
640
tPostgresPlusOutput
Cochez cette case si vous utilisez 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 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 base de donnes. Nom de la table crire. Notez quune seule table peut tre crite 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. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback.
Action on table
641
tPostgresPlusOutput
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)
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.
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 de base de donnes.
Advanced settings
Encoding Type
642
tPostgresPlusOutput
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
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 PostgresPlus. 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 des scnarios associs, consultez : tDBOutput Scnario : Afficher la base de donnes en sortie, page 264 tMySQLOutput Scnario 1 : Ajouter une colonne et modifier les donnes, page 499.
643
tPostgresPlusOutputBulk
Proprits du tPostgresPlusOutputBulk
Les composants tPostgresPlusOutputBulk et tPostgresPlusBulkExec 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 tPostgresPlusOutputBulkExec, 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/PostgresPl us Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Postgresql. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Postgresql. 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. Advanced settings Row separator Field separator Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs.
644
Include header Encoding Type
Cochez cette case pour inclure len-tte des colonnes dans le fichier. 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 tPostgresPlusBulkExec. Ensemble ils offrent un gain de performance important pour lalimentation dune base de donnes PostgresPlus.
Scnarios associs
Pour un scnario associ au composant tPostgresPlusOutputBulk, consultez : 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. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.
645
tPostgresPlusOutputBulkExec
Proprits du tPostgresplusOutputBulkExec
Famille de composant Databases/Postgrespl us Le tPostgresPlusOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tPostgresPlusOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes PostgresPlus. 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 exact 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 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.
Fonction Objectif
Basic settings
Action on table
File Name
646
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. Advanced settings Action Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Les informations demandes seront diffrentes en fonction de laction choisie. Slectionnez le type de fichiers traiter. Chane de caractres affiche pour signifier que la valeur est nulle. Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs : None : aucun caractre de sparation. Whitespace : le caractre de sparation est un espace. EOF (used for loading LOBs from lobfile) : la sparation est constitue dun caractre de fin de fichier (End Of File). Other terminator : la sparation est constitue dun caractre autre que ceux prcdemment noncs. Caractre dchappement de la ligne.
File type Null string Row separator Fields terminated by
Escape character
Scnarios associs
Pour un scnario associ au composant tPostgresPlusOutputBulkExec, consultez : 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. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.
647
tPostgresPlusRollback
tPostgresPlusRollback
Proprits du tPostgresPlusRollback
Ce composant est troitement li aux composants tPostgresPlusCommit et tPostgresPlusConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Famille de composant Databases/PostgresPl us Le tPostgresPlusRollback annule la transaction dans une base de donnes connecte. Ce composant permet dviter le commit de transaction involontaire. Component list Slectionnez le composant tPostgresPlusConnection 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.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce component est gnralement utilis avec dautres composants PostgresPlus, notamment les composants tPostgresPlusConnection et tPostgresPlusCommit components. n/a
Limitation
Scnario associ
Pour un scnario associ au composant tPostgresPlusRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524.
648
tPostgresPlusRow
tPostgresPlusRow
Proprits du tPostgresPlusRow
Famille de composant Databases/PostgresPl us Le tPostgresPlusRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tPostgresPlusRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. 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 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
Fonction
Objectif
Basic settings
649
tPostgresPlusRow
Nom de la table de base 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.
Query
Die on error
Advanced settings
650
tPostgresPlusRow
Encoding Type
Commit every
Scnarios associs
651
tPostgresPlusSCD
tPostgresPlusSCD
Le composant tPostgresPlusSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tPostgresPlusSCD, page 42.
652
tPostgresPlusSCDELT
tPostgresPlusSCDELT
Le composant tPostgresPlusSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tPostgresPlusSCDELT, page 44.
653
tPostgresqlBulkExec
tPostgresqlBulkExec
Proprits du tPostgresqlBulkExec
Les composants tPostgresqlOutputBulk et tPostgresqlBulkExec 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 tPostgresqlOutputBulkExec, 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/Postgresql
Le composant tPostgresqlBulkExec permet dinsrer les donnes dune base de donnes Postgresql. Le tPostgresqlBulkExec est un composant ddi, il permet un gain de performance lors du traitement des donnes de la base de donnes Postgresql. 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 Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes.
654
tPostgresqlBulkExec
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. 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. 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
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 Use standard_conforming _string ON 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. Activez la variable
655
tPostgresqlBulkExec
Force not null for columns
Dfinissez la nullabilit des colonnes Force not null : Cochez la case correspondant la colonne (Column) que vous souhaitez dfinir comme ntant pas nulle.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant doit tre utilis en association avec le composant tPostgresqlOutputBulk. Ensemble, ils permettent dobtenir des gains de performances dans une base de donnes Postgresql. n/a
Limitation
Scnarios associs
Pour dautres exemples dutilisation du composant tPostgresqlBulkExec, 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, le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.
656
tPostgresqlClose
tPostgresqlClose
Proprits du tPostgresqlClose
Le composant tPostgresqlClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Postgresql. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tPostgresqlConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tPostgresqlConnection et tPostgresqlRollback. Il est gnralement utilis avec un composant tPostgresqlConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tPostgresqlClose, consultez tMysqlConnection page 482
657
tPostgresqlCommit
tPostgresqlCommit
Proprits du tPostgresqlCommit
Ce composant est troitement li aux composants tPostgresqlConnection et tPostgresqlRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tPostgresqlCommit 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 tPostgresqlConnection dans la liste sil y a plus dune connexion dans votre Job. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tPostgresqlCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Postgresql, notamment les composants tPostgresqlConnection et tPostgresqlRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tPostgresqlConnection et tPostgresqlRollback. Ils sont gnralement utiliss avec un composant tPostgresqlConnection car celui-ci permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tPostgresqlCommit, consultez tMysqlConnection page 482.
658
tPostgresqlConnection
Proprits du tPostgresqlConnection
Ce composant est troitement li aux composants tPostgresqlCommit et tPostgresqlRollback. Ils sont gnralement utiliss avec un composant tPostgresqlConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tPostgresqlConnection 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 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.
Advanced settings
Auto commit
659
Ce composant est gnralement utilis avec des composants Oracle, notamment les composants tPostgresqlCommit et tPostgresqlRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tPostgresqlCommit et tPostgresqlRollback. Ils sont gnralement utiliss avec un composant tPostgresqlConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tPostgresqlConnection, consultez tMysqlConnection page 482
660
tPostgresqlInput
tPostgresqlInput
Proprits du tPostgresqlInput
Famille de composant Databases/ Postgresql
Fonction Objectif
Le composant tPostgresqlInput lit une base de donnes et en extrait des champs laide de requtes. Le tPostgresqlInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). 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
661
tPostgresqlInput
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.
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
662
tPostgresqlInput
Use cursor
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.
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 Postgresql.
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tPostgresqlInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 Scnario 2 : Utiliser la variable StoreSQLQuery, page 260
663
tPostgresqlOutput
tPostgresqlOutput
Proprits du tPostgresqlOutput
Fonction Objectif
Le composant tPostgresqlOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tPostgresqlOutput 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 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.
Basic settings
664
tPostgresqlOutput
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. 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
665
tPostgresqlOutput
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 tPostgresqlOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Advanced settings
Encoding Type
Commit every
Additional Columns
666
tPostgresqlOutput
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 Postgresql. 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 tPostgresqlOutput 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.
667
tPostgresqlOutputBulk
Proprits du tPostgresqlOutputBulk
Les composants tPostgresqlOutputBulk et tPostgresqlBulkExec 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 tPostgresqlOutputBulkExec, 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.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Postgresql. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Postgresql. 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.
Advanced settings
668
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 tPostgresqlBulkExec. Ensemble ils offrent un gain de performance important pour lalimentation dune base de donnes Postgresql.
Scnarios associs
Pour un scnario associ au composant tPostgresqlOutputBulk, consultez : 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. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.
669
tPostgresqlOutputBulkExec
Proprits du tPostgresqlOutputBulkExec
Fonction Objectif
Le tPostgresqlOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tPostgresqlOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Postgresql. 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 exact 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 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. 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. 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
670
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. 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 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. Slectionnez le type de fichiers traiter. Chane de caractres affiche pour signifier que la valeur est nulle. Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Caractre dchappement de la ligne. Caractres utiliss pour entourer le texte. Activez le paramtre standard_conforming_string pour traiter les backslashs comme une chane ordinaire et non pas comme un caractre dchappement. Dfinissez la nullabilit des colonnes Force not null : Cochez la case correspondant la colonne (Column) que vous souhaitez dfinir comme ntant pas nulle.
File type Null string Row separator Fields terminated by Escaped char Text enclosure Use standard_conforming _string ON Force not null for columns
Scnarios associs
Pour un scnario associ au cmposant tPostgresqlOutputBulkExec, consultez :
671
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. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.
672
tPostgresqlRow
tPostgresqlRow
Proprits du tPostgresqlRow
Fonction
Le tPostgresqlRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tPostgresqlRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. 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 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
673
tPostgresqlRow
Query
Die on error
Advanced settings
674
tPostgresqlRow
Encoding Type
Commit every
Scnarios associs
675
tPostgresqlRollback
tPostgresqlRollback
Proprits du tPostgresqlRollback
Ce composant est troitement li aux composants tPostgresqlCommit et tPostgresqlConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tPostgresqlRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant tPostgresqlConnection 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.
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec dautres composants Oracle, notamment les composants tPostgresqlConnection et tPostgresqlCommit. n/a
Scnario associ
Ce composant est troitement li aux composants tPostgresqlConnection et tPostgresqlCommit. Ils sont gnralement utiliss avec un composant tPostgresqlConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tPostgresqlRollback, consultez tMysqlRollback page 524
676
tPostgresqlSCD
tPostgresqlSCD
Le composant tPostgresqlSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tPostgresqlSCD, page 47.
677
tPostgresqlSCDELT
tPostgresqlSCDELT
Le composant tPostgresqlSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tPostgresqlSCDELT, page 49.
678
tSASInput
tSASInput
Assurez-vous dinstaller au pralable les modules sas.core.jar, sas.intrnet.javatools.jar et sas.svc.connection.jar sous le chemin lib > java dans votre build Talend Open Studio pour pouvoir utiliser toutes les fonctionnalits des composants SAS. Vous pouvez vrifier que ces modules ont bien t installs partir de la vue Modules de votre studio.
Proprits du tSASInput
Famille de composant Databases/SAS
Fonction Objectif
Le composant tSASInput lit une base de donnes et en extrait des champs laide de requtes. Le tSASInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). 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 Librefs Nom ou adresse IP du serveur SAS. Port dcoute ouvrir. Renseignez le nom du rpertoire physique dans lequel est contenue la table lire, suivi de son chemin daccs. On aura par exemple : TpSas C:/SAS/TpSas 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.
Basic settings
679
tSASInput
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 Renseignez le nom de la table lire, prfix par le nom du rpertoire physique dans lequel elle est contenue. On aura par exemple : TpSas.Customers. La requte peut tre construite manuellement (Built-in) pour un Job particulier ou stocke dans le Repository sil sagit dune requte frquemment utilise, pour en faciliter lutilisation. Saisissez votre requte, si elle nest pas stocke dans le Repository, en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma.
Query type
Query
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes utilisant une connexion SAS.
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.
680
tSASOutput
tSASOutput
Assurez-vous dinstaller au pralable les modules sas.core.jar, sas.intrnet.javatools.jar et sas.svc.connection.jar sous le chemin lib > java dans votre build Talend Open Studio pour pouvoir utiliser toutes les fonctionnalits des composants SAS. Vous pouvez vrifier que ces modules ont bien t installs partir de la vue Modules de votre studio.
Proprits du tSASOutput
Famille de composant Databases/SAS
Le composant tSASOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tSASOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Use an existing connection Cochez cette case et slectionnez le composant tSASConnection 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. SAS 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.
Class Name Username et Password
681
tSASOutput
Table Action on data
Nom de la table lire. 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 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.
682
tSASOutput
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 tSASOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Commit every
Additional Columns
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 utilisant une connexion SAS. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes SAS. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple 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 tSASOutput, consultez : le Scnario : Afficher la base de donnes en sortie, page 264 du composant tDBOutput.
683
tSASOutput
le Scnario 1 : Ajouter une colonne et modifier les donnes, page 499 du composant tMySQLOutput.
684
tSQLiteClose
tSQLiteClose
Proprits du tSQLiteClose
Famille de composant Databases/SQLite
Le composant tSQLiteClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes SQLite. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tSQLiteConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tSQLiteConnection et tSQLiteRollback. Il est gnralement utilis avec un composant tSQLiteConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tSQLiteClose, consultez tMysqlConnection page 482
685
tSQLiteCommit
tSQLiteCommit
Proprits du tSQLiteCommit
Ce composant est troitement li aux composants tSQLiteConnection et tSQLiteRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tSQLiteCommit 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 Close connection Slectionnez le composant tSQLiteConnection dans la liste sil y a plus dune connexion dans votre Job. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tSQLiteCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants SQLite, notamment les composants tSQLiteConnection et tSQLiteRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tSQLiteConnection et tSQLiteRollback. Ils sont gnralement utiliss avec un composant tSQLiteConnection car celui-ci permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tSQLiteCommit, consultez tMysqlConnection page 482.
686
tSQLiteConnection
tSQLiteConnection
Proprits du tSQLiteConnection
Ce composant est troitement li aux composants tSQLiteCommit et tSQLiteRollback. Ils sont gnralemet utiliss avec un composant tSQLiteConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tSQLiteConnection 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. Database Table Schema Use or register a shared DB Connection Nom de la base de donnes. Nom du schma. 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.
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. Utilisation Limitation Ce composant est gnralement utilis avec des composants SQLite, notamment les composants tSQLiteCommit et tSQLiteRollback. n/a
687
tSQLiteConnection
Scnarios associs
Ce composant est troitement li aux composants tSQLiteCommit et tSQLiteRollback. Ils sont gnralement utiliss avec un composant tSQLiteConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tSQLiteConnection, consultez tMysqlConnection page 482
688
tSQLiteInput
tSQLiteInput
Proprits du tSQLiteInput
Fonction
Le composant tSQLiteInput lit une base de donnes et en extrait des champs laide de requtes. Un petit moteur de base de donnes SQLite lui est intgr, il na donc pas besoin dtre connect un serveur de base de donnes. Le tSQLiteInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). 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 tSQLiteConnection 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.
Objectif
Basic settings
689
tSQLiteInput
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 Schema et Edit Schema Chemin daccs au fichier de la base de donnes SQLite. 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. Query type La requte peut tre construite manuellement (Built-in) pour un Job particulier ou stocke dans le Repository sil sagit dune requte frquemment utilise, pour en faciliter lutilisation. 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. Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes. Cochez cette case pour collecter les donnes de log au niveau du composant.
Query
Advanced settings
Encoding Type
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est tout fait autonome du fait de son moteur de base de donnes SQLite intgr. Il sagit dun composant de dbut pouvant initier un traitement de flux de donnes.
690
tSQLiteInput
Scnario : Filtrer des donnes SQlite

Le scnario suivant dcrit un Job assez simple qui permet dappliquer une requte donne utilisant un filtre pour extraire des lignes partir dune base de donnes SQLite source et alimenter une table SQLite en sortie.
Cliquez-dposez partir de la Palette les composants tSQLiteInput et tSQLiteOutput. Reliez le composant dentre et de sortie laide dun lien de type row Main. Dans longlet Basic settings du composant tSQLiteInput, entrez le chemin daccs ou parcourez vos dossiers jusquau fichier dentre la base de donne SQLite.
Le fichier contient des centaines de lignes et comprend une colonne ip servant de base la requte. Dans longlet Basic settings du composant tSQLiteInput, modifiez le schma afin quil corresponde la structure de la table.
691
tSQLiteInput
Dans le champ Query, renseignez la requte choisie par rapport la colonne ip. Slectionnez les paramtres dencodage correspondant. Pour le composant tSQLiteOutput, dans le champ Database de longlet Basic settings, slectionnez le chemin daccs la base de donne de sortie.
Dans le champ Table, renseignez le nom de la table alimenter avec les donnes slectionnes. A partir des listes droulantes Action on table et Action on Data, slectionnez les actions effectuer sur la table et sur les donnes. Dans le cas prsent, les actions sont, respectivement, Drop and create et Insert. Synchronisez le schma avec le schma dentre. Slectionnez lencodage puis dfinissez la limite de commit. Enregistrez le Job puis excutez-le en appuyant sur F6.
Les donnes slectionnes sont renvoyes vers le fichier SQLite dfini.
692
tSQLiteOutput
tSQLiteOutput
Proprits du tSQLiteOutput
Fonction
Le composant tSQLiteOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Un petit moteur de base de donnes SQLite lui est intgr, il na donc pas besoin dtre connect un serveur de base de donnes. Le tSQLiteOutput 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. Use an existing connection Cochez cette case lorsque vous utilisez le composant tSQLiteConnection. 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.
693
tSQLiteOutput
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 Table Action on table Chemin daccs au fichier 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. 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
694
tSQLiteOutput
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.
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 tSQLiteOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Advanced settings
Encoding Type
Commit every
Additional Columns
695
tSQLiteOutput
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant doit absolument tre reli un composant dentre (Input). Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes SQLite. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.
Scnario associ
Pour un scnario associ au composant tSQLiteOutput, consultez tSQLiteInput page 689.
696
tSQLiteRollback
tSQLiteRollback
Proprits du tSQLiteRollback
Ce composant est troitement li aux composants tSQLiteCommit et tSQLiteConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Le tSQLiteRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tSQLiteConnection 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
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 SQLite, notamment avec le tSQLiteConnection et le tSQLiteCommit. n/a
Scnario associ
Pour un scnario associ au tSQLiteRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524 du composant tMySQLRollback.
697
tSQLiteRow
tSQLiteRow
Proprits du tSQLiteRow
Fonction Objectif
Le tSQLiteRow excute une requte dfinie dans une base de donnes spcifie et utilise les paramtres de la colonne. Une requte prdfinie utilise le flux dentre pour remplacer les paramtres substituables par les valeurs dfinies pour chaque paramtre. Ce composant est trs utile quand il sagit de faire des mises jour. 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. Database Schema et Edit Schema Chemin daccs au fichier de la base de donnes SQLite. 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
698
tSQLiteRow
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. 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 avant le commit.
Die on error
Advanced settings
Commit every
699
tSQLiteRow
Utilisation
Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes SQL.
Scnario : Mettre jour des lignes SQLite

Le scnario suivant dcrit un Job qui permet de mettre jour un fichier de base de donne SQLite en utilisant une requte prdfinie et un fichier dlimit.
Cliquez-dposez les composants tFileInputDelimited et tSQLiteRow. Dans longlet Basic settings du composant tFileInputDelimited, parcourez les dossiers et slectionnez le fichier dentre utiliser pour mettre jour les lignes dans la base de donnes.
Il ny a ni en-tte ni pied de page. Le sparateur de ligne (Row separator) est un retour chariot et le sparateur de champ (Field separator) un double point. Modifiez le schma sil nest pas stock dans le Repository.
Assurez-vous que la taille et le genre dfinissent correctement les colonnes. Dans longlet Basic settings du composant tSQLiteRow, renseignez le champ Database avec le chemin daccs au fichier mettre jour.
700
tSQLiteRow
Le schma est en mode read-only puisquil doit correspondre au schma dentre. Entrez la requte ou rcuprez-la partir du Repository. Dans le cas prsent, on a mis jour la colonne type_os en focntion de la valeur id dfinie dans le flux entrant. La requte se prsente comme suit : 'Update download set type_os=? where id=?' Cochez ensuite la case Prepared statement pour afficher la table des paramtres substituables.
Dans la table des paramtres dentre, ajoutez autant de lignes quil y a de paramtres substituables. Dans cet exemple, on veut dfinir type_os et id. Renseignez le champ Commit every et choisissez le type dencodage partir de la liste droulant Encoding type. Enregistrez le Job et appuyez sur F6 pour lexcuter. La table dowload table de la base de donnes SQLite est ainsi mise jour le code avec le nouveau code type_os et selon le fichier dlimit dentre.
701
tSybaseBulkExec
tSybaseBulkExec
Proprits du tSybaseBulkExec
Le composant tSybaseBulkExec permet dinsrer les donnes dune base de donnes Sybase. Le tSybaseBulkExec est un composant ddi, il permet un gain de performance lors du traitement des donnes de la base de donnes Sybase. 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 tSybaseConnection 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. Server 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 base de donnes.
702
tSybaseBulkExec
Server Bcp Utility Batch size Table
Adresse IP du serveur de base de donnes pour la connexion de lutilitaire Bcp. Nom de lutilitaire bcp utiliser pour copier les donnes sur le serveur Sybase. Nombre de lignes dans chaque lot de traitement de donnes. Nom de la table crire. Notez quune seule table peut tre crite 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 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 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. 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.
Action on table
File Name
Advanced settings
Action on data
Vous pouvez effectuer les actions suivantes sur la table dfinie : Bulk Insert : ajoute des entres multiples la table. Le Job sarrte lorsque des doublons sont trouvs. Bulk Update : effectue des changements simultans aux multiples entres. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) sparant les lignes. Nombre de lignes den-tte ignorer en dbut de fichier.
Field Terminator Row Terminator Head row
703
tSybaseBulkExec
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. Slectionnez la sortie utiliser pour rcuprer la sortie standard de la base Sybase : to console : vers la console. to global variable : vers la variable globale.
Output
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job , ainsi quau niveau du composant. Utilisation Limitation Ce composant est gnralement utilis lorsque les donnes charger dans la base nexigent aucune transformation particulire. Contrairement au composant Oracle ddi, ce composant Sybase ne permet aucune action directe sur les donnes.
Scnarios associs
Pour un scnario associ au composant tSybaseBulkExec, 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.
704
tSybaseClose
tSybaseClose
Proprits du tSybaseClose
Famille de composant Databases/Sybase
Le composant tSybaseClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Sybase. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tSybaseConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tSybaseConnection et tSybaseRollback. Il est gnralement utilis avec un composant tSybaseConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tSybaseClose, consultez tMysqlConnection page 482
705
tSybaseCommit
tSybaseCommit
Proprits du tSybaseCommit
Ce composant est troitement li aux composants tSybaseConnection et tSybaseRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tSybaseCommit 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 Close Connection Slectionnez le composant tSybaseCommit dans la liste sil y a plus dune connexion dans votre Job. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tSybaseCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Sybase, notamment les composants tSybaseConnection et tSybaseRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tSybaseConnection et tSybaseRollback. Ils sont gnralement utiliss avec un composant tSybaseConnection car celui-ci permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tSybaseCommit, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.
706
tSybaseConnection
tSybaseConnection
Proprits du tSybaseConnection
Ce composant est troitement li aux composants tSybaseCommit et tSybaseRollback. Ils sont gnralement utiliss avec un composant tSybaseConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tSybaseConnection 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.
Ce composant est gnralement utilis avec des composants Oracle, notamment les composants tSybaseCommit et tSybaseRollback. n/a
707
tSybaseConnection
Scnarios associs
Pour un scnario associ au composant tSybaseConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 483.
708
tSybaseInput
tSybaseInput
Proprits du tSybaseInput
Fonction Objectif
Le composant tSybaseInput lit une base de donnes et en extrait des champs laide de requtes. Le tSybaseInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). 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
709
tSybaseInput
Cochez cette case et slectionnez le composant tSybaseConnection 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.
Server Port Database Sybase 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 exact du schma Sybase. 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.
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.
710
tSybaseInput
Advanced settings
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.
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 Sybase.
Scnario associ
Pour un scnario associ, consultez les scnarios du composant tDBInput : le Scnario 1 : Afficher les donnes slectionnes partir dune table, page 258 le 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..
711
tSybaseIQBulkExec
tSybaseIQBulkExec
Proprits du tSybaseIQBulkExec
Famille de composant Databases/SybaseIQ
Le composant tSybaseIQBulkExec permet de charger un fichier bulk dans une base de donnes Sybase IQ. Le tSybaseIQBulkExec est un composant ddi, il permet un gain de performance lors du traitement des donnes de la base de donnes Sybase IQ. 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 tSybaseConnection 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. DB Version Host Port Database Slectionnez la version de Sybase que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.
712
tSybaseIQBulkExec
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 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 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 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. 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.
Action on table
Local filename
Advanced settings
Lines terminated by Field Terminated by Use enclosed quotes Use fixed length
Caractre, chane ou expression rgulire sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Cochez cette case pour utiliser des caractres pour entourer les donnes. Cochez cette case pour dterminer une longueur fixe pour les lignes de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant offre la flexibilit des requtes sur les bases de donnes Sybase IQ. Contrairement au composant Oracle ddi bulk, il nest possible deffectuer aucune action sur les donnes avec ce composant ddi Sybase IQ.
713
tSybaseIQBulkExec
Scnario associ
Pour un scnario associ au tSybaseIQBulkExec, 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.
714
tSybaseIQOutputBulkExec
Proprits du tSybaseIQOutputBulkExec
Famille de composant Databases/SybaseIQ
Le tSybaseIQOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tSybaseIQOutputBulkExec est un composant ddi, il permet un gain de performance lors du traitement des donnes de la base de donnes Sybase IQ. 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 tSybaseConnection 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 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 base de donnes.
715
Table
Nom de la table crire. Notez quune seule table peut tre crite 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 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. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cochez cette case pour ajouter des lignes la fin des enregistrements. 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.
Action on table
File Name
Append the file Schema et Edit Schema
Advanced settings
Fields terminated by Lines terminated by Use enclose quotes Include Head Encoding Type
Caractre, chane ou expression rgulire sparant les champs. Caractre, chane ou expression rgulire sparant les lignes. Cochez cette case pour utiliser des caractres pour entourer les donnes. Cochez cette case pour inclure len-tte des colonnes dans le fichier. 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. Usage Limitation Ce composant est principalement utilis lorsquaucune transformation particulire nest requise sur les donnes charger dans la base de donnes. n/a
716
Scnarios associs
Pour un scnario associ au composant tSybaseIQOutputBulkExec, consultez : 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. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.
717
tSybaseOutput
tSybaseOutput
tSybaseOutput Properties
Le composant tSybaseOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tSybaseOutput 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.
718
tSybaseOutput
Cochez cette case et slectionnez le composant tSybaseConnection 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.
Server Port Database Sybase 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 exact du schma Sybase. 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 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.
Action on table
719
tSybaseOutput
Turn on identity insert Cochez cette case pour utiliser votre propre squence sur les valeurs Identity des donnes insres (plutt que de laisser le serveur SQL choisir les valeurs squentielles). Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job 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 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. 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.
720
tSybaseOutput
Advanced settings
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 tSybaseOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
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. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Sybase. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.
Scnario associ
Pour un scnario associ au composant tSybaseOutput, 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.
721
tSybaseOutputBulk
tSybaseOutputBulk
Proprits du tSybaseOutputBulk
Les composants tSybaseOutputBulk et tSybaseBulkExec 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 tSybaseOutputBulkExec, 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.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Sybase. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Sybase. 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 rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Advanced settings
722
tSybaseOutputBulk
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 tSybaseBulkExec. Ensemble ils offrent un gain de performance important pour lalimentation dune base de donnes Sybase.
Scnario associ
Pour un scnario associ au composant tSybaseOutputBulk, consultez : 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. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.
723
tSybaseOutputBulkExec
Proprits du tSybaseOutputBulkExec
Le tSybaseOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tSybaseOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Sybase. 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 tSybaseConnection 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. Server 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 base de donnes.
724
Bcp Utility Table
Nom de lutilitaire bcp utiliser pour copier les donnes sur le serveur Sybase. Nom de la table crire. Notez quune seule table peut tre crite 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. 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 rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Action on table
File Name
Advanced settings
Action on data
Vous pouvez effectuer les actions suivantes sur la table dfinie : Bulk Insert : ajoute des entres multiples la table. Le Job sarrte lorsque des doublons sont trouvs. Bulk Update : effectue des changements simultans aux multiples entres. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) sparant les lignes dans la base de donnes. Nombre de lignes den-tte ignorer en dbut de fichier.
Field Terminator DB Row Terminator First row N0 . Of File
FILE Row Terminator Caractre, chane ou expression rgulire sparant les lignes dans le fichier. Include Head Cochez cette case pour inclure len-tte des colonnes dans le fichier.
725
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. to console : linformation est charge. to global variable : valeurs retournes partir de fichiers de log.
Output
Scnarios associs
Pour un scnario associ au composant tSybaseOutputBulkExec, consultez : 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. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du tOracleBulkExec.
726
tSybaseRollback
tSybaseRollback
Proprits du tSybaseRollback
Ce composant est troitement li aux composants tSybaseCommit et tSybaseConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tSybaseRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Close Connection Slectionnez le composant tSybaseConnection 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.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec dautres composants Oracle, notamment les composants tSybaseConnection et tSybaseCommit. n/a
Scnario associ
Pour un scnario associ au composant tSybaseRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524.
727
tSybaseRow
tSybaseRow
Proprits du tSybaseRow
Fonction
Le tSybaseRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tSybaseRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. 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. Server Port Database Sybase 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 Sybase.
Objectif
Basic settings
728
tSybaseRow
Username et Password Table name
Informations dauthentification de lutilisateur de base de donnes. Nom de la table lire.
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. 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. 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. 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.
Advanced settings
729
tSybaseRow
Commit every
Scnario associ
Pour un scnario associ au composant tSybaseRow, 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.
730
tSybaseSCD
tSybaseSCD
Le composant tSybaseSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tSybaseSCD, page 61.
731
tSybaseSCDELT
tSybaseSCDELT
Le composant tSybaseSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tSybaseSCDELT, page 63.
732
tSybaseSP
tSybaseSP
Proprits du tSybaseSP
Le composant tSybaseSP appelle une procdure stocke de base de donnes. Ce composant 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 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 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.
733
tSybaseSP
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.
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. Dure maximale dattente des resultats de la procdure stocke. 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.
Timeout Interval Parameters
Advanced settings
Encoding Type
734
tSybaseSP
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.
735
tTeradataClose
tTeradataClose
Proprits du tTeradataClose
Famille de composant Databases/Teradata
Le composant tTeradataClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Teradata. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tTeradataConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tTeradataConnection et tTeradataRollback. Il est gnralement utilis avec un composant tTeradataConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tTeradataClose, consultez tMysqlConnection page 482
736
tTeradataCommit
tTeradataCommit
Proprits du tTeradataCommit
Ce composant est troitement li aux composants tTeradataConnection et tTeradataRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tTeradataCommit 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 tTeradataConnection dans la liste sil y a plus dune connexion dans votre Job. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tTeradataCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Postgresql, notamment les composants tTeradataConnection et tTeradataRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tTeradataConnection et tTeradataRollback. Ils sont gnralement utiliss avec un composant tTeradataConnection car celui-ci permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tTeradataCommit, consultez tMysqlConnection page 482.
737
tTeradataConnection
tTeradataConnection
Proprits du tTeradataConnection
Ce composant est troitement li aux composants tTeradataCommit et tTeradataRollback. Ils sont gnralemet utiliss avec un composant tTeradataConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tTeradataConnection 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 Database Username et Password Additional JDBC parameters Adresse IP du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes, afin de supporter des caractres spcifiques. Exemple : CHARSET=KANJISIS_OS pour supporter les caractres japonais. 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.
Encoding type
Advanced settings
Auto Commit
738
tTeradataConnection
Ce composant est gnralement utilis avec des composants Teradata, notamment les composants tTeradataCommit et tTeradataRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tTeradataCommit et tTeradataRollback. Ils sont gnralement utiliss avec un composant tTeradataConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tTeradataConnection, consultez tMysqlConnection page 482
739
tTeradataFastExport
tTeradataFastExport
Proprits du tTeradataFastExport
Le composant tTeradataFastExport exporte trs rapidement des lots de donnes volumineux dune table ou dune vue Teradata. Le tTeradataFastExport exporte des lots de donnes dune table Teradata vers un systme client ou vers une base de donnes plus petite. 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 Database name Username et Password Table Schema et Edit Schema Slectionnez le type de systme dexploitation que vous utilisez. 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. 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. Script generated folder Exported file Field separator Error file Parcourez votre rpertoire et slectionnez la destination du fichier qui sera cr. Nom et chemin daccs au fichier qui sera cr. Caractre, chane ou expression rgulire sparant les champs. Parcourez votre rpertoire et slectionnez la destination du fichier dans lesquels seront enregistrs les messages derreur.
Advanced settings
740
tTeradataFastExport
Utilisation
Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Teradata.
Scnario associ
741
tTeradataFastLoad
tTeradataFastLoad
Proprits du tTeradataFastLoad
Fonction Objectif
Le composant tTeradataFastLoad lit une base de donnes et en extrait des champs laide de requtes. Le tTeradataFastLoad excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). 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 Database Username et Password Table Execute Batch every Die on error 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. Nombre de lignes par lot charger. 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. 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.
Basic settings
Advanced settings
742
tTeradataFastLoad
Utilisation
Scnario associ
743
tTeradataFastLoadUtility
Proprits du tTeradataFastLoadUtility
Fonction Objectif
Le composant tTeradataFastLoadUtility lit une base de donnes et en extrait des champs laide de requtes. Le tTeradataFastLoadUtility excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). 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 Database name Username et Password Table Schema et Edit Schema Slectionnez le type de systme dexploitation que vous utilisez. 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. 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. Script generated folder Load file Field separator Error file Parcourez votre rpertoire et slectionnez la destination du fichier qui sera cr. Entrez le nom du fichier partir duquel vous souhaitez charger les donnes. Caractre, chane ou expression rgulire sparant les champs. Parcourez votre rpertoire et slectionnez la destination du fichier dans lesquels seront enregistrs les messages derreur.
Basic settings
744
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Teradata.
Scnario associ
745
tTeradataInput
tTeradataInput
Proprits du tTeradataInput
Fonction Objectif
Le composant tTeradataInput lit une base de donnes et en extrait des champs laide de requtes. Le tTeradataInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). 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 tSybaseConnection 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
746
tTeradataInput
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 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 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. 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, afin de supporter des caractres spcifiques. Exemple : CHARSET=KANJISIS_OS pour supporter les caractres japonais.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. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Advanced settings
Encoding Type
747
tTeradataInput
Utilisation
Scnario associ
Pour un scnario associ, consultez les scnarios du 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 tContextLoad.
748
tTeradataMultiLoad
tTeradataMultiLoad
Proprits du tTeradataMultiLoad
Fonction Objectif
Le composant tTeradataMultiLoad lit une base de donnes et en extrait des champs laide de requtes. Le tTeradataMultiLoad excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). 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 Database name Username et Password Table Schema et Edit Schema Slectionnez le type de systme dexploitation que vous utilisez. 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. 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. Script generated folder Parcourez votre rpertoire et slectionnez la destination du fichier qui sera cr.
Basic settings
749
tTeradataMultiLoad
Action to data
Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. 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.
Where condition in case Delete Load file Field separator Error file
Saisissez une condition, qui, si elle est vrifie, supprimera la ligne. Entrez le nom du fichier partir duquel vous souhaitez charger les donnes. Caractre, chane ou expression rgulire sparant les champs. Parcourez votre rpertoire et slectionnez la destination du fichier dans lesquels seront enregistrs les messages derreur.
Scnario associ
750
tTeradataOutput
tTeradataOutput
Proprits du tTeradataOutput
Le composant tTeradataOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tTeradataOutput 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. Use an existing connection Cochez cette case et slectionnez le composant tTeradataConnection 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.
751
tTeradataOutput
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 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 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. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback.
752
tTeradataOutput
Action on data
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. 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.
753
tTeradataOutput
Advanced settings
Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes, afin de supporter des caractres spcifiques. Exemple : CHARSET=KANJISIS_OS pour supporter les caractres japonais.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 tTeradataOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
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 de 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 de requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Teradata. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 507 du composant tMysqlOutput.
754
tTeradataOutput
Scnario associ
755
tTeradataRollback
tTeradataRollback
Proprits du tTeradataRollback
Ce composant est troitement li aux composants tTeradataCommit et tTeradataConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tTeradataRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant tTeradataConnection 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.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec dautres composants Teradata, notamment les composants tTeradataConnection et tTeradataCommit. n/a
Scnario associ
Pour un scnario associ au composant tTeradataRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524.
756
tTeradataRow
tTeradataRow
Proprits du tTeradataRow
Fonction
Le tTeradataRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tTeradataRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. 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 tTeradataConnection 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 de base de donnes.
Objectif
Basic settings
757
tTeradataRow
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 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
Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le 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, afin de supporter des caractres spcifiques. Exemple : CHARSET=KANJISIS_OS pour supporter les caractres japonais.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
758
tTeradataRow
Commit every
Scnario associ
759
tTeradataTPump
tTeradataTPump
Proprits du tTeradataTPump
Fonction Objectif
Le composant tTeradataTPump lit une base de donnes et en extrait des champs l'aide de requtes. Le tTeradataTPump 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 de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Execution platform Database name Username et Password Table Schema et Edit Schema Slectionnez le type de systme dexploitation que vous utilisez. 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. 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. Script generated folder Parcourez votre rpertoire et slectionnez la destination du fichier qui sera cr.
Basic settings
760
tTeradataTPump
Action to data
Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. 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.
Where condition in case Delete Load file Field separator Error file
Saisissez une condition, qui, si elle est vrifie, supprimera la ligne. Entrez le nom du fichier partir duquel vous souhaitez charger les donnes. Caractre, chane ou expression rgulire sparant les champs. Parcourez votre rpertoire et slectionnez la destination du fichier dans lesquels seront enregistrs les messages derreur.
Scnario associ
761
tVerticaBulkExec
tVerticaBulkExec
Proprits du tVerticaBulkExec
Les composants tVerticaOutputBulk et tVerticaBulkExec 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 tVerticaOutputBulkExec, 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/Vertica
Le composant tVerticaBulkExec effectue une action dInsert sur les donnes fournies. Le tVerticaBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Vertica. 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 composant tVerticaConnection. 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
762
tVerticaBulkExec
Database Username et Password Action on table
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 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 de la table crire. Notez quune seule table peut tre crite la fois. 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 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 Schema et Edit schema
Remote Filename
Nom du fichier traiter. Voir galement :Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cochez cette case pour stocker les donnes dans une mmoire physique, et ainsi optimiser la lecture de ces donnes, puisquelles seront compresses et pr-tries. Le Job sarrte automatiquement si aucune ligne na t charge. Caractre, chane ou expression rgulire sparant les champs. Chane de caractres affiche pour signifier que la valeur est nulle.
Advanced settings
Write to ROS (Read Optimized Store)
Exit job if no row was loaded Fields terminated by Null string
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec un composant tVerticaOutputBulk. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes Vertica.
763
tVerticaBulkExec
Scnarios associs
Pour un scnario associ au composant tVerticaBulkExec, 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 composant tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 569 du composant tOracleBulkExec.
764
tVerticaClose
tVerticaClose
Proprits du tVerticaClose
Le composant tVerticaClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Vertica. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tVerticaConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tVerticaConnection et tVerticaRollback. Il est gnralement utilis avec un composant tVerticaConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tVerticaClose, consultez tMysqlConnection page 482
765
tVerticaCommit
tVerticaCommit
Proprits du tVerticaCommit
Ce composant est troitement li aux composants tVerticaConnection et tVerticaRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tVerticaCommit 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 tVerticaConnection 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 tVerticaCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Vertica et notamment avec les composants tVerticaConnection et tVerticaRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tVerticaConnection et tVerticaRollback. Ils sont gnralement utiliss avec un composant tVerticaConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tVerticaCommit, consultez tVerticaConnection page 767.
766
tVerticaConnection
tVerticaConnection
Proprits du tVerticaConnection
Ce composant est troitement li aux composants tVerticaCommit et tVerticaRollback. Ils sont gnralemet utiliss avec un composant tVerticaConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tVerticaConnection 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.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Vertica, notamment les composants tVerticaCommit et tVerticaRollback. n/a
767
tVerticaConnection
Scnario associ
Ce composant est troitement li aux composants tVerticaCommit et tVerticaRollback. Ils sont gnralement utiliss avec un composant tVerticaConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tVerticaConnection, consultez tMysqlConnection page 482
768
tVerticaInput
tVerticaInput
Proprits du tVerticaInput
Fonction Objectif
Le composant tVerticaInput lit une base de donnes et en extrait des champs laide de requtes. Le tVerticaInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). 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
769
tVerticaInput
Cochez cette case lorsque vous utilisez le composant tVerticaConnection. 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.
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.
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. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres.
Advanced settings
Trim all the String/Char columns
770
tVerticaInput
Trim column
Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Vertica.
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.
771
tVerticaOutput
tVerticaOutput
Proprits du tVerticaOutput
Le composant tVerticaOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tVerticaOutput 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 tVerticaConnection. 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.
772
tVerticaOutput
Port Database Username et Password Table 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 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. 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
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.
773
tVerticaOutput
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. 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. Cochez cette case afin de paramtrer le nombre de lignes dans chaque lot de traitement de donnes, dans le champ Batch Size. 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 tVerticaOutput 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.
Advanced settings
Encoding
Commit every
Use Batch Mode
Additional Columns
774
tVerticaOutput
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 Vertica. 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 tVerticaOutput, 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.
775
tVerticaOutputBulk
tVerticaOutputBulk
Proprits du tVerticaOutputBulk
Les composants tVerticaOutputBulk et tVerticaBulkExec 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 tVerticaOutputBulkExec, 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.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Vertica. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Vertica. 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.
Advanced settings
776
tVerticaOutputBulk
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 tVerticaBulkExec. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes Vertica.
Scnarios associs
Pour un scnario associ au tVerticaOutputBulk, 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.
777
tVerticaOutputBulkExec
Proprits du tVerticaOutputBulkExec
Le composant tVerticaOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tVerticaOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Vertica. 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 DB Name 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. 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. 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
778
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. Cochez cette case pour stocker les donnes dans une mmoire physique, et ainsi optimiser la lecture de ces donnes, puisquelles seront compresses et pr-tries. Le Job sarrte automatiquement si aucune ligne na t charge. Caractre, chane ou expression rgulire sparant les champs. Chane de caractres affiche pour signifier que la valeur est nulle. Cochez cette case pour inclure len-tte des colonnes dans le fichier. 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.
Append Advanced settings Write to ROS (Read Optimized Store)
Exit job if no row was loaded Field Separator Null string Include header Encoding Type
Scnarios associs
Pour un scnario associ au tVerticaOutputBulkExec, 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.
779
tVerticaRollback
tVerticaRollback
Proprits du tVerticaRollback
Ce composant est troitement li aux composants tVerticaCommit et tVerticaConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tVerticaRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Close Connection Slectionnez le composant tVerticaConnection 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.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec dautres composants Oracle, notamment les composants tVerticaConnection et tVerticaCommit. n/a
Scnario associ
Pour un scnario associ au composant tVerticaRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524.
780
tVerticaRow
tVerticaRow
Proprits du tVerticaRow
Fonction
Le tVerticaRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tVerticaRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. 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 Vertica que vous utilisez. Cochez cette case lorsque vous utilisez le composant tVerticaConnection. 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.
Objectif
Basic settings
781
tVerticaRow
Schema Username et Password Schema et Edit Schema
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. 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
Die on error
Advanced settings
782
tVerticaRow
Encoding
Commit every
Scnario associ
Pour un scnario associ au composant tVerticaRow, 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.
783
tVerticaRow
784
Composants ELT
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille ELT de la Palette de Talend Open Studio. La famille ELT regroupe les connecteurs de bases de donnes les plus courants, ainsi que des composants de traitement, tous ddis au mode ELT dans lequel les SGBD cibles deviennent des outils de transformation. Ce mode supporte les bases de donnes les plus courantes, comme Teradata, Oracle, Vertica, Netezza, Sybase, etc.
Composants ELT
tELTAggregate
tELTAggregate
Proprits du tELTAggregate
Famille de composant ELT
Fonction
Le composant tELTAggregate collecte les donnes dune ou plusieurs colonnes et gre ces donnes en un seul bloc. Ce composant excute en temps rel des transformations de donnes dans la SGBD elle-mme. Il permet dtablir des mtriques bases sur des valeurs ou des calculs. Component list Slectionnez le composant de connexion la base de donnes dans la liste si vous utilisez plus dune connexion dans le Job en cours. Nom de la base de donnes. Nom de la table contenant les donnes dont vous souhaitez collecter les donnes. Nom de la table dans laquelle vous souhaitez crire les donnes collectes et transformes. 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. Operations Slectionnez le type dopration et la valeur utiliser pour le calcul et le champ de sortie. Output Column : Slectionnez le champ de destination dans la liste. Function : Slectionnez une des oprations suivantes effectuer sur les donnes : count : calcule le nombre de lignes, min : slectionne la plus petite valeur, max : slectionne la plus grande valeur, avg : calcule la moyenne, sum : calcule la somme, count (distinct) : compte le nombre de lignes sans les doublons.
Database name Source table name Target table name Schema et Edit Schema
786
Composants ELT
tELTAggregate
Input column position : Slectionnez la colonne dentre partir de laquelle vous souhaitez collecter les donnes agrger. Group by Dfinit les ensembles dagrgation, dont les valeurs sont utilises pour les calculs. Output Column : Slectionnez le libell de colonne dans la liste fournie, base sur la structure de schma que vous avez dfinie. Vous pouvez ajouter autant de colonnes de sortie que vous le souhaitez afin daffiner les agrgations. Input Column position : Faites la correspondance entre les libells des colonnes dentre avec ceux des colonnes de sortie, dans le cas o vous souhaitez que les libells du schma de sortie soient diffrents du schma dentre. Advanced settings SQL Template tStatCatcher Statistics SQLTemplate List Cochez cette case pour collecter les donnes de log au niveau du composant. Cliquez sur le bouton Add pour ajouter un ou plusieurs modle SQL du systme la liste SQLTemplateList. Cliquez dans la cellule de la colonne SQLTemplate List que vous venez dajouter et slectionnez le modle SQL du systme adquat dans la liste de modles fournis par Talend. Note : Vous pouvez crer vos propres modles SQL et les ajouter la liste SQLTemplate List. Pour crer un nouveau modle SQL : 1- Slectionnez un modle dj existant dans la liste SQLTemplate list et cliquez dans son code dans le champ de code. Une bote de dialogue souvrira vous demandant de crer un nouveau modle. 2- Cliquez sur Yes pour ouvrir la bote de dialogue New SQLTemplate. 3- Renseignez les informations de votre modle SQL et cliquez sur Finish pour fermer la bote de dialogue. Un diteur de modle SQL apparat dans lequel vous pouvez saisir votre code. 4- Cliquez sur le bouton Add pour ajouter le nouveau modle dans la liste SQLTemplate list. Pour plus dinformations, consultez la section Utilisation des SQL Templates, page 123 du Guide Utilisateur Talend Open Studio. Utilisation Ce composant est un composant intermdiaire. Vous pouvez lutiliser avec dautres composants de base de donnes, notamment les composants de connexion et de commit. n/a
Limitation
787
Composants ELT
tELTAggregate
Scnario : Filtrer et agrger les colonnes dune table directement dans le SGBD
Le scnario Java suivant cre un Job qui ouvre une connexion une base de donnes Mysql et : cre un schma partir de la table dune base de donnes, les lignes de ce schma correspondent aux noms des colonnes spcifies dans le filtre, filtre les colonnes de cette mme table afin de nobtenir que les donnes correspondant aux colonnes filtres, collecte les donnes de la colonne filtre, regroupes en fonction dune valeur spcifique et crit les donnes agrges dans la table de cible. Pour filtrer et agrger les colonnes de la table de votre base de donnes : Cliquez et dposez les composants suivants dans lespace de modlisation : tELTMysqlconnection, tELTFilterColumns, tELTFilterRows, tELTAggregate, tELTCommit et tELTRollback. Connectez les cinq composants laide de liens de type OnComponentOk. Connectez les composants tELTAggregate et tELTRollback laide dun lien de type OnComponentError.
Dans lespace de modlisation, slectionnez le tMysqlConnection et cliquez sur la vue Component pour paramtrer ses proprits. Dans longlet Basic settings, renseignez manuellement les informations de connexion ou slectionnez-les partir des variables de contexte, via la raccourci Ctrl+Espace cliquez sur le champ correspondant si les vous avez stock sous le noeud DB connection du rpertoire Metadata du Repository. Pour plus dinformations sur les mtadonnes, consultez Dfinition des schmas de mtadonnes du Guide utilisateur de Talend Open Studio.
788
Composants ELT
tELTAggregate
Dans lespace de modlisation, slectionnez le composant tELTFilterColumns et cliquez sur la vue Component pour paramtrer ses proprits.
Dans la liste droulante Database type, slectionnez la base de donnes adquate. Dans la liste droulante Component list, slectionnez le composant de connexion la base de donnes si plusieurs composants de connexion sont utiliss dans votre Job. Dans le champ Database name, saisissez le nom de la base de donnes laquelle vous vous tes connect. Dans le champ Source table name, saisissez le nom de votre table source contenant les donnes que vous souhaitez traiter et cliquez sur le bouton [...] ct du champ Edit schema pour dfinir la structure des donnes de votre table source. Dans le champ Target table name, saisissez le nom de la table cible contenant vos nouvelles donnes traites et cliquez sur le bouton [...] ct du champ Edit schema pour dfinir la structure de la table cible.
Lorsque vous dfinissez la structure des donnes de la table source, le nom des colonnes apparat automatiquement dans la colonne Column du tableau Column filters.
Dans ce scnario, la table source contient les cinq colonnes : id, First_Name, Last_Name, Address et id_State.
789
Composants ELT
tELTAggregate
Dans le tableau Column filters, filtrez les colonnes en cochant la case des colonnes que vous souhaitez crire dans votre table cible. Dans ce scnario, le composant tELTFilterColumns ne garde que les colonnes id, First_Name et id_State de la table source.
Dans la vue Component, vous pouvez cliquer sur longlet SQL Template et ajouter des modles SQL du systme ou crer vos propres modles SQL et les utilisez dans votre Job afin deffectuer les oprations que vous souhaitez. Pour plus dinformations, consultez Proprits du tELTFilterColumns page 795.
Dans lespace de modlisation, slectionnez le composant tELTFilterRows et cliquez sur longlet Component pour paramtrer ses proprits.
Dans la liste droulante Database type, slectionnez la base de donnes adquate. Dans la liste droulante Component list, slectionnez le composant de connexion la base de donnes si plusieurs composants de connexion sont utiliss dans votre Job. Dans le champ Database name, saisissez le nom de la base de donnes laquelle vous vous tes connect. Dans le champ Source table name, saisissez le nom de votre table source contenant les donnes que vous souhaitez traiter et cliquez sur le bouton [...] ct du champ Edit schema pour dfinir la structure des donnes de votre table source. Dans le champ Target table name, saisissez le nom de la table cible contenant vos nouvelles donnes traites et cliquez sur le bouton [...] ct du champ Edit schema pour dfinir la structure de la table cible. Dans ce scnario, la table source et la table cible contiennent les trois colonnes filtres id, First_Name et id_State. Dans le champ Where condition, saisissez la commande WHERE vous permettant de nextraire que les champs correspondant vos critres. Dans ce scnario, le composant tELTFilterRows filtre la colonne First_Name de la table source pour nobtenir que les prnoms commencent par la lettre a. Dans lespace de modlisation, slectionnez le composant tELTAggregate et cliquez sur la vue Component pour paramtrer ses proprits. Dans la liste droulante Database type, slectionnez la base de donnes adquate. Dans la liste Component list, slectionnez le composant de connexion la base de donnes si plusieurs composants de connexion sont utiliss dans votre Job.
790
Composants ELT
tELTAggregate
Dans le champ Database name, saisissez le nom de la base de donnes laquelle vous vous tes connect. Dans le champ Source table name, saisissez le nom de votre table source contenant les donnes que vous souhaitez traiter et cliquez sur le bouton [...] ct du champ Edit schema pour dfinir la structure des donnes de votre table source. Dans le champ Target table name, saisissez le nom de la table cible contenant vos nouvelles donnes traites et cliquez sur le bouton [...] ct du champ Edit schema pour dfinir la structure de la table cible. Le schma de la table source est compos de trois colonnes : id, First_Name et id_State. Le schma de la table cible est compos de deux colonnes : customers_status et customers_number. Dans ce scnario, nous souhaitons regrouper les clients par statut marital et compter le nombre de client pour chaque groupe marital. Pour cela, dfinissez les tableaux Operations et Grouped by.
Dans le tableau Operations, cliquez sur le bouton [+] pour ajouter une ou plusieurs lignes et cliquez dans la cellule de la colonne Output column et slectionnez la colonne de sortie qui contiendra les donnes compter. Cliquez dans la cellule de la colonne Function et slectionnez lopration effectuer.
791
Composants ELT
tELTAggregate
Dans le tableau Group by, cliquez sur le bouton [+] pour ajouter une ou plusieurs lignes et cliquez dans la cellule de la colonne Output column pour slectionner la colonne de sortie qui contiendra les donnes agrges. Dans lespace de modlisation, slectionnez le composant tELTCommit et cliquez sur la vue Component pour paramtrer ses proprits. Dans la liste droulante Database type, slectionnez la base de donnes adquate. Dans la liste droulante Component list, slectionnez le composant de connexion la base de donnes si plusieurs composants de connexion sont utiliss dans votre Job. Effectuez la mme procdure pour le composant tELTRollback. Enregistrez le Job et appuyez sur F6 pour lexcuter. La table aggregate_customers compose de deux colonnes est cre dans la base de donnes. Elle regroupe les clients en fonction de leur statut marital et compte le nombre de client pour chaque statut marital.
792
Composants ELT
tELTCommit
tELTCommit
Proprits du tELTCommit
Ce composant est troitement li au composant tELTRollback et au composant ELT de connexion la base de donnes sur laquelle vous travaillez. Ils sont gnralement utiliss ensemble lors de transactions.
Famille du composant Databases/ELT
Fonction Objectif
Le composant tELTCommit 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. Database Type Component list Slectionnez dans le menu droulant le type de base de donnes sur lequel vous voulez travailler. Sil y a plus dune connexion dans le Job en cours, slectionnez le composant de connexion la base de donnes que vous utilisez dans la liste. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Basic settings
Close connection
Advanced settings SQL Template
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. SQLTemplate List Cliquez sur le bouton Add pour ajouter un ou plusieurs modle SQL du systme la liste SQLTemplateList. Cliquez dans la cellule de la colonne SQLTemplate List que vous venez dajouter et slectionnez le modle SQL du systme adquat dans la liste de modles fournis par Talend. Note : Vous pouvez crer vos propres modles SQL et les ajouter la liste SQLTemplate List. Pour crer un nouveau modle SQL : 1- Slectionnez un modle dj existant dans la liste SQLTemplate list et cliquez dans son code dans le champ de code. Une bote de dialogue souvrira vous demandant de crer un nouveau modle. 2- Cliquez sur Yes pour ouvrir la bote de dialogue New SQLTemplate. 3- Renseignez les informations de votre modle SQL et cliquez sur Finish pour fermer la bote de dialogue. Un diteur de modle SQL apparat dans lequel vous pouvez saisir votre code. 4- Cliquez sur le bouton Add pour ajouter le nouveau modle dans la liste SQLTemplate list. Pour plus dinformations, consultez la section Utilisation des SQL Templates, page 123 du Guide Utilisateur Talend Open Studio.
793
Composants ELT
tELTCommit
Utilisation
Ce composant est gnralement utilis avec des composants ELT et notamment avec le composant tELTRollback, ainsi quavec le composant ELT de connexion la base de donnes que vous utilisez. n/a
Limitation
Scnario associ
Ce composant est troitement li au composant tELTRollback et au composant ELT de connexion la base de donnes avec laquelle vous travaillez. Ils sont gnralement utiliss avec le composant ELT de connexion correspondant car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tELTCommit, consultez tVerticaConnection page 767.
794
Composants ELT
tELTFilterColumns
tELTFilterColumns
Proprits du tELTFilterColumns
Fonction
Le composant tELTFilterColumns modifie le schma de la table dune base de donnes en filtrant les colonnes. Ce composant filtre en temps rel les donnes dans la SGBD elle-mme. Il permet dhomogniser des schmas en rorganisant ou en supprimant des colonnes ou en ajoutant de nouvelles colonnes. Database Type Component list Slectionnez dans le menu droulant le type de base de donnes sur lequel vous voulez travailler. Slectionnez le composant de connexion la base de donnes si vous utilisez plus dune connexion dans votre Job en cours. Nom de la base de donnes. Nom de la table contenant les donnes filtrer. Nom de la table dans laquelle vous souhaitez crire les donnes filtres. 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. Column filters Dans le tableau, cochez la case Filter pour filtrer toutes vos colonnes, ou, pour en filtrer moins, cliquez sur la ou les case(s) en face du nom de la ou des colonne(s). Cochez cette case pour collecter les donnes de log au niveau du composant.
Advanced settings
795
Composants ELT
tELTFilterColumns
SQL Template
SQLTemplate List
Cliquez sur le bouton Add pour ajouter un ou plusieurs modle SQL du systme la liste SQLTemplateList. Cliquez dans la cellule de la colonne SQLTemplate List que vous venez dajouter et slectionnez le modle SQL du systme adquat dans la liste de modles fournis par Talend. Note : Vous pouvez crer vos propres modles SQL et les ajouter la liste SQLTemplate List. Pour crer un nouveau modle SQL : 1- Slectionnez un modle dj existant dans la liste SQLTemplate list et cliquez dans son code dans le champ de code. Une bote de dialogue souvrira vous demandant de crer un nouveau modle. 2- Cliquez sur Yes pour ouvrir la bote de dialogue New SQLTemplate. 3- Renseignez les informations de votre modle SQL et cliquez sur Finish pour fermer la bote de dialogue. Un diteur de modle SQL apparat dans lequel vous pouvez saisir votre code. 4- Cliquez sur le bouton Add pour ajouter le nouveau modle dans la liste SQLTemplate list. Pour plus dinformations, consultez la section Utilisation des SQL Templates, page 123 du Guide Utilisateur Talend Open Studio.
Utilisation
Ce composant est un composant intermdiaire. Vous pouvez lutiliser avec dautres composants de base de donnes, notamment les composants de connexion et de commit. n/a
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Filtrer et agrger les colonnes dune table directement dans le SGBD, page 788.
796
Composants ELT
tELTFilterRows
tELTFilterRows
Proprits du tELTFilterRows
Fonction
Le composant tELTFilterRows vous permet de filtrer les lignes dune table. Ce composant filtre en temps rel les donnes dans la SGBD elle-mme. Il permet de mettre en place un filtrage de lignes sur nimporte quelle donne source grce une commande WHERE. Database Type Component List Slectionnez dans le menu droulant le type de base de donnes sur lequel vous voulez travailler. Slectionne le composant de connexion la base de donnes si vous utilisez plus dune connexion dans le Job en cours. Nom de la base de donnes. Nom de la table contenant les donnes filtrer. Nom de la table dans laquelle vous souhaitez crire les donnes filtres. 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. Where condition Utilisez une commande WHERE pour dfinir un critre partir duquel vous souhaitez filtrer vos donnes. Vous pouvez utiliser la commande WHERE pour slectionner des lignes spcifiques de votre table en fonction de certains critres ou certaines conditions. Cochez cette case pour collecter les donnes de log au niveau du composant.
Advanced settings
797
Composants ELT
tELTFilterRows
SQL Template
SQLTemplate List
Cliquez sur le bouton Add pour ajouter un ou plusieurs modle SQL du systme la liste SQLTemplateList. Cliquez dans la cellule de la colonne SQLTemplate List que vous venez dajouter et slectionnez le modle SQL du systme adquat dans la liste de modles fournis par Talend. Note : Vous pouvez crer vos propres modles SQL et les ajouter la liste SQLTemplate List. Pour crer un nouveau modle SQL : 1- Slectionnez un modle dj existant dans la liste SQLTemplate list et cliquez dans son code dans le champ de code. Une bote de dialogue souvrira vous demandant de crer un nouveau modle. 2- Cliquez sur Yes pour ouvrir la bote de dialogue New SQLTemplate. 3- Renseignez les informations de votre modle SQL et cliquez sur Finish pour fermer la bote de dialogue. Un diteur de modle SQL apparat dans lequel vous pouvez saisir votre code. 4- Cliquez sur le bouton Add pour ajouter le nouveau modle dans la liste SQLTemplate list. Pour plus dinformations, consultez la section Utilisation des SQL Templates, page 123 du Guide Utilisateur Talend Open Studio.
Utilisation
Ce composant est un composant intermdiaire. Vous pouvez lutiliser avec dautres composants de base de donnes, notamment les composants de connexion et de commit. n/a
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Filtrer et agrger les colonnes dune table directement dans le SGBD, page 788.
798
Composants ELT
tELTJDBCInput
tELTJDBCInput
Proprits de tELTJDBCInput
Les composants tELTJDBCInput, tELTJDBCOutput, et tELTJDBCMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base JDBC afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fournit le schma de la table dentre la commande SQL qui sera excute. Permet dajouter autant de tables que ncessaires dans une commande Insert qui peut tre complexe. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Le schma dfini est ensuite pass au composant ELT Mapper afin de lutiliser dans la commande SQL Insert 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. Default Table Name Saisissez le nom de la table par dfaut.
Default Schema Name Saisissez le nom du schma par dfaut. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTJDBCInput est troitement lie celle du tELTJDBCMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTJDBCInput, consultez les scnarios suivants du composant tELTMysqlMap :
799
Composants ELT
tELTJDBCInput
Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 814. Scnario 2 : ELT utilisant une table Alias, page 817.
800
Composants ELT
tELTJDBCMap
tELTJDBCMap
Proprits de tELTJDBCMap
Les composants tELTJDBClInput, tELTJDBCOutput, et tELTJDBCMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base JDBC afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. 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. ELT Oracle Map Editor Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
801
Composants ELT
tELTJDBCMap
Style link
Slectionnez le type daffichage des liens. Auto : par dfaut, les liens entre les schmas dentre et de sortie et les paramtres du service Web sont en forme de courbe. Curves : les liens entre les schmas et les paramtres du service Web sont en forme de ligne. Line : les liens entre les schmas et les paramtres du service Web sont en forme de lignes droites. Cette option vous permettra doptimiser les performances. 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.
Property type
Host Port Database Username et Password Encoding Type
Adresse IP du serveur de base de donnes Numro de port dcoute du serveur de la base. Nom de la base de donnes Donnes dauthentification de lutilisateur de la base 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. 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
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Lutilisation du composant tELTJDBCMap est troitement lie celle des composants tELTJDBCInput et tELTJDBCOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios associs, consultez les scnarios suivants du composant tELTMysqlMap : Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 814. Scnario 2 : ELT utilisant une table Alias, page 817.
802
Composants ELT
tELTJDBCOutput
tELTJDBCOutput
Proprits de tELTJDBCOutput
Les composants tELTJDBCInput, tELTJDBCOutput, et tELTJDBCMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base MSSql afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Famille du composant ELT
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert dans la base de donnes JDBC. Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Note : dans les composants ELT JDBC, seule lopration Insert est disponible. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. 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. Default Table Name Saisissez le nom de la table par dfaut.
Default Schema Name Saisissez le nom du schma par dfaut. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTJDBCOutput est troitement lie celle des composants tELTJDBCInput et tELTJDBCMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
803
Composants ELT
tELTJDBCOutput
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTJDBCOutput, consultez les scnarios suivants du composant tELTJDBCMap : Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 814. Scnario 2 : ELT utilisant une table Alias, page 817.
804
Composants ELT
tELTMSSqlInput
tELTMSSqlInput
Proprits de tELTMSSqlInput
Les composants tELTMSSqlInput, tELTMSSqlOutput, et tELTMSSqlMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base MSSql afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Default Schema Name Saisissez le nom du schma par dfaut. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTMSSqlInput est troitement lie celle du tELTMSSqlMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTMSSqlInput, consultez les scnarios suivants du composant tELTMysqlMap :
805
Composants ELT
tELTMSSqlInput
806
Composants ELT
tELTMSSqlMap
tELTMSSqlMap
Proprits de tELTMSSqlMap
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. 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. ELT MSSql Map Editor Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
807
Composants ELT
tELTMSSqlMap
Style link
Property type
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Lutilisation du composant tELTMSSqlMap est troitement lie celle des composants tELTMSSqlInput et tELTMSSqlOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
808
Composants ELT
tELTMSSqlOutput
tELTMSSqlOutput
Proprits de tELTMSSqlOutput
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert dans la base de donnes MSSql. Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Note : dans les composants ELT MSSql, seule lopration Insert est disponible. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. 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. Default Table Name Saisissez le nom de la table par dfaut.
Default Schema Name Saisissez le nom du schma par dfaut. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTMSSqlOutput est troitement lie celle des composants tELTMSSqlInput et tELTMSSqlMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
809
Composants ELT
tELTMSSqlOutput
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTMSSqlOutput, consultez les scnarios suivants du composant tELTMysqlMap : Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 814. Scnario 2 : ELT utilisant une table Alias, page 817.
810
Composants ELT
tELTMysqlInput
tELTMysqlInput
Proprits de tELTMysqlInput
Les composants tELTMysqlInput, tELTMysqlOutput, et tELTMysqlMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base MySQL afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fournit le schma de la table dentre la commande SQL qui sera excute. Permet dajouter autant de tables que ncessaires dans une commande Insert qui peut tre complexe. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Le schma dfini est ensuite pass au composant ELT Mapper afin de lutiliser dans la commande SQL Insert 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.
Utilisation
Lutilisation du composant tELTMysqlInput est troitement lie celle du tELTMysqlMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant le composant tELTMysqlInput, consultez les scnarios suivants du composant tELTMysqlMap : Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 814. Scnario 2 : ELT utilisant une table Alias, page 817.
811
Composants ELT
tELTMysqlMap
tELTMysqlMap
Proprits de tELTMysqlMap
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. 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 Encoding Adresse IP du serveur de base de donnes Numro de port dcoute du serveur de la base. Nom de la base de donnes Donnes dauthentification de lutilisateur de la base 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. Laperu est un clich des donnes traites dans le Mapper. Il apparat lorsque les proprits du Mapper ont t compltes. La synchronisation de laperu nest disponible quaprs avoir enregistrer les modifications. Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
Preview
Map editor
Utilisation
Lutilisation du composant tELTMysqlMap est troitement lie celle des composants tELTMysqlInput et tELTMysqlOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
812
Composants ELT
tELTMysqlMap
Connecter les composants ELT

Les composants ELT ne traitent pas les donnes en tant que telles mais les informations du schma descriptif de la table qui seront utilises pour alimenter les paramtres de la requte SQL excuter. Par consquent la connexion requise pour relier ces diffrents composants est simplement un lien qui porte le nom de la table.
Le nom de la sortie que vous donnez ce lien lors de sa cration doit correspondre exactement au nom de la table car ce paramtre sera utilis lors de la gnration de la commande SQL.
Voir galement : Connexion de type Link du Guide Utilisateur Talend Open Studio
Tables de jointure et de correspondance

Dans le Mapper ELT, vous pouvez slectionner des colonnes spcifiques des schmas dentre et les ajouter dans le schma de sortie. De la mme manire que dans lditeur du Mapper ETL, simplement glissez et dposez le contenu du schma dentre vers le schma de sortie. Utilisez les touches Ctrl et Maj pour la slection multiple des colonnes contigus ou non. Vous pouvez mettre en place des jointures explicites pour extraire des donnes varies de diffrentes tables. Cliquez sur la liste droulante Join et slectionnez une jointure explicite. Les jointures suivantes sont disponibles : Inner Join, Left Outer Join, Right Outer Join ou Full Outer Join et Cross Join. Par dfaut la jointure interne (Inner Join) est slectionne. Vous pouvez galement crer des tables Alias afin de slectionner des donnes varies dans une mme table. Dans la zone Input, cliquez sur le bouton plus (+) pour crer un Alias. Dfinissez la table sur laquelle lalias est bas. Saisissez un nom pour la table alias, de prfrence veillez ce quil soit diffrent de la table principale pour viter les confusions.
Ajouter des clauses Where

Vous pouvez galement restreindre la requte Select laide dune clause Where. Cliquez sur le bouton Add filter row situ en haut de la table de sortie et saisissez la condition que vous souhaitez appliquer. Veillez ce que les composants dentre soient tous lis correctement au composant ELT Map pour garantir que les inclusions, jointures et clauses fonctionnent.
813
Composants ELT
tELTMysqlMap
Gnrer la requte SQL

La mise en correspondance des lments partir des schmas dentre vers les schmas de sortie cre automatiquement la requte Select correspondante.
Les ventuelles clauses sont galement prises en compte automatiquement.
Scnario 1 : Agrger les colonnes dune table et appliquer un filtre

Le scnario suivant dcrit un Job rassemblant plusieurs schmas dune table en entre puis utilise une clause dans la requte SQL afin de filtrer les donnes en sortie.
Cliquez et dposez les composants suivants : tELTMysqlIntput, tELTMysqlMap, tELTMysqlOutput. Trois composants sont requis en entre pour ce Job. Connectez les trois composants ELT dentre au mapper ELT laide de liens dont le nom doit suivre strictement la nomenclature des tables de la base de donnes, dans cet exemple : owners, cars et resellers. Puis connectez le mapper ELT au composant de sortie ELT laide dun nouveau lien appel results dans cet exemple. Les trois schmas dentre sont stocks dans les mtadonnes (Metadata) du Repository. Ils peuvent donc facilement tre rutiliss.
814
Composants ELT
tELTMysqlMap
Cliquez sur le mapper ELT pour dfinir les informations de connexion la base de donnes. Les informations de connexion la base de donnes sont l encore stockes dans le Repository.
Lencodage par dfaut est utilis pour la base de donnes MySql. Ouvrez lditeur ELT Map pour mettre en place les jointures entre les tables dentre (Input). Glissez-dposez la colonne ID_Owner partir de la table Owners vers la colonne correspondante dans la table cars. Slectionnez loption de jointure INNER JOIN dans la table Cars, puis cochez la case Explicit Join en face de ID_Owners. Glissez la colonne ID_Resellers partir de la table Cars vers la table Resellers pour mettre en place la seconde jointure. Slectionnez nouveau loption de jointure INNER JOIN dans la table Resellers et cochez la case Explicit Join face la colonne correspondante. Puis slectionnez les colonnes agrger en sortie. Slectionnez toutes les colonnes des tables Cars et Owners et uniquement les colonnes Reseller_Name et City partir de la table Resellers. Glissez et dposez ces colonnes dans la table de sortie Results. La mise en correspondance apparat en jaune et les jointures en violet.
Composants ELT
tELTMysqlMap
Cliquez sur longlet Generated SQL Select query pour afficher la requte SQL correspondante.
Puis appliquez un filtre sur la table de sortie. Cliquez sur le bouton Add filter row de la table de sortie (output).
Conditionnez le Select laide dune clause Where comme suit : resellers.City ='West Coast City' Notez que la clause Where apparat dans longlet daperu de la requte SQL gnre.
Cliquez OK pour enregistrer le paramtrage de lELT Map. Configurez le composant de sortie ELT Output dans la vue Component du composant tELTMysqlOutput. Dans le champ Action on table slectionnez Drop and create table pour lexemple donn ci-dessous et dans ce cas, la seule action disponible sur les donnes est linsertion, donc slectionnez Insert. Le schma doit tre synchronis avec le composant tELTMysqlMap pour que les divers schmas source puissent tre agrgs.
816
Composants ELT
tELTMysqlMap
Toutes les donnes slectionnes sont insres dans la table results comme spcifi dans la requte SQL statement conditionne par la clause.
Scnario 2 : ELT utilisant une table Alias

Le scnario suivant dcrit un Job utilisant une table Alias. La table employees contient toutes les informations concernant les employes ainsi quun ID de leur responsable respectif, qui sont galement considrs comme des employs et par consquent inclus dans la table employees. La table dept contient les informations de lieu et de dpartement des employs de la base.
Glissez et dposez les composants tELTMysqlInput afin de collecter les schmas respectifs des tables employees et dept. Dans cet exemple, les deux schmas sont stocks dans le Repository et peuvent ainsi tre facilement rutiliss.
Puis slectionnez le composant tELTMysqlMap et configurez les informations de connexion la base Mysql.
817
Composants ELT
tELTMysqlMap
Ces informations de connexion sont l encore stockes dans la partie Metadata du Repository.
Cliquez sur le bouton [...] pour lancer lditeur ELT Map. Vrifiez dabord que la premire table dentre de la zone Input correspond votre flux principal car la russite des jointures en dpend. Dans cet exemple, la table employees devrait donc se trouver en premire position.
Glissez-dposez la colonne DeptNo partir de la table employees vers la table dept afin de mettre en place la jointure join entre les deux tables dentre. Cochez la case Explicit Join et dfinissez cette jointure comme Inner Join. Puis crez la table Alias base sur la table employees.
818
Composants ELT
tELTMysqlMap
Appelez cet alias Managers et cliquez OK pour lafficher comme nouvelle table dentre (Input) dans le mapper ELT. Glissez-dposez la colonne ID column partir de la table employees vers la colonne ID_Manager de la table alias Managers nouvellement cre. Cochez la case Explicit Join et dfinissez la comme Left Outer Join, afin que les rsultats de ce filtre soient rcuprs mme en cas de valeur Null.
Glissez-dposez le contenu des deux tables dentre, employees et dept, ainsi que la colonne Name partir de la table Manager vers la table de sortie (Output). Cliquez sur longlet Generated SQL Select query pour afficher la requte excuter.
819
Composants ELT
tELTMysqlMap
Puis cliquez sur le composant de sortie et configurez le champ Action on data sur Insert. Assurez-vous que le schma est synchronis avec la table de sortie du mapper ELT avant dexcuter le Job via la touche F6 ou via la barre doutils.
Linformation Department ainsi que les entres Employees sont associes dans la sortie, et la colonne Manager Name a pu tre rcupre grce la jointure explicite.
820
Composants ELT
tELTMysqlOutput
tELTMysqlOutput
Proprits de tELTMysqlOutput
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert dans la base de donnes Mysql Action on table Action on data En Java, utilisez le composant tCreateTable pour remplacer cette option. Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Note : dans les composants ELT Mysql, seule lopration Insert est disponible. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. 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. 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.
Utilisation
Lutilisation du composant tELTMysqlOutput est troitement lie celle des composants tELTMysqlInput et tELTMysqlMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
821
Composants ELT
tELTMysqlOutput
Scnarios associs
Pour des scnarios utilisant le composant tELTMysqlOutput, consultez les scnarios suivants du composant tELTMysqlMap : Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 814. Scnario 2 : ELT utilisant une table Alias, page 817.
822
Composants ELT
tELTOracleInput
tELTOracleInput
Proprits de tELTOracleInput
Les composants tELTOracleInput, tELTOracleOutput, et tELTOracleMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Oracle afin de gnrer des commandes Insert, Udpate ou Delete y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fournit le schma de la table dentre la commande SQL qui sera excute. Permet dajouter autant de tables que ncessaires dans une commande Insert qui peut tre complexe. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Le schma dfini est ensuite pass au composant ELT Mapper afin de lutiliser dans la commande SQL Insert. 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.
Utilisation
Lutilisation du composant tELTOracleInput est troitement lie celle du tELTOracleMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnario associ
Pour un scnario utilisant le composant tELTOracleInput, consultez le Scnario : Mettre jour les lignes dune base Oracle, page 826 du composant tELTOracleMap.
823
Composants ELT
tELTOracleMap
tELTOracleMap
Proprits de tELTOracleMap
Les composants tELTOracleInput, tELTOracleOutput, et tELTOracleMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Oracle afin de gnrer des commandes Insert, Update ou Delete y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. Use an existing connection Java uniquemen t 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. ELT Oracle Map Editor Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
824
Composants ELT
tELTOracleMap
Style link
Property type
Java uniquement
Connection type Host Port Database Username et Password Encoding
Liste droulante des pilotes disponibles. Adresse IP du serveur de base de donnes Numro de port dcoute du serveur de la base. Nom de la base de donnes Donnes dauthentification de lutilisateur de la base 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. 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 Java uniquemen t
Java uniquement
Use Hint Options
Cochez cette case afin dactiver la zone de configuration des hints, afin de vous permettre doptimiser lexcution dune requte. Dans cette zone, les paramtres sont : -HINT : spcifiez le hint dont vous avez besoin, laide de la syntaxe /*+ */. -POSITION : spcifiez o placer le hint dans linstruction SQL. -SQL STMT : slectionnez linstruction SQL utiliser.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Lutilisation du composant tELTOracleMap est troitement lie celle des composants tELTOracleInput et tELTOracleOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma. Composants Talend Open Studio 825
Composants ELT
tELTOracleMap

Pour plus dinformations concernant la connexion des composants ELT, consultez Connecter les composants ELT page 813. Voir galement : Connexion de type Link du Guide Utilisateur Talend Open Studio

Dans le Mapper ELT, vous pouvez slectionner des colonnes des schmas dentre et les intgrer dans le schma de sortie. Pour plus dinformations concernant la mise en correspondance et les jointures, consultez Tables de jointure et de correspondance page 813.

Pour plus dinformations sur la manipulation des clauses, consultez Ajouter des clauses Where page 813.
Gnrer la requte SQL

La mise en correspondance dlments des schmas dentre avec le schma de sortie cre automatiquement la requte Select correspondante. La/les clauses dfinies dans le mapper ELT sont galement intgres automatiquement dans la requte.
Scnario : Mettre jour les lignes dune base Oracle

Le scnario suivant est bas sur le Job dcrit dans la section des composants ELT MySQL, Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 814. Laction sur les donnes Update tant disponible en base Oracle, le scnario suivant dcrit un Job qui met jour une slection de lignes provenant de la table results, puis ajoute linformation model (modle) la colonne make (marque) de la table cars (vhicules).
826
Composants ELT
tELTOracleMap
Configurez les trois composants dentre tel que dcrit dans Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 814. Lors de cette tape de connexion des composants dentre ELT, assurez-vous que le nom des liens correspond exactement aux noms des tables de la base de donnes car ils seront utiliss comme paramtres dans la requte SQL gnre grce au mapper ELT. Enlevez la clause utilise pour filtrer les colonnes de sortie (si vous partez du scnario MySql indiqu en introduction). Ajoutez une nouvelle ligne de filtre la table de sortie pour tablir une relation entre tables dentre (owners) et de sortie (results) : owners.ID_OWNER=results.ID_OWNER
Puisque notre but est de mettre jour la table, enlevez toutes les colonnes de la table de sortie qui ne sont pas concernes par cette mise jour (Update). Puis mettez jour la colonne Make (marque) en ajoutant la mention C-Class prcde dune double barre verticale. Ajoutez galement la mention Sold by (Vendu par) devant le nom du revendeur dans la colonne reseller name (nom revendeur) de la table resellers. Vrifiez la requte Select gnre dans longlet Generated SQL select query.
Cliquez OK pour valider la configuration et fermer le mapper ELT. Veillez ce que les informations de connexion la base Oracle soient correctes dans longlet Basic Settings du composant tELTOracleMap. Puis slectionnez le composant tELTOracleOutput afin de dfinir les actions effectuer sur les donnes dans le champ Action on data.
827
Composants ELT
tELTOracleMap
Aucune action nest requise sur la table, mais par contre slectionnez Update dans le champ Action on data. Cliquez Edit schema pour vrifier que le schma correspond celui de la table de sortie configur dans le Mapper ELT. Dans le champ Where clause, entrez la clause supplmentaire suivante : results.MAKE= Mercedes. Puis appuyez sur F6 pour excuter le Job puis vrifiez la table results dans un client de base de donnes.
Le Job a donc excut la requte SQL gnre et effectu les mises jour des lignes concernes.
828
Composants ELT
tELTOracleOutput
tELTOracleOutput
Proprits de tELTOracleOutput
Les composants tELTOracleInput, tELTOracleOutput, et tELTOracleMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Oracle afin de gnrer des commandes Insert, Update ou Delete y compris des clauses, et ces commandes devront tre excutes dans la table de sortie dfinie.
Fonction Objectif Basic settings En Java, utilisez le composant tCreateTable pour remplacer cette option.
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert ou Update dans la base de donnes Oracle Action on table Sur la table dfinie, vous pouvez effectuer une des oprations suivantes : None : aucune opration de table effectuer. Drop and create the table : la table est supprime puis une nouvelle table est cre. Create a table : la table nexiste pas encore et doit donc tre cre. Si la table existe dj, une erreur est gnre et le Job sarrte. Create table if doesnt exist : Cre la table si ncessaire et effectue les actions sur les donnes. Clear a table : le contenu de la table est supprim. Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Update : Met jour des lignes existantes. Delete : Supprime les entres correspondantes au flux dentre. MERGE : met jour ou insre les donnes dans la table. Les options disponibles pour lopration MERGE diffrent de celles disponibles pour les oprations Insert, Update et Delete. 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 dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Loption MERGE est disponible en Java uniquement
Action on data
829
Composants ELT
tELTOracleOutput
Where clauses (for UPDATE and DELETE only) Java uniquement Use Merge Update (pour MERGE)
Saisissez la clause permettant de filtrer les donnes mettre jour ou supprimer lors des oprations de mise jour ou de suppression. Cochez cette case pour mettre jour des donnes de votre table de sortie. Column : Liste des colonnes du flux dentre. Update : Cochez la case correspondant au nom de la colonne que vous souhaitez mettre jour. Use Merge Update Where Clause : Cochez cette case et saisissez la clause WHERE permettant de filtrer les donnes mettre jour, si ncessaire. Use Merge Update Delete Clause : Cochez cette case et saisissez la clause WHERE permettant de filtrer les donnes supprimer et mettre jour, si ncessaire. Cochez cette case pour insrer des donnes dans la table. Column : Liste des colonnes du flux dentre. Check All : Cochez la case correspondant au nom de la colonne que vous souhaitez insrer. Use Merge Update Where Clause : Cochez cette case et saisissez la clause WHERE permettant de filtrer les donnes insrer. Saisissez le nom de la table par dfaut.
Java uniquement
Use Merge Insert (pour MERGE)
Default Table Name Java uniquement Encoding
Default Schema Name Saisissez le nom du schma Oracle par dfaut. 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.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTOracleOutput est troitement lie celle des composants tELTOracleInput et tELTOracleMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnario : Utiliser la fonction MERGE dOracle pour mettre jour et insrer simultanment des donnes
Le scnario suivant dcrit un Job trois composants ELT permettant de mettre jour les donnes dune table client grce la commande MERGE dOracle. Les informations des nouveaux clients sont ajoutes et celles des anciens sont mises jour.
830
Composants ELT
tELTOracleOutput
A partir du noeud Metadata du Repository : Sous le noeud correspondant la base de donnes contenant les tables utiliser pour ce scnario, slectionnez le schma de la table contenant les nouvelles donnes sur les clients et glissez dans lespace de modlisation. Dans ce scnario, le schma utilis se nomme NEW_CUSTOMERS_MLE. Dans la bote de dialogue [Components], slectionnez le composant tELTOracleInput et cliquez sur OK. Pour plus dinformations concernant les mtadonnes, consultez la section Dfinition des schmas de mtadonnes du Guide Utilisateur de Talend Open Studio. A partir de la Palette de composants : Glissez les composants tELTOracleMap et tELTOracleOutput dans lespace de modlisation. Pour relier les composants entre eux : Cliquez-droit sur le composant dentre, NEW_CUSTOMERS_MLE, glissez jusquau tELTOracleMap et relchez le bouton droit pour crer le lien. De la mme manire, connectez le tELTOracleMap au tELTOracleOutput laide dun nouveau lien appel RESULTS dans cet exemple. Double-cliquez sur le composant dentre pour afficher ses proprits dans la vue Components.
Dans la liste Schema, slectionnez Repository si vous avez stock le schma de votre table dans le rpertoire Metadata du Repository ou slectionnez Built-in et configurez-le manuellement en cliquant sur le bouton [...] ct du champ Edit schema. Le schma est configur comme suit :
831
Composants ELT
tELTOracleOutput
Dans le champ Default Table Name, saisissez entre guillemets le nom de la table source. Ici, la table utilise se nomme NEW_CUSTOMERS_MLE. Dans le champ Default Schema Name, saisissez entre guillemets le nom du schma source. Ici, le schma utilis se nomme ROOT. Cliquez sur le tELTOracleMap et sur la vue Component pour afficher les proprits de base du composant.
Cochez la case Use an existing connection et slectionnez le composant tOracleConnection dans la liste Component list si vous souhaitez utiliser la connexion ouverte par un composant de connexion. Dans la liste Property Type, slectionnez Repository et cliquez sur le bouton [...] pour slectionner la connexion la base de donnes contenant les tables utilises dans ce scnario. Les champs suivants seront automatiquement renseigns avec les informations de connexion cette base de donnes. Si vous navez pas cr de mtadonnes avec ces informations, slectionnez le mode Built-in dans la liste Property Type et renseignez-les manuellement.
832
Composants ELT
tELTOracleOutput
Pour plus dinformations concernant les mtadonnes, consultez la section Dfinition des schmas de mtadonnes du Guide Utilisateur de Talend Open Studio. Cliquez sur le bouton [...] correspondant au champ ELT Oracle Map Editor pour ouvrir lditeur permettant de faire les correspondances entre le flux dentre et le flux de sortie.
Cliquez sur le bouton [+] en haut gauche de lditeur pour ouvrir la bote de dialogue permettant dajouter lalias correspondant la table dentre.
Dans la bote de dialogue Add a new alias :
833
Composants ELT
tELTOracleOutput
Slectionnez le nom du flux de la table dentre dans la liste Select the table to use. Ici, nous avons slectionn ROOT.NEW_CUSTOMERS_MLE. Saisissez le nom que vous souhaitez donner lalias correspondant dans le champ Type in a valid alias. Ici, nous avons nomm lalias new_customers.
Lalias nest pas obligatoire quand la table en entre nest utilise quune seule fois dans le tMap.
Cliquez sur OK. Dans lditeur du tELTOracleMap, slectionnez toutes les colonnes de la table dentre et glissez-les dans la table de sortie, RESULTS. Cliquez sur longlet Generated SQL Select query pour afficher la requte excuter.
Cliquez sur OK. Dans lespace de modlisation, double-cliquez sur le composant tELTOracleOutput pour paramtrer ses proprits dans la vue Component.
Dans la liste Action on data, slectionnez MERGE. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent ou paramtrez manuellement le schma de sortie en slectionnant Built-in dans la liste Schema et en cliquant sur le bouton [...] ct du champ Edit schema. Cochez la case Use Merge Update pour mettre jour les donnes grce la fonction MERGE dOracle.
834
Composants ELT
tELTOracleOutput
Dans le tableau qui apparat, cochez les cases correspondant aux colonnes que vous souhaitez mettre jour. Nous souhaitons mettre jour les donnes client en fonction de leur ID. Ainsi, cochez toutes les cases sauf celle correspondant la colonne ID.
Les colonnes dfinies comme cl primaire NE PEUVENT PAS et NE DOIVENT PAS faire lobjet dune mise jour.
Cochez les cases Use Merge Update Where Clause et Use Merge Update Delete Clause si vous souhaitez utiliser une clause WHERE pour filtrer les donnes mettre jour et une clause DELETE WHERE pour supprimer les donnes avant de rinsrer les donnes mises jour, lors de lopration de MERGE.
Cochez la case Use Merge Insert pour insrer de nouvelles donnes en mme temps que de mettre jour les anciennes grce la fonction MERGE dOracle. Dans le tableau qui apparat, cochez les cases correspondant aux colonnes que vous souhaitez insrer. Nous souhaitons insrer toutes les nouvelles donnes client. Ainsi, cochez toutes les cases correspondant de toutes les colonnes insrer. Cochez la case Use Merge Insert Where Clause si vous souhaitez utiliser une clause WHERE pour filtrer les donnes insrer lors de lopration de MERGE. Dans le champ Default Table Name, saisissez entre guillemets le nom de la table source. Ici, la table utilise se nomme NEW_CUSTOMERS_MLE Dans le champ Default Schema Name, saisissez entre guillemets le nom du schma source. Ici, le schma utilis se nomme ROOT. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
835
Composants ELT
tELTOracleOutput
Les donnes sont mises jour et insres dans la base de donnes et la requte utilise saffiche dans la console. Pour un scnario utilisant le composant tELTOracleOutput, consultez le Scnario : Mettre jour les lignes dune base Oracle, page 826 du composant tELTOracleMap.
836
Composants ELT
tELTPostgresqlInput
tELTPostgresqlInput
Proprits de tELTPostgresqlInput
Les composants tELTPostgresqlInput, tELTPostgresqlOutput, et tELTPostgresqlMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Postgresql afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Default Schema Name Saisissez le nom du schma par dfaut. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTPostgresqlInput est troitement lie celle du tELTPostrgesqlMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTPostgresqlInput, consultez les scnarios suivants du composant tELTPostgresqlMap :
837
Composants ELT
tELTPostgresqlInput
838
Composants ELT
tELTPostgresqlMap
tELTPostgresqlMap
Proprits de tELTPostgresqlMap
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. Use an existing connection Cochez cette case et slectionnez le composant tPostgresqlConnection 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. ELT Postgresql Map Editor Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
839
Composants ELT
tELTPostgresqlMap
Style link
Property type
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Lutilisation du composant tELTPostgresqlMap est troitement lie celle des composants tELTPostgresqlInput et tELTPostgresqlOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
840
Composants ELT
tELTPostgresqlOutput
Proprits de tELTPostgresqlOutput
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert dans la base de donnes Postgresql. Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Note : dans les composants ELT Postrgesql, seule lopration Insert est disponible. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. 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. Default Table Name Saisissez le nom de la table par dfaut.
Default Schema Name Saisissez le nom du schma par dfaut. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTPostgresqlOutput est troitement lie celle des composants tELTPostgresqlInput et tELTPostgresqlMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
841
Composants ELT
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTPostgresqlOutput, consultez les scnarios suivants du composant tELTMysqlMap : Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 814. Scnario 2 : ELT utilisant une table Alias, page 817.
842
Composants ELT
tELTRollback
tELTRollback
Proprits du tELTRollback
Ce composant est troitement li au composant tELTCommit et au composant ELT de connexion correspondant la base de donnes sur laquelle vous travaillez. Ils sont gnralement utiliss ensemble lors de transactions.
Famille du composant Databases/ELT
Le tELTRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Database Type Component list Slectionnez dans le menu droulant le type de base de donnes sur lequel vous voulez travailler. Slectionnez le composant ELT de connexion le plus pertinent 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 SQL Template
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. SQLTemplate List Cliquez sur le bouton Add pour ajouter un ou plusieurs modle SQL du systme la liste SQLTemplateList. Cliquez dans la cellule de la colonne SQLTemplate List que vous venez dajouter et slectionnez le modle SQL du systme adquat dans la liste de modles fournis par Talend. Note : Vous pouvez crer vos propres modles SQL et les ajouter la liste SQLTemplate List. Pour crer un nouveau modle SQL : 1- Slectionnez un modle dj existant dans la liste SQLTemplate list et cliquez dans son code dans le champ de code. Une bote de dialogue souvrira vous demandant de crer un nouveau modle. 2- Cliquez sur Yes pour ouvrir la bote de dialogue New SQLTemplate. 3- Renseignez les informations de votre modle SQL et cliquez sur Finish pour fermer la bote de dialogue. Un diteur de modle SQL apparat dans lequel vous pouvez saisir votre code. 4- Cliquez sur le bouton Add pour ajouter le nouveau modle dans la liste SQLTemplate list. Pour plus dinformations, consultez la section Utilisation des SQL Templates, page 123 du Guide Utilisateur Talend Open Studio.
Utilisation
Il faut utiliser ce composant en association avec des composants ELT, notamment avec le tELTCommit et le composant ELT de connexion correspondant la base de donnes avec laquelle vous travaillez. Composants Talend Open Studio 843
Composants ELT
tELTRollback
Limitation
n/a
Scnario associ
Pour un scnario associ au tELTRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 524 du composant tMySQLRollback.
844
Composants ELT
tELTSybaseInput
tELTSybaseInput
Proprits de tELTSybaseInput
Les composants tELTSybaseInput, tELTSybaseOutput, et tELTSybaseMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Sybase afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Default Schema Name Saisissez le nom du schma Sybase par dfaut. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTSybaseInput est troitement lie celle du tELTSybaseMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant le composant tELTSybaseInput, consultez les scnarios suivants du composant tELTMysqlMap :
Composants ELT
tELTSybaseInput
846
Composants ELT
tELTSybaseMap
tELTSybaseMap
Proprits de tELTSybaseMap
Les composants tELTSybaseInput, tELTSybaseOutput, et tELTSybaseMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Sybase afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. Use an existing connection Cochez cette case et slectionnez le composant tSybaseConnection 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. ELT Sybase Map Editor Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
847
Composants ELT
tELTSybaseMap
Style link
Property type
Adresse IP du serveur de base de donnes Numro de port dcoute du serveur de la base. Nom de la base de donnes Donnes dauthentification de lutilisateur de la base 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.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTSybaseMap est troitement lie celle des composants tELTSybaseInput et tELTSybaseOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
848
Composants ELT
tELTSybaseOutput
tELTSybaseOutput
Proprits de tELTSybaseOutput
Les composants tELTSybaseInput, tELTSybaseOutput, et tELTSybaseMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Sybase fin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert dans la base de donnes Sybase. Action on table Action on data En Java, utilisez le composant tCreateTable pour remplacer cette option. Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Note : dans les composants ELT Sybase, seule lopration Insert est disponible. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. 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. Default Table Name Saisissez le nom de la table par dfaut.
Default Schema Name Saisissez le nom du schma Sybase par dfaut. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTSybaseOutput est troitement lie celle des composants tELTSybaseInput et tELTSybaseMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
849
Composants ELT
tELTSybaseOutput
Scnarios associs
850
Composants ELT
tELTTeradataInput
tELTTeradataInput
Proprits de tELTTeradataInput
Les composants tELTTeradataInput, tELTTeradataOutput, et tELTTeradataMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Teradata afin de gnrer des commandes Insert y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fournit le schma de la table dentre la commande SQL qui sera excute. Permet dajouter autant de tables que ncessaires dans une commande Insert qui peut tre complexe. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Le schma dfini est ensuite pass au composant ELT Mapper afin de lutiliser dans la commande SQL Insert 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.
Utilisation
Lutilisation du composant tELTTeradataInput est troitement lie celle du tELTTeradataMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant le composant tELTTeradataInput, consultez les scnarios suivants du tELTTeradataMap : Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 814. Scnario 2 : ELT utilisant une table Alias, page 817.
851
Composants ELT
tELTTeradataMap
tELTTeradataMap
Proprits de tELTTeradataMap
Les composants tELTTeradataInput, tELTTeradataOutput, et tELTTeradataMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Teradata afin de gnrer des commandes Insert y compris des clauses, et ces commandes devront tre excutes dans la table de sortie dfinie.
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. 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 Encoding Adresse IP du serveur de base de donnes Numro de port dcoute du serveur de la base. Nom de la base de donnes Donnes dauthentification de lutilisateur de la base 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. Laperu est un clich des donnes traites dans le Mapper. Il apparat lorsque les proprits du Mapper ont t compltes. La synchronisation de laperu nest disponible quaprs avoir enregistrer les modifications. Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
Preview
Map editor
Utilisation
Lutilisation du composant tELTTeradataMap est troitement lie celle des composants tELTTeradataInput et tELTTeradataOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
852
Composants ELT
tELTTeradataMap

Pour plus dinformations concernant la connexion des composants ELT, consultez Connecter les composants ELT page 813. Voir galement : Connexion de type Link du Guide Utilisateur Talend Open Studio

Dans le Mapper ELT, vous pouvez slectionner des colonnes des schmas dentre et les intgrer dans le schma de sortie. Pour plus dinformations concernant la mise en correspondance et les jointures, consultez Tables de jointure et de correspondance page 813.

Pour plus dinformations sur la manipulation des clauses, consultez Ajouter des clauses Where page 813.
Gnrer la requte SQL

La mise en correspondance dlments des schmas dentre avec le schma de sortie cre automatiquement la requte Select correspondante. La/les clauses dfinies dans le mapper ELT sont galement intgres automatiquement dans la requte.
Scnarios associs
853
Composants ELT
tELTTeradataOutput
tELTTeradataOutput
Proprits de tELTTeradataOutput
Les composants tELTTeradataInput, tELTTeradataOutput, et tELTTeradataMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Teradata afin de gnrer des commandes Insert y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert ou Update dans la base de donnes Teradata Action on table Action on data En Java, utilisez le composant tCreateTable pour remplacer cette option. Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Dans les composants ELT Teradata, seule lopration Insert est disponible. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. 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. 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.
Utilisation
Lutilisation du composant tELTTeradataOutput est troitement lie celle des composants tELTTeradataInput et tELTTeradataMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
854
Composants ELT
tELTTeradataOutput
Scnarios associs
855
Composants ELT
tELTTeradataOutput
856
Composants File
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille File de la Palette de Talend Open Studio. La famille File regroupe les composants qui lisent et crivent des donnes dans tous types de fichiers un seul ou plusieurs schmas, du plus courant au format le plus spcifique (dans les sous-familles Input et Output). De plus, la sous-famille Management regroupe des composants ddis aux fichiers qui peuvent effectuer diverses traitements sur les fichiers, notamment la dcompression, la suppression, la copie, la comparaison de fichiers, etc.
Composants File
tAdvancedFileOutputXML
tAdvancedFileOutputXML appartient deux familles de composants : File et XML. Pour plus dinformations concernant le composant tAdvancedFileOutputXML, consultez tAdvancedFileOutputXML page 1304.
858
Composants File
tApacheLogInput
tApacheLogInput
Proprits du tApacheLogInput
Component family File/Input
Fonction Objectif
Le composant tApacheLogInput permet de lire le fichier de log daccs dun serveur Apache. Le tApacheLogInput aide la gestion effective du serveur Apache. Il est obligatoire lorsquil sagit dobtenir un retour sur lactivit et les performances du serveur, mais aussi sur les problmes susceptibles de se produire. 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. 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 rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. File Name Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables 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.
Basic settings
Utilisation
Ce composant peut tre utilis en standalone. Il permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1330 du composant tFileInputXML. n/a
Limitation
859
Composants File
tApacheLogInput
Scnario : Lire un fichier de log daccs Apache

Le scnario suivant cre un Job deux composants permettant de lire le fichier de log daccs dun serveur Apache et dafficher les donnes en sortie dans la console de log Run. A partir de la Palette, cliquez-dposez les composants tApacheLogInput et tLogRow dans lditeur graphique. Cliquez droit sur le tApacheLogInput et slectionnez une connexion Row > Main dans le menu contextuel. Cliquez ensuite sur le tLogRow, le lien appropri apparat entre les deux composants.
Dans lditeur graphique, slectionnez le tApacheLogInput. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du composant tApacheLogInput.
Configurer les champs Property Type et Schema Type en mode Built-In. Cliquez sur le bouton Edit schema si vous souhaitez voir les colonnes (en mode read-only). Dans le champ File Name, renseignez le chemin daccs ou parcourez vos dossiers jusquau fichier de log daccs que vous voulez lire. Dans lditeur graphique, slectionnez le composant tLogRow et cliquez sur la vue Component pour un dfinir la configuration de base (Basic settings). Pour plus dinformations, consultez le composant tLogRow, page 1095. Appuyez sur F6 pour excuter le Job.
860
Composants File
tApacheLogInput
Les lignes de log du fichier dfini sont affiches dans la console.
861
Composants File
tCreateTemporaryFile
Proprits du tCreateTempraryFile
Famille du composant File/Management
Fonction Objectif
Le composant tCreateTemporaryFile permet de crer et dorganiser les fichiers temporaires. Le tCreateTemporaryFile aide la cration dun fichier temporaire et sa redirection dans dossier dfini. Ce composant permet galement de conserver ou de supprimer ce fichier temporaire, selon le cas, aprs lexcution du Job. Remove file when execution is over Directory Template Suffix Cochez cette case pour que le fichier temporaire soit supprim aprs lexcution du Job. Renseignez le chemin daccs au dossier o sont stocks les fichiers temporaires. Attribuez un nom au fichier temporaire en respectant le modle. Entrez une extension de fichier pour prciser le format que vous voulez donner au fichier temporaire.
Basic settings
Utilisation
Le composant tCreateTemporaryFile vous donne la possibilit de grer vos fichiers temporaires pour que la mmoire soit libre au profit dautres projets, ce qui permet doptimiser les performances systme.
Scnario : Crer un fichier temporaire et y crire des donnes

Le scnario suivant dcrit un Job simple permettant de crer un fichier temporaire vide dans un dossier dfini, puis dy crire des donnes et enfin de le supprimer aprs lexcution du Job. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tCreateTemporaryFile, le tRowgenerator, le tFileOutputDelimited, le tFileInputDelimited et le tLogRow. Reliez le tCreateTemporaryFile au tRowGenerator laide dun lien de type SubJobOk. Reliez le tRowGenerator au tFileOutputDelimited laide dun lien de type Row Main. Reliez le tRowGenerator au tFileInputDelimited laide dun lien de type SubJobOk. Reliez le tFileInputDelimited au tLogRow laide dun lien de type Row Main.
862
Composants File
Dans lditeur graphique, slectionnez le composant tCreateTemporaryFile. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tCreateTemporaryFile.
Cochez la case Remove file when execution is over pour supprimer, aprs lexcution du Job, le fichier temporaire cr. Cliquez sur le bouton [...] ct du champ Directory pour parcourir vos dossiers jusqu celui o seront stocks les fichiers temporaires. Vous pouvez galement entrer directement le chemin daccs. Dans le champ Template, renseignez le nom du fichier temporaire en veillant ce quil respecte le format du modle. Dans le champ Suffix, renseignez lextension du fichier pour indiquer le format que vous voulez donner au fichier temporaire. Dans lditeur graphique, slectionnez le tRowGenerator puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
863
Composants File
Dans la liste droulante Schema Type, choisissez le mode Built-In. Cliquez sur le bouton [...] du champ Edit schema pour dfinir les donnes passer au composant tFileOutputDelimited. Dans cet exemple, seules les donnes de la colonne value sont traites.
Cliquez sur OK pour fermer la bote de dialogue. Cliquez sur le bouton [...] du champ RowGenerator Editor pour ouvrir la bote de dialogue de lditeur.
Dans le champ Number of Rows for Rowgenerator, entrez le chiffre 5 pour gnrer cinq lignes puis cliquez sur Ok pour fermer la bote de dialogue. Dans lditeur graphique, slectionnez le tFileOutputDelimited puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
864
Composants File
Dans la liste droulante Property Type, choisissez le mode Built-In. Cliquez dans le champ File Name puis appuyez simultanment sur Ctrl+Espace pour accder la liste dauto-compltion. Pour envoyer les donnes en sortie vers le fichier temporaire cr, slectionnez loption tCreateTemporaryFile_1.FILEPATH dans la liste des variables. Renseignez les sparateurs de lignes et de champs dans leurs champs respectifs Row Separator et Field Separator. Choisissez le mode Built-In dans la liste droulante Schema puis cliquez sur Sync columns pour synchroniser les colonnes dentre et de sortie. Notez que la connexion Row permet dalimenter automatiquement le schma de sortie. Pour plus dinformations sur les types de schmas, consultez les chapitres Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Dans lditeur graphique, slectionnez le composant tFileInputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileInputDelimited.
Choisissez le mode Built-in dans la liste droulante Property Type. Cliquez dans le champ File Name puis appuyez simultanment sur Ctrl+Espace pour accder la liste dauto-compltion. Pour lire les donnes du fichier temporaire cr, slectionnez tCreateTemporaryFile_1.FILEPATH dans la liste des variables. Renseignez les sparateurs de lignes et de champs dans leurs champs respectifs Row Separator et Field Separator.
865
Composants File
Dans la liste droulante Schema, choisissez le mode Built-In puis cliquez sur le bouton [...] du champ Edit schema pour dfinir les donnes passer au composant tLogRow. Dans cet exemple, le schma est compos de la seule colonne value. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
Le fichier temporaire est cr, lors de lexcution du Job, dans le dossier qui a t dfini et les cinq lignes gnres sont inscrites dans ce fichier. Le fichier temporaire est supprim aprs lexcution du Job.
866
Composants File
tFileArchive
tFileArchive
Proprits du tFileArchive
Famille de composant File/Management
Fonction
Le composant tFileArchive zippe un ou plusieurs fichier(s) en fonction des paramtres dfinis et place larchive cre dans le rpertoire souhait. Ce composant zippe un ou plusieurs fichier(s) pour un ventuel traitement. Directory Rpertoire dans lequel le fichier zipp sera plac. Subdirectories (en Perl, ce champ se nomme Include subdirectories) : Cochez cette case si le ou les rpertoire(s) slectionn(s) contiennent des sous-dossiers. Rpertoire de destination et nom du fichier archive. Choisissez le niveau de compression que vous souhaitez appliquer. Best : la qualit de compression sera optimale mais le temps de compression sera long. Normal : qualit et temps de compression intermdiaires. Fast : la compression sera rapide mais la qualit de compression sera amoindrie. Cochez cette case si vous souhaitez que tous les fichiers du dossier soient zipps. Dcochez-la pour spcifier dans le tableau Files le ou les fichier(s) que vous dsirez zipper. Filemask : entrez un nom de fichier ou masque de fichier utilisant un caractre spcial ou une expression rgulire. Cochez cette case pour crer un nouveau dossier si votre dossier de destination nexiste pas. 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. Cochez cette case pour collecter les donnes de log au niveau du composant.
Archive file Compress level
All files
Java uniquement
Create directory if not exists Encoding type
Ce composant doit tre utilis en standalone. n/a
867
Composants File
tFileArchive
Scnario : Zipper des fichiers laide dun tFileArchive

Ce scnario met en scne un Job form dun composant unique. Il a pour but de zipper des fichiers et de les enregistrer dans le rpertoire choisi. Cliquez-dposez le composant tFileArchive de la Palette dans lespace de modlisation graphique. Double-cliquez sur le composant afin dafficher sa vue Component.
Dans le champ Directory, cliquez sur [...], parcourez votre rpertoire et slectionnez le dossier ou le fichier que vous souhaitez compresser. Cochez la case Subdirectories si vous dsirez inclure dans larchive les fichiers des sous-dossiers. Renseignez ensuite le champ Archive file, en indiquant le rpertoire de destination et le nom de votre archive. Cochez la case Create directory if not exists si votre rpertoire de destination nexiste pas encore et que vous souhaitez le crer. Dans la liste Compress level, slectionnez le niveau de compression que vous dsirez appliquer votre archive. Dans cet exemple, nous avons choisi dutiliser le niveau normal. Dcochez la case All Files si vous ne souhaitez compresser que des fichiers spcifiques.
Ajoutez une ligne dans le tableau laide du bouton [+], et cliquez sur le nom qui saffiche. Saisissez entre toiles une partie du nom du ou des fichier(s) que vous souhaitez compresser. Appuyez sur F6 afin dexcuter votre Job.
868
Composants File
tFileArchive
Le tArchiveFile a compress les fichiers slectionns et a cr le dossier dans le rpertoire indiqu.
869
Composants File
tFileCompare
tFileCompare
Proprits du tFileCompare
Le composant tFileCompare compare deux fichiers et fournit des informations de comparaison (en fonction dun schma en lecture seule). Ce composant permet de contrler la qualit des donnes des fichiers traits. 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 mais pour ce composant le schma est en lecture seule. Le chemin daccs au fichier vrifier. Le chemin daccs du fichier sur lequel la comparaison est bas. Saisissez le message afficher dans la console Run en fonction du rsultat de la comparaison.
File to compare Reference file If differences are detected, display If no difference detected, display Print to console Utilisation
Cochez cette case pour afficher le message saisi.
Ce composant peut tre utilis en standalone mais il est gnralement reli un composant de sortie pour regrouper les informations de comparaison. n/a
Limitation
Scnario : Comparer des fichiers dzipps

Ce scnario dcrit un Job permettant de dzipper un fichier et de le comparer avec un fichier de rfrence pour sassurer quil na pas t modifi. La sortie de cette comparaison est stocke dans un fichier dlimit et un message est affich dans la console.
Cliquez et dposez les composants suivants : tFileUnarchive, tFileCompare et tFileOutputDelimited.
870
Composants File
tFileCompare
Reliez les composants tFileUnarchive et tFileCompare laide dune connexion de type Iterate. Connectez le composant tFileCompare au composant de sortie laide dun lien Main row. Dans longlet Basic settings du composant tFileUnarchive, renseignez le chemin daccs au fichier dzipper. Dans le champ Extraction Directory, renseignez le chemin de destination du fichier dzipp. Dans longlet Basic settings du composant tFileCompare, paramtrez les proprits du fichier comparer. Dans le champ File to compare, appuyez sur Ctrl+Espace pour afficher la liste des variables globales. Slectionnez $_globals{tFileUnarchive_1}{CURRENT_FILEPATH} ou "((String)globalMap.get("tFileUnarchive_1_CURRENT_FILEPATH"))" en fonction du langage avec lequel vous travaillez, pour rcuprer le chemin daccs du fichier partir du composant tFileUnarchive.
Puis dans le champ Reference file, paramtrez le fichier de rfrence sur lequel est bas la comparaison. Dans les champs If differences detected, display et If no differences detected, dispay, paramtrez les messages afficher lorsque les fichiers sont diffrents et lorsquils sont identiques, par exemple : '[Job '.$_globals{Job_name}.'] Files differ' si vous travaillez en Perl ou "[Job " + JobName + "] Files differ" si vous travaillez en Java. Cohez la case Print to Console, pour que le message dfini apparaisse la fin de lexcution du Job. Le schma est en lecture seule et contient les informations standard. Cliquez sur Edit schema pour le consulter.
871
Composants File
tFileCompare
Puis paramtrez le composant de sortie en utilisant des points-virgules comme sparateurs de donnes. Enregistrez le Job et appuyez sur F6 pour lexcuter.
Le message paramtr apparat dans la console et la sortie contient les informations telles quelles ont t dfinies dans le schma.
872
Composants File
tFileCopy
tFileCopy
Proprits du tFileCopy
Le composant tFileCopy fait une copie dun fichier source dans un rpertoire cible et peut supprimer le fichier source, si ncessaire. Ce composant permet de rationnaliser les traitements en effectuant des tches rcurrentes et fastidieuses de manire automatique. File Name Destination Remove source file Replace existing file Chemin daccs au fichier copier ou dplacer. Chemin daccs du rpertoire dans lequel le fichier est copi ou dplac. Cochez cette case pour dplacer le fichier. Cochez cette case pour craser le fichier dj existant.
Ce composant peut tre utilis en standalone. n/a
Scnario : Rcuprer un fichier de la corbeille

Ce scnario dcrit un Job faisant une boucle sur une liste de fichiers, copie chaque fichier du rpertoire source vers le rpertoire cible. Puis il supprime les fichiers copis du rpertoire source.
Cliquez-dposez les composants tFileList et tFileCopy. Reliez-les laide dune connexion Iterate. Dans longlet Basic settings du composant tFileList, spcifiez le rpertoire sur lequel sera effectue la boucle.
873
Composants File
tFileCopy
Dans le champ Filemask, paramtrez le masque du fichier en *.txt pour ne tenir compte que des fichiers avec cette extension. Dans cet exemple, la casse nest pas prise en compte, ainsi dans la liste droulante Case Sensitive, slectionnez loption No. Puis slectionnez le composant tFileCopy et paramtrez ses proprits dans longlet Basic settings.
Dans le champ File Name, appuyez sur Ctrl+Espace pour accder la liste des variables. Slectionnez la variable globale ((String)globalMap.get("tFileList_1_CURRENT_FILEPATH")) si vous travaillez en Java, ou $_globals{tFileList_1}{CURRENT_FILEPATH} si vous travaillez en Perl. De cette manire, tous les fichiers du rpertoire source peuvent tre traits. Cochez la case Remove Source file pour supprimer le fichier ayant t copi. Cochez la case Replace existing file pour craser tout fichier dj existant dans le rpertoire de destination. Enregistrez le Job et appuyez sur F6. Les fichiers sont copis dans le rpertoire de destination et supprims du rpertoire source.
874
Composants File
tFileDelete
tFileDelete
Proprits du tFileDelete
Fonction Objectif Basic settings Utilisation Limitation
Le composant tFileDelete supprime un fichier dun rpertoire spcifi. Ce composant permet de rationnaliser les traitements en effectuant des tches rcurrentes et fastidieuses de manire automatique. File Name Chemin daccs au fichier supprimer.
Scnario : Supprimer des fichiers

Ce scnario dcrit un Job trs simple supprimant des fichiers dun rpertoire donn.
Cliquez et dposez les composants suivants : tFileList, tFileDelete, tJava. Dans le champ Directory de longlet Basic settings du composant tFileList, spcifiez le rpertoire sur lequel la boucle doit tre effectue.
Dans le champ Filemask, paramtrez le masque de fichier en *.txt. Ne cochez aucune case. Dans longlet Basic settings du composant tFileDelete, paramtrez le champ File Name afin que le fichier slectionn par le composant tFileList soit supprim. Ceci permet de supprimer tous les fichiers dun rpertoire spcifi.
875
Composants File
tFileDelete
Appuyez sur Ctrl+Espace pour accder la liste des variables globales. En Java, la variable adquate permettant de rcuprer le fichier en cours est : ((String)globalMap.get("tFileList_1_CURRENT_FILEPATH")). Puis dans le composant tJava, dfinissez le message afficher dans la sortie standard (la console Run). Dans cet exemple Java, saisissez le script suivant dans le champ Code : System.out.println( ((String)globalMap.get("tFileList_1_CURRENT_FILE")) + " has been deleted!" ); Puis enregistrez le Job et appuyez sur F6 pour lexcuter.
Le message dfini dans le composant tJava apparat dans la console pour chaque fichier supprim laide du composant tFileDelete.
876
Composants File
tFileExist
tFileExist
Proprits du tFileExist
Fonction Objectif
Le composant tFileExist vrifie si un fichier existe ou non. Le tFileExists aide rationaliser les processus en automatisant les tches rcurrentes et fastidieuses, comme par exemple vrifier si un fichier existe ou non. File Name Chemin daccs au fichier dont vous voulez vrifier lexistence.
Basic settings Utilisation Limitation
Scnario : Vrifier lexistence dun fichier et le crer sil nexiste pas

Ce scnario dcrit un Job simple qui permet de vrifier si le fichier spcifi existe, dafficher un message lcran si le fichier nexiste pas, de lire les donnes dun autre fichier dentre spcifi et de les crire dans un fichier dlimit en sortie. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tFileExist, le tFileInputDelimited, le tFileOutputDelimited et le tMsgBox. Reliez dabord le tFileExist au tFile InputDelimited laide dun lien de type OnSubJobOk, puis au tMsBox laide dun lien de type Run If.
Reliez le tFileInputDelimited au tFileOutputDelimite laide dun lien de type Row Main. Dans lditeur graphique, slectionnez le tFileExist puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
877
Composants File
tFileExist
Dans le champ File name, renseignez le chemin daccs au fichier ou parcourez vos dossiers la recherche du fichier dont vous voulez vrifier lexistence. Dans lditeur graphique, slectionnez le composant tFileInputDelimited puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
Remplissez le champ File Name en parcourant vos dossiers jusquau fichier dentre que vous voulez lire. Dfinissez les sparateurs de lignes et de champs dans leurs champs respectifs Row separator et Field Separator. Dfinissez le nombre de lignes den-tte (Header), de pied de page (Footer) et le nombre maximal de lignes traiter (Limit) en fonction de vos besoins. Dans ce scnario, notre tableau comporte une ligne den-tte. Dans la liste droulante Schema, choisissez le mode Built-In. Cliquez ensuite sur le bouton [...] du champ Edit schema pour dfinir les donnes passer au composant tFileOutputDelimited. Dfinissez les donnes prsentes dans le fichier lire (file2 dans ce scnario). Pour plus dinformations sur les types de schmas, consultez les chapitres Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
878
Composants File
tFileExist
Le schma du fichier file2 est compos de cinq colonnes : Num, Ref, Price, Quant et Tax. Dans lditeur graphique, slectionnez le composant tFileOutputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileOutputDelimited.
Dfinissez le champ Property Type en mode Build in. Dans le champ File name, appuyez simultanment sur Ctrl+Espace pour accder la liste des variables et slectionner FILENAME. Dfinissez les sparateurs de lignes et de champs dans leurs champs respectifs Row separator et Field Separator. Cochez la case Include Header car, dans cet exemple, le fichier file2 comprend un en-tte. Dfinissez le champ Schema en mode Built in puis cliquez sur le bouton Sync columns pour synchroniser le schma du fichier de sortie (file1) avec le schma du fichier dentre (file2).
879
Composants File
tFileExist
Dans lditeur graphique, slectionnez le composant tMsBox. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tMsBox.
Cliquez sur le lien If pour en afficher les proprits dans la vue Basic settings. Dans le panneau Condition, appuyez simultanment sur Ctrl+Espace pour accder la liste de variable et slectionner EXISTS. Entrez un point dexclamation avant la variable pour en inverser le sens.
Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
880
Composants File
tFileExist
Une bote de dialogue apparat pour confirmer que le fichier nexiste pas. Cliquez sur OK pour fermer cette bote de dialogue et continuer lexcution du Job. Le fichier manquant, file1 dans cet exemple, est crit sous la forme dun fichier dlimit lendroit pralablement dtermin.
881
Composants File
tFileInputARFF
tFileInputARFF
Proprits du tFileInputARFF
Famille de composant File/Input
Fonction Objectif
Le composant tFileInputARFF lit un fichier ARFF ligne ligne et spare des champs simples. Ce composant ouvre un fichier et le lit ligne par ligne afin de le diviser en champs et denvoyer ces champs au composant suivant, comme dfini par le schma, via une connexion Row. 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 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. File Name Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. 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. 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.
Basic settings
882
Composants File
tFileInputARFF
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 de base de donnes. Cochez cette case pour collecter les informations de log au niveau du composant.
tStatCatcher Statistics Utilisation
Utilisez ce composant pour lire un fichier et sparer les champs laide du sparateur spcifi.
Scnario : Afficher le contenu dun fichier ARFF

Le scnario suivant dcrit un Job form de deux composants ayant pour objectif de lire ligne ligne un fichier ARFF, de slectionner des donnes dlimites et dafficher la sortie dans la console de la vue Run. Un fichier ARFF se prsente comme suit :
Un fichier ARFF est gnralement compos de deux parties : la description de la structure des donnes, correspondant aux lignes qui dbutent par @attribute, et les donnes brutes, qui suivent lexpression @data. Dans lespace de modlisation du studio de Talend Open Studio, crez le Job suivant :
883
Composants File
tFileInputARFF
Glissez et dposez le composant tFileInputARFF de la Palette dans lespace de modlisation graphique. Glissez et dposez de la mme manire le composant tLogRow Cliquez-droit sur le composant tFileInputARFF et slectionnez Row > Main dans le menu contextuel. Puis glissez ce lien vers le tLogRow et relchez lorsque le symbole de prise de courant apparat. La transmission du flux de donne entre les deux composants est ainsi tablie. Double-cliquez sur le tFileInputARFF pour paramtrer ce composant. Dans la vue Component, renseignez le champ File Name. Parcourez votre rpertoire de fichiers, afin de slectionner le fichier .arff. Dans le champ Schma, slectionnez Built-In. Cliquez sur le bouton [...] du champ Edit schema, pour effectuer manuellement la description des colonnes du fichier lu. Cliquez autant de fois sur le bouton que ncessaire pour dcrire chacune des colonnes du fichier lu. Dans cet exemple, 17 colonnes sont ajoutes, nommez-les comme suit :
Pour chacune des colonnes slectionnez le Type : chaine de caractres (String). Cliquez sur OK.
884
Composants File
tFileInputARFF
Dans lespace de modlisation, double-cliquez sur le composant tLogRow pour afficher sa vue Component. Cliquez sur le bouton [...] du champ Edit schema pour vrifier que le schma a bien t propag. Si ce nest pas le cas, cliquez sur le bouton Sync columns.
Conservez les paramtres par dfaut. Appuyez sur F6 pour excuter votre Job.
La console affiche les donnes contenues dans le fichier ARFF dlimites par une barre verticale (sparateur par dfaut).
885
Composants File
tFileInputDelimited
tFileInputDelimited
Proprits du tFileInputDelimited
Fonction Objectif
Le composant tFileInputDelimited lit un fichier ou un flux de donnes ligne par ligne et spare des champs simples. Ce composant lit un fichier ou un flux de donnes ligne par ligne, afin de le diviser en champs et denvoyer ses champs au composant suivant, comme dfini par le schma, via une connexion Row. 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/Stream File name : Chemin daccs et nom du fichier, et/ou variable traiter. Stream : Flux de donnes traiter. Les donnes doivent pralablement tre mises en flux afin dtre rcupres par le tFileInputDelimited via la variable INPUT_STREAM disponible dans la liste dauto-compltion (Ctrl+Espace). Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Row separator Field separator CSV options Chane (ex : \nsous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Cochez cette case pour prendre en compte les paramtres spcifiques aux fichiers CSV, notamment la manire de protger les caractres dans le champ Escape char et le type de guillemet dans le champ Enclosure. Nombre de lignes ignorer au dbut dun fichier. Nombre de lignes ignorer la fin dun fichier. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ni traite.
Basic settings
Header Footer Limit
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.
886
Composants File
tFileInputDelimited
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. Skip empty rows Uncompress as zip file Die on error Cochez cette case pour ignorer les lignes vides. Cochez cette case pour dcompresser le fichier dentre. 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 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.
Advanced settings
Extract lines at random Cochez cette case pour dfinir le nombre de lignes extraire de faon alatoire. 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. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes. Cochez cette case pour synchroniser chaque ligne avec le schma dentre. Cochez la case devant le nom de chacune des colonnes dont vous voulez supprimer les espaces de dbut et de fin de champ. Cochez cette case pour sparer les lignes avant de sparer les champs. Cochez cette case pour collecter les donnes de log au niveau du composant.
Trim all columns Check each row structure against schema Check columns to trim
Split row before field tStatCatcher Statistics Utilisation
Utilisez ce composant pour lire un fichier et sparer les champs laide du sparateur spcifi. Il permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1330 du composant tFileInputXML.
887
Composants File
tFileInputDelimited
Scnario 1 : Afficher le contenu dun fichier dlimit

Le scnario suivant est un Job de deux composants ayant pour objectif de lire les lignes dun fichier, de slectionner des donnes dlimites et dafficher la sortie dans la console de la vue Run.
Cliquez et dposez un composant tFileInputDelimited de la Palette dans lespace de modlisation. De la mme manire, cliquez et dposez un composant tLogRow. Cliquez-droit sur le composant tFileInputDelimited et slectionnez Row > Main dans le menu contextuel. Puis glissez ce lien vers le tLogRow et relchez lorsque le symbole de prise de courant apparat. Slectionnez le composant tFileInputDelimited nouveau et dfinissez ses proprits dans longlet Basic Settings :
Renseignez le chemin daccs au fichier dans le champ File Name. Ce champ est obligatoire. Dfinissez le sparateur de lignes dans le champ Row separator afin didentifier la fin dune ligne. Puis dfinissez le sparateur de champs dans Field separator pour dlimiter les champs composant une ligne. Dans ce scnario, len-tte (Header) et le pied de page (Footer) nont pas besoin dtre dfinis. Et la limite de lignes lues (Limit ) est de 50 pour cet exemple. Slectionnez soit local (Built-in) soit distant (Repository) comme Schema pour dfinir les donnes qui passent par le composant tLogRow. Vous pouvez charger et/ou diter le schma laide de la fonction Edit Schema. Voir galement : Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Assurez-vous que la case Skip empty rows est coche afin dignorer les lignes vierges. Saisissez lencodage utilis dans le fichier dentre. Ce paramtre permet dassurer lhomognit de lencodage dans tous les fichiers dentre et de sortie.
Composants File
tFileInputDelimited
Slectionnez le composant tLogRow et dfinissez le sparateur de champs de la sortie affiche. Voir galement : Proprits du tLogRow, page 1095. Cochez la case Print schema column name in front of each value pour rcuprer le libell des colonnes dans la sortie affiche. Cliquez sur la vue Run, puis cliquez sur Run pour excuter le Job. Le fichier est lu ligne par ligne et les champs extraits sont affichs dans la console, tel que dfini dans les proprits du composant (dans longlet Basic settings).
La console affiche len-tte suivi des donnes lues par le Job.
Scnario 2 : Lire les donnes dun fichier distant en mode stream

Le scnario suivant illustre un Job quatre composants ayant pour objectif de rcuprer les donnes dun fichier volumineux quasiment aussitt quelles ne sont lues afin dviter lattente du tlchargement de lensemble du fichier de donnes, et les affichent dans la console de la vue Run.
Dposez les composants suivants dans lespace de modlisation : tFileFetch, tSleep, tFileInputDelimited, et tLogRow. Reliez les composants tSleep et tFileInputDelimited via un lien de type Trigger > OnComponentOk et reliez les composants tFileInputDelimited et tLogRow via un lien de type Row > Main. Double-cliquez sur le composant tFileFetch pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
889
Composants File
tFileInputDelimited
Dans la liste Protocol, slectionnez le type de protocole vous permettant daccder au serveur sur lequel est stock votre fichier de donnes. Dans le champ URI, saisissez lURI daccs au serveur sur lequel est stock votre fichier. Cochez la case Use cache to save the resource pour mettre les donnes de votre fichier en mmoire cache. Cette option permet dutiliser le mode stream pour transfrer les donnes du fichier. A partir de lespace de modlisation, double-cliquez sur le composant tSleep pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits. Par dfaut, le champ Pause du composant tSleep correspond 1 seconde. Laissez ce paramtre par dfaut. Il met le deuxime Job en pause afin de laisser le temps au premier Job contenant le tFileFetch de lire les donnes du fichier. A partir de lespace de modlisation, double-cliquez sur le composant tFileInputDelimited pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
890
Composants File
tFileInputDelimited
Dans le champ File name/Stream : - Effacez le contenu par dfaut. - Faites un Ctrl+Espace pour faire apparatre la liste des variables disponibles partir de ce composant. - Slectionnez la variable tFileFetch_1_INPUT_STREAM dans la liste dauto-compltion, la varaible suivante apparat dans le champ Filename : ((java.io.InputStream)globalMap.get("tFileFetch_1_INPUT_STRE AM")). Dans la liste Schema, slectionnez Built-in et cliquez sur le bouton [...] ct du champ Edit schema pour dcrire la structure des donnes du fichier que vous souhaitez rcuprer. Le fichier US_Employees est compos de six colonnes : ID, Employee, Age, Address, State, EntryDate.
Cliquez sur le bouton [+] pour ajouter les six colonnes et paramtrez-les comme indiqu sur la capture dcran ci-dessus. Cliquez sur OK. A partir de lespace de modlisation, double-cliquez sur le composant tLogRow pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits. Cliquez sur Edit schema et assurez-vous que le schma est rcupr du composant prcdent. Sinon, cliquez sur Sync Columns pour le rcuprer. A partir de lespace de modlisation, cliquez sur la vue Job et sur longlet Extra.
891
Composants File
tFileInputDelimited
Cochez la case Multi thread execution afin dexcuter les deux Jobs en parallle, sachant que le deuxime Job a un retard dune seconde par rapport au premier comme dfini dans le tSleep. Cette option permet donc de rcuprer les donnes grce au tFileDelimited quasiment ds leur lecture par le tFileFetch. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Les donnes sont affiches dans la console ds leur lecture.
892
Composants File
tFileInputMSDelimited
Proprits du tFileInputMSDelimited
Famille du composant Fonction Objectif File/Input
Le composant tFileInputMSDelimited permet de lire des fichiers dlimits multi structure complexes. Le tFileInputMSDelimited ouvre le fichier multi structure complexe, en lit la structure (schmas) puis utilise des liens de type Row pour envoyer les champs, tels quils ont t dfinis dans les diffrents schmas, vers les composants suivants dans le Job. Multi Schema Editor Lditeur de schmas [Multi Schema Editor] permet de construire et de configurer le flux de donnes dans un fichier dlimit multi structure pour pouvoir associer un schma pour chaque sortie. Pour plus dinformations, consultez Lditeur de schmas Multi Schema Editor, page 893. Les schmas dfinis dans lditeur de schmas [Multi Schema Editor], ainsi que les types denregistrements correspondants, saffichent automatiquement dans le tableau Output. 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. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes. Cochez cette case pour collecter les donnes de log au niveau du composant.
Basic settings
Output
Die on error
Advanced settings
Trim all columns tStatCatcher Statistics
Utilisation
Utilisez ce composant pour lire des fichiers dlimits multi structure et dfinissez un sparateur de champs pour diffrencier les champs contenus dans ces fichiers.
Lditeur de schmas Multi Schema Editor

Lditeur [Multi Shema Editor] vous permet de dfinir : le chemin daccs au fichier source, les proprits du fichier source, la structure des donnes pour chacun des schmas de sortie.
Lorsque vous dfinissez la structure de chaque schma de sortie dans le [Multi Schema Editor], le nom des colonnes des diffrentes structures saffichent automatiquement dans la liste du schma dentre des composants qui suivent le tFileInputMSDelimited. Vous pouvez cependant dfinir la structure des donnes directement dans la vue Basic settings de chacun de ces composants.
Le [Multi Shema Editor] permet galement de slectionner un schma qui servira de source (cl primaire) aux donnes entrantes, afin den assurer lunicit. Lditeur utilise ce procd de
893
Composants File
mapping pour associer tous les schmas traits dans le fichier dlimit au schma source de ce mme fichier.
Lditeur souvre en affichant par dfaut la premire colume. Cette colume contient gnralement lindicateur de type des enregistrements. Une fois ouvert, vous pouvez cependant dfinir comme cl primaire nimporte quelle colonne du schma en cochant la case associe.
Limage ci-dessous donne un aperu de lditeur de schmas [Multi Schema Editor].
Pour des informations plus dtailles sur le Multi Schema Editor, consultez le Scnario : Lecture dun fichier dlimit multi structure, page 895.
894
Composants File
Scnario : Lecture dun fichier dlimit multi structure

Le prsent scnario sert crer un Job en Java permettant de lire trois schmas dans un mme fichier dlimit et den afficher la structure sur la console de la vue Run. Le fichier dlimit trait dans ce scnario se prsente comme suit :
A partir de la Palette, cliquez sur les composants suivants et dposez-les dans lditeur graphique : un composant tFileInputMSDelimited et trois tLogRow. Double-cliquez sur le tFileInputMSDelimited pour ouvrir lditeur Multi Schema Editor.
Cliquez sur le bouton Browse... ct du champ File name pour indiquer o se trouve le fichier dlimit multi-schma que vous voulez traiter. Dans la zone File Settings, renseignez : -le type dencodage de votre fichier source, partir de la liste droulante. Cette option permet de garantir une certaine cohrence entre tous les fichiers dentre et de sortie. -les sparateurs de champ et de ligne utiliss dans le fichier source.
Cochez la case Use Multiple Separator et configurez les champs qui suivent si diffrents sparateurs de champs sont utiliss pour sparer les schmas du fichier source.
Un aperu des donnes du fichier source apparat automatiquement dans le panneau daffichage Preview.
895
Composants File
La colonne Column 0, qui contient gnralement lindicateur de type des enregistrements est slectionne par dfaut. Vous pouvez cependant dfinir nimporte quelle autre colonne comme cl primaire en cochant sa case associe.
Cliquez sur le bouton Fetch Codes droite du panneau Preview pour cataloguer les types de schmas et les enregistrements du fichier source. Dans ce scnario, le fichier source comporte trois types de schmas (A, B, C). A partir du panneau daffichage Fetch Codes, cliquez sur chacun des trois types pour que la structure de leurs donnes saffiche dans le panneau Preview.
896
Composants File
Cliquez dans les cellules de la ligne Name et choisissez le nom des colonnes de chacun des schmas slectionns. Dans ce scnario, les colonnes se lisent comme suit : -Schma A : Type, DiscName, Author, Date, -Schma B : Type, SongName, -Schma C : Type, LibraryName. Vous devez prsent dfinir, partir des donnes dentre, la cl primaire qui permettra de conserver leur unicit (dans ce scnario, il sagit de DiscName). Il vous faut pour cela : Slectionner, partir du panneau daffichage Fetch Codes, le schma contenant la colonne que vous voulez dfinir comme cl primaire (dans ce scnario, il sagit du schma A) pour en afficher la structure. Cliquer dans la cellule Key correspondant la colonne DiscName et cocher la case qui saffiche alors.
Cliquer nimporte o dans lditeur pour que la mention false, dans la case Key, devienne true. Vous devez maintenant indiquer le schma pre auquel vous voulez rattacher les autres schmas fils (dans ce scnario, il sagit de DiscName). Il vous faut pour cela : Slectionner le schma B, partir du panneau daffichage Fetch Codes, puis cliquer sur le bouton flche droite pour le dplacer vers la droite. Faire de mme pour le schma C.
897
Composants File
Le champ Cardinality nest pas obligatoire. Il vous permet de dterminer le nombre (ou lintervalle) de champs des schmas fils rattachs au schma pre. Cependant, si vous entrez un nombre ou un intervalle inexact et essayez dexcuter le Job, un message derreur apparatra.
Dans le [Multi Schema Editor], cliquez sur le bouton OK pour valider tous les changements que vous venez deffectuer et fermer lditeur de schmas. Les trois schmas dfinis, ainsi que les types denregistrements correspondants, saffichent automatiquement dans la vue Basic settings du composant tFileInputMSDelimited.
Dans lditeur graphique, effectuez un clic-droit sur le composant tFileInputMSDelimited et connectez-le aux trois autres composants tLogRow1, tLogRow2 et tLogRow3 laide des liens respectifs row_A_1, row_B_1 et row_C_1.
Les trois schmas que vous avez dfinis dans lditeur [Multi Schema Editor] sont automatiquement communiqus aux trois composants tLogRow.
898
Composants File
Si ncessaire, cliquez sur le bouton Edit schema dans la vue Basic settings de chacun des composants tLogRow pour avoir un aperu des structures de donnes en entre et en sortie, telles que vous les avez dfinies dans le Multi Schema Editor, ou pour les modifier.
Enregistrez votre Job puis appuyez sur F6 pour lexcuter. Le fichier dlimit multi-schma est lu ligne par ligne et les champs extraits sont affichs dans la console Run Job comme dfini dans le [Multi Schema Editor].
899
Composants File
tFileInputEBCDIC
tFileInputEBCDIC
Ce composant requiert lutilisation dun JDK Sun.
Proprits du tFileInputEBCDIC
Fonction Objectif
Le composant tFileInputEBCDIC lit un fichier EBCDIC et extrait les donnes en fonction du schma slectionn. Ce composant ouvre un fichier et le lit afin disoler les donnes en fonction des schmas dcrivant la structure de ce fichier et denvoyer ses donnes et schmas au(x) composant(s) suivant(s) via une connexion Row. 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. Schema(s) Data file Xc2j file Ajoutez les diffrents schmas transmettre en sortie. Slectionnez le fichier EBCDIC contenant les donnes traiter. Slectionnez le fichier xc2j de transformation.
Basic settings
Utilisation
Utilisez ce composant pour lire un fichier EBCDIC et sparer les donnes en fonction des schmas identifis dans ce fichier.
Scnario : Extraire les donnes dun fichier EBCDIC et alimenter une base de donnes
Ce scnario utilise lassistant [Copybook Connection] guidant lutilisateur travers les diffrentes tapes de cration de connexion au fichier Copybook et de rcupration des schmas EBCDIC. Lassistant [Copybook Connection] 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 tFileInputEBCDIC manuellement.
Le scnario suivant est un Job de quatre composants ayant pour objectif de lire un fichier au format EBCDIC contenant des informations sur les clients et sur leurs transactions financires, den extraite et transformer les donnes et de crer deux tables dans une base de donnes partir des deux schmas, clients et transactions, extraits du fichier EBCDIC dorigine.
900
Composants File
tFileInputEBCDIC
Ce scnario Java utilise lassistant EBCDIC Connection pour crer une connexion au fichier Copybook et gnrer un fichier xc2j permettant de rcuprer et de transformer les diffrents schmas du fichier. Crez une connexion au fichier Copybook dcrivant la structure de votre fichier EBCDIC. Dans ce scnario la connexion Copybook est appele EBCDIC. Rcuprez le schma du fichier. Une fois la connexion au fichier Copybook cre et les schmas rcuprs laide des assistants EBCDIC et Schema, ils apparaissent sous le noeud Metadata > Copybook. Ces nouveaux schmas sappellent Schema01, Schema04 et Schema05.
Pour rcuprer les diffrentes structures du fichier et les utiliser dans Talend Open Studio : Dans le Repository, appuyez sur Ctrl+Shift tout en cliquant sur le schma Schema01 et glissez-le dans lditeur graphique. Cette manipulation crera le composant dentre tFileInputEBCDIC. Cliquez et dposez le composant tMysqlOutput. Double-cliquez sur le tFileInputEBCDIC pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
901
Composants File
tFileInputEBCDIC
Les champs Property Type, Schema(s), Data file et Xc2j file sont automatiquement renseigns par les informations de la mtadonne. Le champ Property Type indique la mtadonne utilise pour le composant. Le champ Schema indique quel schma est transmis au composant suivant. Le champ Data file indique le chemin daccs au fichier de donnes EBCDIC. Le champ Xc2j file indique le chemin daccs au fichier permettant dextraire le schma dcrivant la structure du fichier EBCDIC. Si vous tes en mode Built-In, renseignez ces champs manuellement. Dans lditeur graphique, cliquez-droit sur le tFileInputEBCDIC, slectionnez Row > row_Schema01_1 dans le menu contextuel puis cliquez sur le tMysqlOutput pour relier les composants entre eux. Double-cliquez sur le composant tMysqlOutput pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
Dans la liste Property Type, slectionnez le mode Repository et cliquez sur le bouton [...] pour slectionner la connexion la base de donnes centralise dans les mtadonnes du Repository. Les champs Host, Port, Database, Username et Password seront renseigns automatiquement. Si vous tes en mode Built-In, renseignez ces champs manuellement.
902
Composants File
tFileInputEBCDIC
Dans le champ Table, renseignez le nom de la table crer qui contiendra les donnes extraites du fichier EBCDIC. Ici, nous appelons cette table ebcdic_01. Dans le champ Action on table, slectionnez loption Create table pour crer la table. A ce stade, le Job rcupre le schma Schema01 du fichier EBCDIC et le transmet ainsi que ses donnes correspondantes vers la base de donnes. Nous souhaitons maintenant rcuprer le schma et les donnes du schma Schema04 du fichier EBCDIC, effectuer une transformation sur ces donnes et les transmettre cette mme base de donnes. Pour cela : Cliquez et dposez les composants tMap et tMysqlOutputBulkExec dans lditeur graphique. Double-cliquez sur le composant tFileInputEBCDIC pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
Dans le champ Schema(s), cliquez sur le bouton (+) pour ajouter une ligne, cliquez sur cette ligne puis sur le bouton [...] qui apparat en fin de champ. Dans lassistant qui souvre, slectionnez Create schema from repository pour rcuprer le schma dfini dans la mtadonne EBCDIC puis dans la liste droulante, slectionnnez le schma Schema04. Cliquez sur OK. Si vous navez pas rcupr le schma dans les mtadonnes du repository, slectionnez Create schema for built-in, puis spcifiez manuellement le nom et la description de votre schma. Les deux schmas Schema01 et Schema04 apparaissent dans le champ Schema(s) du composant tFileInputEBCDIC. Pour relier les composants entre eux, cliquez-droit sur le tFileInputEBCDIC, slectionnez Row > row_Schema04_1 dans le menu contextuel puis cliquez sur le tMap. Puis cliquez-droit sur le tMap, glissez le lien jusquau tMysqlOutputBulkExec et relchez le bouton. Dans lassistant qui souvre, indiquez le nom de la sortie ebcdic_04. Double-cliquez sur le tMap pour ouvrir son diteur
903
Composants File
tFileInputEBCDIC
Slectionnez toutes les colonnes de la table row_Schema04_1 et glissez-les dans la table ebcdic_04. Dans le tableau ebcdic_04 de la zone Schema editor en bas de lditeur, cliquez sur le bouton (+) pour ajouter une colonne au schma. Nommez cette colonne SUM_AG_NUMBER. Dans la table row_Schema04_1 gauche de lditeur, appuyez sur Ctrl puis slectionnez les colonnes CC01404_L_11_MENAG_1_1 et CC01404_AG_CAM_1_1 et glissez-les dans la nouvelle colonne SUM_AG_NUMBER de la table ebcdic_04, et ajoutez le signe + entre les deux colonnes concatnes pour obtenir : row_04_1.CC01404_L_11_MENAG_1_1 + row_04_1.CC01404_AG_CAM_1_ 1. Cliquez sur OK. Dans lditeur graphique, double-cliquez sur le tMysqlOutputBulkExec pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
904
Composants File
tFileInputEBCDIC
Dans la liste Property Type, slectionnez le mode Repository et cliquez sur le bouton [...] pour slectionner la connexion la base de donnes centralise dans les mtadonnes du Repository. Les champs Host, Port, Database, Username et Password seront renseigns automatiquement. Si vous tes en mode Built-In, renseignez ces champs manuellement. Dans le champ Table, renseignez le nom de la table crer qui contiendra les donnes extraites du fichier EBCDIC. Dans le champ Action on table, slectionnez loption Create table pour crer la table. Enregistrez votre Job via Ctrl+S et cliquez sur la vue Run, cochez les cases Statistics et Exec time puis cliquez sur Run pour excuter le Job. Les deux tables ont t cres dans la base de donnes et contiennent la structure ainsi que les donnes, de transactions et clients, du fichier EBCDIC dorigine.
905
Composants File
tFileInputExcel
tFileInputExcel
Proprits du tFileInputExcel
Famille du composant File/Input
Fonction Objectif
Le composant tFileInputExcel lit un fichier Excel (.xls ou .xlsx) ou un flux de donnes et en extrait les donnes ligne par ligne. Ce composant lit un fichier Excel 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 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 connexion et enregistrer les paramtres de connexion au fichier Excel que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de fichier, consultez le chapitre Configurer un schma File Excel du Guide Utilisateur de Talend Open Studio . File name/Stream File name : Chemin daccs et nom du fichier, et/ou variable traiter. Stream : Flux de donnes traiter. Les donnes doivent pralablement tre mises en flux afin dtre rcupres par le tFileInputExcel via la variable INPUT_STREAM disponible dans la liste dauto-compltion (Ctrl+Espace). Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. All sheets Sheet list Cochez cette case pour traiter toutes les feuilles du fichier Excel. Cliquez sur le bouton [+] pour ajouter de nouvelles lignes la liste de feuilles traiter : Sheet (name or position) : renseignez le nom ou la position de la feuille traiter. Use Regex : cochez cette case si vous utilisez une expression rgulire pour filtrer les feuilles selon un modle. Nombre de lignes ignorer au dbut dun fichier. Nombre de lignes ignorer la fin dun fichier.
Basic settings
Header Footer
906
Composants File
tFileInputExcel
Limit Affect each sheet(header&footer) Die on error
Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ni traite. Cochez cette case pour appliquer les paramtres dfinis dans les champs Header et Footer toutes les feuilles traites. 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 lintervalle de colonnes que vous voulez traiter : la position de la premire colonne dans le champ First column et celle de la dernire colonne traiter dans le champ Last column. 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.
First column et Last column
Advanced settings
Advanced separator Encoding Type
Cochez cette case pour modifier les sparateurs de lignes utiliss. 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 lire les nombres en valeur relle. Cochez cette case pour ignorer les lignes vides. Cochez cette case pour ne pas effectuer de validation des donnes. Cochez cette case pour ignorer les avertissements gnrs par des erreurs sur le fichier Excel.
Read real values for numbers Stop to read on empty rows Dont validate the cells Ignore the warning
907
Composants File
tFileInputExcel
Utilisation
Utilisez ce composant pour lire un fichier Excel (.xls ou .xlsx) et sparer les champs en fonction dun schma dfini. Ce composant permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1330 du composant tFileInputXML.
Scnario associ
908
Composants File
tFileInputFullRow
tFileInputFullRow
Proprits du tFileInputFullRow
Le composant tFileInputFullRow lit un fichier donn ligne par ligne. Le tFileInputFullRow ouvre un fichier quil lit ligne par ligne et passe les lignes compltes au composant suivant comme dfini dans le schma, via une connnexion de type Row. 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 tFileInputFullRow prcdent. File Name Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Row separator Header Footer Limit Skip empty rows Chane (ex : \n sous Unix) sparant les lignes. Nombre de lignes ignorer en dbut de fichier. Nombre de lignes ignorer la fin dun fichier. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ni traite. Cochez cette case pour ignorer les lignes vides.
Basic settings
Utilisation
Utilisez ce composant pour lire des lignes compltes dans un fichier dlimit pouvant tre trs gros. Ce composant permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1330 du composant tFileInputXML.
Scnario : Lire des lignes compltes dans un fichier dlimit

Le scnario suivant cre un Job deux composants permettant de lire des lignes compltes partir dun fichier et dafficher les donnes de sortie dans la console de log Run. A partir de la Palette, cliquez-dposez les composants tFileInputFullRow et tLogRow dans lditeur graphique.
909
Composants File
tFileInputFullRow
Cliquez-droit sur le composant tFileInputFullRow et connectez-le au tLogRow laide dun lien de type Row Main.
Dans lditeur graphique, slectionnez le composant tFileInputFullRow. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileInputFullRow.
Dans longlet Basic settings, configurez le champ Schema en mode Built-In. Clickez sur le bouton [...] du champ Edit schema pour voir les donnes passer au composant tLogRow. Notez que le schma est en read-only et ne comporte quune seule colonne, line.
Dans le champ File Name, renseignez le chemin daccs au fichier traiter ou cliquez sur le bouton [...]. Ce champ est obligatoire. Dans ce scnario, le fichier lire sappelle test5 et comporte trois lignes comprenant chacune deux champs spars par un point-virgule. Dans le champ Row separator, renseignez le sparateur permettant didentifier les fins de ligne. Dans la champ Header, indiquez la valeur 1. Dans ce scnario, ni le pied-de-page ni le nombre de lignes traiter ne sont renseigns.
Composants File
tFileInputFullRow
Dans lditeur graphique, slectionnez le tLogRow puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations, consultez le tLogRow, page 1095. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
Le composant tFileInputFullRow lit les trois lignes une une sans tenir compte des sparateurs de champs et les lignes compltes apparaissent dans la console Run.
Pour extraire des lignes uniquement les champs, utilisez le tExtractDelimitedFields, le tExtractPositionalFields et le tExtractRegexFields. Pour plus dinformations, consultez les composants tExtractDelimitedFields, page 1194, tExtractPositionalFields, page 1199 et tExtractRegexFields, page 1201.
911
Composants File
tFileInputJSON
tFileInputJSON
Proprits du tFileInputJSON
Famille de composant File
Fonction Objectif
Le composant tFileInputJSON lit un fichier JSON et extrait les donnes en fonction du schma slectionn. Ce composant ouvre un fichier et le lit afin disoler les donnes en fonction des schmas dcrivant la structure de ce fichier et denvoyer ses donnes et schmas au(x) composant(s) suivant(s) via une connexion Row. 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. 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 rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Use URL Cochez cette case pour rcuprer les donnes directement partir dinternet. URL : entrez le chemin daccs lURL partir de laquelle rcuprer les donnes. Nom du fichier partir duquel rcuprer les donnes. Column : reflte le schma tel quil est dfini dans lditeur Edit Schema. JSONPath Query : Saisissez les champs extraire de la structure JSON dentre. Cochez cette case pour modifier les sparateurs de lignes utiliss. 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
Filename Mapping
Advanced settings
Advanced separator Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
912
Composants File
tFileInputJSON
Utilisez ce composant pour lire un fichier JSON et sparer les donnes en fonction des schmas identifis dans ce fichier. n/a
Scnario : Extraire les donnes des champs dun fichier au format JSON
Ce scnario est de deux composants et permet de lire un fichier au format JSON et den extraire les donnes.
Glissez les composants tFileInputJSON de la famille File et tLogRow de la famille Logs & Errors partir de la Palette dans le Job designer. Reliez les composants entre eux via des connexions de type Main > Row. Double-cliquez sur le composant tFileInputJSON pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
Si votre schma est dj stock sous le noeud Db Connections dans le Repository, slectionnez loption Repository dans le champ Schema Type puis choisissez les mtadonnes appropries partir de la liste. Si vous navez encore dfini aucun schma, slectionnez loption Built-in et renseignez manuellement les informations de connexion et la structure des donnes dans un schma. Cliquez sur le bouton [...] du champ Edit schema pour ouvrir une bote de dialogue dans laquelle vous pouvez dfinir le schma afficher en sortie.
913
Composants File
tFileInputJSON
Cliquez sur le bouton OK pour fermer la bote de dialogue. Dans la zone Mapping, les lments du champ Column sont alors renseigns automatiquement selon le schma que vous venez de dfinir. Dans cet exemple, le schma comporte quatre colonnes FirstName, LastName, Address et City. Dans le champ Filename, renseignez le chemin daccs au fichier JSON dont vous voulez rcuprer les donnes. Si les donnes sont stockes distance sur Internet, cochez la case Use URL puis, de la mme faon, renseignez lURL daccs au fichier traiter. Dans cet exemple, le fichier trait se prsente comme suit :
Dans la zone Mapping, les lignes du champ Column sont dj renseignes. Pour chacune delle, indiquez dans le champ JSONPath query le niveau de larborescence sur lequel rcuprer les donnes. Dans le Job designer, double-cliquez sur le composant tLogRow pour paramtrer ses proprits dans longlet Basic settings de la vue Component.
Cliquez sur le bouton Sync Columns pour rcuprer le schma du composant prcdent. Enregistrez le Job et appuyez sur F6 pour lxecuter.
Le Job retourne les informations du client selon les paramtres slectionns dans le schma.
914
Composants File
tFileInputLDIF
tFileInputLDIF
Proprits du tFileInputLDIF
Le composant tFileInputLDIF lit un fichier LDIF donn ligne par ligne. Le tFileInputLDIF ouvre un fichier quil lit ligne par ligne et passe les lignes compltes au composant suivant comme dfini dans le schma, via une connnexion de type 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. File Name Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. add operation as prefix when the entry is modify type Die on error Cochez cette case pour afficher le mode doprations effectues. 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.
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 modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant tFileInputLDIF prcdent. 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 de base de donnes. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
915
Composants File
tFileInputLDIF
Utilisation
Utilisez ce composant pour lire des lignes compltes dans un fichier dlimit pouvant tre trs gros.Ce composant permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1330 du composant tFileInputXML.
Scnario associ
Pour un scnario associ, consultez Scnario : Ecrire des donnes dans un fichier LDIF page 960.
916
Composants File
tFileInputMail
tFileInputMail
Proprits du tFileInputMail
Le composant tFileInputMail lit len-tte et le contenu du fichier email dfini. Ce composant permet dextraire les donnes standard des emails. File name Schema et Edit Schema Entrez le fichier email source. 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 dans cette vue, le schma devient automatiquement ponctuel (built-in). Cliquez sur Sync columns pour rcuprer le schma partir du composant prcdent dans le Job. 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 dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Attachment export directory Mail parts Renseignez le chemin daccs au rpertoire dans lequel exporter les pices jointes. Column : Ce champ est automatiquement renseign avec les colonnes dfinies dans le schma que vous avez propag. Mail part : Saisissez ltiquette den-tte ou de corps de message afficher dans la sortie. Multi value : Cochez cette case pour chaque colonne comportant des champs valeurs multiples. Field separator : Saisissez le sparateur de valeur des champs valeurs multiples.
917
Composants File
tFileInputMail
Die on error
Cochez cette case pour arrter lexcution du Job lorsquune erreur survient. Dcochez la case pour la ligne en erreur et terminer le processus avec les lignes sans erreur. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Advanced settings
Ce composant traite un flux de donnes et par consquant requiert un composant de sortie. n/a
Scnario : Extraire des champs cls dun email

Ce scnario est constitu de deux composants et a pour objectif dextraire certains champs cls et den afficher les valeurs dans la console Run.
Cliquez et dposez les composants tFileInputMail et tLogRow. Reliez les composants laide dun lien de type Row Main. Double-cliquez sur le composant tFileInputMail pour afficher longlet Basic settings de la vue Component et configurer les paramtres de base :
Dans le champ File Name, slectionnez le fichier email traiter. Renseignez manuellement le chemin daccs ou cliquez sur le bouton [...] pour parcourir vos dossiers jusquau fichier choisi. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir la bote de dialogue permettant de dfinir le schma afficher en sortie.
918
Composants File
tFileInputMail
Dfinissez votre schma en incluant toutes les colonnes que vous souhaitez retrouver dans le flux de sortie. Dans cet exemple, le schma comporte quatre colonnes Date, Author, Object et Status. Une fois dfini, cliquez sur OK pour fermer la bote de dialogue et propager le schma dans le tableau Mail parts. Dans la colonne Mail part du tableau, saisissez les cls standards des parties header (en -tte) et body (corps de message) qui seront utilises pour retrouver les valeurs envoyer en sortie. Cochez la case Multi Value pour chacune des cls standards pouvant se retrouver plus dune fois dans votre fichier dentre. Dfinissez si besoin un sparateur pour les valeurs de ces cls dans le champ Separator. Double-cliquez sur le composant tLogRow pour afficher longlet Basic settings de la vue Component et configurer les paramtres de base. Dfinissez le composant tLogRow afin que les valeurs affiches soient spares par un retour chariot. Sous Windows, saisissez \n entre guillemets doubles. Pour plus dinformations sur le composant tLogRow, consultez le chapitre tLogRow, page 1095. Enregistrez votre Job puis appuyez sur F6 pour lexcuter et afficher le flux de sortie dans la console de la vue Run Job.
Les valeurs cls den-tte sont extraites comme spcifi dans le tableau Mail parts. En effet, la date de rception, lauteur, le sujet ainsi que les diffrents statuts contenus dans lemail sont affichs.
919
Composants File
tFileInputPositional
Proprits du tFileInputPositional
Fonction Objectif
Le composant tFileInputPositional lit un fichier ou un flux de donnes ligne par ligne et extrait les champs selon un modle (pattern). tFileInputPositional lit un fichier ou un flux de donnes ligne par ligne, spare les champs tels que dfinis par le schma et passe les donnes extraites au composant suivant via une connnexion de type 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. File name/Stream File name : Chemin daccs et nom du fichier, et/ou variable traiter. Stream : Flux de donnes traiter. Les donnes doivent pralablement tre mises en flux afin dtre rcupres par le tFileInputPositional via la variable INPUT_STREAM disponible dans la liste dauto-compltion (Ctrl+Espace). Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Row separator Customize Chane (ex : \n sous Unix) sparant les lignes. Cochez cette case pour personnaliser le format des donnes du fichier positionnel et renseignez les colonnes du tableau Formats. Column : Slectionnez la colonne que vous souhaitez personnaliser. Size : Saisissez la taille correspondant la colonne. Padding char : Saisissez entre guillemets le caractre de remplissage utilis afin quil soit supprim de votre champ. Le caractre par dfaut est un espace. Alignment : Slectionnez le paramtre dalignement appropri. Longueurs spares par des virgules, interptes comme une chane de caractres entre guillemets. Vrifiez que les valeurs saisies dans ce champ sont cohrentes avec le schma dfini. Cochez cette case pour ignorer les lignes vides. Cochez cette case pour dcompresser le fichier dentre.
Basic settings
Pattern
Skip empty rows Uncompress as zip file
920
Composants File
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. Nombre de lignes ignorer au dbut dun fichier. Nombre de ligne ignorer la fin dun fichier. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ni traite. 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. 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 Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Header Footer Limit Schema et Edit Schema
Advanced settings
Needed to process rows longer than 100 000 characters Advanced separator Trim all columns Check columns to trim
Cochez cette case si les lignes traiter dans le fichier dentre font plus de 100 000 caractres de long. Cochez cette case pour modifier les sparateurs de lignes utiliss. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes. Cochez la case devant le nom de chacune des colonnes dont vous souhaitez supprimer les espaces de dbut et de fin de champ. 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 collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Encoding
Utilisez ce composant pour lire un fichier et sparer les champs laide du sparateur spcifi. Ce composant permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1330 du composant tFileInputXML.
921
Composants File
Scnario : Transformer un fichier positionnel en XML

Le scnario suivant construit un Job avec deux composants, qui a pour objectif de lire les donnes dun fichier positionnel en entre et de rendre des donnes slectionnes en sortie (selon leur position) dans un fichier XML.
Cliquez et dposez un composant tFileInputPositional de la Palette dans lespace de modlisation. Le fichier contient des lignes de donnes, dans cet exemple, contract nr, customer references et insurance numbers. Cliquez-dposez un composant tFileOutputXML. Ce fichier recevra les rfrences de manire structure. Cliquez-droit sur le composant tFileInputPositional et slectionnez une connexion Row > Main. Glissez cette connexion vers le composant tFileOutputXML et relchez la souris lorsque le symbole de prise de courant apparat. Slectionnez le composant tFileInputPositional nouveau et dfinissez ses proprits. Les proprits de ce Job sont de type built-in pour ce scnario. Par consquent, les informations de proprits sont renseignes pour ce Job seulement et ne peuvent tre rutilises pour un autre Job, contrairement des proprits de type Repository.
Renseignez le chemin daccs au fichier dans le champ File Name. Ce champ est obligatoire. Puis dfinissez le sparateur de lignes (Row separator) permettant didentifier la fin de la ligne : le retour chariot par dfaut. Puis dans le champ Pattern dfinissant les champs dune ligne. Le pattern est une srie de longueurs correspondant aux valeurs de champs du fichier en entre. Les valeurs doivent tre saisies entre guillemets simples et spares par une virgule. Veillez ce que les valeurs saisies correspondent la longueur des champs dfinis dans le schma. Dans ce scnario, les champs den-tte (Header), de pied de page (Footer) et de limite (Limit) nont pas besoin dtre dfinis.
922
Composants File
Slectionnez le type de schma (Schema) pour dfinir les donnes transmettre au composant tFileOutputXML. Vous pouvez slectionner et/ou modifier le schma via la fonction Edit Schema. Pour ce schma, dfinissez trois colonnes, respectivement Contracts, CustomerRef et InsuranceNr correspondant aux trois valeurs de longueurs dfinies.
Puis dfinissez les proprits du composant de sortie. Saisissez le chemin daccs au fichier XML de sortie.
Saisissez une (ou plusieurs) balise racine (Root tag) pour envelopper la structure en sortie XML. Dans ce cas, la balise est ContractsList. Dfinissez la balise de la ligne (Row tag) qui dfinit chaque ligne. Dans ce cas, la balise est ContractRef. Cochez la case Column name as tag name pour rutiliser le libell des colonnes du schma dentre comme nom de balise pour structurer le fichier XML de sortie. Par dfaut, le nom de balise est field, quel que soit le type de valeur dans les colonnes.
923
Composants File
Saisissez lencodage (Encoding) du fichier dentre. Notez que pour linstant la vrification de lencodage nest pas fonctionnellement supporte. Slectionnez le type de schma dans le champ Schema type. Si vous avez dj mis en place la connexion entre les composants dentre et de sortie du Job, la propagation du schma est automatique. Sinon, cliquez sur Sync columns pour les synchroniser. Passez la vue Run et cliquez sur le bouton Run pour xecuter le Job. Le fichier est lu ligne par ligne et divis en champs bass sur les longueurs dfinies prcdemment dans le champ Pattern. Vous pouvez louvrir dans nimporte quel diteur XML standard.
924
Composants File
tFileInputMSPositional
Proprits du tFileInputMSPositional
Fonction Objectif
Le composant tFileInputMSPositional permet de lire des schmas multiples partir dun fichier positionnel. Le tFileInputMSPositional ouvre le fichier multi structure complexe, en lit la structure (schmas) puis utilise des liens de type Row pour envoyer les champs, tels quils ont t dfinis dans les diffrents schmas, vers les composants suivants dans le Job. 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. File Name Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Row separator Schema Identifier Field Position Records Chane de caractres (ex : \n sous Unix) sparant les lignes. Position de la chane de caractres identifiant les diffrents schmas. Schema : dfinissez autant de schmas que ncessaire. Schema Identifier value : valeur de la chane de caractres identifiant les diffrents schmas. Saisissez le nom de la colonne. Pattern : Chane de caractres reprsentant la longueur de chacune des colonnes du schma correspondant, spares par des virgules. Vrifiez que les valeurs dfinies dans ce champ sont cohrentes avec le schma dfini. Reject incorrect row size : cochez les cases des schmas pour lesquels vous nacceptez pas une taille de ligne incorrecte. Parent key column : Saisissez le nom de la colonne cl parente. Key column : Saisissez le nom de la colonne cl. Nombre de lignes ignorer au dbut du fichier. Nombre de lignes ignorer la fin du fichier. Nombre maximal de lignes traiter. Si Limit = 0, aucune ligne ne sera lue ni traite.
Basic settings
Skip from header Skip from footer Limit
925
Composants File
Die on parse error
Dcochez cette case pour passer les lignes contenant des erreurs de parse et terminer le traitement avec les lignes sans erreur. Dcochez cette case pour passer les lignes dont le type den-tte est inconnu et terminer le traitement avec les lignes sans erreurs. Cochez cette case afin de pouvoir traiter de longues lignes (ceci est ncessaire pour traiter des lignes contenant plus de 100 000 caractres). Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes. 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 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. Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Die on unknown header type Advanced settings Process long rows (needed for processing rows longger than 100,000 characters wide) Trim all columns Advanced separator (for numbers)
Encoding Type
Utilisation
Utilisez ce composant pour lire un fichier positionnel multi-schma et servez-vous dune valeur spcifiant lemplacement pour sparer les champs. Ce composant permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1330 du composant tFileInputXML.
Scnario associ
Pour un scnario associ, consultez le Scnario : Lecture dun fichier dlimit multi structure, page 895 du composant tFileInputMSDelimited.
926
Composants File
tFileInputProperties
Proprits du tFileInputProperties
Le composant tFileInputProperties lit un fichier texte ligne par ligne et extrait les champs. Il ouvre un fichier texte quil lit ligne par ligne, spare les champs sur le modle cl=valeur. 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. Pour ce composant, le schma est en lecture seule puisque les fichiers sont structurs sur le modle cl=valeur. Slectionnez le format de votre fichier .properties ou .ini. .properties : fichier de configuration dont les donnes sont disposes sur deux lignes et structures de la manire suivante cl=valeur. .ini : fichier de configuration dont les donnes sont disposes sur deux lignes, structures de la manire suivante cl=valeur.et regroupes en sections. Retrieve Mode : - Retrieve All pour rcuprer lintgralit du fichier, - Retrieve Sections pour rcuprer les sections du fichier, - Retrieve by section pour rcuprer les donnes contenues dans la section spcifie dans le champ Section Name. Section Name : saisissez le nom de la section sur laquelle effectuer lopration ditration. File Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Calculate MD5 Hash Cochez cette case pour que lalgorithme vrifie que le fichier est bien tlcharg.
File format
Utilisation
Utilisez ce composant pour lire un fichier et sparer les donnes en fonction de la structure cl=valeur du fichier.
Scnario : Lire et mapper la cl et les valeurs de fichiers properties et alimenter un glossaire

Le scnario suivant est un Job de quatre composants lisant deux fichiers proprits en anglais et en franais. Ces donnes sont ensuite mises en correspondance afin de constituer un glossaire.
927
Composants File
Les fichiers de proprits utiliss pour ce scnario sont des fichiers contenant les chanes de caractres utiliss pour la localisation du composant tMysqlInput de Talend Open Studio.
Cliquez-glissez deux composants tFileInputProperties de la famille File > Input dans le Job designer, un composant tMap de la famille Processing et un composant tLogRow de la famille Log & Errors. Reliez les composants entre eux via des connexions Row > Main. Double-cliquez sur le premier composant tFileInputProperties pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
928
Composants File
Dans le champ File Format, slectionnez le format de votre fichier. Dans le champ File Name, cliquez sur le bouton [...] et slectionnez le fichier .properties anglais que vous souhaitez utiliser. Rptez cette procdure avec le deuxime composant et le fichier franais :
Double-cliquez sur le composant tMap pour ouvrir son diteur :
Slectionnez toutes les colonnes de la table English_terms et glissez-les vers la table de sortie. Slectionnez la colonne key de la table English_terms et glissez-la dans la colonne key de la table French_terms. Dans le tableau glossary de la zone Schema editor en bas du tMap, renommez le champ value en EN puisquil contiendra les valeurs du fichier anglais.
Composants File
Cliquez sur le bouton [+] pour ajouter une ligne au tableau glossary et renommez-la FR. Dans le champ Length, configurez la taille maximum du champ 255. Slectionnez la colonne value de la table English_terms et glissez-la dans la colonne FR de la table French_terms. Cliquez sur OK. Dans le Job designer, double-cliquez sur le composant tLogRow pour paramtrer ses proprits dans la onglet Basic settings de la vue Component. Cliquez sur le bouton Sync Columns pour rcuprer le schma du composant prcdent. Enregitrez votre Job et appuyez sur F6 pour lexcuter.
Le glossaire apparat dans la console de la vue Run avec dans la premire colonne le nom de la cl, dans la deuxime le terme du fichier anglais et dans le troisime colonne le terme correspondant du fichier franais.
930
Composants File
tFileInputRegex
tFileInputRegex
Proprits du tFileInputRegex
Fonction Objectif
Puissant composant qui peut remplacer bon nombre des composants File. Il requiert des connaissances avances en rdaction dexpressions rgulires. Le tFileInputRegex lit un fichier ou un flux de donnes ligne par ligne afin de le diviser en champs laide dexpressions rgulires et denvoyer les champs dfinis dans le schma au composant suivant via une connexion Row. 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/Stream File name : Chemin daccs et nom du fichier, et/ou variable traiter. Stream : Flux de donnes traiter. Les donnes doivent pralablement tre mises en flux afin dtre rcupres par le tFileInputRegex via la variable INPUT_STREAM disponible dans la liste dauto-compltion (Ctrl+Espace). Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Row separator Regex Chane (ex : \n sous Unix) pour distinguer les lignes. Ce champ est compatible Perl ou Java et peut contenir plusieurs lignes. Intgrez vos expressions rgulires le subpattern correspondant aux champs extraire. En Java, doublez les antislashes en regexp La syntaxe Regexp est diffrente en Java et en Perl et requiert des guillemets respectivement doubles et simples. Header Footer Limit Nombre de lignes ignorer en dbut de fichier. Nombre de lignes ignorer en fin de fichier. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ni traite.
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.
931
Composants File
tFileInputRegex
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 stock dans le Repository. Ainsi, il est rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Skip empty rows Die on error Cochez cette case pour ignorer les lignes vides. 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. 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
Utilisation
Ce composant sert lire un fichier et en sparer les champs selon les Regex dfinies.Ce composant permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1330 du composant tFileInputXML. n/a
Limitation
Scnario : Transformer en fichier Regex en Positional

Le scnario suivant est un Job form de deux composants, qui a pour objectif de lire les donnes dun fichier dentre utilisant des expressions rgulires et transformant les donnes ainsi dlimites en sortie positionnelle.
Cliquez et dposez un composant tFileInputRegex et tFileOutputPositional de la Palette dans lespace de modlisation. Cliquez droit sur le composant tFileInputRegex et slectionnez une connexion Row > Main dans le menu contextuel. Faites glisser cette connexion vers le composant tFileOutputPositional et relchez lorsque le symbole appropri apparat. Slectionnez tFileInputRegex nouveau et dfinissez ses proprits dans longlet Component :
932
Composants File
tFileInputRegex
Les proprits de ce Job sont de type built-in. Par consquent, elles ne sont dfinies que pour ce Job et ne peuvent tre partages avec dautres utilisateurs. Indiquez le chemin daccs au fichier dans le champ File Name. Ce champ est obligatoire. Dfinissez le sparateur de lignes, dans le champ Row separator, afin didentifer la fin dune ligne. Puis, dans Regular expression, dfinissez lexpression rgulire utiliser pour dlimiter les champs dune ligne qui seront passs au composant suivant. Vous pouvez utiliser Java ou Perl et saisir une expression rgulire multiligne si vous en avez besoin.
Veillez utiliser la bonne expression rgulire en fonction de la langue de gnration de code que vous utilisez. En effet, la syntaxe nest pas la mme en Java et en Perl. Assurez-vous aussi dinsrer les expressions rgulires dans des guillemets simples ou doubles en fonction de la langue de gnration.
Assurez-vous dinclure dans cette expression tous les sous-patterns des champs extraire. Dans ce scnario, ignorez les champs en-tte (Header), pied de page (Footer) et limite (Limit). Dans le Schema, slectionnez local (Built-in) comme type de schma des donnes transfrer au composant tFileOutputPositional. Vous pouvez charger ou crer partir de la fonction Edit Schema. Puis dfinissez les proprits du deuxime composant :
933
Composants File
tFileInputRegex
Saisissez le chemin daccs au fichier de sortie. Saisissez lencodage du fichier de sortie dans le champ Encoding. Notez que pour linstant, lhomognit de lencodage dans un Job nest pas vrifie. Slectionnez le type de schma dans Schema. Cliquez sur le bouton Sync columns pour rcuprer en sortie le schma dentre. Passez longlet Run et cliquez sur le bouton Run pour excuter le Job. Le fichier dentre est lu ligne par ligne puis divis en champs dlimits selon la valeur de lexpression regulire dfinie. Vous pouvez ouvrir le fichier de sortie avec tout diteur standard.
934
Composants File
tFileInputXML
tFileInputXML
Le tFileInputXML appartient deux familles de composants : File et XML. Pour plus dinformations concernant le composant tFileInputXML, consultez tFileInputXML page 1326.
935
Composants File
tFileInputMSXML
tFileInputMSXML
Proprits du tFileInputMSXML
Famille du composant MXML ou File/Input
Fonction Objectif
Le composant tFileInputMSXML permet de lire des schmas multiples partir dun fichier XML structur et de les restituer en sortie. Le tFileInputMSXML ouvre le fichier multi structure complexe, en lit la structure (schmas) puis utilise des liens de type Row pour envoyer les champs, tels quils ont t dfinis dans les diffrents schmas, vers les composants suivants dans le Job. File Name Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Root XPath query Enable XPath in column Schema XPath loop But lose the order Racine de larborescence XML sur laquelle se base la requte. Cochez cette case si vous souhaitez dfinir un chemin XPath dans le champ Schema XPath loop du tableau Outputs. Cette option nest disponible quavec le mode de gnration dom4j. Vrifiez donc que ce mode a bien t slectionn dans la liste Generation mode dans longlet Advanced settings de votre composant. Si vous utilisez cette option, les donnes ne seront pas retournes dans lordre. Outputs Schema : dfinissez autant de schmas que ncessaire. Schema XPath loop : noeud ou chemin XPath de larborescence XML sur lequel la boucle est base. Si vous souhaitez utiliser un chemin XPath dans le champ Schema XPath loop, vous devez pralablement cocher la case Enable XPath in column Schema XPath loop but lose the order. XPath Queries : renseignez les champs extraire de la structure XML dentre. Create empty row : cochez les cases des schmas pour lesquels vous voulez crer des lignes vides. 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.
Basic settings
936
Composants File
tFileInputMSXML
Advanced settings
Trim all column Generation mode Encoding Type
Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes. Slectionnez le mode de gnration dans la liste. 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 mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant. Limitation n/a
Scnario : Lecture dun fichier XML multi structur

Le prsent scnario sert crer un Job en Java permettant de lire un fichier XML multi-schma et den afficher la structure sur la console de la vue Run. Le fichier XML trait dans ce scnario se prsente comme suit :
Cliquez et dposez le composant tFileInputMSXML et deux composants tLogRow dans lditeur graphique. Double-cliquez sur le tFileInputMSXML pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
937
Composants File
tFileInputMSXML
Dans le champ File Name, slectionnez le fichier XML que vous souhaitez traiter. Dans le champ Root XPath query, indiquez la racine de larborescence XML sur laquelle sera base la requte. Cochez la case Enable XPath in column Schema XPath loop But lose the order si vous souhaitez dfinir un chemin XPath dans le champ Schema XPath loop du tableau Outputs. Dans ce scnario, nous nutilisons pas cette option. Cliquez sur le bouton [+] pour ajouter des lignes au tableau Outputs dans lesquelles vous pouvez dfinir les schmas de sortie. Dans le tableau Outputs, cliquez dans chaque cellule Schema et cliquez sur le bouton [...] pour saisir le nom du schma dans la bote de dialogue qui souvre.
Saisissez le nom du schma de sortie et cliquez sur OK. Lditeur de schma du tFileInputMSXML apparat. Dfinissez le schma dj dfini dans le tableau Outputs. Effectuez cette procdure pour chaque schma de sortie que vous crez. Dans ce scnario, nous souhaitons dfinir deux schmas de sortie : record et book. Dans lditeur graphique, cliquez-droit sur le tFileInputMSXML et connectez-le aux tLogRow1 et tLogRow2 laide des liens record et book.
938
Composants File
tFileInputMSXML
Dans la vue Basic settings et dans la cellule Schema XPath loop, indiquez le noeud de larborescence XML sur laquelle sera base la requte. Dans la cellule XPath Queries, indiquez les champs extraire du fichier XML dentre. Cochez les cases Create empty row ct des noms des schmas dans lesquels vous souhaitez crer des lignes vides. Enregistrez votre Job et appuyez sur F6 pour lancer son excution. Les schmas spcifis sont extraits du fichier XML multi-schma et sont affichs dans la console. Le fichier XML multi-schma est lu ligne par ligne et les champs extraits sont affichs dans la console de la vue Run.
939
Composants File
tFileList
tFileList
Proprits du tFileList
Le composant tFileList fait une boucle sur les fichiers et/ou les dossiers dun rpertoire donn. Le tFileList rcupre un groupe de fichiers et/ou de dossiers suivant un masque donn et fait une boucle sur chacun deux. Directory FileList Type Chemin daccs au rpertoire de fichiers. Slectionnez partir de la liste droulante le type de source dentre utilis : Files pour des fichiers, Directories pour des rpertoires ou Both pour les deux types. Cochez cette case si le ou les rpertoires slectionn(s) contiennent des sous-dossiers. Cochez cette case pour crer un filtre selon la casse des noms des fichiers.
Include subdirectories Case Sensitive
Generate Error if no Cochez cette case pour tre averti par un message file found derreur que la recherche de fichier na pas abouti. Use Glob Expressions as Filemask (Unchecked means Perl5 Regex Expressions) Files Cette case est coche par dfaut et permet de filtrer les rsultats laide dexpressions globales (Glob Expressions). Dcochez la case pour filtrer les rsultats laide dexpressions de type regex Perl5. Cliquez sur le bouton [+] pour ajouter des lignes de filtre : Filemask : entrez un nom de fichier ou masque de fichier utilisant un caractre spcial ou une expression rgulire.
Utilisation
Le composant tFilelist fournit une liste de fichiers dun rpertoire donn sur lequel il fait une boucle.
Scnario : Itration sur un rpertoire

Le scnario suivant dcrit un Job de trois composants, qui a pour objectif de rpertorier les fichiers dun rpertoire donn, de lire chaque fichier par itration, de slectionner les donnes dlimites et dafficher ces donnes en sortie dans la console Run.
940
Composants File
tFileList
Cliquez et dposez les composants suivants : tFileList, tFileInputDelimited et tLogRow dans lespace de modlisation. Cliquez-droit sur le composant tFileList et connectez-le au composant tFileInputDelimited via une connexion de type Row Iterate. Puis connectez le tFileInputDelimited au tLogRow laide dune connexion de type Row Main. Paramtrez ensuite les proprits respectives des composants. Tout dabord, slectionnez le composant tFileList et cliquez sur longlet Basic settings :
Dans le champ Directory, indiquez le chemin daccs des fichiers traiter. Pour faire apparatre ce chemin daccs dans le Job lui-mme, utilisez le nom de champ (__DIRECTORY__) qui apparat en bulle info lorsque vous passez le souris sur le champ Directory. Saisissez cette rfrence dans le champ Label Format de longlet View.
Dans le champ FileList Type, slectionnez loption Files. Dfinissez le champ Case sensitive sur Yes pour prendre la casse en compte dans cet exemple. Laissez la case Use Glob Expressions as Filemask coche si vous utilisez des expressions globales pour filtrer les fichiers. Dans le champ Filemask, indiquez un masque de fichier. Utilisez les caractres spciaux si besoin est.
941
Composants File
tFileList
Paramtrez les proprits du deuxime composant tFileInputDelimited :
Dans le champ File Name, nommez le fichier laide dune variable contenant son chemin daccs, tel que vous lavez renseign dans les proprits du tFileList. Appuyez sur Ctrl+Espace pour accder la liste dautocompltion des variables. Slectionnez la variable globale ((String)globalMap.get("tFileList_1_CURRENT_FILEPATH")) si vous travaillez en Java, ou $_globals{tFileList_1}{CURRENT_FILEPATH} si vous travaillez en Perl. De cette manire, tous les fichiers du rpertoire source peuvent tre traits. Renseignez les autres champs comme pour un fichier dlimit tFileInputDelimited standard. Voir galement : Proprits du tFileInputDelimited, page 886. Slectionnez le composant de sortie tLogRow et renseignez le sparateur de champs qui saffichera dans la console de longlet Run. Voir galement : Proprits du tLogRow, page 1095.
942
Composants File
tFileList
Litration seffectue sur le rpertoire dfini. Chacun des fichiers contenus dans ce rpertoire est lu. Puis les donnes dlimites sont transmises au composant de sortie qui les affiche dans la console Log de la vue Run. Pour dautres scnarios utilisant le tFileList, consultez tFileCopy page 873
943
Composants File
tFileOutputARFF
tFileOutputARFF
Proprits du tFileOutputARFF
Famille de composant File/Output
Le composant tFileOutputARFF transmet des donnes vers un fichier ARFF. Ce composant crit un fichier ARFF contenant des donnes organises en fonction du schma dfini. 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 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 . File name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Attribute Define Reflte le schma tel quil est dfini dans la bote de dialogue Edit schema. Column : Nom de la colonne. Type : Type des donnes de la colonne. Pattern : Saisissez le modle (pattern) de la donne si ncessaire. Saisissez le nom de la relation. 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.
Relation Append Schema et Edit Schema
944
Composants File
tFileOutputARFF
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 dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. 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. Advanced settings Dont generate empty file Cochez cette case pour empcher la gnration dun fichier vide.
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Limitation Utilisez ce composant pour crire dans un fichier ARFF des donnes rcupres dautres composants laide dune connexion de type Row. n/a
Scnario associ
Pour un scnario associ, consultez le Scnario : Afficher le contenu dun fichier ARFF, page 883.
945
Composants File
tFileOutputDelimited
Proprits du tFileOutputDelimited
Le composant tFileOutputDelimited transmet des donnes vers un fichier dlimit. Ce composant crit un fichier dlimit contenant des donnes organises en fonction du schma dfini. 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 Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Row separator Field separator Append Include header Compress as zip file Schema et Edit Schema Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire pour sparer les champs du fichier de sortie. Cochez cette option pour ajouter de nouvelles lignes la fin du fichier. Cochez cette case pour tenir compte de len-tte dans le fichier de sortie. Cochez cette case pour compresser en zip le fichier de sortie. 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 dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
946
Composants File
Sync columns
Cliquez sur ce bouton pour synchroniser le schma de sortie avec celui dentre. La fonction Sync ne saffiche que si une connexion de type Row est lie au composant de sortie. 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. Cochez cette case pour prendre en compte les paramtres spcifiques aux fichiers CSV, notamment la manire de protger les caractres dans le champ Escape char et le type de guillemet dans le champ Enclosure.
Advanced settings
CSV options
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. Split output in several files Si le fichier dlimit en sortie est volumineux, vous pouvez le scinder en plusieurs fichiers. Rows in each output file : saisissez le nombre de lignes pour chaque fichier de sortie. Cochez cette case pour personnaliser le nombre de lignes crire avant de vider le tampon. Row Number: Nombre de lignes crire avant de vider le tampon. Sortie en mode ligne. 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. Cochez cette case pour empcher la gnration dun fichier vide.
Custom the flush buffer size
Output in row mode Encoding Type
Dont generate empty file
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Limitation Utilisez ce composant pour crire dans un fichier dlimit des donnes rcupres dautres composants laide dune connexion de type Row. n/a
Scnario : Ecrire des donnes dans un fichier dlimit

Ce scnario est constitu de trois composants et a pour objectif dextraire certaines donnes dun fichier contenant des informations sur les clients (customers) puis de les crire dans un fichier dlimit en sortie. Dans lexemple suivant, nous avons enregistr les informations de connexion et les mtadonnes dans le Repository afin de faciliter leur rutilisation. Pour plus dinformations sur comment centraliser les donnes de connexion et autres mtadonnes dun fichier dans le Repository, consultez Configurer un schma File Delimited page 216.
Composants File
Dans le Repository, ouvrez le noeud File Delimited de la catgorie Metadata. Cliquez sur la mtadonne customers, et dposez-le dans lespace de modlisation graphique. Une bote de dialogue souvre et vous demande quel type de composant vous voulez dposer.
Cliquez sur tFileInputDelimited puis sur OK. Double-cliquez sur le composant afin dafficher la vue Component, afin de paramtrer les informations de connexion et dfinir le schma des donnes d'entre.
Si vous slectionnez Repository dans la liste Property Type, les champs suivants seront automatiquement renseigns partir des informations centralises dans le Repository. Si vous slectionnez le mode Built-In, renseignez les champs manuellement. Cliquez sur le bouton [...] correspondant au champ File Name. Dans la bote de dialogue de slection, parcourez le systme de fichiers et slectionnez le fichier dentre, dans cet exemple: customer.csv.
948
Composants File
Dans les champs Row et Field Separators, saisissez respectivement le sparateur de lignes "\n" et le sparateur de champs ";". Si votre fichier contient des en-ttes ou des pieds-de-page, indiquez le nombre de lignes concernes dans les champs Header et Footer. Si vous avez slectionn le mode Repository, le schma du fichier sera automatiquement renseign. En mode Built-in, cliquez sur Edit Schema afin de dcrire les donnes dentre, et ainsi dfinir le schma trait. Le schma du fichier Customers se prsente comme suit :
Cliquez sur OK. Dans la Palette, ouvrez la famille Processing et slectionnez le composant tMap. Glissez-le dans lespace de modlisation graphique. Reliez le composant dentre customers au composant tMap. Pour ce faire, cliquez-droit sur Customers, et, dans le menu droulant, slectionnez Row, puis Main. Cliquez sur le tMap pour crer le lien. Double-cliquez ensuite sur le tMap afin douvrir son diteur.
949
Composants File
Dans cet diteur, crez une nouvelle table, droite. Cliquez sur le bouton plus vert en haut droite, et renseignez le nom de la table ainsi cre (row2 par exemple) dans la bote de dialogue [Add a new output table].
Cliquez sur OK. Dans la table de gauche (row1), slectionnez les trois premires lignes (Id, CustomerName et CustomerAddress) en appuyant sur Ctrl, puis glissez-les dans la table de droite. Dans le Schema editor en bas de lditeur, changez le Type de la ligne RegisterTime, dans la table de droite, et passez-le en chane de caractres, String.
Cliquez sur OK pour enregistrer les modifications et fermer lditeur. Dans la Palette, ouvez la famille File, puis la catgorie Output, puis glissez le composant tFileOutputDelimited dans lespace de modlisation graphique. Reliez ensuite le tMap au composant tFileOutputDelimited. Pour cela, cliquez-droit sur le composant tMap, et, dans le menu droulant, slectionnez Row, puis row2. Cliquez sur le tFileOutputDelimited pour crer le lien.
Composants File
Double-cliquez sur le composant tFileOutputDelimited pour ouvrir la vue Component.
Dans le champ Property Type, slectionnez le mode Built-in et renseignez les champs suivants manuellement. Cliquez sur le bouton [...] correspondant au champ File Name. Dans la bote de dialogue de slection, indiquez le rpertoire de destination et le nom de votre fichier. Pour les champs Row et Field Separators, saisissez respectivement le sparateur de lignes \n et le sparateur de champs ;. Ils seront utiliss dans le fichier de sortie pour dlimiter les valeurs et les lignes. Cochez la case Include Header si vous souhaitez rcuprer le libell des colonnes. Cliquez sur Edit schema et assurez-vous que le schma est correctement rcupr du schma dentre. Si ncessaire, cliquez sur Sync Columns pour rcuprer le schma du composant prcdent. Pour excuter le job, appuyez sur F6.
Le fichier cr est dlimit par des points-virgules, il ne contient que les colonnes Id, CustomerName et CustomerAddress.
951
Composants File
tFileOutputMSDelimited
Proprits du tFileOutputMSDelimited
Famille du composant File/Output
Fonction Objectif
Le composant tFileOutputMSDelimited permet dcrire des schmas multiples dans un fichier dlimit. Le tFileOutputMSDelimited cre un fichier dlimit multi structure complexe laide de la structure des donnes (schmas) venant des diffrents flux dentre de type Row. File Name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Row Separator Field Separator Use Multi Field Separators Schemas Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Cochez cette case attribuer un sparateur diffrent chacun des schmas, partir de la colonne Field separator du champ Schemas. La table est automatiquement charge avec des schmas rsultant des diffrents flux dentre connects au composant tFileOutputMSDelimited. Renseignez les relations de dpendance entre les diffrents schmas : Parent row : Saisissez le nom du flux pre (en fonction du nom du lien Row qui transfre les donnes). Parent key column : Saisissez le nom de la colonne cl du flux pre. Key column : Saisissez le nom de la colonne cl pour la ligne slectionne. 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. Cochez cette case pour prendre en compte les paramtres spcifiques aux fichiers CSV, notamment la manire de protger les caractres dans le champ Escape char et le type de guillemet dans le champ Text enclosure. Cette case est coche par dfaut. Cette option permet de crer le dossier contenant le fichier dlimit de sortie sil nexiste pas dj.
Basic settings
Advanced settings
CSV options
Create directory if not exists
952
Composants File
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. Cochez cette case pour annuler la gnration du fichier si celui-ci est vide. Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Dont generate empty file tStatCatcher Statistics
Utilisation
Utilisez ce composant pour crire un fichier dlimit multi structure et sparer les champs laide dun sparateur de champ.
Scnario associ
953
Composants File
tFileOutputEBCDIC
tFileOutputEBCDIC
Ce composant requiert lutilisation dun JDK Sun.
Proprits du tFileOutputEBCDIC
Le composant tFileOutputEBCDIC crit un fichier EBCDIC partir de plusieurs fichiers de donnes diffrents ayant chacun un schma diffrent. Ce composant crit un fichier EBCDIC avec des donnes extraites de fichier(s) en fonction des schmas dcrivant leur structure. 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 Chemin daccs et nom du fichier EBCDIC de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Xc2j file Slectionnez le fichier xc2j de transformation.
Utilisation
Utilisez ce composant pour crire un fichier EBCDIC et sparer les donnes en fonction des schmas identifis dans les fichiers en entre.
Scnario : Crer un fichier EBCDIC partir de deux fichiers dlimits

Ce scnario utilise lassistant [Copybook Connection] guidant lutilisateur travers les diffrentes tapes de cration de connexion au fichier Copybook et de rcupration des schmas EBCDIC. Lassistant [Copybook Connection] 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 tFileOutputEBCDIC manuellement.
Le scnario suivant est un Job de trois composants ayant pour objectif dcrire un fichier au format EBCDIC partir de deux fichiers dlimits ayant des schmas diffrents.
954
Composants File
tFileOutputEBCDIC
Ce scnario Java utilise lassistant EBCDIC Connection pour crer une connexion au fichier Copybook et gnrer un fichier xc2j permettant de rcuprer et de transformer les diffrents schmas du fichier. Crez une connexion au fichier Copybook dcrivant la structure dun fichier EBCDIC. Dans ce scnario la connexion Copybook est appele EBCDIC. Rcuprez le schma du fichier. Une fois la connexion au fichier Copybook cre et les schmas rcuprs laide des assistants EBCDIC et Schema, ils apparaissent sous le noeud Metadata > Copybook. Ces nouveaux schmas sappellent Schema01, Schema04 et Schema05. Pour crer un fichier EBCDIC partir de deux fichiers dlimits dans Talend Open Studio : Cliquez et dposez deux composants tFileInputDelimited et un composant tFileOutputEBCDIC dans lditeur graphique. Pour les relier, cliquez-droit sur chaque composant tFileInputDelimited, slectionnez Row > Main dans le menu contextuel et cliquez sur le composant tFileOutputEBCDIC. Double-cliquez sur le premier tFileInputDelimited pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
Dans le champ File Name, slectionnez le fichier dlimit en cliquant sur le bouton [...] Dans le champ Schema, slectionnez loption Repository, puis cliquez sur le bouton [...] et slectionnez le schma correspondant votre fichier dans la bote de dialogue, sous le noeud Copybook.
Composants File
tFileOutputEBCDIC
Dans le champ Header, indiquez le nombre de ligne en-tte rcuprer et passer au composant suivant : 1 dans ce scnario. Paramtrez les proprits du deuxime tFileInputDelimited de la mme manire que le premier. Double-cliquez sur le tFileOutputEBCDIC pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
Dans le champ Data file, indiquez le rpertoire et le nom du fichier EBCDIC qui sera cr partir des deux fichiers dlimits. Dans le champ Xc2j file, renseignez le chemin daccs au fichier permettant dextraire le schma dcrivant la structure du fichier EBCDIC. Enregistrez votre Job via Ctrl+S et cliquez sur la vue Run, cochez les cases Statistics et Exec time puis cliquez sur Run pour excuter le Job
956
Composants File
tFileOutputExcel
tFileOutputExcel
Proprits du tFileOutputExcel
Le composant tFileOutputExcel transmet des donnes vers un fichier de type MS Excel. Ce composant crit un fichier MS Excel contenant des donnes organises en fonction du schma dfini. File name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Sheet name Include header Append existing file Nom de la feuille. Cochez cette case pour tenir compte de len-tte dans le fichier de sortie. Cochez cette option pour ajouter de nouvelles lignes la fin du fichier. Append existing sheet : Cochez cette option pour ajouter de nouvelles lignes la fin de la feuille Excel. Cochez cette case pour rajouter des informations dans des cellules prexistantes : First cell X : emplacement de la cellule sur laxe des abcisses. First cell Y : emplacement de la cellule sur laxe des ordonnes. Keep existing cell format : lorsque la case est coche, cette option permet de garder le format et lalignement de la cellule. Slectionnez dans la liste droulante la police utiliser. Cette case est dcoche par dfaut, vous pouvez alors prciser dans le tableau associ quelles sont les colonnes dfinir automatiquement. Cochez cette case pour que la taille de toutes les colonnes soit dfinies automatiquement. 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.
Is absolute Y pos.
Font Define all columns auto size
957
Composants File
tFileOutputExcel
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. Sync columns Cliquez sur ce bouton pour synchroniser le schma de sortie avec celui dentre. La fonction Sync ne saffiche que si une connexion de type Row est lie au composant de sortie.
Advanced settings
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. Advanced separator (for numbers) 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 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 mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Limitation Utilisez ce composant pour crire dans un fichier MS Excel des donnes rcupres dautres composants laide dune connexion de type Row. n/a
Scnario associ
958
Composants File
tFileOutputLDIF
tFileOutputLDIF
Proprits du tFileOutputLDIF
Fonction Objectif
Le composant tFileOutputLDIF extrait des donnes vers un fichier LDIF qui peut ensuite tre charg dans un annuaire LDAP. Le tFileOutputLDIF crit ou modifie un fichier LDIF avec des donnes dlimites en entre selon le schma dfini. Peut galement supprimer le contenu dun fichier LDIF. File name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Wrap Change type Place un retour chariot aprs le nombre de caractres dfini. Slectionnez Add, Modify ou Delete pour respectivement crer un nouveau fichier LDIF, modifier ou supprimer un fichier LDIF. En cas de modification, paramtrez le type de modification apporte. 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 dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Sync columns Cliquez pour synchroniser le schma du fichier de sortie avec le schma du fichier dentre. La fonction Sync napparat quune fois la connexion Row mise en place entre les composants dentre et 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. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. 959
Basic settings
Encoding
Append
Composants File
tFileOutputLDIF
Advanced settings
Advanced separator
Cochez cette case pour modifier les sparateurs de lignes utiliss.
Create directory if not Cochez cette case pour crer un nouveau dossier si exists votre dossier de destination nexiste pas. Custom the flush buffer size Cochez cette case pour personnaliser le nombre de lignes crire avant de vider le tampon. Row Number: Nombre de lignes crire avant de vider le tampon. 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 Job, ainsi quau niveau de chaque composant. Utilisation Limitation Utilisez ce composant pour crire un fichier LDIF laide des donnes provenant dautres composants relis par une connexion de type Row. n/a
Scnario : Ecrire des donnes dans un fichier LDIF

Ce scnario est constitu de deux composants et a pour objectif dextraire les donnes dune table de base de donnes puis dcrire ses donnes dans un fichier LDIF de sortie.
Cliquez et dposez les composants tMysqlInput et tFileOutputLDIF de la Palette dans lespace de modlisation. Connectez les deux composants laide dun lien Row > Main. Slectionnez le composant tMysqlInput et cliquez sur longlet Basic settings de la vue Component. Si vous conservez les informations de connexion votre base de donnes dans la zone Metadata du Repository, slectionnez loption Repository dans le champ Property type . De mme, dans le champ Schema type, slectionnez le schma correspondant parmi les mtadonnes si votre schma est galement stock dans le Repository. Tous les paramtres de connexion comme de schma sont ainsi rcuprs.
960
Composants File
tFileOutputLDIF
Sinon, slectionnez Built-in dans les champs Property type et Schema et paramtrez manuellement votre connexion la base de donnes et les informations du schma. Puis double-cliquez sur le composant tFileOutpuLDIF et paramtrez ses proprits dans longlet Basic settings. Renseignez le nom et le chemin daccs au fichier LDIF. Sil nexiste pas, le Job se chargera de le crer. Dans le champ Wrap, saisissez le nombre de caractres contenus sur une ligne. Les caractres qui suivent seront automatiquement placs sur la ligne suivante.
Slectionnez Add dans le champ Change Type puisque, par dfinition, un ficher nouvellement cr est vide. Dans le cas dune modification, vous devrez dfinir la nature de la modification que vous souhaitez effectuer dans le fichier. Dans le champ Schema, slectionnez loption Built-in et cliquez sur Sync Columns pour rcuprer la dfinition du schma dentre. Appuyez sur F6 pour excuter le Job.
961
Composants File
tFileOutputLDIF
Le fichier LDIF cr comporte les donnes de la table de la base de donnes et le type de changement effectu sur le fichier est, dans ce cas, dfini comme : addition.
962
Composants File
tFileOutputPositional
Proprits du tFileOutputPositional
Le composant tFileOutputPositional crit un fichier ligne par ligne en se basant sur la longueur et le format des champ ou colonnes dune ligne. Il crit un fichier ligne par ligne, en se basant sur la structure des donnes (schma) venant du flux dentre. 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. File Name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. 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. 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 Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Row separator Append Include header Compress as zip file Chane (ex : \n sous Unix) sparant les lignes. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Cochez cette case pour tenir compte de len-tte dans le fichier de sortie. Cochez cette case pour compresser en zip le fichier de sortie.
963
Composants File
Formats
Personnalisez le format des donnes du fichier positionnel et renseignez les colonnes du tableau Formats. Column : Slectionnez la colonne que vous souhaitez personnaliser. Size : Saisissez la taille correspondant la colonne. Padding char : Saisissez entre guillemets le caractre de remplissage utiliser. Le caractre par dfaut est un espace. Alignment : Slectionnez le paramtre dalignement appropri. Keep : Si les donnes contenues dans la colonne ou dans le champ sont trop longues, slectionnez la partie que vous souhaitez garder. Cochez cette case pour modifier les sparateurs de lignes utiliss. Cochez cette case pour crer un nouveau dossier si votre dossier de destination nexiste pas. Cochez cette case pour personnaliser le nombre de lignes crire avant de vider le tampon. Row Number: Nombre de lignes crire avant de vider le tampon. 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 empcher la gnration dun fichier vide. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Advanced settings
Advanced separator Create directory if not exists Custom the flush buffer size
Encoding Type
Dont generate empty file tStatCatcher Statistics
Utilisation
Utilisez ce composant pour lire un fichier et sparer les champs laide du sparateur spcifi.
Scnario associ :
Pour un scnario associ, consultez Scnario : Transformer un fichier positionnel en XML, page 922.
964
Composants File
tFileOutputMSPositional
tFileOutputMSPositional
Proprits du tFileOutputMSPositional
Famille du composant File/Output
Le composant tFileOutputMSPositional permet dcrire des schmas multiples dans un fichier positionnel. Le tFileOutputMSPositional cre un fichier multi structure complexe laide de la structure des donnes (schmas) venant des diffrents flux dentre de type Row. File Name Chemin daccs et nom du fichier crer, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Row separator Schemas Chane (ex : \n sous Unix) sparant les lignes. La table est automatiquement charge avec des schmas rsultant des diffrents flux dentre connects au composant tFileOutputMSPositional. Renseignez les relations de dpendance entre les diffrents schmas : Parent row : Saisissez le nom du flux pre (en fonction du nom du lien Row qui transfre les donnes). Parent key column : Saisissez le nom de la colonne cl du flux pre. Key column : Saisissez le nom de la colonne cl pour la ligne slectionne. Pattern : Saisissez le modle (pattern) qui permet de positionner les sparateurs de champ pour chaque ligne dentre. Padding char : Saisissez entre guillemets le caractre de remplissage utiliser. Le caractre par dfaut est un espace. Alignment : Slectionnez le paramtre dalignement appropri.
Utilisation
Utilisez ce composant pour crire un fichier positionnel multi structure et sparer les champs laide dun sparateur de position.
Scnario associ
965
Composants File
tFileOutputProperties
tFileOutputProperties
Proprits du tFileOutputProperties
Le composant tFileInputProperties crit un fichier de configuration de type ini ou properties. Il crit un fichier de configuration contenant des donnes texte organises sur le modle cl=valeur. 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. Pour ce composant, le schma est en lecture seule puisque les fichiers sont structurs sur le modle cl=valeur. Slectionnez le format de votre fichier .properties ou .ini. .properties : fichier de configuration dont les donnes sont disposes sur deux lignes et structures de la manire suivante cl=valeur. .ini : fichier de configuration dont les donnes sont disposes sur deux lignes, structures de la manire suivante cl=valeur. et regroupes en sections.. Section Name : saisissez le nom de la section sur laquelle effectuer lopration ditration. Append File Name Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio.
File format
Utilisation
Utilisez ce composant pour crire un fichier dont les donnes sont organises selon la structure cl=valeur.
Scnario associ
Pour un scnario associ, consultez le Scnario : Lire et mapper la cl et les valeurs de fichiers properties et alimenter un glossaire, page 927 du composant tFileInputProperties.
966
Composants File
tFileOutputXML
tFileOutputXML
Le tFileOutputXML appartient deux familles de composants : File et XML. Pour plus dinformations concernant le composant tFileOutputXML, consultez tFileOutputXML page 1334.
967
Composants File
tFileOutputMSXML
tFileOutputMSXML
Proprits du tFileOutputMSXML
Fonction Objectif
Le composant tFileOutputMSXML permet dcrire des schmas multiples dans un fichier XML structur. tFileOutputMSXML cre un fichier XML multi structure complexe laide de la structure des donnes (schmas) venant des diffrents flux dentre de type Row. File Name Chemin daccs et nom du fichier crer, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Configure XML tree Ouvre linterface ddie pour vous aider mettre en place le mapping XML. Pour plus de dtails sur linterface, voir Dfinir un arbre XML Multischma, page 968.
Basic settings
Limitation
n/a
Dfinir un arbre XML Multischma

Double-cliquez sur le composant tFileOutputMSXML pour ouvrir linterface ddie ou cliquez sur le bouton [...] de longlet Basic settings de la vue Component.
968
Composants File
tFileOutputMSXML
La liste droulante de la zone Linker source, gauche de linterface, contient tous les schmas dentre qui peuvent tre ajouts au fichier XML multischma de sortie ( la condition que plusieurs flux dentre soient connects au composant tFileOutputMSXML). Dans le champ Schema List, on retrouve la liste de toutes les colonnes rcupres du flux dentre de la slection. Sur la droite de linterface, dfinissez la structure XML que vous souhaitez obtenir dans le fichier XML en sortie. Vous pouvez la crer manuellement ou tout simplement importer la structure XML. Puis importez les colonnes de chaque schma dentre de la slection dans llment de larbre XML correspondant. Importer un arbre XML Le meilleur moyen de renseigner larbre XML est dimporter un fichier XML bien form. Dans la colonne XML Tree, cliquez une fois sur le champ root tag, qui saffiche par dfaut, pour le renommer. Cliquez droit sur ce champ pour afficher le menu contextuel. Dans le menu, slectionnez Import XML tree. Slectionnez le fichier importer et cliquez sur OK.
969
Composants File
tFileOutputMSXML
La colonne XML Tree est donc automatiquement renseigne avec les bons lments. Vous pouvez supprimer et ajouter des lments ou des sous lments larbre : Slectionnez llment adquat dans larbre. Cliquez-droit pour faire apparatre le menu contextuel. Slectionnez Delete pour supprimer la slection de larbre ou slectionnez loption adquate parmi les suivantes : Add sub-element, Add attribute, Add namespace pour enrichir larbre.
970
Composants File
tFileOutputMSXML
Crer manuellement larbre XML Si vous ne possdez pas de structure XML dj dfinie, vous pouvez la crer manuellement. Dans la colonne XML Tree, cliquez une fois sur le champ root tag, qui saffiche par dfaut, pour le renommer. Cliquez droit sur ce champ pour afficher le menu contextuel. Dans le menu, slectionnez Add sub-element pour crer le premier lment de la structure. Vous pouvez aussi ajouter un attribut ou un lment enfant nimporte quel lment de larbre ou supprimer nimporte quel lment de larbre. Slectionnez llment adquat dans larbre que vous venez de crer. Cliquez-droit gauche du nom de llment pour afficher le menu contextuel. Dans le menu, slectionnez loption adquate parmi les suivantes : Add sub-element, Add attribute, Add namespace ou Delete.
Mapping de donnes XML partir de sources multischma

Une fois votre arbre XML cr, slectionnez le premier schma mapper. Vous pouvez alimenter chaque lment ou sous-lment XML avec les colonnes du flux dentre dans la colonne Related Column : Cliquez sur lune des entres de la colonne Schema column name. Glissez-la dans le sous-lment correspondant droite. Relchez-la pour que le mapping soit effectif.
Une flche bleue apparat pour illustrer ce mapping. Sil est disponible, utilisez le bouton Auto-Map situ en bas gauche de linterface, il permet deffectuer cette opration automatiquement. Vous pouvez dconnecter nimporte quel mapping de nimporte quel lment de larbre XML : Slectionnez llment de larbre XML que vous souhaitez dconnecter de sa source respective.
971
Composants File
tFileOutputMSXML
Cliquez-droit gauche de son nom pour afficher le menu contextuel. Slectionnez Disconnect linker. La flche bleue disparat.
Dfinir le statut du noeud

Dfinir larbre XML et le transfert de donnes ne suffit pas. Vous devez aussi dfinir les lments sur lesquels la boucle est effectue pour chacune des sources de la slection et, si ncessaire, llment partir duquel le regroupement est effectu. Elment Boucle Llment Boucle permet de dfinir llment objet dune itration. Llment Boucle est gnralement un gnrateur de lignes. Pour dfinir un lment comme un lment Boucle : Slectionnez llment adquat dans larbre XML. Cliquez-droit gauche du nom de llment pour afficher le menu contextuel. Slectionnez loption Set as Loop Element.
La colonne Node Status affiche le nouveau statut slectionn.

Il ne peut y avoir quun seul lment Boucle la fois.
Elment Group Llment Group est optionnel, il reprsente un lment constant sur lequel est effectue une fonction Groupby. Llment Group ne peut tre dfini que si un lment Boucle a t pralablement dfini. Lorsque vous utilisez un lment Group, les lignes doivent tre tries pour pouvoir tre regroupes par le noeud slectionn.
Composants File
tFileOutputMSXML
Pour dfinir un lment comme lment Group : Slectionnnez llment adquat dans larbre XML. Cliquez-droit gauche du nom de llment pour afficher le menu contextuel. Slectionnez loption Set as Group Element.
La colonne Node Status affiche le nouveau statut slectionn et tout autre statut de regroupement est automatiquement dfini, si ncessaire. Une fois le mapping termin, cliquez sur OK pour valider les paramtres et continuez la configuration de votre Job.
Scnario associ
973
Composants File
tFileProperties
tFileProperties
Proprits du tFileProperties
Le composant tFileProperties permet de crer un flux monoligne affichant les proprits du fichier trait. Le tFileProperties permet de recueillir les informations concernant les proprits principales dun fichier dfini. 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 dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Edit schema File :Le nombre de lignes en lecture seule est diffrent sous Java et sous Perl. Chemin daccs et nom du fichier traiter, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Calculate MD5 Hash Cochez cette case pour vrifier le MD5 du fichier tlcharg.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant peut tre utilis en standalone. n/a
Scnario : Afficher les proprits dun fichier trait

Ce scnario Java dcrit un Job trs simple permettant dafficher les proprits dun fichier spcifi. A partir de la Palette, cliquez-dposez les composants tFileProperties et tLogRow dans lditeur graphique.
974
Composants File
tFileProperties
Cliquez-droit sur le tFileProperties et connectez-le au tLogRow laide dun lien de type Main Row.
Dans lditeur graphique, slectionnez le composant tFileProperties. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileProperties.
Configurez le champ Schema Type en mode Built in.. Cliquez sur le bouton [...] du champ Edit schema si vous voulez voir les colonnes read-only. Dans le champ File, entrez le chemin daccs ou parcourez vos dossiers jusquau fichier dont vous voulez afficher les proprits. Dans lditeur graphique, slectionnez le tLogRow et cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations, consultez le composant tLogRow, page 1095. Enregistrez le Job et appuyez sur F6 pour lexcuter.
Les proprits du fichier dfini saffichent dans la console Run.
975
Composants File
tFileRowCount
tFileRowCount
Proprits du tFileRowCount
Le composant tFileRowCount compte le nombre de lignes dans un fichier. Ce composant ouvre un fichier et le lit ligne par ligne afin de dterminer le nombre de lignes quil contient. File Name Chemin daccs et nom du fichier traiter, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Row separator Ignore empty rows Encoding Type Chane (ex : \n sous Unix) sparant les lignes. Cochez cette case pour que les lignes vides ne soient pas prises en compte. 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. Cochez cette case pour collecter les donnes de log au niveau du composant.
Le tFileRowCount est un composant standalone, et doit tre utilis avec un lien de type OnSubjobOk vers un tJava.
Scnario associ :
976
Composants File
tFileTouch
tFileTouch
Proprits du tFileTouch
Le composant tFileTouch cre un fichier vide. Ce composant cre un fichier vide, et cre le rpertoire de destination sil nexiste pas. File Name Chemin daccs et nom du fichier crer, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Create directory if not exists Cochez cette case pour crer un nouveau dossier si votre dossier de destination nexiste pas. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant peut tre utilis en standalone.
Scnario associ :
977
Composants File
tFileUnarchive
tFileUnarchive
Proprits du tFileUnarchive
Le composant tFileUnarchive dzippe un fichier archive en fonction des paramtres dfinis et le place dans le rpertoire souhait. Ce composant dzippe un fichier archive de nimporte quel format (zip, rar, etc.) pour un ventuel traitement. Archive file Extract Directory Chemin daccs au fichier archive. Rpertoire dans lequel le fichier dzipp sera plac.
Java uniquement Perl uniquement Utilisation Limitation
Use archive name as Cochez cette case pour reproduire le chemin root directory / daccs au fichier ou sil nexiste pas, un nouveau Extract file paths dossier sera cr. Use Command line tools Cochez cette case pour utiliser un autre dzippeur que celui utilis par dfaut par Perl.
Ce composant peut tre utilis en standalone mais il peut aussi tre utilis en composant de dpart dans un Job via un lien Iterate. n/a
Scnario associ
Pour un exemple dutilisation du composant tFileUnarchive, consultez tFileCompare page 870
978
Composants File
tPivotToColumnsDelimited
Proprits du tPivotToColumnsDelimited
Le composant tPivotToColumnsDelimited extrait les donnes en fonction dune opration dagrgation exerce sur une colonne pivot. Le tPivotToColumnsDelimited permet dajuster la slection de donnes transmettre en sortie. Pivot column Aggregation column Aggregation function Slectionnez la colonne qui sert de pivot pour lopration dagrgation dans le flux dentre. Slectionnez la colonne contenant les donnes agrger dans le flux dentre. Slectionnez la fonction utiliser dans le cas o plusieurs valeurs sont disponibles dans la colonne pivot. Dfinissez les ensembles dagrgation dont les valeurs qui sont utilises pour les calculs. Input Column : Faites le lien entre les libells des colonnes dentre et ceux des colonnes de sortie, dans le cas o vous souhaitez que les libells du schma de sortie soient diffrents du schma dentre. File Name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Field separator Row separator Caractre, chane ou expression rgulire pour sparer les champs du fichier de sortie. Chane (ex : \n sous Unix) sparant les lignes.
Group by
Ce composant ncessite un flux dentre. n/a
Scnario : Utiliser une colonne pivot pour agrger des donnes

Le scnario suivant dcrit un Job qui agrge des donnes dun fichier dentre dlimit laide dune colonne pivot.
979
Composants File
Cliquez sur les composants suivant et dposez-les dans lespace de modlisation : tFileInputDelimited, tPivotToColumnsDelimited. Le fichier utiliser en entre est compos de 3 colonnes : ID, Question et les rponses correspondantes : Answer
Dans lespace de modlisation, slectionnez le composant tFileInputDelimited. Dfinissez ses proprits dans longlet Basic settings de la vue Component.
Slectionnez le fichier dentre pour renseigner le champ File Name. Dfinissez les sparateurs de lignes (Row) et de champs (Field), respectivement : retour chariot et point virgule, dans cet exemple. Le fichier contient un en-tte, ainsi dfinissez-le. Paramtrez le schma avec les trois colonnes : ID, Questions, Answers.
980
Composants File
Puis slectionnez le composant tPivotToColumnsDelimited et paramtrez ses proprits dans longlet Basic Settings de la vue Component.
Dans le champ Pivot column, slectionnez la colonne pivot dans le schma dentre. La colonne pivot est gnralement celle prsentant le plus de doublons (valeurs dagrgation pivot). Dans le champ Aggregation column, slectionnez la colonne agrger dans le schma dentre. Dans le champ Aggregation function, slectionnez la fonction effectuer lorsque des doublons sont trouvs. Dans la table Group by, ajoutez une entre dans la colonne Input column, qui sera utilise pour regrouper la colonne agrge. Dans le champ File Name, indiquez le chemin daccs et le nom du fichier de sortie. Et dans les champs Row et Field separator, paramtrez les sparateurs pour les lignes et donnes de sortie ayant t agrges. Puis, appuyez sur F6 pour excuter le Job. Le fichier de sortie affiche les donnes qui viennent dtre agrges.
981
Composants File
982
Composants Internet
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille Internet de la Palette de Talend Open Studio. La famille Internet regroupe les composants vous permettant daccder du contenu stock sur Internet, des services Web aux e-mails en passant par les flux RSS, le SCP, le MOM, le FTP, etc.
Composants Internet
tFileFetch
tFileFetch
Proprits du tFileFetch
Famille de composant Internet
Le composant tFileFetch rcupre un fichier partir dun protocole. Ce composant permet de rcuprer des donnes dun fichier partir dun protocole. Protocol Slectionnez parmi la liste suivante le protocole utiliser, puis renseignez les champs correspondants : http, https, ftp, smb. Les proprits peuvent diffrer lgrement en fonction du type de protocole slectionn. Les champs additionnels sont dfinis dans ce tableau la suite des proprits gnrales. URI Use cache to save the resource Saisissez lURI du site sur lequel le fichier doit tre rcupr. Cochez cette case pour enregistrer les donnes dans le cache. Cette option vous permet de traiter directment le flux de donnes du fichier (en mode stream) sans sauvegarder ce fichier sur votre disque. Elle permet donc un gain de temps et de performance.
smb smb
Domain Username et Password Destination directory Destination Filename
Saisissez le nom du domaine du serveur Microsoft. Saisissez lidentifiant utilisateur et le mot de passe de connexion au serveur. Slectionnez le rpertoire de destination dans lequel le fichier rcupr sera plac. Saisissez le nouveau nom du fichier rcupr. Cette case est coche par dfaut elle permet de reproduire larborescence de rpertoires de lURI. Pour enregistrer le fichier la racine de votre rpertoire de destination, dcochez la case. Cette case est coche par dfaut, elle permet dutiliser la mthode POST. Dans le tableau Parameters, saisissez le nom de la ou des variable(s) dans le champ Name et leur valeur correspondante dans le champ Value. Dcochez cette case si vous souhaitez utiliser la mthode GET.
http, https, ftp
Create full path according to URI
http, https
POST method
984
Composants Internet
tFileFetch
http, https, ftp
Die on error
Dcochez cette case pour passer les lignes en erreur et terminer le traitement des lignes sans erreur. Cochez cette case pour collecter les donnes de log au niveau du composant. Nombre de secondes avant fermeture de la connexion au protocole. Cochez cette case pour imprimer la rponse du serveur dans la console. Cochez cette case pour charger un ou plusieurs fichier(s) sur le serveur. Dans le champ Name, saisissez le nom du fichier que vous souhaitez charger, et dans le champ File, saisissez le chemin daccs au fichier.
Advanced settings http, https http, https http, https
tStatCatcher Statistics Timeout Print response to console Upload file
http, https, ftp
Enable proxy server Cochez cette case si vous vous connectez derrire un proxy et renseignez les informations correspondantes. Enable NTLM Credentials Cochez cette case si vous utiliser un protocole dauthentification NTLM. Domain : Nom de domaine du client. Host : Adresse IP du client.
http, https, ftp
http, https
Need authentication Cochez la case dauthentification et renseignez le nom de lutilisateur dans le champs Username et son mot de passe dans le champs Password, si cela est ncessaire pour accder au protocole. Ce composant est gnralement utilis en composant de dpart pour alimenter le flux dentre dun Job et est souvent utilis avec un lien de type OnSubjobOk ou OnComponentOk, en fonction du contexte. n/a
Utilisation
Limitation
Scnario 1 : Rcuprer des donnes partir dun protocole HTTP

Ce scnario dcrit un Job comprenant trois composants, qui retrouve des donnes partir dun site internet HTTP et slectionne des donnes qui seront stockes dans un fichier dlimit.
985
Composants Internet
tFileFetch
Cliquez et dposez les composants tFileFetch, tFileInputRegex et tFileOutputDelimited dans lespace de modlisation, puis connectez-les comme illustr sur la figure ci-dessus. Dans longlet Basic settings du composant tFileFetch, slectionnez le protocole que vous souhaitez utiliser. Ici, nous utilisons le protocole HTTP. Saisissez lURI sur lequel le fichier peut tre rcupr. Dans le champ Destination directory, slectionnez le rpertoire dans lequel le fichier rcupr doit tre stock. Dans le champ Filename, saisissez le nouveau nom du fichier si vous souhaitez le renommer. Dans cet exemple, filefetch.txt. Slectionnez le composant tFileInputRegex. Dans le champ File name paramtrez le nom du fichier afin quil corresponde au fichier rcupr prcdemment. Dans le champ Regex, utilisez une expression rgulire pour slectionner les donnes adquates du fichier rcupr. Dans cet exemple : <td(?: class="leftalign")?> \s* (t\w+) \s* </td>
Utilisez la bonne expression rgulire en fonction du langage de gnration utilis. En effet, la syntaxe est diffrente en Java et en Perl, ainsi que les guillemets utilises pour introduire les expressions rgulires : guillemets simples en Perl et guillemets doubles en Java.
Si ncessaire, dfinissez len-tte dans le champ Header, le pied de page dans le champ Footer et le nombre de lignes traiter dans le champ Limit. Pour cet exemple, ignorez ce champ. Dfinissez le schma dcrivant le flux transmettre au composant de sortie. Le schma devrait tre automatiquement propag au flux de sortie, mais pour en tre sr, vrifiez le schma dans longlet Basic settings du composant tFileOutputDelimited. Puis appuyez sur F6 pour excuter le Job.
Scnario 2 : Lire les donnes dun fichier distant en mode stream

Pour un exemple de transfert de donnes en mode stream, consultez le Scnario 2 : Lire les donnes dun fichier distant en mode stream, page 889.
986
Composants Internet
tFileInputJSON
tFileInputJSON
Le composant tFileInputJSON appartient deux familles diffrentes : Internet et File. Pour plus dinformations, consultez tFileInputJSON, page 912.
987
Composants Internet
tFTPConnection
tFTPConnection
Proprits du tFTPConnection
Famille de composant Internet/FTP
Le composant tFTPConnection ouvre une connexion FTP afin deffectuer une transaction. Le tFTPConnection permet douvrir une connexion FTP afin deffectuer des transferts de fichiers en une seule transaction. Host Port Username Password Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Identifiant de connexion au serveur FTP. Mot de passe de connexion au serveur FTP.
SFTP Cochez cette case puis, partir de la liste Support/Anthenticat droulante Authentication method, ion method slectionnez loption adquate dauthentification au serveur : Password : Renseignez le mot de passe. Public key : Renseignez la cl prive ou cliquez sur le bouton [...] ct du champ Private key pour parcourir vos dossiers jusquau fichier adquat. Si vous choisissez loption Public Key comme mthode dauthentification, assurez-vous que la cl ait t ajoute lagent ou quaucune passphrase (phrase secrte) ne soit demande. Lorsque la case est dcoche, slectionnez votre mode de connexion, Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes, ou Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes. Advanced settings Use Socks Proxy Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant est gnralement utilis comme sous-Job a un seul composant. n/a
988
Composants Internet
tFTPConnection
Scnarios associs
Pour un scnario associ, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1004. Consultez galement le Scnario : Itration sur un rpertoire distant, page 995 du tFTPFileList Pour un scnario associ utilisant un protocole diffrent, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1039.
989
Composants Internet
tFTPDelete
tFTPDelete
Proprits du tFTPDelete
Le composant tFTPDelete supprime les fichiers slectionns via une connexion FTP. Le tFTPDelete supprime les fichiers dun serveur FTP distant. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent 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, vous pouvez utiliser longlet Dynamic settings, pour partager la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct travers les deux niveaux de Job. Pour plus dinformations concernant les Dynamic settings, consultez le Guide Utilisateur de votre Studio. Host Port Username et Password Remote directory Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Informations dauthentification de lutilisateur du serveur FTP. Rpertoire source o se trouvent les fichiers supprimer.
990
Composants Internet
tFTPDelete
SFTP Cochez cette case puis, partir de la liste Support/Anthenticat droulante Authentication method, ion method slectionnez loption adquate dauthentification au serveur : Password : Renseignez le mot de passe. Public key : Renseignez la cl prive ou cliquez sur le bouton [...] ct du champ Private key pour parcourir vos dossiers jusquau fichier adquat. Si vous choisissez loption Public Key comme mthode dauthentification, assurez-vous que la cl ait t ajoute lagent ou quaucune passphrase (phrase secrte) ne soit demande. Lorsque la case est dcoche, slectionnez votre mode de connexion, Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes, ou Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes. Files Advanced settings Use Socks Proxy Noms ou chemins daccs aux fichiers supprimer. Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ignore Failure At Quit (FTP) tStatCatcher Statistics Utilisation
Ce composant est gnralement utilis comme sous-Job un seul composant mais il peut aussi tre utilis comme composant de sortie ou de fin. n/a
Limitation
Scnarios associs
Pour un scnario associ, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1004. Pour un scnario associ utilisant un protocole diffrent, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1039.
991
Composants Internet
tFTPFileExist
tFTPFileExist
Proprits du tFTPFileExist
Le composant tFTPFileExist vrifie si un fichier est prsent sur le serveur FTP. Le tFTPFileExist permet de vrifier la prsence dun fichier sur le serveur FTP distant. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent 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, vous pouvez utiliser longlet Dynamic settings, pour partager la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct travers les deux niveaux de Job. Pour plus dinformations concernant les Dynamic settings, consultez le Guide Utilisateur de votre Studio. Host Port Username et Password Remote directory File Name Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Informations dauthentification de lutilisateur du serveur FTP. Rpertoire source o se trouvent les fichiers supprimer. Nom du fichier dont vous voulez vrifier la prsence.
992
Composants Internet
tFTPFileExist
SFTP Cochez cette case puis, partir de la liste Support/Anthenticat droulante Authentication method, ion method slectionnez loption adquate dauthentification au serveur : Password : Renseignez le mot de passe. Public key : Renseignez la cl prive ou cliquez sur le bouton [...] ct du champ Private key pour parcourir vos dossiers jusquau fichier adquat. Si vous choisissez loption Public Key comme mthode dauthentification, assurez-vous que la cl ait t ajoute lagent ou quaucune passphrase (phrase secrte) ne soit demande. Lorsque la case est dcoche, slectionnez votre mode de connexion, Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes, ou Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes. 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 si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour collecter les donnes de log au niveau du composant.
Advanced settings
Use Socks Proxy
Ce composant est gnralement utilis comme sous-Job un seul composant mais il peut aussi tre utilis comme composant de sortie ou de fin. n/a
Limitation
Scnarios associs
993
Composants Internet
tFTPFileList
tFTPFileList
Proprits du tFTPFileList
Fonction Objectif
Le composant tFTPFileList fait une boucle sur les fichiers et/ou les dossiers dun rpertoire distant donn. Le tFTPFileList rcupre un groupe de fichiers et/ou de dossiers suivant un masque donn et fait une boucle sur chacun deux, en se connectant un rpertoire distant via un protocole FTP. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent 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, vous pouvez utiliser longlet Dynamic settings, pour partager la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct travers les deux niveaux de Job. Pour plus dinformations concernant les Dynamic settings, consultez le Guide Utilisateur de votre Studio. Host Port Username et Password Remote directory File detail Adresse IP. Numro du port dcoute. Informations dauthentification de lutilisateur. Chemin daccs au rpertoire distant. Cochez cette case pour voir toutes les informations du fichier, et non pas juste son nom.
Basic settings
SFTP Cochez cette case puis, partir de la liste Support/Anthenticat droulante Authentication method, ion method slectionnez loption adquate dauthentification au serveur : Password : Renseignez le mot de passe. Public key : Renseignez la cl prive ou cliquez sur le bouton [...] ct du champ Private key pour parcourir vos dossiers jusquau fichier adquat. Si vous choisissez loption Public Key comme mthode dauthentification, assurez-vous que la cl ait t ajoute lagent ou quaucune passphrase (phrase secrte) ne soit demande.
994
Composants Internet
tFTPFileList
Connect Mode
Slectionnez le mode adquat de connexion au serveur : Active : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes. Passive : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes. Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour collecter les donnes de log au niveau du composant.
Advanced settings
Use Socks Proxy
Le composant tFTPFilelist est gnralement utilis comme composant seul dans un sous-job mais il peut aussi tre utilis avec dautres composants.
Scnario : Itration sur un rpertoire distant

Le scnario suivant dcrit un Job de trois composants qui a pour objectif de se connecter un serveur FTP, de lister les fichiers dun rpertoire distant donn en fonction dun masque, de les rcuprer et de les envoyer vers un rpertoire local dfini.
Cliquez et dposez les composants suivants : tFTPConnection, tFTPFileList et tFTPGet dans lespace de modlisation. Cliquez droit sur le composant tFTPConnection et connectez-le au composant tFTPFileList via une connexion de type OnSubjobOk. Puis connectez le tFTPFileList au tFTPGet laide dune connexion de type Iterate. Slectionnez le tFTPConnection et cliquez sur longlet Basic settings de la vue Component pour paramtrer le composant :
995
Composants Internet
tFTPFileList
Dans le champ Host, renseignez ladresse IP du serveur FTP. Dans le champ Port, renseignez le numro du port dcoute. Dans les champs Username et Password, renseignez respectivement le login et le mot de passe de connexion au serveur distant. Dans la liste Connect Mode, slectionnez le mode de connexion au serveur FTP que vous souhaitez utiliser. Slectionnez le tFTPFileList et cliquez sur longlet Basic settings de la vue Component pour paramtrer le composant :
Cochez la case Use an existing connection et dans la liste Component list, slectionnez le composant de connexion tFTPConnection_1. Les informations de connexion sont automatiquement renseignes. Dans le champ Remote directory, renseignez le chemin relatif du rpertoire contenant les fichiers lister. Dans le champ Filemask, indiquez un masque de fichier. Utilisez les caractres spciaux si besoin est. Dans cet exemple, on ne veut rcuprer que les fichiers dlimits (.csv).
996
Composants Internet
tFTPFileList
Dans la liste Connect Mode, slectionnez le mode de connexion au serveur FTP que vous souhaitez utiliser. Dans cet exemple, il sagit du mode Passive. Slectionnez le tFTPGet et cliquez sur longlet Basic settings de la vue Component pour paramtrer le composant :
Cochez la case Use an existing connection et dans la liste Component list, slectionnez le composant de connexion adquat, tFTPConnection_1 dans cet exemple. Les informations de connexion sont automatiquement renseignes. Dans le champ Local directory, renseignez le chemin relatif du rpertoire de destination des fichiers rcuprer. Dans le champ Remote directory, renseignez le chemin relatif du rpertoire contenant les fichiers rcuprer. Dans la liste Transfer Mode, slectionnez le mode de transfert FTP que vous souhaitez utiliser. Dans la liste Overwrite file, slectionnez lune des options disponibles pour le transfert du fichier. Dans le champ Filemask, slectionnez la variable globale ((String)globalMap.get("tFTPFileList_1_CURRENT_FILEPATH")) de manire traiter tous les fichiers du rpertoire source. Dans la liste Connect Mode, slectionnez le mode de connexion au serveur FTP que vous souhaitez utiliser. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
997
Composants Internet
tFTPFileList
Une fois la connexion au serveur FTP tablie, les fichiers sont lists dans le rpertoire spcifi, selon le masque choisi, puis sont rcuprs et stocks dans le rpertoire de destination pralablement dfini. Vous pouvez vrifier que la copie des fichiers a t ralise partir de votre explorateur de disque.
998
Composants Internet
tFTPFileProperties
tFTPFileProperties
Proprits du tFTPFileProperties
Famille du composant Internet
Le composant tFTPFileProperties permet de crer un flux monoligne affichant les proprits du fichier trait sur un serveur FTP. Le tFTPFileProperties permet de recueillir les informations concernant les proprits principales dun fichier dfini sur un serveur FTP. Schema type 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 dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Edit schema Use an existing connection/Compone nt List Host Port Username Password Local directory Remote directory File :Le nombre de lignes en lecture seule est diffrent sous Java et sous Perl. 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. Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Login de connexion au serveur FTP. Mot de passe de connexion au serveur FTP. Chemin daccs lemplacement de destination du fichier. Chemin daccs du rpertoire source o les fichiers sont rcuprs. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio.
999
Composants Internet
tFTPFileProperties
SFTP Support/Anthenticat ion method
Cochez cette case puis, partir de la liste droulante Authentication method, slectionnez loption adquate dauthentification au serveur : Password : Renseignez le mot de passe. Public key : Renseignez la cl prive ou cliquez sur le bouton [...] ct du champ Private key pour parcourir vos dossiers jusquau fichier adquat. Si vous choisissez loption Public Key comme mthode dauthentification, assurez-vous que la cl ait t ajoute lagent ou quaucune passphrase (phrase secrte) ne soit demande. Lorsque la case est dcoche, slectionnez votre mode de connexion, Passive ou Active.
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 vrifier le MD5 du fichier tlcharg. Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy.
Calculate MD5 Hash Advanced settings Use Socks Proxy
Ignore Failure At Quit Cochez cette case afin dignorer les erreurs dues la (FTP) fermeture du FTP ou de la bibliothque. tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant peut tre utilis en standalone. n/a
Scnario associ
Pour un scnario associ, consultez le Scnario : Afficher les proprits dun fichier trait, page 974.
1000
Composants Internet
tFTPGet
tFTPGet
Proprits du tFTPGet
Le composant tFTPGet rcupre les fichiers slectionns via une connexion FTP. Le tFTPGet rcupre les fichiers slectionns dun seveur FTP distant et les copie dans un rpertoire local. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent List pour rutiliser les informations de connexion que vous avez dj dfinies. Host Port Username Password Local directory Remote directory Transfer mode Overwrite file Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Login de connexion au serveur FTP. Mot de passe de connexion au serveur FTP. Chemin daccs lemplacement de destination du fichier. Chemin daccs du rpertoire source o les fichiers sont rcuprs. Diffrents modes de transfert FTP. Liste des options disponibles pour le transfert du fichier. Append : Cochez cette case pour crire les donnes la fin de lenregistrement, et ainsi ne pas lcraser. Noms ou chemins daccs aux fichiers transfrer. Slectionnez votre mode de connexion. Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes. Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des 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. 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 les lignes contenant les erreurs seront ignores.
Files Connection Mode
Encoding type
Die on error
1001
Composants Internet
tFTPGet
Advanced settings
Use Socks Proxy
Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant est gnralement utilis comme sous-Job a un seul composant mais il peut aussi tre utilis comme composant de sortie ou de fin. n/a
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1004. Consultez galement le Scnario : Itration sur un rpertoire distant, page 995 du tFTPFileList. Pour un scnario associ utilisant un protocole diffrent, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1039.
1002
Composants Internet
tFTPPut
tFTPPut
Proprits du tFTPPut
Le composant tFTPPut copie les fichiers slectionns via une connexion FTP. Le tFTPPut copie les fichiers slectionns dun rpertoire local dfini vers un rpertoire FTP distant. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent 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, vous pouvez utiliser longlet Dynamic settings, pour partager la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct travers les deux niveaux de Job. Pour plus dinformations concernant les Dynamic settings, consultez le Guide Utilisateur de votre Studio. Host Port Username Password Local directory Remote directory Transfer mode Overwrite file Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Login de connexion au serveur FTP. Mot de passe de connexion au serveur FTP. Chemin daccs au rpertoire source du ou des fichier(s). Chemin daccs au rpertoire de destination du ou des fichier(s). Diffrents modes de transfert FTP. Liste des options disponibles pour le fichier transfr. Append : Cochez cette case pour crire les donnes la fin de lenregistrement, et ainsi ne pas lcraser. SFTP Support: cochez cette case pour tablir une mthode dauthentification. Authentication method: slectionnez la mthode dauthentification partir de la liste droulante.
SFTP Support et Authentication method
1003
Composants Internet
tFTPPut
Files
Cliquez sur le bouton [+] pour ajouter une ligne puis remplissez les colonnes. Filemask: noms et chemins daccs aux fichiers transfrer. New name: nom donner au fichier FTP aprs le transfert. Slectionnez votre mode de connexion. Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes. Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des 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. 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 les lignes contenant les erreurs seront ignores. Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour collecter les donnes de log au niveau du composant.
Connection Mode
Encoding type
Die on error
Advanced settings
Use Socks Proxy
Limitation
Scnario : Copier des fichiers sur un serveur FTP distant

Ce scnario cre un Job deux composants permettant douvrir une connexion un serveur distant afin de copier les fichiers souhaits en une seule transaction.
1004
Composants Internet
tFTPPut
Cliquez et dposez les composants tFTPConnection permettant deffectuer toutes les oprations en une seule transaction et tFTPPut de la famille Internet dans le Job Designer. Reliez le tFTPConnection au tFTPPut laide dun lien de type OnSubJobOk. Dans le Job designer, double-cliquez sur le tFTPConnection pour paramtrer ses proprits de base dans longlet Basic settings de la vue Component :
Dans le champ Host, renseignez ladresse IP du serveur. Dans le champ Port, renseignez le numro du port dcoute. Dans les champs Username et Password, renseignez respectivement le login et le mot de passe de connexion au serveur distant. Dans la liste Connection Mode, slectionnez le mode de connexion au serveur FTP que vous souhaitez utiliser. Dans le Job designer, double-cliquez sur le tFTPPut pour paramtrer ses proprits de base dans longlet Basic settings de la vue Component :
1005
Composants Internet
tFTPPut
Cochez la case Use an existing connection et dans la liste Component list, slectionnez le composant de connexion tFTPConnection_1. Les informations de connexion sont automatiquement renseignes. Dans le champ Local directory, renseignez le chemin daccs au rpertoire local contenant le fichier, moins que vous ne renseigniez directement les masques des fichiers dans la colonne Filemask du champ Files. Dans le champ Remote directory, renseignez les informations de connexion au rpertoire du seveur distant. Dans la liste Transfert mode, slectionnez le mode de transfert utilis. Dans la liste Overwrite file, slectionnez loption dcrasement du fichier. Dans le tableau Files, cliquez deux fois sur le bouton (+) pour ajouter deux lignes la liste Filemask, renseignez les masques de fichier pour chaque fichier que vous souhaitez copier dans le rpertoire distant. Enregistrez votre Job et appuyez sur F6 pour lexcuter. Les fichiers spcifis dans le champ Filemask sont copis dans le rpertoire du serveur distant.
1006
Composants Internet
tFTPRename
tFTPRename
Proprits du tFTPRename
Le composant tFTPRename renomme les fichiers slectionns via une connexion FTP. Le tFTPRename renomme les fichiers slectionns dun rpertoire local dfini vers un rpertoire FTP distant. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent 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, vous pouvez utiliser longlet Dynamic settings, pour partager la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct travers les deux niveaux de Job. Pour plus dinformations concernant les Dynamic settings, consultez le Guide Utilisateur de votre Studio. Host Port Username Password Remote directory Overwrite file Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Login de connexion au serveur FTP. Mot de passe de connexion au serveur FTP. Chemin daccs au rpertoire de destination du ou des fichier(s). Liste des options disponibles pour le fichier transfr. Append : Cochez cette case pour crire les donnes la fin de lenregistrement, et ainsi ne pas lcraser. SFTP Support : cochez cette case pour tablir une mthode dauthentification. Authentication method : slectionnez la mthode dauthentification partir de la liste droulante. Cliquez sur le bouton [+] pour ajouter une ligne puis remplissez les colonnes. Filemask : noms et chemins daccs aux fichiers transfrer. New name : nom donner au fichier FTP aprs le transfert.
SFTP Support et Authentication method
Files
1007
Composants Internet
tFTPRename
Connection Mode
Slectionnez votre mode de connexion. Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes. Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des 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. 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 les lignes contenant les erreurs seront ignores. Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour collecter les donnes de log au niveau du composant.
Encoding type
Die on error
Advanced settings
Use Socks Proxy
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1004 .
1008
Composants Internet
tFTPTruncate
tFTPTruncate
Proprits du tFTPTruncate
Le composant tFTPTruncate tronque les fichiers slectionns via une connexion FTP. Le tFTPTruncate tronque les fichiers slectionns dun rpertoire local dfini vers un rpertoire FTP distant. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent 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, vous pouvez utiliser longlet Dynamic settings, pour partager la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct travers les deux niveaux de Job. Pour plus dinformations concernant les Dynamic settings, consultez le Guide Utilisateur de votre Studio. Host Port Username Password Remote directory SFTP Support et Authentication method Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Login de connexion au serveur FTP. Mot de passe de connexion au serveur FTP. Chemin daccs au rpertoire de destination du ou des fichier(s). SFTP Support : cochez cette case pour tablir une mthode dauthentification. Authentication method : slectionnez la mthode dauthentification partir de la liste droulante. Cliquez sur le bouton [+] pour ajouter une ligne puis remplissez les colonnes. Filemask : noms et chemins daccs aux fichiers transfrer. New name : nom donner au fichier FTP aprs le transfert.
Files
1009
Composants Internet
tFTPTruncate
Connection Mode
Slectionnez votre mode de connexion. Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes. Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des 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 si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour collecter les donnes de log au niveau du composant.
Encoding type
Advanced settings
Use Socks Proxy
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1004 .
1010
Composants Internet
tJMSInput
tJMSInput
Proprits du tJMSInput
Fonction Objectif
Ce composant cre une interface entre une application Java et un systme Middleware orient Message. Le tJMSInput permet de mettre en place des interactions entre composants applicatifs dans un cadre faiblement coupl, asynchrone et fiable via un serveur JMS. Module List Context Provider Slectionnez dans cette liste la bibliothque utiliser. Saisissez l'URL de contexte, par exemple "com.tibco.tibjms.naming.TibjmsInitialContextFact ory". Attention cependant, la syntaxe peut varier selon le serveur JMS utilis Saisissez lURL du serveur en respectant la syntaxe, par exemple "tibjmsnaming://localhost:7222". Saisissez le nom JDNI. Si vous devez vous identifier, cochez la case et saisissez votre nom dutilisateur et votre mot de passe. Slectionnez le type de message, Topic ou Queue. Saisissez la source du message, telle quattendue par le serveur. Celle-ci peut tre compos du type et du nom de la source, par exemple : queue/A ou topic/testtopic. Notez que ce champ est sensible la casse. Renseignez le dlai (en secondes) avant de passer au message suivant. Saisissez le nombre maximal de messages traiter. Spcifiez votre filtre. Slectionnez le mode de traitement des messages: Raw Message : Message brut. Message Content : 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 du composant tJMSInput est en lecture seule. Il est compos dune colonne : Message
Basic settings
Server URL Connection Factory JDNI Name Use Specified User Identity Message Type Message From
Timeout for Next Message (in sec) Maximum Messages Message Selector Expression Processing Mode
Schema type et Edit Schema
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. Il requiert un composant de sortie. Composants Talend Open Studio 1011
Composants Internet
tJMSInput
Limitation
Assurez-vous que le serveur JMS correspondant est lanc.
Scnario associ :
Pour un scnario associ, consultez le Scnario : Communication asynchrone via un serveur MOM, page 1015.
1012
Composants Internet
tJMSOutput
tJMSOutput
Proprits du tJMSOutput
Fonction Objectif
Ce composant cre une interface entre une application Java et un systme Middleware orient Message. Le tJMSOutput permet de mettre en place des interactions entre composants applicatifs dans un cadre faiblement coupl, asynchrone et fiable via un serveur JMS. Module List Context Provider Slectionnez dans cette liste la bibliothque utiliser. Saisissez l'URL de contexte, par exemple "com.tibco.tibjms.naming.TibjmsInitialContextFact ory". Attention cependant, la syntaxe peut varier selon le serveur JMS utilis Saisissez lURL du serveur en respectant la syntaxe, par exemple "tibjmsnaming://localhost:7222". Saisissez le nom JDNI. Si vous devez vous identifier, cochez la case et saisissez votre nom dutilisateur et votre mot de passe. Slectionnez le type de message, Topic ou Queue. Saisissez la cible du message, telle quattendue par le serveur. Slectionnez le mode de traitement des messages: Raw Message : Message brut. Message Content : contenu du message. 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 du composant tJMSInput est en lecture seule. Il est compos dune colonne : Message
Basic settings
Server URL Connection Factory JDNI Name Use Specified User Identity Message Type To Processing Mode
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. Il requiert un composant dentre. Assurez-vous que le serveur JMS correspondant est lanc.
Scnario associ :
Pour un scnario associ, consultez le Scnario : Communication asynchrone via un serveur MOM, page 1015.
Composants Internet
tMomInput
tMomInput
Proprits du tMomInput
Ce composant rcupre un message dune file dattente dun systme Middleware orient Message et le passe au composant suivant. Le tMomInput permet de mettre en place des communications asynchrones via un serveur MOM. MQ Server Slectionnez dans cette liste le serveur MOM utiliser. Les paramtres requis diffrent lgrement en fonction du serveur slectionn. Renseignez le nom de lhte (Host) et ladresse IP du serveur MOM ainsi que le Port. 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 du composant tMomInput est en lecture seule. Il est compos de deux colonnes : From et Message Cochez cette case pour consulter en continu le serveur MOM pour rcuprer les nouveaux messages. Saisissez la source du message, telle quattendue par le serveur. Celle-ci peut tre compos du type et du nom de la source, par exemple : queue/A ou topic/testtopic. Notez que ce champ est sensible la casse. Slectionnez le type de message : Text, Bytes ou Map. La valeur par dfaut est Channel. Renseignez le gestionnaire de file(s) dattente. Saisissez le nom de la file dattente. Cochez cette case pour appliquer un filtre portant sur les messages id, filtre que vous dterminerez dans le champ Message id.
Host/Port Schema type et Edit Schema
JBoss Messaging
Keep listening
Message From
Message Body Type Websphere Channel Queue Manager Message Queue Is using message id to fetch
Commit (delete Cochez cette case afin de forcer le commit aprs message after reading lecture de chaque message dans la file dattente. from the queue) 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. Il requiert un composant de sortie. Assurez-vous que le serveur JBoss ou Websphere correspondant est lanc.
1014
Composants Internet
tMomInput
Scnario : Communication asynchrone via un serveur MOM

Ce scnario est compos de deux Jobs. Le premier permet de poster des messages sur la file dattente du serveur JBoss et le deuxime recupre les messages de ce serveur. Dans le premier Job, un message compos de chanes de caractres est cr laide du composant tRowGenerator puis transmis au serveur JBoss laide du composant tMomOutput. Un composant intermdiaire, le composant tLogRow, permet dafficher le flux transmis.
Cliquez et dposez ces trois composants dans votre premier Job et connectez-les via le clic-droit avec des liens de type Main row. Double-cliquez sur le composant tRowGenerator pour configurer le schma des donnes qui seront gnres de manire alatoire.
Crez une seule colonne appele message. Elle correspond au message qui sera mis sur la file dattente du MOM. Cette colonne est de type String et peut contenir une valeur nulle. Pour produire les donnes, utilisez une fonction prdfinie permettant de concatner de manire alatoire les caractres ascii choisis pour former la chane de 6 caractres. Cette fonction est la suivante : getAsciiRandomString. (version Java). Cliquez sur le bouton daperu pour afficher un chantillon au hasard des donnes gnres. Paramtrez le champ Number of rows to be generated permettant de dfinir le nombre de lignes gnre 10. Cliquez sur OK pour valider. Le composant tLogRow est uniquement utilis pour afficher un tat intermdiaire des donnes manipules. Dans cet exemple, aucune configuration spcifique nest ncessaire. Puis slectionnez le composant tMomOutput.
1015
Composants Internet
tMomInput
Dans cet exemple, le serveur MQ server utiliser est de type JBoss. Dans les champs Host et Port, renseignez les informations de connexion correspondantes. Slectionnez le type de message dans la liste droulante Message type, il peut tre de type Queue ou Topic. Pour cet exemple, slectionnez le type Queue dans la liste. Dans le champ To, saisissez les informations source du message strictement telles quelles sont attendues par le serveur. Il doit correspondre au type de message que vous avez slectionn dans la liste droulante Message Type, notamment : queue/A.
Le nom du message est sensible la casse, ainsi queue/A et Queue/A sont diffrents.
Puis cliquez sur Sync Columns pour rcuprer le schma du composant prcdent. Le schma tant en lecture seule, il ne peut tre modifi. Les donnes envoyes sur le serveur MQ proviennent de la premire colonne rencontre du schma. Excutez le Job et, grce au composant tLogRow, observez dans la console le flux de donnes transmis.
Puis paramtrez le deuxime Job pour rcuprer les messages de la file dattente du serveur MOM.
Cliquez et dposez un composant tMomInput (dans la famille Internet de la Palette) et un composant tLogRow pour afficher les messages rcuprs. Slectionnez le tMomInput et dfinissez ses paramtres.
1016
Composants Internet
tMomInput
Slectionnez le serveur MQ server dans la liste. Dans cet exemple, un serveur de message JBoss est utilis. Renseignez les informations Host et Port du serveur. Renseignez les paramtres des champs Message From et Message Type afin quils correspondent la source et au type de message attendus par le serveur de message. Le schma dans le champ Schema est en lecture seule et est compos de deux colonnes : From et Message. Cochez la case Keep listening et paramtrez la frquence de vrification 5 secondes.
Lorsque vous utilisez loption Keep Listening, vous devez cliquez sur le bouton Kill pour stopper le Job.
Laissez les paramtres par dfaut du composant tLogRow. Enregistrez le Job et excutez-le (si vous le lancez pour la premire fois ou si vous lavez stopper au cours dun lancement prcdent).
Les messages rcuprs sur le serveur sont affichs dans la console.
1017
Composants Internet
tMomMessageIdList
tMomMessageIdList
Proprits du tMomMessageIdList
Fonction
Le composant tMomMessageIdList rcupre la liste des ID des messages partir de la file dattente dun systme Middleware orient Message et la passe au composant suivant. Le tMomMessageIdList permet ditrer les ID de certains messages. Il est gnralement utilis avec le tMomInput. Pour plus dinformations, consultez tMomInput, page 1014. MQ Server Slectionnez dans cette liste le serveur MOM utiliser. Les paramtres requis diffrent lgrement en fonction du serveur slectionn. Renseignez le nom de lhte (Host) et ladresse IP du serveur MOM ainsi que le Port. La valeur par dfaut est Channel Renseignez le gestionnaire de file(s) dattente. Saisissez le nom de la file dattente.
Objectif
Basic settings
Host/Port Websphere Channel Queue Manager Message Queue Utilisation Limitation
Ce composant est gnralement utilis en tant que composant de dbut. Il requiert un composant de sortie. Assurez-vous que le serveur Websphere correspondant est lanc.
Scnario associ
Pour un scnario associ, consultez le composant tMomInput, page 1014.
1018
Composants Internet
tMomOutput
tMomOutput
Proprits du tMomOutput
Dpose un message sur la file dattente dun systme Middleware orient message afin quil soit rcupr de manire asynchrone. Le tMomOutput permet de mettre en place des communications asynchrones via un serveur MOM. MQ Server Slectionnez dans la liste le serveur MOM utiliser. En fonction du serveur slectionn, les paramtres diffrent lgrement. Renseignez le nom de lhte ou ladresse IP du serveur MOM dans le champ Host, ainsi que le Port. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Lors de lutilisation du composant tMomOutput, le schma est en lecture seule mais changera en fonction du schma dentre. Le serveur attend uniquement un schma une colonne pour contenir les Messages. Saisissez la destination du message, telle quelle est attendue par le serveur ; le type est le nom du dossier cible doivent tre indiqus, par exemple : queue/A ou topic/testtopic Notez que ce champ est sensible la casse. Slectionnez le type de message : topic ou queue. La valeur par dfaut est Channel. Renseignez le gestionnaire de file(s) dattente. Saisissez le nom de la file dattente.
Host/Port Schema type et Edit Schema
JBoss Messaging
To
Message Type Websphere Channel Queue Manager Message Queue Utilisation Limitation
Ce composant ncessite un composant dentre ou un composant intermdiaire. Assurez-vous que le serveur JBoss ou Websphere correspondant soit bien lanc.
Scnario associ
Pour un exemple dutilisation du tMomOutput, consultez tMomInput page 1014.
1019
Composants Internet
tPOP
tPOP
Proprits du tPOP
Fonction Objectif
Le composant tPOP rcupre un ou plusieurs e-mails partir dun protocole POP3 ou IMAP. Le composant tPOP utilise le protocole POP ou IMAP pour se connecter au serveur de messagerie spcifi. Il rcupre ensuite un ou plusieurs e-mails et crit les informations rcupres dans un ou plusieurs fichiers dfinis. Les paramtres avancs (Advanced settings) permettent d'appliquer un ou plusieurs filtres la slection. Host Renseignez le nom de lhte ou ladresse IP du serveur de messagerie auquel vous voulez vous connecter. Renseignez le numro du port du serveur de messagerie. Renseignez les informations dauthentification votre compte de messagerie : Username : entrez lidentifiant que vous utilisez pour accder votre bote mail. Password : entrez le mot de passe de connexion votre bote mail. Renseignez le chemin daccs au dossier dans lequel vous voulez stocker les e-mails rcuprs partir de votre messagerie, ou cliquez sur [...] pour parcourir vos dossiers jusqu lemplacement souhait. Appuyez sur Ctrl+Espace pour afficher la liste des modles prdfinis ou dfinissez manuellement la syntaxe du nom des fichiers cible. Les donnes des e-mails rcuprs partir du serveur de messagerie sont crites dans ces fichiers. Par dfaut, tous les messages prsents sur le serveur de messagerie spcifi sont rcuprs. Pour ne rcuprer qu'un nombre dfini de messages, dcochez cette case et renseignez dans le champ Number of emails to retrieve : le nombre de-mails rcuprer. La collecte des e-mails se fait du plus rcent au plus ancien. Cochez cette case si vous ne souhaitez pas conserver sur le serveur les e-mails rcuprs. Pour les serveurs Gmail, cette option ne fonctionne pas avec le protocole POP3. Slectionnez le protocole IMAP et vrifiez que le compte Gmail est configur pour utiliser ce protocole.
Basic settings
Java uniquement
Port Username et Password
Output directory
Filename pattern
Retrieve all emails?
Delete emails from server
1020
Composants Internet
tPOP
Java uniquement
Choose the protocol
Slectionnez partir de la liste droulante le protocole utiliser pour rcuprer les e-mails. Le protocole dpend de celui utilis par votre messagerie. Si vous choisissez le protocole imap, vous aurez la possibilit de spcifier le dossier contenant les e-mails que vous souhaitez rcuprer. Cochez cette case si votre serveur de messagerie utilise ce protocole de scurisation des changes. Cette option est obligatoire pour les utilisateurs de messagerie Gmail.
Java uniquement
Use SSL
Advanced settings Java uniquement
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Filter Cliquez sur le bouton [+] pour ajouter des lignes de filtre afin de ne rcuprer quune slection de-mails : Filter item : slectionnez lun des types de filtre suivants partir de la liste droulante : From : les messages sont filtrs en fonction de ladresse e-mail de provenance. To : les messages sont filtrs en fonction de ladresse e-mail de destination. Subject : les messages sont filtrs en fonction du sujet. Before date : les messages sont filtrs en fonction de la date dmission ou de rception ; ils doivent tre antrieurs la date indique. After date : les messages sont filtrs en fonction de la date dmission ou de rception ; ils doivent tre postrieurs la date indique. Pattern : appuyez sur Ctrl+Espace pour afficher la liste des valeurs disponibles et slectionnez la valeur utiliser pour chacun des filtres.
Java uniquement
Filter condition relation
Slectionnez le type de relation appliquer entre les filtres : and : les conditions dtermines par les filtres sajoutent les unes aux autres, la recherche est plus restrictive. or : les conditions dtermines par les filtres sont indpendantes les unes des autres, la recherche est plus large.
Ce composant ne traite pas de flux de donnes, il peut donc tre utilis seul. n/a
Scnario : Rcuprer une slection de-mails partir dun compte de messagerie

Ce scnario Java un seul composant a pour but de rcuprer un nombre prdfini de-mails partir dun compte de messagerie. A partir de la Palette, cliquez-dposez un composant tPOP dans lditeur graphique,
Composants Internet
tPOP
Double-cliquez sur le tPOP pour afficher la vue Basic settings et paramtrer le composant. Renseignez les informations de connexion au serveur de messagerie : le nom de lhte ou son adresse IP entre guillemets dans le champ Host et le numro de port dans le champ Port. Saisissez ensuite les informations d'authentification de votre compte de messagerie. Dans le champ Username, saisissez entre guillemets votre identifiant et dans le champ Password, saisissez votre mot de passe. Dans cet exemple, le serveur de messagerie s'appelle Free.
Dans le champ Output directory, slectionnez manuellement le chemin daccs ou cliquez sur [...] pour slectionner le dossier de destination des e-mails rcuprs sur le serveur. Dans le champ Filename pattern, dfinissez la syntaxe de nommage des fichiers de destination ou appuyez sur Ctrl+Espace pour afficher la liste des modles prdfinis. Dans cet exemple, la syntaxe est la suivante : TalendDate.getDate("yyyyMMdd-hhmmss") + "_" + (counter_tPOP_1 + 1) + ".txt" Les fichiers de destination, enregistrs au format texte, sont dfinis par leur date, heure et ordre de collecte. Dcochez la case Retrieve all emails? pour ne rcuprer quun nombre dfini de-mails. Dans cet exemple, 10 messages sont rcuprs. Cochez la case Delete emails from server pour supprimer les e-mails du serveur une fois quils ont t rcuprs en local. Slectionnez un type de protocole partir de la liste droulante Choose the protocol. Le choix du protocole dpend de celui utilis par votre fournisseur de messagerie. Certains fournisseurs comme Gmail utilisent les deux protocoles. Dans cet exemple, le protocole slectionn est pop3. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
1022
Composants Internet
tPOP
Le composant tPOP a ainsi rcupr les 10 derniers messages du compte de messagerie spcifi. Pour chaque e-mail rcupr, un fichier .txt a t cr dans le dossier tPOP. Chaque fichier contient les mtadonnes d'envoi du message (expditeur, destinataire, objet du message) ainsi que les donnes propres au message.
1023
Composants Internet
tRSSInput
tRSSInput
Proprits du tRSSInput
Fonction Objectif
Le composant tRSSInput lit des flux RSS en utilisant des URLs. Le tRSSInput permet de suivre les billets posts sur certains sites en particulier afin den rassembler et organiser les informations rapidement et facilement pour votre utilisation. Schema type 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. Dans le contexte dutilisation du tRSSInput, le schma est compos de quatre colonnes : TITLE, DESCRIPTION, PUBDATE et Link. Les paramtres de titre sont en lecture seule, contrairement leur type et leur longueur. Saisissez lURL du flux RSS lire. Lorsque cette case est coche, le composant tRSSInput lit les articles du flux RSS partir de la date renseigne en cliquant sur le bouton [...] situ ct du champ date time. Lorsque cette case est coche, le composant tRSSInput lit autant darticles que le nombre spcifi dans le champ max amount. 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 les lignes contenant les erreurs seront ignores.
Basic settings
RSS URL Read articles from
Max number of articles Die on error
Ce composant est gnralement utilis en tant que composant de dbut. Il requiert un composant de sortie. n/a.
Scnario : Rcuprer les billets frquemment mis jour sur un blog

Ce scnario Java deux composants a pour but de rcuprer les billets qui sont souvent mis jour sur un blog, partir dun flux RSS local Talend, en utilisant le composant tRSSInput. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tRSSInput et le tLogRow. Cliquez-droit sur le premier pour le connecter au second laide dun lien de type Row Main.
1024
Composants Internet
tRSSInput
Dans lditeur graphique, slectionnez le tRSSInput. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tRSSInput.
Configurez le champ Schema Type en mode Built-In puis cliquez sur le bouton [...] situ ct du champ Edit Schema pour changer le type et la longueur des paramtres du schma si ncessaire. Cliquez sur OK pour fermer la bote de dialogue.
Le schma du tRSSInput est compos de quatre colonnes, TITLE, Description, PUBDATE, et LINK. Il est en lecture seule, except pour les paramtres de type et de longueur.
Dans longlet Basic settings du composant tRSSInput, saisissez lURL daccs au flux RSS. Dans ce scnario, le tRSSInput est associ au flux RSS Talend : http://feeds.feedburner.com/Talend.
1025
Composants Internet
tRSSInput
Cochez/dcochez les autres cases selon vos besoins. Dans ce scnario, on veut afficher les informations de deux articles dats du 20 juillet 2008. Dans lespace graphique, slectionnez le tLogRow puis cliquez sur la vue Component pour en dfinir la configuration de base. Pour plus dinformations sur les proprits du composant tLogRow, consultez les Proprits du tLogRow, page 1095. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
Le composant tRSSInput a accd au flux RSS du site de Talend votre place et en a organis les informations pour vous. Deux billets sont affichs sur la console. Chacun deux a ses propres titre, description, date de publication et URL du flux RSS correspondante. Les blogs prsentent le dernier billet en premier et vous pouvez faire dfiler vers le bas pour lire les billets les plus anciens.
1026
Composants Internet
tRSSOutput
tRSSOutput
Proprits du tRSSOutput
Le composant TRSSOutput crit des fichiers XML de flux RSS. Le tRSSOutput permet de crer des fichiers XML contenant des flux RSS. File Name Chemin daccs ou nom du fichier XML en sortie. Consultez galement la section Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. 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 option pour ajouter des nouvelles lignes la fin du fichier. Les informations renseigner dans cette zone concernent lintgralit des donnes saisies, du site, etc. plutt que des lments particuliers. Title : Saisissez un titre significatif. Description : Entrez une description du contenu qui vous semble suffisamment dtaille. Publication date : Renseignez la date adquate. Link : Saisissez lURL approprie. Optionnal Channel Elements Renseignez dans le tableau les informations relatives aux mtadonnes du flux RSS. Cliquez sur le bouton [+] pour ajouter de nouvelles lignes : Element Name : nom de la mtadonne. Element Value : contenu de la mtadonne. 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. Dans le contexte dutilisation du tRSSInput, le schma est compos de quatre colonnes : TITLE, DESCRIPTION, PUBDATE et Link. Les paramtres de titre sont en lecture seule, contrairement leur type et leur longueur.
Encoding type
Append Channel
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant doit obligatoirement tre reli un composant de dbut ou un composant intermdiaire. n/a
1027
Composants Internet
tRSSOutput
Scnario 1 : Crer un flux RSS et stocker les fichiers sur un serveur FTP
Ce scnario Java a pour but de : crer un flux RSS pour des fichiers que vous souhaitez partager avec dautres personnes, et stocker lensemble des fichiers sur un serveur FTP. Ce scnario permet dcrire un fichier XML de flux RSS partir dune table Mysql contenant des informations concernant des livres. Il ajoute galement des liens vers les fichiers stocks sur un serveur FTP au cas o les utilisateurs voudraient avoir accs aux fichiers dans leur intgralit. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tMysqlInput, le tRSSOutput et le tFTPPut. Cliquez droit sur le tMysqlInput et connectez-le au tRSSOutput laide dun lien de type Row Main. Cliquez droit sur le tMysqlInput et connectez-le au tFTPPut laide dun lien de type OnSubjobOk.
Dans lespace graphique, slectionnez le tMysqlInput. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tMysqlInput.
1028
Composants Internet
tRSSOutput
Configurez le champ Property type en mode Repository puis cliquez sur le bouton [...] pour slectionner la base de donnes adquate dans la liste. Les dtails de connexion ainsi que le schma sont remplis automatiquement. Dans le champ Table Name, saisissez le nom de votre table ou cliquez sur le bouton [...] et slectionnez le nom de la table partir de la liste. Dans ce scnario, la table Mysql de donnes saisies sappelle rss_talend et le schma comporte quatre colonnes, TITLE, Description, PUBDATE, et LINK. Dans le champ Query, saisissez la requte de base de donnes en faisant particulirement attention ce que lordre des champs corresponde au schma dfini, ou cliquez sur Guess Query. Dans lespace graphique, slectionnez le composant tRSSOutput. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tRSSOutput.
Dans le champ File name, utilisez le nom de fichier et son chemin daccs dfinis par dfaut ou parcourez vos dossiers pour dfinir votre propre fichier XML de sortie. Slectionnez le type dencodage partir de la liste Encoding Type. Dans le panneau Channel, saisissez un titre, une description, une date de publication et un lien dfinissant lensemble de vos donnes saisies.
Composants Internet
tRSSOutput
Slectionnez le type de schma dans la liste Schema Type puis cliquez sur Edit Schema pour le modifier si ncessaire.
Vous pouvez galement cliquer sur Sync Column pour rcuprer le schma gnr par le composant prcdent.
Enregistrez votre Job puis appuyez sur F6 pour en excuter la premire partie.
Le composant tRSSOutput a cr en sortie un flux RSS au format XML pour les fichiers dfinis. Pour stocker lintgralit des fichiers sur un serveur FTP : Dans lespace graphique, slectionnez le FTPPut. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFTPPut.
1030
Composants Internet
tRSSOutput
Saisissez le nom du serveur et le numro de port dans les champs correspondants. Renseignez vos dtails de connexion dans les champs Username et Password. Parcourez vos dossier jusquau rpertoire local ou tapez manuellement le chemin daccs dans le champ Local directory. Entrez les dtails du serveur de rpertoire distant. Slectionnez le mode de transfert partir de la liste Transfer mode. Dans le panneau Files, cliquez sur le bouton [+] pour ajouter des lignes puis remplissez les masques de fichiers de tous les fichiers copier sur le rpertoire distant. Dans ce scnario, les fichiers enregistrer sur le serveur FTP sont tous des fichiers texte. Enregistrez votre Job puis appuyez sur F6 pour lexcuter. Les fichiers dfinis sont copis sur le serveur distant.
Scnario 2 : Crer un flux RSS contenant des mtadonnes

Ce scnario Java deux composants a pour but de crer un flux RSS contenant des mtadonnes et de rediriger les informations obtenues dans un fichier XML de flux RSS en sortie. A partir de la Palette, cliquez-dposez les composants tRSSInput et tRSSOutput dans lditeur graphique. Cliquez droit sur le tRSSInput et connectez-le au tRSSOutput laide dun lien de type Row Main.
1031
Composants Internet
tRSSOutput
Dans lespace graphique, slectionnez le tRSSInput. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tRSSInput.
Si votre schma est dj stock dans le Repository, slectionnez loption Repository dans le champ Schema Type 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. Cliquez sur le bouton [...] situ ct du champ Edit Schema pour vrifier les paramtres du schma si ncessaire.
Le schma du tRSSInput est compos de quatre colonnes, TITLE, DESCRIPTION, PUBDATE, et LINK et il est en lecture seule. Dans lespace graphique, slectionnez le composant tRSSOutput. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tRSSOutput.
1032
Composants Internet
tRSSOutput
Dans le champ File name, utilisez le nom de fichier de sortie et son chemin daccs dfinis par dfaut ou parcourez vos dossiers pour dfinir votre propre fichier XML de sortie. Slectionnez le type dencodage partir de la liste Encoding Type. Dans le panneau Channel, saisissez un titre, une description, une date de publication et un lien dfinissant lensemble de vos donnes saisies. Dans le tableau Optional Channel Element, dfinissez les mtadonnes de votre flux RSS. Dans ce scnario, le flux comprend deux mtadonnes : copyright, laquelle est associe la valeur tos, et language, laquelle est associe la valeur en_us. Slectionnez le type de schma dans la liste Schema Type puis cliquez sur Edit Schema pour le modifier si ncessaire.
Vous pouvez galement cliquer sur Sync Column pour rcuprer le schma gnr par le composant prcdent.
Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
1033
Composants Internet
tRSSOutput
Les fichiers dfinis sont copis dans le fichier XML de sortie et les mtadonnes apparaissent sous le noeud <channel>, en dessous des informations de base du flux RSS.
1034
Composants Internet
tSCPConnection
tSCPConnection
Proprits du tSCPConnection
Famille de composant Internet/SCP
Le composant tSCPConnection ouvre une connexion SCP afin deffectuer une transaction. Le tSCPConnection permet douvrir une connexion SCP afin deffectuer des transferts scuriss de fichiers en une seule transaction. Host Port Username Authentication method Password Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP.
Ce composant est gnralement utilis comme sous-Job un seul composant. n/a
Scnarios associs
1035
Composants Internet
tSCPDelete
tSCPDelete
Proprits du tSCPDelete
Le composant tSCPDelete supprime les fichiers slectionns dun serveur distant par le biais dun protocole entirement crypt. Le tSCPDelete permet de supprimer un fichier dun serveur SCP donn. Host Port Username Authentication method Password Filelist Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP. Nom ou chemin daccs du fichier supprimer.
Utilisation
Ce composant est gnralement utilis comme sous-Job un seul composant mais il peut aussi tre utilis en association avec dautres composants. n/a
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1039. Pour un scnario associ utilisant un protocole diffrent, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1004.
1036
Composants Internet
tSCPFileExists
tSCPFileExists
Proprits du tSCPFileExists
Le composant tSCPFileExists vrifie si un fichier est prsent sur le serveur distant, par le biais dun protocole entirement crypt. Le tSCPFileExists permet de vrifier la prsence dun fichier sur le serveur SCP spcifi. Host Port Username Authentication method Password Remote directory Filename Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP. Chemindaccs au rpertoire du serveur distant. Nom du fichier chercher.
Utilisation
Limitation
Scnario associ
1037
Composants Internet
tSCPFileList
tSCPFileList
Proprits du tSCPFileList
Fonction
Le composant tSCPFileList fait une opration ditration sur les fichiers dun rpertoire du serveur distant, par le biais dun protocole entirement crypt. Le tSCPFileList permet de lister les fichiers dun serveur SCP spcifi. Host Port Username Authentication method Password Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP.
Command separator Le caractre utilis pour sparer les diffrentes commandes. Filelist Utilisation Nom ou chemin daccs au rpertoire contenant les fichiers lister.
Limitation
Scnario associ
1038
Composants Internet
tSCPGet
tSCPGet
Proprits du tSCPGet
Le composant tSCPGet transfert les fichiers slectionns par le biais dun protocole entirement crypt via une connexion SCP. Le tSCPGet permet de copier de fichiers du serveur SCP spcifi. Host Port Username Authentication method Password Local directory Overwrite or Append Filelist Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP. Chemin daccs du rpertoire de destination. Liste des options disponibles pour le transfert des fichiers. Nom ou chemin daccs du ou des fichier(s) copier.
Utilisation
Limitation
Scnario : Rcuprer des fichiers dun serveur SCP distant

Ce scnario Java cre un Job un seul composant qui rcupre le fichier slectionn dun serveur SCP distant. Cliquez et dposez le composant tSCPGet dans lditeur graphique. Dans lditeur graphique, slectionnez le tSCPGet et cliquez sur la vue Component pour paramtrer ses proprits de base.
1039
Composants Internet
tSCPGet
Dans le champ Host, renseignez ladresse IP du serveur SCP. Dans le champ Port ,renseignez le numro du port dcoute du serveur SCP. Dans les champs Username et Password, renseignez respectivement le login et le mot de passe de connexion au serveur SCP. Dans la liste Authentication method, slectionnez la mthode dauthentification approprie. Notez que les champs suivants changent en fonction de la mthode dauthentification slectionne. La mthode dauthentification Password est utilise dans ce scnario. Dans le champ Local directory, renseignez le chemin daccs au rpertoire dans lequel sera copi le fichier. Dans la liste Overwrite or Append, slectionnez laction effectuer. Dans la zone Filelist, cliquez sur le bouton [+] pour ajouter une ligne la liste Source et renseignez le chemin daccs au fichier sur le serveur SCP distant. Dans ce scnario, le fichier copier du serveur SCP distant sur le disque local sappelle backport.pl. Enregistrez le Job et appuyez sur F6 lexcuter. Le fichier du serveur distant est copi sur le disque local.
1040
Composants Internet
tSCPPut
tSCPPut
Proprits du tSCPPut
Le composant tSCPPut copie les fichiers slectionns sur un serveur SCP distant par le biais dun protocole entirement crypt. Le tSCPPut permet de copier les fichiers dans le rpertoire dun serveur SCP distant. Host Port Username Authentication method Password Remote directory Filelist Adresse IP dun serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP. Chemin daccs au rpertoire de destination. Nom ou chemin daccs au(x) fichier(s) copier.
Utilisation
Limitation
Scnario associ
1041
Composants Internet
tSCPRename
tSCPRename
Proprits du tSCPRename
Le composant tSCPRename renomme des fichiers sur un serveur SCP distant. Le tSCPRename permet de renommer un ou des fichier(s) sur le serveur SCP slectionn. Host Port Username Authentication method Password File to rename Rename to Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP. Nom ou chemin daccs au fichier renommer. Saisissez le nouveau nom du fichier.
Utilisation
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1039.
1042
Composants Internet
tSCPTruncate
tSCPTruncate
Proprits du tSCPRename
Le composant tSCPTruncate supprime toutes les donnes dun fichier via une connexion SCP. Le tSCPTruncate permet de supprimer les donnes dun ou plusieurs fichier(s) dun serveur SCP. Host Port Username Authentication method Password Remote directory Filelist Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP. Chemin daccs au fichier de destination. Nom ou chemin daccs au(x) fichier(s) vider.
Utilisation
Ce composant est gnralement utilis en tant que sous-Job un seul composant mais il peut aussi tre utilis en association avec dautres composants. n/a
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1039.
1043
Composants Internet
tSendMail
tSendMail
Proprits du tSendMail
Le composant tSendMail envoie des messages et toute autre pice jointe aux destinataires spcifis. Le tSendMail permet de prvenir des destinataires dun tat particulier dun Job ou de possibles erreurs. To From Show senders name? Cc Bcc Subject Message Adresse e-mail du destinataire principal. Adresse e-mail du serveur denvoi. Cochez cette case pour dfinir le nom dexpditeur afficher dans les messages. Sendername : renseignez le nom de lexpditeur. Adresse e-mail des destinataires en copie. Adresse e-mail des destinataires en copie cache. Objet du mail. Contenu du message. Appuyez sur Ctrl+Espace pour afficher la liste des variables disponibles.
Die if the attachment Dcochez cette case pour que les messages soient file doesnt exist envoys mme si aucune pice jointe nest attache. Attachment Cliquez sur le bouton [+] pour ajouter des lignes de filtre : File : masque du fichier ou chemin daccs au fichier joindre le-mail. Cliquez sur le bouton [+] pour ajouter des lignes de filtre : Key : saisissez la cl de tout en-tte diffrent de len-tte standard. Value : saisissez la valeur correspondante la cl. Adresse IP du serveur SMTP utilis pour lenvoi de-mails. Cochez cette case pour authentifier le serveur auprs du client via un protocole scuris SSL. Cochez cette case pour authentifier le serveur auprs du client via un protocole scuris STARTTLS. Slectionnez dans la liste droulante le niveau de priorit de votre message.
Other Headers
SMTP Host et Port SSL Support STARTTLS Support
Importance
1044
Composants Internet
tSendMail
Need authentication?
Cochez la case dauthentification et renseignez le nom de lutilisateur (username) et son mot de passe (password), si cela est ncessaire pour accder au service. 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 les lignes contenant les erreurs seront ignores.
Die on error
Advanced settings
MIME subtype from Slectionnez dans la liste droulante la forme the text MIME type attribuer au texte du message. 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 collecter les donnes de log au niveau du composant.
Ce component est gnralement utilis en tant que sous-Job mais peut aussi tre utilis comme composant de sortie ou de fin de Job. Il peut tre connect aux autres composants via des liens Row ou Iterate. Notez que lenvoi de-mail requiert deux modules (Perl) diffrents suivant quil contient une pice jointe ou non.
Limitation
Scnario : Envoyer un e-mail lors dune erreur

Ce scnario est un Job compos de trois composants permettant denvoyer un e-mail des destinataires spcifiques lorsquune erreur se produit.
A partir de la Palette, cliquez-dposez les composants suivants dans lespace de modlisation : tFileInputDelimited, tFileOutputXML et tSendMail. Cliquez-droit sur le composant tFileInputDelimited et reliez-le au composant tFileOutputXML laide dun lien de type Row > Main. Cliquez-droit sur le composant tFileInputDelimited et reliez-le au composant tSendMail laide dun lien de type Trigger > OnSubjobError. Double-cliquez sur le composant tFileInputDelimited pour afficher longlet Basic settings du composant et configurer ses paramtres de base.
1045
Composants Internet
tSendMail
A partir de la liste Property type, slectionnez : -Repository si vous avez dj stock les mtadonnes de votre fichier dentre dans le Repository, les champs suivants sont alors renseigns automatiquement avec les informations stockes, ou -Built-in si aucune mtadonne nest stocke pour votre fichier dentre ; vous devez alors renseigner manuellement les champs suivants. Dans cet exemple, cest le mode Built-in qui est utilis. Dans le champ File Name, renseignez le chemin daccs ou cliquez sur le bouton [...] pour parcourir vos dossiers jusquau fichier traiter. Ce champ est obligatoire. Dans cet exemple, le fichier traiter est customer_mail.csv. Dfinissez le sparateur de lignes dans le champ Row separator afin didentifier la fin dune ligne. Puis dfinissez le sparateur de champs dans Field separator pour dlimiter les champs composant une ligne. Les sparateurs utiliss dans ce scnario sont des sparateurs de champs et de lignes classiques de fichier CSV. Dans ce scnario, len-tte (Header), le pied de page (Footer) et la limite de lignes lues (Limit) nont pas besoin dtre dfinis. Slectionnez loption Built-in partir de la liste droulante Schema et renseignez manuellement les informations concernant le fichier dlimit dans les champs correspondants. Cliquez sur le bouton [...] ct du champ Edit schema pour afficher la bote de dialogue permettant de dfinir la structure des donnes. Dans ce scnario, le schma comporte quatre colonnes : Id, Name, Address et IdState. Cliquez sur le bouton [+] pour ajouter autant de lignes que ncessaire la structure des donnes. Dans cet exemple, il ny a quune seule colonne dans le schma : xmlStr. Cliquez sur OK pour valider vos changements et fermer la bote de dialogue.
1046
Composants Internet
tSendMail
Si vous avez pralablement stock votre schma dans le rpertoire Metadata sous File delimited, slectionnez loption Repository dans la liste droulante Schema puis cliquez sur le bouton [...] ct du champ pour afficher la bote de dialogue [Repository Content] paritr de laquelle vous pouvez slectionner un schma pertinent. Cliquez sur Ok pour fermer la bote de dialogue et remplir les champs automatiquement avec les mtadonnes contenues dans le schma. Pour plus dinformations sur le stockage des schmas de mtadonnes dans le Repository, consultez les sections Configurer un schma File Delimited et Dposer des composants du rpertoire Metadata du Guide Utilisateur de Talend Open Studio.
Voir galement : Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Assurez-vous que la case Skip empty rows est coche afin dignorer les lignes vierges. Double-cliquez sur le composant tFileOutputXML pour afficher longlet Basic settings du composant et configurer ses paramtres de base.
Cliquez sur le bouton [...] ct du champ File Name pour slectionner le rpertoire de destination du fichier et saisissez le nom du fichier. Dans ce scnario, nous appelons le fichier customer_data.xml. Dans le champ Row tag, saisissez entre guillemets le nom que vous souhaitez donner la balise contenant les donnes. Cliquez sur Edit schema et assurez-vous que le schma est rcupr partir du schma dentre. Si ncessaire, cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Double-cliquez sur le composant tSendMail pour afficher longlet Basic settings du composant et configurer ses paramtres de base.
1047
Composants Internet
tSendMail
Saisissez les adresses e-mail des destinataires dans le champ To et les champs Cc et Bcc selon vos prfrences, ainsi que celle de lexpditeur dans le champ From. Cochez la case Show senders name? puis renseignez le nom de lexpditeur dans le champ Sendername pour que votre message ait une meilleure visibilit auprs de vos destinataires. Renseignez lobjet du message dans le champ Subject. Saisissez dans le champ Message le message contenant le code derreur produit laide de la variable globale correspondante. Accdez la liste des variables en appuyant sur Ctrl+Espace. Ajoutez des pices jointes et des informations sur les en-ttes, si ncessaire, dans les champs respectifs Attachments et Other headers. Saisissez les informations SMTP dans les champs SMTP host et SMTP port. Enregistrez votre Job puis appuyez sur F6 pour lexcuter. Dans ce scnario, le fichier contenant les donnes transfrer vers une sortie XML ne peut tre trouv. Le composant tSendmail sexcute lorsque cette erreur est rencontre et envoie un mail de notification au destinataire spcifi.
1048
Composants Internet
tSocketInput
tSocketInput
Proprits du tSocketInput
Fonction Objectif JAVA Basic settings
Le composant tSocketInput ouvre un port de socket et permet dcouter les donnes envoyes. Le tSocketInput est un composant dcoute, permettant de transmettre des donnes via un port dfini. Host name Port Timeout Uncompress Die on error Nom ou adresse IP du serveur Hte. Port dcoute ouvrir. Nombre de secondes avant fermeture du socket du port dcoute. Cochez cette case pour extraire les donnes si ncessaire. 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. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \nsous Unix) utilise pour sparer les lignes. Caractre de la ligne viter. Caractres utiliss pour entourer le texte. 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.
Field separator Row separator Escape Char Text enclosure Schema type et Edit Schema
1049
Composants Internet
tSocketInput
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.
Utilisation
Ce composant ouvre un point daccs au poste de travail ou au serveur. Ce composant est un composant de dbut de Job et sarrte uniquement aprs expiration. n/a
Limitation
Les proprits Perl tant lgrement diffrentes des proprits Java, elles sont dcrites dans le tableau suivant :
PERL basic settings Schema type 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. Host name Port Field separator End of Line separator End of data Opening message /Message /Acknowledge message /Closing message Utilisation Nom ou adresse IP du serveur Hte Port dcoute ouvrir. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) utilise pour sparer les lignes. Caractre, chane ou expression rgulire indiquant la fin de la section de donnes. Description du message, si ncessaire.
Ce composant ouvre un point daccs un poste de travail ou un serveur. Ce composant dbute un Job et ne sarrte quaprs avoir reu un message de fermeture.
1050
Composants Internet
tSocketInput
Scnario : Transfrer des donnes vers un port dcoute (Java)

Le scnario suivant dcrit un double Job dont le but est de transfrer des donnes via un port dcoute. Le composant Socket peut aussi permettre de contrler la communication entre les serveurs ne pouvant pas communiquer directement entre eux.
Crez deux Jobs : le premier (SocketInput) ouvre un port dcoute et attend que les donnes soient envoyes. Le deuxime (SocketOutput) transmet des donnes dlimits dun fichier vers le numro de port correspondant au port dcoute. Dans le premier Job, cliquez et dposez les composants suivants : tSocketInput et tLogRow. Dans le deuxime Job, cliquez et dposez les composants suivants : tFileInputDelimited et tSocketOutput. Commencez par configurer les paramtres du deuxime Job. Slectionnez tFileInputDelimited et dans longlet Basic Settings de la vue Component, configurez les paramtres daccs au fichier dentre.
Dans le champ File Name, renseignez le chemin daccs au fichier. Renseignez les sparateurs de lignes et de champs respectivement dans les champs Row et Field separators, ainsi que len-tte dans le champ Header.
1051
Composants Internet
tSocketInput
Dcrivez le schma des donnes passer au composant tSocketOutput. Slectionnez le composant tSocketOutput et configurez les paramtres de longlet Basic Settings de la vue Component.
Dans le champ Host, renseignez ladresse IP et dans le champ Port, renseignez le numro du port vers lequel les donnes seront transfres. Dans le champ Retry, dfinissez le nombre dessais effectuer et dans le champ Timeout renseignez la dure (en seconde) avant que le Job ne sarrte automatiquement. Configurez le reste des options si ncessaire. Le schma devrait se propager du composant prcdent. Maintenant, configurez les paramtres du premier Job (SocketInput) contenant le composant tSocketInput.
Dans le champ Host, renseignez ladresse IP et dans le champ Port, renseignez le numro du port dcoute vers lequel les donnes sont transfres. Dans le champ Timeout, dfinissez la dure (en secondes) avant que le Job ne sarrte automatiquement.
1052
Composants Internet
tSocketInput
Configurez le reste des options si ncessaire. Modifiez le schma afin quil corresponde en tout point ou en partie au schma du deuxime Job. Laissez les proprits par dfaut du composant tLogRow. Excutez le Job SocketInput en premier, afin douvrir le port dcoute et de le prparer recevoir les donnes. Avant que le Job ne sarrte, lancez lautre Job (SocketOutput) afin de transmettre les donnes. Le rsultat saffiche dans la vue Run, ainsi que les informations douverture du socket.
1053
Composants Internet
tSocketOutput
tSocketOutput
Proprits du tSocketOutput
Le composant tSocketOutput crit des donnes sur un port dcoute. Le tSocketOutput transfert des donnes dun flux dentre vers le port dcoute du socket. Host Port Compress Retry times Timeout Field separator Row separator Escape Char Text enclosure Schema type et Edit Schema Nom ou adresse IP du serveur Hte. Port dcoute ouvrir Cochez cette case pour archiver les donnes si ncessaire. Nombre dessais avant que le Job ne soit mis en chec. Nombre de secondes avant fermeture du port dcoute. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) sparant les lignes. Caractre de la ligne viter. Caractres utiliss pour entourer le texte. 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. 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.
Utilisation
Ce composant ouvre un point daccs au poste de travail ou au serveur. Ce composant est un composant de dbut de Job et sarrte uniquement aprs expiration.
1054
Composants Internet
tSocketOutput
Limitation
n/a
Scnario associ
Pour un exemple dutilisation du tSocketOutput, consultez Scnario : Transfrer des donnes vers un port dcoute (Java) page 1051.
1055
Composants Internet
tWebServiceInput
tWebServiceInput
Proprits du tWebServiceInput
Fonction Objectif
Ce composant appelle la mthode du service Web invoqu et retourne la classe dfinie en fonction des paramtres donns. Le tWebServiceInput invoque une mthode via un service Web dont lobjectif est celui dcrit dans les proprits. Pour traiter des donnes complexes hirarchiques, vous devez utiliser les fonctions avances du tWebServiceInput en codant directement du Java dans le champ Code de la vue Advanced settings. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de cration de schma WSDL et enregistrer les paramtres de connexion WSDL que vous avez dfinis dans la vue Basic settings du composant dans le Repository. Pour plus dinformations sur la configuration et le stockage des paramtres de connexion WSDL, consultez la section Configurer un schma WSDL du Guide Utilisateur de Talend Open Studio. Perl uniquement 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. 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. 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
1056
Composants Internet
tWebServiceInput
Perl uniquement
End Point URI WSDL
Identificateur de ressources du service Web. Description des bindings et de la configuration du service Web. Cochez cette case dauthentification et : - Saisissez un identifiant, ainsi quun mot de passe, dans les champs correspondants, si ncessaire pour accder au service. Sinon, - Cochez la case Windows authentication et saisissez le nom de domaine Windows dans le champ correspondant si cela est ncessaire pour accder au service. Cochez cette case si vous vous connectez derrire un proxy et renseignez les informations correspondantes. Cochez cette case pour authentifier le serveur auprs du client via un protocole SSL et renseignez les champs correspondants. TrustStore file : saisissez le chemin daccs et le nom du fichier TrustStore contenant la liste des certificats approuvs par le client. TrustStore password : saisissez le mot de passe utilis pour vrifier lintgrit des donnes TrustStore. Saisissez en secondes la dure de connexion au service Web. Saisissez le nom exact de la mthode invoquer. Le nom de la mthode DOIT correspondre la mthode dcrite dans le service Web. Le nom de la mthode est sensible la casse. Saisissez les paramtres attendus et les valeurs retourner. Assurez-vous que les paramtres saisis correspondent parfaitement aux noms et la casse des paramtres dcrits dans la mthode.
Java uniquement
Need authentication / Username et Password
Java uniquement
Use http proxy
Java uniquement
Trust server with SSL
Java uniquement
Time out (second) Method Name
Parameters
Advanced settings
Advanced Use
Cochez cette case pour afficher les champs suivants permettant dutiliser les fonctions avances du tWebServiceInput : Java uniquemen WSDL2Java : cliquez sur le bouton [...] pour gnrer des routines contenant les codes Java t ncessaires la connexion et linterrogation du service Web. Code : saisissez le code permettant de se connecter et dinterroger le service Web en vous basant sur les deux modles proposs en utilisant les routines gnres automatiquement. Match Brackets : slectionnez le nombre daccolades utiliser pour fermer la boucle for en fonction du nombre daccolades ouvertes.
1057
Composants Internet
tWebServiceInput
Ce component est gnralement utilis comme composant de dbut. Il requiert un composant de sortie. n/a
Scnario 1 : Extraire des images laide dun Webservice

Ce scnario dcrit un Job constitu de deux composants dont le but est dutiliser une mthode de service Web et dafficher le rsultat en sortie dans une vue standard. La mthode rcupre une adresse URL complte sous forme de chane en entre et retourne une liste dimages provenant dune page Web donne.
Cliquez et dposez les composants tWebServiceInput et tLogRow. Dans la vue Component du composant tWebServiceInput, configurez les spcifications WSDL : WSDL et End Point URI lorsque cela est ncessaire. Si le service Web invoqu requiert des informations dauthentification, cochez la case Need authentication? et renseignez ces informations.
Si vous vous connectez derrire un proxy, cochez la case Use http proxy et renseignez les champs concernant lhte, lutilisateur, le port et le mot de passe. Dans le champ Method Name, saisissez le nom de la mthode tels que dfinis dans la description du service Web. Le nom et la casse de la mthode saisie doivent correspondre parfaitement la mthode du service Web demand.
1058
Composants Internet
tWebServiceInput
Dans la zone Parameters, cliquez sur le bouton [+] pour ajouter une ligne au tableau, puis saisissez le nom exact des paramtres tel quattendus par la mthode. Dans la colonne Value, saisissez ladresse URL du site Web partir duquel les images seront extraites. Connectez le composant tWebServiceInput au composant de sortie standard, tLogRow. Appuyez sur F6 pour excuter le Job.
Toutes les images extraites du site Web spcifi sont retournes dans la vue Run, sous la forme dune liste dadresses URL.
Scnario 2 : Lire des donnes publies dans un service Web, en utilisant les fonctions avances du tWebServiceInput (Java)
Ce scnario dcrit un Job constitu de deux composants dont le but est de rcuprer une liste de fonds publie sur un service Web financier (distribu par www.xignite.com) et dafficher le rsultat en sortie dans la vue standard (la vue Run). Ce scnario est destin des utilisateurs avancs ayant des notions de Java. En effet, lobjectif de ce Job tant de rcuprer des donnes complexes hirarchiques, il est ncessaire de coder en Java les fonctions dont vous avez besoin pour rcuprer ces donnes.
1059
Composants Internet
tWebServiceInput
Cliquez et dposez le composant tWebServiceInput de la famille Internet et le composant tLogRow de la famille Logs & Errors dans lespace de modlisation. Reliez les composants laide dune connexion de type Row Main. Double-cliquez sur le tWebServiceInput pour afficher la vue Component et paramtrer ses proprits :
Dans longlet Basic settings : Dans la liste Property Type, slectionnez loption Built-in et renseignez manuellement les champs suivants. Dans la liste Schema Type, slectionnez Built-in et cliquez sur le bouton [...] pour configurer manuellement le schma comme dans la figure ci-dessous :
1060
Composants Internet
tWebServiceInput
Dans le champ WSDL, saisissez ladresse du WSDL auquel vous connecter. Dans le champ Time out, saisissez en secondes la dure de la connexion au service Web. Cliquez sur longlet Advanced settings pour renseigner les fonctions avances du composant tWebServiceInput :
Cochez la case Advanced Use pour afficher les champs de configuration avance. Cliquez sur le bouton [...] situ ct du champ WSDL2Java pour gnrer automatiquement des routines partir du WSDL du service Web.
1061
Composants Internet
tWebServiceInput
Ces routines apparaissent sous le noeud Code > Routines du Repository, et peuvent tre utilises dans le code pour construire les fonctions ncessaires la rcupration des donnes hirarchiques du service Web. Saisissez les fonctions adquates dans le champ Code. Par dfaut, deux exemples de code sont fournis dans le champ Code : le premier sert retourner une donne et le deuxime en retourner plusieurs. Pour ce scnario, nous souhaitons retourner plusieurs donnes. Ainsi, supprimez le premier exemple de code et utilisez le deuxime exemple de code pour construire les fonctions. Dans le deuxime exemple, remplacez les morceaux de code exemple par le code correspondant gnr dans les routines partir du WDSL. Remplacez TalendJob_PortType par le nom de la routine terminant par _Port_Type : XigniteFundHoldingsSoap_PortType. Remplacez les diffrentes instances de talendJob par un nom plus parlant tel que le nom de la mthode utilise : fundHolding. Remplacez TalendJobServiceLocator par le nom de la routine terminant par Locator : XigniteFundHoldingsLocator. Remplacez les deux instances de TalendJobSoapBindingStub par le nom de la routine terminant par BindingStub : XigniteFundHoldingsSoap_BindingStub. Dans les parenthses correspondant aux codes stub.setUsername et stub.setPassword, saisissez respectivement votre identifiant et votre mot de passe entre guillemets. Dans un souci de confidentialit ou de maintenance, vous pouvez mettre votre identifiant et votre mot de passe dans des variables de contexte.
1062
Composants Internet
tWebServiceInput
La liste des fonds fournis par le service Web de Xignite sont identifis laide de symboles (Symbol), qui sont de type String (chane de caractres). Dans cet exemple, nous souhaitons rcuprer la liste des fonds dont la premire lettre du symbole est comprise entre I et J. Pour cela, dfinissez les arguments utiliser : string startSymbol=I et String endSymbol=J. Puis saisissez le code permettant de crer le tableau de rsultat rcuprant la liste des fonds (listFunds) de participation (fundholdings) en utilisant les arguments dfinis : routines.Fund[] result = fundHoldings.listFunds(startSymbol, endSymbol); Effectuez une boucle sur la liste des fonds pour rcuprer les fonds compris entre I et J : for(int i = 0; i < result.length; i++) { Puis dfinissez les sorties retourner, par exemple : rcuprez les donnes CIK du schma Security avec le code getSecurity().getCIK() et transmettez-les au champ CIK du schma de sortie. Le code obtenu pour faire fonctionner le service Web doit correspondre au code suivant : routines.XigniteFundHoldingsSoap_PortType fundHoldings = new routines.XigniteFundHoldingsLocator().getXigniteFundHoldingsSoap( ); routines.XigniteFundHoldingsSoap_BindingStub stub = (routines.XigniteFundHoldingsSoap_BindingStub)fundHoldings; stub.setUsername(identifiant); stub.setPassword(mot de passe); String startSymbol="I"; String endSymbol="J"; routines.Fund[] result = fundHoldings.listFunds(startSymbol, endSymbol); for(int i = 0; i < result.length; i++) { output_row.CIK = (result[i]).getSecurity().getCIK(); output_row.cusip = (result[i]).getSecurity().getCusip(); output_row.symbol = (result[i]).getSecurity().getSymbol(); output_row.ISIN = (result[i]).getSecurity().getISIN(); output_row.valoren = (result[i]).getSecurity().getValoren(); output_row.name = (result[i]).getSecurity().getName(); output_row.market = (result[i]).getSecurity().getMarket(); output_row.category = (result[i]).getSecurity().getCategoryOrIndustry(); output_row.asOfDate = (result[i]).getAsOfDate();
Les sorties dfinies dans le code Java output_row.sortie doivent correspondre exactement aux noms des colonnes dfinis dans le schma du composant. En effet, la casse doit tre respecte pour que les donnes soient rcupres.
1063
Composants Internet
tWebServiceInput
Dans le champ Match Brackets, slectionnez le nombre daccolades utiliser pour fermer la boucle for en fonction du nombre daccolades ouvertes. Pour ce scnario, slectionnez une seule accolade puisquune seule accolade a t ouverte dans le code. Double-cliquez sur le composant tLogRow pour afficher la vue Component et paramtrer ses proprits. Cliquez sur le bouton [...] situ ct du champ Edit Schema pour vrifier que le schma du composant prcdent a bien t propag au composant de sortie. Sinon, cliquez sur le bouton Sync columns pour rcuprer le schma. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Les fonds compris entre I et J sont retourns et affichs dans la console de Talend Open Studio.
1064
Composants Internet
tXMLRPCInput
tXMLRPCInput
Proprits du tXMLRPCInput
Ce composant appelle la mthode du service RPC invoqu et retourne la classe dfinie en fonction des paramtres donns. Le composant tXMLRPCInput invoque une mthode via un service Web dont lobjectif est celui dcrit dans les proprits. 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. Dans le contexte du RPC, le schma correspond aux paramtres de sortie. Si deux paramtres doivent tre retourns, alors le schma comportera deux colonnes. Adresse URL du service RPC accder Cochez la case dauthentification et renseignez le nom de lutilisateur (username) et son mot de passe (password), si cela est ncessaire pour accder au service. Saisissez le nom exact de la mthode invoquer. Le nom de la mthode DOIT correspondre parfaitement la mthode dcrite dans le service RPC. Le nom de la mthode est sensible la casse. Slectionnez le type de donnes retourner par la mthode. Assurez-vous quil correspond parfaitement celui dfini dans la mthode. Saisissez les paramtres attendus en entre par la mthode.
Server URL Need authentication / Username et Password Method Name
Return class
Parameters Utilisation Limitation
Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a
Scnario : Chercher le nom dun Etat via une mthode XMLRPC

Ce scnario dcrit un Job deux composants utilisant une mthode RPC et affichant le rsultat dans la console.
1065
Composants Internet
tXMLRPCInput
Cliquez et dposez les composants tXMLRPCInput et tLogRow. Dans longlet Basic settings, paramtrez les proprits du composant tXMLRPCInput.
Dans la liste droulante Schema type, slectionnez loption Built-in. Configurez un schma contenant une unique colonne puisque seul un paramtre est attendu en sortie : StateName.
Dans le champ Server url, renseignez ladresse URL du serveur. Pour cet exemple, utilisez : http://phpxmlrpc.sourceforge.net/server.php Aucune information dauthentification nest ncessaire pour cet exemple. Dans le champ Method, renseignez la mhode appeler, ici : examples.getStateName Pour cet exemple, la classe retourne nest pas obligatoire. Ainsi, dans le champ return class, laissez les paramtres par dfaut. Puis, dans le tableau Parameters, configurez les paramtres ncessaires la mthode appele. La colonne Name nest pas utilise dans le code mais la valeur doit correspondre la syntaxe attendue par la mthode. Dans cet exemple, saisissez State Nr dans le champ Name et dans le champ Value, choisissez un numro au hasard, ici : 42.
1066
Composants Internet
tXMLRPCInput
La classe na pas beaucoup dimpact sur cette mthode dmo mais pourrait en avoir sur une autre mthode. Ainsi, laissez les paramtres par dfaut. Dans la vue Component du composant tLogRow, cochez la case Print schema column name in front of each value. Enregistrez le Job puis excutez-le, en appuyant sur F6.
Le rsultat obtenu en sortie en utilisant la mthode RPC GetStateName et correspondant au quarante deuxime Etat des Etats Unis est donc South Dakota.
1067
Composants Internet
tXMLRPCInput
1068
Composants Logs & Errors

Ce chapitre passe en revue les principaux composants de la famille Logs & Errors de la Palette de Talend Open Studio. La famille Logs & Errors regroupe les composants ddis la gestion des donnes de log et des erreurs des Jobs.

tAssert
tAssert
Proprits du tAssert
Le composant tAssert est troitement li au tAssertCatcher pour tester une excution de Job. Il gnre une assertion boolenne partir dune instruction conditionnelle, dans le but dalimenter le statut dexcution prsent par le tAssertCatcher.
Famille de composant Logs & Errors
Fonction Objectif
Envoie le message de statut du Job au tAssertCatcher. Gnre lassertion boolenne relative lanalyse du Job. Le statut peut tre : Ok : lexcution du Job a russi. Fail : lexcution a chou. Les rsultats du Job test ne correspondent pas ce qui tait attendu, ou une erreur est survenue lors de lexcution. Description Expression Saisissez votre message descriptif afin d'identifier l'assertion du tAssert. Saisissez linstruction conditionnelle sur laquelle baser votre assertion.
Basic settings
Utilisation
Ce composant suit l'action laquelle est lie directement la condition assertive. Il peut tre utilis comme composant intermdiaire ou final du Job principal, ou bien en tant que composant de dbut, intermdiaire ou de fin du Job secondaire. Lvaluation du tAssert est capture par le tAssertCatcher.
Limitation
Scnario : Paramtrer une condition assertive pour lexcution dun Job

Ce scnario dcrit comment paramtrer une condition assertive dans le composant tAssert afin dvaluer si lexcution du Job a russi ou non. De plus, vous pouvez galement trouver comment deux rsultats diffrents dvaluation saffichent et comment les lire. Le scnario utilise un tAssert, mais aussi : un tFileInputDelimited et un tFileOutputDelimited. Les deux composants constituent le Job principal, duquel le statut dexcution est valu. Pour plus dinformations sur ces deux composants, consultez les composants : tFileInputDelimited, page 886 et tFileOutputDelimited, page 946. un tFileCompare. Il ralise la comparaison entre le fichier de sortie du Job principal et un fichier de rfrence standard. Le rsultat comparatif est valu par le tAssert par rapport la condition assertive configure dans ses paramtres. Pour plus dinformations propos du tFileCompare, consultez le composant tFileCompare, page 870. un tAssertCatcher. Il capture lvaluation gnre par le tAssert. Pour plus dinformations propos du composant tAssertCatcher, consultez le composant tAssertCatcher, page 1076.

tAssert
un tLogRow. Il vous permet de lire lvaluation capture. Pour plus dinformations propos du tLogRow, consultez le composant tLogRow, page 1095. Afin de crer le Job principal, procdez comme suit : Prparez un fichier dlimit .csv comme fichier source lu par votre Job principal. Editez deux lignes dans ce fichier. Les modifications nont pas dimportance, vous pouvez uniquement simplifier le contenu. Nommez-le source.csv. Dans Talend Open Studio, crez un nouveau Job, que vous appelerez JobAssertion. Placez un tFileInputDelimited et un tFileOutputDelimited dans lespace de modlisation graphique. Connectez- les laide dun lien Row Main afin de crer le Job principal.
Double-cliquez sur le tFileInputDelimited afin douvrir sa vue Component. Dans le champ File Name de la vue Component, renseignez le chemin daccs votre fichier source.csv.
Slectionnez dans la liste Property Type le mode Built-In et cliquez sur le bouton [...] de loption Edit schema afin de dfinir les donnes passer au tFileOutputDelimited. Dans ce scnario, slectionnez les donnes prsentes dans le fichier source.csv que vous avez cr. Pour plus dinformations propos des types de schma, consultez Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio. Dfinissez les autres paramtres dans les champs correspondants, selon le fichier source.csv que vous avez cr. Double-cliquez sur le tFileOutputDelimited afin douvrir sa vue Component.
1071

tAssert
Dans le champ File Name de la vue Component, renseignez le chemin daccs votre fichier de sortie, et laissez les autres champs comme dfinis par dfaut.
Appuyez sur F6 afin dexcuter le Job principal. Il lit votre fichier source.csv, passe les donnes au tFileOutputDelimited et crit un fichier dlimit de sortie, out.csv. Continuez modifier votre Job, afin de voir comment le tAssert value le statut dexcution du Job principal. Renommez le fichier out.csv en reference.csv. Ce fichier est le rsultat attendu de lcriture du Job principal. Placez un tFileCompare, un tAssert et un tLogRow dans lespace de modlisation graphique. Connectez-les avec un lien Row Main. Connectez le tFileInputDelimited au tFileCompare avec un lien OnSubjobOk.
Double-cliquez sur le tFileCompare afin douvrir sa vue Component. Dans la vue Component, renseignez les chemins daccs dans les champs File to compare et Reference file correspondants, et laissez les autres champs comme dfinis par dfaut.
1072

tAssert
Pour plus dinformations propos du composant tFileCompare, consultez le composant tFileCompare, page 870. Cliquez ensuite sur le tAssert, puis cliquez sur longlet Component, au bas de lespace de modlisation graphique.
Dans la vue Component, ditez la condition row2.differ==0, dans le champ expression ainsi que la description de lassertion. Dans le champ expression, row2 constitue le flux de donnes transmis du tFileCompare au tAssert, differ est une colonne du schma du tFileCompare qui affiche si les fichiers compars sont identiques. 0 signifie quaucune diffrence na t dtecte entre le fichier out.csv et le fichier reference.csv par le tFileCompare. Les fichiers compars sont donc identiques, la condition assertive est remplie, le tAssert conclut que le Job principal a t excut avec succs. Sinon, il conclut quil a chou.
La colonne differ fait partie du schma, en lecture seule, du tFileCompare. Pour plus dinformations sur son schma, consultez le composant tFileCompare, page 870.
Appuyez sur F6 afin dexcuter votre Job. Vrifiez le rsultat retourn dans la vue Run.
1073

tAssert
La console affiche les rsultats de la comparaison du tFileCompare : Files are identical. Mais lvaluation du tAssert nest visible nulle part. Vous avez donc besoin du composant tAssertCatcher pour capturer lvaluation. Placez un tAssertCatcher et un tLogRow dans lespace de modlisation graphique. Connectez-les laide dun lien Row Main.
Utilisez la configuration par dfaut du tAssertCatcher dans sa vue Component.
1074

tAssert
Appuyez sur F6 afin dexcuter votre Job. Vrifiez les rsultats prsents dans la vue Run. Vous pouvez voir que les informations sur le statut du Job ont t ajoutes : 2010-01-29 15:37:33|fAvAzH|TASSERT|JobAssertion|java|tAssert_1|Ok|--| The output file should be identical with the reference file.
La description du JobAssertion dans la console est organise selon le schma du tAssertCatcher, lequel comprend des colonnes correspondant au temps dexcution, lID trait, au nom du projet, au langage du code, lorigine de lvaluation, le rsultat de lvaluation, les informations dtailles de lvaluation, et le message descriptif de lassertion. Pour plus dinformations propos du schma du tAssertCatcher, consultez le composant tAssertCatcher, page 1076. La console indique que le statut dexcution du Job JobAssertion est Ok. En plus de lvaluation, vous pouvez toujours voir les informations descriptives du JobAssertion, parmi lesquelles la description que vous avez saisie dans les Basic settings du tAssert. Effectuez ensuite quelques oprations pour que le Job principal ne puisse gnrer le fichier attendu. Pour ce faire, procdez comme suit : Effacez une ligne de votre fichier reference.csv. Appuyez sur F6 pour excuter votre Job nouveau. Vrifiez les rsultats retourns dans la vue Run. 2010-02-01 19:47:43|GeHJNO|TASSERT|JobAssertion|tAssert_1|Failed|Test logically failed|The output file should be identical with the reference file.
La console indique que le statut dexcution du Job principal est Failed (a chou). Lexplication dtaille suit peu aprs, Test logically failed (chec logique du test). Vous pouvez avoir une ide du statut de votre Job : il a chou lors de la gnration du fichier attendu cause dun chec logique. Cet chec logique peut provenirdune erreur logique lors de la cration du Job. Le statut et ses explications sont prsents respectivement dans les colonnes de statut et de sous-statut du schma du tAssertCatcher. Pour plus dinformations propos de cette colonne, consultez le composant tAssertCatcher, page 1076.
1075

tAssertCatcher
tAssertCatcher
Proprits du tAssertCatcher
A partir de son schma prdfini, le tAssertCatcher retrouve les informations des statuts d'excution, des excutions des Jobs et du tAssert. Gnre un flux de donnes consolidant les informations de statut dune excution de Job, et transfre les donnes dans les fichiers de sortie dfinis. Schema type Un schma est une description de lignes, i.e., il dfinit les champs traiter et passer au composant suivant. Pour ce composant, le schma est en lecture seule puisquil regroupe les informations de log standard, notamment : Moment : Date et heure de traitement. Pid : ID traits. Project : Projet auquel appartiennent les Jobs analyss. Job : Nom du Job analys. Language : Langage utilis par le Job. Cela peut tre Java ou Perl. Origin : Origine de lassertion de statut. Elle peut provenir de diffrents composants tAssert. Status : Jugements retrouvs partir du tAssert. Ils peuvent tre : - Ok : si linstruction conditionnelle du tAssert est value comme vraie (true) lexcution. - Failed : si linstruction conditionnelle du tAssert est value comme fausse (false), ou si des erreurs surviennent lexcution. Les rsultats du Job test ne correspondent pas ce qui tait attendu, ou une erreur est survenue lors de lexcution. Substatus : Explications dtailles propos des assertions de statut. Les explications peuvent tre : - Test logically failed : le Job analys ne produit pas le rsultat attendu. - Execution Error : une erreur dexcution est survenue lors de lexcution. Description : La description textuelle que vous avez saisie dans le tAssert. Catch Java Exception Cette case, une fois coche, vous permet de capturer les erreurs dexception Java. Catch tAssert Cette case vous permet de capturer les assertions du tAssert.
1076

tAssertCatcher
Utilisation
Ce composant est un composant de dbut de Job secondaire qui retrouve les informations de statut dexcution partir de diffrentes sources. Il gnre un flux de donnes afin de transfrer les informations au composant suivant. Ce composant doit tre utilis avec le composant tAssert.
Limitation
Scnario associ
Pour un scnario associ, consultez le scnario du tAssert : Scnario : Paramtrer une condition assertive pour lexcution dun Job, page 1070
1077

tChronometerStart
tChronometerStart
Proprits du tChronometerStart
Fonction Objectif
Le composant tChronometerStart dmarre lopration de mesure du temps dexcution dun sous-Job. Le tChronometerStart fonctionne comme un chronomtre : le composant commence calculer soit le temps de traitement dun ou plusieurs sous-Jobs du Job principal, soit le temps de traitement dune partie dun sous-Job. Vous pouvez utiliser le tChronometerStart comme composant de dbut ou au milieu dun Job. Il peut prcder une ou plusieurs tches de traitement dans un sous-Job. Il peut galement prcder un ou plusieurs sous-Jobs dans le Job principal. n/a
Utilisation
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Mesurer la dure de traitement dun sous-Job ou dune partie dun sous-Job.
1078

tChronometerStop
tChronometerStop
Proprits du tChronometerStop
Fonction Objectif
Le composant tChronometerStop mesure le temps dexcution dun sous-Job. Le tChronometerStop fonctionne comme un chronomtre : arrte le calcul du temps de traitement soit dun ou de plusieurs sous-Jobs dans le Job principal, soit dune partie dun sous-Job. En Perl, le composant tChronometerStop affiche le temps dexcution total, le nombre dexcutions, le nombre de lignes traites la seconde ainsi que le temps minimal, maximal et moyen de traitement dune ligne. En Java, il affiche le temps dexcution total. Since options Cochez lune des deux cases pour choisir le point de dpart du processus de mesure : Since the beginning : arrte le calcul du temps dont la mesure a commenc au dbut dun sous-Job. Since a tChronometerStart : arrte le calcul du temps dont la mesure a commenc partir dun composant tChronometerStart utilis sur le flux de donnes du sous-Job. Cochez cette case pour afficher les informations dexcution du sous-Job sur la console. Cochez cette case pour afficher le nom des composants sur la console. Entrez un texte, pour permettre didentifier votre sous-Job par exemple. Cochez cette case pour afficher les informations dexcution du sous-Job en units de temps exploitables.
Basic settings
Display duration in console Display component name Caption Display human readable duration Utilisation Limitation
Ne peut tre utilis comme composant de dbut. n/a
Scnario : Mesurer la dure de traitement dun sous-Job ou dune partie dun sous-Job
Ce scnario est un sous-Job, qui, dans une squence, effectue les oprations suivantes : gnre 1 000 000 lignes de noms et de prnoms ; regroupe les noms et les prnoms correspondants ; stocke les donnes de sortie dans un fichier dlimit ; mesure la dure densemble du sous-Job ;
1079

tChronometerStop
affiche les informations relatives au temps de traitement dans la console de log Run. Pour mesurer le temps dexcution du sous-Job : A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tRowGenerator, le tMap, le tFileOutputDelimited et le tChronometerStop. Reliez les trois premiers composants laide de liens de type Main Row.
Lorsque vous reliez le tMap au tFileOutputDelimited, vous serez invits donner un nom la table en sortie. Le nom utilis dans cet exemple est new_order.
Reliez le tFileOutputDelimited au tChronometerStop laide dun lien de type OnComponentOk. Slectionnez le tRowGenerator puis cliquez sur la vue Component pour paramtrer ses proprits de base, dfinies par dfaut, dans longlet Basic settings.
Cliquez sur le bouton [...] du champ Edit schema pour dfinir le schma du tRowGenerator. Cliquez deux fois sur le bouton [+] pour ajouter deux colonnes : First_Name et Last_Name. Cliquez sur OK afin de fermer la bote de dialogue. Cliquez sur le bouton [...] du champ RowGenerator Editor pour ouvrir lditeur et dfinir les donnes gnrer.
1080

tChronometerStop
Dans le champ Number of Rows for RowGenerator de lditeur [RowGenerator Editor], prcisez le nombre de lignes gnrer puis cliquez sur OK. Lditeur [RowGenerator Editor] se ferme. Une bote de dialogue souvre et vous demande si vous souhaitez propager les changements. Cliquez sur Yes (Oui). Double-cliquez sur le composant tMap pour ouvrir son diteur. Lditeur du tMap affiche le schma du component tRowGenerator.
Dans longlet Schema editor de lditeur du tMap, cliquez sur le bouton [+] de la table de sortie pour ajouter deux lignes puis configurez-les. Dans lditeur du tMap, glissez la ligne First_Name de la table dentre dans la ligne Last_Name de la table de sortie et glissez la ligne Last_Name dans la ligne First_Name de la table de sortie. Cliquez sur Apply pour enregistrer les modifications. A nouveau, une bote de dialogue souvre et vous demande si vous souhaitez propager les changements. Cliquez sur Yes. Cliquez sur OK pour fermer lditeur.
1081

tChronometerStop
Slectionnez le tFileOutputDelimited et cliquez sur la vue Component pour paramtrer ses proprits de base dans longlet Basic settings :
Slectionnez le tChronometerStop et cliquez sur la vue Component pour paramtrer ses proprits de base dans longlet Basic settings. Dans la zone Since options, cochez la case Since the beginning pour mesurer la dure dexcution du sous-Job entier.
1082

tChronometerStop
Cochez/dcochez les autres cases en fonction de vos besoins. Dans ce scnario, nous souhaitons afficher dans la console la dure dexcution du sous-Job, prcde du nom du composant. Si ncessaire, saisissez du texte de le champ Caption. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Vous pouvez aussi mesurer la dure du sous-Job en plaant un tChronometerStop en dessous du tRowGenerator, et en les connectant via un lien OnSubJobOk.
1083

tDie
tDie
Proprits du tDie
Les composants tDie et tWarn sont troitements lis au composant tLogCatcher. Ils sont gnralement utiliss ensemble afin que les donnes de log collectes par le tLogCatcher soient rassembles et envoyes vers la sortie dfinie.
Le composant tDie tue le Job en cours dexcution. Il est gnralement utilis avec un composant tCatch afin de collecter des donnes de log. Ce composant dclenche le composant tLogCatcher afin de collecter des donnes de log exhaustives avant de tuer le Job. Die message Error code Priority Saisissez le message qui sera affich avant que le Job ne soit tu. Saisissez le code de lerreur (un entier) si ncessaire. Slectionnez le niveau de priorit.
Ce composant ne peut tre utilis en tant que composant de dbut. n/a
Scnarios associs
Pour des exemples dutilisation du composant tDie, consultez les scnarios du composant tLogCatcher : Scnario 1 : Avertissement & log lors de la cration dentres, page 1091 Scnario 2 : Monitorer & arrter un Job, page 1093
1084

tFlowMeter
tFlowMeter
Proprits du tFlowMeter
Le composant tFlowMeter compte le nombre de lignes traites dans le flux spcifi. Le nombre de lignes est ensuite rcupr par le composant tFlowMeterCatcher afin dtre ajout dans les donnes de log. Use input connection name as label Mode Cochez cette case pour rutiliser le nom donn au flux dentre Main Row comme libell des donnes logge. Slectionnez le type de valeur des donnes mesures : Absolute : le nombre actuel de lignes est logg. Relative : un pourcentage (%) du nombre de lignes est logg. Ajoutez un seuil pour observer les proportions en volumes mesurs. Vous pouvez dcider que le flux doit tre compris entre un nombre minimum et maximum de lignes, et si le flux est infrieur au seuil minimum, il y a un goulot dtranglement.
Thresholds
Ce composant ne peut tre utilis comme composant de dbut puisquil ncessite un flux dentre pour fonctionner. n/a
Si vous avez besoin dutiliser les donnes de log, les statistiques et tout autre mesure des flux de donnes, consultez Automatiser lutilisation de statistiques & logs du Guide utilisateur de Talend Open Studio.
Scnario associ
Pour plus dinformations sur lutilisation du tFlowMeter, consultez le Scnario : Mesurer le flux dun Job, page 1087
1085

tFlowMeterCatcher
tFlowMeterCatcher
Proprits du tFlowMeterCatcher
Fonction
Le composant tFlowMeterCatcher est bas sur le schma dfini. Il rcupre les donnes du composant tFlowMeter et les transmet au composant de sortie. Ce composant fonctionne comme une fonction de log dclenche par lutilisation du composant tFlowMeter dans le Job. Schema type Un schma est une description de lignes, i.e., il dfinit les champs traiter et passer au composant suivant. Pour ce composant, le schma est en lecture seule puisquil regroupe les informations de log standard, notamment : Moment : Date et heure du traitement Pid : Identifiant systme du Job. Father_pid : Identifiant systme du Job parent, le cas chant. Sinon, le Pid est dupliqu. Root_pid : Identifiant systme du Job racine, le cas chant. Sinon, le Pid est dupliqu. System_pid : Identifiant systme gnr par le systme. Project : Nom du projet auquel appartient le Job. Job : Nom du Job en cours. Job_repository_id : Identifiant gnr par lapplication. Job_version : Numro de version du Job en cours. Context : Nom du contexte en cours. Origin : Nom du composant, le cas chant. Label : Libell de la connexion main Row prcdent le composant tFlowMeter dans le Job et dont la volumtrie sera analyse. Count : Nombre de lignes en cours de traitement. Reference : Nom de la ligne de rfrence telle quelle a t dfinie dans le composant tFlowMeter lorsque le mode Relative a t slectionn. Thresholds : cette fonction ne sutilise que si le mode Relative a t slectionn dans le composant tFlowMeter.
Utilisation
Ce composant est le composant de dbut du Job secondaire qui se dclenche automatiquement la fin du Job principal.
1086

tFlowMeterCatcher
Limitation
Lutilisation de ce composant est lie lutilisation du composant tFlowMeter. Pour plus dinformations, consultez tFlowMeter page 1085.
Scnario : Mesurer le flux dun Job

Le Job suivant permet de recueillir le nombre de lignes traites. Les mesures sont prises deux fois, une fois aprs le composant dentre, cest--dire avant quelles soient filtres, et aprs leur filtrage, avant le composant de sortie.
Cliquez et dposez les composants suivants : tMysqlInput, tFlowMeter (x2), tMap, tLogRow, tFlowMeterCatcher et tFileOutputCSV. Connectez les composants du Job principal laide de liens de type Row main et cliquez sur le libell pour lui donner un nom plus parlant, par exemple US_States aprs le composant dentre et filtered_states aprs le tMap. Reliez aussi les composants tFlowMeterCatcher et tFileOutputCSV laide dune connexion de type Row main puisque les donnes sont transmises au composant de sortie. Dans la vue Component du composant tMysqlInput, slectionnez loption Repository dans le champ Property Type, si les proprits de connexion la base de donnes sont stockes dans une mtadonne du Repository. Sinon, slectionnez loption Built-in et paramtrez les proprits et le schma manuellement.
Le Schma est compos de deux composants : idState et LabelState. Dans le champ Query type, slectionnez loption pour cet exemple.
1087

tFlowMeterCatcher
Les 50 Etats des Etats Unis sont enregistrs dans la table us_states. Pour que les 50 entres soient slectionnes, la requte effectuer dans la base de donnes Mysql est la suivante : select * from us_states. Dans le champ Encoding type, slectionnez lencodage adquat. Puis slectionnez le composant suivant, le tFlowMeter, et paramtrez ses proprits.
Cochez la case Use input connection name as label pour rutiliser le nom de la connexion dentre dans le fichier log de sortie (tFileOutputCSV). Dans le champ Mode, slectionnez loption Absolute puisquil ny a pas de flux de rfrence, et aucun seuil ne doit tre dfini dans le champ Threshold pour cet exemple.
Les informations du champ Thresholds sont utilises dans un outil de monitoring tel que lActivity Monitoring Console de Talend afin dobtenir une reprsentation proportionnelle du flux trait. Pour plus dinformations, consultez le Guide utilisateur de lActivity Monitoring Console.
Puis lancez lditeur du tMap pour paramtrer les proprits de filtrage. Pour cet exemple, glissez et dposez les colonnes ID et States de la zone Input ( gauche) du tMap vers la zone Output ( droite). Aucune variable nest utilise pour cet exemple.
Dans la table du flux de sortie (ici, la table filtered_states), cliquez sur la flche dote dun (+) pour ajouter un ligne de filtre. Glissez la colonne LabelState de la zone Input (row2) vers le champ filtre et saisissez un filtre permettant de nobtenir que les Etats commenant par la lettre M. Lexpression finale ressemble : row2.LabelState.startsWith("M")
1088

tFlowMeterCatcher
Cliquez sur OK pour valider les paramtres. Puis slectionnez le deuxime composant tFlowMeter et paramtrez ses proprits.
Cochez la case Use input connection name as label. Dans le champ Mode, slectionnez loption Relative et dans la liste droulante Reference connection, slectionnez US_States comme rfrence. Une fois de plus, aucun seuil nest utilis pour cet exemple, ainsi laissez le champ Threshold vide. Aucun paramtre particulier nest requis pour le composant tLogRow. Il en va de mme pour le composant tFlowMeterCatcher puisque ses proprits sont limites au schma prdfini contenant les informations de log. Paramtrez les proprits du composant de sortie (tFileOutputCSV).
Cochez la case Append pour logger toutes les mesures du tFlowMeter. Enregistrez le Job et excutez-le.
1089

tFlowMeterCatcher
La vue Run affiche le nom des Etats filtrs tel quil a t dfini dans le Job.
Dans le fichier csv dlimit, le nombre de lignes de la colonne count varie entre le composant tFlowMeter1 et le tFlowMeter2 puisque les donnes ont t filtres. La colonne reference affiche cette diffrence.
1090

tLogCatcher
tLogCatcher
Proprits du tLogCatcher
Fonction
Le composant tLogCatcher rcupre les champs et les messages des fonctions Java Exception/PerlDie et des composants tDie et/ou tWarn et les transmet au composant suivant. Ce composant fonctionne comme une fonction de log dclenche par une des trois fonctions suivantes : Java exception/PerlDie, tDie ou tWarn, pour collecter et transfrer des donnes de log. Schema type 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. Catch PerlDie Cochez cette case pour dclencher la fonction tCatch Catch Java Exception lorsque les fonctions PerlDie/Java Exception sont appeles dans le Job. Catch tDie Catch tWarn Cochez cette case pour dclencher la fonction tCatch lorsque le composant tDie est appel dans le Job. Cochez cette case pour dclencher la fonction tCatch lorsque le composant tWarn est appel dans le Job.
Objectif
Basic settings
Ce composant est le composant de dbut dun Job secondaire qui se dclenche automatiquement la fin du Job principal. n/a
Scnario 1 : Avertissement & log lors de la cration dentres

Dans ce scnario constitu de trois composants, un composant tRowGenerator cre des donnes alatoires (des id incrmenter). Le flux dentre atteint le composant tWarn qui dclenche le sous-Job commenant par le tLogCatcher. Ce sous-Job rcupre le message davertissement ainsi que les informations standard et les transmet au tLogRow afin dafficher les donnes de log.
1091

tLogCatcher
Cliquez et dposez les composants tRowGenerator, tWarn, tLogCatcher et tLogRow dans lespace de modlisation. Connectez les composants tRowGenerator et tWarn. Connectez les composants tLogCatcher et tLogRow sparement. Dans lditeur du tRowGenerator, paramtrez la cration des donnes alatoires laide de fonction de base :
Dans la vue Component du composant tWarn, paramtrez le message davertissement dans le champ Warn message, le code et le niveau de priorit dans le champ Priority. Pour cet exemple, le message est this is a warning. Pour ce scnario, concatnez le message ci-dessus avec une fonction pour collecter la premire valeur de la table Input.
Dans la vue Component du composant tLogCatcher, cochez la case tWarn pour que le message dfini dans le tWarn soit rcupr par le sous-Job. Cliquez sur Edit Schema pour vrifier le schma utilis pour la sortie de log. Notez que le log est complet.
1092

tLogCatcher
Appuyez sur F6 pour excuter le Job. Notez que le Log produit est exhaustif.
Scnario 2 : Monitorer & arrter un Job

Ce scnario utilise les composants tLogCatcher et tDie. Un composant tRowGenerator est connect un composant tFileOutputDelimited laide dun lien Row. Lorsquune erreur survient, le composant tDie dclenche le sous-Job contenant le tLogCatcher qui affiche les donnes de log dans la console Run.
Cliquez et dposez les composants ncessaires de la Palette : tRowGenerator, tFileOutputDelimited, tDie, tLogCatcher, tLogRow. Dans la vue Component du composant tRowGenerator, paramtrez les proprits des donnes dentre qui seront traites.
Editez le schma et paramtrez les colonnes suivantes : id, name, quantity, flag et creation. Dans le champ Number of rows, saisissez 0. Cela consituera lerreur sur laquelle sera base opration Die. Dans la colonne Values, dfinissez les fonctions permettant dalimenter le flux dentre.

tLogCatcher
Paramtrez les proprits du tFileOutputDelimited afin quil contienne les donnes transmises. La connexion Row provenant du tRowGenerator alimente automatiquement le schma du tFileOutputDelimited. Dans le champ Row separator, saisissez un point-virgule comme sparateur de champ. Connectez le composant de sortie au tDie laide dun lien Trigger > If. Double-cliquez sur cette nouvelle connexion et paramtrez le if : ((Integer)globalMap.get("tRowGenerator_1_NB_LINE")) <=0 Puis double-cliquez pour slectionner et paramtrer les proprits du composant tDie dans longlet Basic settings.
Dans le champ Die message, saisissez le message transmettre au tLogCatcher avant que le Job ne soit arrt par la fonction Kill. Dans le mme Job, cliquez et dposez un tLogCatcher, sans pour autant le connecter aux composants prcdents, et connectez-le un composant tLogRow. Dans longlet Basic settings du composant tLogCatcher, paramtrez ses proprits. Assurez-vous que la case tDie est bien coche pour pouvoir ajouter un message Die aux informations de Log transmises au composant final.
Appuyez sur F6 pour excuter le Job et notez que le log contient un message en noir et un en rouge. Les donnes de log en noir proviennent du tDie et sont transmises par le tLogCatcher. Et le message Java Exception en rouge apparat puisque le Job sest arrt.
1094

tLogRow
tLogRow
Proprits du tLogRow
Le composant tLogRow affiche les donnes ou les rsultats dans la console Run. Ce composant permet de monitorer les donnes traites. Print values in table cells Separator Le flux de sortie apparat dans un tableau. Saisissez le sparateur qui dlimitera les donnes dans la console.
Print component Cochez cette case si plusieurs composants unique name in front LogRow sont utiliss. Cela permet de diffrencier of each output row les sorties. Print schema column name in front of each value Use fixed length for values Utilisation Limitation Cochez cette case pour rcuprer les libells des colonnes du schma de sortie. Cochez cette case pour paramtrer une largeur fixe aux valeurs affiches.
Ce composant peut tre utilis en composant intermdiaire dans un flux de donnes ou en composant de fin dans un Job design. n/a
Scnarios associs
Pour plus dinformations sur lutilisation du tLogRow, consultez les composants : tFileInputDelimited, Scnario 1 : Afficher le contenu dun fichier dlimit, page 888. tContextLoad, Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1122. tWarn, tDie et tLogCatcher, Scnario 1 : Avertissement & log lors de la cration dentres, page 1091 et Scnario 2 : Monitorer & arrter un Job, page 1093.
1095

tStatCatcher
tStatCatcher
Proprits du tStatCatcher
Fonction
Le composant tStatCatcher est bas sur le schma dfini et regroupe les mtadonnes du Job en cours dexcution, ainsi que les mtadonnes de chaque composant de ce Job. Ce composant fonctionne comme une fonction de log dclenche pour chaque composant dont la case StatsCatcher Statistics est coche. Il collecte et transfert ces donnes de log la sortie dfinie. Schema type Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Pour ce composant, le schma est en lecture seule, puisquil regroupe les informations de log standard, notamment : Moment : Date et heure du traitement Pid : Identifiant systme du Job. Father_pid : Identifiant systme du Job parent, le cas chant. Sinon, le Pid est dupliqu. Root_pid : Identifiant systme du Job racine, le cas chant. Sinon, le Pid est dupliqu. Project : Nom du projet auquel appartient le Job. Job : Nom du Job en cours. Context : Nom du contexte en cours. Origin : Nom du composant, le cas chant. Message : Informations de dbut et de fin du Job.
Objectif
Basic settings
Utilisation
Ce composant est le composant de dbut dun Job secondaire qui se dclenche automatiquement la fin du Job principal. Les dates de dbut et de fin apparaissent dans le log. n/a
Limitation
Scnario : Afficher les statistiques du Job

Ce scnario dcrit un Job quatre composants, permettant dafficher dans la console Run les statistiques recueillies lors de la gnration du fichier grce au composant tStatCatcher.
1096

tStatCatcher
Cliquez et dposez les composants : tRowGenerator, tFileOutputDelimited, tStatCatcher et tLogRow Dans longlet Basic settings du composant tRowGenerator, paramtrez les donnes gnrer. Pour ce Job, le schma est compos de trois colonnes : ID_Owners, Name_Customer et ID_Insurance, gnres laide dun script Perl.
Le nombre de lignes peut tre limit 100. Cliquez sur longlet Main de la vue Component.
Et cochez la case tStatCatcher Statistics pour activer la fonction de rcupration des statistiques. Puis, paramtrez les proprits du composant de sortie. Dans la vue Component du tFileOutputDelimited, slectionnez le fichier de sortie ou saisissez le nom du fichier de sortie crer. Paramtrez les sparateurs de champs (point-virgule) et lencodage. Cliquez sur Edit schema et assurez-vous que le schma est rcupr du schma dentre. Si ncessaire, cliquez sur Sync Columns pour rcuprer le schma du composant prcdent.
1097

tStatCatcher
Puis cliquez sur longlet Advanced settings de la vue Component, et cochez la case tStatCatcher Statistics pour activer la fonction de rcupration des statistiques. Dans le deuxime Job, double-cliquez sur le composant tStatCatcher. Notez que les proprits sont fournis uniquement pour information puisque le schma reprsentant les donnes regrouper et agrger en statistiques, est en lecture seule.
Paramtrez ensuite les proprits du tLogRow. Dfinissez le sparateur de donnes qui apparatra dans la console. Enfin, appuyez sur F6 pour excuter le Job et afficher les rsultats du Job.
Les donnes de log affiche les informations de dbut et de fin du Job en lui-mme, ainsi que pour chaque composant.
1098

tWarn
tWarn
Proprits du tWarn
Le composant tWarn envoie un message davertissement au composant suivant. Ce composant dclenche un avertissement souvent pris comme donnes de log exhaustives par le composant tLogCatcher. Warn message Code Priority Saisissez votre message davertissement. Saisissez le niveau de code. Slectionnez le niveau de priorit.
Utilisation
Ce composant ne peut tre utilis comme composant de dbut. Ainsi, sil est connect un composant de sortie, il doit aussi tre connect un composant dentre. n/a
Limitation
Scnarios associs
Pour des exemples dutilisation du tWarn, consultez les scnarios du composant tLogCatcher : Scnario 1 : Avertissement & log lors de la cration dentres, page 1091 Scnario 2 : Monitorer & arrter un Job, page 1093
1099

tWarn
1100
Composants Misc
Ce chapitre passe en revue les principaux composants prsents dans la famille Misc de la Palette de Talend Open Studio. La famille Misc regroupe divers connecteurs permettant de rpondre des besoins, tels que la cration de lignes de donnes factices, la mise en tampon de donnes, le chargement de variables de contexte.
Composants Misc
tAddLocationFromIP
tAddLocationFromIP
Proprits du tAddLocationFromIP
Famille du composant Misc
Fonction Objectif
Le composant tAddLocationFromIP remplace des adresses IP par le lieu gographique correspondant. Le tAddLocationFromIP vous permet de localiser gographiquement les visiteurs grce leurs adresses IP : il identifie le lieu gographique des visiteurs (pays, rgion, ville, latitude, longitude, code postal, etc.) en utilisant un fichier de consultation dadresse IP. Schema type et Un schma est une description de lignes, i.e., il Edit Schema dfinit 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 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 rutilisable dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Database Filepath Input parameters Chemin daccs au fichier de consultation dadresses IP. Input column : Slectionnez la colonne dentre partir de laquelle les valeurs sont collectes pour lagrgation. input value is a hostname : Cochez cette case si la colonne dentre comporte des noms dhtes. input value is an IP address : Cochez cette case si la colonne dentre comporte des adresses IP. Location type Country code : Cochez cette case pour remplacer ladresse IP par le code du pays correspondant. Country name : Cochez cette case pour remplacer ladresse IP par le nom du pays correspondant.
Basic settings
Utilisation
Ce composant peut tre utilis comme tape intermdiaire du traitement permettant de remplacer des adresses IP par des informations golocalises. Il ne peut tre utilis comme composant de dbut car il ncessite un flux en entre, ainsi quun composant de sortie. n/a
Limitation
1102
Composants Misc
tAddLocationFromIP
Scnario : Identifier la localisation gographique dune adresse IP

Le scnario Java suivant cre un Job trois composants associant une adresse IP un lieu gographique. Il permet dobtenir la localisation gographique du visiteur dun site partir de son adresse IP. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tFixedFlowInput, le tAddLocationFromIP, et le tLogRow. Connectez les trois composants en utilisant des liens de type Row Main.
Dans lespace graphique, slectionnez le tFixedFlowInput. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFixedFlowInput. Configurez le champ Schema Type en mode Built-In puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes que vous voulez utiliser en entre. Dans ce scnario, le schma est constitu dune colonne comportant une adresse IP.
Cliquez sur le bouton OK pour fermer la bote de dialogue, puis acceptez la propagation des modifications lorsque le systme vous invite le faire. La colonne dfinie saffiche dans la section Values de la vue Basic settings. Cliquez dans la cellule Value puis dfinissez la valeur de ladresse IP.
1103
Composants Misc
tAddLocationFromIP
Dans le champ Number of rows, entrez le nombre de lignes gnrer. Dans lespace graphique, slectionnez le composant tAddLocationFromIP. Cliquez dans la vue Component pour dfinir la configuration de base (Basic settings) du tAddLocationFromIP.
Cliquez sur le bouton Sync columns pour synchroniser le schma avec le schma dentre du tFixedFlowInput. Parcourez vos dossiers jusquau fichier GeoIP.dat pour en dfinir le chemin daccs dans le champ Database filepath.
Assurez-vous de tlcharger la dernire version du fichier de consultation des adresses IP, partir du site indiqu dans la vue Basic settings du composant tAddLocationFromIp.
Dans la zone Input parameters, dfinissez les paramtres dentre selon vos besoins. Dans ce scnario, la colonne dentre correspond la colonne ip, qui comporte une adresse IP, dfinie prcdemment. Dans la zone Location type, dfinissez le type de lieu selon vos besoins. Dans ce scnario, on veut afficher le nom du pays. Dans lditeur graphique, slectionnez le composant tLogRow. Cliquez sur la vue Component puis dfinissez la configuration de base (Basic settings) du tLogRow selon vos besoins. Dans ce scnario, on veut afficher les valeurs dans les cellules dune table. Enregistrez votre Job puis cliquez sur F6 pour lexcuter.
1104
Composants Misc
tAddLocationFromIP
La ligne unique gnre par le Job affiche le nom du pays correspondant ladresse IP renseigne.
1105
Composants Misc
tBufferInput
tBufferInput
Proprits du tBufferInput
Famille de composant Misc
Fonction Objectif
Ce composant permet de rcuprer les donnes mises en tampon pour pouvoir les rutiliser dans un deuxime sous-job. Lee composant tBufferInput rcupre les donnes mises en mmoire tampon, via un composant tBufferOutput par exemple, pour les traiter dans un deuxime temps. Schema type 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. Lors de lutilisation du tBufferInput, cest lordre des colonnes qui est pris en compte, ainsi lordre des colonnes est plus important que leur libell. 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 rutilisable dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Basic settings
Utilisation
Ce composant est le composant de dbut dun Job secondaire qui se dclenche automatiquement la fin du Job principal.
Scnario : Rcuprer les donnes mises en tampon (Java)

Ce scnario dcrit un Job qui rcupre les donnes mises en mmoire tampon lors de lexcution dun premier sous-job et les affiche dans la console standard.
1106
Composants Misc
tBufferInput
Cliquez et dposez les composants suivants : tFileInputDelimited et tBufferOutput. Slectionnez le composant tFileInputDelimited et dans longlet Basic Settings de la vue Component, paramtrez les proprits daccs au fichier dentre.
Dans le champ File Name, paramtrez le chemin daccs au fichier dlimit contenant les donnes mettre en tampon. Dans les champs Row et Field separators, renseignez respectivement les sparateurs de lignes et de champs. Dans le champ Header, renseignez les informations sur un ventuel en-tte. Cliquez sur le bouton [...] cot du champ Schema type pour dcrire la structure du fichier
Dcrivez le Schma des donnes passer au composant tBufferOutput. Slectionnez le composant tBufferOutput et paramtrez ses proprits dans longlet Basic Settings de la vue Component.
1107
Composants Misc
tBufferInput
Gnralement le schma du composant dentre alimente automatiquement le schma du composant tBufferOutput. Mais vous pouvez aussi configurer une partie du schma mettre en tampon si vous le souhaitez. Dposez les composants tBufferInput et tLogRow en dessous du sous-job que vous venez de crer. Reliez le composant tFileInputDelimited au tBufferInput via un lien de type Trigger > OnSubjobOk et reliez le composant tBufferInput au tLogRow via un lien de type Row > Main. Double-cliquez sur le composant tBufferInput pour paramtrer ses proprits dans la vue Component. Dans longlet Basic settings, cliquez sur le bouton [...] cot du champ Schema pour dcrire la structure du fichier.
Utilisez la mme description de fichier que celle dfinie pour le composant tFileInputDelimited et cliquez sur OK. Le schma du composant tBufferInput alimente automatiquement le schma du composant tLogRow. Sinon double-cliquez sur le tLogRow pour afficher ses proprits dans la vue Component et cliquez sur le bouton Sync columns. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
La console affiche les donnes qui ont t rcuprs de la mmoire tampon.
1108
Composants Misc
tBufferOutput
tBufferOutput
Proprits du tBufferOutput
Fonction Objectif
Ce composant met en tampon des donnes afin de pouvoir y accder plus tard via un service Web par exemple. Ce composant permet daccder aux donnes via un service Web. En effet, il a t conu pour tre export en tant que service Web afin daccder aux donnes directement partir du serveur dapplication Web. Pour plus dinformations, consultez Exporter un Job en tant que WebService du Guide utilisateur de Talend Open Studio. Schema type 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. Lors de lutilisation du tBufferOutput, cest lordre des colonnes qui est pris en compte, ainsi lordre des colonnes est plus important que leur libell. 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 rutilisable dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Basic settings
Utilisation
Ce composant nest pas un composant de dbut (font vert) et il requiert un composant de sortie.
Scnario 1 : Mettre des donnes en tampon (Java)

Ce scnario dcrit un Job volontairement basique qui met en tampon les donnes dun Job enfant pendant quun Job parent affiche les donnes mise en tampon dans la console standard. Gnralement, un Job utilisant un composant tBufferOutput incluerait une tape dexport en tant que service Web, afin que les donnes soient accessibles directement via le serveur dapplication Web.
1109
Composants Misc
tBufferOutput
Crez deux Jobs : le premier Job (BufferFatherJob) excute le deuxime et affiche le contenu dans la console Run. Le deuxime Job (BufferChildJob) stocke les donnes dfinies dans une mmoire tampon. Dans le premier Job, cliquez et dposez les composants suivants : tRunJob et tLogRow. Dans le deuxime Job, cliquez et dposez les composants suivants : tFileInputDelimited et tBufferOutput. Commencez par paramtrer les proprits du deuxime Job. Slectionnez le composant tFileInputDelimited et dans longlet Basic Settings de la vue Component, paramtrez les proprits daccs au fichier dentre.
Dans le champ File Name, paramtrez le chemin daccs au fichier dlimit contenant les donnes mettre en tampon. Dans les champs Row et Field separators, renseignez respectivement les sparateurs de lignes et de champs. Dans le champ Header, renseignez les informations sur un ventuel en-tte.
1110
Composants Misc
tBufferOutput
Dcrivez le Schma des donnes passer au composant tBufferOutput. Slectionnez le composant tBufferOutput et paramtrez ses proprits dans longlet Basic Settings de la vue Component.
Gnralement le schma du composant dentre alimente automatiquement le schma du composant tBufferOutput. Mais vous pouvez aussi configurer une partie du schma mettre en tampon si vous le souhaitez. Maintenant le premier Job (BufferFatherJob), paramtrez les proprits du composant tRunJob.
Cliquez sur Edit schema pour modifier le schma si ncessaire et slectionner la colonne afficher. Le schma peut tre identique ou diffrent du schma mis en tampon. Dans le tableau Context Param, vous pouvez aussi dfinir les paramtres de contexte utiliser pour lexcution de ce Job. Pour cet exemple, gardez le contexte par dfaut. Appuyez sur F6 pour excuter les Jobs parent. Le composant tRunJob se charge dexcuter le Job enfant et affiche les donnes dans la console standard :
1111
Composants Misc
tBufferOutput
Scnario 2 : Mettre les donnes de sortie en mmoire tampon du serveur dapplication Web
Ce scnario dcrit un Job appelant un service Web et stockant les donnes de sortie directement sur la mmoire tampon du serveur dapplication Web. Ce scnario cre dabord un Job utilisant des variables de contexte qui pourra ensuite tre utilis en tant que service Web, puis exporte de Job en tant que service Web. Crer un Job utilisant des variables de contexte et pouvant tre export en tant que service Web : Cliquez-dposez les composants suivants dans le Job Designer : tFixedFlowInput et tBufferOutput. Reliez-les via une connexion de type Row Main.
Dans lespace de travail, slectionnez le tFixedFlowInput. Cliquez sur la vue Component pour paramtrer ses proprits de base dans longlet Basic settings. Dans la liste Schema Type, slectionnez Built-In et cliquez sur le bouton [...] cot du champ Edit Schema pour dcrire la structure des donnes que vous souhaitez partir des variables internes. Dans ce scnario, le schma est constitu de trois colonnes : now, firstname, et lastname.
1112
Composants Misc
tBufferOutput
Cliquez trois fois sur le bouton (+) pour ajouter trois lignes de paramtre et configurez vos variables. Cliquez sur OK pour fermer la bote de dialogue et acceptez la propagation des modifications lorsque vous y tes invit. Les trois colonnes dfinies apparaissent dans le champ Values de longlet Basic settings du tFixedFlowInput.
Cliquez dans le cellule Value de chaque ligne des deux premier paramtres dfinis et appuyez sur Ctrl+Space pour accder la liste des variables globales. A partir de la liste des variables globales, slectionnez TalendDate.getCurrentDate() pour la colonne now et talendDatagenerator.getFirstName pour la colonne firstname. Pour ce scnario, nous souhaitons dfinir deux variables de contexte : nb_lines et lastname. Dans la premire, nous paramtrons le nombre de lignes gnrer, et dans le deuxime, nous paramtrons les noms qui apparaitront dans la liste de sortie. Le composant tFixedFlowInput gnrera le nombre de lignes et les trois colonnes : now, firstname, et lastname dfinies dans les variables de contexte. Pour plus dinformations concernant lutilisation des variables de contexte : consultez Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Pour dfinir les deux variables de contexte : Slectionnez le composant tFixedFlowInput et cliquez sur la vue Contexts. Dans la vue Variables, cliquez sur le bouton (+) pour ajouter deux lignes de paramtres et configurez-les.
1113
Composants Misc
tBufferOutput
Cliquez sur longlet Values as table et configurez le premier paramtre dfinissant le nombre de lignes gnrer et le second paramtre dfinissant les noms afficher.
Cliquez sur la vue Component pour afficher longlet Basic settings du composant tFixedFlowInput. Cliquez dans la cellule Value de la colonne lastname et appuyez sur Ctrl+Space pour accder la liste des variables globales. A partir de la liste des variables globales, slectionnez context.lastname, la variable de contexte que vous avez cr pour la colonne lastname.
1114
Composants Misc
tBufferOutput
Exporter un Job en tant que service Web : Avant dexporter votre Job en tant que service Web, consultez la section Export de Job scripts du Guide utilisateur de Talend Open Studio. Dans la vue Repository, cliquez-droit sur le Job que vous venez de crer et slectionnez Export Job Scripts dans le menu. La bote de dialogue [Export Job Scripts] souvre.
Cliquez sur le bouton Browse... et slectionnez le rpertoire dans lequel enregistrer votre Job. Dans la zone Export type, slectionnez le type dexport que vous souhaitez utiliser dans votre application Web Tomcat (WAR pour cet exemple) et cliquez sur Finish. La bote de dialogue [Export Job Scripts] se referme. Copiez le fichier War et collez-le dans le rpertoire de votre Tomcat.
1115
Composants Misc
tBufferOutput
Scnario 3 : Appeler un Job contenant des variables de contexte partir de votre navigateur Web
Ce scnario dcrit la procdure utiliser pour appeler le Job cr dans le scnario 2 partir de votre navigateur Web en modifiant/sans modifier les valeurs des variables de contexte. Saisissez lURL suivante dans votre navigateur Web : http://localhost:8080//export_job/services/export_job3?method=runJob dans laquelle export_job correspond au nom du rpertoire de votre application Web dploy sur le Tomcat et export_job3 correspond au nom de votre Job.
Cliquez sur Enter pour excuter votre Job partir du navigateur.
Le Job utilise les valeurs par dfaut des variables de contexte : nb_lines et lastname, et donc gnre trois lignes contenant la date en cours, un prnom et le nom Ford. Vous pouvez modifier les valeurs des variables de contexte directement partir de votre navigateur. Pour appeler le Job partir de votre navigateur et modifier les valeurs des deux variables de contexte, saisissez lURL suivante : http://localhost:8080//export_job/services/export_job3?method=runJob&arg1=--context_param %20lastname=MASSY&arg2=--context_param%20nb_lines=2.
1116
Composants Misc
tBufferOutput
%20 correspond un espace blanc lorsquil est utilis dans une URL. Dans le premier argument arg1, dfinissez la valeur MASSY pour la variable de contexte lastname. Ainsi le nom qui apparatra sera MASSY. Dans le deuxime argument arg2, dfinissez la valeur 2 pour la variable de contexte nb_lines pour ne gnrer que deux lignes de donnes. Cliquez sur Enter pour excuter le Job partir du navigateur.
Le Job gnre deux lignes avec MASSY comme nom.
Scnario 4 : Appeler un Job export en tant que service Web dans un autre Job
Ce scnario dcrit un Job appelant un autre Job export en tant que service Web en utilisant un composant tWebServiceInput. Ce scnario appelera le Job cr dans le scnario 2. Cliquez-dposez les composants suivants dans le Job Designer : tWebServiceInput et tLogRow. Reliez-les via une connexion de type Row Main.
Dans lespace de travail, slectionnez le composant tWebServiceInput. Cliquez sur la vue Component pour dfinir ses proprits de base dans longlet Basic settings.
1117
Composants Misc
tBufferOutput
Dans la liste Schema Type, slectionnez Built-In et cliquez sur le bouton [...] cot du champ Edit Schema pour dcrire la structure des donnes que vous souhaitez appeler du Job export. Dans ce scnario, le schma est constitu de trois colonnes, now, firstname, et lastname.
Cliquez sur le bouton (+) pour ajouter les trois lignes de paramtres et dfinir vos variables. Cliquez sur OK pour fermer la bote de dialogue. Dans le champ WSDL de longlet Basic settings de la vue Component du tWebServiceInput, saisissez lURL : http://localhost:8080/export_job/services/export_job3?WSDL dans laquelle export_job correspond au nom du rpertoire de votre application Web dans lequel le Job appeler est stock et export_job3 correspond au nom du Job.
1118
Composants Misc
tBufferOutput
Dans le champ Method name, saisissez runJob. Dans la zone Parameters, cliquez sur le bouton (+) pour ajouter deux lignes de paramtres et dfinir vos variables de contexte. Cliquez dans la premire cellule Value pour configurer le paramtre dfinissant le nombre de lignes gnrer : --context_param nb_line=3. Cliquez dans la deuxime cellule Value pour configurer le maramtre dfinissant le nom afficher : --context_param lastname=Ford. Slectionnez le tLogRow et cliquez sur la vue Component pour afficher les proprits du composant. Dans la vue Basic settings du tLogRow, slectionnez loption Table pour afficher les donnes de sortie sous forme de tableau. Pour plus dinformations, consultez les Proprits du tLogRow, page 1095. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Le Job gnre trois colonnes contenant la date en cours, des prnoms et des noms, et les affiche dans la console sous forme de tableau.
1119
Composants Misc
tContextDump
tContextDump
Proprits du tContextDump
Fonction Objectif
tContextDump fait une copie des valeurs du contexte utilis dans le Job. Le tContextDump peut tre utilis pour transformer les paramtres de contexte dun flux et les rutilisez via un composant tContextLoad. Cette fonction est trs pratique pour rutiliser un contexte que vous naurez dfini quune seule fois, dans plusieurs Jobs via le tContextLoad.. Schema type et Edit Schema Le schma du composant tContextDump est en lecture seule et est compos de deux colonnes : Key et Value, qui correspondent au nom et la valeur du paramtre copier. Un schma est une description de lignes, i.e., il dfinit les 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 lorsque vous modifiez le schma, les proprits deviennent automatiquement 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. Print operations Cochez cette case pour afficher les paramtres de contexte dans la vue Run.
Basic settings
Ce composant cre un flux de donnes partir des valeurs de contexte, ainsi il doit tre connect un composant de sortie. Le tContextDump ne cre pas de variable de contexte non dfinie.
Scnario associ
1120
Composants Misc
tContextLoad
tContextLoad
Proprits du tContextLoad
Fonction Objectif
Le composant tContextLoad modifie dynamiquement les valeurs du contexte actif. Le tContextLoad permet de charger un contexte partir dun flux entrant. Ce composant effectue aussi deux contrles. Il prvient lorsque les paramtres dfinis dans le flux entrant ne sont pas dfinis dans le contexte. Il avertit galement lorsque la valeur dun contexte nest pas initialise dans le flux entrant. Mais notez que ces avertissements ne bloquent pas le traitement. Schema type et Edit Schema Le schma du composant tContextLoad doit tre compos de deux colonnes, lune contenant le nom du paramtre et la deuxime contenant la valeur du paramtre charger. 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, les proprits deviennent automatiquement built-in. Built-in : Le shma 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 dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. If a variable loaded, Si une variable est charge mais napparat pas but not in the context dans le contexte, choisissez comment doit safficher la notification. Sous forme derreur (Error), de warning (warning), ou dinformation (info). If a variable in the context, but not loaded Si une variable apparat dans le contexte mais nest pas charge, choisissez comment doit safficher la notification. Sous forme derreur (Error), de warning (warning), ou dinformation (info). Cochez cette case pour afficher les paramtres de contexte dans la vue Run. Cochez cette case pour ne pas afficher derreur.
Basic settings
Print operations Disable errors
1121
Composants Misc
tContextLoad
Disable warnings Disable infos Die on error
Cochez cette case pour ne pas afficher de warning. Cochez cette case pour ne pas afficher dinformation. 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 les lignes contenant les erreurs seront ignores. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant sappuie sur le flux de donnes pour charger les valeurs de contexte utiliser. Ainsi, il requiert un composant dentre et ne peut pas tre un composant de dbut. Le tContextLoad ne cre aucune variable qui na pas t dfinie dans le contexte par dfaut.
Limitation
Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL
Ce scnario est compos de deux sous-Jobs. Le premier permet de charger dynamiquement des paramtres de contexte et le deuxime utilise ces paramtres chargs pour afficher le contenu dune base de donnes.
Cliquez et dposez les composants : tFilelist, tFileInputDelimited, tContextLoad pour le premier sous-Job. Et cliquez et dposez les composants tMysqlInput et tLogRow pour le deuxime. Connectez-les comme indiqu sur le schma ci-dessus. Crez autant de fichiers dlimits quil y a de contextes diffrents et conservez-les dans un rpertoire spcifique appel Contexts. Dans ce scnario, test.txt contient les informations de connexion la base de donnes locale de test et prod.txt contient les informations de connexion de la base de donnes distante de production. Chaque fichier est constitu de deux champs contenant le nom du paramtre et sa valeur correspondante, en fonction du contexte.
1122
Composants Misc
tContextLoad
Dans longlet Basic settings du composant tFileList, slectionnez le rpertoire contexts dans lequel les deux fichiers test et prod seront stocks. Dans longlet Basic settings du composant tFileInputDelimited, dans le champ File Name, appuyez sur Ctrl+Espace pour accder la liste des variables globales. Slectionnez tFileList_1.CURRENT_FILEPATH qui permet de faire une boucle sur le rpertoire contenant les fichiers de contexte. Dfinissez le schma manuellement (Built-in) en cliquant sur le bouton Edit schema. Il contient deux colonnes : Key et Value, correspondant respectivement au paramtre et sa valeur. Acceptez la propagation du schma dfini au composant suivant (tContextLoad). Pour ce scnario, cochez la case Print operations pour afficher les paramtres de contexte utiliss dans la vue Run. Puis double-cliquez sur le composant tMySQLInput pour accder ses proprits dans longet Basic settings. Pour chacune des valeurs stockes dans le fichier de contexte, appuyez sur F5 et dfinissez le paramtre de contexte devant tre dfini par lutilisateur. Par exemple, le champ Host a pour valeur de paramtre context.host, dont le nom de paramtre est host dans le fichier de contexte. Sa valeur actuelle est talend-dbms.
1123
Composants Misc
tContextLoad
Puis dans le champ Schema Type, renseignez les informations sur le schma. Si le schma est stock dans le noeud Metadata du Repository sous forme de mtadonne, slectionnez-le aprs avoir slectionn loption Repository. Dans le champ Query, saisissez la requte SQL devant tre excute sur la table spcifie. Dans ce Job, effectuez un simple SELECT des colonnes de la table, qui seront ensuite affiches dans longlet Run grce au composant tLogRow. Enfin, appuyez sur F6 pour excuter le Job.
Les paramtres de contexte et les valeurs slectionns dans la table sont affichs dans la console Run.
1124
Composants Misc
tFixedFlowInput
tFixedFlowInput
Proprits du tFixedFlowInput
Famille du composant Misc
Le composant tFixedFlowInput gnre autant de lignes et de champs que vous souhaitez alimenter par des valeurs fixes. Le tFixedFlowInput permet de gnrer des donnes fixes partir de variables internes. Schema type 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. Mode Slectionnez le mode, parmi les trois proposs, que vous souhaitez utiliser. Use Single Table : Saisissez la donne que vous souhaitez gnrer dans la colonne Value correspondante. Use Inline Table : Ajoutez la ou les ligne(s) que vous souhaitez gnrer. Use Inline Content : Saisissez vos donnes gnrer, spares par les sparateurs pralablement dfinis dans les champs Row et Field Separator. Saisissez le nombre de lignes de donnes gnrer. Saisissez entre guillemets les valeurs correspondant aux colonnes dfinies dans la bote de dialogue du schma, via le bouton Edit schema.
Number of rows Values
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant peut tre utilis comme composant de dbut ou de milieu, il requiert donc un composant de sortie.
Scnarios associs
Pour des scnarios associs, consultez :
1125
Composants Misc
tFixedFlowInput
Scnario 2 : Mettre les donnes de sortie en mmoire tampon du serveur dapplication Web, page 1112. Scnario : Itrer une table de base de donnes et lister le nom des colonnes de la table, page 477.
1126
Composants Misc
tMsgBox
tMsgBox
Proprits du tMsgBox
Le composant tMsgBox ouvre une bote de dialogue contenant un bouton OK, ncessitant une action de la part de lutilisateur. Ce composant est une pause graphique dans le cours du traitement. Title Buttons Le texte saisi saffiche dans la barre de titre de la bote de dialogue. Liste des boutons que vous souhaitez inclure dans la bote de dialogue. Les combinaisons de bouton sont restreintes et ne peuvent tre changes. Icne de la barre de titre de la bote de dialogue. Texte libre afficher dans la bote de dialogue. Le texte peut tre dynamique (ex : reprendre un nom de fichier).
Icon Message
Utilisation
Ce composant peut tre utilis comme tape intermdiaire du traitement ou comme composant de dbut ou de fin de Job. Il peut tre connect laide dun lien Row ou Iterate. Si vous utilisez Perl, assurez-vous que le package adquat est install sur votre ordinateur.
Limitation
Scnario : Test de type Hello world!

Le scnario suivant reprsente un Job un seul composant utilis pour afficher lheure et la date la place du message Hello World!. Cliquez et dposez un composant tMsgBox dans lespace de modlisation. Paramtrez les proprits daffichage du message :
Title est le titre de la bote de message, vous pouvez utiliser nimporte quelle variable.
1127
Composants Misc
tMsgBox
Dans le champ Message, saisissez le texte "Current date is: " entre guillemets doubles concatn laide dun +, puis appuyez sur Ctrl+Espace afin dafficher la liste dauto-compltion, et slectionnez la routine systme TalendDate.getCurrentDate. Entourez-la de parenthses. Cliquez sur longlet Run puis excutez le Job. Le message affiche le texte dfini prcdemment et requiert une action de lutilisateur pour disparatre et passer au composant suivant ou terminer le Job.
Aprs avoir cliqu sur le bouton OK, le log de la vue Run est mis jour. Voir galement : Excution dun job du Guide utilisateur de Talend Open Studio.
1128
Composants Misc
tRowGenerator
tRowGenerator
Proprits du tRowGenerator
Fonction
Le composant tRowGenerator gnre autant de lignes et de champs que vous souhaitez alimenter par des valeurs prises de faon alatoire dans une liste dfinie. Ce composant peut tre utilis des fins de test, pour crer un flux dentre dans le cadre de jeux de tests. Schema type et Un schma est une description de lignes, i.e., il Edit Schema dfinit 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 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 rutilisable dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Objectif
Basic settings
RowGenerato r editor
Lditeur vous permet de dfinir prcisment les colonnes et la nature des donnes gnrer. Vous pouvez prdfinir des routines ou saisir vous-mme la fonction utiliser pour gnrer les donnes souhaites. Cochez cette case pour collecter les donnes de log au niveau du composant.
La simplicit dutilisation de lditeur du tRowGenerator vous permet de gnrer des donnes de faon alatoire sans connaissance des langages Perl et Java. n/a
Limitation
Lditeur du tRowGenerator souvre dans une fentre spare constitue de deux parties : dans la partie suprieure de la fentre, une vue de dfinition de Schema, dans la partie infrieure, une vue Function de dfinition et daperu des fonctions.
Dfinition du schma
Pour commencer, vous devez dfinir la structure des donnes gnrer. Ajoutez autant de colonnes que ncessaire laide du bouton plus [+]. Dans la zone Columns, saisissez les noms des colonnes crer et cochez la case Key si ncessaire.
Composants Misc
tRowGenerator
Assurez-vous davoir correctement dfini la nature des donnes contenues dans la colonne en slectionnant le type dans la colonne Type. En fonction du type slectionn, la liste des fonctions proposes dans la colonne Function diffre. Cette information est obligatoire.
Dautres informations, bien que facultatives, peuvent tre utiles, telles que les colonnes Length, Precision ou Comment. Mais vous avez la possibilit de cacher les colonnes que vous nutilisez pas, en cliquant sur le bouton Columns dans la barre doutils et en dcochant les colonnes que vous souhaitez cacher. Dans la zone Function, slectionnez la routine/fonction prdfinie si lune des propositions correspond vos besoins. Vous pouvez galement ajouter cette liste toute routine que vous avez dveloppe et stocke dans la partie Routine du Repository. Vous avez enfin la possiblit de saisir directement la fonction que vous souhaitez utiliser dans la vue Function. Voir galement : Dfinition dune fonction, page 1130. Cliquez sur Refresh pour visualiser un aperu des donnes gnres. Saisissez le nombre de lignes gnrer. Plus le nombre de lignes est lev, plus la dure dexcution sera longue pour cette opration de gnration.
La liste des fonctions propose diffre selon la langue de votre projet (Perl ou Java).
Dfinition dune fonction

Vous avez slectionn les trois points [...] dans la colonne Function de lditeur du Schma, car vous souhaitez personnaliser la fonction de gnration. Slectionnez longlet Function parameters. La zone Parameter affiche Customized parameter comme nom du paramtre (en lecture seule).
1130
Composants Misc
tRowGenerator
Dans la zone Value, saisissez la fonction Perl ou Java que vous souhaitez utiliser pour gnrer des donnes. Cliquez sur longlet Preview et cliquez sur le bouton Preview pour visualiser un chantillon des donnes qui seront gnres.
Scnario : Gnration alatoire de fichiers de test

Le scnario suivant dcrit un Job de deux composants, gnrant 50 lignes composes de la manire suivante : un ID alatoire compris entre 1 et 3, un nom et un prnom pris de manire alatoire dans une liste de chanes de caractres, et le champ Date dfinie dans une priode donne.
Cliquez et dposez un composant tRowGenerator et un composant tLogRow dans lespace de modlisation. Cliquez-droit sur le composant tRowGenerator et slectionnez le lien Row > Main. Faites glisser ce lien jusquau composant tLogRow. Double-cliquez sur le composant tRowGenerator pour ouvrir lditeur. Dfinissez les champs gnrer.
La colonne ID (random_ID) est de type entier (integer), les noms et prnoms sont de type chane de caractres (String) et la Date est de type Date. Dans la colonne Function, slectionnez la fonction adapte dans la liste ou les trois points [...] pour la fonction personnalise. Dans longlet Function parameters, dfinissez les valeurs prendre de faon alatoire.
Les colonnes First_Name et Last_Name sont gnrer laide dune fonction getAsciiRandomString prdfinie dans les routines systme. Par dfaut, la longueur dfinie est de 6 caractres, mais vous pouvez la changer.
1131
Composants Misc
tRowGenerator
La colonne Date appelle galement une fonction prdfinie getRandomDate. Vous pouvez diter les valeurs de paramtre dans longlet Function parameters. Dans le champ Number of Rows, paramtrez le nombre de lignes 50. Cliquez sur OK pour valider les paramtres. Double-cliquez sur le composant tLogRow pour visualiser les paramtres dans longlet Basic settings. Retenez les paramtres par dfaut. Appuyez sur F6 pour excuter le Job.
Les 50 lignes sont gnres selon les paramtres dfinis dans lditeur du composant tRowGenerator et sont affiches en sortie standard de la vue Run.
1132
Composants Orchestration
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille Orchestration de la Palette de Talend Open Studio. La famille Orchestration regroupe les composants vous permettant de squencer et dorchestrer les tches ou les traitements de vos Jobs et sous-Jobs.
tFileList
tFileList
Le tFileList appartient deux familles : File et Orchestration. Pour plus dinformations concernant le composant tFileList, consultez tFileList page 940..
1134
tFlowToIterate
tFlowToIterate
Proprits du tFlowToIterate
Famille du composant Orchestration
Le composant tFlowToIterate transforme un flux de donnes en une liste. Le tFlowToIterate permet de transformer un flux traitable en donnes non traitables. Use the default (key, value) in global variables Customize Lorsque cette case est coche, le systme utilise la valeur par dfaut de la variable gobale utilise dans le Job. key : Entrez le nom de la nouvelle variable globale. Appuyez sur Ctrl+Espace pour accder lensemble des variables disponibles, quelles soient globales ou dfinies par lutilisateur. value : Cliquez dans la cellule pour accder la liste des colonnes rattaches la variable globale dfinie.
Utilisation
Le tFlowToIterate nest pas un composant de dbut, et il requiert un composant de sortie.
Scnario : Transformer un flux de donnes en liste

Le scnario suivant dcrit un Job permettant de lire une liste de fichiers partir dun fichier dentre donn. Il effectue galement une itration sur chacun des fichiers, slectionne les donnes dentre et affiche le rsultat en sortie dans la console de log Run. A partir de la Palette, cliquez-dposez les composants suivants dans lespace de modlisation : deux tFileInputDelimited, un tFlowToIterate et un tLogRow. Cliquez-droit sur chacun des composants pour les relier entre eux. Connectez le premier tFileInputDelimited au tFlowToIterate laide dun lien de type Row Main, puis le tFlowToIterate au deuxime tFileInputDelimited laide dun lien de type Iterate, enfin le second tFileInputDelimited au tLogRow laide dun lien de type Row Main.
Dans lespace graphique, slectionnez le premier tFileInputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du composant tFileInputDelimited.
1135
tFlowToIterate
Dans la vue Basic settings, cliquez sur le bouton [...] situ ct du champ File Name pour dterminer le chemin daccs au fichier dentre.
Le champ File Name est obligatoire.
Le fichier dentre utilis dans ce scnario sappelle Customers. Il sagit dun fichier texte contenant trois autres fichiers texte simples : Name, E-mail et Address. Le fichier Name est constitu dune colonne contenant le nom des clients et le fichier E-mail dune colonne contenant ladresse email de ces clients. Le troisime fichier texte, Address, est compos dune colonne comprenant ladresse postale des clients. Renseignez les autres champs en fonction de votre fichier. Pour plus dinformations sur le tFileInputDelimited, consultez les Proprits du tFileInputDelimited, page 886. Dans ce scnario, len-tte, le pied de page et le nombre limite de lignes traiter ne sont pas dfinis. Donc, laissez les champs Header (en-tte) et Footer (pied de page) et Limit par dfaut. Cliquez sur le bouton Edit schema pour dcrire la structure des donnes du fichier dentre. Dans ce scnario, le schma comporte une seule colonne appele FileName.
Dans lespace graphique, slectionnez le tFlowToIterate. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du composant tFlowToIterate.
1136
tFlowToIterate
Cochez la case Use the default (key, value) in global variables si besoin. Cette option permet dutiliser la valeur par dfaut de la variable globale. Cliquez sur le bouton [+] pour ajouter une ligne de paramtres puis dfinissez vos variables. Cliquez dans la cellule de la colonne key pour modifier le nom de la variable selon vos dsirs.
Vous pouvez appuyer sur Ctrl+Espace partir de la cellule de la colonne key pour accder la liste des variables globales et des variables utilisateur.
Dans lespace graphique, slectionnez le second composant tFileInputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) de ce second tFileInputDelimited.
Dans le champ File Name, renseignez le nom du fichier en utilisant la variable approprie. Vous devez utiliser la syntaxe correspondant au langage employ (Perl ou Java). En Perl, la syntaxe exacte est .$_globals{tFlowToIterate}{Name_of_File}. En Java, la syntaxe correcte est +globalMap.get(file). Remplissez les autres champs selon vos besoins. Pour plus dinformations, consultez les Proprits du tFileInputDelimited, page 886. Dans lespace graphique, slectionnez le dernier composant, le tLogRow. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tLogRow.
1137
tFlowToIterate
Dfinissez les paramtres selon vos besoins. Pour plus dinformations, consultez Proprits du tLogRow, page 1095. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
La console affiche, pour chaque ligne, le nom du client, son e-mail et son adresse, prcds du nom de la colonne du schma.
1138
tInfiniteLoop
tInfiniteLoop
Proprits du tInfiniteLoop
Famille de composant Orchestration
Le composant tInfiniteLoop fait une boucle linfini sur lexcution dune tche. Le tInfiniteLoop permet dexcuter automatiquement une tche ou un Job dans une boucle, linfini. Wait at each iteration (in seconds) tStatCatcher Statistics Saisissez le temps, en secondes, dattente entre chaque itration. Cochez cette case pour collecter les donnes de log au niveau du composant.
Le composant tInifniteLoop est un composant de dbut et requiert une connexion de type Iterate au composant suivant. n/a
Scnario associ
Pour un exemple dutilisation proche, consultez le Scnario : Excuter un Job partir dune boucle, page 1143 du composant tLoop.
1139
tIterateToFlow
tIterateToFlow
Proprits du tIterateToFlow
Le composant tIterateToFlow transforme une liste en flux de donnes pouvant tre trait. Ce composant permet de transformer des donnes non traitables en flux traitable. Schema type 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. Lors de lutilisation du tIterateToFlow, le schma doit tre dfini. 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 rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Mapping Column :Saisissez le nom des colonnes crer. Value : Appuyez sur Ctrl+Espace pour accder toutes les variables disponibles soit globales soit celles que vous avez dfinies. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant nest pas un composant de dbut (fond vert) et requiert un composant de sortie.
Scnario : Transformer une liste de fichiers en flux de donnes

Le scnario suivant dcrit un Job permettant de faire une boucle sur une liste de fichiers, de rcuprer leur nom, ainsi que la date en cours, pour ensuite transformer ces donnes en un flux qui sera affich dans la console.
1140
tIterateToFlow
Cliquez et dposez les composants suivants : tFileList, tIterateToFlow et tLogRow. Connectez le tFileList au tIterateToFlow laide dun lien Iterate et connectez le Job au composant tLogRow laide dun lien Row main. Dans la vue Component du composant tFileList, donnez le chemin daccs au rpertoire contenant la liste de fichiers.
Dans cet exemple, les fichiers sont trois fichiers .txt simples stocks dans le rpertoire Countries. Dans la liste Case sensitive, slectionnez No (Non) pour ne pas tenir compte de la casse. Slectionnez le composant tIterateToFlow et cliquez sur Edit Schema pour modifier le nouveau schma.
Ajoutez deux nouvelles colonnes : Filename de type String et Date de type date. Assurez-vous davoir paramtr le bon modle en Java. Cliquez sur OK pour valider. Une bote de dialogue souvre et vous demande si vous souhaitez propager les changements. Cliquez sur Yes (Oui). Notez que ce nouveau schma apparat dans le tableau Mapping.
1141
tIterateToFlow
Dans chaque cellule de la colonne Value, appuyez sur Ctrl+Espace pour accder la liste des variables globales et celles que vous avez dfinies. Pour la colonne Filename, utilisez la variable globale : tFileList_1CURRENT_FILEPATH. Elle reprend le chemin daccs courant pour recueillir le nom de chaque fichier, le Job fait une boucle sur ce rpertoire. Pour le colonne Date, utilisez la routine Talend : Date.GetDate (en Perl) ou TalendDate.getCurrentDate() (en Java) Puis dans la vue Component du composant tLogRow, cochez la case Print values in cells of a table. Enregistrez votre Job et excutez-le, en appuyant sur F6.
Le chemin daccs apparat dans la colonne Filename et la date en cours apparat dans la colonne Date.
1142
tLoop
tLoop
Proprits du tLoop
Le composant tLoop fait une boucle sur lexcution dune tche. Le tLoop permet dexcuter automatiquement une tche ou un Job dans une boucle. Loop Type Slectionnez le type de boucle effectuer : For ou While. For : La tche ou le Job est excut(e) pour le nombre de boucle dfini. While : La tche ou le Job est excut(e) jusqu ce que la condition soit rencontre. Saisissez le numro de la premire instance sur laquelle la boucle doit commencer. Si vous slectionnez linstance numro 2 comme instance de dpart et que vous prenez un cart de 2, cela signifie que la boucle se fera sur tous les nombres pairs. Saisissez la dernire instance sur laquelle la boucle doit passer. Saisissez lcart entre deux instances avec lequel la boucle doit seffectuer. Un cart de 2 signifie que la boucle passe toutes les deux instances. Saisissez une expression dclenchant la boucle. Saisissez la condition devant tre rencontre pour que la boucle sarrte. Saisissez lexpression dcrivant lopration effectuer chaque boucle. Cochez cette case pour collecter les donnes de log au niveau du composant.
For
From
To Step
While
Declaration Condition Iteration
Le composant tLoop est un composant de dbut et requiert une connexion de type Iterate au composant suivant. n/a
Scnario : Excuter un Job partir dune boucle

Ce scnario dcrit un Job constitu dun Job parent et dun Job enfant. Le Job parent excute une boucle qui permet dexcuter un Job enfant n nombre de fois, avec une pause entre chaque excution.
1143
tLoop
Dans le Job parent, cliquez et dposez les composants tLoop, tRunJob et tSleep dans lespace de modlisation. Connectez le composant tLoop au tRunJob laide dune connexion de type Iterate. Puis connectez le tRunJob au tSleep laide dune connexion de type Row. Dans le Job enfant, cliquez et dposez les composants suivants : tPOP, tFileInputMail et tLogRow. Dans longlet Basic settings du composant tLoop, saisissez le numro de linstance sur lequel commencer (1), le numro de linstance sur lequel finir (5) et lcart utiliser (1). Dans longlet Basic settings du composant tRunJob, slectionnez le Job enfant dans la liste des Jobs proposs, pour cet exemple : popinputmail. Slectionnez le contexte, si ncessaire. Pour cet exemple, le contexte est celui par dfaut (default) ne contenant aucune variable. Dans longlet Basic settings du composant tSleep, saisissez la dure de la pause en secondes dans le champ Pause. Pour cet exemple, la pause est de 3 seconds. Dans longlet Basic settings du Job enfant, dfinissez les paramtres de connexion au serveur pop. Dans longlet Basic settings du composant tFileInputMail, slectionnez une variable globale dans le champ File Name, pour collecter le fichier courant dans le rpertoire dfini dans le composant tPOP. Appuyez sur Ctrl+Espace pour accder la liste des variables. Pour cet exemple, la variable utiliser est : $_globals{tPOP_1}{CURRENT_FILEPATH} (pour Perl) ((String)globalMap.get("tPOP_1_CURRENT_FILEPATH")) (pour Java) Dfinissez le Schema pour quil inclue llment du mail traiter. Les champs du schma sont les suivants : author, topic, delivery date et number of lines. Dans la colonne Mail part de la table Mail Parts, saisissez le champ de le-mail correspondant chaque colonne dfinie dans le schma. Par exemple : author provient du champ From du fichier e-mail.
1144
tLoop
Puis connectez les composants tFileInputMail et tLogRow. Appuyez sur F6 pour excuter le Job, et vrifiez les rsultats de lexcution dans la vue Run.
1145
tPostjob
tPostjob
Proprits du tPostjob
Fonction Objectif Utilisation Limitation
Le composant tPostjob dmarre lexcution dun post-job. Le tPostjob dclenche une action requise aprs lexcution dun Job. Le tPostjob est un composant de dbut. Il ne peut tre reli au composant suivant quavec une connexion de type Iterate. n/a
Pour plus dinformations sur le composant tPostjob, consultez la section Pr-job et post-job du Guide Utilisateur de Talend Open Studio.
Scnario associ
1146
tPrejob
tPrejob
Proprits du tPrejob
Fonction Objectif Utilisation Limitation
Le composant tPrejob dmarre lexcution dun pr-job. Le tPrejob dclenche une action requise pour lexcution dun Job. Le tPrejob est un composant de dbut. Il ne peut tre reli au composant suivant quavec une connexion de type Iterate. n/a
Pour plus dinformations sur le composant tPrejob, consultez la section Pr-job et post-job du Guide Utilisateur de Talend Open Studio.
Scnario associ
1147
tReplicate
tReplicate
Proprits du tReplicate
Le composant tReplicate duplique le schma entrant en deux flux identiques. Ce composant permet deffectuer diffrentes oprations sur le mme schma. Schema type 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 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 rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Utilisation
Ce composant nest pas un composant de dbut (fond vert) puisquil requiert un composant dentre et un composant de sortie.
Scnario associ
Pour un exemple dutilisation du tReplicate, consultez le tReplaceList, page 195
1148
tRunJob
tRunJob
Le tRunJob appartient deux familles : Orchestration et System. Pour plus dinformations concernant le composant tRunJob, consultez tRunJob, page 1264.
1149
tSleep
tSleep
Proprits du tSleep
Fonction Objectif
Le composant tSleep effectue une pause lors de lexcution dun Job. Ce composant permet didentifier les goulots dtranglement ventuels laide dune pause lors de lexcution du Job des fins de test ou de monitoring. En production, il peut tre utilis pour tout type de pause dans le traitement dun Job, pour alimenter un flux entrant par exemple. Pause (in second) Temps en seconde pendant lequel le Job est suspendu.
Basic settings Utilisation Limitation
Le composant tSleep est gnralement utilis comme composant intermdiaire mettant un Job en pause, avant de le reprendre. n/a
Scnario associ
Pour un exemple dutilisation du tSleep, consultez le Scnario : Excuter un Job partir dune boucle, page 1143.
1150
tUnite
tUnite
Proprits du tUnite
Le composant tUnite fusionne des donnes de diverses sources, bases sur un mme schma. Ce composant centralise des donnes provenant de sources diverses et htrognes. Schema type 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 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 rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant nest pas un composant de dbut; il requiert un ou plusieurs composants en entre et un composant de sortie.
Scnario : Itration sur des fichiers et fusion de contenu

Le Job suivant effectue une itration sur une liste de fichiers puis fusionne leur contenu et affiche le contenu final des deux colonnes dans la console.
Cliquez et dposez les composants suivants dans lespace de modlisation : tFileList, tFileInputDelimited, tUnite et tLogRow. Connectez le composant tFileList au tFileInputDelimited laide dun lien Iterate et connectez les autres composants laide de liens Row main. Dans longlet Basic settings du composant tFileList, slectionnez le rpertoire dans lequel les fichiers fusionner sont stocks.
tUnite
Dans la liste Case Sensitive, slectionnez Yes (Oui) si vous souhaitez tenir compte de la casse, ou No (Non) si vous ne vous voulez pas la prendre en compte. Pour cet exemple, slectionnez Yes. Les fichiers sont trs basiques et contiennent une liste de pays et leur score respectif.
Slectionnez le composant tFileInputDelimited et affichez son onglet Basic settings. Dans cet exemple, les paramtres de connexion des fichiers dentre ne sont pas stocks dans les mtadonnes du Repository. Ainsi, slectionnez loption Built-In dans le champ Property type et paramtrez les proprits manuellement.
1152
tUnite
Pour renseigner le champ File Name, appuyez sur Ctrl+Espace pour accder la liste des variables. Pour traiter tous les fichiers du rpertoire dfini dans le composant tFileList, slectionnez tFileList.CURRENT_FILEPATH dans la liste des variables globales. Conservez les paramtres par dfaut des champs Row et Field separators, ainsi que des autres champs. Cliquez sur le bouton Edit Schema et dfinissez manuellement le schma deux colonnes pour quil corresponde au contenu des fichiers dentre.
Pour cet exemple, les deux colonnes sont Country et Points. Elles peuvent toutes les deux prendre une valeur nulle, ainsi cochez les cases de la colonne Nullable. La colonne Country sera de type String, et la colonne Points sera de type Integer. Cliquez sur OK pour valider les paramtres, puis acceptez la propagation du schma dans le reste du Job. Puis slectionnez le composant tUnite et affichez la vue Component. Notez que le schma de sortie reflte exactement celui dentre et quil est en lecture seule. Dans la vue Component du composant tLogRow, cochez la case Print values in cells of the table pour afficher correctement les valeurs de sortie. Enregistrez le Job et excutez-le.
1153
tUnite
La console affiche les donnes des diffrents fichiers, fusionnes dans une seule table.
1154
tWaitForFile
tWaitForFile
Proprits du tWaitForFile
Fonction
Le composant tWaitForFile fait une boucle sur un rpertoire donn la recherche dajout ou de suppression de fichier puis dclenche un sous-Job lorsque la condition est rencontre. Ce composant permet de dclencher un Job en fonction dune condition lie la prsence ou au retrait dun fichier. Wait at each iteration (in seconds) Max. iterations (infinite if empty) Directory to scan File mask Include subdirectories Case sensitive Include present file Trigger action when Paramtrez lintervalle de temps entre chaque boucle. Nombre de vrifications effectuer avant que le Job ne sarrte. Nom du rpertoire vrifier. Masque du fichier recherch. Cochez cette case pour inclure les sous-dossiers. Cochez cette case pour tenir compte de la casse. Cochez cette case pour inclure le fichier courant. Slectionnez la condition remplir pour effectuer laction : A file is created : un fichier est cr. A file is deleted : un fichier est supprim. A file is updated : un fichier est mis jour A file is created or updated or deleted : un fichier est cr, supprim ou mis jour. Slectionnez laction effectuer : soit stopper litration lorsque la condition est rencontre (exit loop) soit continuer la boucle jusqu ce que le nombre maximum ditrations soit atteint (continue loop). 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 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 rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Then
1155
tWaitForFile
Wait for file to be released
Cochez cette case pour empcher lexcution du Job si votre fichier est ouvert.
Ce composant est un composant de dbut (ou de dclenchement) pour le sous-Job excut en fonction de la condition tablie. Ainsi, ce composant doit tre connect un sous-job via un lien Iterate. n/a
Limitation
Scnario : Attendre la suppression dun fichier

Ce scnario dcrit un Job permettant de scanner un rpertoire la recherche dun fichier qui sera supprim de ce rpertoire, pour ensuite lancer un sous-Job. Ainsi, lorsquun fichier est supprim, le sous-Job affiche un message indiquant cette suppression.
Ce Job est constitu de deux composants : le tWaitForFile et le tMsgbox. Cliquez et dposez ces composants dans lespace de modlisation et connectez-les laide dun lien Iterate pour effectuer la boucle. Puis slectionnez le composant tWaitForFile, et dans longlet Basic settings de la vue Component, paramtrez les proprits de la condition et de la boucle :
Dans le champ Time (in seconds) between iterations, paramtrez la dure en secondes entre chaque itration. Dans cet exemple, le rpertoire sera scann toutes les 5 secondes. Dans le champ Max. number of iterations (infinite loop if empty), saisissez le nombre ditration effectuer avant que le Job ne soit arrt. Dans cet exemple, le rpertoire est scann 5 fois maximum. Dans le champ Directory to scan, renseignez le chemin daccs au rpertoire devant tre scann.
1156
tWaitForFile
Dans le champ Trigger action when, slectionnez la condition rencontrer pour que le sous-Job soit lanc. Dans cet exemple, la condition est la suppression (ou le dplacement) dun fichier du rpertoire. Dans le champ Then, slectionnez laction effectuer lorsque la condition est rencontre avant que le nombre ditrations dfini ne soit atteint. Dans cet exemple, la boucle sarrte ds que la condition est rencontre. Puis dfinissez le sous-Job effectuer lorsque la condition est rencontre. Dans cet exemple, le sous-Job affiche une bote de dialogue. Slectionnez le composant tMsgBox, et dans longlet Basic settings de la vue Component, saisissez le message afficher. Dans les champs Title et Message, renseignez le titre et le message. Dans les champs Buttons et Icon, renseignez le type de boutons et dicnes utiliser.
Dans le champ Message, vous pouvez saisir nimporte quel type de message que vous souhaitez faire apparatre et utiliser des variables globales disponibles dans la liste dauto-compltion via le raccourci Ctrl+Espace. Par exemple, en Perl, le message utilis pour ce Job est : "Deleted File: $_globals{tWaitForFile_1}{DELETED_FILE}, on Iteration : $_globals{tWaitForFile_1}{CURRENT_ITERATION}\n" Le message en Java est : "Deleted file: "+((String)globalMap.get("tWaitForFile_1_DELETED_FILE"))+" on iteration Nr:"+((Integer)globalMap.get("tWaitForFile_1_CURRENT_ITERATI ON"))
1157
tWaitForFile
Excutez le Job via la raccourci F6. Pendant que la boucle seffectue, supprimez un fichier du rpertoire dfini et la bote de dialogue contenant le message dfini apparat.
1158
tWaitForSocket
tWaitForSocket
Proprits du tWaitForSocket
Fonction
Le composant tWaitForSocket fait une boucle sur un port dfini la recherche de donnes puis dclenche un sous-job lorsque la condition est rencontre. Ce composant permet de dclencher un Job en fonction dune condition dfinie. Port End of line separator Then Saisissez le numro du port couter. Saisissez le sparateur de fin de ligne de vos donnes. Slectionnez laction effectuer : soit continuer couter le port (keep on listening) soit fermer la connexion (close socket). Cochez cette case afin dafficher les donnes client ou serveur. Cochez cette case pour collecter les donnes de log au niveau du composant.
Print client/server data Advanced settings Utilisation tStatCatcher Statistics
Ce composant est un composant de dbut (ou de dclenchement) pour le sous-Job excut en fonction de la condition tablie. Ainsi, ce composant doit tre connect un sous-job via un lien Iterate. n/a
Limitation
Scnario associ
1159
tWaitForSqlData
tWaitForSqlData
Proprit du tWaitForSqlData
Fonction
Le composant tWaitForSqlData effectue une boucle sur une connexion donne la recherche dun ajout ou dune suppression de lignes, puis dclenche un sous-Job lorsque la condition est rencontre. Ce composant permet de dclencher un sous-Job en fonction de la prsence de donnes sql. Wait at each iteration (in seconds) Max. iterations (infinite loop if empty) Paramtrez en secondes lintervalle de temps entre chaque vrification. Nombre de vrifications effectuer avant que le Job ne sarrte (si vous ne saisissez rien, la boucle sera infinie).
Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent 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. Table to scan Nom de la table vrifier.
1160
tWaitForSqlData
Trigger action when rowcount is
Slectionnez la condition rencontrer pour excuter laction : Equal to : gal Not Equal to : diffrent de Greater than : suprieur Lower than : infrieur Greater or equal to : suprieur ou gal Lower or equal to :infrieur ou gal . Dfinissez la valeur prendre en compte. Slectionnez laction effectuer lorsque la condition est rencontre : soit arrter la boucle (exit loop), soit continuer la boucle jusqu ce que le nombre ditration maximum soit atteint (continue loop).
Value Then
Utilisation
Bien que ce composant ait besoin dun composant de connexion pour ouvrir laccs une base de donnes, il joue aussi le rle de composant de dbut (ou de dclenchement) pour le sous-Job excuter lorsque la condition est rencontre. Ainsi, ce composant doit tre connect un sous-Job via un lien Iterate. n/a
Limitation
Scnario : Attendre lajout de lignes dans une table

Ce scnario dcrit un Job lisant la table dune base de donnes dans lattente dun ajout de donnes dans cette table, pour ensuite excuter un sous-Job. Lorsque des donnes sont ajoutes, le sous-Job effectue un Select* sur la table et affiche le contenu des donnes insres dans la console standard. Cet exemple est prsent en Perl, mais les paramtres sont les mmes si vous souhaitez leffectuer en Java.
Cliquez et dposez les composants suivants de la Palette dans lespace de modlisation : tMysqlConnection, tWaitForSqlData, tMysqlInput, tLogRow. Connectez le composant tMysqlConnection au composant tWaitforSqlData laide un lien OnSubJobOK, disponible via le clic-droit. Puis connectez le composant tWaitForSqlData au sous-Job laide dun lien Iterate puisquaucune donne nest transfre pour le moment. En effet, le tWaitForSqlData effectue seulement des boucles jusqu ce que la condition soit rencontre. Dans le sous-Job excuter si la condition est rencontre, le composant tMysqlInput est connect au tLogRow. Puisque cette connexion sert transfrer des donnes, utilisez un lien de type Row main.
1161
tWaitForSqlData
Maintenant, paramtrez la connexion la table devant tre vrife intervalles rguliers. Dans longlet Basic Settings de la vue Component du composant tMySqlConnection, paramtrez les proprits de connexion la base de donnes.
Renseignez les champs Host, Port, Database, Username, Password pour ouvrir une connexion la base de donnes. Pour plus dinformations, consultez les composants de connexion aux bases de donnes. Par exemple, pour une base de donnes Mysql, consultez tMysqlConnection page 482. Dans le champ Encoding, slectionnez lencodage adquat, si ncessaire. Puis slectionnez le composant tWaitForSqlData, et dans longlet Basic Settings de la vue Component, paramtrez ses proprits. Dans le champ Wait at each iteration, paramtrez en secondes lintervalle entre chaque itration.
Dans le champ Max iterations, saisissez le nombre ditrations maximum effectuer avant que le Job ne sarrte. Pour utiliser le composant tWaitForSqlData, il faut quune connexion soit ouverte pour effectuer le nombre de boucles dfini. Slectionnez la connexion adquate (sil y en a plusieurs) dans la liste droulante Component List. Dans le champ Table to scan, saisissez le nom de la table scanner. Dans cet exemple : test_datatypes. Dans les champs Trigger action when rowcount is et Value, slectionnez la condition rencontrer afin de lancer le sous-Job. Pour cet exemple, le nombre de lignes prendre en compte dans la table scanne soit tre suprieur ou gal 1, ainsi slectionnez be greater or equal to 1.
1162
tWaitForSqlData
Dans le champ Then, slectionnez laction effectuer lorsque la condition est rencontre avant que le nombre maximum ditrations dfini ne soit atteint. Dans cet exemple, ds que la condition est rencontre, la boucle devrait sarrter. Puis paramtrez le sous-Job excuter lorsque la condition est rencontre. Dans cet exemple, le sous-Job slectionne les donnes de la table scanne et les affiche dans le console. Slectionnez le composant tMysqlInput, et dans longlet Basic Settings de la vue Component, paramtrez la connexion la table.
Si la connexion est stocke dans le Repository, slectionnez-la dans la liste droulante. Sinon, cochez la case Use an existing connection et slectionnez le composant de connexion correspondant dans la liste. Dans cet exemple, le schma correspondant la structure de la table est stock dans le Repository. Dans le champ Table Name, renseignez le nom de la table partir de laquelle les donnes seront extraites, Test_datatypes. Puis dans le champ Query, saisissez la commande Select permettant dextraire le contenu de la table. Pour cet exemple, laissez les proprits par dfaut du composant tLogRow. Avant dexcuter le Job, assurez-vous que la table scanner (test_datatypes) est bien vide, afin que la condition (greater or equal to 1) soit rencontre. Puis excutez le Job via le raccourci F6. Avant la fin de la boucle, ajoutez une ou deux lignes la table test_datatypes afin que la condition soit rencontre.
Le Job sarrte lorsque les donnes ajoutes la table sont dtectes lors de la boucle et le contenu de la table est affich dans la console.
1163
tWaitForSqlData
1164
Composants Processing
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille Processing de la Palette de Talend Open Studio. La famille Processing regroupe les composants vous permettant deffectuer diffrents types de traitement de flux de donnes, notamment lagrgation, le mapping, la transformation, la dnormalisation, le filtrage, etc.
tAggregateRow
tAggregateRow
Proprits du tAggregateRow
Famille de composant Processing
Fonction
Le composant tAggregateRow reoit un flux de donnes et fait une agrgation base sur une ou plusieurs colonnes. Pour chacune des lignes en sortie, une cl dagrgation est fournie, ainsi que le rsultat de lopration dagrgation correspondant (min, max, sum, etc.). Il permet dtablir des mtriques et des statistiques bases sur des valeurs ou des calculs. Schema type 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 lorsque vous modifiez le schma, il se met automatiquement en built-in. 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 dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Group by Dfinit les ensembles dagrgation, dont les valeurs sont utilises pour les calculs. Output Column : Slectionnez le libell de colonne dans la liste fournie, base sur la structure de schma que vous avez dfinie. Vous pouvez ajouter autant de colonnes de sortie que vous le souhaitez afin daffiner les agrgations. Ex : Slectionnez Country (Pays) pour calculer la moyenne des valeurs pour chaque pays ou slectionnez Country et Region pour comparer les rsultats des rgions dun pays par rapport aux rgions dun autre pays. Input Column : Faites la correspondance entre les libells des colonnes dentre avec ceux des colonnes de sortie, dans le cas o vous souhaitez que les libells du schma de sortie soient diffrents du schma dentre. Operations Slectionnez le type dopration effectuer ainsi que la valeur utiliser pour le calcul et le champ de sortie.
1166
tAggregateRow
Output Column : Slectionnez le champ de destination dans la liste. Fonction : Slectionnez loprateur parmi : count : calcule le nombre de ligne, min : slectionne la plus petite valeur, max : slectionne la plus grande valeur, avg : calcule la moyenne, sum : calcule la somme, first : retourne la premire valeur, last : retourne la dernire valeur, list : liste les valeurs dune agrgation de plusieurs cls. list (object) : liste les valeurs Java dune agrgation de plusieurs cls, count (distinct) : compte le nombre de lignes sans les doublons, standard deviation : calcule lcart-type. Input column position : Slectionnez la colonne dentre partir de laquelle les valeurs sont collectes pour lagrgation. Ignore null values : Cochez cette case devant le nom de toutes les colonnes pour lesquelles vous voulez que les valeurs nulles soient ignores. Advanced settings Delimiter(only for list operation) Use financial precision, this is the max precision for sum and avg operations, checked option heaps more memory and slower than unchecked. Saisissez le sparateur que vous souhaitez utiliser afin de sparer les diffrentes oprations. Cochez cette case afin dutiliser une prcision financire, une prcision maximale, mais qui consomme plus de mmoire et rend le processus plus lent. Nous vous conseillons dutiliser le type BigDecimal en sortie avec cette option, afin dobtenir des rsultats prcis.
Check type overflow Vrifie les types des donnes afin dviter que le (slower) Job ne plante Check ULP (Unit in the Last Place), ensure that a value will be incremented or decremented correctly, only float and double types. (slower) tStatCatcher Statistics Utilisation Cochez cette case afin davoir la meilleure prcision possible pour les types Float et Double.
Ce composant est un composant intermdiaire car il traite un flux de donnes, par consquent il requiert des composants en entre comme en sortie. Gnralement, lutilisation du composant tAggregateRow est combine au composant tSortRow.
1167
tAggregateRow
Limitation
n/a
Scnario : Agrger des valeurs et trier des donnes

Le scnario suivant dcrit un Job quatre composants. Le composant dentre, un fichier dlimit csv, contient des noms de pays et des valeurs de notation trier par ordre dcroissant de moyenne. Ce composant dentre est connect un oprateur tAggregateRow qui se charge de calculer les moyennes puis un composant tSortRow qui se charge du tri. Le flux de sortie est dirig dans un nouveau fichier CSV.
A partir du dossier File de la Palette, cliquez et dposez un composant tFileInputDelimited. Cliquez sur le libell du composant et renommez-le en Countries. Ou passez dans longlet View pour le changer. Dans longlet Basic settings, dfinissez le chemin daccs ainsi que les critres de dlimitation. Ou slectionnez lentre de mtadonnes correspondant votre fichier dentre, si vous en avez dfini une. Cliquez sur Edit schema... et paramtrez les colonnes : Countries et Points correspondant la structure du fichier. Si la description du fichier est conserve dans les Metadata du Repository, le schma est automatiquement charg lorsque vous cliquez sur Repository dans le champ Schema type. Puis dans le dossier Processing de la Palette, cliquez et dposez le composant tAggregateRow. Renommez-le en Calculation. Cliquez-droit et connectez Countries Calculation laide dune connexion Row > Main. Double-cliquez sur Calculation (composant tAggregateRow) pour dfinir les proprits. Cliquez sur Edit schema et dfinissez le schma de sortie. Vous pouvez ajouter autant de colonnes que vous le voulez selon le nombre doprations densemble que vous souhaitez obtenir en sortie.
1168
tAggregateRow
Dans cet exemple, nous calculerons la moyenne de la notation par pays et nous afficherons les valeurs min et max par pays, sachant que chaque pays possde plusieurs notes. Cliquez sur OK lorsque le schma est termin. Dfinissez prsent les diffrentes oprations densemble effectuer. Dans le champ Group By de la fentre Basic settings du composant tAggregateRow, dfinissez les ensembles sur lesquels les oprations sont effectues. Dans cet exemple, slectionnez Country comme colonne de regroupement. Notez que dans la colonne de sortie, un champ cl doit tre dfini dans le schma. La premire colonne cite comme de sortie (Output) dans la table Group By devient lensemble principal de calcul. Toutes les autres sorties deviennent alors secondaires dans lordre daffichage. Slectionnez la colonne dentre (Input) dont sont extraites les valeurs. Puis renseignez les diverses oprations ralises. Les fonctions utilises dans cet exemple sont des moyennes (average), min, max. Slectionnez la colonne dentre dont sont extraites les valeurs de calcul et slectionnez les cases Ignore null values si ncessaire.
1169
tAggregateRow
Cliquez-dposez un composant tSortRow dans lespace de modlisation. Pour plus dinformations concernant ce composant, consultez Proprits du tSortRow page 1257. Connectez-le au composant tAggregateRow laide dune connexion de type Row > Main. Dans la vue Component du composant tSortRow, dfinissez la colonne de tri, le type ainsi que lordre de tri.
Dans ce scnario, la colonne trier est Country, le type de tri est alphabtique et lordre est ascendant. Ajoutez un composant de sortie ce Job. Cliquez et dposez un composant tFileOutputDelimited et paramtrez-le. Connectez le composant tSortRow ce composant de sortie.
1170
tAggregateRow
Dans la vue Component, saisissez le chemin daccs au fichier de sortie. Cliquez sur Edit schema pour le configurer si ncessaire. Dans ce scnario, le fichier dlimit est de type CSV. Cochez la case Include Header afin de rutiliser les libells des colonnes du schma dans le flux de sortie. Appuyez sur F6 pour excuter le Job. Le fichier CSV est ainsi cr et il contient les rsultats des oprations dagrgation.
1171
tAggregateSortedRow
tAggregateSortedRow
Proprits du tAggregateSortedRow
Famille du composant Processing
Fonction
Le composant tAggregateSortedRow reoit un flux de donnes tries sur lequel il effectue une agrgation base sur une ou plusieurs colonnes. La cl dagrgation et les rsultats pertinents des oprations (min, max, sum, etc.) sont dispenss pour chaque ligne de sortie. Le tAggregateSortedRow vous permet de rcuprer un chantillon de mtriques reposant sur des valeurs ou des calculs. Etant donn que les donnes du flux dentre sont supposes tre dj tries, les performances nen sont que plus optimises. Schema type 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 lorsque vous modifiez le schma, il se met automatiquement en built-in. 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 dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Group by Dfinit les ensembles dagrgation, dont les valeurs sont utilises pour les calculs. Output Column : Slectionnez le libell de colonne dans la liste fournie, base sur la structure de schma que vous avez dfinie. Vous pouvez ajouter autant de colonnes de sortie que vous le souhaitez afin daffiner les agrgations. Ex : Slectionnez Country (Pays) pour calculer la moyenne des valeurs pour chaque pays ou slectionnez Country et Region pour comparer les rsultats des rgions dun pays par rapport aux rgions dun autre pays. Input Column : Faites la correspondance entre les libells des colonnes dentre avec ceux des colonnes de sortie, dans le cas o vous souhaitez que les libells du schma de sortie soient diffrents du schma dentre.
Objectif
Basic settings
1172
tAggregateSortedRow
Operations
Slectionnez le type dopration effectuer ainsi que la valeur utiliser pour le calcul et le champ de sortie. Output Column : Slectionnez le champ de destination partir de la liste droulante. Function : Choisissez loprateur parmi : count, min, max, avg, first, last. Input column position : Slectionnez la colonne dentre partir de laquelle les valeurs sont rcupres avant dtre agrges. Ignore null values : Cochez cette case devant le nom de toutes les colonnes pour lesquelles vous voulez que les valeurs nulles soient ignores.
Utilisation
Ce composant traite des flux de donnes, il ncessite donc des composants dentre et sortie. Il est donc dfini en tant que composant intermdiaire. n/a
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Agrger des valeurs et trier des donnes, page 1168 du composant tAggregateRow.
1173
tConvertType
tConvertType
Proprits du tConvertType
Fonction
Le composant tConvertType permet deffectuer des conversions spcifiques du type de donnes Java vers un autre type de donnes Talend au cours de lexcution. Le composant tConvertType permet de convertir automatiquement des donnes de type Java vers un autre type utilis par Talend, ce qui permet dviter les erreurs de compilation. Schema type 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 lorsque vous modifiez le schma, il se met automatiquement en built-in. 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 dans divers projets et Jobs designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Auto Cast Cette case est coche par dfaut. Elle permet de convertir automatiquement des donnes de type Java.
Objectif
Basic settings
Ce composant ne peut tre utilis comme composant de dbut. Il requiert un flux dentre pour fonctionner. n/a
Scnario : Convertir des types de donnes Java

Le scnario Java suivant permet de crer un Job quatre composants dans lequel le tConvertType est utilis pour convertir des donnes de type Java stockes dans trois colonnes diffrentes et le tMap est utilis pour modifier le schma : la premire colonne reste intacte et les deux dernires colonnes du schma dentre sont fusionnes en une seule colonne dans le schma de sortie.
1174
tConvertType
Dans ce scnario, le schma du fichier dlimit utilis en entre est stock dans le Repository, vous pouvez donc renseigner les proprits du composant tFileInputDelimited dun simple glisser-dposer du rpertoire Repository > Metadata > File delimited vers lespace de modlisation. Pour plus dinformations, consultez Dposer des composants du rpertoire Metadata du Guide utilisateur de Talend Open Studio.
Cliquez et dposez les composants suivants dans lespace de modlisation : tConvertType, tMap et tLogRow. Dans le Repository, dveloppez les noeuds Metadata > File Delimited et glissez-dposez la mtadonne correspondante dans lespace de modlisation. Pour ce scnario, JavaTypes. La bote de dialogue [Components] apparat. Dans la bote de dialogue, slectionnez le tFileInputDelimited dans la liste des composants et cliquez sur Ok. Un composant tFileInputComponent appel Java types apparat dans lespace de modlisation. Connectez les composants laide de liens Row Main.
Dans lespace de modlisation, slectionnez le composant tFileInputDelimited et cliquez sur la vue Component pour paramtrer ses proprits de base. Dans longlet Basic settings, slectionnez loption Repository dans la liste Property Type puisque les proprits du fichier sont stockes dans le Repository. Les autres champs sont alors renseigns automatiquement grce aux donnes rcupres.
Le fichier dentre utilis pour ce scnario est un fichier texte appel input contenant des donnes Java de type string (chane de caractres), integer (entier) et float.
1175
tConvertType
Dans la vue Basic settings, renseignez les autres champs, si ncessaire. Pour plus dinformations, consultez les Proprits du tFileInputDelimited, page 886. Dans ce scnario, il ny a pas den-tte et de pied de page et il ny a pas de nombre limite de lignes traiter. Cliquez sur Edit schema pour dcrire la structure des donnes du fichier dentre. Dans ce scnario, le schma est compos de trois colonnes : StringtoInteger, IntegerField et FloatToInteger.
Cliquez sur Ok pour fermer la bote de dialogue. Dans lespace de modlisation, slectionnez le tConvertType et cliquez sur la vue Component pour paramtrer ses proprits de base.
Dans la liste Schema Type, slectionnez loption Built in et cliquez sur le bouton Sync columns pour rcuprer automatiquement les colonnes du composant tFileInputDelimited. Si ncessaire, cliquez sur Edit schema pour dcrire manuellement la structure des donnes de ce composant de traitement.
Gnralement, la case Auto Cast est coche par dfaut.
1176
tConvertType
Dans ce scnario, nous souhaitons convertir les donnes de type string (chane de caractres) en integer (entier) et des donnes de type float en integer. Cliquez sur OK pour fermer la bote de dialogue [Schema of tConvertType]. Dans lespace de modlisation, double-cliquez sur le tMap pour ouvrir lditeur du tMap. Lditeur du tMap souvre et affiche les noms des colonnes du fichier dentre.
Dans longlet Schema editor en bas de lditeur du tMap, cliquez sur le bouton (+) de la table de sortie pour ajouter deux lignes et nommez-les StringToInteger et Sum. Dans lditeur du tMap, glissez la ligne StringToInteger de la table dentre vers la ligne StringToInteger de la table de sortie. Dans lditeur du tMap, glissez les lignes IntegerField et FloatToInteger de la table dentre vers la ligne Sum de la table de sortie.
1177
tConvertType
Cliquez sur OK pour fermer lditeur du tMap.
Dans lespace de modlisation, slectionnez le tLogRow et cliquez sur la vue Component pour paramtrer ses proprits de base. Pour plus dinformations, consultez le tLogRow, page 1095. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Les donnes de type string sont converties en integer et affiches dans la colonne StringToInteger dans la console. Les donnes de type float sont converties en integer et ajoutes la valeur IntegerField et leur somme est affiche dans la colonne Sum dans la console.
1178
tDenormalize
tDenormalize
Proprits du tDenormalize
Famille de composant Processing/Fields
Le composant tDenormalize dnormalise un flux entrant en fonction dune colonne. Le tDenormalize permet de synthtiser un flux entrant. Schema type 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. En Perl, le schma est en lecture seule et obligatoirement en Built-In. 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. To denormalize Java uniquement Ce tableau vous permet de choisir les paramtres de dnormalisation des colonnes. Column : Slectionnez la colonne dnormaliser. Delimiter : Saisissez, entre guillemets doubles, le sparateur que vous souhaitez utiliser. Merge same value : Cochez cette case si vous voulez fusionner les valeurs identiques. Slectionnez la colonne du flux entrant sur laquelle est base la dnormalisation (inclus dans la cl). Slectionnez une ou plusieurs colonnes regrouper. Nous vous conseillons de supprimer du schma les colonnes qui ne sont pas utilises avant de procder au traitement. Renseignez le sparateur dlimitant les donnes du flux dnormalis.
Perl uniquement Java uniquement
Column to denormalize Group by
Item Separator Perl uniquement Advanced settings Deduplicate items Perl uniquement tStatCatcher Statistics Utilisation Limitation
Supprime les doublons lorsque les valeurs dnormalises sont concatnes. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant peut tre utilis en tape intermdiaire dans un flux de donnes. Notez que ce composant peut changer lordre du flux entrant en Java et en Perl.
1179
tDenormalize
Scnario 1 : Dnormaliser une colonne

Ce scnario illustre un Job dnormalisant une colonne dun fichier dlimit via un composant de dnormalisation, et affichant le rsultat dans la console.
Cliquez et dposez les composants suivants : tFileInputDelimited, tDenormalize, tLogRow. Connectez ces composants laide dun lien Row main. Dans la vue Component du composant tFileInputDelimited, renseignez le chemin daccs au fichier dnormaliser.
Dans les champs Header, Row Separator et Field Separator, renseignez respectivement le nombre de lignes den-tte, le type de sparateur de lignes et de champs. Le fichier dentre est compos de deux colonnes : Fathers et Children.
Dans longlet Basic settings du tDenormalize, paramtrez la colonne contenant des valeurs multiples regrouper. Dans le tableau To denormalize, slectionnez la colonne Children. Dans cet exemple, la colonne Children est celle dnormaliser.
1180
tDenormalize
Dans le champ Delimiter, paramtrez le sparateur des valeurs regroupes. Attention, une seule colonne peut tre dnormalise. Cochez la case Merge same value si vous souhaitez supprimer les ventuels doublons. Enregistrez le Job et excutez-le en appuyant sur F6.
Toutes les valeurs de la colonne Children (dfinie comme colonne dnormaliser) sont regroupes en fonction des valeurs de la colonne Fathers. Les valeurs sont spares par des virgules.
Scnario 2 : Dnormaliser plusieurs colonnes

Ce scnario illustre un Job dnormalisant deux colonnes dun fichier dlimit via un composant de dnormalisation et affichant le rsultat dans la console.
Cliquez et dposez les composants suivants : tFileInputDelimited, tDenormalize, tLogRow. Connectez tous les composants laide dune connexion Row main.
1181
tDenormalize
Dans longlet Basic settings du composant tFileInputDelimited, renseignez le chemin daccs au fichier dnormaliser.
Renseignez les autres champs dont les champs Row et Field separators et Header contenant respectivement les sparateurs de lignes et de champs et le nombre de lignes den-tte. Le schma du fichier est compos de quatre colonnes : Name, FirstName, HomeCity, WorkCity.
Dans longlet Basic settings du composant tDenormalize, slectionnez les colonnes contenant les rptitions. Elles correspondent aux colonnes apparaissant plusieurs fois dans le document. Dans cet exemple, FirstName, HomeCity et WorkCity sont les colonnes partir desquelles la dnormalisation est effectue. Ajoutez autant trois lignes la table To denormalize que vous le souhaitez en cliquant sur le bouton [+]. Puis slectionnez les colonnes FirstName, HomeCity et WorkCity dans la liste droulante.
1182
tDenormalize
Dans la colonne Delimiter, paramtrez les dlimiteurs en les saisissant entre guillemets, afin de sparer les valeurs concatnes. Pour la colonne FirstName, saisissez #, pour la colonne HomeCity, saisissez , et pour la colonne WorkCity, saisissez . Enregistrez le Job et excutez-le, en appuyant sur F6.
Le rsultat affiche les valeurs dnormalises concatnes laide des sparateurs. Dans longlet Basic settings du composant tDenormalize, dans le tableau To denormalize, cochez la case Merge same value pour fusionner les valeurs identiques. Enregistrez le Job et excutez-le en appuyant sur F6.
Cette fois-ci, la console affiche les rsultats sans doublon.
1183
tDenormalizeSortedRow
Proprits du tDenormalizeSortedRow
Famille du composant Processing/Fields
Fonction
Le composant tDenormalizeSortedRow rassemble dans un groupe toutes les lignes dentre dnormalises tries ainsi que leurs valeurs distinctes, associes par des sparateurs de champ. Le tDenormalizeSortedRow permet de synthtiser les lignes dentre tries afin de faire des conomies de mmoire. Schema type 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. 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. Input rows count To denormalize Renseignez le nombre de lignes dentre. Renseignez le nom de la colonne dnormaliser.
Ce composant traite des flux de donnes, il ncessite donc un composant dentre et un composant de sortie. n/a
Scnario : Regrouper des lignes tries

Ce scnario Java dcrit un Job quatre composants. Il permet de lire un fichier dlimit donn ligne par ligne, de trier les donnes dentres en fonction de leur type et de leur ordre, de dnormaliser toutes les lignes dentres tries et enfin dafficher le rsultat dans la console de log Run. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tFileInputDelimited, le tSortRow, le tDenormalizeSortedRow et le tLogRow. Connectez les quatre composants laide de liens de type Row Main.
1184
Dans lditeur graphique, slectionnez le composant tFileInputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileInputDelimited.
Dfinissez le champ Property Type en mode Built-In. Renseignez le chemin daccs au fichier traiter dans le champ File Name. Dans cet exemple, on utilise le fichier name_list, qui comporte deux colonnes, id et first name.
Dfinissez si ncessaire les sparateurs de lignes et de champs, len-tte et le pied-de-page, ainsi que le nombre de lignes traites. Dfinissez le champ Schema en mode Built in puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes passer au composant suivant. Dans cet exemple, le schma est constitu de deux colonnes, id et name.
1185
Dans lespace graphique, slectionnez le composant tSortRow. Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings) du tSortRow.
Dfinissez le champ Schema Type en mode Built-In puis cliquez sur Sync columns pour rcuprer le schma partir du composant tFileInputDelimited. Dans le panneau Criteria, cliquez sur le bouton [+] pour ajouter une ligne puis dfinissez les paramtres de tri pour la colonne du schma traiter. Dans cet exemple, on veut trier la colonne id dans lordre croissant. Dans lespace graphique, slectionnez le composant tDenormalizeSortedRow. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tDenormalizeSortedRow.
1186
Dfinissez le champ Schema Type en mode Built-In puis cliquez sur Sync columns pour rcuprer le schma partir du schma du composant tSortRow. Dans le champ Input rows count, entrez le nombre de lignes dentre traiter ou cliquez simultanment sur Ctrl+Espace pour accder la liste des variables de contexte puis slectionnez la variable : tDenormalizeSortedRow_1.NB_LINE. Dans le panneau To denormalize, cliquez sur le bouton [+] pour ajouter une ligne puis dfinissez les paramtres de la colonne dnormaliser. Dans cet exemple, on veut dnormaliser la colonne name. Dans lditeur graphique, slectionnez le composant tLogRow puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations sur le LogRow, consultez le chapitre tLogRow, page 1095. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
Le rsultat affich sur la console montre la faon dont la colonne name a t dnormalise.
1187
tEmptyToNull
tEmptyToNull
Proprits du tEmptyToNull
Fonction Objectif
Le composant tEmptyToNull transforme les champs vides dun fichier ou dune table en champs NULL dans une base de donnes. Le tEmptyToNull permet de remplacer des champs vides par des champs non dfinis produisant des valeurs NULL dans le composant de sortie. Ce composant ne ncessite aucune configuration, il sexcute automatiquement. tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Basic settings Advanced settings Utilisation
Ce composant est gnralement utilis comme composant intermdiaire dans un flux de donnes, il ncessite donc un composant en entre et un composant en sortie. Le composant en sortie doit obligatoirement tre de type base de donnes. n/a
Limitation
Scnario : Remplacer des champs vides par des champs non-dfinis (NULL)
Ce scnario Perl dcrit un Job trois composants. Il permet de remplacer les champs sans chanes de caractres par des champs non-dfinis afin de gnrer des valeurs NULL en sortie. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tFileInputDelimited, le tEmptyToNull et le tMysqlOutput. Connectez les trois composants laide de liens de type Row Main.
Dans lditeur graphique, slectionnez le composant tFileInputDelimited. Cliquez sur la vue Component pour configurer les paramtres de base (Basic settings) du tFileInputDelimited.
1188
tEmptyToNull
Dans le champ Property Type, slectionnez le mode Repository si vous avez stock les informations du fichier dlimit sous le noeud Metadata du Repository ou slectionnez le mode Built-In pour les dfinir manuellement. Dans ce scnario, on utilise le mode Built-In. Renseignez le chemin daccs au fichier traiter dans le champ File Name. Dans cet exemple, on utilise le fichier name_list, qui comporte quatre colonnes, id, first name, last name et login.
Dfinissez si ncessaire les sparateurs de lignes (Row separator) et de champs (Field separator), len-tte (Header) et le pied-de-page (Footer), ainsi que le nombre de lignes traiter (Limit). La premire ligne, qui porte le nom des colonnes, est ignore dans cet exemple, cest pourquoi le champ Header est dfini 1. Dans le champ Schema, slectionnez le mode Built in puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes passer au composant suivant. Dans cet exemple, le schma est constitu de quatre colonnes, id, first_name, last_name et login.
1189
tEmptyToNull
Dans lditeur graphique, double-cliquez sur le composant tMysqlOutput pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] cot du champ Edit schema pour consulter le schma. Dans le champ Property Type, slectionnez Repository si vous avez stock les informations de connexion la base de donnes sous le noeud Metadata du Repository ou slectionnez le mode Built-In, puis renseignez manuellement les champs suivants : Host, Port, Database, Username et Password. Pour plus dinformations sur les proprits du composant tMysqlOutput, consultez tMysqlOutput page 495. Dans le champ Table, saisissez le nom de la table dont les champs contiendront les donnes extraites du fichier dlimit. Dans le champ Action on table, slectionnez lopration que vous souhaitez effectuer sur la table. Pour ce scnario, slectionnez Create table pour crer la table.
1190
tEmptyToNull
Dans le champ Action on data, slectionnez lopration que vous souhaitez effectuer sur les donnes. Pour ce scnario, laissez loption Insert. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
A partir de votre explorateur de base de donnes, vous pouvez vrifier que la table namelist a bien t cre. Elle se prsente sous la forme des quatre colonnes id, first_name, last_name et login du schma dfini en sortie et les champs vides du fichier de dpart on t remplacs par la valeur NULL.
1191
tExternalSortRow
tExternalSortRow
Proprits du tExternalSortRow
Fonction
Le composant tExternalSortRow utilise une application externe de tri pour trier les donnes dentre dune ou plusieurs colonnes, en fonction de leur type et de leur ordre. Le tExternalSortRow permet dtablir des mtriques et des tables de classification. 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. 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. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Caractre, chane ou expression rgulire sparant les champs. Renseignez le chemin daccs au fichier externe contenant lalgorithme de tri utiliser. Cliquez sur [+] pour ajouter autant de lignes que ncessaire pour mettre en place le tri. La premire colonne dfinie dans le schma est slectionne par dfaut. Schema column : Slectionnez la colonne de votre schma sur laquelle vous souhaitez baser votre tri. Notez que lordre est important car il dtermine la priorit de tri. Sort type : Numrique ou Alphabtique. Dautres types de tri sont venir.
Field separator External command sort path Criteria
1192
tExternalSortRow
Order : Ordre ascendant ou descendant. Advanced settings Maximum memory Renseignez la taille de la mmoire physique que vous voulez allouer au processus de tri.
Temporary directory Dfinissez lendroit o stocker les fichiers temporaires. Set temporary input file directory Add a dummy EOF line tStatCatcher Statistics Utilisation Limitation Cochez la case pour afficher le champ dans lequel vous pouvez spcifier le rpertoire du fichier dentre temporaire. Cochez cette case lorsque vous utilisez le composant tAggregateSortedRow. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant traite des flux de donnes, il ncessite donc un composant dentre et un composant de sortie. n/a
Scnario associ
Pour un scnario associ, consultez le Scnario : Trier des donnes, page 1258 du composant tSortRow.
1193
tExtractDelimitedFields
Proprits du tExtractDelimitedFields
Fonction Objectif
Le composant tExtractDelimitedFields gnre des colonnes multiples partir dune colonne donne dans un fichier dlimit. Le tExtractDelimitedFields permet dextraire les champs partir dune chane de caractres, pour les crire un autre endroit par exemple. Field to split Field separator Slectionnez partir de la liste le champ sparer. Dfinissez le sparateur de champs. La syntaxe regex utilise un certain nombre de caractres spciaux comme oprateurs. Si vous utilisez lun de ces oprateurs comme sparateur de champs, il est ncessaire de protger le caractre par un double backslash. 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. 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. 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.
Basic settings
Die on error
Advanced settings
Advanced separator(for number)
Cochez cette option pour modifier les sparateurs utiliss pour les nombres.
1194
Trim columns
Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes. Cochez cette case pour synchroniser chaque ligne avec le schma dentre. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Check each row structure against schema tStatCatcher Statistics Utilisation
Ce composant traite des flux de donnes, il ncessite donc un composant dentre et un composant de sortie. Il permet d'extraire des donnes d'un champ dlimit l'aide d'un lien Row > Main, et permet de crer un flux de rejet avec un lien Row > Reject, filtrant les donnes dont le type ne correspond pas au type dfini. n/a
Limitation
Scnario : Extraire des champs partir dun fichier dlimit par des virgules
Ce scnario Java dcrit un Job trois composants o le composant tExtractdelimitedFields est utilis pour extraire deux colonnes partir dun fichier dlimit par des virgules. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tFileInputDelimited, le tExtractDelimitedFields et le tLogRow. Effectuez un clic-droit sur chacun des trois composants pour les connecter laide de liens Row Main.
Dans lespace graphique, slectionnez le composant tFileInputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileInputDelimited. Dans longlet Basic settings, dfinissez le champ Property Type en mode Built-In. Cliquez sur le bouton [...] ct du champ File Name pour dfinir le chemin daccs au fichier dentre.
1195
Dans ce scnario, on utilise le fichier dentre test5. Il sagit dun fichier texte dont certaines donnes sont spares par des virgules.
Dans longlet Basic settings, renseignez les autres champs. Pour plus dinformations, consultez le chapitre Proprits du tFileInputDelimited, page 886. Dans ce scnario, len-tte et le pied-de-page ne sont pas dfinis et aucune limite nest renseigne concernant le nombre de lignes traites. Cliquez sur Edit schema pour dcrire la structure des donnes du fichier dentre. Dans ce scnario, le schma est compos dune seule colonne, name.
Dans lespace graphique, slectionnez le composant tExtractDelimitedFields. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tExtractDelimitedFields.
1196
A partir de la liste droulante Field to split, slectionnez la colonne dissocier. Dans ce scnario, il sagit de la colonne name. Dans le champ Field separator, renseignez le sparateur de champs correspondant. Cliquez sur Edit schema pour dcrire la structure des donnes de ce composant de traitement. Dans le panneau de sortie de la bote de dialogue [Schema of tExtractRegexFields], cliquez sur le bouton [+] pour ajouter deux colonnes, firstname et lastname, au schma de sortie.
Dans ce scnario, on veut sparer la colonne name en deux colonnes dans le flux de sortie, firstname et lastname. Cliquez sur OK pour fermer la bote de dialogue [Schema of tExtractDelimitedFields]. Dans lespace graphique, slectionnez le composant tLogRow puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations, consultez le chapitre tLogRow, page 1095. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
1197
Les prnoms (firstname) et les noms (lastname) sont extraits et affichs sur la console dans leurs colonnes dfinies correspondantes.
1198
tExtractPositionalFields
Proprits du tExtractPositionalFields
Le composant tExtractPositionalFields gnre des colonnes multiples partir dune colonne donne en utilisant des champs positionnels. Le tExtractPositionalFields permet dextraire les donnes dun fichier positionnel selon un modle (pattern). Field Customize Slectionnez dans la liste le champ partir duquel effectuer lextraction. Cochez cette case pour personnaliser le format des donnes du fichier positionnel et renseignez les colonnes du tableau Formats. Column : Slectionnez la colonne que vous souhaitez personnaliser. Size : Saisissez la taille correspondant la colonne. Padding char : Saisissez entre guillemets le caractre de remplissage utilis afin quil soit supprim de votre champ. Le caractre par dfaut est un espace. Alignment : Slectionnez le paramtre dalignement appropri. Renseignez le modle utiliser pour lextraction. Un modle est constitu de valeurs de longueur spares par des virgules et interprtes comme une chane de caractres entre guillemets. Assurez-vous que les valeurs saisies dans ces champs correspondent au schma dfini. 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. 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.
Pattern
Die on error
1199
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. Advanced settings Advanced separator(for number) Trim Column Cochez cette option pour modifier les sparateurs utiliss pour les nombres. Cochez cette case afin de supprimer les espaces en dbut et en fin de champ, dans toutes les colonnes. Cochez cette case pour synchroniser chaque ligne avec le schma dentre. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Check each row structure against schema tStatCatcher Statistics Utilisation
Limitation
Scnario associ
Pour un scnario associ, consultez le chapitre tExtractRegexFields, page 1201.
1200
tExtractRegexFields
tExtractRegexFields
Proprits du tExtractRegexFields
Fonction Purpose Basic settings
Le composant tExtractRegexFields gnre des colonnes multiples partir dune colonne donne en utilisant des correspondances regex. Le tExtractRegexFields permet dutiliser des expressions rgulires pour extraire les donnes selon un modle. Field to split Regex Schema type et Edit Schema Slectionnez dans la liste le champ (ou colonne) sparer. Renseignez lexpression rgulire en fonction du langage de programmation que vous utilisez. 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. 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.
Advanced settings
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 synchroniser chaque ligne avec le schma dentre. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Check each row structure against schema tStatCatcher Statistics
1201
tExtractRegexFields
Utilisation
Limitation
Scnario : Extraire des noms, des domaines et domaines de premier niveau partir dadresses e-mail
Ce scnario Java dcrit un Job trois composants dans lequel le tExtractRegexFields est utilis pour dfinir une expression rgulire correspondant lune des colonnes des donnes dentre. Dans ce scnario, il sagit de la colonne email. Le composant tExtractRegexFields est galement utilis pour trouver les correspondances avec ladite expression rgulire. Cette expression comprend des identifieurs de champ permettant de sparer le nom dutilisateur, le nom de domaine ainsi que le nom du domaine de premier niveau pour chaque adresse e-mail. Si ladresse e-mail est valide, ces trois parties sont extraites et affiches sur la console dans trois colonnes diffrentes. Les donnes des deux autres colonnes dentre, id et age, sont galement extraites puis rediriges. A partir de la Palette, cliquez-dposez les composants suivants dans lespace graphique : le tFileInputDelimited, le tExtractRegexFields et le tLogRow. Connectez les trois composants laide de liens Row Main comme ci-dessous.
Dans lespace graphique, cliquez sur le composant tFileInputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileInputDelimited. A partir de longlet Basic settings, configurez le champ Property Type en mode Built-In. Cliquez sur le bouton [...] ct du champ File Name pour dfinir le chemin daccs au fichier dentre.
1202
tExtractRegexFields
Dans ce scnario, le fichier dentre utilis est test4. Il sagit dun fichier texte comportant trois colonnes : id, email et age. Renseignez tous les autres champs comme demand. Pour plus dinformations, consultez le chapitre Proprits du tFileInputDelimited, page 886. Dans ce scnario, len-tte et le pied-de-page ne sont pas dfinis et aucune limite nest renseigne concernant le nombre de lignes traites. Cliquez sur le bouton [...] du champ Edit schema pour dfinir la structure des donnes du fichier dentre. Dans ce scnario, le schma est compos de trois colonnes, id, email et age. Dans lespace graphique, slectionnez le composant tExtractRegexFields. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tExtractRegexFields. A partir de la liste droulante Field to split, slectionnez la colonne sparer, savoir email dans ce scnario. Dans le panneau Regex, renseignez lexpression rgulire utiliser pour effectuer la correspondance. Dans ce scnario, il sagit dune expression rgulire Java.
Cliquez sur Edit schema pour dcrire la structure des donnes du composant de traitement. Dans le panneau Output de la bote de dialogue [Schema of tExtractRegexFields], cliquez sur le bouton [+] pour ajouter cinq colonnes au schma de sortie.
1203
tExtractRegexFields
Dans ce scnario, on veut sparer la colonne dentre email en trois colonnes name, domain et tld dans le flux de sortie. Les deux autres colonnes dentre seront extraites telles quelles. Cliquez sur OK pour fermer la bote de dialogue [Schema of tExtractRegexFields]. Dans lespace graphique, slectionnez le composant tLogRow puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations, consultez le chapitre tLogRow, page 1095. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
Le composant tExtractRegexFields effectue une correspondance entre toutes les adresse e-mail donnes et lexpression rgulire dfinie, puis extrait le nom dutilisateur, le domaine et le domaine de premier niveau, quil affiche sur la console dans trois colonnes spares. Les deux autres colonnes, id et age, sont extraites telles quelles.
1204
tExtractXMLField
tExtractXMLField
tExtractXMLField appartient deux familles de composants : Processing et XML. Pour plus dinformations concernant le composant tExtractXMLField, consultez tExtractXMLField, page 1318.
1205
tFilterColumns
tFilterColumns
Proprits du tFilterColumns
Fonction
Le composant tFilterColumns opre des modifications spcifiques, tablies partir dun mapping du nom des colonnes, sur un schma dfini. Le tFilterColumns permet dhomogniser des schmas, soit en fonction de lordre des colonnes, soit en supprimant ou en ajoutant des colonnes. Schema type 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 dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Objectif
Basic settings
Utilisation
Ce composant nest pas un composant de dbut (fond vert) et il ncessite un composant de sortie.
Scnario associ
Pour plus dinformations concernant lutilisation du composant tFilterColumns, consultez le Scnario : Remplacement mutliple et filtrage de colonnes, page 1250 du composant tReplace.
1206
tFilterRow
tFilterRow
Proprits du tFilterRow
Le composant tFilterRow filtre des lignes dentre en dfinissant des conditions sur les colonnes slectionnes. Le composant tFilterRow aide paramtrer les filtres sur les donnes source. 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. Le schma est en lecture seule. 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. Logical operator used to combine conditions Conditions Si vous souhaitez utiliser les modes de filtrage simple et avanc la fois, slectionnez loprateur permettant de combiner les deux modes. Cliquez sur le bouton [+] pour ajouter autant de conditions que voulu. Les conditions sont excutes les unes aprs les autres pour chaque ligne. Input column : Slectionnez la colonne du schma sur laquelle excuter la fonction. Function : Slectionnez une fonction dans la liste. Operator : Slectionnez loprateur permettant de relier la colonne dentre et la valeur. Value : Renseignez la valeur filtre, entre guillemets si besoin est.
Use advanced mode Cochez cette case lorsque lopration effectuer ne peut aboutir grce aux fonctions standard proposes. Dans le champ texte, entrez lexpression rgulire comme demand. Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
1207
tFilterRow
Utilisation
Ce composant nest pas un composant de dbut (fond vert) et il ncessite un composant de sortie.
Scnario : Filtrer une liste de noms et faire une recherche dans la liste
Le scnario suivant permet de filtrer une liste de prnoms en fonction du genre des noms. Il effectue ensuite une liste des prnoms commenant par rom en utilisant une expression rgulire.
A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tFileInputDelimited, le tFilterRow et le tLogRow. Connectez le tFileInputDelimited au tFilterRow laide dun lien Row Main comme ci-dessus. Ensuite, connectez le tFilterRow au tLogRow, laide dun lien Row Filter. Dans lespace graphique, cliquez sur le composant tFileInputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileInputDelimited. Dans ce Job, les proprits et le schma sont en mode Built-in. Les informations ne seront donc pas rcupres partir des donnes stockes dans le Repository. Cliquez sur le bouton [...] ct du champ File Name pour dfinir le chemin daccs au fichier dentre.
Renseignez les sparateurs de lignes (Row Separator) et de champs (Field Separator). Le sparateur de lignes est constitu dun retour chariot et le sparateur de champs dune tabulation. Cliquez sur le bouton [...] du champ Edit schema pour dfinir la structure des donnes du fichier dentre. Dans ce scnario, le schma est compos de quatre colonnes : firstname, gender, language et frequency. Dans la colonne Type, slectionnez String pour les quatre lignes.
1208
tFilterRow
Cliquez sur OK pour valider et fermer lditeur. Une bote de dialogue souvre et vous demande si vous voulez propager les changements. Cliquez sur Yes (oui). A partir de longlet Advanced settings, slectionnez dans la liste le type dencodage (Encoding type) utiliser en fonction de votre fichier. Dans lespace graphique, cliquez sur le composant tFilterRow. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFilterRow. Slectionnez loption And comme oprateur logique (Logical operator used to combine conditions) dans ce scnario pour combiner les deux types de conditions (simple et avanc). Dans le tableau Conditions, renseignez les paramtres de filtrage par rapport la colonne gender.
Slectionnez loption gender dans la colonne InputColumn, Match dans la colonne Function, == dans la colonne Operator. Dans la colonne Value, entrez la valeur m entre guillemets pour filtrer uniquement les noms masculins. Cochez la case Use advanced mode pour implmenter une recherche sur les noms commenant par la syllabe puis entrez lexpression rgulire Java suivante qui comprend le nom de la colonne dans laquelle effectuer la recherche : input_row.firstname.matches("^rom.*")
1209
tFilterRow
Le composant tLogRow ne requiert aucun paramtrage particulier pour ce Job. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
Seuls les prnoms masculins commenant par la syllabe rom sont lists dans la console.
1210
tMap
tMap
Proprits du tMap
Le tMap est un composant avanc qui sintgre Talend Open Studio comme un plugin. Le tMap transforme et dirige les donnes partir dune ou plusieurs source(s) et vers une ou plusieurs destinations. Preview Laperu est un instantan des donnes du Mapper. Il nest visible que lorsque les proprits du Mapper sont renseignes. La synchronisation de laperu ne prend effet quaprs la sauvegarde des modifications. Auto : par dfaut, les liens sont en forme de courbes. Curves : les liens du mapping sont en forme de courbes. Lines : les liens du mapping sont en forme de lignes droites. Cette dernire option amliore lgrement les performances. Le Mapper est lditeur du tMap. Il vous permet de dfinir les proprits daiguillage et de transformation des donnes. Si vous ne souhaitez pas grer les erreurs dexcution, vous pouvez utiliser loption Die on error (coche par dfaut), en haut droite de lditeur. Cette option arrte le Job en cas derreur.
Mapping links display as
Map editor
Utilisation
Plusieurs utilisations sont possibles, de la simple rorganisation des champs de donnes aux transformations les plus complexes, telles que le multiplexage et le dmultiplexage de donnes, la concatnation, linversion, le filtrage, etc. Lutilisation du composant tMap requiert un niveau moyen de connaissances Perl ou Java afin dexploiter au mieux ses fonctionnalits. Ce composant est utilis comme une tape intermdiaire, cest pourquoi il ne peut pas tre utilis comme composant de dbut ou de fin de Job. Pour plus dinformations, consultez Mapping de flux de donnes du Guide utilisateur de Talend Open Studio.
Limitation
Scnario 1 : Mapping simple avec filtre et jointure explicite

Le Job Java ci-dessous a pour objectif de lire des donnes dun fichier stock dans le Repository, de rechercher des donnes dun fichier de rfrence distant puis dextraire des donnes de ces deux fichiers en fonction de filtres et denvoyer ces donnes vers le fichier de sortie et de rejet. Cliquez sur File dans la Palette de composants, slectionnez tFileInputDelimited et dposez-le dans lespace de modlisation. Changez le libell en Cars (vhicules), soit en double-cliquant sur le libell directement dans lespace de modlisation graphique, soit via longlet View de la vue Component.
1211
tMap
Rptez cette opration et renommez le second composant dentre en Owners (propritaires). Cliquez sur Processing dans la Palette de composants, slectionnez le tMap et dposez-le dans lespace de modlisation. Reliez les deux composants dentre, Owners et Cars au composant tMap et renommez les libells des connexions respectives.
Les Mtadonnes des fichiers dlimits Cars et Owners sont dfinies dans le gestionnaire Metadata du Repository. Ainsi vous pouvez leur assigner les proprits stockes dans le Repository dans la vue Component. Double-cliquez sur Cars pour paramtrer les proprits.
Slectionnez Repository dans les champs Property type et Schema type. Le reste des champs est automatiquement renseign lorsque vous slectionnez la mtadonne approprie dans la liste. Double-cliquez sur le composant Owners et dfinissez nouveau les proprits. Slectionnez la mtadonne approprie si elle existe. Sinon dfinissez manuellement chacune des proprits. Pour plus dinformations concernant la cration de mtadonnes dans le Repository, consultez Dfinition des schmas de mtadonnes du Guide utilisateur de Talend Open Studio. Puis double-cliquez sur le composant tMap pour ouvrir le Mapper. La zone Input (donnes en entre) est dj renseigne avec les schmas des composants dentre et la premire table correspond au flux principal (Main Row). Les libells de chacune des connexions dentre apparaissent en en-tte des tables. Crez une jointure entre les deux tables dentre en faisant simplement glisser le champ ID_Owner de la table principale vers le champ quivalent de la table de rfrence.
tMap
Dfinissez le lien en Inner Join en cochant la case correspondante. Cliquez sur le signe [+] dans la zone Output (sortie) du Mapper et ajoutez trois tables de sortie : Insured, Reject_NoInsur, Reject_OwnerID.
Glissez et dposez le contenu de la table principale dentre vers la premire table de sortie. Pour plus dinformations concernant le mapping de donnes, consultez Mapping de flux de donnes du Guide utilisateur de Talend Open Studio. Cliquez sur la flche dote dun [+] pour ajouter une ligne de filtre. La table Insured rassemble les donnes des tables Cars et Owners qui possdent un ID Insurance.
1213
tMap
Par consquent, glissez-dposez le champ ID_Insurance vers la zone de filtre qui vient dtre cre et saisissez la formule dexclusion des valeurs non dfinies suivante : owners_data.ID_Insurance = null La table Reject_NoInsur est un flux de rejet standard regroupant les donnes qui ne satisfont pas la condition de filtre dfinie. Cliquez sur la flche orange pour dfinir cette table comme table de rejet standard.
La troisime et dernire table est une table de rejets spcifiques pour les jointures Inner Join qui ne peuvent tre tablies. Il sagit par exemple du cas o un champ Owners_ID de la table Cars ne correspond aucune entre du fichier Owners. Cliquez sur la flche de couleur violette pour dfinir la dernire table comme table de rejet Inner Join. Cliquez sur OK pour valider et revenir lespace de modlisation.
1214
tMap
Ajoutez trois composants tFileOutputDelimited au Job et reliez-les au Job partir du composant tMap laide dun lien Row > Main. Rutilisez les trois libells dfinis prcdemment dans le mapper pour renommer vos connexions.
Puis double-cliquez sur chacun des composants de sortie afin de dfinir leur chemin daccs respectif. Si vous souhaitez crer un nouveau fichier, parcourez votre systme jusquau dossier de destination et saisissez le nom du fichier avec son extension. Cochez la case Include header pour rutiliser les libells des colonnes du schma dentre dans votre fichier de sortie.
Appuyez sur F6 pour excuter le Job ou passez longlet Run et cliquez sur le bouton Run. Les fichiers de sortie sont crs.
1215
tMap
Scnario 2 : Mapping avec rejet Inner join

Ce scnario, bas sur le scnario 1, requiert lajout dun fichier dentre, Resellers, contenant les informations sur les revendeurs, ainsi que lajout de champs supplmentaires dans le fichier de sortie principal. De plus, deux filtres sont ajouts sur les jointures Inner Join afin de rcuprer les rejets spcifiques. Cliquez sur File dans la Palette des composants et dposez un composant tFileInputDelimited dans lespace de modlisation graphique. Connectez ce nouveau composant au mapper et ajoutez un libell au composant et cette connexion : ici, Resellers.
Double-cliquez sur le composant Resellers pour dfinir les proprits dentre. Parcourez votre systme de fichier jusquau Resellers.csv. Editez le schma et ajoutez les colonnes pour reflter la structure du fichier dentre.
1216
tMap
Vous pouvez galement crer une mtadonne contenant la description de ce fichier et avoir la possibilit de rutiliser ses proprits et son schma en slectionnant Repository dans les champs adquats. Pour plus dinformations, consultez Configurer un schma File Delimited du Guide utilisateur de Talend Open Studio. Double-cliquez sur le composant tMap et vous remarquerez que le schma est automatiquement ajout la zone Input des schmas dentre.
Crez une jointure entre le flux dentre principal (Row Main) et lentre de rfrence (Lookup), Resellers. Cochez la case Inner Join pour dfinir le type de jointure cr. Glissez-dposez les champs de la table Resellers vers la table de sortie principale.
1217
tMap
Lorsque deux Inner Joins sont dfinis, vous devez soit dfinir deux tables de rejet inner join pour diffrencier les deux rejets, soit rassembler les deux rejets inner join dans une seule et mme table de sortie, sil ny a quune seule sortie.
Dans la zone de sortie Output, cliquez sur le signe [+] pour ajouter une nouvelle table de sortie. Donnez un nom cette nouvelle connexion, Reject_ResellerID Cliquez sur le bouton Inner Join Reject (flche violette) pour dfinir cette nouvelle sortie comme tant une table de rejet Inner Join. Glissez-dposez deux champs de la table dentre principale (Cars) dans cette nouvelle table. Par consquent, dans cet exemple, si la jointure Inner Join ne peut tre tablie pour une entre, les donnes (ID_Cars & ID_resellers) seront rejetes dans le fichier de sortie appropri et permettront didentifier rapidement le goulot dtranglement.
1218
tMap
Appliquez maintenant un filtre sur chacune des sorties de rejet Inner Join afin de distinguer les deux types de rejets. Dans la premire table de rejet (Reject_OwnerID), cliquez sur la flche dote dun signe [+] pour ajouter une ligne de filtre et renseignez ce champ avec la formule suivante pour ne recueillir que les rejets lis au champ OwnerID non dfini : Owners_data.ID_Owner==null Dans la seconde table de rejet Inner Join (Reject_ResellerID), renouvelez lopration et utilisez la formule suivante : Resellers_data.ID_Reseller==null
Cliquez sur Apply pour enregistrer les changements, puis sur OK pour fermer le Mapper. Cliquez-droit sur le composant tMap, cliquez sur Row et slectionnez Reject_ResellerID dans la liste. Connectez le flux principal du Mapper au composant de sortie Reseller.
Dans ce scnario, retirez du fichier Resellers.csv les lignes correspondant aux Reseller ID 5 et 8. Excutez le Job via la touche F6 du clavier, ou partir de la vue Run.
tMap
Les quatre fichiers de sortie sont tous crs dans le dossier dfini dans les proprits de la vue Component. Remarquez que dans le fichier de rejet li lInner Join, NoResellerID.csv, le champ ID_Owners correspond aux entres du fichier Cars dont le Reseller ID est gal 5 et 8 tel que dfini prcdemment.
Scnario 3 : Mapping de jointure en cascade

Un troisime scnario plus avanc et bas sur le scnario 2 requiert lajout dune nouvelle entre contenant les informations dassurance, par exemple.
1220
tMap
Dans le Mapper, mettez en place une jointure Inner Join entre deux tables de rfrence (Lookup) des flux secondaires Owners et Insurance afin de grer les rfrences en cascade et par consquent de rcuprer les informations de la table Insurance via les donnes de la table Owners.
Scnario 4 : Mapping avanc avec filtres, jointures explicites et rejet Inner join
Ce scnario prsente un Job utilisant le tMap et permettant de trouver les clients potentiels dun Reseller (revendeur). Ces clients doivent tre propritaires dune marque dfinie et avoir entre 2 et 6 enfants (inclus) dans un but de vente incitative.
Cliquez-dposez les composants suivants de la Palette : tFileInputDelimited (x3), tMap, tFileOutputDelimited (x2) Connectez les composants dentre au tMap laide de connexions de type Main row. Faites attention au premier composant que vous connectez car son flux de donnes sera automatiquement un flux Main (principal). Et toutes les autres connexions seront alors de type Lookup (flux de rfrence). Dfinissez les proprits de chaque composant dentre dans longlet Basic settings. Par exemple, slectionnez le chemin daccs au fichier Resellers utilis comme flux principal dans votre Job.
1221
tMap
Slectionnez le fichier dlimit utiliser, les sparateurs de lignes et de champs (Row et Field Separator), les lignes den-tte (Header) et de bas de page (Footer), si ncessaire. Cliquez sur Edit Schema, si le schma nest pas stock dans le Repository. Vous retrouverez ce schma dans la table principale en haut de la zone dentre Input du Mapper. Rptez ces tapes pour les autres composants dentre : Cars et Owners. Ces deux flux de rfrence (Lookup) renseigneront les tables secondaires (lookup) de la zone dentre du Mapper. Cliquez sur le composant tMap pour ouvrir le Mapper et dfinir le mapping et les filtres.
Tout dabord, configurez les jointures explicites entre le flux Main et le flux Lookup. Dun simple glisser-dposer, dplacez la colonne ID_Resellers vers les colonnes correspondantes puis renseignez le champ Expression key dans la table Lookup.
1222
tMap
La jointure explicite apparat en couleur tout comme la cl de hachage. Puis dans le champ Expr. Key de la colonne Make (Marque), saisissez (en Java) le filtre appliquer. Dans ce cas dutilisation, saisissez simplement BMW puisque ce qui est recherch ce sont les propritaires (Owners) de cette marque en particulier. Effectuez une jointure en cascade entre les deux tables de rfrence Cars et Owners, afin de retrouver les informations sur les propritaires et plus prcisment le nombre denfants quils ont.
Dun simple glisser-dposer, dplacez la colonne ID_Owners de la table Cars vers le champ Expr. Key de la colonne id_owner de la table Owners. Cliquez sur le bouton Filter prs de la case Inner Join pour afficher la zone de saisie du Filtre.
1223
tMap
Saisissez la dclaration de Filtre pour rduire le nombre de lignes prises en compte dans le flux Lookup. Dans cet exemple, la dclaration est la suivante : Owners.Children_Nr > 1 && Owners.Children_Nr < 6 Et comme vous souhaitez exclure les valeurs nulles du flux de sortie principal et les traiter dans une table diffrente, cochez la case Inner Join pour chaque table Lookup filtrer.
Dans lInner join, vous pouvez ensuite slectionner une des options suivantes : Unique match, First match, Last match ou All Matches. Dans cet exemple, slectionnez loption All matches. Ainsi, si plusieurs correspondances sont trouves dans lInner Join (i.e. les lignes rpondant la jointure explicite ainsi quau filtre), elles seront toutes prises en compte dans le flux de sortie (soit dans le flux de rejet, soit dans le flux de sortie standard). Puis dans la zone Output du Mapper, ajoutez deux tables : une pour les correspondances rpondant la jointure explicite et au filtre et une pour les rejets. Cliquez sur le bouton [+] pour ajouter des tables et donnez un nom aux flux de sortie.
1224
tMap
Glissez-dposez les donnes des tables Main et Lookup de la zone Input vers les tables de sortie respectives, suivant le type dinformations que vous souhaitez obtenir. Dans la table de rejet utilise pour diriger les donnes ne rpondant pas ni la jointure externe ni au filtre, cliquez sur le bouton Inner Join Reject (flche violette) pour lactiver. Dans lditeur graphique, cliquez droit sur le tMap et crez une connexion de sortie vers le composant correspondant. Dfinissez les paramtres des composants de sortie dans longlet Basic settings.
Dfinissez le chemin daccs, les sparateurs de lignes (Row) et de champs (Field), si ncessaire. Et pour cet exemple, cochez la case Include Header. Le Schma devrait se propager automatiquement laide du Mapper. Enregistrez votre Job, puis cliquez sur longlet Run et cochez la case Statistics pour suivre lexcution du Job.
1225
tMap
Les statistiques montrent que plusieurs correspondances ont t trouves et ainsi la somme des lignes de sortie (Main + Rejet) est suprieure au nombre de lignes du flux dentre principal.
Scnario 5 : Mapping avanc avec filtres et vrification des lignes

Ce scnario est une version modifie du scnario prcdent. Il dcrit un Job qui applique des filtres et vrifie chaque ligne dune entre de rfrence.
Reprenez le Job du Scnario 4 : Mapping avanc avec filtres, jointures explicites et rejet Inner join, page 1221. Aucune modification na t apporte aux fichiers Input delimited. Lancez le Mapper pour modifier le mapping et les filtres.
1226
tMap
Supprimez toutes les jointures explicites entre la table principale et la table de rfrence, Cars. Notez que loption All Matches se change automatiquement en All Rows. En fait, comme aucune jointure explicite nest dclare (il ny a pas de cl de hachage), toutes les lignes du flux de rfrence doivent tre prises en compte et vrifies en fonction des lignes du flux principal. Supprimez le filtre (BMW) du champ Expr. key de la table Cars.
Et cliquez sur le bouton Filter pour afficher la zone de saisie du filtre. Puis saisissez le nouveau filtre pour rduire la recherche aux marques BMW ou Mercedes. La dclaration du filtre est la suivante : Cars.Make.equals("BMW") || Cars.Make.equals("Mercedes") Le filtre appliqu sur la table de rfrence Owners ne change pas par rapport au scnario prcdent. Dfinissez les nouveaux chemins daccs pour les flux de sortie respectifs. Enregistrez le Job et activez les Statistiques dans longlet Run avant dexcuter le Job.
1227
tMap
Les Statistiques montrent quun produit cartsien a t effectu entre les lignes du flux principal avec les lignes filtres du flux de rfrence.
Le contenu du flux de sortie principal montre que les lignes filtres sont bien passes.
Alors que le rsultat des rejets met en vidence les lignes qui ne correspondent aucun des filtres.
1228
tMap
Scnario 6 : Mapping avanc avec rechargement de la base de rfrence chaque ligne

Le scnario suivant dcrit un Job permettant de rcuprer certaines informations sur des personnes dans une base de donnes de rfrence, en se basant sur une jointure effectue sur leur ge. Le flux principal des donnes source est lu partir dune table Mysql appele people_age contenant certains dtails sur les personnes, comme leur identifiant (numrique), leur nom et prnom (alphanumrique) ainsi que leur ge (numrique), qui peut tre soit 40, soit 60 ans. On a intentionnellement rduit le nombre dentres de cette table. Les informations de rfrence sont galement stockes dans une table Mysql appele large_data_volume. Cette table de rfrence contient un certain nombre dentres, dont le nom des villes dans lesquelles les personnes enregistres dans la table principale sont alles. Le nombre dentres a t restreint pour plus de clart mais, dans le cas dune utilisation normale, le Job ci-dessous a des rsultats plus significatifs quand on traite un gros volume de donnes de rfrence. Pour optimiser les performances, un composant de connexion aux bases de donnes est utilis au dbut de ce Job pour ouvrir une connexion la base de donnes de rfrence afin de ne pas ouvrir et refermer une connexion chaque ligne de la table de rfrence charge. Un filtre dexpression (expression filter) est appliqu ce flux de rfrence, qui permet de ne slectionner que les donnes des personnes dont lge est 60 ou 40 ans. Ainsi, seules les lignes pertinentes de la table de rfrence sont enregistres pour chaque ligne du flux principal. Ce Job prsente donc comment, partir dun nombre limit de lignes de flux principal, on peut optimiser la base de donnes de rfrence pour nenregistrer que les rsultats correspondant la cl dexpression (expression key).
En gnral, comme le chargement des rfrences seffectue pour chacune des lignes de flux principal, il est plus intressant dutiliser cette option quand on ne traite quun nombre limit de lignes de flux principal et un grand nombre de lignes de rfrence.
La jointure seffectue au niveau du champ age. Les informations de la base de rfrence sont ensuite charges pour chacune des lignes du flux principal en entre, en utilisant loption de chargement approprie dans lditeur du composant tMap.
1229
tMap
Dans cet exemple, les mtadonnes ont t prpares pour le composant de connexion et les composants source. Pour plus dinformations sur les mtadonnes de connexion aux bases de donnes et les mtadonnes de cration de schmas des tables, consultez la section ddie au sujet dans le Guide Utilisateur de Talend Open Studio. Le Job est form de cinq composants, quatre composants de bases de donnes et un composant de mapping. A partir du noeud Metadata > Db Connections dans le Repository, glissez le schma de base de donnes dans lditeur graphique. Dans cet exemple, la table source sappelle people_age. Lorsque vous dposez le composant, une liste apparat lcran : slectionnez le composant tMySQLInput.
Dposez le schma de base de donne de rfrence partir du noeud Metadata > Db Connections. Dans cet exemple, la table de rfrence sappelle large_data_volume. De la mme manire, glissez une connexion la base de donnes du noeud Db Connections dans le Repository dans lditeur graphique. Dans la bote de dialogue [Components], slectionnez le composant tMysqlConnection. Ce composant cre une connexion permanente la base de donnes de rfrence afin dviter que la connexion ne se referme au chargement que chaque ligne de rfrence. A partir de la Palette situe droite dans lditeur graphique, cliquez-dposez le connecteur tMap (famille Processing) et le composant tMySQLOutput (famille Database).
1230
tMap
Reliez maintenant tous les composants entre eux : faites un clic-droit sur le tMySQLInput correspondant la table people et maintenez le bouton enfonc tout en dplaant le curseur jusquau tMap. Relchez le bouton lorsque vous tes sur le tMap, le flux principal de lignes est cr automatiquement. Renommez le lien de type Main en people, pour pouvoir identifier plus facilement le flux de donnes principal. Effectuez la mme opration pour connecter la table de rfrence (large_data_volume) au tMap et le tMap au tMySQLOutput. Une bote de dialogue apparat et vous devez donner un nom au lien de sortie. Dans cet exemple, le flux de sortie sappelle people_mixandmatch. Renommez galement le lien de connexion la base de rfrence en large_volume pour pouvoir identifier plus facilement le flux de donnes. Connectez le tMysqlCOnnection au tMysqlInput via un lien de type OnSubjobOk. Double-cliquez ensuite sur le composant tMap pour ouvrir lditeur graphique de mapping.
La table Output (qui sest cre automatiquement quand vous avez li le tMap au tMySQLOutput) sera compose des lignes concordantes du flux de rfrence (large_data_volume) et du flux principal (people_age). Slectionnez les lignes du flux principal que vous voulez passer en sortie et faites les glisser vers la table Output (dans le coin suprieur droit de lditeur de mapping) : ils y seront copis.
1231
tMap
Dans cet exemple, la slection des lignes du flux principal inclut les champs suivants : id, first_name, last_Name et age. Dans la table de rfrence, la colonne city est slectionne. Faites glisser les colonnes slectionnes des tables dentre (people et large_volume) vers la table de sortie. Crez maintenant la jointure entre le flux principal et le flux de rfrence. Slectionnez la colonne age dans la table du flux principal (en haut) et faites-la glisser vers la colonne age de la table du flux de rfrence (large_volume dans cet exemple). Licne dune cl apparat ct de lexpression lie dans la table de rfrence. La jointure est maintenant tablie. Slectionnez maintenant loption Reload at each row pour que la base de rfrence soit charge nouveau pour chaque nouvelle ligne traite.
Cliquez sur la flche verte pour afficher le menu et slectionner les options voulues. Dans cet exemple vous devez galement slectionner loption All matches dans la table de rfrence pour rcuprer dans le flux de sortie toutes les occurrences de age qui correspondent. Implmentez ensuite le filtre, tabli partir de la colonne age, dans la table de rfrence. Le champ GlobalMapKey est cr automatiquement lorsque vous slectionnez loption Reload at each row. Vous pouvez donc utiliser cette expression pour filtrer les donnes de rfrence de manire dynamique, pour que seules les informations pertinentes soient charges avec le flux principal. Comme la soulign lintroduction de ce scnario, le flux de donnes principal contient uniquement les personnes dont lge vaut 40 ou 60. Pour viter de charger toutes les lignes de la table de rfrence, dont les ges sont diffrents de 40 et 60, vous pouvez utiliser la valeur ge du flux principal comme variable globale pour alimenter le filtre de rfrence.
1232
tMap
Glissez la colonne Age de la table de flux principal vers le champ Expr. dans la table de rfrence. Renseignez ensuite le nom de la variable dans le champ globalMap Key, en utilisant une expression. Dans cet exemple, lexpression est : people.Age. Cliquez sur le bouton OK pour enregistrer les paramtres de mapping et retourner dans lditeur graphique. Pour terminer limplmentation du filtrage dynamique du flux de rfrence, vous devez maintenant ajouter une clause where la requte de la base de donnes dentre.
A la fin du champ Query, juste aprs la commande Select, entrez la clause de type where suivante : WHERE AGE = " + ((Integer)globalMap.get("people.Age")). Assurez-vous que le type correspond la colonne utilise comme variable. Dans cet exemple, la donne Age est du type Integer. Veillez aussi utiliser la variable de la manire dont vous lavez paramtre dans le champ globalMap key de lditeur de mapping.
tMap
Double-cliquez ensuite sur le composant tMySQLoutput et vrifiez que le schma correspond aux paramtres de mapping. Tout est maintenant prt pour lexcution du Job. Cliquez sur longlet Run, situ en bas de lditeur graphique, pour afficher la vue dexcution du Job.
Avant dexcuter le Job, slectionnez loption Traces pour observer lavance du traitement des donnes. Assurez-vous que les types de donnes sont respects (string, integer...) pour viter les erreurs dexcution. Appuyez ensuite sur la touche F6 ou cliquez sur le bouton Run pour excuter le Job. Pour une meilleure visibilit, il est possible dagrandir la vue du Job dans lditeur graphique lors de lexcution en double-cliquant simplement sur longlet portant le nom du Job.
Les donnes de rfrence sont charges nouveau pour chaque ligne du flux principal qui correspond la contrainte dge. Toutes les correspondances la condition age sont rcupres partir des lignes de la table de rfrence et regroupes dans le flux de sortie. Si vous vrifiez les donnes contenues dans la table people_mixandmatch nouvellement cre, vous y trouverez toutes les copies bases sur age correspondant aux diffrentes personnes dont lge vaut 40 ou 60, ainsi que les villes o ils sont alls.
tMap
Scnario 7 : Mapping avec des tables de sortie

Le scnario suivant dcrit un Job traitant des flux de rejet sans les sparer du flux principal.
Dans la vue Repository, cliquez sur Metadata > File delimited. Glissez-dposez la mtadonne customers dans lespace de modlisation graphique. Pour plus dinformations concernant la centralisation des mtadonnes, consultez Dfinition des schmas de mtadonnes, page 125 du Guide Utilisateur Talend Open Studio. La mtadonne customers contient des informations relatives aux clients, comme leur ID, leur nom, leur adresse... Une bote de dialogue souvre et vous demande de choisir le type de composant que vous souhaitez utiliser.Slectionnez le composant tFileInputDelimited et cliquez sur OK.
tMap
Ensuite, glissez-dposez la mtadonne states. Slectionnez le mme composant dans la bote de dialogue, et cliquez sur OK. La mtadonne states contient lidentifiant de ltat, ainsi que son nom. Glissez-dposez de la Palette un tMap et deux composants tLogRow. Reliez le composant customers au tMap laide dun lien Row Main. Reliez le composant states au tMap, en utilisant un lien Row Main. Il sera automatiquement dfini comme Lookup. Double-cliquez sur le composant tMap. Glissez-dposez la colonne idState dans la premire ligne de la seconde table, afin de crer une jointure. Dslectionnez la case Die on error si vous souhaitez grer les erreurs dexcution. La table ErrorReject est maintenant cre. Cliquez quatre fois sur le bouton [+] en haut droite de lditeur, afin dajouter quatre colonnes. Slectionnez les colonnes dentre id, idState, RegTime puis glissez et dposez-les dans les quatre nouvelles colonnes vides.
Cliquez sur le bouton [+] en haut droite de lditeur afin dajouter une table de sortie. Dans la bote de dialogue qui souvre, slectionnez New output. Dans le champ correspondant, saisissez le nom de la table, out1. Cliquez sur OK. Ensuite, glissez-dposez les quatre colonnes suivantes de la table dentre dans la table out1 : id, CustomerName, CustomerAddress, et idState. Ajoutez deux colonnes RegTime et RegisterTime avec un format Date, en cliquant deux fois sur le bouton [+]. Cliquez sur la premire, et appuyez sur Ctrl+Espace pour afficher la liste dautocompltion. Slectionnez TalendDate.parseDate. Changez le modle en ("dd/MM/yyyy HH:mm",row1.RegTime). Rptez lopration pour la seconde colonne, mais changez le modle en ("yyyy-MM-dd HH:mm:ss.SSS",row1.RegisterTime).
1236
tMap
Ensuite, cliquez sur le bouton [+] en haut droite de lditeur, afin dajouter une table de sortie. Dans la bote de dialogue qui souvre, slectionnez Create join table from, choisissez Out1, et donnez le nom rejectInner. Cliquez sur OK. Cliquez sur la flche violette pour grer les rejets. Cliquez sur la colonne LabelState, et appelez-la UNKNOWN. Dans la colonne RegTime, appuyez sur Ctrl+Espace, et slectionnez TalendDate.parseDate. Changez le modle en ("dd/MM/yyyy HH:mm",row1.RegTime.) Dans la colonne RegisterTime, appuyez sur Ctrl+Espace, et slectionnez TalendDate.parseDate, mais changez le modle en ("yyyy-MM-dd HH:mm:ss.SSS",row1.RegisterTime). SI les donnes de la ligne row1 a un modle incorrect, elles seront retournes par le flux ErrorReject. Cliquez sur OK afin de valider les modifications et fermer lditeur. Double-cliquez sur le composant tLogRow afin dafficher sa vue Component. Dans la zone Mode, slectionnez Table. Rptez lopration avec le second tLogRow. Ensuite, sauvegardez votre Job et appuyez sur F6 pour lexcuter.
1237
tMap
La Console affiche les flux principaux et de rejet, traits par le composant tMap, et unifis en un mme flux de sortie.
1238
tNormalize
tNormalize
Proprits du tNormalize
Famille de composant Processing/Fields
Le composant tNormalize normalise un flux entrant en fonction du standard SQL. Le tNormalize permet damliorer la qualit de donnes et donc facilite la mise jour des donnes. Schema type 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. Pour ce composant, le schma est en lecture seule. 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. Column to normalize Item separator Slectionnez la colonne du flux entrant sur laquelle est bas la normalisation. Renseignez le sparateur dlimitant les donnes du flux entrant.
Advanced settings Get rid of duplicated Cochez cette case pour supprimer les lignes rows from output doublons du flux de sortie. Java uniquement Use CSV parameters Java uniquement Cochez cette case pour prendre en compte les paramtres spcifiques aux fichiers CSV, notamment la manire de protger les caractres dans le champ escape mode et le type de guillemet dans le champ enclosure. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant est gnralement utilis comme composant intermdiaire dans un flux de donnes. n/a
Scnario : Normaliser des donnes

Ce scnario illustre un Job qui normalise une liste de mots-cls des sujets dun forum puis les transmet sous forme de tableau dans la console de la vue Run.
1239
tNormalize
Cliquez et dposez les composants suivants dans lespace de modlisation : tFileInputDelimited, tNormalize, tLogRow. Dans longlet Basic settings du composant tFileInputDelimited, slectionnez le fichier normaliser.
Le schma du fichier est stock dans le Repository. Il est compos dune colonne, appele Tags, et chaque ligne possde un ou plusieurs mots-cls. Dans les champs Row Separator et Field Separator, renseignez les sparateurs de lignes et de champs.
Dans longlet Basic settings du composant tNormalize, dans la liste Column to normalize, slectionnez la colonne sur laquelle la normalisation est base. Dans ce scnario, la colonne normaliser est Tags.
1240
tNormalize
Dans le champ Item separator, renseignez le sparateur de donnes, ici la virgule, que vous devez saisir entre guillemets. Dans les proprits du composant tLogRow, slectionnez le mode Table (print values in the cells of table). Enregistrez le Job et excutez-le, en appuyant sur F6.
Les valeurs sont normalises et affiches dans un tableau dans la console.
1241
tPerl
tPerl
Proprits du tPerl
Le tPerl transforme nimporte quelle donne saisie en code Perl. Le tPerl est un diteur (Perl) et aussi un outil trs flexible dans le Job. Code Saisissez le code Perl en fonction de la commande ou de la tche que vous souhaitez excuter. Pour plus dinformations concernant la syntaxe des fonctions Perl, consultez laide en ligne de Talend Open Studio dans le menu Talend Open Studio > User Guide > Perl.
Ce composant est gnralement utilis pour dbogger une erreur mais peut aussi tre utlis pour afficher le contenu dune variable. Ce composant est ddi aux utilisateurs Perl avancs et ne doit pas tre utilis avec un lien de type Row Main car il est destin tre utilis seul.
Scnario : Afficher le nombre de lignes traites

Ce scnario est un Job trois composants qui affiche dans la console de log le nombre de lignes traites et passes en sortie dans un fichier XML.
A partir de la Palette, cliquez-dposez les trois composants suivants dans lditeur graphique : le tFileInputDelimited, le tFileOutputExcel et le tPerl. Cliquez-droit sur le tFileInputDelimited et connectez-le au tFileOutputExcel laide dun lien de type Row Main. Cliquez-droit nouveau sur le tFileInputDelimited et reliez-le au tPerl laide dun lien Trigger > OnSubjobOk. Ce lien signifie que, comme lindique la flche, le premier composant (tFileDelimited) sexcutera avant le second (tPerl).
1242
tPerl
Cliquez une fois sur le tFileInputDelimited et slectionnez longlet Basic settings de la vue Component pour dfinir les proprits du composant.
Les proprits (Properties) ne sont pas rutilises pour ou partir dun Job stock dans le Repository, elles sont au contraire utilises pour ce Job uniquement. Par consquent, slectionnez loption Built-In dans la liste droulante du champ Property Type. Renseignez le chemin daccs au fichier contenant les donnes traiter ou parcourez vos dossiers jusqu celui-ci. Dans cet exemple, le fichier texte comprend une liste de noms associe aux adresses email correspondantes. Dfinissez les sparateurs de ligne (Row) et de champ (Field). Dans ce scnario, chaque ligne comprend un nom et son adresse email associe. Les champs sont spars par des points-virgules. La premire ligne du fichier contient le nom des colonnes, elle doit donc tre ignore dans ce Job. La valeur de len-tte (champ Header) est alors de 1. Il nest pas ncessaire de dfinir un pied-de-page (Footer) ou une valeur maximale (Limit) pour ce scnario. Le champ Schema type est galement dfini en mode Built-in dans cet exemple. Cliquez sur Edit Schema pour dcrire le contenu du fichier dentre. Dans ce scnario, il existe deux colonnes appeles Name et Emails contenant des chanes de caractres (String) dont la longueur nest pas dfinie. La clef est porte par le champ Email. Slectionnez le composant tFileOutputExcel et dfinissez-en les paramtres en fonction de vos besoins. Slectionnez le chemin daccs au fichier de sortie, appel Sheet, puis synchronisez le schma. Dfinissez ensuite le sous-Job tPerl de manire rcuprer le nombre de lignes transfres au fichier XML en sortie.
1243
tPerl
Entrez la commande Perl print pour afficher la variable relative au nombre de lignes lues dans le tFileInputDelimited. Pour accder la liste des variables disponibles, appuyez sur Ctrl+Espace puis slectionnez la variable adquate partir de la liste. Pour une meilleure lisibilit de la console de log Run Job, ajoutez le signe gal avant et aprs la commande. Notez que les commandes, les chanes de caractres et les variables apparaissent dans des couleurs diffrentes. Passez la vue Run Job et excutez le Job. Le Job sexcute normalement et cre un fichier XML en sortie qui correspond au schma deux colonnes ayant t dfini : Name et Email.
Le rsultat de la commande Perl apparat dans la console de log du Job.
1244
tPivotToRows
tPivotToRows
Proprits du tPivotToRows
Fonction Objectif
Le composant tPivotToRows transforme des colonnes en lignes. Le composant tPivotToRows permet de choisir une liste de colonnes du flux entrant pour en fournir l'quivalent sous forme de lignes dans le flux sortant. Schema type 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. 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. Row keys Slectionnez la liste des colonnes du schma dentre que vous voulez afficher sous forme de ligne unique. Les colonnes non slectionnes constitueront le pivot. Cliquez sur le bouton [+] pour ajouter autant de lignes que de colonnes concatner. Dans le champ Input column de chaque ligne, slectionnez le nom des colonnes choisies. Dterminez le sparateur des valeurs concatnes.
Basic settings
Row key concatenate delimiter Advanced settings Utilisation tStatCatcher Statistics
Ce composant est gnralement utilis comme composant intermdiaire dans un flux de donnes, il ncessite donc un composant en entre et un composant en sortie.
1245
tPivotToRows
Scnario : Concatner une liste de colonnes partir dune table en utilisant les autres colonnes comme pivot
Le scnario suivant est un Job Perl quatre composants permettant de concatner sur une mme ligne les informations de plusieurs colonnes dune table, en utilisant les autres colonnes comme pivot.
A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tFileInputDelimited, le tPivotToRows et deux tLogRow. Connectez les quatre composants laide de liens Row Main comme ci-dessus. Dans lespace graphique, cliquez sur le composant tFileInputDelimited. Cliquez sur la vue Component pour configurer les paramtres de base (Basic settings) du tFileInputDelimited.
Dans le champ Property Type, slectionnez le mode Repository si vous avez stock les informations du fichier dlimit sous le noeud Metadata du Repository ou slectionnez le mode Built-In pour les dfinir manuellement. Dans ce scnario, on utilise le mode Built-In. Renseignez le chemin daccs au fichier traiter dans le champ File Name. Dans cet exemple, on utilise le fichier use_case_tunpivotrow, qui comporte huit colonnes : id, CustomerName, CustomerAddress, id2 et RegisterTime qui sont destines tre concatnes, ainsi que Sum1, Sum2 et Sum3 qui serviront de pivot. Dfinissez si ncessaire les sparateurs de lignes (Row separator) et de champs (Field separator), len-tte (Header) et le pied-de-page (Footer), ainsi que le nombre de lignes traiter (Limit). La premire ligne, qui porte le nom des colonnes, est ignore dans cet exemple, cest pourquoi le champ Header est dfini 1.
tPivotToRows
Dans le champ Schema, slectionnez le mode Built in puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes passer au composant suivant. Dans cet exemple, le schma est constitu des huit colonnes du fichier dentre use_case_tunpivotrow.
Dans lespace graphique, cliquez sur le composant tPivotToRows. Cliquez sur la vue Component pour configurer les paramtres de base (Basic settings) du tPivotToRows. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] cot du champ Edit schema pour consulter le schma. Cliquez sur le bouton [+] pour insrer dans la zone Row keys autant de lignes quil y a de colonnes concatner. Dans cet exemple, on a ajout cinq lignes.
A partir de la liste droulante du champ Input column, slectionnez pour chaque ligne lintitul de la colonne concatner. Les colonnes du schma dentre qui ne seront pas slectionnes serviront de pivot. Dans cet exemple, les colonnes id, CustomerName, CustomerAddress, id2 et RegisterTime sont slectionnes pour la concatnation alors que les colonnes Sum1, Sum2 et Sum3 sont laisses de ct pour servir de pivot.
1247
tPivotToRows
Dans le champ Row key concatenate delimiter, dfinissez un caractre pour sparer les donnes des diffrentes colonnes une fois la concatnation acheve. Cliquez sur un des composants tLogRow puis cliquez sur la vue Component pour configurer leurs paramtres de base (Basic settings).
Choisissez le mode Table pour visualiser le fichier de dpart et le rsultat du tPivotToRows au mme format et ainsi pouvoir les comparer. Utilisez les mmes paramtres pour le second composant tLogRow. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
La console de log prsente les rsultats des deux composants tLogRow. Le tableau tLogRow_1 donne un aperu du fichier de dpart et le tableau tLogRow_2 montre la concatnation des colonnes id, CustomerName, CustomerAddress, id2 et RegisterTime ainsi que la transformation des colonnes Sum1, Sum2 et Sum3 en pivot.
1248
tReplace
tReplace
Proprits du tReplace
Le composant tReplace effectue un Rechercher/Remplacer dans les colonnes dentre spcifies. Ce composant permet de nettoyer tous les fichiers avant traitement. Schema type 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 automatiquement ajoutes 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 rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Simple Mode Search / Replace Cliquez sur le bouton [+] pour ajouter autant de conditions que vous le souhaitez. Les conditions sont excutes lune aprs lautre pour chaque ligne. Input column : Slectionnez la colonne du schma sur laquelle effectuer le Rechercher/Remplacer. Search : Saisissez la valeur chercher dans la colonne dentre. Replace with : Saisissez la valeur de remplacement. Whole word : Cochez cette case si la valeur recherche constitue un mot entier. Case sensitive : Cochez cette case pour tenir compte de la casse. Notez que vous ne pouvez pas utiliser dexpression rgulire dans ces colonnes.
Use advanced mode Cochez cette case si vous souhaitez utiliser des expressions rgulires. Ce composant nest pas un composant de dbut puisquil requiert un flux de donnes. Il requiert aussi un composant de sortie.
1249
tReplace
Scnario : Remplacement mutliple et filtrage de colonnes

Le Job suivant recherche et remplace diffrentes coquilles et fautes dans un fichier .CSV puis filtre une colonne avant de gnrer en sortie un nouveau fichier .CSV contenant les donnes modifies.
Cliquez et dposez les composants suivants dans lespace de modlisation : tFileInputDelimited, tReplace, tFilterColumn et tFileOutputDelimited. Connectez les composants laide de liens de type Main Row via un clic-droit sur chaque composant. Slectionnez le composant tFileInputDelimited et paramtrez les proprits du flux dentre.
Dans la liste droulante Property type, slectionnez loption Built-in. Puis renseignez manuellement les champs suivants. Si les proprits sont centralises dans le Repository, choisissez loption Repository et les champs seront automatiquement remplis. Le Fichier est un simple fichier .csv stock localement. Ainsi, dans le champ Filepath, renseignez le chemin daccs au fichier. Dans le champ Row Separator, renseignez le sparateur de lignes, ici le retour chariot. Dans le champ Field Separator, renseignez le sparateur de champs, ici un point virgule. Dans cet exemple, il ny a pas den-tte (Header), de pied de page (Footer) ou de nombre limite de lignes traiter (Limit). Le fichier contient des caractres tels que : \t, |||, [d] ou *d qui ne devraient pas tre interprts comme des caractres spciaux ou comme des caractres gnriques.
1250
tReplace
Dans le champ Schema, slectionnez aussi loption Built-in. Le schma est compos de quatre colonnes de diffrents types : chanes de caractres (string) ou entier (int). Slectionnez le composant tReplace pour paramtrer les proprits des Rechercher/Remplacer.
Le schma peut tre synchronis partir du flux dentre. Cochez la case Simple mode car les paramtres de recherche peuvent tre facilement dfinis sans avoir recours aux expressions rgulires. Cliquez sur le signe [+] pour ajouter des lignes aux tableaux des paramtres. En premier paramtre, slectionnez amount dans la colonne Input column. Dans la colonne Search, cherchez tous les points et dans la colonne Replace indiquez la valeur de remplacement, ici la virgule. Les valeurs doivent tre mises entre guillemets. En deuxime paramtre, slectionnez str dans la colonne Input column. Dans la colonne Search, cherchez les chanes de caractres stret ou streat ou stre. Notez que ces valeurs sont spares par une barre verticale qui signifie OU et qui quivaut au or en langage Perl. Dans la colonne Replace, renseignez la valeur de remplacement, ici Street. Cochez la case whole word. En troisime paramtre, slectionnez nouveau str dans la colonne Input column. Dans la colonne Search, cherchez les barres verticales en mettant une barre oblique inverse devant pour viter de la confondre avec le or en langage Perl. Et dans la colonne Replace, ne mettez rien entre les guillemets.
tReplace
En quatrime paramtre, slectionnez firstname dans la colonne Input column. Dans le champ Search, cherchez les caractres suivants : [, ], +, *. Notez que ces valeurs sont spares par une barre verticale qui signifie OU et qui est quivaut au or en langage Perl. Et dans la colonne Replace, ne mettez rien entre les guillemets. En cinquime paramtre, slectionnez amount dans la colonne Input column. Dans le champ Search, saisissez le signe du dollar entre guillemets simples et dans le champ Replace, saisissez le signe de leuro entre guillemets. En dernier paramtre, slectionnez firstname dans la colonne Input column. Dans la colonne Search, cherchez la chane \t. Pour diffrencier cette chane de la tabulation, ajoutez autant de barres obliques inverses devant quil y a de vrifications. En dautres termes, il faut ajouter deux barres obliques inverses pour que la chane ne soit pas confondue avec la tabulation et deux autres qui font partie du caractre recherch. En tout, il doit y avoir quatre barres obliques inverses inclue celle constituant la chane de caractres. Dans le champ Replace, ne mettez rien entre les guillemets. Cochez la case whole word. Loption Advanced mode nest pas utilise pour ce scnario. Slectionnez le composant suivant : tFilterColumn.
Le composant tFilterColumn contient un diteur de schma permettant de crer un schma de sortie bas sur le nom des colonnes du schma dentre. Dans cet exemple, changez lordre des colonnes et ajoutez trois nouvelles colonnes pour obtenir le schma suivant : empty_field, firstname, name, str, amount, filler1, filler2. Cliquez sur OK pour valider. Double-cliquez sur le tFileOutputDelimited afin dafficher sa vue Component.
1252
tReplace
Dans le champ Property Type, slectionnez loption Built-in et paramtrez les proprits du composant tFileOutputDelimited manuellement. Dans le champ Schema, slectionnez loption Built-in et cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Enregistrez le Job et excutez-le.
La premire colonne est vide et les caractres parasites ont t supprims des autres colonnes. La colonne street a t dplace, les dcimales sont dornavant spares par une virgule et le symbole montaire a t chang.
1253
tSampleRow
tSampleRow
Proprits du tSampleRow
Le composant tSampleRow filtre les lignes en fonction de leur position. Le tSampleRow permet de slectionner des lignes en fonction dune liste de lignes simples et/ou de groupes de lignes. Schema type 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. 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. Range Renseignez la position ou lintervalle choisi, en utilisant la syntaxe approprie, pour rcuprer une liste de lignes simples et/ou de groupes de lignes.
Ce composant traite des flux de donnes, il ncessite donc des composants dentre et sortie. n/a
Scnario : Filtrer des lignes et des groupes de lignes

Ce scnario Java dcrit un Job trois composants. On utilise un composant tRowGenerator pour crer des entres au hasard qui sont directement envoyes au tSampleRow, o elles seront filtres en fonction de leur position. Dans ce scnario, on suppose que le flux dentre contient les noms des vendeurs associs au nombre de produits quils ont chacun vendus ainsi que le nombre dannes passes dans lentreprise. Le rsultat de lopration de filtrage apparat dans la console Run. A partir de la Palette, cliquez dposez les composants suivants dans lditeur graphique : le tRowGenerator, le tSampleRow et le tLogRow. Connectez ces trois composants laide de liens de type Row Main.
1254
tSampleRow
Dans lditeur graphique, slectionnez le tRowGenerator. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tRowGenerator. Dans la vue Basic settings, dfinissez loption Schema Type en mode Built-In puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes que vous voulez utiliser en entre. Dans ce scnario, le schma est compos de cinq colonnes.
Dans longlet Basic settings, cliquez sur RowGenerator Editor pour dfinir les donnes gnrer. Dans lditeur RowGenerator Editor, prcisez le nombre de lignes gnrer dans le champ Number of Rows for RowGenerator puis cliquez sur OK pour fermer lditeur.
1255
tSampleRow
Dans lditeur graphique, slectionnez le tSampleRow. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tSampleRow.
Dans longlet Basic settings, dfinissez loption Schema Type en mode Built-In puis cliquez sur Sync columns pour rcuprer le schma partir du composant tRowGenerator. Dans le panneau Range, dfinissez le filtre de slection des lignes en utilisant la syntaxe approprie comme indiqu plus haut. Dans ce scnario, on veut slectionner la premire et la cinquime ligne, ainsi que le groupe de lignes entre 9 et12. Dans lespace graphique, slectionnez le tLogRow puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations sur les proprits du tLogRow, consultez tLogRow, page 1095. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
Les rsultats filtrs apparaissent dans la console de log. Ils affichent la premire et la cinquime ligne, ainsi que les lignes entre 9 et 12.
1256
tSortRow
tSortRow
Proprits du tSortRow
Ce composant trie les donnes dentre bases sur une ou plusieurs colonnes, selon un type de tri et un ordre. Il permet dtablir des mtriques et des tables de classification. Schema type 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 dans cette vue, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent dans le Job. 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 Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Criteria Cliquez sur [+] pour ajouter autant de lignes que ncessaire pour mettre en place le tri. La premire colonne dfinie dans le schma est slectionne par dfaut. Schema column : Slectionnez la colonne de votre schma sur laquelle vous souhaitez baser votre tri. Notez que lordre est important car il dtermine la priorit de tri. Sort type : Numrique ou Alphabtique. Dautres types de tri sont venir. Order : Ordre ascendant ou descendant.
1257
tSortRow
Advanced settings
Sort on disk
Personnalisez la mmoire utilise de manire temporaire pour stocker les donnes de sortie. Temp data directory path : Dfinissez le chemin daccs au dossier dans lequel stocker les fichiers temporaires. Create temp data directory if not exists : Cochez cette case afin de crer le dossier sil nexiste pas. Buffer size of external sort : Entrez la taille de la mmoire physique allouer au processus de tri. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant manipule le flux de donnes et par consquent requiert un composant en entre et un composant en sortie. Il sagit donc dun composant intermdiaire. n/a
Limitation
Scnario : Trier des donnes

Le scnario suivant dcrit un Job constitu de trois composants. Un composant tRowGenerator est utilis pour crer des entres de faon alatoire. Ces entres seront ensuite envoyes au composant tSortRow afin dtre tries selon une valeur dfinie. Dans ce scnario, le flux dentre contient des noms de vendeurs ainsi que leur volume de vente respectif et leur nombre dannes danciennet dans lentreprise. Le rsultat de lopration de tri est affich dans la console Run.
Cliquez et dposez les trois composants requis pour ce scnario : tRowGenerator, tSortRow et tLogRow. Connectez-les laide de connexions de type Row Main. Dans le RowGenerator editor, dfinissez les valeurs qui seront cres de manire alatoire et qui seront ensuite tries par le tSortRow. Pour plus dinformations concernant lutilisation du tRowGenerator, consultez Proprits du tRowGenerator page 1129.
1258
tSortRow
Dans ce scnario, chaque vendeur est class en fonction de la valeur de ses ventes (Sales) et de son anciennet dans lentreprise (YearsInComp). Double-cliquez sur tSortRow pour afficher longlet Basic settings. Dfinissez la priorit de tri sur la valeur des ventes et, en second critre, sur lanciennet.
1259
tSortRow
Utilisez le bouton (+) pour ajouter le nombre de lignes de critres requis. Paramtrez le type de tri, dans cet exemple, les deux critres sont de type numrique. Enfin, tant donn que la sortie est une classification, dfinissez lordre de tri comme descendant. Dans longlet Advanced Settings, cochez loption Sort on disk pour modifier les paramtres de la mmoire temporaire. Dans le champ Temp data directory path, renseignez le chemin daccs au dossier dans lequel vous voulez stocker les donnes temporaires. Dans le champ Buffer size of external sort, dfinissez la taille maximale de la mmoire tampon allouer au traitement des donnes.
La valeur par dfaut de la mmoire tampon est de 1000000 mais plus vous traitez un nombre important de lignes et/ou colonnes, plus cette valeur devra tre leve pour viter linterruption automatique du Job signifie par le message derreur out of memory.
Assurez-vous que ce flux est connect au composant de sortie tLogRow, afin dafficher le rsultat dans la console Run. Appuyez sur F6 pour excuter le Job ou passez la vue Run et cliquez sur le bouton Run. Le classement est dabord bas sur la valeur des ventes puis sur le nombre dannes danciennet.
1260
tSortRow
1261
tSortRow
1262
Composants System
Ce chapitre passe en revue les principaux composants de la famille System de la Palette de Talend Open Studio. La famille System regroupe les composants permettant dinteragir avec votre systme dexploitation.
Composants System
tRunJob
tRunJob
Proprits du tRunJob
Famille de composant System
Le composant tRunJob excute le Job spcifi dans ses proprits dans un contexte dfini. Le tRunJob permet de matriser des systmes de Job complexes devant tre excuter lun aprs lautre. 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 dans cette vue, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent dans le Job. 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 Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. CopyChild Job Schema Job Cliquez sur ce bouton pour rcuprer le schma du Job fils. Slectionnez le Job appeler et traiter. Assurez-vous que le Job appel ait t excut au moins une fois auparavant pour que son excution via le tRunJob se droule le mieux possible. Slectionnez la version du Job fils que vous souhaitez utiliser. Si vous avez paramtr des contextes et des variables pour les Jobs excuter via le tRunJob, slectionnez dans la liste le contexte appliquer. Cochez cette case afin dutiliser un processus idpendant pour excuter le sous-job. Cela vous permettra de rsoudre des problmes lis la taille limite de la mmoire.
Version Context
Use an independent process to run subjob
1264
Composants System
tRunJob
Die on child error
Dcochez cette case pour excuter le Job parent mme sil y a une erreur lors de lexcution du Job fils. Cochez cette case pour obtenir les contextes du Job parent. Dcochez-la pour obtenir les contextes du Job fils. Vous pouvez modifier les paramtres de contexte slectionns. Cliquez sur le bouton (+) pour ajouter les paramtres tels quils ont t dfinis dans le contexte du Job fils.
Transmit whole context Context Param
Pour plus dinformations sur les paramtres de contexte, consultez la section Dfinir les paramtres de contexte du Guide Utilisateur de Talend Open Studio.
Advanced settings Print Parameters tStatCatcher Statistics Utilisation Cochez cette case pour afficher les paramtres internes et externes dans la Console. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant peut tre utilis en Job standalone ou peut aider clarifier certains Jobs complexes en vitant davoir un nombre important de sous-jobs dans le mme Job. n/a
Limitation
Scnario : Excuter un Job fils

Le scnario suivant dcrit un Job un composant appelant et excutant un autre Job. Le Job excuter lit une liste de fichiers dlimits de base et affiche son contenu dans la console de la vue Run. La particularit de ce Job rside dans le fait que ce dernier est excut partir dun autre Job et utilise la variable de contexte provenant du fichier dentre devant tre trait.
Crez le premier Job lisant un fichier dlimit.

Composants System
tRunJob
A partir de la Palette, cliquez et dposez les composants tFileInputDelimited et tLogRow dans lespace de modlisation. Connectez ces deux composants laide dun lien de type Row Main. Double-cliquez sur le composant tFileInputDelimited pour afficher la vue Basic settings et paramtrer les proprits du composant dentre. Dans la liste droulante Property Type, slectionnez loption Built-In.
Cliquez dans le champ File Name puis appuyez sur la touche F5 pour ouvrir la fentre de configuration de variable. Nommez cette nouvelle variable de contexte, ici appelez-la File.
1266
Composants System
tRunJob
Pour cet exemple, laissez les paramtres par dfaut, i.e. ne cochez pas la case Prompt for value et laissez le champ Prompt vide. Cliquez sur Finish pour valider puis appuyez sur Enter pour vous assurer que la nouvelle variable de contexte est conserve dans le champ File Name. Dans les champs Field separator et Row separator de longlet Basic settings, renseignez respectivement les sparateurs de champs et de lignes utiliss dans le fichier dentre. Dans cet exemple, les fichiers ne possdent ni en-tte ni pied de page. Ainsi, laissez les champs Header et Footer vides. Les fichiers sont relativement courts, vous pouvez donc laisser le champ Limit vide. Dans la liste droulante Schema type, slectionnez loption Built-in. Cliquez sur le bouton [...] pour configurer manuellement le schma. Ajoutez deux colonnes et nommez-les comme les deux premires colonnes du fichier dentre. Dans cet exemple : username et age.
Si vous avez stock le schma dans le Repository, slectionnez la mtadonne correspondant la structure de votre fichier dentre.
Double-cliquez sur le composant tLogRow pour afficher la vue Basic settings et paramtrer les proprits du composant de sortie. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant dentre puis paramtrez les autres options selon vos besoins. Enregistrez le Job fils puis appuyez sur la touche F6 vous assurer quil sexcute correctement.
Composants System
tRunJob
Crez le deuxime Job jouant le rle de Job parent. Cliquez et dposez les composants tFileList et tRunJob dans lespace de modlisation. Connectez ces deux composants laide dun lien de type Iterate. Double-cliquez sur le composant tFileList pour afficher la vue Basic settings et paramtrer les proprits du composant.
Dans le champ Directory, renseignez le chemin daccs au rpertoire contenant les fichiers traiter ou cliquez sur le bouton [...] pour parcourir vos dossiers jusqu ce rpertoire. Dans cet exemple, il sagit du rpertoire tRunJob qui contient trois fichiers dlimits. Dans la liste droulante FileList Type, slectionnez loption Files. Cochez la case Use Glob Expressions as Filemask pour pouvoir utiliser des expressions rgulires dans vos masques. Cliquez sur le bouton [...] pour ajouter un masque et renseignez le filtre appliquer. Dans cet exemple, les fichiers rcuprer sont de type dlimit, le filtre choisi est *.csv. Double-cliquez sur le composant tRunJob pour afficher la vue Basic settings et paramtrer les proprits du composant.
1268
Composants System
tRunJob
Cliquez sur le bouton [...] ct du champ Job pour accder la bote de dialogue [Find a Job].
Slectionnez le Job fils excuter puis cliquez sur OK pour fermer la bote de dialogue. Le nom du Job slectionn apparat dans le champ Job de la vue Basic settings du tRunJob. Cliquez sur le bouton Copy Child Job Schema pour rcuprer le schma dfini dans le Job fils. Cliquez sur le bouton [+] pour ajouter une ligne de paramtres dans le champ Context Param. Cliquez dans la cellule Values puis appuyez sur Ctrl+Espace pour accder la liste des variables de contexte et slectionnez le contexte tFileList-1.CURRENT_FILEPATH. La cellule Values est automatiquement renseigne par la variable de contexte correspondante : ((String)globalMap.get(tFileList-1.CURRENT_FILEPATH)). Pour plus dinformations sur les paramtres de contexte, consultez la section Dfinir les paramtres de contexte du Guide Utilisateur de Talend Open Studio. Enregistrez le Job matre puis appuyez sur la touche F6 pour lexcuter.
1269
Composants System
tRunJob
Le Job appel lit les donnes contenues dans les fichiers dentre comme dfini dans le schma dentre et le rsultat de ce Job est directement affich dans la console Run. Voir galement : Le composant tLoop, page 1143, Le Scnario 1 : Mettre des donnes en tampon (Java), page 1109 du composant tBufferOutput.
1270
Composants System
tSetEnv
tSetEnv
Proprits du tSetEnv
Famille du composant System
Fonction Objectif
Le composant tSetEnv ajoute des variables lenvironnement du systme de manire temporaire, pendant lexcution du Job. Le tSetEnv permet de crer des variables et dexcuter un Job script en communicant les informations des variables nouvellement cres entre les diffrents sous-jobs. Aprs lexcution du Job, ces nouvelles variables sont supprimes. Parameters Cliquez sur le bouton [+] pour ajouter les variables ncessaires au Job. name : Renseignez la syntaxe de la nouvelle variable. value : Entrez une valeur pour ce paramtre en fonction du contexte. append : Cochez cette case pour ajouter la nouvelle variable la fin.
Basic settings
Le tSetEnv peut tre utilis comme composant de dbut ou composant intermdiaire. n/a
Scnario : Modifier la variable Date lors de lexcution dun Job

Le scnario suivant est un Job qui permet de lire une colonne dans une base de donnes Oracle, de rcuprer la date courante partir de cette colonne en utilisant une requte de base de donnes de crer une nouvelle variable grce au tSetEnv pour modifier le format de la date puis dafficher la date modifie dans la console. Pour modifier le format de la date en utilisant une nouvelle variable cre par le tSetEnv : A partir de la Palette, cliquez-dposez les composants tSetEnv, tOracleInput et tLogRow dans lditeur graphique. Connectez le tSetEnv au tOracleInput laide dun lien OnSubjobOk. Connectez le tOracleInput au tLogRow laide dun lien Row Main.
1271
Composants System
tSetEnv
Slectionnez le tSetEnv dans lditeur graphique puis cliquez sur la vue Component. Dans longlet Basic settings, cliquez sur le bouton [+] pour ajouter une ligne de paramtres et dfinissez votre nouvelle variable. Cliquez dans la cellule name puis renseignez la syntaxe de la variable concernant la date. Dans cet exemple, on utilise NLS_DATE_FORMAT. Cliquez dans la cellule value puis renseignez la valeur dsire pour votre nouvelle variable de date.
Dans cet exemple, on veut transformer le format de date DD-MMM-YY prdfini par le systme en YYYY-MM-DD. Slectionnez le tOracleInput puis cliquez sur longlet Component . Paramtrez la configuration de base (Basic settings) du composant tOracleInput. Pour plus dinformations, consultez le composant tOracleInput, page 577.
1272
Composants System
tSetEnv
Dans cet exemple, on effectue une requte sur une base Oracle pour extraire les donnes contenues dans la colonne the REGISTERDATE de la table NEW_CUSTOMERS_MLE. Slectionnez le tLogRow puis cliquez sur la vue Component. Renseignez la configuration de base (Basic settings) du composant tLogRow. Pour plus dinformations, consultez le composant tLogRow, page 1095. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
La date saffiche dans la console au format YYYY-MM-DD modifi par le composant tSetEnv. Pour afficher la date au format pr-dfini par le systme en utilisant ce Job : Dans lespace graphique, cliquez-droit sur le composant tSetEnv et slectionnez loption Deactivate tSetEnv_1 partir de la liste droulante. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
1273
Composants System
tSetEnv
La date saffiche dans la console au format DD-MMM-YY pr-dfini par le systme.
1274
Composants System
tSSH
tSSH
Proprits du tSSH
Le composant tSSH renvoie les donnes dun ordinateur distant via le protocole Secure Shell dfini. Le tSSH permet dentrer en communication avec un serveur distant et de renvoyer les informations de scurit. Host Port User Public Key/Password Adresse IP. Numro du port dcoute. Informations dauthentification de lutilisateur. Slectionnez loption adquate. Si vous choisissez loption Public Key, assurez-vous que la cl ait t ajoute lagent ou quaucune passphrase (phrase secrte) ne soit demande. Password : Renseignez le mot de passe. Private key : Slectionnez votre cl prive. Saisissez la commande permettant de rcuprer linformation de lordinateur distant. Dfinit la dure avant expiration. Un message notifiant lexpiration sera gnr si lactuel temps de rponse dpasse ce dlai dexpiration.
Password/Private Key Commands Use timeout/timeout in seconds Utilisation Limitation
Ce composant peut tre utilis en standalone. Lutilisation de ce composant est adapte pour les systmes de type Unix.
Scnario : Accder aux informations du systme distant via SSH

Le scnario suivant dcrit un Job utilisant un protocole SSH pour afficher le nom dhte du serveur distant auquel vous souhaitez vous connecter et la date actuelle de ce systme distant. Un composant tSSH est suffisant pour ce Job. Cliquez et dposez-le de la famille System de la Palette. Double-cliquez sur le tSSH et slectionnez longlet Basic settings de la vue Component.
1275
Composants System
tSSH
Renseignez le nom de lhte dans le champ Host auquel accder partir du SSH, ainsi que le numro du port dans le champ Port. Dans le champ User, renseignez le nom didentification de lutilisateur sur lordinateur distant. Slectionnez la mthode dauthentification dans la liste droulante Authentication method. Dans cet exemple, la mthode dauthentification utilise est Public key (cl publique). Renseignez donc le champ Private key avec votre cl prive. Dans le champ Command, saisissez la commande suivante. Dans cet exemple, saisissez hostname; date entre guillemets simples (puisque le Job est gnr en Perl). Cochez la case Use timeout et paramtrez la dure avant expiration 5 secondes.
Lordinateur distant renvoie le nom de lhte, ainsi que la date et lheure en cours.
1276
Composants System
tSystem
tSystem
Proprits du tSystem
Le composant tSystem excute une ou plusieurs commande(s) systme. tSystem peut appeler dautres commandes de traitement, fonctionnant dj dans un Job plus grand. Use home directory Command Cochez cette case pour changer le nom et le chemin du rpertoire ddi. Saisissez la commande systme excuter. Notez que la syntaxe nest pas vrifie. Sous Windows, les commandes MS-DOS ne permettent pas de passer directement du dossier courant au dossier contenant le fichier excuter. Pour excuter un fichier, vous devez donc utiliser une premire commande afin de changer de dossier courant, puis une deuxime commande excutant le fichier. Standard Output et Error Output Slectionnez le type de sortie auquel les donnes traites seront transfres. to console : transmet les donnes vers la console de la vue Run. to global variable : les donnes sont envoyes dans une variable de sortie lie au composant tSystem. both to console and to global variable : les donnes sont envoyes la fois vers la console de la vue Run et dans une variable de sortie lie au composant tSystem. normal : les donnes sont envoyes au composant suivant. Schema type 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 dans cette vue, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent dans le Job.
1277
Composants System
tSystem
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 Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Environment variables Cliquez sur le bouton [+] pour ajouter les variables denvironnement ncessaires au Job. name : Renseignez la syntaxe de la nouvelle variable. value : Entrez une valeur pour ce paramtre en fonction du contexte.
Ce composant sert aux entreprises qui utilisent dj dautres applications quils souhaitent intgrer leur flux via Talend. n/a
Scnario : Echo Hello World!

Ce scnario est constitu dun Job deux composants permettant dafficher un message dans la console de la vue Run.
A partir de la Palette, dposez les composants tSystem et tJava dans lespace graphique. Cliquez-droit sur le composant tSystem et slectionnez un lien de type OnSubjobOk pour relier ces deux composants. Lorsque vous excutez le Job, le premier composant dclenchera le deuxime. Double-cliquez sur le composant tSystem pour afficher longlet Basic settings et configurer ses paramtres de base.
1278
Composants System
tSystem
Dans le champ Command, saisissez la commande echo suivie de la chane de caractres afficher : cmd /c echo HELLO WORLD Dans le champ Standard Output, slectionnez loption to a global variable pour envoyer la sortie dans une variable globale. Laissez les autres champs par dfaut. Slectionnez ensuite le composant tJava.
Saisissez la commande Java permettant dafficher la variable de sortie du tSystem dans la console : System.out.println(Hello World!); Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
Le Job excute une commande echo et affiche la sortie dans la console de log de la vue Run grce la fonction println de la commande Java du composant tJava.
Composants System
tSystem
1280
Composants Talend MDM

Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille Talend MDM de la Palette de Talend Open Studio. La famille Talend MDM regroupe les composants qui lisent et crivent des donnes dans les fichiers XML du hub XML MDM.

tMDMDelete
tMDMDelete
Ce composant est disponible dans la Palette, mais vous pourrez lutiliser uniquement si vous possdez Talend MDM.
Proprits du tMDMDelete
Famille de composant Talend MDM
Le composant tMDMDelete supprime des enregistrements de donnes dentits spcifiques du hub MDM (rfrentiel XML). Ce composant efface des donnes de rfrence du hub MDM. 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. Si vous modifiez le schma, il redevient automatiquement built-in. Cliquez sur le bouton Sync columns afin de rcuprer le schma du composant prcdent. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : 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. URL Username et Password Version Saisissez lURL daccs au serveur MDM. Informations dauthentification de lutilisateur du serveur MDM. Saisissez le nom de la version des donnes de rfrence laquelle vous souhaitez vous connecter, en fonction de vos droits utilisateur. Laissez ce champ vide pour afficher la version par dfaut des donnes de rfrence. Saisissez le nom de lentit contenant les donnes que vous souhaitez effacer. Saisissez le nom du conteneur de donnes contenant les donnes que vous souhaitez effacer. Spcifiez le(s) champ(s) (dans lordre de la squence) composant la cl lorsque lentit possde une cl multiple.
Entity Data Container Keys
1282

tMDMDelete
Logical delete
Cochez cette case afin denvoyer les donnes de rfrence dans la Corbeille, et renseignez le chemin daccs la Corbeille (Recycle bin path). Une fois dans la Corbeille, les donnes de rfrence peuvent tre supprimes dfinitivement ou restaures. Si vous laissez la case dcoche, les donnes de rfrence seront supprimes dfinitivement. Cochez cette cases afin darrter le Job en cas derreur. Cochez cette case pour collecter les donnes de log au niveau du composant.
Die on error Advanced settings Utilisation tStatCatcher Statistics
Utilisez ce composant pour crire un fichier et sparer les champs laide dun sparateur spcifique.
Scnario : Supprimer des donnes de rfrence dun hub MDM

Ce scnario dcrit un Job deux composants supprimant les enregistrements de donnes spcifis du rfrentiel XML MDM.
Glissez-dposez de la Palette dans lespace de modlisation graphique un composant tMDMInput et un composant tMDMDelete, de la famille Talend MDM. Connectez les deux composants laide dun lien Row > Main. Double-cliquez sur le composant tMDMInput afin dafficher sa vue Component et dfinir ses proprits.
1283

tMDMDelete
Dans la liste Property Type, slectionnez Built-in pour renseigner les champs manuellement. Si vous avez stock votre connexion MDM dans les mtadonnes du Repository, slectionnez Repository dans la liste, et les champs seront automatiquement remplis. Dans la liste Schema Type, slectionnez Built-in et cliquez sur le bouton [...] ct du champ Edit schema, afin douvrir une bote de dialogue dans laquelle vous pourrez dfinir la structure des donnes de rfrence que vous souhaitez lire dans le hub MDM.
Les donnes de rfrence sont collectes dans un schma compos de quatre colonnes de type String: Id, Name, City et State. Cliquez sur OK pour fermer la bote de dialogue et procder ltape suivante. Dans le champ URL, saisissez entre guillemets lURL du serveur MDM : "http://localhost:8080/talend/TalendPort". Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au serveur MDM. Dans le champ Version, saisissez entre guillemets le nom de la version des donnes de rfrence laquelle vous souhaitez accder. Laissez ce champ vide afin dafficher la version des donnes de rfrence par dfaut. Dans le champ Entity, saisissez entre guillemets le nom de lentit mtier contenant les enregistrements de donnes que vous souhaitez lire. Ici, nous travaillons avec lentit Agency. Dans le champ Data Container, saisissez entre guillemets le nom du conteneur de donnes contenant les donnes de rfrence que vous voulez lire. Ici, nous utilisons le conteneur DStar.
La case Use multiple conditions est coche par dfaut.
1284

tMDMDelete
Dans le tableau Operations, dfinissez les conditions de filtre des donnes de rfrence que vous souhaitez supprimer : -cliquez sur le bouton [+] afin dajouter une nouvelle ligne. Dans la colonne Xpath, saisissez entre guillemets le chemin Xpath et la balise du noeud XML sur lequel vous souhaitez appliquer le filtre. Ici, nous travaillons avec lentit Agency, saisissez Agency/Id. Dans la colonne Function, slectionnez la fonction que vous souhaitez utiliser. Dans ce scnario, nous utilisons la fonction Starts With. Dans la colonne Value, saisissez la valeur de votre filtre. Ici, nous souhaitons filtrer les donnes de rfrence dont lID commence par TA. Dans la vue Component, cliquez sur longlet Advanced settings afin de configurer les paramtres avancs.
Dans le champ Loop XPath query, saisissez entre guillemets la structure et le nom du noeud XML sur lequel excuter la boucle. Dans la zone Mapping et dans la colonne XPath query, saisissez entre guillemets le nom de la balise XML sur laquelle nous souhaitons collecter les donnes de rfrence, ct de la colonne de sortie correspondante. Dans lespace de modlisation graphique, cliquez sur le composant tMDMDelete afin dafficher sa vue Component et dfinir ses proprits.
1285

tMDMDelete
Dans la liste Schema, slectionnez Built-in et cliquez sur le bouton [...] ct du champ Edit Schema, afin de dcrire la structure des donnes de rfrence du hub MDM.
Cliquez sur le bouton [+], droite, afin dajouter une colonne de type String. Nommez-la xmlOutput. Cliquez sur OK. Dans le champ URL, saisissez lURL requise pour vous connecter au serveur MDM, par exemple : "http://localhost:8080/talend/TalendPort". Dans les champs Username et Password, saisissez les informations dauthentification requises afin de vous connecter au serveur. Dans le champ Version, saisissez entre guillemets le nom de la version des donnes de rfrence laquelle vous souhaitez accder. Laissez le champ vide si vous souhaitez accder la version par dfaut. Dans le champ Entity, saisissez le nom de lentit mtier contenant les donnes de rfrence que vous souhaitez supprimer. Ici, nous travaillons avec lentit Agency.
1286

tMDMDelete
Dans le champ Data Container, saisissez le nom du conteneur de donnes contenant les donness supprimer. Ici, nous utilisons le conteneur DStar. Dans le tableau Keys, cliquez sur le bouton [+] afin dajouter une nouvelle ligne. Dans la colonne Keys, slectionnez la colonne contenant la cl de lentit Agency. Ici, la cl de lentit Agency est dans le champ Id.
Si lentit possde des cls multiples, ajoutez autant de lignes que ncessaire pour les cls, et slectionnez-les dans lordre squentiel.
Cochez la case Logical delete si vous ne voulez pas supprimer dfinitivement les donnes de rfrence. Elles seront envoyes dans la Corbeille. Une fois dans la Corbeille, les donnes de rfrence peuvent tre supprimes dfinitivement, ou bien restaures. Si vous laissez cette case dcoche, les donnes de rfrence seront supprimes dfinitivement. Remplissez le champ Recycle bin path. Ici, nous avons laiss le chemin daccs la Corbeille par dfaut, mais si votre chemin daccs la Corbeille est diffrent de celui par dfaut, spcifiez-le. Appuyez sur Ctrl+S pour sauvegarder votre Job, puis sur F6 pour lexcuter. Les donnes dont lID commence par TA ont t supprimes et envoyes dans la Corbeille MDM.
1287

tMDMInput
tMDMInput
Proprits du tMDMInput
Le composant tMDMInput lit les donnes de rfrence du hub MDM (rfrentiel XML). Ce composant lit les donnes de rfrence dans un hub MDM et rend possible le traitement de ces donnes. Property Type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. 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. Si vous modifiez le schma, il redevient 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. URL Username et Password Version Saisissez lURL daccs au serveur MDM. Saisissez les informations dauthentification de lutilisateur du serveur MDM. Saisissez le nom de la version des donnes de rfrence laquelle vous souhaitez vous connecter, en fonction de vos droits utilisateur. Laissez ce champ vide pour afficher la version par dfaut des donnes de rfrence. Saisissez le nom de lentit contenant les donnes que vous souhaitez effacer.
Entity
1288

tMDMInput
Data Container
Saisissez le nom du conteneur de donnes contenant les donnes que vous souhaitez effacer.
Use multiple conditions Cochez cette case pour filtrer les donnes de rfrence laide de conditions. Xpath : saisissez, entre guillemets, le noeud XML sur lequel appliquer la condition. Function : slectionnez la condition utiliser. Value : saisissez, entre guillemets, la valeur souhaite. Predicate : slectionnez un prdicat lorsque vous utilisez plusieurs conditions. Si vous dcochez cette case, vous avez la possibilit de slectionner des ID particuliers devant tre affichs dans la colonne ID value du tableau IDS. Si vous dcochez la case Use multiple conditions, loption Batch Size de longlet Advanced settings ne sera plus disponible. Skip rows Limit Advanced settings Batch Size Renseignez le nombre de lignes ignorer. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ou traite. Nombre de lignes dans chaque lot trait. Cette option napparat pas si vous avez dcoch la case Use multiple conditions dans longlet Basic settings. Loop XPath query Mapping Noeud de larborescence XML sur lequel est bas la boucle. Column : reflte le schma tel quil est dfini dans lditeur Edit Schema. XPath query : Saisissez les champs extraire de la structure XML dentre. Get Nodes : Cochez cette case pour rcuprer les balises XML entournant les donnes avec celles-ci. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant est utilis comme composant de dbut. Il ncessite un flux de sortie..
Scnario : Lire les donnes de rfrence dun hub MDM

Ce scnario dcrit un Job deux composants qui lit les donnes de rfrence dans un serveur MDM et les affiche dans la console de log.
A partir de la Palette, glissez les composants tMDMInput de la famille Talend MDM, et tLogRow de la famille Logs & Errors dans lespace de modlisation.

tMDMInput
Reliez-les via un lien de type Row Main. Double-cliquez sur le composant tMDMInput pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
Dans la liste Property Type, slectionnez Built-In et renseignez les champs manuellement. Si vous avez stock les informations de connexion au MDM dans les mtadonnes du Repository, slectionnez Repository dans la liste et les champs suivants seront renseigns automatiquement. Dans la liste Schema, slectionnez Built-In et cliquez sur le bouton [...] ct du champ Edit schema pour dcrire la structure des donnes de rfrence que vous souhaitez lire sur le serveur MDM.
Les donnes de rfrence sont rcupres dans un schma trois colonnes de type String : ISO2Code, Name, Currency. Cliquez sur OK.
1290

tMDMInput
Dans le champ URL, saisissez entre guillemets lURL de connexion au serveur MDM. Dans les champs Username et Password, saisissez lidentifiant et le mot de passe de connexion au serveur MDM. Dans le champ Version, saisissez entre guillemets le nom de la version des donnes de rfrence laquelle vous avez souhaitez accder. Laissez le champ vide pour afficher la version par dfaut. Dans le champ Entity, saisissez entre guillemets le nom de lentit mtier contenant les donnes de rfrence que vous souhaitez lire. Dans le champ Data Container, saisissez entre guillemets le nom du conteneur de donnes contenant les donnes de rfrence que vous souhaitez lire. Dans la vue Component, cliquez sur longlet Advanced settings pour paramtrer les proprits avances du composant.
Dans le champ Loop XPath query, saisissez entre guillemets larborescence et le nom du noeud XML sur lequel effectuer la boucle. Dans le tableau Mapping, les colonnes du schma du composant apparaissent sous la colonne Column. Saisissez entre guillemets le nom de la balise XML dans laquelle rcuprer les donnes de rfrence dans le champ XPath query correspondant la colonne du schma de sortie. Dans lespace de modlisation, double-cliquez sur le composant tLogRow pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits. Cliquez sur Edit schema et assurez-vous que le schma est rcupr du composant prcdent. Sinon, cliquez sur Sync Columns pour rcuprer le schma du composant. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
1291

tMDMInput
La liste des diffrents pays, ansi que leur code et devise est retourne dans la console de la vue Run.
1292

tMDMOutput
tMDMOutput
Proprits du tMDMOutput
Le composant tMDMOutput crit des donnes de rfrence dans un hub MDM (rfrentiel XML). Ce composant crit des donnes de rfrence sur le serveur MDM. 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. Schema type 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. 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. XML Field URL Username et Password Version Slectionnez le nom de la colonne dans laquelle vous souhaitez crire les donnes XML. Saisissez lURL daccs au serveur MDM. Saisissez les informations dauthentification de lutilisateur du serveur MDM. Saisissez le nom de la version des donnes de rfrence laquelle vous souhaitez vous connecter, en fonction de vos droits utilisateur. Laissez ce champ vide pour afficher la version par dfaut des donnes de rfrence. Saisissez le nom du modle de donnes en comparaison duquel les donnes crire seront valides. Composants Talend Open Studio 1293
Data Model

tMDMOutput
Data Container Return Keys
Saisissez le nom du conteneur de donnes dans lequel vous souhaitez crire les donnes de rfrence. Columns corresponding to IDs in order : dans lordre squentiel, dfinissez les colonnes de sortie qui stockeront les valeurs des cls retournes (cls primaires) des lments crer. Cochez cette case pour mettre jour les champs modifis. Si vous ne cochez pas cette case, la totalit des champs sera remplace par les champs modifis. Cochez cette case pour ajouter les actions effectues un rapport de modifications. Source Name : Saisissez, entre guillemets, le nom de lapplication partir de laquelle les modifications sont apportes. Enable verification by before saving transformer : cochez cette case pour vrifier lenregistrement qui vient dtre ajout avant quil ne soit enregistr. 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 commiter les donnes de rfrence par lot. Rows to commit : saisissez le nombre de lignes par lot. Ouvrez linterface daide la cration de la structure XML des donnes de rfrence crire. Slectionnez la colonne utiliser pour regrouper les donnes de rfrence.
Is Update
With Report
Die on error
Advanced settings
Extended Output
Configure Xml Tree Group by
Create empty element if Cette case est coche par dfaut. Si le contenu de la colonne needed Related Column de linterface permettant de crer la structure XML est nul, ou si aucune colonne nest associe au noeud XML, cette option crera une balise ouvrante et une balise fermante aux endroits prvus. Advanced separator (for number) Cochez cette case pour modifier les sparateurs utiliss par dfaut dans les nombres : - Thousands separator : saisissez entre guillemets le sparateur utiliser pour les milliers. - Decimal separator : saisissez entre guillemets le sparateur utiliser pour les dcimales. Slectionnez le mode de gnration que vous souhaitez utiliser en fonction de votre mmoire disponible : - Fast but memory-consuming (Dom4J), le plus rapide mais consommant de la mmoire. - Slow with no memory consumed, le plus lent ne consommant pas de mmoire. 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.
Generation mode
Encoding Type
1294

tMDMOutput
Utilisez ce composant pour crire un fichier et sparer les champs laide dun sparateur spcifque.
Scnario : Ecrire des donnes de rfrence dans un hub MDM

Ce scnario dcrit un Job deux composants qui gnre un enregistrement de donnes, transforme ces donnes en XML et les charge dans lentit mtier MDM dfinie. Ce Job gnre galement la cl primaire de lenregistrement de donnes charg.
Dans cet exemple, nous souhaitons charger une nouvelle agence dans lentit mtier Agency. Cette nouvelle agence doit comprendre un nom, un pays et une rgion. A partir de la Palette, glissez les composants tFixedFlowInput de la famille Misc, et tMDMOutput de la famille Talend MDM dans lespace de modlisation. Reliez-les via des liens de type Row Main. Double-cliquez sur le composant tFixedFlowInput pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
Dans la liste Schema, slectionnez Built-In et cliquez sur le bouton [...] ct du champ Edit schema pour dcrire la structure des donnes de rfrence que vous souhaitez crire dans le serveur MDM.

tMDMOutput
Ajoutez trois colonnes de type String en cliquant sur le bouton [+]. Nommez ces colonnes Name, Country et Region. Cliquez sur OK. Dans le champ Number of rows, saisissez le nombre de lignes que vous souhaitez gnrer. Ici, nous souhaitons gnrer quune seule ligne. Dans la zone Mode, slectionnez le mode Use Single Table pour ne gnrer quune seule table. Dans le tableau Values, saisissez entre guillemets, dans chaque champ Value, la valeur correspondant chaque colonne du schma. Dans lespace de modlisation, double-cliquez sur le composant tMDMOutput pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
1296

tMDMOutput
Dans la liste Property Type, slectionnez Built-In et renseignez les champs manuellement. Si vous avez stock les informations de connexion au MDM dans les mtadonnes du Repository, slectionnez Repository dans la liste et les champs suivants seront renseigns automatiquement. Dans la liste Schema, slectionnez Built-In et cliquez sur le bouton [...] ct du champ Edit schema pour dcrire la structure des donnes de rfrence que vous souhaitez charger sur le serveur MDM.
1297

tMDMOutput
Dans la zone de droite, ajoutez une colonne de type String en cliquant sur le bouton [+]. Nommez cette colonne xmlOutput. Le schma de sortie du composant va insrer le contenu XML complet et extraire la cl primaire des donnes insres. Cliquez sur OK. La liste XML Field dans longlet Basic settings est automatiquement renseigne avec la colonne de sortie que vous venez de crer. Dans le champ URL, saisissez entre guillemets lURL de connexion au serveur MDM. Dans les champs Username et Password, saisissez lidentifiant et le mot de passe de connexion au serveur MDM. Dans le champ Version, saisissez entre guillemets le nom de la version des donnes de rfrence laquelle vous souhaitez accder. Laissez le champ vide pour accder la version par dfaut. Dans le champ Data Model, saisissez entre guillemets le nom du modle de donnes par rapport auquel vous souhaitez valider les donnes de rfrences que vous souhaitez crire. Dans le champ Data Container, saisissez entre guillemets le nom du conteneur de donnes dans lequel les donnes de rfrence doivent tre crites. Dans la vue Component, cliquez sur longlet Advanced settings pour paramtrer les paramtres avances du composant.
Cochez la case Extended Output si vous souhaitez commiter les donnes de rfrence par lot. Vous pouvez spcifier le nombre de lignes par lot dans le champ Rows to commit. Cliquez sur le bouton [...] du champ Configure Xml Tree pour ouvrir lditeur du composant.
1298

tMDMOutput
Dans la zone Link target droite, cliquez dans le champ Xml Tree et remplacez rootTag par le nom de lentit mtier dans laquelle vous souhaitez insrer lenregistrement de donnes, Agency dans cet exemple. Dans la zone Linker source, slectionnez les trois colonnes de votre schma et glissez les sur le noeud Agency. La bote de dialogue [Selection] souvre.
Slectionnez Create as sub-element of target node pour que vos trois colonnes correspondent trois sous-lments du noeud Agency en XML. Cliquez sur OK.
Dans la zone Link target cliquez-droit sur llment que vous souhaitez dfinir comme lment sur lequel effectuer une boucle, puis slectionnez Set as Loop Element dans le menu contextuel. Dans cet exemple, nous voulons que Country soit llment ditration.
1299

tMDMOutput
Cliquez sur OK pour valider vos changements et fermer lditeur. Enregistrez votre Job et appuyez sur F6 pour lexcuter. Le nouvel enregistrement de donnes est insr dans lentit mtier Agency, dans le conteneur de donnes Location, sur le serveur MDM. Cet enregistrement de donnes contient, comme dfini dans le schma, le nom de lagence, son pays et sa rgion. La cl primaire de lenregistrement insr est galement gnre et retrouve.
1300

tMDMReceive
tMDMReceive
Proprits du tMDMReceive
Le composant tMDMReceive gnre autant de lignes et de colonnes que vous souhaitez, en utilisant des variables de contexte. Ce composant rcupre un paramtre de contexte comprenant des donnes MDM XML et les transforme en schma plat. 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 passera automatiquement en mode 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. XML Record Saisissez le paramtre de contexte vous permettant de rcuprer les dernires modifications apportes au serveur MDM. Pour plus dinformations propos de la cration et de lutilisation des paramtres de contexte, consultez Dfinition des Contextes et des Variables du Guide Utilisateur Talend Open Studio. Noeud de larborescence XML sur lequel est bas la boucle. Column : reflte le schma tel quil est dfini dans lditeur Edit Schema. XPath query : Saisissez les champs extraire de la structure XML dentre. Get Nodes : Cochez cette case pour ajouter les balises XML entournant les donnes rcuprer. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ni traite.
Loop XPath query Mapping
Limit
1301

tMDMReceive
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.
Ce composant est un composant de sortie. Il ncessite un flux de sortie.
Scnario associ
1302
Composants XML
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille XML de la Palette de Talend Open Studio. La famille XML regroupe les composants ddis aux tches lies au XML, notamment le parsing, la validation, la cration de structures XML, etc.
Composants XML
Proprits du tAdvancedFileOutputXML
Famille de composant File/Output ou XML
Fonction
Le composant tAdvancedFileOutputXML transmet des donnes vers un fichier de type XML et propose une interface de gestion des boucles et des Group by si ncessaire. Le tAdvancedFileOutputXML cre un fichier XML contenant les valeurs des donnes dfinies dans larborescence XML. File name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Configure XML tree Ouvre linterface daide la cration du fichier XML. Pour plus dinformations sur linterface, consultez Dfinir un arbre XML page 1306. 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. 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 dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Sync columns Cliquez sur ce bouton pour synchroniser le schma de sortie avec celui dentre. La fonction Sync ne saffiche que si une connexion de type Row est lie au composant de sortie. Cochez cette option pour ajouter de nouvelles lignes la fin de votre fichier source XML.
Append the source xml file
Generate compact file Cochez cette case pour gnrer un fichier ne comprenant aucun espace vide ni aucun sparateur de ligne. Lensemble des lments se prsente alors sur une ligne unique, ce qui permet de rduire le poids du fichier.
1304
Composants XML
Include DTD or XSL
Cochez cette case pour ajouter la dclaration DOCTYPE indiquant le nom de llment racine et le chemin daccs et le nom du fichier DTD ou pour ajouter linstruction de traitement indiquant le type de feuille de style (telle que les XSL) utilise et son chemin daccs et nom. DTD : saisissez le nom de llment racine dans le champ Root Element et saisissez le chemin daccs et le nom du fichier DTD dans le champ File Name. XSL : saisissez le type de feuille de style dans le champ Type et saisissez le chemin daccs et le nom du fichier dans le champ File Name. Si le fichier XML de sortie est lourd, vous pouvez le scinder en plusieurs fichiers en dfinissant un certain nombre de lignes par fichier. Cette case est coche par dfaut. Cette option permet de crer le dossier contenant le fichier XML de sortie sil nexiste pas dj. Cette case est coche par dfaut. Si le contenu de la colonne Associated Column est nul ou si aucune colonne nest associe au noeud XML, cette option crera une balise ouvrante et une balise fermante aux endroits prvus. Si lun des lments XML est associ un espace de nommage, cette option crera le fichier XSD correspondant. Pour utiliser cette option, vous devez slectionner le mode de gnration Dom4J dans la liste Generation mode.
Advanced settings
Split output in several files Create directory only if not exists Create empty element if needed
Create associated XSD file
Advanced separator (for number)
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 mode de gnration le plus rapide mais consommant de la mmoire (Fast but memory-consuming - Dom4J) ou le plus lent ne consommant pas de mmoire (Slow with no memory consumed) en fonction de votre mmoire disponible. 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. Cochez cette case pour annuler la gnration du fichier si celui-ci est vide.
Generation mode
Encoding type
Dont generate empty file
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log du Job, aussi bien au niveau du Job quau niveau de chaque composant.
1305
Composants XML
Utilisez ce composant pour crer un fichier XML partir des donnes transmises par dautres composants via une connexion de type Row. n/a
Dfinir un arbre XML

Double-cliquez sur le composant tAdvancedFileOutputXML pour ouvrir linterface ddie ou cliquez sur le bouton [...] du champ Configure Xml Tree de longlet Basic settings dans la vue Component.
Le champ Schema List de la zone Linker Source, gauche de linterface, contient toutes les colonnes du flux dentre ( condition que le flux dentre soit connect au composant tAdvancedFileOutputXML). A droite de linterface, dans la zone Linker Target, dfinissez la structure XML que vous souhaitez obtenir en sortie. Vous pouvez la crer manuellement ou tout simplement importer la structure XML. Puis importez les colonnes du schma dentre dans llment de larbre XML correspondant. Importer un arbre XML Le meilleur moyen de renseigner larbre XML est dimporter un fichier XML bien form. Renommez la balise racine qui saffiche par dfaut dans le panneau XML tree, en cliquant sur celle-ci. Dans la colonne XML Tree, cliquez-droit sur le champ root tag pour afficher le menu contextuel. Dans le menu, slectionnez Import XML tree.
Composants XML
Slectionnez le fichier importer et cliquez sur OK.

Vous pouvez importer la structure XML dun fichier au format XML, XSD et DTD.
La colonne XML Tree est donc automatiquement renseigne avec les lments. Vous pouvez supprimer et ajouter des lments ou des sous lments larbre : Slectionnez llment adquat dans larbre. Cliquez-droit pour faire apparatre le menu contextuel. Slectionnez Delete pour supprimer la slection de larbre ou slectionnez loption adquate parmi les suivantes : Add sub-element, Add attribute, Add namespace pour enrichir larbre. Crer manuellement larbre XML Si vous ne possdez pas de structure XML dj dfinie, vous pouvez la crer manuellement. Dans la colonne XML Tree, cliquez une fois sur le champ root tag pour le renommer. Cliquez droit sur ce champ pour afficher le menu contextuel. Dans le menu, slectionnez Add sub-element pour crer le premier lment de la structure. Vous pouvez aussi ajouter un attribut ou un lment enfant nimporte quel lment de larbre ou supprimer nimporte quel lment de larbre. Slectionnez llment adquat dans larbre que vous venez de crer. Cliquez-droit gauche du nom de llment pour afficher le menu contextuel. Dans le menu, slectionnez loption adquate parmi les suivantes : Add sub-element, Add attribute, Add namespace ou Delete.
Mapping de donnes XML

Une fois votre arbre XML cr, vous pouvez alimenter chaque lment ou sous-lment XML avec les colonnes du flux dentre dans la colonne Related Column :
1307
Composants XML
Cliquez sur une des entres de la colonne Schema List. Glissez-la dans le sous-lment correspondant droite. Relchez-la pour que le mapping soit effectif.
Une flche bleue apparat pour illustrer ce mapping. Sil est disponible, utilisez le bouton Auto-Map situ en bas gauche de linterface, il permet deffectuer cette opration automatiquement. Vous pouvez dconnecter nimporte quel mapping de nimporte quel lment de larbre XML : Slectionnez llment de larbre XML que vous souhaitez dconnecter de sa source respective. Cliquez-droit gauche de son nom pour afficher le menu contextuel. Slectionnez Disconnect linker. La flche bleue disparat.
Dfinir le statut du noeud

Dfinir larbre XML et le transfert de donnes ne suffit pas. Vous devez aussi dfinir llement sur lequel la boucle est effectue et si ncessaire llment partir duquel le regroupement est effectu. Element Boucle Llment Boucle permet de dfinir llment objet dune itration. Llment Boucle est gnralement un gnrateur de lignes. Pour dfinir un lment comme un lment Boucle : Slectionnez llment adquat dans larbre XML. Cliquez-droit gauche du nom de llment pour afficher le menu contextuel. Slectionnez loption Set as Loop Element.
1308
Composants XML
La colonne Node Status affiche le nouveau statut slectionn.

Il ne peut y avoir quun seul lment Boucle la fois.
Elment Group Llment Group est optionnel, il reprsente un lment constant sur lequel est effectue une fonction Groupby. Llment Group ne peut tre dfini que si un lment Boucle a t pralablement dfini. Lorsque vous utilisez un lment Group, les lignes doivent tre tries pour pouvoir tre regroupes par le noeud slectionn. Pour dfinir un lment comme lment Group : Slectionnez llment adquat dans larbre XML. Cliquez-droit gauche du nom de llment pour afficher le menu contextuel. Slectionnez loption Set as Group Element.
1309
Composants XML
La colonne Node Status affiche le nouveau statut slectionn et tout autre statut de regroupement est automatiquement dfini, si ncessaire. Une fois le mapping termin, cliquez sur OK pour valider les paramtres et continuez la configuration de votre Job.
Scnario : Crer un fichier XML laide dune boucle

Le scnario suivant dcrit la cration dun fichier XML partir dun fichier plat tri contenant une vidothque.
Dans la palette de composants, cliquez sur les composants tFileInputDelimited et tAdvancedFileOutputXML et dposez-les dans lespace de modlisation. Sinon, si vous avez dj cr une mtadonne contenant la description du fichier dentre dans le noeud Metadata du Repository, alors vous pouvez cliquer-dposer directement cette mtadonne dans lespace de modlisation pour paramtrer automatiquement le flux dentre. Cliquez-droit sur le composant dentre et reliez-le au composant tAdvancedFileOutputXML laide dune connexion de type Row Main. Slectionnez le composant tFileInputDelimited et paramtrez ses proprits dans la vue Component en bas de la fentre du Studio.
1310
Composants XML
Dans la liste droulante Property type, slectionnez loption Repository si la description de votre fichier est stocke dans une mtadonne du Repository. Si vous cliquez-dposez le composant directement partir de la mtadonne, vous naurez pas besoin de modifier ses proprits. Sinon, slectionnez loption Built-in et renseignez manuellement les champs de longlet Basic settings. Le fichier dentre contient les colonnes suivantes, spares par des points-virgules : id, name, category, year, language, director et cast.
Dans cette exemple, le champ Cast regroupe diffrentes valeurs et id sincrmente lorsque lon change de film. Si ncessaire, dfinissez le schma du tFileDelimitedInput en fonction de la structure du fichier.
1311
Composants XML
Une fois que vous avez vrifi que le schma du fichier dentre correspond vos attentes, cliquez sur OK pour valider. Puis slectionnez le composant tAdvancedFileOutputXML et cliquez sur la vue Component pour paramtrer ses proprits, ainsi que le mapping dans longlet Basic settings. Notez que vous pouvez directement double-cliquer sur le composant pour ouvrir linterface de mapping.
Dans le champ File Name, slectionnez le fichier qui sera crit la fin du Job, sil existe dj ou saisissez le chemin daccs et le nom du fichier qui seront crs automatiquement pour la sortie. Par dfaut, le schma (description du fichier) est automatiquement propag partir du flux dentre. Mais vous pouvez le modifier si ncessaire. Puis cliquez sur le bouton [...] ou double-cliquez sur le composant tAdvancedFileOutputXML dans lespace de modlisation pour ouvrir lditeur de mapping. Les colonnes du schma du fichier dentre sont listes gauche de linterface.
1312
Composants XML
A droite de linterface, configurez larbre XML afin quil reflte la structure du fichier de sortie. Vous pouvez soit crer la structure noeud par noeud. Pour plus dinformations sur la cration manuelle de larbre XML, consultez Dfinir un arbre XML page 1306. Dans cet exemple, un modle XML est utilis pour renseigner automatiquement larbre XML. Cliquez-droit sur le champ root tag qui apparat par dfaut et slectionnez loption Import XML tree la fin des options du menu contextuel. Dans la fentre Ouvrir, slectionnez le fichier XML importer et cliquez sur OK pour valider limport.
Vous pouvez importer la structure XML dun fichier au format XML, XSD et DTD.
Puis cliquez-dposez chaque champ de la colonne Schema List vers son lment correspondant dans larbre XML de la colonne XML tree tel que dcrit dans Mapping de donnes XML, page 1307. Le mapping apparat sous la forme dune flche bleue entre la zone de gauche et celle de droite.
Enfin, dans la colonne Node Status, dfinissez le statut du noeud sur lequel la boucle est effectue. Dans cet exemple, llment Cast correspondant llment Boucle puisque les donnes de ce champ dans le fichier dentre ne sont jamais les mmes. Cliquez-droit sur llment Cast de larbre XML et slectionnez loption Set as loop element. Pour regrouper les donnes par film, llment Movie doit aussi tre dfini comme lment Group. Cliquez-droit sur le noeud parent Movie de larbre XML et slectionnez loption Set as group element.
1313
Composants XML
Le statut slectionn parat sur la ligne de llment correspondant dans la colonne Node Status. Cliquez sur OK pour valider la configuration. Puis appuyez sur F6 pour excuter le Job.
Le fichier XML de sortie affiche la structure telle quelle a t dfinie.
1314
Composants XML
tDTDValidator
tDTDValidator
Proprits du tDTDValidator
Famille de composant XML
Le composant tDTDValidator valide un fichier XML entrant en fonction dune DTD et envoie les informations de validation la sortie dfinie. Ce composant permet de vrifier les donnes et la qualit de la structure du fichier trait Schema type 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. Le schma de ce composant est en lecture seule. Il contient les informations standard de validation de fichier. Chemin daccs au fichier DTD de rfrence. Chemin daccs au fichier XML valider. Saisissez un message afficher dans la console Run bas sur le rsultat de la comparaison.
DTD file XML file If XML is valid, display If XML is not valid detected, display Print to console Utilisation
Cochez cette case pour afficher le message de validation.
Ce composant peut tre utilis en standalone mais il est gnralement connect un composant de sortie pour rassembler les informations de validation. n/a
Limitation
Scnario : Valider un fichier XML

Ce scnario dcrit un Job permettant de valider plusieurs fichiers dun rpertoire et de transmettre les informations de validation des fichiers non valides dans un fichier dlimit.
Cliquez et dposez les composants suivants de la Palette : tFileList, tDTDValidator, tMap, tFileOutputDelimited. Connectez le tFileList et le tDTDValidator avec un lien Iterate et les composants restants avec des liens Row main.
1315
Composants XML
tDTDValidator
Paramtrez les proprits du composant tFileList afin quil rcupre les fichiers XML du rpertoire.
Dans le champ Filemask, saisissez le masque *.xml entre guillemets simples en Perl et guillemets doubles. Dcochez la case Case Sensitive. Dans la vue Component du composant tDTDValidate, le schma est en lecture seule puisquil contient des informations de validation standard. Paramtrez les proprits du fichier DTD utiliser comme rfrence, dans le champ DTD file.
Dans le champ Xml file, appuyez sur Ctrl+Espace pour accder la liste des variables globales et slectionnez la variable permettant de rcuprer le chemin daccs des fichiers : $_globals{tFileList_1}{CURRENT_FILEPATH} (en Perl) Dans les divers messages afficher dans la console Run, utilisez JobName pour afficher le libell du Job. Rappelez aussi le nom du fichier grce la variable : $_globals{tFileList_1}{CURRENT_FILE}. Saisissez votre message en tenant compte du langage utilis pour le Job, Perl ou Java, notamment pour lutilisation du point ou du plus. Cochez la case Print to Console. Dans le composant tMap, glissez-dposez les informations de validation du schma standard que vous souhaitez passer au fichier de sortie.
1316
Composants XML
tDTDValidator
Une fois que le schma de sortie est dfini, ajoutez un filtre de condition pour ne slectionner que les informations lorsque le fichier XML nest pas valide. Saisissez dabord la valeur souhaite pour cette variable, loprateur en fonction du type de donnes filtres puis la variable devant correspondre cette condition, ici (en Java et en Perl) : 0 == $row1[validate] Puis (si cela nest pas dj effectu) connectez le tMap au tFileOutputDelimited via un lien main row. Nommez-le errorsOnly. Dans longlet Basic settings du composant tFileOutputDelimited, paramtrez le chemin daccs de destination du fichier dlimit, les sparateurs de champs et lencodage. Enregistrez le Job et appuyez sur F6 pour lexcuter.
Dans la console de la vue Run, les messages dfinis apparaissent pour chaque fichier invalide. Au mme moment, le fichier de sortie est aliment avec les informations de validation.
1317
Composants XML
tExtractXMLField
tExtractXMLField
Proprits du tExtractXMLField
Fonction Objectif
Le composant tExtractXMLField lit la structure XML contenue dans les champs dun fichier ou dune table et en extrait les donnes. Le tExtractXMLField lit la structure XML contenue dans les champs dun fichier ou dune table, rcupre les donnes contenues dans cette structure et les envoie au composant suivant via un lien Row. 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. Schema type 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 rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. XML field Nom du champ XML traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio Noeud de larborescence XML sur lequel est bas la boucle. Column : reflte le schma tel quil est dfini dans lditeur Edit Schema. XPath Query : Saisissez les champs extraire de la structure Xml dentre. Get nodes : Cochez cette case pour rcuprer le contenu XML de tous les nuds courants spcifis dans le champ Xpath Query, ou cochez la case correspondant un nud spcifique pour ne rcuprer que le contenu du nud slectionn. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ou traite.
Basic settings
Loop XPath query Mapping
Limit
1318
Composants XML
tExtractXMLField
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.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log du Job, aussi bien au niveau du Job quau niveau de chaque composant. Ce composant doit tre utilis en composant intermdiaire. Il ncessite donc un composant dentre et de sortie. Il permet d'extraire des donnes d'un champ dlimit l'aide d'un lien Row > Main, et permet de crer un flux de rejet avec un lien Row > Reject, filtrant les donnes dont le type ne correspond pas au type dfini. n/a
Utilisation
Limitation
Scnario 1 : Extraire les donnes XML dun champ dune table de base de donnes
Ce scnario est compos de trois composants et permet de lire la structure XML contenue dans les champs dune base de donnes et den extraire les donnes.
Glissez les composants tMysqlInput de la famille Database > Mysql, tExtractXMLField de la famille Xml et un composant tFileOutputDelimited de la famille File > Output de la Palette dans le Job designer. Reliez les composants entre eux via des connexions de type Main > Row. Double-cliquez sur le composant tMysqlInput pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
1319
Composants XML
tExtractXMLField
Si votre schma est dj stock sous le noeud Db Connections dans le Repository, slectionnez loption Repository dans le champ Schema Type puis choisissez les mtadonnes appropries partir de la liste. Si vous navez encore dfini aucun schma, slectionnez loption Built-in et renseignez manuellement les informations de connexion et la structure des donnes dans un schma. Pour plus dinformations sur les proprits du composant tMysqlInput, consultez tMysqlInput page 487. Dans le champ Table Name, saisissez le nom de la table dont les champs contiennent les donnes XML. Dans ce scnario, la table se nomme customerdetails et ne contient quune seule colonne. Cliquez sur le bouton Guess Query pour rcuprer la requte correspondant votre schma. Dans le Job designer, double-cliquez sur le composant tExtractXMLField pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
1320
Composants XML
tExtractXMLField
Dans la liste droulante Property type, slectionnez loption Repository si la description de votre fichier est stocke dans une mtadonne du Repository. Si vous cliquez-dposez le composant directement partir de la mtadonne, vous naurez pas besoin de modifier ses proprits. Sinon, slectionnez loption Built-in et renseignez manuellement les champs suivants. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] ct du champ Edit schema pour consulter le schma. Dans la liste Xml field, slectionnez la colonne dont vous souhaitez extraire le contenu XML. La colonne se nomme CustomerDetails et est lunique colonne de la table customerdetails. Dans le champ Loop XPath query, saisissez le noeud de larborescence sur lequel effectuer la boucle afin de rcuprer les donnes. La colonne Column du tableau Mapping sera automatiquement renseigne avec la description du fichier que vous avez configur. Dans la colonne Xpath query, saisissez entre guillemet le noeud du champ XML contenant les donnes que vous voulez extraire. Dans ce scnario, nous souhaitons extraire les noms des clients donc saisissez CustomerName qui correspond llment Xml contenant cette information. Dans le Job designer, double-cliquez sur le composant tFileOutputDelimited pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
Dans le champ File Name, indiquez le rpertoire et le nom du fichier de sortie. Pour ce scnario, nous appelons le fichier CustomerNames.csv. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] ct du champ Edit schema pour consulter le schma. Enregistrez le Job et appuyez sur F6 pour lexcuter.
1321
Composants XML
tExtractXMLField
Le Job retourne les noms des clients contenus sous le noeud CustomerName du champ CustomerDetails de la table.
Scnario 2 : Extraire les donnes valides et les donnes errones partir dun champ XML dans fichier dlimit
Ce scnario est compos de quatre composants et permet de lire la structure XML contenue dans les champs dun fichier dlimit, den extraire les donnes et de rejeter les donnes errones.
A partir de la Palette, glissez dans le Job designer les composants tFileInputDelimited de la famille File > Input, tExtractXMLField de la famille Xml, tFileOutputDelimited de la famille File > Output et tLogRow de la famille Logs & Errors. Reliez les composants entre eux comme indiqu sur le schma ci-dessus. Double-cliquez sur le composant tFileInputDelimited pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
1322
Composants XML
tExtractXMLField
Slectionnez loption Built-in partir de la liste droulante Schema et renseignez manuellement les informations concernant le fichier dlimit dans les champs correspondants. Cliquez sur le bouton [...] ct du champ Edit schema pour afficher la bote de dialogue permettant de dfinir la structure des donnes, comme prsent ci-dessus. Cliquez sur le bouton [+] pour ajouter autant de lignes que ncessaire la structure des donnes. Dans cet exemple, il ny a quune seule colonne dans le schma : xmlStr. Cliquez sur OK pour valider vos changements et fermer la bote de dialogue.
Si vous avez pralablement stock votre schma dans le rpertoire Metadata sous File delimited, slectionnez loption Repository dans la liste droulante Schema puis cliquez sur le bouton [...] ct du champ pour afficher la bote de dialogue [Repository Content] paritr de laquelle vous pouvez slectionner un schma pertinent. Cliquez sur Ok pour fermer la bote de dialogue et remplir les champs automatiquement avec les mtadonnes contenues dans le schma. Pour plus dinformations sur le stockage des schmas de mtadonnes dans le Repository, consultez les sections Configurer un schma File Delimited et Dposer des composants du rpertoire Metadata du Guide Utilisateur de Talend Open Studio.
A partir de la liste Property type, slectionnez : -Repository si vous avez dj stock les mtadonnes de votre fichier dentre dans le Repository, les champs suivants sont alors renseigns automatiquement avec les informations stockes, ou -Built-in si aucune mtadonne nest stocke pour votre fichier dentre ; vous devez alors renseigner manuellement les champs suivants. Dans cet exemple, cest le mode Built-in qui est utilis. Dans le champ File Name, renseignez le chemin daccs ou cliquez sur le bouton [...] pour parcourir vos dossiers jusquau fichier traiter. Dans cet exemple, il sagit du fichier CustomerDetails_Error. Ce fichier csv stock localement contient une suite de lignes simples au format XML, spares par un double retour chariot.
1323
Composants XML
tExtractXMLField
Dans le champ Row Separator, renseignez le sparateur de lignes, ici le double retour chariot. Dans le champ Field Separator, renseignez le sparateur de champ, aucun ici. Dans cet exemple, il ny a pas den-tte (Header), de pied de page (Footer) ou de nombre limite de lignes traiter (Limit). Dans lespace graphique, double-cliquez sur le composant tExtractXMLField pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
A partir de la liste Property type, slectionnez : -Repository si vous avez dj stock les mtadonnes de votre fichier dentre dans le Repository, les champs suivants sont alors renseigns automatiquement avec les informations stockes, ou -Built-in si aucune mtadonne nest stocke pour votre fichier dentre ; vous devez alors renseigner manuellement les champs suivants. Dans cet exemple, cest le mode Built-in qui est utilis. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] ct du champ Edit schema pour consulter le schma ou le modifier. La colonne Column du tableau Mapping sera automatiquement renseigne avec lae schma dfini. Dans la liste Xml field, slectionnez la colonne dont vous souhaitez extraire le contenu XML. Dans cet exemple, la colonne se nomme xmlStr. Dans le champ Loop XPath query, saisissez le noeud de larborescence sur lequel effectuer la boucle afin de rcuprer les donnes. Dans la colonne Xpath query, saisissez entre guillemets le noeud du champ XML contenant les donnes que vous voulez extraire. Dans le Job designer, double-cliquez sur le composant tFileOutputDelimited pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
1324
Composants XML
tExtractXMLField
Choisissez le mode Built-in dans la liste droulante Property Type. Dans le champ File Name, indiquez le rpertoire et le nom du fichier de sortie. Pour ce scnario, nous appelons le fichier CustomerNames_right.csv. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] ct du champ Edit schema pour consulter le schma ou le modifier. Dans le Job designer, double-cliquez sur le composant tLogRow pour paramtrer ses proprits dans longlet Basic settings de la vue Component. Cliquez sur le bouton Sync Columns pour rcuprer le schma du composant prcdent. Pour plus dinformations sur le composant tLogRow, consultez le chapitre tLogRow, page 1095. Enregistrez le Job et appuyez sur F6 pour lexcuter.
Le composant tExtractXMLField lit et extrait dans un fichier dlimit en sortie, CustomerNames_right dans cet exemple, les informations concernant les clients dont la structure XML est correcte, et affiche les lignes errones dans la console de log.
1325
Composants XML
tFileInputXML
tFileInputXML
Proprits du tFileInputXML
Fonction Objectif
Le composant tFileInputXML lit un fichier XML structur ou un flux de donnes et extrait les donnes ligne par ligne. Ce composant lit un fichier XML 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 de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Schema type 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 rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. File name/Stream File name : Chemin daccs et nom du fichier, et/ou variable traiter. Stream : Flux de donnes traiter. Les donnes doivent pralablement tre mises en flux afin dtre rcupres par le tFileInputXML via la variable INPUT_STREAM disponible dans la liste dauto-compltion (Ctrl+Espace). Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Loop XPath query Noeud de larborescence sur lequel la boucle est base.
Basic settings
1326
Composants XML
tFileInputXML
Mapping
Column : Colonnes mapper. Elles refltent le schma dfini par le champ Schema type. XPath Query : Saisissez les champs extraire de lentre structure. Get nodes : Cochez cette case pour rcuprer le contenu XML de tous les nuds courants spcifis dans le champ Xpath Query, ou cochez la case correspondant un nud spcifique pour ne rcuprer que le contenu du nud slectionn. Loption Get Nodes fonctionne en mode DOM4j et SAX, cependant avec le mode SAX, les noms despace ne sont pas supports. Pour plus dinformations concernant les modes DOM4j et SAX, consultez les proprits de la liste Generation mode de longlet Advanced settings. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ou traite. Si -1, toutes les lignes sont lues ou traites, qiuelque soit le nombre. 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 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. Cochez cette case pour ignorer les espaces de noms. Generate a temporary file : renseignez le chemin daccs et le nom du fichier temporaire XML. Cochez cette case pour sparer les valeurs des noeuds fils concatnes. Ce champ ne peut tre utilis que si vous avez slectionn le mode Xerces dans le champ Generation mode. Le champs Field separator apparat : Dfinissez le sparateur utiliser pour sparer les valeurs
Limit
Die on error
Advanced settings
Ignore the namespaces Use Separator for mode Xerces
Encoding Type
1327
Composants XML
tFileInputXML
Generation mode
Slectionnez dans la liste droulante le mode de gnration du fichier XML en fonction de la disponibilit de votre mmoire et de la rapidit souhaite. -Fast and memory-consuming (Dom4j) : plus rapide mais consommateur de mmoire, -Memory-consuming (Xerces) : consommateur de mmoire, -Less memory consumed (SAX) :moins consommateur de mmoire. Lorsque que vous utilisez loption Get Nodes du tableau Mapping de longlet Basic settings avec le mode de gnration SAX, les noms despace ne sont pas supports.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log du Job, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Ce composant doit tre utilis en tant que composant dentre. Il permet de crer un flux de donnes XML laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1330. n/a
Limitation
Scnario 1 : Extraire des adresses XML

Ce scnario trs basique est constitu de deux composants : un composant tFileInputXML qui extrait des donnes du fichier XML contenant des adresses et un composant tLogRow qui affiche le rsultat de cette opration dans la console Run via le composant tLogRow.
Slectionnez un composant tFileInputXML dans le dossier File de la Palette. Cliquez et dposez galement un composant tLogRow et connectez ces deux composants. Dans longlet Basic settings du composant tFileInputXML, dfinissez les proprits :
1328
Composants XML
tFileInputXML
Le fichier XML contenant les adresses a t pralablement dfini dans la zone Metadata, par consquent rcuprez ses proprits en slectionnant Repository dans Property type. De cette manire, les proprits sont automatiquement rcupres et le reste des champs est renseign ( lexception du Schma). Pour plus dinformations concernant lassistant de cration de mtadonnes, consultez du Guide utilisateur de Talend Open Studio. De la mme manire, slectionnez le schma appropri dans la liste de mtadonnes du Repository. Cliquez sur Edit schema si vous souhaitez modifier le schma charg. Dans le champ Filename, indiquez le fichier structur dentre. Dans le champ Loop XPath query, modifiez le noeud de boucle si ncessaire. Dans la table de Mapping, renseignez les champs extraire et afficher dans la sortie. Si le fichier est volumineux, dfinissez un nombre de ligne maximum traiter dans le champ Limit. Saisissez lencodage si ncessaire, puis double-cliquez sur tLogRow pour dfinir le caractre sparateur. Enfin, appuyez sur F6 ou cliquez sur le bouton Run dans la vue Run pour excuter le Job. Dans la console, les champs dfinis sont extraits du fichier XML structur et sont affichs.
1329
Composants XML
tFileInputXML
Scnario 2 : Extraire les donnes XML errones dans un flux de rejet

Ce scnario dcrit un Job trois composants qui permet de lire un fichier XML et : dune part, de retourner les donnes XML correctes dans un autre fichier XML, et dautre part, dafficher dans la console de log les donnes errones dont le type ne correspond pas au type dfini.
A partir de la Palette, glissez les composants tFileInputXML, tFileOutputXML et tLogRow dans lespace de modlisation. Cliquez-droit sur le composant tFileInputXML, slectionnez Row > Main dans le menu contextuel, et cliquez sur le composant tFileOutputXML pour crer le lien. Cliquez-droit sur le composant tFileInputXML, slectionnez Row > Reject dans le menu contextuel, et cliquez sur le composant tLogRow pour crer le lien de rejet. Double-cliquez sur le composant tFileInputXML pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
1330
Composants XML
tFileInputXML
Dans la liste Property Type, slectionnez Repository et cliquez sur le bouton [...] pour afficher la bote de dialogue [Repository Content] partir de laquelle vous pouvez slectionner la mtadonne relative votre fichier si vous lavez stock sous le noeud File xml du rpertoire Metadata du Repository. Les champs suivants seront renseigns automatiquement. Sinon, slectionnez le mode Built-in et renseignez ces champs manuellement. Pour plus dinformations sur le stockage des schmas de mtadonnes dans le Repository, consultez les sections Configurer un Schma File XML et Dposer des composants du rpertoire Metadata du Guide Utilisateur de Talend Open Studio. Dans le champ Schema Type, slectionnez Repository et cliquez sur le bouton [...] pour slectionner le schma dcrivant la structure de votre fichier si vous lavez stock dans le Repository. Sinon, cliquez sur le bouton [...] ct du champ Edit schema et dfinissez le schma manuellement.
Dans cet exemple, le schma comprend cinq colonnes : id, CustomerName, CustomerAddress, idState et id2. Cliquez sur le bouton [...] ct du champ Filename et indiquez le chemin daccs au fichier XML. Dans le champ Loop XPath query, saisissez, entre guillemets, le chemin du noeud sur lequel effectuer une boucle. Dans la table Mapping, la colonne Column est automatiquement renseigne avec les colonnes dfinies dans le schma. Dans la colonne XPath query, saisissez entre guillemets le noeud du fichier XML contenant les donnes que vous voulez extraire dans la colonne correspondante. Dans le champ Limit, saisissez le nombre de lignes traiter. Dans ce scnario, nous traitons les 10 premires lignes. Double-cliquez sur le composant tFileOutputXML pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
1331
Composants XML
tFileInputXML
Cliquez sur le bouton [...] ct du champ File Name pour slectionner le rpertoire de destination du fichier et saisissez le nom du fichier. Dans ce scnario, nous appelons le fichier customer_data.xml. Dans le champ Row tag, saisissez entre guillemets le nom que vous souhaitez donner la balise contenant les donnes. Cliquez sur Edit schema et assurez-vous que le schma est rcupr du schma dentre. Si ncessaire, cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Double-cliquez sur le composant tLogRow pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits. Cliquez sur Edit schema et assurez-vous que le schma est rcupr du schma dentre. Si ncessaire, cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Dans la zone Mode, slectionnez loption Vertical. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
1332
Composants XML
tFileInputXML
Le fichier customer_data.xml contenant les donnes correctes est cr et les donnes errones sont affiches dans la console de la vue Run.
1333
Composants XML
tFileOutputXML
tFileOutputXML
Proprits de tFileOutputXML
Le composant tFileOutputXML produit en sortie des donnes sous forme de fichier de type XML. Le tFileOutputXML crit dans un fichier XML des donnes spares selon un schma spcifi. File name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinition des Contextes et des Variables du Guide utilisateur de Talend Open Studio. Root tag Row tag Column name as tag name Split output in files Schema type et Edit Schema Enveloppe les donnes et la structure entire du fichier de sortie. Enveloppe les donnes et la structure de chaque ligne. Cochez cette case pour rcuprer les libells de colonnes du schma dentre et les utiliser comme balise XML. Si le fichier XML en sortie et volumineux, vous pouvez scinder ce fichier en plusieurs parties. 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. 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 dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Sync columns Cliquez sur ce bouton pour synchroniser le schma de sortie avec le schma dentre. La fonction Sync ne saffiche que si une connexion de type Row est lie au composant 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
1334
Composants XML
tFileOutputXML
Utilisez ce composant pour crire dans un fichier XML des donnes rcupres dautres composants laide dune connexion de type Row. n/a
Scnario : Utiliser un format de sortie XML

Un scnario utilisant le composant tFileOutputXML est dcrit dans le Scnario : Transformer un fichier positionnel en XML, page 922.
1335
Composants XML
tWriteXMLField
tWriteXMLField
Proprits du tWriteXMLField
Le composant tWriteXMLField lit un fichier XML dentre, en extrait la structure et linsre dans les champs du fichier ou de la table de sortie. Le tWriteXMLField lit un fichier XML dentre, extrait la structure du fichier et linsre dans les champs du fichier ou de la table de sortie. Output Column Configure Xml Tree Slectionnez la colonne du composant de sortie dans laquelle vous souhaitez crire la structure XML. Ouvre linterface daide la cration de la structure XML crire dans un champ. Pour plus dinformations sur linterface, consultez Dfinir un arbre XML page 1306. 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 dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Sync columns Cliquez sur ce bouton pour synchroniser le schma de sortie avec celui dentre. La fonction Sync ne saffiche que si une connexion de type Row est lie au composant de sortie. Slectionnez la colonne utiliser pour regrouper les donnes. Cochez cette case si vous ne souhaitez pas inclure la dclaration XML. Cette case est coche par dfaut. Si le contenu de la colonne Related Column de linterface permettant de crer la structure XML est nul, ou si aucune colonne nest associe au noeud XML, cette option crera une balise ouvrante et une balise fermante aux endroits prvus.
Group by Advanced settings Remove the xml declaration Create empty element if needed
1336
Composants XML
tWriteXMLField
Create associated XSD file
Si lun des lments XML est associ un espace de nommage, cette option crera le fichier XSD correspondant. Pour utiliser cette option, vous devez slectionner le mode de gnration Dom4J dans la liste Generation mode. Cochez cette case pour modifier les sparateurs utiliss par dfaut dans les nombres. Thousands separator : saisissez entre guillemets le sparateur utiliser pour les milliers. Decimal separator : saisissez entre guillemets le sparateur utiliser pour les dcimales. Slectionnez le mode de gnration le plus rapide mais consommant de la mmoire (Fast but memory-consuming - Dom4J) ou le plus lent ne consommant pas de mmoire (Slow with no memory consumed) en fonction de votre mmoire disponible. 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.
Generation mode
Encoding Type
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant doit tre utilis en composant intermdiaire. Il ncessite donc un composant dentre et de sortie. n/a
Scnario : Extraire la structure dun fichier XML et linsrer dans les champs dune base de donnes
Ce scnario est compos de trois composants et permet de lire un fichier XML, den extraire la structure puis de transmettre cette structure dans les champs dune table.
Glissez les composants tFileInputXml et tWriteXMLField de la famille Xml et un composant tMysqlOutput de la famille Database > Mysql de la Palette dans le Job designer. Reliez ces composants via des liens de type Row > Main. Double-cliquez sur le composant tFileInputXml pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
1337
Composants XML
tWriteXMLField
Dans la liste droulante Property type, slectionnez loption Repository si la description de votre fichier est stocke dans une mtadonne du Repository. Si vous cliquez-dposez le composant directement partir de la mtadonne, vous naurez pas besoin de modifier ses proprits. Sinon, slectionnez loption Built-in et renseignez manuellement les champs suivants. Pour plus dinformations sur les proprits du composant tFileInputXML, consultez tFileInputXML page 1326. Si vous avez slectionnez loption Built-in, cliquez sur le bouton [...] ct du champ Edit schema puis dans la bote de dialogue, dcrivez manuellement la structure de votre fichier. Dans le champ Look Xpath query, saisissez sur quel noeud du fichier la boucle doit tre effectue. Pour ce scnario, la boucle est effectue sur le noeud customer. La colonne Column du tableau Mapping sera automatiquement renseigne avec la description du fichier que vous avez configur. Dans la colonne Xpath query, saisissez entre guillemet le noeud du fichier XML contenant les donnes correspondant la colonne de gauche. Cliquez sur le composant tWriteXMLField dans le Job designer puis cliquez sur la vue Component pour lafficher et paramtrer les proprits du composant :
Cliquez sur le bouton [...] ct du champ Edit schema et, dans la bote de dialogue, ajoutez une ligne en cliquant sur le bouton (+).
1338
Composants XML
tWriteXMLField
Dans cette ligne, saisissez le nom de la colonne de votre flux de sortie que vous souhaitez renseigner avec la structure du fichier XML dans la zone de droite, CustomerDetails dans ce scnario. Dans la colonne Type de cette ligne, indiquez quelle est de type String et dans la colonne Length, indiquez quelle est de longueur 255. Cliquez sur Ok pour valider votre schma de sortie et retourner aux proprits du composant. Dans le champ Output Column, slectionnez la colonne dans laquelle vous souhaitez insrer le contenu XML. Cliquez sur le bouton [...] du champ Configure Xml Tree pour ouvrir linterface daide la cration de structures XML.
Dans la zone Link Target, cliquez sur le noeud rootTag et renommez-le CustomerDetails. Dans la zone Linker source, slectionnez CustomerName et CustomerAddress et glissez-les sur le noeud CustomerDetails. Une bote de dialogue souvre vous demandant quel type daction vous souhaitez effectuer : slectionnez Create as sub-element of target node afin de crer des sous-lments au noeud CustomerDetails. Cliquez-droit sur llment CustomerName et slectionnez loption Set As Loop Element dans le menu. Cliquez sur OK.
1339
Composants XML
tWriteXMLField
Dans le Job designer, double-cliquez sur le composant tMysqlOutput pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
Si votre schma est dj stock sous le noeud Db Connections dans le Repository, slectionnez loption Repository dans le champ Schema Type puis choisissez les mtadonnes appropries partir de la liste. Si vous navez encore dfini aucun schma, slectionnez loption Built-in et renseignez manuellement les informations de connexion et la structure des donnes dans un schma. Pour plus dinformations sur les proprits du composant tMysqlOutput, consultez tMysqlOutput page 495. Dans le champ Table, saisissez le nom de la table dont les champs contiendront les donnes XML. Dans le champ Action on table, slectionnez lopration que vous souhaitez effectuer sur la table. Pour ce scnario, slectionnez Create table pour crer la table. Dans le champ Action on data, slectionnez lopration que vous souhaitez effectuer sur les donnes. Pour ce scnario, laissez loption Insert. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] ct du champ Edit schema pour consulter le schma. Enregistrez le Job et appuyez sur F6 pour lexcuter.
1340
Composants XML
tWriteXMLField
Chaque champ de la colonne CustomerDetails est renseigne avec la structure XML du fichier de dpart : linstruction de traitement XML <?xml version=""1.0"" encoding=""ISO-8859-15""?>, le premier noeud sparant chaque client <CustomerDetails> et les informations sur les clients <CustomerAddress> et <CustomerName>.
1341
Composants XML
tXSDValidator
tXSDValidator
Proprits du tXSDValidator
Fonction
Le composant tXSDValidator valide un fichier XML entrant en fonction dun fichier XSD et envoie les informations de validation la sortie dfinie. Ce composant permet de vrifier les donnes et la qualit de la structure du fichier trait Schema type 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. Le schma de ce composant est en lecture seule. Il contient les informations standard de validation de fichier. Chemin daccs au fichier XSD de rfrence. Chemin daccs au fichier XML valider. Saisissez un message afficher dans la console Run bas sur le rsultat de la comparaison.
XSD file XML file If XML is valid, display If XML is not valid detected, display Print to console Usage
Cochez cette case pour afficher le message de validation.
Ce composant peut tre utilis en standalone mais il est gnralement connect un composant de sortie pour rassembler les informations de validation. n/a
Limitation
Scnario associ
Pour plus dinformation sur lutilisation du composant tXSDValidator, consultez le Scnario : Valider un fichier XML, page 1315
1342
Composants XML
tXSLT
tXSLT
Proprits du tXSLT
Le composant tXSLT tient compte dune feuille de style XSL pour transformer un fichier source XML et lenvoyer vers la sortie dfinie. Le tXSLT permet de transformer une structure de donnes en une autre structure. XML file XSL file Output file Chemin daccs au fichier XML transformer. Chemin daccs au fichier XSL de rfrence. Chemin daccs du fichier de sortie. Si le fichier nexiste pas, il sera cr. Le fichier de sortie peut tre nimporte quel fichier structur ou non tels que html, xml, txt ou mme pdf ou edifact en fonction de votre fichier xsl. Cliquez sur le bouton [+] pour ajouter de nouvelles lignes la liste Parameters et dfinir les paramtres de transformation du fichier XSLT. Pour chaque ligne, renseignez la cl dans la colonne name et sa valeur associe dans la colonne value.
Parameters
Scnario : Transformer un fichier XML en HTML laide dune feuille de style XSL
Ce scnario dcrit un Job deux composants appliquant une feuille de style XSL un fichier XML et gnre un fichier HTML en sortie. Il permet galement de dfinir un paramtre de transformation pour la feuille de style XSL afin de changer la couleur de larrire plan de len-tte dans le document HTML cr en sortie. A partir de la Palette, cliquez et dposez un composant tXSLT et un tMsBox dans lespace graphique.
Double-cliquez sur le tXSLT pour ouvrir la vue Basic settings et paramtrer le composant.
1343
Composants XML
tXSLT
Dans le champ XML file, renseignez le chemin daccs ou parcourez vos dossiers jusquau fichier XML transformer. Dans cet exemple, il sagit dune liste de titres MP3 et leurs informations associes (nom de lartiste, maison de disque...).
Dans le champ XSL file de la vue Basic settings, renseignez le chemin daccs ou parcourez vos dossiers jusquau fichier XSL appropri. Dans le champ Output file, renseignez le chemin daccs ou parcourez vos dossiers jusquau fichier HTML. Dans cet exemple, nous souhaitons convertir les donnes XML en fichier HTML comprenant un tableau constitu dun en-tte suivi de la liste du nom des artistes ct du nom des chansons.
1344
Composants XML
tXSLT
Dans la zone Parameters de la vue Basic settings, cliquez sur le bouton [+] pour ajouter une ligne o dfinir le nom et la valeur du paramtre de transformation du fichier XSL. Dans cet exemple, le nom du paramtre de transformation utilis est bgcolor et sa valeur est green. Double-cliquez sur le tMsgBox pour afficher la vue Basic settings et paramtrer le composant.
1345
Composants XML
tXSLT
Enregistrez votre Job puis appuyez sur F6 pour lexcuter. Une bote de dialogue saffiche et vient confirmer que le fichier HTML est bien cr en sortie et quil est stock lendroit pralablement dfini.
Cliquez sur Ok pour fermer la bote de dialogue. Vous pouvez dsormais ouvrir le fichier HTML cr pour vrifier la transformation des donnes XML et la couleur darrire-plan de len-tte du tableau.
1346
A Alias ........................................................... 813 B Business tCentricCRMInput ................................. 80 tCentricCRMOutput ............................... 81 tHL7Input ............................................... 82 tMicrosoftCRMInput ............................. 86 tMicrosoftCRMOutput ........................... 94 tMSAXInput .......................................... 96 tMSAXOutput ........................................ 97 tOpenbravoERPInput ........................... 104 tOpenBravoERPOutput ....................... 106 tSalesforceBulkExec ............................ 107 tSalesforceConnection ......................... 109 tSalesforceGetDeleted ......................... 110 tSalesforceGetServerTimestamp ......... 113 tSalesforceGetUpdated ........................ 114 tSalesforceInput ................................... 116 tSalesforceOutput ................................. 118 tSalesforceOutputBulk ......................... 122 tSalesforceOutputBulkExec ................. 128 tSAPCommit ........................................ 133 tSAPRollback ....................................... 150 tSugarCRMInput .................................. 151 tSugarCRMOutput ............................... 154 tVtigerCRMInput ................................. 155 tVtigerCRMOutput .............................. 156 Business Intelligence tDB2SCD ................................................. 2 tIGreenplumSCD ..................................... 7 tInformixSCD .......................................... 9 tIngresSCD ............................................. 11 tMondrianInput ...................................... 13 tMSSqlSCD ........................................... 17 tMysqlSCD ............................................ 19 tOracleSCD ............................................ 36 tParAccelSCD ........................................ 40 tSPSSInput ............................................. 52 tSPSSOutput .......................................... 56 tSPSSProperties ..................................... 59 tSPSSStructure ....................................... 60 tSybaseSCD ........................................... 61 BusinessIntelligence
PostgresPlusSCD ....................................42 PostgresqlSCD ........................................47 C Component, Composant ........1, 175, 207, 857, 1165, .........................................................1281 Contexte ....................................................1265 Custom Code tJava ......................................158, 159, 161 tJavaFlex ...............................164, 171, 172 CustomCode tGroovy .................................................158 tGroovyFile ...........................................159 tJava ......................................................161 tJavaFlex ...............................................164 tJavaRow ..............................................171 tLibraryLoad .........................................172 D Data Quality tAddCRCRow .......................................176 tFuzzyMatch .........................................180 tIntervalMatch ......................................186 tParseAddress .......................................191 tParseName ...........................................193 tReplaceList ..........................................195 tSchemaComplianceCheck ...................199 tUniqRow .............................................204 Data quality tAddCRCRow ...............................176, 191 Database PostgresPlusOutput ...............................640 tAccessInput .........................................208 tAccessOutput .......................................210 tAccessRow ..........................................213 tAS400Close .........................................216 tAS400Commit .....................................215 tAS400Connection ...............................217 tAS400Input .........................................219 tAS400LastInsertId ...............................221 tAS400Output .......................................222 tAS400Rollback ...................................226 tAS400Row ..........................................227 tDB2BulkExec ......................................235 tDB2Close ............................................238
tDB2Commit ........................................ 239 tDB2Connection .................................. 240 tDB2Input ............................................ 242 tDB2Output .......................................... 245 tDB2Rollback ...................................... 249 tDB2Row ............................................. 250 tDB2SCD ..................................... 253, 987 tDB2SCDELT .................................. 4, 254 tDB2SP ................................................ 255 tDBInput ...................................... 257, 906 tDBOutput ............................................ 262 tDBSQLRow ........................................ 267 tEXAInput ............................................ 271 tEXAOutput ......................................... 273 tEXARow ............................................. 277 tEXistConnection ................................. 279 tFirebirdClose ...................................... 292 tFirebirdCommit .................................. 293 tFirebirdConnection ............................. 294 tFirebirdInput ....................................... 296 tFirebirdOutput .................................... 298 tFirebirdRollback ................................. 301 tFirebirdRow ........................................ 302 tFixedFlowInput ................................. 1125 tGreenplumBulkExec ........................... 305 tGreenplumClose ................................. 308 tGreenplumCommit ............................. 309 tGreenplumConnection ........................ 310 tGreenplumInput .................................. 312 tGreenplumOutput ............................... 314 tGreenplumOutputBulk ....................... 318 tGreenplumOutputBulkExec ............... 320 tGreenplumRollback ............................ 322 tGreenplumRow ................................... 323 tGreenplumSCD ................................... 326 tHiveClose ........................................... 327 tHiveConnection .................................. 328 tHiveRow ............................................. 330 tHSQLDbInput ..................................... 333 tHSQLDbOutput .................................. 335 tHSQLDbRow ..................................... 339 tInformixBulkExec .............................. 342 tInformixClose ..................................... 345 tInformixCommit ................................. 346 tInformixConnection ............................ 347
tInformixInput ......................................349 tInformixOutput ....................................351 tInformixOutputBulk ............................355 tInformixOutputBulkExec ....................357 tInformixRollback ................................360 tInformixRow .......................................361 tInformixSCD .......................................364 tInformixSP ..........................................365 tIngresClose ..........................................368 tIngresCommit ......................................369 tIngresConnection .................................370 tIngresInput ...........................................371 tIngresOutput ........................................373 tIngresRollback .....................................376 tIngresRow ...........................................377 tIngresSCD ...........................................379 tInterbaseClose .....................................380 tInterbaseCommit .................................381 tInterbaseConnection ............................382 tInterbaseInput ......................................384 tInterbaseOutput ...................................386 tInterbaseRollback ................................390 tInterbaseRow .......................................391 tJavaDBInput ........................................394 tJavaDBOutput .....................................396 tJavaDBRow .........................................399 tJDBCClose ..........................................403 tJDBCColumnList ................................402 tJDBCCommit ......................................404 tJDBCConnection .................................405 tJDBCInput ...........................................407 tJDBCOutput ........................................410 tJDBCRollback .....................................414 tJDBCRow ............................................415 tJDBCSP ...............................................418 tJDBCTableList ....................................420 tLDAPAttributesInput ..........................421 tLDAPInput ..........................................424 tLDAPOutput .......................................428 tLDAPRenameEntry .............................433 tMaxDBInput ........................................435 tMaxDBOutput .....................................437 tMaxDBRow .........................................440 tMSSqlBulkExec ..................................442 tMSSqlClose .........................................445
ii
tMSSqlCommit .................................... 447 tMSSqlConnection ............................... 448 tMSSqlInput ......................................... 450 tMSSqlLastInsertId .............................. 453 tMSSqlOutput .............................. 453, 454 tMSSqlOutputBulk .............................. 459 tMSSqlOutputBulkExec ...................... 461 tMSSqlRollback ................................... 464 tMSSqlRow .......................................... 465 tMSSqlSCD ......................................... 468 tMSSqlSP ............................................. 469 tMSSqlTableList .................................. 472 tMysqlBulkExec .......... 305, 473, 548, 605 tMysqlClose ......................................... 476 tMysqlColumnList ............................... 477 tMysqlCommit .... 216, 238, 239, 292, 293, 308, . 309, 327, 345, 346, 368, 369, 380, . 381, 402, 403, 404, 420, 445, 446, . 447, 472, 476, 477, 481, 543, 551, . 552, 573, 574, 604, 608, 609, 633, . 634, 657, 658, 685, 686, 705, 706, .......... 736, 737, 765, 766, 793 tMysqlConnection 217, 240, 279, 294, 310, . 328, 347, 370, 382, 405, 448, 482, 553, . 575, 610, 635, 659, 687, 707, 738, .......................................... 767 tMysqlInput .................................. 487, 769 tMysqlLastInsertId ............................... 490 tMysqlOutput ............................... 495, 772 tMysqlOutputBulk ............................... 514 tMysqlOutputBulkExec ....................... 520 tMysqlRollback ... 150, 221, 226, 249, 301, 322, . 360, 376, 390, 464, 490, 524, 562, . 624, 648, 697, 727, 756, 780, 843 tMysqlRow ................................... 526, 563 tMysqlSCD .......................................... 536 tMysqlSCDELT ............................. 32, 537 tMysqlSP .............................................. 538 tMysqlTableList ................................... 543 tNetezzaBulkExec ................................ 548 tNetezzaClose ...................................... 551 tNetezzaCommit .................................. 552 tNetezzaConnection ............................. 553 tNetezzaInput ....................................... 555
tNetezzaOutput .....................................558 tNetezzaRollback ..................................562 tNetezzaRow .........................................563 tOracleBulkExec ...................................566 tOracleClose .........................................573 tOracleCommit .....................................574 tOracleConnection ................................575 tOracleInput ..........................................577 tOracleOutput .......................................580 tOracleOutputBulk ...............................585 tOracleOutputBulkExec .......................587 tOracleRollback ....................................591 tOracleRow ...........................................592 tOracleSCD .....................................35, 595 tOracleSCDELT .............................37, 596 tOracleSP ..............................................597 tOracleTableList ...................................604 tParAccelBulkExec ...............................605 tParAccelClose .....................................608 tParAccelCommit .................................609 tParAccelConnection ............................610 tParAccelInput ......................................612 tParAccelOutput ...................................615 tParAccelOutputBulk ...........................619 tParAccelOutputBulkExec ...................621 tParAccelRollback ................................624 tParAccelRow .......................................625 tParAccelSCD .......................................628 tPosgtresqlOutput .................................664 tPostgresPlusBulkExec .........................630 tPostgresPlusClose ...............................633 tPostgresPlusCommit ...........................634 tPostgresPlusConnection ......................635 tPostgresPlusInput ................................637 tPostgresPlusOutputBulk ......................644 tPostgresPlusOutputBulkExec ..............646 tPostgresPlusRollback ..........................648 tPostgresPlusRow .................................649 tPostgresPlusSCD .................................652 tPostgresPlusSCDELT ...................44, 653 tPostgresqlBulkExec .............................654 tPostgresqlClose ...................................657 tPostgresqlCommit ...............................658 tPostgresqlConnection ..........................659 tPostgresqlInput ....................................661
iii
tPostgresqlOutputBulk ......................... 668 tPostgresqlOutputBulkExec ................. 670 tPostgresqlRollback ............................. 676 tPostgresqlRow .................................... 673 tPostgresqlSCD .................................... 677 tPostgresqlSCDELT ....................... 49, 678 tSASInput ............................................. 679 tSASOutput .......................................... 681 tSQLiteClose ........................................ 685 tSQLiteCommit .................................... 686 tSQLiteConnection .............................. 687 tSQLiteInput ........................................ 689 tSQLiteOutput ...................................... 693 tSQLiteRollback .................................. 697 tSQLiteRow ......................................... 698 tSybaseBulkExec ................................. 702 tSybaseClose ........................................ 705 tSybaseCommit .................................... 706 tSybaseConnection ............................... 707 tSybaseInput ......................................... 709 tSybaseIQBulkExec ............................. 712 tSybaseIQOutputBulkExec .................. 715 tSybaseOutput ...................................... 718 tSybaseOutputBulk .............................. 722 tSybaseOutputBulkExec ...................... 724 tSybaseRollback ................................... 727 tSybaseRow ......................................... 728 tSybaseSCD ......................................... 731 tSybaseSCDELT ............................ 63, 732 tSybaseSP ............................................. 733 tTeradataClose ..................................... 736 tTeradataCommit ................................. 737 tTeradataConnection ............................ 738 tTeradataFastExport ............................. 740 tTeradataFastLoad ............................... 742 tTeradataFastLoadUtility ..................... 744 tTeradataInput ...................................... 746 tTeradataMultiLoad ............................. 749 tTeradataOutput ................................... 751 tTeradataRollback ................................ 756 tTeradataRow ....................................... 757 tTeradataTPump ................................... 760 tVerticaBulkExec ................................. 762 tVerticaClose ....................................... 765 tVerticaCommit ................... 293, 766, 793
tVerticaConnection ...............................767 tVerticaInput .........................................769 tVerticaOutput ......................................772 tVerticaOutputBulk ..............................776 tVerticaOutputBulkExec ......................778 tVerticaRollback ...................................780 tVerticaRow ..........................................781 Database Utilities tCreateTable .........................................230 tParseRecordSet ....................................629 Databases tEXistDelete .........................................280 tEXistGet ..............................................282 tEXistList ..............................................284 tEXistPut ...............................................286 tEXistXQuery .......................................288 tEXistXUpdate .....................................290 DataQuality tIntervalMatch ......................................186 E ELT tELTAggregate .....................................786 tELTCommit .........................................793 tELTFilterColumns ...............................795 tELTFilterRows ....................................797 tELTJDBCInput ...................................799 tELTJDBCMap .....................................801 tELTJDBCOutput .................................803 tELTMSSqlInput ..................................805 tELTMSSqlMap ...................................807 tELTMSSqlOutput ...............................809 tELTMysqlInput ...799, 805, 811, 837, 845 tELTMysqlMap ....801, 807, 812, 839, 847 tELTMysqlOutput 803, 809, 821, 841, 849 tELTOracleInput ...................................823 tELTOracleMap ....................................824 tELTOracleOutput ................................829 tELTPostgresqlInput .............................837 tELTPostgresqlMap ..............................839 tELTPostgresqlOutput ..........................841 tELTRollback .......................................843 tELTSybaseInput ..................................845 tELTSybaseMap ...................................847 tELTSybaseOutput ...............................849
iv
tELTTeradataInput ............................... 851 tELTTeradataMap ................................ 852 tELTTeradataOutput ............................ 854 F File tApacheLogInput ................................. 859 tCreateTemporaryFile .......................... 862 tExtractPositionalFields ..................... 1199 tExtractRegexFields ........................... 1201 tFileArchive ......................................... 867 tFileCompare ....................................... 870 tFileCopy ............................................. 873 tFileDelete .................................... 875, 877 tFileExist .............................................. 877 tFileInputARFF .................................... 882 tFileInputDelimited ..... 859, 882, 886, 893, 909, ..... 915, 976, 977, 1282, 1288, 1293 tFileInputExcel ..................................... 906 tFileInputFullRow ................................ 909 tFileInputJSON .................................... 912 tFileInputLDIF ..................................... 915 tFileInputMail ...................................... 917 tFileInputPositional ..... 920, 925, 927, 952, 965, .......................................... 966 tFileInputRegex ................................... 931 tFileInputXML .. 912, 935, 936, 968, 1318, 1326, ...................................... 1336 tFileList .... 179, 862, 940, 994, 1134, 1149 tFileOutputARFF ................................. 944 tFileOutputDelimited ........................... 946 tFileOutputExcel .................. 957, 974, 999 tFileOutputLDIF .................................. 959 tFileOutputMSDelimited ..................... 952 tFileOutputMSPositional ..................... 965 tFileOutputPositional ........................... 963 tFileOutputXML ........................ 967, 1334 tFileProperties ...................................... 974 tFileRowCount ..................................... 976 tFileTouch ............................................ 977 tFileUnarchive ............................. 867, 978 tFTPFileProperties ............................... 999 tPivotOutputDelimited ......................... 979
I Internet tFileFetch ..............................................984 tFTPConnection ....................................988 tFTPDelete ....................................990, 992 tFTPFileExist ........................................992 tFTPFileList ..........................................994 tFTPGet ..............................................1001 tFTPPut 280, 282, 284, 286, 288, 290, 988, .............................1003, 1007, 1009 tFTPRename .......................................1007 tFTPTruncate ......................................1009 tJMSInput ...........................................1011 tJMSOutput .........................................1013 tMomInput ..........................................1014 tMomMessageIdList ...........................1018 tMomOutput .......................................1019 tPOP ....................................................1020 tRSSInput ...........................................1024 tRSSOutput .........................................1027 tSCPConnection .................................1035 tSCPDelete .........................................1036 tSCPFileExists ....................................1037 tSCPFileList .............................1035, 1038 tSCPGet ..............................................1039 tSCPPut ...............................................1041 tSCPRename .......................................1042 tSCPTruncate ......................................1043 tSendMail ...........................................1044 tSocketInput ........................................1049 tSocketOutput .....................................1054 tWebServiceInput ...............................1056 tXMLRPCInput ..................................1065 J Jointure Explicite ................................................813 Jointure explicite ........................................813 Jointures Left Outer Join ......................................819 L Log&Error tDie .....................................................1084 tLogCatcher ........................................1091
tLogRow ............................................ 1095 Logs&Errors tAssert ................................................ 1070 tAssertCatcher .................................... 1076 tChronometerStart .............................. 1078 tChronometerStop .............................. 1079 tFlowMeter ......................................... 1085 tFlowMeterCatcher ............................ 1086 tStatCatcher ........................................ 1096 tWarn ................................................. 1099 M Misc tAddLocationFromIP ......................... 1102 tAlfrescoOutput ..................................... 68 tBufferOutput ........................... 1106, 1109 tContextDump .................................... 1120 tContextLoad ..................................... 1121 tLoop ........................................ 1146, 1147 tMsgBox ............................................. 1127 tRowGenerator ................................... 1129 MultiSchema tFileInputMSDelimited ........................ 893 tFileInputMSPositional ........................ 925 tFileInputMSXML ............................... 936 O Orchestration tFileList .............................................. 1134 tFlowToIterate ................................... 1135 tInfiniteLoop ...................................... 1139 tIterateToFlow ................................... 1140 tLoop .................................................. 1143 tPostjob .............................................. 1146 tPrejob ................................................ 1147 tReplicate ........................................... 1148 tRunJob .............................................. 1149 tSleep ................................................. 1150 tUnite ................................................. 1151 tWaitForFile ....................................... 1155 tWaitForSocket .................................. 1159 tWaitForSqlData ................................ 1160 P Processing
tAggregateRow ...........................786, 1166 tAggregateSortedRow ........................1172 tConvertType ......................................1174 tDenormalize ......................................1179 tDenormalizeSortedRow ....................1184 tEmptyToNull .....................................1188 tExternalSortedRow ...........................1192 tExtractDelimitedFields ......................1194 tExtractXMLField ..............................1205 tFilterColumns ....................................1206 tFilterRow ...........................................1207 tMap ....................................................1211 tNormalize ..........................................1239 tPerl .....................................................1242 tPivotToRows .....................................1245 tReplace ..............................................1249 tSampleRow .......................................1254 tSortRow .............................................1257 Proprits du tDB2Close ....238, 292, 308, 327 S StoreSQLQuery ..........................................260 System tRunJob ...............................................1264 tSetEnv ...............................................1271 tSSH ....................................................1275 tSystem ...............................................1277 T Table Alias ......................................................813 tAccessInput Advanced settings .................................209 tAccessOutput Advanced settings .................................211 Talend MDM tMDMDelete .......................................1282 tMDMInput .........................................1288 tMDMOutput ......................................1293 tMDMReceive ....................................1301 tAlfrescoOutput Advanced settings ...................................69 tAS400Input Advanced settings .........................220, 436 tAS400Output
vi
Advanced settings ................................ 223 tDB2Input Advanced settings .. 243, 1122, 1125, 1129 tDB2Output Advanced settings .. 6, 39, 46, 51, 237, 247 tDBInput Advanced settings ................................ 258 tDBOutput Advanced settings ................................ 263 tFileInputEBCDIC ..................................... 900 tFileInputExcel Advanced settings ................................ 907 tFileOutputEBCDIC .................................. 954 tFirebirdInput Advanced settings ................ 272, 278, 296 tFirebirdOutput Advanced settings ........................ 274, 299 tFTPFileList ............................................... 994 tHSQLDBOutput Advanced settings ........................ 337, 438 tHSQLDbOutput Advanced settings ........................ 337, 438 tInformixOutput Advanced settings ................ 344, 350, 353 tIngresInput Advanced settings ........................ 334, 372 tIngresOutput Advanced settings ................................ 374 tInterbaseOutput Advanced settings ................................ 388 tJavaDBInput Advanced settings ................................ 395 tJavaDBOutput Advanced settings ........................ 397, 412 tJDBCInput Advanced settings ................................ 408 tJDBCOutput Advanced settings ................................ 412 tMSSqlInput Advanced settings ................................ 451 tMSSqlOutput Advanced settings ................................ 457 tMysqlInput Advanced settings ................................ 489
tMysqlOutput Advanced settings .................344, 350, 353 tOracleInput Advanced settings .................................579 tOracleOutput Advanced settings .................................583 tPostegresqlInput Advanced settings .........313, 614, 639, 662 tPostegresqlOutput Advanced settings .316, 606, 617, 642, 666 tPostegrsqlOutput Advanced settings .316, 606, 617, 642, 666 tSASInput Advanced settings .................................680 tSASOutput Advanced settings .................................683 tSQLiteInput Advanced settings .................................690 tSQLiteOutput Advanced settings .................................695 tSybaseInput Advanced settings .................................711 tSybaseOutput Advanced settings .................................721 tTeradataInput Advanced settings 740, 742, 745, 747, 750, ...................................................761 tTeradataOutput Advanced settings .................747, 754, 758 V Variable ....................................................1265 StoreSQLQuery ....................................260 X XML tAdvancedFileOutputXML .................1304 tDTDValidator ....................................1315 tExtractXMLField ..............................1318 tFileOutputMSXML .............................968 tWriteXMLField .................................1336 tXSDValidator ....................................1342 tXSLT .................................................1343
vii
viii

TalendOpenStudio Components RG 40b FR

Încărcat de

Informații document

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

TalendOpenStudio Components RG 40b FR

Încărcat de

Drepturi de autor:

Formate disponibile

Talend Open Studio Composants

Composants Talend Open Studio

Creative Commons License

Creative Commons License

Composants Talend Open Studio

Composants Talend Open Studio

Creative Commons License

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

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

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

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

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

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

Composants Talend Open Studio

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

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

Composants Talend Open Studio

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

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

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

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

Composants Talend Open Studio

Composants Talend Open Studio

Creative Commons License

Creative Commons License

Composants Talend Open Studio

Composants Talend Open Studio

Creative Commons License

introduit un paragraphe apportant une information supplmentaire sur un point

Creative Commons License

Composants Talend Open Studio

Historique des versions

Composants Talend Open Studio

Creative Commons License

Creative Commons License

Composants Talend Open Studio

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence

Composants Business Intelligence

Composants Talend Open Studio

Creative Commons License

Composants Business Intelligence

Username et Password Table Schema et Edit Schema

Use memory saving Mode Advanced settings

Creative Commons License

Composants Talend Open Studio