Skip to main content Skip to complementary content

Promoting a preparation across environments

The best practice when using Talend Cloud Data Preparation is to set up one instance for each environment of your production chain.

To promote a preparation from one environment to the other, you have to export it from the source environment, and then import it back to your target environment.

For the import to work, a dataset with the same name and schema as the one which the export was based on must exist on the target environment.

Let's take the example of a simple preparation, used to remove invalid values and formatting errors from an Excel file containing customers data. This preparation is saved as customers preparation.

Simple preparation opened.

The following procedure will detail how to export this simple preparation into a file that can be reimported to a new environment.

Exporting a preparation from the source environment

Now that your preparation has been finalized on your source environment, it is ready to be exported and sent to the target environment.

Procedure

  1. Log in to your Talend Data Preparation source environment.
  2. In the left panel menu, click Preparations to open the list of existing preparations.
  3. Hover over customers_preparation to display the available actions for this preparation.
  4. Click the Export preparation button.
    Export preparation button highlighted.

Results

The preparation is exported as a .json file and the download automatically starts. Save it to your preferred location and rename it customers_preparation.json for example.

Importing a preparation to the target environment

You will now access your target environment and import the previously exported preparation.

Before you begin

A dataset with the same name and schema as the one which the export was based on must be present on the target environment.

The reason for this is that when a preparation is exported as a .json file, the name and schema of the source dataset are exported, in addition to the preparation steps that were applied. The target environment must contain this information on the source dataset, in other words a dataset with the same name and schema, or an error will occur during the import.

Procedure

  1. Log into your Talend Data Preparation target environment.
  2. In the left panel menu, click Preparations to display the available actions related to preparations.
  3. Click the Import preparation button.
  4. In the file explorer window, select the customers_preparation.json file previously exported.
    A loading bar is displayed during the import process. If a preparation with the same name already exists, you can either overwrite it, or import your preparation with a different name.

Results

The customers preparation is added to the list of preparations in the Preparations view of the homepage. It can now be safely used as a production-ready item, in a Talend Job for example, to easily clean data with the same model.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!