Defining Consumer Operators - Parallel Transporter

Teradata® Parallel Transporter User Guide - 17.20

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
Lake
VMware
Product
Parallel Transporter
Release Number
17.20
Published
June 2022
Language
English (United States)
Last Update
2023-08-25
dita:mapPath
uzp1645128359760.ditamap
dita:ditavalPath
tvt1507315030722.ditaval
dita:id
B035-2445
Product Category
Teradata Tools and Utilities

A consumer operator “consumes” data from the data stream in order to write it to a database, or an external data target, such as a flat file.



A script can have as many consumer operators as there are occurrences of the keyword APPLY. For more information, see “APPLY” in Teradata® Parallel Transporter Reference, B035-2436.

Following is a list of Teradata PT consumer operators:

Operator Description
Operators that Write Data to a Database:
Load The Load operator writes data into an empty database table. It is based on the standalone FastLoad utility protocol.
Update The Update operator can perform INSERT, UPDATE, and DELETE operations on one to five database tables. It is based on the standalone MultiLoad utility protocol.
Stream The Stream operator continuously loads data into database tables. It is based on the standalone TPump utility protocol.
SQL Inserter Inserts data into database tables with SQL sessions.
Operators that Write Data to an External Target:
DataConnector (consumer) Writes data directly to an external flat file. The DataConnector operator can also write data through an access.

The DataConnector operator can also write data into files and tables in Hadoop.

Operators that Process and Write Data to an External Target:
FastExport OUTMOD Adapter Enables a standalone FastExport utility OUTMOD routine to be used to post-process rows exported from database tables, before writing them to external flat files.

Script Requirements

When you define a consumer operator in a Teradata PT script, required specifications include:
  • In the operator definition
    • A name for the operator (maximum of 255 characters, with no spaces).
    • The name of the output schema, if different than the input. Use SCHEMA * if the input and output schemas are the same.
    • Declarations for all required attributes.
  • In the APPLY statement
    • An APPLY TO clause that names the consumer operator.

Teradata PT limits the number of tables consumers can load simultaneously, as follows:

Teradata PT Operator Maximum Target Tables
Load 1
Update 5
Stream 127
SQL Inserter 1

Example: Consumer Operator Definition

Load Operator