Skip to main content

Append Datasets

If you are wrangling datasets that represent transactional or serialized data, you can append together slices of data to build a larger dataset for richer analysis.

A union appends two or more similar datasets together. Rows of the second dataset are added to the end of the first.

  • You can include the following objects in a union:

    • A recipe: The output columns of a recipe are used in the union. Note that changes to the recipe can affect the union.

    • A dataset: You can union directly with a dataset to which you have access.

    • A reference dataset: A reference dataset is a link to the output of a recipe from another flow.


      You can create a reference dataset from a recipe. In Flow View, click the recipe and select Create Reference Dataset.

  • In a union, the Cloud Portal can match columns for you automatically.

  • You can also manually tweak the matching and decide the columns to include or exclude in the resulting dataset.


  1. To start a join, begin from Dataset A:

    1. In Flow View, right-click a dataset and select Add > Union.

    2. If your first dataset already has a recipe, click the recipe, and select Append Union.

    3. In the Transformer page, you can enter union in the Search panel.

  2. The Union dialog previews the columns in the output on the left side and the column from the source datasets on the right side.

    1. To add data from a dataset, recipe, or reference, click Add data.

    2. From the Choose data to Union dialog, select or search the datasets to union from the available options.

    3. From the drop-down, you can choose how you want to align the columns between datasets. Select one of the aligning methods such asAuto Align,Align by Name, andAlign by Positionto map the columns of the new datasets to the existing datasets.

    4. ClickApply.

  3. A preview of the columns in the union is displayed.


    Figure: Union Summary

  4. Review the output columns in the left panel.

    1. To remove a column from the output, click the X icon next to the column in the left panel.

  5. If needed, you can change the columns and their order in the output dataset based on selections in the right panel:

    1. To completely remove the dataset from the union, click the X icon next to the dataset name in the right panel.

    2. To add a column to the union output, click the Plus icon to the right of the column entry.

    3. To include all available columns in the output, click Include all or select the respective Plus icon against the column.

  6. To add the union as specified, click Add to Recipe.

The rows of data in the unioned datasets are added to the original dataset, and the union transformation is inserted in the appropriate recipe.


For example, you are cleansing log messages on a weekly basis. You can create separate datasets for each day's log messages and then bring them altogether into a single dataset for processing through a single recipe. This method works best for datasets that have identical or very similar structures.

Below, you can see two datasets of contact information. These simplified datasets track customer contact records.




Last Contact

Jack Jones


Tina Toms


Larry Lyons




Last Contact Date


Amy Abrams


Tina Toms


Samantha Smith



  • There is one overlapping record for Tina Toms.

  • There is a mismatch in one column name ("Last Contact" vs. "Last Contact Date").

  • The columns are in a different order.


  1. Load your first dataset (Dataset01) .

  2. In the recipe panel, add a step. In the Transformation textbox, enter union.

  3. In the Union page, you bring together two or more datasets based on a shared set of fields.

    1. A union operation appends datasets together.

  4. To add another dataset, click Add datasets. Navigate to select the file to add to the union (Dataset02).

  5. Initially, fields are mapped based on the column names. However, in this example, the Last_Contact_Date field from Dataset02 is not included. You can:

    1. Click the + icon next to the Last_Contact_Date field in the left panel. The field is added as a separate field. However, it is not matched with the other contact date field from the original dataset.

    2. From the Match columns drop-down menu, select By Position. In this case, you can see that there are only three fields, but the order is mismatched.


      When possible, you should try to rename or align columns in your datasets prior to building a Union transformation step. Otherwise, you might have to edit the columns after the union has been completed.

      To rename a column, click Rename from the column drop-down in the Transformer page. You can use the same drop-down to move a column.

  6. In this case, you can cancel the union and reposition the Email column after the Last Contact column in Dataset01.

  7. Then, open the Union page again and add Dataset02. Select By Position from the Match columns drop-down menu. Your columns are matched.

  8. Click Add to Recipe.

Dataset02 records have now been added to Dataset01, which now contains all of the records from both datasets. Note that the record for Tina Toms appears twice in the appended dataset.

  • If the appended dataset is a record of all contacts, you should leave the duplicate record in place.

  • If the appended dataset is a record of the most recent contact with each customer, you should remove the duplicate record with the Deduplicate transformation. For more information, see Deduplicate Data.


Be sure to verify that the data type for each column is accurate.