Teradata Parallel Data Pump

Chapter 3: Teradata TPump Commands
DML
Syntax Element
Description
An upsert saves time while loading a database. An upsert completes, in one
pass, an operation which requires two passes for other utilities. The DML
statements that follow this option must be in the order of a single UPDATE
statement followed by a single INSERT statement.
This option first executes the UPDATE statement. If the UPDATE fails because
the target row does not exist, Teradata TPump automatically executes the
INSERT statement. This capability allows updates to the database without first
presorting the data. Otherwise, the data would have to be sorted into:
• rows that need to be updated
• rows that need to be inserted
Further information on the usage and restrictions of the upsert feature
appears in the following usage notes.
PARTITION
partition_name
SERIALIZEON
serialize_on_field
USE
use_field
Optional keyword used to name a session partition to be used for all SQL
requests associated with this DML command
If this keyword is not present, a session created from the SESSIONS will be
used.
Note: If serialization of two or more DML statements is required, the
statements cannot be put in different partitions. Serialization requires that all
DML statements with identical hash values of the rows be submitted from the
same session.
Parameter identifying the partition name
The partition name must obey the same rules for its construction as Teradata
SQL column names.
Keyword used to turn serialization on for the fields specified
SERIALIZEON keyword may be used before, after, or between any IGNORE
or MARK statements.
Parameter identifying the field names where serialization is turned on
This is the same field name used in the LAYOUT command which was used by
the INSERT statement and referenced by the APPLY clause.
Separate the field names with a comma and enclose them in parentheses.
Keyword used to specify the fields that are to be used with a DML’s SQL
statements
Use of this keyword allows specification of the FIELDs from the LAYOUT
command which are actually needed for each DML, so that data from all fields
will not be sent.[
The USE keyword may be placed before, after, or between any IGNORE/
MARK statements.
Parameter identifying the field names to use
Every LAYOUT FIELD used by any of the DML’s SQL statements must be
enumerated in the USE list; otherwise, an error will occur.
Separate the field names with a comma and enclose them in parentheses.
Teradata Parallel Data Pump Reference 117