All Products
Search
Document Center

Data Transmission Service:What do I do if an error is reported for a table in a data synchronization instance?

Last Updated:Mar 30, 2026

If a table in your Data Transmission Service (DTS) data synchronization instance reports an error, remove it from the sync scope, clear its data in the destination database, then re-add it.

Prerequisites

Before you begin, make sure that:

  • No business application is reading from the destination database, or applications can tolerate a brief read interruption

  • The source and destination databases are running as expected

  • The data synchronization instance has other objects to synchronize besides the errored table

  • The data synchronization instance is not in the Modifying Objects state

Usage notes

  • Modifying synchronized objects causes the DTS instance to restart automatically. During the restart, brief data inconsistency between the source and destination databases may occur.

  • You must clear the errored table's data in the destination database. Before proceeding, confirm that:

    • Only DTS writes to that table in the destination database, or the table's data can be safely cleared

    • The business that relies on that table is not affected

Fix the table error

The fix follows three steps:

  1. Remove the errored table from the sync scope

  2. Clear the table's data in the destination database

  3. Re-add the table to the sync scope

Step 1: Go to the Data Synchronization Tasks page

  1. Log on to the Data Management (DMS) console.

  2. In the top navigation bar, click Data + AI.

  3. In the left-side navigation pane, choose DTS (DTS) > Data Synchronization.

Note Operations may vary based on the mode and layout of the DMS console. For more information, see Simple mode and Customize the layout and style of the DMS console. You can also go directly to the Data Synchronization Tasks page of the new DTS console.

Step 2: Select the region

On the right side of Data Synchronization Tasks, select the region where the data synchronization instance resides.

Note In the new DTS console, select the region in the top navigation bar instead.

Step 3: Remove the errored table

How you remove the table depends on how the synchronized object was configured.

Note For more information about how to view the frequently-updated table, see View hot data.

Scenario A: The entire database is the synchronized object

If the database containing the errored table was added as the sync object rather than the table individually, follow these steps:

  1. Find the instance and click Reselect Objects in the Actions column. Reselect the objects to be synchronized

  2. In the Selected Objects section, select the database and click the zuoyi icon to remove it. Full Database

  3. In the Source Objects section, select all tables in that database except the errored table, then click the youyi icon to add them to the Selected Objects section. Table shard

  4. Click Next: Advanced Settings, then Next: Save Task Settings and Precheck.

  5. Wait until Success Rate reaches 100%, then click Changed. Return.

Scenario B: The table itself is the synchronized object

If the errored table was added directly as a sync object, follow these steps:

  1. Find the instance and click Reselect Objects in the Actions column. Reselect the objects to be synchronized

  2. In the Selected Objects section, select the errored table and click the zuoyi icon to remove it. Remove an object

  3. Click Next: Advanced Settings, then Next: Save Task Settings and Precheck.

  4. Wait until Success Rate reaches 100%, then click Changed. Return.

Step 4: Clear the table data in the destination database

Warning

This action permanently deletes the table's data in the destination database. Proceed only after confirming that only DTS writes to this table, or that the data can be safely cleared.

For example, you can execute the following statements to clear the data of a table in a MySQL database. Replace <table_name> with the actual table name.

TRUNCATE TABLE <table_name>;

or

DROP TABLE <table_name>;

Step 5: Re-add the table to the sync scope

  1. Find the instance and click Reselect Objects in the Actions column. Reselect the objects to be synchronized

  2. In the Source Objects section, select the errored table and click the youyi icon to add it to the Selected Objects section. Add a table

  3. Click Next: Advanced Settings, then Next: Save Task Settings and Precheck.

  4. Wait until Success Rate reaches 100%, then click Changed. Return.

Note For more information, see Add an object to a data synchronization task.

Step 6: Verify the fix

Wait for the instance to restart, then check whether the error is still reported.