ComposantsComponents

ComposantsComponents › DiversMisc

tRowGenerator

tRowGenerator

DiversMisc

Génère des lignes de test. Chaque colonne de son schéma reçoit, à chaque ligne, le résultat d'une fonction (prénom, ville, nombre au hasard, séquence…), une valeur tirée au hasard dans une liste, ou votre propre expression Java. Pour essayer un job sans vraie source de données, ou produire un nombre donné de lignes. Generates test rows. Each column of its schema gets, for each row, the result of a function (first name, city, random number, sequence…), a value picked at random from a list, or your own Java expression. To try a job without a real data source, or produce a given number of rows.

EntréeInput

Aucune : il commence son sous-job. Sinon un lien Iterate : il génère ses lignes à chaque itération. None: it starts its subjob. Otherwise one Iterate link: it generates its rows at each iteration.

SortieOutput

Main un flux, avec le schéma du composantone flow, with the component schema

Déclencheurs en sortieOutput triggers

On Subjob Ok On Subjob Error On Component Ok On Component Error Run if

On Subjob : seulement quand il commence son sous-job. On Subjob: only when it starts its subjob.

UtilisationUsage

row1 (Main) row2 (Main) tRowGenerator_1 tMap_1 tLogRow_1

À la place de la vraie source, le temps de mettre au point la suite du job : les lignes ont le schéma attendu, en aussi grand nombre que voulu. In place of the real source, while the rest of the job is being built: the rows have the expected schema, in as large a number as wanted.

  1. Déposez le tRowGenerator depuis la famille Divers de la palette. Drop the tRowGenerator from the Misc family of the palette.
  2. Double-cliquez dessus (ou cliquez sur Éditeur du tRowGenerator dans l'onglet Composant) : ajoutez les colonnes, choisissez une fonction pour chacune, réglez ses paramètres et le nombre de lignes. Voir l'éditeur. Double-click it (or click RowGenerator Editor in the Component tab): add the columns, choose a function for each one, set its parameters and the number of rows. See the editor.
  3. Validez par Ok, puis reliez la sortie au composant suivant (clic droit › Ligne › Main). Confirm with Ok, then connect the output to the next component (right-click › Row › Main).

L'éditeur du tRowGeneratorThe RowGenerator editor

Ce qu'il contientWhat it contains

SchémaSchema
Une ligne par colonne (nom, type…), avec trois colonnes de plus : Fonctions, Variables d'environnement (les valeurs des paramètres) et Aperçu (un exemple de valeur).One line per column (name, type…), with three more columns: Functions, Environment variables (the parameter values) and Preview (a sample value).
Nombre de lignes pour RowGeneratorNumber of Rows for RowGenerator
Le nombre de lignes générées par le job ; une variable de contexte y est acceptée.The number of rows generated by the job; a context variable is accepted.
Paramètres de la fonctionFunction parameters
Onglet du bas : les paramètres de la fonction de la colonne choisie (Paramètre, Valeur, Commentaire).Bottom tab: the parameters of the function of the selected column (Parameter, Value, Comment).
AperçuPreview
Onglet du bas : quelques lignes d'essai, selon le Nombre de lignes pour la prévisualisation, avec le bouton Aperçu.Bottom tab: a few test rows, from the Number of Rows for Preview, with the Preview button.

Les fonctionsThe functions

La liste Fonctions propose les fonctions des routines qui déclarent le type de la colonne : TalendDataGenerator.getFirstName() ou getUsCity() pour une String, Numeric.sequence(…) ou Numeric.random(…) pour un Integer, TalendDate.getRandomDate(…) pour une Date. Une nouvelle colonne String reçoit TalendString.getAsciiRandomString(6). The Functions list offers the functions of the routines that declare the column type: TalendDataGenerator.getFirstName() or getUsCity() for a String, Numeric.sequence(…) or Numeric.random(…) for an Integer, TalendDate.getRandomDate(…) for a Date. A new String column gets TalendString.getAsciiRandomString(6).

L'entrée ... (Configurez votre expression), proposée pour tous les types, laisse écrire sa propre expression Java dans son paramètre. The ... entry (Set your own expression), offered for every type, lets you write your own Java expression in its parameter.

Ce que le job garde : une expression par colonneWhat the job keeps: one expression per column

À la validation, l'éditeur écrit pour chaque colonne une expression (la fonction et ses paramètres, ou votre expression) dans le paramètre VALUES, et le nombre de lignes dans NB_ROWS. À l'exécution, l'expression est lue de trois façons : On confirmation, the editor writes for each column an expression (the function and its parameters, or your expression) in the VALUES parameter, and the number of rows in NB_ROWS. At run time, the expression is read in three ways:

Numeric.random(0,100)
Avec une parenthèse (ailleurs qu'en premier caractère) : l'expression est calculée pour chaque ligne.With a parenthesis (other than as first character): the expression is computed for each row.
"new","paid","sent"
Sans parenthèse, avec des virgules : une liste de valeurs, une tirée au hasard pour chaque ligne.Without a parenthesis, with commas: a list of values, one picked at random for each row.
"FR" · context.batch
Ni l'un ni l'autre : l'expression telle quelle, la même à chaque ligne si elle ne change pas.Neither: the expression as is, the same for each row if it does not change.

ParamètresSettings

La troisième colonne dit où se règle le paramètre ; 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. The third column tells where the setting is made; 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 OngletTab Description
SchémaSchemaSCHEMA videempty Composant, éditeurComponent, editor Les colonnes générées. The generated columns.
Éditeur du tRowGeneratorRowGenerator EditorMAP — ComposantComponent Bouton qui ouvre l'éditeur, comme un double-clic sur le composant. Button that opens the editor, like a double-click on the component.
Nombre de lignesNumber of rowsNB_ROWS 100 ÉditeurEditor Nombre de lignes pour RowGenerator dans l'éditeur. Une expression Java entière (5, context.nb) ; vide, 100. Number of Rows for RowGenerator in the editor. An integer Java expression (5, context.nb); empty, 100.
ValeursValuesVALUES · ARRAY — ÉditeurEditor Une ligne par colonne : son nom et l'expression écrite par l'éditeur d'après la fonction et ses paramètres. Voir ci-dessus comment elle est lue. One line per column: its name and the expression written by the editor from the function and its parameters. See above how it is read.

Variable globaleGlobal variable

NB_LINE (Integer, disponible après le composant) : nombre de lignes générées, ((Integer) globalMap.get("tRowGenerator_1_NB_LINE")). NB_LINE (Integer, available after the component): number of rows generated, ((Integer) globalMap.get("tRowGenerator_1_NB_LINE")).

ExemplesExamples

Les sorties sont celles de la console, copiées depuis une exécution du job. Les valeurs tirées au hasard changent d'une exécution à l'autre. The outputs are the console ones, copied from a run of the job. The values picked at random change from one run to the next.

Fonctions de testTest functions

row1 (Main) tRowGenerator_1 tLogRow_1

5 lignes, tLogRow en mode Table. Un tJava relié par On Subjob Ok affiche NB_LINE. 5 rows, tLogRow in Table mode. A tJava connected with On Subjob Ok prints NB_LINE.

ColonneColumn Type Valeur (fonction et paramètres)Value (function and parameters)
idIntegerNumeric.sequence("s1",1,1)
firstNameStringTalendDataGenerator.getFirstName()
cityStringTalendDataGenerator.getUsCity()
scoreIntegerNumeric.random(0,100)
.--+---------+--------------+-----.
|            tLogRow_1            |
|=-+---------+--------------+----=|
|id|firstName|city          |score|
|=-+---------+--------------+----=|
|1 |Thomas   |Columbus      |0    |
|2 |Calvin   |Lincoln       |52   |
|3 |Andrew   |Denver        |27   |
|4 |Theodore |Salt Lake City|70   |
|5 |Chester  |Nashville     |59   |
'--+---------+--------------+-----'

Rows generated: 5

Numeric.random(0,100) donne un entier entre 0 et 100, bornes comprises. Numeric.random(0,100) gives an integer between 0 and 100, bounds included.

Liste, constante et dateList, constant and date

4 lignes, tLogRow en mode Simple. La colonne day est une Date de modèle "yyyy-MM-dd". 4 rows, tLogRow in Basic mode. The day column is a Date with the "yyyy-MM-dd" pattern.

ColonneColumn ValeurValue
status"new","paid","sent"
country"FR"
dayTalendDate.getRandomDate("2026-01-01","2026-12-31")
new|FR|2026-11-13
new|FR|2026-11-09
sent|FR|2026-09-01
paid|FR|2026-02-06

Avec le contexteWith the context

Nombre de lignes context.nb (Integer, 2) ; la colonne batch vaut context.batch (String, B42). Number of rows context.nb (Integer, 2); the batch column is context.batch (String, B42).

ColonneColumn ValeurValue
idNumeric.sequence("s1",1,1)
batchcontext.batch
1|B42
2|B42

Une séquence partagée par tout le jobA sequence shared by the whole job

row1 (Main) OnSubjobOk row2 (Main) tRowGenerator_1 tLogRow_1 tRowGenerator_2 tLogRow_2

Deux tRowGenerator de 3 lignes, chacun avec id = Numeric.sequence("s1",1,1). tLogRow avec le nom unique devant chaque ligne. Two tRowGenerator of 3 rows, each with id = Numeric.sequence("s1",1,1). tLogRow with the unique name in front of each row.

[tLogRow_1] 1
[tLogRow_1] 2
[tLogRow_1] 3
[tLogRow_2] 4
[tLogRow_2] 5
[tLogRow_2] 6

Le second continue à 4 : la séquence s1 est la même. The second one goes on at 4: the s1 sequence is the same.

[tLogRow_1] 1
[tLogRow_1] 2
[tLogRow_1] 3
[tLogRow_2] 1
[tLogRow_2] 2
[tLogRow_2] 3

Avec, entre les deux, un tJava qui exécute Numeric.removeSequence("s1");. With, between the two, a tJava that runs Numeric.removeSequence("s1");.

Pièges et conseilsPitfalls and tips

Une liste de valeurs avec des parenthèsesA list of values with parentheses

Valeur "Paris (75)","Lyon (69)" : à cause de la parenthèse, elle est prise pour une expression, et le job ne compile pas (message abrégé) : Value "Paris (75)","Lyon (69)": because of the parenthesis, it is taken as an expression, and the job does not compile (shortened message):

error: ';' expected
		return "Paris (75)","Lyon (69)";
		                   ^

Écrivez plutôt une expression qui tire elle-même la valeur : Write instead an expression that picks the value itself:

new String[] {"Paris (75)","Lyon (69)"}[Numeric.random(0,1)]
Lyon (69)
Paris (75)
Lyon (69)

Séquences : un nom par usageSequences: one name per use

Numeric.sequence garde son compteur, par nom, pour tout le job : deux colonnes ou deux composants qui utilisent "s1" se partagent les numéros. Donnez un nom différent à chaque séquence, ou effacez-la avec Numeric.removeSequence("s1") pour repartir de la valeur de départ. Numeric.sequence keeps its counter, by name, for the whole job: two columns or two components that use "s1" share the numbers. Give each sequence a different name, or remove it with Numeric.removeSequence("s1") to start again from the start value.

Des valeurs qui changentValues that change

Les fonctions au hasard donnent d'autres valeurs à chaque exécution. Pour des données d'essai identiques d'une fois sur l'autre, prenez des séquences, des constantes, ou un tFixedFlowInput. The random functions give other values at each run. For test data identical from one time to the next, take sequences, constants, or a tFixedFlowInput.

Dates au hasardRandom dates

TalendDate.getRandomDate attend ses deux bornes au format "yyyy-MM-dd". L'affichage de la date suit ensuite le modèle de la colonne dans le schéma. TalendDate.getRandomDate expects its two bounds in the "yyyy-MM-dd" format. The date is then displayed with the column pattern of the schema.

Ses propres fonctionsYour own functions

Avec ..., toute expression Java est acceptée : une routine du projet, un calcul sur une autre fonction ("C-" + Numeric.sequence("c",1,1)), une variable globale. With ..., any Java expression is accepted: a project routine, a computation on another function ("C-" + Numeric.sequence("c",1,1)), a global variable.

Voir aussiSee also