Incremental Copy Parameters | Teradata Data Mover - Incremental Copy Parameters - Teradata Data Mover

Teradata® Data Mover User Guide

Product
Teradata Data Mover
Release Number
17.12
Published
January 2022
Language
English (United States)
Last Update
2022-01-18
dita:mapPath
ptl1635805434108.ditamap
dita:ditavalPath
mpm1591127278842.ditaval
dita:id
B035-4101
lifecycle
previous
Product Category
Analytical Ecosystem

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>