Category: Transform / Basic
This action appends one or more columns from another table where the values in certain columns in both tables match. The action is similar to the SQL join.
There are four possible merge modes:
Retrieve the first matching combination from the other table. Any subsequent combinations are ignored.
Retrieve all matching combinations from the other table. This mode can increase the number of rows in the current table as rows are duplicated to hold any multiple matches from the second dataset.
Include all combinations of keys from both tables. Similar to the full outer join in SQL.
Include only matching rows from both tables.
Setting | Description |
---|---|
Add columns from table | Select table that will return columns to the current dataset where values match. |
Where all these columns match | Select the columns within the current dataset (left drop-down) and the second dataset (right drop-down) where values will match. To define multi-columnar matches, use the Add more matching columns to select additional matching columns in each dataset. |
Merge mode | Options: Lookup (for each row in this table, get any one matching row from the second table and ignore other matches), Left join (for each row in this table add all matching rows from the second table), Full join (add matching and non-matching rows from both tables) Inner join (add rows that match in both tables). |
Return columns | From the list, select the columns from the second dataset that will be appended to the current dataset. |
The reference to the second table will appear as a dotted line connecting this action to the second dataset in the application window.
Matching is case-sensitive.
Values must be identical (equal) in order to be matched. If another matching mode is needed (e.g. "Starts with") use the Match action first to do the matching.
For an inner join use the Keep/remove matching action before merging to keep only the overlapping subset of values in the matching columns.
Example: Merge the "Outflow" column of Table 2 into Table 1 based on matching values in the "Rivers" columns in both tables.
Table 1: The longest rivers in the world
River | Length (km) | Continent |
---|---|---|
Nile | 6650 | Africa |
Amazon | 6400 | South America |
Yangtze | 6300 | Asia |
Mississippi | 6275 | North America |
Table 2: The outflow
River | Outflow |
---|---|
Nile | Mediterranean |
Amazon | Atlantic Ocean |
Yangtze | East China Sea |
Mississippi | Gulf of Mexico |
Action parameters:
Add columns from table: Table 2
Where values in Table 1 "River" column match values in Table 2 "River" column
Merge mode: Left join (add all matching rows from Table 2 to Table 1)
Return column: Outflow
Result table:
River | Length (km) | Continent | Outflow |
---|---|---|---|
Nile | 6650 | Africa | Mediterranean |
Amazon | 6400 | South America | Atlantic Ocean |
Yangtze | 6300 | Asia | East China Sea |
Mississippi | 6275 | North America | Gulf of Mexico |