Teradata Parallel Data Pump

Chapter 3: Teradata TPump Commands
IMPORT
Syntax Element
WHERE condition
Description
Condition that determines whether the indicated label options are applied to
the records and sent to Teradata Database, where:
• condition true = yes
• condition false = no
The condition specification can reference:
• Any combination of fields defined in the currently active layout
• System and user-defined constants and variables
• The fieldname1 specified in commands
When VARTEXT is specified, the Teradata TPump utility assumes that the
input data is variable-length text fields separated by a field delimiter
character. The utility parses each input data record on a field-by-field basis,
and creates a VARCHAR field for each input text field.
When the character set of the job script is different from the client character
set used for the job (for example, on z/OS the job script must be in Teradata
EBCDIC when using the UTF8 client character set, or UTF-16 client
character set can be used with the job script in UTF8), Teradata TPump
translates the string constants specified in the condition and the import data
referenced in the condition to the same character set before evaluating the
condition.
For example, when the client character set is UTF-16 and the script character
set is UTF8, if the following command is given
… APPLY lable1 WHERE C1 = 'INSERT';
Teradata TPump translates the data in the C1 field to the UTF8 form and
compares it with the UTF8 form of 'INSERT' to obtain the evaluation result.
Similarly, on the mainframe, when the client character set is UTF8 and the
script character set is Teradata EBCDIC, if the following command is given:
… APPLY lable2 WHERE C2 = 'DELETE';
Teradata TPump translates the data in the C2 field from the UTF8 form to the
Teradata EBCDIC form and perform the comparison with the Teradata
EBCDIC form of 'DELETE'.
Caution:
When using the UTF8 client set on the mainframe, be sure to
examine the definition in International Character Set Support to
determine the code points of the special characters required.
Different versions of EBCDIC do not always agree as to the
placement of these characters. The mappings between Teradata
EBCDIC and Unicode can be referred to in Appendix E of
International Character Set Support.
Usage Notes
A maximum of four IMPORT commands can be used in a single Teradata TPump load task. A
single load comprises the set of commands and statements bounded by a BEGIN LOAD-END
LOAD command pair. If the number of IMPORTs sent to Teradata Database for the load
exceeds four, an error message is logged. Teradata TPump has been limited to four IMPORTs
per load in order to limit the amount of memory needed to keep track of job-related statistics.
Teradata Parallel Data Pump Reference 153