ComposantsComponents › 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
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.
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. |
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.
Flux principalMain flow
| idInteger | nameString |
|---|---|
| 1 | Ada |
| 2 | Grace |
| 3 | Alan |
Lookup
| idInteger | cityString |
|---|---|
| 1 | London |
| 3 | Manchester |
| 3 | Bletchley |
| 4 | Paris |
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 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
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.
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.
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.
"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.
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).
tFilterRow · garder les lignes qui remplissent des conditionskeep the rows that meet conditionstAggregateRow · regrouper les lignes et calculer par groupegroup rows and compute per grouptHashOutput · tHashInput · garder un flux en mémoire pour le relirekeep a flow in memory to read it againtLogRow · afficher les lignes d'un fluxdisplay the rows of a flow