Before you begin
You have previously created a connection to the system storing your source data.
Here, an HDFS connection.
You have previously added the dataset holding your source data.
Here the Left dataset holds user data with country codes and indexes, and the Right dataset holds the data to be combined with the source data: country names and indexes (download the join-countries.json and join-users.json files from the Downloads tab in the left panel of this page).
You also have created the connection and the related dataset that will hold the processed data.
Here, a database table.
- Click ADD PIPELINE on the PIPELINES page. Your new pipeline opens.
Give the pipeline a meaningful name.
ExampleJoin Country Data
Click ADD SOURCE to open the panel allowing you to
select your source data, here a list of customers with country codes stored in
Select your dataset and click SELECT DATASET in order to
add it to the pipeline.
Rename it if needed.
- Click and add a Join processor to the pipeline. The Configuration panel opens.
Give a meaningful name to the processor.
Examplecombine country data
In the CONFIGURATION area:
- Select the dataset to be combined with the source dataset (here, a dataset called Countries) in the Join dataset list.
- Select Left outer join in the Join type list, as you want matching records and additional records from the left dataset to be listed in the result set.
In the CONDITIONS area:
- Select or enter the path to the existing record to be compared in the left dataset. (here, .countryCode) in the Left key list.
Select or enter the path to the existing record to be compared in the
right dataset. (here, .index) in the
Right key list.
You can use the avpath syntax in this area.
- Click SAVE to save your configuration.
Click the ADD DESTINATION item next to the
Join processor and select the dataset that will hold
your joined data.
Rename it if needed.
(Optional) Click the top preview icon after the last Join processor to preview your data after the join
- After saving the Join processor configuration, the JOIN DATASET tab will appear in the
Data preview area to let
you preview the result of the join operation.
- Only the 50 first records of your datasets are loaded in the preview. As a result you may not see matching records in the preview but they will be taken into account at run time.
- After saving the Join processor configuration, the JOIN DATASET tab will appear in the Data preview area to let you preview the result of the join operation.
- On the top toolbar of Talend Cloud Pipeline Designer, select your run profile in the list (for more information, see Run profiles).
- Click the run icon to run your pipeline.
Your pipeline is being executed, the user country data is now joined and both the country codes and the country full names are combined in the generated output that is sent to the target system you have indicated.