Help Center/ DataArts Studio/ User Guide/ DataArts Migration/ Tutorials/ Migrating Data from OBS to DLI
Updated on 2022-09-23 GMT+08:00

Migrating Data from OBS to DLI

Scenario

DLI is a fully hosted big data query service. This section describes how to use CDM to migrate data from OBS to DLI. The procedure includes four steps:

  1. Creating a CDM Cluster
  2. Creating a DLI Link
  3. Creating an OBS Link
  4. Creating a Migration Job

Prerequisites

  • You have enabled OBS and DLI and have the permissions to read data from OBS.
  • You have created resource queues, databases, and tables on DLI.

Creating a CDM Cluster

If is an independent CDM service, create a CDM cluster by following the instructions provided in Creating a Cluster. If is used as a CDM component of DataArts Studio, create a CDM cluster by following the instructions provided in Creating a Cluster.

In this scenario, if the CDM cluster is used only to migrate data from OBS to DLI and does not need to migrate data of other data sources, there is no special requirements on the VPC, subnet, and security group of the CDM cluster. You can specify them based on your needs. CDM accesses DLI and OBS through the intranet. The flavor of the CDM cluster is selected based on the amount of data to be migrated. Generally, cdm.medium meets the requirements for most migration scenarios.

Creating a DLI Link

  1. Click Job Management in the Operation column of the CDM cluster. On the displayed page, click the Links tab and then Create Link. The Select Connector page is displayed.

    Figure 1 Selecting a connector

  2. Select Data Lake Insight, click Next, and configure the DLI link parameters. See Figure 2.

    • Name: Enter a custom link name, for example, dlilink.
    • AK and SK: Enter the AK and SK used for accessing the DLI database.
    • Project ID: Enter the project ID of the region to which DLI belongs.
    Figure 2 Creating a DLI link

  3. Click Save. The Link Management page is displayed.

Creating an OBS Link

  1. Click Job Management in the Operation column of the CDM cluster. On the displayed page, click the Links tab and then Create Link. The Select Connector page is displayed.

    Figure 3 Selecting a connector type

  2. Select Object Storage Service (OBS) and click Next to configure parameters for the OBS link.

    • Name: Enter a custom link name, for example, obslink.
    • OBS Server and Port: Enter the actual OBS address information.
    • AK and SK: Enter the AK and SK used for logging in to OBS.
    Figure 4 Creating an OBS link

  3. Click Save. The Link Management page is displayed.

Creating a Migration Job

  1. Choose Table/File Migration > Create Job to create a job for migrating data from OBS to DLI. See Figure 5.

    Figure 5 Creating a job for migrating data from OBS to DLI
    • Job Name: Enter a custom job name.
    • Source Link Name: Select the obslink link created in Creating an OBS Link.
      • Bucket Name: Select the bucket from which the data is to be migrated.
      • Source Directory/File: Set this parameter to the path of the data to be migrated.
      • File Format: Select CSV or JSON for transferring files to a data table.
      • Retain the default values of the optional parameters in Show Advanced Attributes. For details, see From OBS.
    • Destination Link Name: Select the dlilink link created in Creating a DLI Link.
      • Resource Queue: Enter the resource queue to which the destination table belongs.
      • Database Name: Enter the name of the database to which data is to be written.
      • Table Name: Enter the name of the table to which data is to be written. CDM cannot automatically create tables on DLI. The table must be created on DLI in advance, and the field types and formats of the table must be consistent with those of the data to be migrated.
      • Clear Before Importing Data: Choose whether to clear data in the destination table before data import. In this example, retain the default value.

  2. Click Next. The Map Field page is displayed. CDM automatically matches the source and destination fields.

    • If the field mapping is incorrect, you can drag the fields to adjust the mapping.
    • CDM supports field conversion during the migration. For details, see Converting Fields.

  3. Click Next and set task parameters. Generally, retain the default values of all parameters.

    In this step, you can configure the following optional functions:
    • Retry Upon Failure: If the job fails to be executed, you can determine whether to automatically retry. Retain the default value Never.
    • Group: Select the group to which the job belongs. The default group is DEFAULT. On the Job Management page, jobs can be displayed, started, or exported by group.
    • Schedule Execution: To configure scheduled jobs, see Scheduling Job Execution. Retain the default value No.
    • Concurrent Extractors: Enter the number of extractors to be concurrently executed. Retain the default value 1.
    • Write Dirty Data: Specify this parameter if data that fails to be processed or filtered out during job execution needs to be written to OBS for future viewing. Before writing dirty data, create an OBS link. Retain the default value No so that dirty data is not recorded.
    • Delete Job After Completion: Retain the default value Do not delete.

  4. Click Save and Run. The Job Management page is displayed, on which you can view the job execution progress and result.
  5. After the job is successfully executed, in the Operation column of the job, click Historical Record to view the job's historical execution records and read/write statistics.

    On the Historical Record page, click Log to view the job logs.