Teradata Parallel Data Pump

Chapter 3: Teradata TPump Commands
FIELD
Usage Notes
One or more FIELD commands may be intermixed with the TABLE command and the
FILLER command. These commands must follow a LAYOUT command.
If an input record field in fieldname is redefined, the data type from “character” to “decimal”
with the datadesc parameter cannot be changed. This is illegal in Teradata TPump and will
abort the job and return an error message.
If both NULLIF and DROP LEADING/TRAILING BLANKS/NULLSis specified on the same
FIELD command, the DROP clause is evaluated after the NULLIF clause. As an example, in
the FIELD command:
.FIELD FIELDNAME * CHAR (5) NULLIF FIELDNAME = 'x'
DROP LEADING BLANKS;
if the input for fieldname is 'x', the NULLIF expression would evaluate to false because the
leading blanks are not dropped before the NULLIF evaluation.
Specifying Data Types
Use the datadesc parameter to specify the type and length of data in the field. Teradata TPump
generates the USING phrase accordingly with the user-assigned field name to which the body
of the DML statement refers.
For complete details on data types and data conversions, see SQL Data Types and Literals.
The following is a short list of the input length and field description for the data type
specifications which can be made in the datadesc parameter:
Graphic Data Type Specifications
GRAPHIC(n)
Where n is the length of the input stream in terms of double-byte characters.
Length: n*2 bytes, if n is specified; otherwise 2 bytes, as n=1 is assumed.
Description: n double-byte characters.
The following example illustrates the use of the GRAPHIC data types in support of kanji or
multibyte character data. The FIELD statement can contain GRAPHIC data types.
.LAYOUT KANJIDATA;
.FIELD EMPNO * SMALLINT;
.FIELD LASTNAME * GRAPHIC(30);
.FILLER FIRSTNAME * GRAPHIC(30);
.FIELD JOBTITLE * VARGRAPHIC(30);
VARGRAPHIC(n)
Where n is the length of the input stream in terms of double-byte characters.
Length: m + 2 bytes where m/2