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:Mar 19, 2024

    The data transmission service allows you to download the settings of migration objects in a data migration project and supports automatic configuration and verification of object settings based on imported CSV files. This allows you to save project settings and configure multiple migration projects 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 project by specifying migration objects, you can download the settings of the objects, such as the source database name, source table name, destination database name, destination 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 project whose object settings you want to download.

      image.png

    4. On the details page of the project, click the More icon in the upper-right corner, and then click Download Project Configuration.

      Important

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

      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 a template CSV file, modify it as needed, and then import it.

    Important

    If you edit the object settings in an Excel file, separate the columns with commas (,), 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, destination database name, destination table name, column mapping, and row filter condition.

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

      For more information, see Purchase a data migration project.

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

      image.png

    3. Configure the data migration project 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 projects of the corresponding type.

    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 Project Configuration on the details page of the project to generate a CSV file.

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

    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 project.

    9. Complete subsequent project settings as prompted.