You can use the convert REST API resource to automatically convert a synchronization task to a data transfer task.
Data transfer tasks provide the same functionality as synchronization tasks while also providing support for more connector types, such as Snowflake V2.
When you convert a synchronization task, Data Integration creates a new data transfer task based on the synchronization task in the project folder specified in the convert request. It doesn't delete the synchronization task. The data transfer task contains the same task configurations as the synchronization task, including connection configurations, filters, parameters, field mappings, and runtime attributes.
You can't convert synchronization tasks that contain the following objects:
•More than five lookup objects
•Mapplets
•Multiple source objects
•Target child objects
If the synchronization task has data sorting configured, the sort direction for all fields must be the same in order to convert the task to a data transfer task. You can't convert tasks with multiple sort directions.
Data Integration tags both tasks so that you can determine which assets in your organization have been converted. It tags new data transfer tasks with the tag "MIGRATED FROM DSS" and converted synchronization tasks with the tag "MIGRATED TO DTT".
For more information about the convert REST API resource, see the REST API Reference.
Post conversion checklist
Perform the following tasks after converting a synchronization task to a data transfer task.
•If the synchronization task is used by a taskflow or linear taskflow, update the taskflow or linear taskflow to use the data transfer task.
•If the data transfer task runs on the same schedule as the synchronization task, update one of the tasks to avoid running multiple tasks at once.
•Optionally, update asset tags. Data Integration automatically tags the synchronization task and the data transfer task, but you can update the tags.
Data transfer task behavior changes
Consider the following behavior changes when you convert a synchronization task to a Data transfer task:
•If the synchronization task has a lookup configured in the field mapping, Data Integration creates a lookup source in the data transfer task. The lookup field remains mapped to the target.
•Data transfer tasks display only technical field names in filters and field mappings.
•Data transfer tasks don't persist alphabetical sorting of fields in the database.
•Data Integration converts saved queries in a synchronization task to custom queries in the data transfer task. Custom queries are not shared components.
•Data Integration doesn't retain schema snapshots of source connections when it converts a synchronization task to a data transfer task.
•Data Integration doesn't copy object metadata changes to objects in the data transfer task. You can't edit object metadata in a data transfer task.