Teradata Parallel Data Pump

Chapter 3: Teradata TPump Commands
BEGIN LOAD
Syntax Element
ERRLIMIT
errcount
CHECKPOINT
Description
Optional keyword for setting a limit on records rejected for errors.
When the ERRLIMIT is exceeded, Teradata TPump performs a
checkpoint, then terminates the job. The data read before ERRLIMIT
was exceeded will be submitted and completed before the job is
terminated. This means when a job is terminated due to ERRLIMIT was
exceeded, there may be more error records in the error table than the
number specified in ERRLIMIT. To facilitate diagnosis of data errors,
the ERRLIMIT should be greater than the number of statements packed
into one request.
Error threshold for controlling the number of rejected records. Usage
depends on whether used with the errpercent parameter.
• When used without the errpercent parameter, specifies, as an
unsigned integer, the number of records that can be rejected and
recorded in tname during a load (all records sent between the BEGIN
LOAD and END LOAD commands). The default is no limit.
• When used with the errpercent parameter (which is approximate),
specifies the maximum number of records that must be sent to
Teradata Database before the errpercent parameter is applied.
For example, if errcount = 100 and errpercent = 5, then 100 records must
be sent to Teradata Database before the approximate 5 percent rejection
limit is applied. If only the first five records are rejected when the 100th
record is sent, the limit is not exceeded. If there are six rejections,
however, then the limit is exceeded. After the 100th record is sent,
Teradata TPump stops processing if the 5 percent limit has been
exceeded.
When the limit has been exceeded, Teradata TPump writes an error
message to the external system’s customary message destination and
terminates the task.
All tables in use are left in their state at the time of the termination. This
allows errors to be corrected in data records and restarting of the task
from the last checkpoint. If a restart is not possible or not desired, any
unwanted tables should be dropped.
Keyword indicating the number of minutes between the occurrences of
checkpoints.
This is followed by a frequency value.
Teradata Parallel Data Pump Reference 99