Mapping Object Names

Data synchronization allows you to synchronize objects (including databases, schemas and tables) in a sources database to the corresponding objects in a destination database. If the synchronization objects in source and destination databases have different names, you can map the source object name to the destination one. The object types that can be mapped include database, schema, and table.

Object name mapping can be used only in the following scenarios:

For the first time you select synchronization objects for a data synchronization task.
For the first time you add or delete the synchronization object which is not in a mapping relationship.

Objects whose database names or table names contain newline characters cannot be mapped.
If the destination DB is a type of PostgreSQL (for example, GaussDB, or PostgreSQL), the destination schema name cannot start with pg_. Otherwise, the migration fails.
The following data flow types do not support schema mapping for tables of the smallserial, serial, and bigserial types:
- GaussDB primary/standby -> GaussDB distributed
- GaussDB primary/standby -> GaussDB primary/standby
- GaussDB distributed -> GaussDB distributed
- GaussDB distributed->GaussDB primary/standby

This section describes how to map objects when configuring a data synchronization task. For details about the mapping relationship, see Viewing Synchronization Mapping Information.

Mapping Databases

During real-time synchronization, if the names of source databases to be synchronized are different from those in the destination, you can map the source database names to the destination ones.

On the Set Synchronization Task page, select the database that needs to be mapped from the synchronization objects on the right area and click Edit.

Figure 1 Mapping databases
Changing a database name

In the displayed dialog box, enter a new database name. The new database name is the name of the database saved in the destination DB instance.

Figure 2 Changing a database name
Check the result.

After the database name is changed, the database name before modification and the new database name are displayed. The database mapping is complete.
Figure 3 Checking the result

Mapping Schemas

A schema is a collection of database objects, including: tables, views, stored procedures, and indexes.

During real-time synchronization, if the names of source schemas to be synchronized are different from those in the destination, you can map the source schema names to the destination ones.

On the Set Synchronization Task page, select the schema that needs to be mapped from the synchronization objects on the right area and click Edit.

Figure 4 Mapping schemas
Edit the schema name.

In the displayed dialog box, enter a new schema name which is the name to be saved in the destination database.

Figure 5 Edit Schema Name
Check the result.

After the schema name is changed, the schema name before modification and the new schema name are displayed. The schema mapping is complete.
Figure 6 Checking the result

Mapping Tables

During real-time synchronization, if the names of source tables to be synchronized are different from those in the destination, you can map the source table names to the destination ones.

On the Set Synchronization Task page, select the table that needs to be mapped from the synchronization objects on the right area and click Edit.

Figure 7 Table name mapping
Change a table name.

In the displayed dialog box, enter a new table name. The new table name is the name of the table saved in the destination database.

Figure 8 Changing a table name
Check the result.

After the table name is changed, the table name before modification and the new table name are displayed. The table mapping is complete.
Figure 9 Checking the result