Promoting semantic types across environments

The best practice when using Talend Cloud Data Stewardship or Talend Cloud Data Preparation is to set up one instance for each environment of your production chain and export/import the semantic types in the project across environments.

Exporting semantic types

You can export one or more semantic types from your source environment so that they are ready to be imported into the target environment.

When you export a compound semantic type which references other semantic types, only the names of the references to the children types are exported.

Before you begin

Your Talend Cloud user must have the Semantic types manager role of the Dictionary service application assigned in Talend Management Console, in addition to any of the Talend Cloud Data Stewardship or Talend Cloud Data Preparation roles.

Procedure

Log in to Talend Cloud Data Stewardship as a campaign owner, or Talend Cloud Data Preparation with any of the user roles.
Select SEMANTIC TYPES in the left panel.
To export all the semantic types listed in the page, select the Select All check box or select the check boxes next to the group of semantic types you want to export.
Click EXPORT SEMANTIC TYPE.
In the open dialog box, click OK to save a local copy of the semantic types in a .json file.
The .json file is saved on your local system with a name following the below templates whether you export several semantic types or one respectively:
- <number of exported semantic types>_Semantic_Types_<export_timestamp>
- <semantic type label>_<export_timestamp>
The export date and time are in the format YYYY-MM-DD HH:mm:ss-000.

Results

The semantic types are exported in a .json file. You can now import the file into the target environment.

Importing semantic types

You can import into a target environment one or more semantic types exported from your source environment.

Before you begin

Your Talend Cloud user must have the Semantic types manager role of the Dictionary service application assigned in Talend Management Console, in addition to any of the Talend Cloud Data Stewardship or Talend Cloud Data Preparation roles.
When importing a compound semantic type, all children types referenced by it should have been already published to Talend Dictionary Service in the target environment.

Procedure

Log in to Talend Cloud Data Stewardship as a campaign owner, or Talend Cloud Data Preparation with any of the user roles.
Select SEMANTIC TYPES in the left panel and click the IMPORT SEMANTIC TYPES tab on top of the page.
Browse to the .json file you have exported and saved on your local system and click Open.
A message is displayed to confirm the import, or to prompt you to overwrite a semantic type with the same name which already exists in the target environment.
You are prompted to overwrite a semantic type with the same name only if it is published to Talend Dictionary Service and if it has the same category types as the one you want to import.

Results

The semantic types are imported and automatically published to Talend Dictionary Service, and the Modified By and Modified On values are updated accordingly.

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!

Leave your feedback here