ComposantsComponents › TraitementProcessing
Ne laisse passer que les lignes dont le numéro d'arrivée figure dans une liste : des numéros et des plages, comme 1..3,6. Pratique pour prendre un échantillon, garder les premières lignes d'un flux ou isoler une ligne à examiner.
Only lets through the rows whose arrival number is in a list: numbers and ranges, such as 1..3,6. Handy to take a sample, keep the first rows of a flow or isolate a row to examine.
EntréeInput
Main un fluxone flow
SortieOutput
Main un flux : les lignes retenues, dans leur ordre d'arrivéeone flow: the rows kept, in their order of arrival
Déclencheurs en sortieOutput triggers
On Component Ok On Component Error Run if
Le composant compte les lignes reçues, à partir de 1. Une ligne dont le numéro est dans la liste passe telle quelle ; les autres s'arrêtent là. Il ne trie pas et ne s'arrête pas avant la fin du flux : 1..10 sur un fichier d'un million de lignes lit tout le fichier.
The component counts the rows received, from 1. A row whose number is in the list goes through as it is; the others stop there. It does not sort and does not stop before the end of the flow: 1..10 on a file of a million rows reads the whole file.
"1..3,6".
In Range, write in quotes the numbers and the ranges to keep, separated by commas, without spaces: "1..3,6".
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. 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.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| SchémaSchemaSCHEMA | — | ToujoursAlways | Les colonnes du flux, reprises du lien entrant. Chaque colonne de sortie reçoit la colonne d'entrée de même nom. The flow columns, taken from the incoming link. Each output column gets the input column of the same name. |
| (texte d'aide)(help text)INFO_RANGE | — | ToujoursAlways |
Un texte en anglais, non modifiable, qui rappelle la syntaxe : "1,5" les lignes 1 et 5, "10..20" les lignes 10 à 20, "23..45,48,50..54", "1..10" les 10 premières lignes.
An English text, not editable, which recalls the syntax: "1,5" lines 1 and 5, "10..20" lines 10 to 20, "23..45,48,50..54", "1..10" the 10 first lines.
|
| ÉcartRangeRANGE | "1,5,10..20" |
ToujoursAlways | Les numéros des lignes à garder (voir Syntaxe). Champ de plusieurs lignes : un retour à la ligne compte comme une virgule. The numbers of the rows to keep (see Syntax). Multi-line field: a line break counts as a comma. |
6) ou une plage début..fin, bornes comprises (1..3 : 1, 2 et 3).
Items separated by commas. An item is a number (6) or a start..end range, bounds included (1..3: 1, 2 and 3).
5), un tiret (1-3), un point-virgule, une plage à l'envers (3..1), un élément vide. Le numéro 0 ne correspond à aucune ligne.
Any item of another form is ignored without a message: with a space ( 5), a dash (1-3), a semicolon, a reversed range (3..1), an empty item. Number 0 matches no row.
Le modèle regarde si le champ contient une lettre : The template looks whether the field contains a letter:
"1..2" + ",9" n'est donc pas calculée (exemple).
Without a letter, it is a text: the quotes are removed, the line breaks become commas, and the rest is taken as it is. An expression such as "1..2" + ",9" is therefore not computed (example).
context.lines), un appel de méthode… Elle suit la même syntaxe.
With a letter, it is a Java expression that gives a text, read when the subjob starts: a context variable (context.lines), a method call… It follows the same syntax.
Aucune : le composant n'en déclare pas et son code n'en range aucune (voir l'essai). Pour compter les lignes retenues, prenez la variable NB_LINE du composant suivant, par exemple celle du tLogRow.
None: the component declares none and its code stores none (see the test). To count the rows kept, take the NB_LINE variable of the next component, for example the one of the tLogRow.
Les jobs ont été exécutés dans Talaxie (Java 21). Un tFixedFlowInput envoie dix lignes (id Integer de 1 à 10, letter String de A à J) au tSampleRow, suivi d'un tLogRow en mode simple. Sorties copiées depuis la console ; sauf mention, seules les lignes du tLogRow sont reprises. Dans les erreurs, le nom du job est remplacé par MyJob et les traces sont abrégées.
The jobs were run in Talaxie (Java 21). A tFixedFlowInput sends ten rows (id Integer from 1 to 10, letter String from A to J) to the tSampleRow, followed by a tLogRow in basic mode. Outputs copied from the console; unless stated, only the tLogRow lines are shown. In the errors, the job name is replaced with MyJob and the traces are shortened.
"1..3,6"
1|A 2|B 3|C 6|F
"1,5,10..20" : le flux s'arrête à 10, la fin de la plage ne sert pas.
"1,5,10..20": the flow ends at 10, the end of the range is not used.
1|A 5|E 10|J
"6,1..2,2" : l'ordre d'arrivée est gardé, la ligne 2 ne sort qu'une fois.
"6,1..2,2": the order of arrival is kept, row 2 comes out only once.
1|A 2|B 6|F
Le champ contient "1,2, un retour à la ligne, puis 9..10" : le code généré utilise "1,2,9..10".
The field contains "1,2, a line break, then 9..10": the generated code uses "1,2,9..10".
1|A 2|B 9|I 10|J
context.lines, variable String de valeur 2,4..5 (sans guillemets, comme toute valeur de contexte). Code généré : String[] rangetSampleRow_1 = context.lines.split(",");
context.lines, String variable of value 2,4..5 (without quotes, like any context value). Generated code: String[] rangetSampleRow_1 = context.lines.split(",");
2|B 4|D 5|E
Console complète du premier exemple, avec un tJava relié par On Subjob Ok qui affiche tSampleRow_1_NB_LINE puis compte les variables dont le nom commence par tSampleRow_1.
Full console of the first example, with a tJava connected with On Subjob Ok which prints tSampleRow_1_NB_LINE then counts the variables whose name starts with tSampleRow_1.
1|A 2|B 3|C 6|F tSampleRow_1_NB_LINE = null Global variables: 0
"1, 5, 7 .. 8" : seul 1 a la forme attendue ; 5 et 7 .. 8 sont ignorés, sans message.
"1, 5, 7 .. 8": only 1 has the expected form; 5 and 7 .. 8 are ignored, without a message.
1|A
De même, "3..1" et "1-3;5" ne laissent passer aucune ligne, et "0,10" seulement la dixième. Un job qui ne sort rien n'est donc pas forcément en erreur : relisez l'écart.
Likewise, "3..1" and "1-3;5" let no row through, and "0,10" only the tenth one. A job that outputs nothing is therefore not necessarily in error: read the range again.
"1..2" + ",9" ne contient pas de lettre : ses guillemets sont retirés et le reste est pris comme texte. Code généré :
"1..2" + ",9" contains no letter: its quotes are removed and the rest is taken as text. Generated code:
String[] rangetSampleRow_1 = "1..2 + ,9".split(",");
L'élément 1..2 + est ignoré, seule la ligne 9 sort :
The 1..2 + item is ignored, only row 9 comes out:
9|I
Pour un écart calculé, passez par une variable de contexte ou une variable Java, dont le nom contient des lettres. For a computed range, go through a context variable or a Java variable, whose name contains letters.
"99999999999" : le job s'arrête au démarrage du sous-job.
"99999999999": the job stops when the subjob starts.
Exception in component tSampleRow_1 (MyJob) java.lang.NumberFormatException: For input string: "99999999999" at java.base/java.lang.NumberFormatException.forInputString(NumberFormatException.java:67) at java.base/java.lang.Integer.parseInt(Integer.java:662) at java.base/java.lang.Integer.valueOf(Integer.java:989) at demo.myjob_0_1.MyJob.tFixedFlowInput_1Process(MyJob.java:1117) …
Au démarrage, le modèle range chaque numéro de chaque plage dans un ensemble en mémoire : 1..100000000 y met cent millions de nombres avant de lire la première ligne. Pour garder toutes les lignes à partir d'un rang, ou les premières lignes d'un gros fichier, préférez les options d'en-tête et de limite du composant de lecture, comme celles du tFileInputDelimited.
At start, the template puts every number of every range into a set in memory: 1..100000000 puts a hundred million numbers in it before reading the first row. To keep all the rows from a given rank, or the first rows of a large file, prefer the header and limit options of the reading component, such as those of the tFileInputDelimited.
Le composant ne fait que garder. Pour retirer des lignes, écrivez les plages qui les entourent ("1..4,6..1000" pour retirer la 5), en gardant à l'esprit la mémoire des grandes plages.
The component only keeps. To remove rows, write the ranges around them ("1..4,6..1000" to remove the 5th), keeping in mind the memory of large ranges.
« Ligne 3 » veut dire la troisième ligne reçue par le tSampleRow, après les filtres et les tris placés avant lui. Pour les trois plus grands montants, triez d'abord avec un tSortRow, puis gardez "1..3".
“Row 3” means the third row received by the tSampleRow, after the filters and the sorts placed before it. For the three largest amounts, sort first with a tSortRow, then keep "1..3".
tFilterRow · garder les lignes qui remplissent des conditionskeep the rows that meet conditionstSortRow · trier un flux avant d'en garder les premières lignessort a flow before keeping its first rowstFilterColumns · garder des colonnes plutôt que des ligneskeep columns rather than rowstUniqRow · séparer les doublonsseparate duplicatestLogRow · afficher les lignes d'un fluxdisplay the rows of a flow