Finalize Table Schema Definition - Parallel Transporter

Teradata Parallel Transporter Operator Programmer Guide

Product
Parallel Transporter
Release Number
16.20
Published
October 2018
Language
English (United States)
Last Update
2018-10-10
dita:mapPath
vxb1527114222350.ditamap
dita:ditavalPath
Audience_PDF_include.ditaval
dita:id
B035-2435
lifecycle
previous
Product Category
Teradata Tools and Utilities

Purpose

Finalize Table Schema Definition is the service function that finalizes the process of creating the table schema.

Structure

#include <pxoper.h>
PXSTC_Code PX_FinalizeTableSchemaDefinition(PX_TableSchemaHandle  tableSchemaHandle);

where the following is true:

Parameter Function Specification
tableSchemaHandle input Table schema handle function to be finalized.

Return Codes

The following Finalize Table Schema Definition function status codes are defined by the Teradata PT operator interface.

Status Code Signifies
PXSTC_Conflict Mismatching type of operations, data, or protocols.
PXSTC_CountError The specified number of objects does not match some predefined value.
PXSTC_LengthError The length of the data to be stored does not match the length of the internal buffer.
PXSTC_BadHandle An undefined table schema handle.
PXSTC_SchemaError An error was detected in the data schema.
PXSTC_Success Successful creation of the table schema.

Usage Notes

Consider the following when using the Finalize Table Schema Definition function.

Topic Usage Notes
Description You must use the Finalize Data Schema Definition function to finalize a data schema before it can be used by Teradata PT operators for subsequent data manipulation functions.
Status If the function status is PXSTC_Success, the defined table schema can be used by Teradata PT operators. See also Begin Table Schema Definition.