Teradata Parallel Data Pump

Chapter 3: Teradata TPump Commands
PARTITION
Syntax Element
statements
threshold
Description
Number of statements, as a positive integer of up to 2430, to pack into a
multiple-statement request
Default value is 20 statements per request.
Note: Under certain conditions, Teradata TPump may determine that the
pack factor has been set too high. Teradata TPump then automatically
lowers the pack setting to an appropriate value and issues warning message
UTY6625, for example:
“UTY6625 WARNING: Packing has been changed to 12 statements per
request”, and continues.
Packing improves network/channel efficiency by reducing the number of
sends/receives between the application and the database.
The packing factor is validated by sending a fully packed request to
Teradata Database using a prepare. This test checks for syntax problems
and requests that are excessively large and overwhelm the parser.
To simplify the script development process, Teradata TPump ignores
certain errors returned by an overloaded parser, shrinks the request, retries
the prepare until it executes successfully and finally, issues a warning noting
the revised packing factor size.
When this happens, the Teradata TPump script should be modified to
eliminate the warning, which avoids the time-consuming process of
shrinking the request.
Note: A packing failure may occur if the source parcel length does not
match the data defined. If this happens, Teradata TPump issues the
message:
“UTY2819 WARNING: Packing may fail because input data does not
match with the data defined.”
To resolve this problem, increase the packing factor and resubmit the job.
Minimum number of sessions to be logged on for the partition
When logging on sessions, if system limits are reached above the threshold
value, Teradata TPump stops trying to log on, and uses whatever sessions
are already logged on.
If the sessions run out before the threshold is reached, Teradata TPump
logs off all sessions, waits for the time determined by the SLEEP value
(specified in the BEGIN LOAD command), and tries to log on again.
Example
A sample script that uses partitioning follows:
.LOGTABLE TPLOG01;
.LOGON cs4400s3/cfl,cfl;
DROP TABLE TPTBL01;
DROP TABLE TPTBL02;
DROP TABLE TPERR01;
CREATE TABLE TPTBL01, FALLBACK(
C1 CHAR(12) not null,
Teradata Parallel Data Pump Reference 177