ComposantsComponents

ComposantsComponents › TraitementProcessing

tSampleRow

tSampleRow

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

UtilisationUsage

row1 (Main) row2 (Main) tFileInputDelimited_1 tSampleRow_1 tLogRow_1

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. Reliez la sortie d'un composant au tSampleRow, puis le tSampleRow au composant suivant. Le schéma est celui du flux entrant. Connect the output of a component to the tSampleRow, then the tSampleRow to the next component. The schema is the one of the incoming flow.
  2. Dans Écart, écrivez entre guillemets les numéros et les plages à garder, séparés par des virgules, sans espace : "1..3,6". In Range, write in quotes the numbers and the ranges to keep, separated by commas, without spaces: "1..3,6".

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

SyntaxeSyntax

  • Des éléments séparés par des virgules. Un élément est un numéro (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).
  • La première ligne porte le numéro 1. L'ordre des éléments et les doublons ne changent rien : les lignes sortent dans leur ordre d'arrivée. The first row has number 1. The order of the items and the duplicates change nothing: the rows come out in their order of arrival.
  • Tout élément d'une autre forme est ignoré sans message : avec une espace ( 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.
  • Un numéro trop grand pour un Integer (plus de 2147483647) arrête le job avant la première ligne. A number too large for an Integer (more than 2147483647) stops the job before the first row.

Texte ou expression JavaText or Java expression

Le modèle regarde si le champ contient une lettre : The template looks whether the field contains a letter:

  • Sans lettre, c'est un texte : les guillemets sont retirés, les retours à la ligne deviennent des virgules, et le reste est pris tel quel. Une expression comme "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).
  • Avec une lettre, c'est une expression Java qui donne un texte, lu au démarrage du sous-job : une variable de contexte (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.

Variables globalesGlobal variables

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.

ExemplesExamples

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.

row1 (Main) row2 (Main) tFixedFlowInput_1 tSampleRow_1 tLogRow_1

Une plage et un numéroA range and a number

"1..3,6"

1|A
2|B
3|C
6|F

La valeur par défautThe default value

"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

Ordre et doublonsOrder and duplicates

"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

Sur plusieurs lignesOn several lines

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

Variable de contexteContext variable

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

Aucune variable globaleNo global variable

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

Pièges et conseilsPitfalls and tips

Une espace suffit à perdre un élémentA space is enough to lose an item

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

Une expression sans lettre n'est pas calculéeAn expression without a letter is not computed

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

Numéro trop grandNumber too large

"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)
	…

Grandes plagesLarge ranges

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.

Pas de mode « exclure »No “exclude” mode

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.

Les numéros suivent l'ordre d'arrivéeNumbers follow the order of arrival

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

Voir aussiSee also