Teradata Parallel Data Pump

Chapter 3: Teradata TPump Commands
EXECUTE
• Teradata TPump expects the parameter list for any macro to match the FIELD list specified
by the LAYOUT in the script. FILLER fields are ignored. If the USE clause is used in the
DML statement, Teradata TPump expects the parameter list for every macro in the DML
statement to match the field list specified by the USE clause. The order should be the same
as the fields in the LAYOUT.
• The macro should specify a single prime index operation: INSERT, UPDATE, DELETE, or
UPSERT. Teradata TPump reports an error if the macro contains more than one
supported statement.
• The restrictions on INSERT, UPDATE, DELETE, and UPSERT statements supported by
Teradata TPump are described in the corresponding sections of this manual.
If the EXECUTE statement is replacing an INSERT, UPDATE, DELETE, or UPSERT statement
in a job script, the EXECUTE statement must be placed at the same location as the INSERT,
UPDATE, DELETE, or UPSERT statement that it replaces. The following example shows an
INSERT statement is replaced by an equivalent predefined macro:
.DML LABEL LABELA;
DELETE ;
INSERT ;
UPDATE ;
.DML LABEL LABELA ;
DELETE ;
EXECUTE INSERT ;
UPDATE ;
The correct syntax for a Teradata TPump predefined macro is one of the following:
• CREATE MACRO () as (UPDATE....; ) ;
• CREATE MACRO () as (INSERT.....; ) ;
• CREATE MACRO () as (DELETE.....; ) ;
• CREATE MACRO () as (UPSERT.....; ) ;
If a Teradata Database server supports Atomic upsert, then automatic use of Atomic upsert is
allowed, when possible, without changing existing Teradata TPump scripts. This is
accomplished in the following manner:
• Teradata TPump attempts to use the Atomic upsert syntax in defining a single UPSERT
macro (instead of an UPDATE/INSERT macro pair).
• If the UPSERT macro is successfully defined, Teradata TPump uses the Atomic upsert
function for the UPSERT.
• If an error occurs during UPSERT macro definition, presumably due to a violation of
Teradata Database Atomic upsert restrictions, Teradata TPump issues a warning and
reverts to the current Teradata TPump upsert method of paired UPDATE/INSERT
statements.
Teradata TPump will continue to operate as it does now when the existing Teradata TPump
syntax for upsert is encountered, and references to predefined macros are used for either the
UPDATE or the INSERT or both.
Teradata Parallel Data Pump Reference 131