FNC_TblOpGetUDTMetadata Function | C Library Functions | Teradata Vantage - FNC_TblOpGetUDTMetadata - Analytics Database - Teradata Vantage

SQL External Routine Programming

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
VMware
Product
Analytics Database
Teradata Vantage
Release Number
17.20
Published
June 2022
Language
English (United States)
Last Update
2023-07-11
dita:mapPath
iiv1628111441820.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
B035-1147
lifecycle
latest
Product Category
Teradata Vantageā„¢

Returns metadata information about one or more UDT columns for an input or output stream.

Syntax

void
FNC_TblOpGetUDTMetadata(int                   streamno,
                        Stream_Direction_en   direction,
                        int                   columnno,
                        int                   bufSize,
                        UDT_BaseInfo_t      *udtbaseInfo);

Syntax Elements

streamno
The input stream number.
direction
Input or output.
columnno
The column number for which UDT metadata is requested. If columnno is -1, UDT metadata is returned for all columns.
int bufSize
The size of the udtbaseInfo buffer passed to this function.
udtbaseInfo
A pointer to an array of UDT_BaseInfo_t structures that will contain the metadata information returned by this function. If you request metadata for all input columns, you must allocate sufficient memory for all the columns.

Usage Notes

FNC_TblOpGetUDTMetadata returns an array of UDT_BaseInfo_t structures that contain UDT metadata information for one or more input or output UDT columns for an input stream. For nonUDT columns, the udt_indicator is set to 0.

This routine is only supported with table operators. The function can be invoked in both the contract function as well as the operator. When invoked in the contract function, it can only be used with an input stream. When invoked in the operator, it can be used with either the input or output stream.

For more information about the UDT_BaseInfo_t structure and the udt_indicator, see Table Operator Data Structures.