To enable incremental copy job with the Data Mover command line, add XML tag enable_incremental_restore and set to "TRUE" after <log_to_event_table> xml tag.
There are a couple of optional parameters under <dsa_options> tag that must be left as UNSPECIFIED. (See Limitations and Caveats and Troubleshooting DELTA Execution Failures sections on when to apply these parameters):
| Parameter Name | Required | Description |
|---|---|---|
| ir_allow_write | No | Used when incremental restore is enabled. Allow write for objects after incremental restore. The valid values are: UNSPECIFIED, TRUE, or FALSE. |
| ir_execution_type | No | Used when incremental restore is enabled. Incremental restore execution type. The valid values are: UNSPECIFIED or FULL. |
The following example shows all the parameters added to the XML for a DSA incremental copy job:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dmCreate xmlns="http://schemas.teradata.com/dataMover/v2009" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schemas.teradata.com/unity/DataMover.xsd">
<source_tdpid>sourceSys</source_tdpid>
<source_user>source_user</source_user>
<source_password>source_password</source_password>
<target_tdpid>targetSys</target_tdpid>
<target_user>target_user</target_user>
<target_password>target_password</target_password>
<use_userid_pool>false</use_userid_pool>
<overwrite_existing_objects>TRUE</overwrite_existing_objects>
<freeze_job_steps>UNSPECIFIED</freeze_job_steps>
<force_utility>DSA</force_utility>
<compare_ddl>UNSPECIFIED</compare_ddl>
<log_level>99</log_level>
<online_archive>UNSPECIFIED</online_archive>
<log_to_event_table>tmsmevent</log_to_event_table
<enable_incremental_restore>TRUE</enable_incremental_restore>
<dsa_options>
<ir_allow_write>UNSPECIFIED</ir_allow_write>
<ir_execution_type>UNSPECIFIED</ir_execution_type>
</dsa_options>
<db_client_encryption>UNSPECIFIED</db_client_encryption>
<database selection="unselected">
<name>db1</name>
<table selection="included">
<name>tb1</name>
</table>
</database>
</dmCreate>