After you run an export task to export data objects from a workspace, you can create an import task to import these data objects to a specified workspace.


  • The Migration Assistant feature is in public preview. This feature is supported in the following regions: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Shenzhen), China (Chengdu), and Singapore (Singapore).
  • To create an export or import task, you must use an Alibaba Cloud account or be a workspace administrator. If you use a workspace as a Resource Access Management (RAM) user who is not assigned the administrator role, you can only view export and import tasks.

Go to the Migration Assistant page

  1. Log on to the DataWorks console.
  2. In the left-side navigation pane, click Workspaces.
  3. After you select the region where the required workspace resides, find the workspace and click Data Analytics.
  4. Click the Icon icon in the upper-left corner. Then, choose All Products > Other > Migration Assistant. By default, DataWorks migration > DataWorks export is displayed.

Create an import task

  1. In the left-side navigation pane of Migration Assistant, choose DataWorks migration > DataWorks import.
  2. On the Import Tasks page, click Create Import Task in the upper-right corner.
  3. In the Create Import Task dialog box, configure the parameters as required.
    Create Import Task
    Parameter Description
    Name The name of the import task. The name can contain only uppercase and lowercase letters, digits, underscores (_), and periods (.).
    Upload From The source of the package that you want to import. Valid values: Local and OSS.
    • If you select Local for this parameter, perform the following steps to upload a package on your machine:
      1. Click Upload File.
      2. In the dialog box that appears, select the package that you want to upload and click Open.
      3. Click Check.
      4. When the message The resource package has passed the check appears, click Preview. On the page that appears, check the package that you want to import.
      Note The size of the package that you want to upload cannot exceed 30 MB.
    • If you select OSS for this parameter, enter the endpoint of an Object Storage Service (OSS) object in the OSS Endpoint field. Then, click Check and Preview in sequence to check and preview the package that you want to upload.
    Remarks The description of the import task.
  4. Click OK. The Import Task Settings page appears.
    Make sure that you have checked the format and content of the package before you click OK.
  5. Configure the import task.
    When you configure the import task, you must complete the settings in the Engine Instance Mapping section. The settings in other sections are optional and can be configured as required. Import
    Note If you migrate data objects between workspaces that are deployed in the same region within the same Alibaba Cloud account, you need only to configure compute engine mapping.
    1. In the Engine Instance Mapping section, select a compute engine of the destination workspace for each compute engine that is bound to the source workspace.
      If multiple compute engines are bound to the source workspace and only one compute engine is bound to the destination workspace, the import task fails. This is because certain types of nodes cannot be created in the destination workspace due to missing of the required compute engines.
    2. Optional:In the Resource Group Mapping section, configure resource group mapping between the source and destination workspaces. This ensures that resource groups are available for running imported nodes.
    3. Optional:In the Dependency Mapping section, configure workspace mapping for relevant nodes.
      Certain nodes use the name of the source workspace in their code. In this case, you must configure workspace mapping for the nodes to run properly after they are imported. Set the New Workspace parameter to the name of the destination workspace. The system uses this workspace name to replace the original workspace name in the node code and the names of the ancestor and descendant nodes of the current node. After the import task is completed, the original workspace name is replaced with the new workspace name.
    4. Optional:In the Dry-run section, find the destination node that you want to set as a dry-run node and click Set up empty run in the Actions column.
      You can also select multiple nodes and click Batch Configure to set these nodes as dry-run nodes.

      This configuration is used to configure the scheduling mode of auto triggered nodes. The auto triggered node that is set as a dry-run node returns a success response without running and does not generate any data.

    5. Optional:In the Commission Rules section, configure the commission rules for Resources, Tables, and Functions, and specify whether to enable Change Owner as required.
      • If a data object with the same name as the data object you want to import exists in the destination workspace, the imported data object cannot be committed.
      • If you select No for the Change Owner parameter and no owner is specified for the node you want to import, you are automatically configured as the owner of the node after it is imported.
  6. Click Import in the upper-right corner.
  7. In the Confirm message, click OK.

View import tasks

On the Import Tasks page, the operations that you can perform on import tasks vary based on their status.
  • After an import task is completed, you can view the details of the task. To view the task details, find the task on the Import Tasks page and click View Import Report in the Actions column. On the page that appears, view the task information in the Basic Information, Import Settings, Import results, and Details sections.Import report
  • If an import task is in the Editing state, you can perform the following steps on the task:
    • Click Edit in the Actions column. On the Import Task Settings page, modify the task configurations.
    • Click Preview in the Actions column. On the page that appears, view the task information in the Basic Information, Overview, and Details sections.
    • Click Delete in the Actions column. In the message that appears, click Ok to delete the task.
  • If an import task is in the Import failed state, you can click Re-import in the Actions column of the task. In the Import progress dialog box, click Return to import task list after the import task is completed.