ComposantsComponents

ComposantsComponents › TraitementProcessing

tJoin

tJoin

TraitementProcessing

Joint le flux principal à un flux Lookup sur une ou plusieurs colonnes clés : chaque ligne principale reçoit des colonnes de la ligne Lookup qui a la même clé. Sans correspondance, la ligne sort avec ces colonnes vides (jointure externe gauche) ou, en jointure interne, part par un lien de rejet. Pour des clés calculées ou plusieurs Lookups, prenez un tMap. Joins the main flow with a Lookup flow on one or more key columns: each main row gets columns from the Lookup row that has the same key. Without a match, the row goes out with these columns empty (left outer join) or, in an inner join, leaves through a reject link. For computed keys or several Lookups, take a tMap.

EntréeInput

Main le flux principal, obligatoirethe main flow, required

Lookup le flux de référence, obligatoirethe reference flow, required

SortieOutput

Main un flux, obligatoireone flow, required

Inner join reject facultatif : les lignes sans correspondanceoptional: the rows without a match

Déclencheurs en sortieOutput triggers

On Component Ok On Component Error Run if

UtilisationUsage

row1 (Main) row2 (Main) row3 (Lookup) row4 (Inner join reject) tFileInputDelimited_1 tJoin_1 tDBOutput_1 tFileInputDelimited_2 tFileOutputDelimited_1

Le Lookup est lu en entier, et gardé en mémoire, avant la première ligne du flux principal. Puis chaque ligne principale y cherche sa clé. The Lookup is read entirely, and kept in memory, before the first row of the main flow. Then each main row looks up its key in it.

  1. Reliez d'abord le flux principal au tJoin, puis le second flux : arrivant sur un tJoin qui a déjà son Main, il devient le Lookup. First connect the main flow to the tJoin, then the second flow: arriving on a tJoin that already has its Main, it becomes the Lookup.
  2. Schéma de sortie : les colonnes du flux principal, dans le même ordre, puis celles à prendre du Lookup. Output schema: the columns of the main flow, in the same order, then the ones to take from the Lookup.
  3. Dans Définition de la clé, une ligne par colonne de la clé : la colonne du flux principal et celle du Lookup. In Key definition, one line per key column: the column of the main flow and the one of the Lookup.
  4. Cochez Inclure la colonne Lookup dans la sortie et indiquez, dans Mapping de la colonne, quelle colonne du Lookup remplit chaque colonne ajoutée. Check Include lookup columns in output and give, in Column mapping, which Lookup column fills each added column.
  5. Pour une jointure interne, cochez Jointure Inner Join (avec rejets en sortie) et, pour garder les lignes sans correspondance, reliez Ligne › Inner join reject. For an inner join, check Inner join ( with reject output ) and, to keep the rows without a match, connect Row › Inner join reject.

Paramètres simplesBasic settings

Les libellés sont ceux de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. Le composant n'a pas de paramètres avancés propres, ni de variable globale. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. The component has no advanced settings of its own, nor any global variable.

ParamètreSetting DéfautDefault VisibleShown Description
SchémaSchemaSCHEMA videempty ToujoursAlways Les colonnes de sortie. Elles reçoivent celles du flux principal par position : la première de la première, et ainsi de suite, sauf les colonnes du Mapping. Le lien de rejet reçoit de même les colonnes du flux principal. The output columns. They get those of the main flow by position: the first from the first, and so on, except the Mapping columns. The reject link gets the main flow columns in the same way.
Inclure la colonne Lookup dans la sortieInclude lookup columns in outputUSE_LOOKUP_COLS NonNo ToujoursAlways Remplit des colonnes de sortie avec celles du Lookup, selon le tableau suivant. Décochée, le tJoin ne fait que garder ou rejeter les lignes. Fills output columns with Lookup ones, according to the next table. Unchecked, the tJoin only keeps or rejects the rows.
Mapping de la colonneColumn mappingLOOKUP_COLS videempty Colonnes Lookup inclusesLookup columns included Une ligne par colonne ajoutée : Colonne de sortie et Colonne de référence (la colonne du Lookup). Sans correspondance, la colonne de sortie reste vide. One line per added column: Output column and Lookup column. Without a match, the output column stays empty.
Définition de la cléKey definitionJOIN_KEY videempty ToujoursAlways Une ligne par colonne de la clé : Attribut de la clé d'entrée (colonne du flux principal) et Attribut de la clé Lookup. Les deux colonnes ont le même type ; les valeurs doivent être égales (equals Java : la casse et les espaces comptent). One line per key column: Input key attribute (column of the main flow) and Lookup key attribute. Both columns have the same type; the values must be equal (Java equals: case and spaces matter).
Jointure Inner Join (avec rejets en sortie)Inner join ( with reject output )USE_INNER_JOIN NonNo ToujoursAlways Cochée : une ligne principale sans correspondance ne sort pas par Main ; elle part par le lien Inner join reject s'il existe, sinon elle est perdue. Décochée : jointure externe gauche, toutes les lignes sortent par Main et le lien de rejet ne reçoit rien. Checked: a main row without a match does not leave through Main; it leaves through the Inner join reject link if there is one, otherwise it is lost. Unchecked: left outer join, all the rows leave through Main and the reject link gets nothing.

ExemplesExamples

Deux tFixedFlowInput : le flux principal et le Lookup. Clé : id = id ; Mapping : city ← city. Schéma de sortie : id, name, city. Sorties copiées depuis une exécution du job. Two tFixedFlowInput: the main flow and the Lookup. Key: id = id; Mapping: city ← city. Output schema: id, name, city. Outputs copied from a run of the job.

row1 (Main) row3 (Main) row2 (Lookup) tFixedFlowInput_1 tJoin_1 tLogRow_1 tFixedFlowInput_2

Flux principalMain flow

idInteger nameString
1Ada
2Grace
3Alan

Lookup

idInteger cityString
1London
3Manchester
3Bletchley
4Paris

Jointure externe gauche (par défaut)Left outer join (default)

Grace n'a pas de ville : elle sort quand même, city vide. La clé 3 est deux fois dans le Lookup : seule la dernière ligne lue compte, et Alan ne sort qu'une fois. La clé 4, sans ligne principale, ne sort pas. Grace has no city: she goes out anyway, city empty. Key 3 is twice in the Lookup: only the last row read counts, and Alan goes out only once. Key 4, without a main row, does not go out.

1|Ada|London
2|Grace|
3|Alan|Bletchley

Jointure interne, avec rejetsInner join, with rejects

Jointure Inner Join cochée ; le lien Inner join reject mène à tLogRow_2. Les deux tLogRow affichent leur nom unique. Inner join checked; the Inner join reject link leads to tLogRow_2. Both tLogRow print their unique name.

[tLogRow_1] 1|Ada|London
[tLogRow_2] 2|Grace|
[tLogRow_1] 3|Alan|Bletchley

Pièges et conseilsPitfalls and tips

Colonnes principales recopiées par positionMain columns copied by position

Même job, schéma de sortie id, city, name. La 2e colonne vient du Lookup ; name, 3e, ne correspond à aucune colonne du flux principal (qui n'en a que deux) : elle reste vide. Same job, output schema id, city, name. The 2nd column comes from the Lookup; name, 3rd, matches no column of the main flow (which has only two): it stays empty.

1|London|
2||
3|Bletchley|

Les noms ne comptent pas : placez les colonnes du flux principal en tête, dans leur ordre d'entrée, et les colonnes du Lookup après. Names do not matter: put the main flow columns first, in their input order, and the Lookup columns after.

Une seule ligne par clé dans le LookupOnly one row per key in the Lookup

Contrairement à une jointure SQL, une ligne principale ne sort jamais plusieurs fois : si plusieurs lignes du Lookup ont la même clé, la dernière lue remplace les autres (Alan → Bletchley dans l'exemple). Dédoublonnez le Lookup avant, ou prenez un tMap et son modèle de correspondance Toutes les correspondances. Unlike an SQL join, a main row never goes out several times: if several Lookup rows have the same key, the last one read replaces the others (Alan → Bletchley in the example). Remove the duplicates from the Lookup first, or take a tMap and its All matches match model.

Le Lookup en mémoireThe Lookup in memory

Tout le Lookup est chargé en mémoire avant le flux principal. Prenez comme Lookup le plus petit des deux flux, et ne gardez que les colonnes utiles. The whole Lookup is loaded in memory before the main flow. Take the smaller of the two flows as the Lookup, and keep only the useful columns.

Clés exactement égalesExactly equal keys

"Paris" et "paris " ne se joignent pas. Nettoyez les clés avant (majuscules, espaces), par exemple avec un tJavaRow ou un tReplace, ou joignez sur une expression dans un tMap. "Paris" and "paris " do not join. Clean the keys first (case, spaces), for example with a tJavaRow or a tReplace, or join on an expression in a tMap.

Garder ou écarter, sans colonne ajoutéeKeep or drop, without added columns

Avec Inclure la colonne Lookup dans la sortie décochée et la jointure interne cochée, le tJoin sépare simplement les lignes dont la clé existe dans le Lookup (Main) de les autres (rejet). With Include lookup columns in output unchecked and the inner join checked, the tJoin simply separates the rows whose key exists in the Lookup (Main) from the others (reject).

Voir aussiSee also