All Products
Search

This Product

    ApsaraDB for OceanBase:Download and import settings of migration objects

    Document Center

    ApsaraDB for OceanBase:Download and import settings of migration objects

    Last Updated:Feb 26, 2025

    The data transmission service allows you to download the settings of migration objects in a data migration task and supports automatic configuration and verification of object settings based on imported CSV files. This allows you to save task settings and configure multiple migration tasks at a time in a quick manner. This feature is suitable for renaming and setting hundreds of objects at a time.

    Download object settings

    After you create a data migration task by specifying migration objects, you can download the settings of the objects, such as the source database name, source table name, target database name, target table name, column mapping, and row filter conditions of an object.

    1. Log on to the ApsaraDB for OceanBase console.

    2. In the left-side navigation pane, choose Data Transmission > Data Migration.

    3. On the Data Migration page, click the name of the task whose object settings you want to download.

      image.png

    4. On the details page of the task, click the ... icon in the upper-right corner, and then click Download Task Configuration in the drop-down list.

      Important

      If you have selected the Match Rules mode to migrate objects in a migration task, you cannot download the object settings of the task.

      image.png

    Import object settings

    The data transmission service allows you to rename databases and tables and set row filter conditions by importing CSV files. You can download the object settings file of an existing task or a template CSV file, modify the file as needed, and then import it.

    Important

    If you edit the object information in an Excel file, save the file as a CSV file, and then import the CSV file.

    The imported CSV file must contain the following columns: source database name, source table name, target database name, target table name, column mapping, and row filter condition.

    1. Log on to the ApsaraDB for OceanBase console and purchase a data migration task.

      For more information, see Purchase a data migration task.

    2. Choose Data Transmission > Data Migration. On the page that appears, click Configuration for the data migration task.

      image.png

    3. Configure the data migration task based on your business needs. On the Select Migration Objects page, select Specify Objects. In the list on the right of the Specify Migration Scope section, click Import Objects in the upper-right corner.

      Important

      You can import objects only if you have selected the Specify Objects mode.

      image.png

      For more information, see the topics for data migration tasks of the corresponding types.

    4. In the dialog box that appears, click OK.

    5. Click Import CSV File in the lower part of the Import Objects dialog box, and select a local CSV file to import it.

      image.png

      You can also click Download CSV Template in the lower part of the dialog box to download the template. Then, configure the settings in the template as needed and click Import CSV File to import the migration objects.

    6. Edit the CSV file as needed.

      Note

      • You can edit the CSV file manually or by using an SQL script. You can also click Download Task Configuration on the details page of the task to generate a CSV file.

      • You can enter names of databases or tables in the target database to establish a mapping between the source and target.

    7. Click Validate to check whether the source objects exist and whether the row filter conditions are correct. If the verification succeeds, the number of verified tables and views is displayed.

    8. Click OK to return to the Select Migration Objects step of the data migration task.

    9. Complete subsequent task settings as prompted.