Teradata Parallel Data Pump

Chapter 3: Teradata TPump Commands
IMPORT
The maximum number of INSERT, UPDATE, and DELETE statements that can be referenced
in an IMPORT is 128. The 128th DML which would cause the insertion of the DML sequence
number of 128 for the DMLSEQ field in the error table could lead to Teradata Database 3520
error.
The only DML statements that are candidates for application by an IMPORT command are
those within the scope of DML commands whose labels appear in one or more of the
IMPORT command’s APPLY clauses. The referenced DML commands and their following
DML statement(s) must appear between the BEGIN LOAD command that defines the task
and the referencing IMPORT commands. A statement or group of statements is applied if no
condition is specified, or if the specified condition is true.
Teradata TPump permits multiple statements to be applied to the same data record in either of
two ways. First, if an APPLY clause refers to a label whose scope includes multiple DML
statements, each of these statements is applied to the same data record under the same
condition specified in the clause. Second, if multiple APPLY clauses are used, each can refer to
the label of a different DML statement or group of statements. Each label’s statements are
applied to the same data record under that condition specified in the respective clause. These
features allow the same data record to be applied to different tables under the same or
differing conditions.
VARTEXT Record Usage
When VARTEXT is specified, Teradata TPump assumes that the input data is variable-length
text fields separated by a field delimiter character. It parses each input data record on a fieldby-field
basis, and creates a VARCHAR field for each input text field.
When using the VARTEXT specification, VARCHAR, VARBYTE, and LONG VARCHAR are
the only valid data type specifications to use in Teradata TPump layout FIELD and FILLER
commands.
Two consecutive delimiter characters direct Teradata TPump to null the field corresponding to
the one immediately following the first delimiter character.
Also, if the last character in a record is a delimiter character, and there is at least one more field
to be processed, then Teradata TPump nulls the field corresponding to the next one to be
processed, as defined in the layout FIELD and FIELD command.
The total number of fields in each input record must be equal to or greater than the number of
fields described in the Teradata TPump layout FIELD and FIELD commands.
If it is less, Teradata TPump generates an error message. If it is more, Teradata Database
ignores the extra fields.
The last field of a record does not have to end with a delimiter character. It can end with a
delimiter character, but it is not required.
When Teradata TPump encounters an error condition in an input record, it normally discards
the record and terminates. When loading variable-length text records, inhibit either or both of
these functions by specifying the error-handling options:
• DISPLAY ERRORS
154 Teradata Parallel Data Pump Reference