25.09.2015 Views

Teradata Parallel Data Pump

Teradata Parallel Data Pump Reference - Teradata Developer ...

Teradata Parallel Data Pump Reference - Teradata Developer ...

SHOW MORE
SHOW LESS
  • No tags were found...

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Chapter 3: <strong>Teradata</strong> T<strong>Pump</strong> Commands<br />

BEGIN LOAD<br />

Syntax Element<br />

PACK<br />

statements<br />

RATE<br />

RETRYTIMES nn<br />

Description<br />

Keyword for the number of statements to pack into a multiplestatement<br />

request.<br />

Maximum value is 2430.<br />

Packing improves network/channel efficiency by reducing the number<br />

of sends and receives between the application and <strong>Teradata</strong> <strong>Data</strong>base.<br />

Number of statements, as a positive integer of up to 2430, to pack into a<br />

multiple-statement request.<br />

Default value is 20 statements per request.<br />

Under certain conditions, <strong>Teradata</strong> T<strong>Pump</strong> may determine that the pack<br />

factor has been set too high. <strong>Teradata</strong> T<strong>Pump</strong> then automatically lowers<br />

the pack setting to an appropriate value and issues warning message<br />

UTY6625, for instance:<br />

“UTY6625 WARNING: Packing has been changed to 12 statements per<br />

request” and continues.<br />

Packing improves network/channel efficiency by reducing the number<br />

of sends/receives between the application and the database.<br />

The packing factor is validated by sending a fully packed request to<br />

<strong>Teradata</strong> <strong>Data</strong>base using a prepare. This test checks for syntax problems<br />

and requests that are excessively large and may overwhelm the parser.<br />

To simplify the script development process, <strong>Teradata</strong> T<strong>Pump</strong> ignores<br />

certain errors returned by an overloaded parser, shrinks the request,<br />

retries the prepare until it executes successfully and finally, issues a<br />

warning noting the revised packing factor size.<br />

When this happens, the <strong>Teradata</strong> T<strong>Pump</strong> script should be modified to<br />

eliminate the warning, thereby avoiding the time-consuming process of<br />

shrinking the request.<br />

A packing failure may occur if the source parcel length does not match<br />

the data defined. If this happens, <strong>Teradata</strong> T<strong>Pump</strong> issues the message:<br />

“UTY2819 WARNING: Packing may fail because input data does not<br />

match with the data defined.”<br />

To resolve this problem, increase the packing factor and resubmit the<br />

job.<br />

Keyword for entering the rate at which statements are sent to <strong>Teradata</strong><br />

<strong>Data</strong>base.<br />

Keyword for retry times number of retry times.<br />

Default is 16.<br />

If nn equals 0, the retry times will be set to 16. If retrytimes is set, this<br />

only takes effect for the requests/data between "BEGIN LOAD" and<br />

"END LOAD" pair.<br />

<strong>Teradata</strong> <strong>Parallel</strong> <strong>Data</strong> <strong>Pump</strong> Reference 103

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!