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

SQL External Routine Programming

Deployment
VantageCloud
VantageCore
Edition
VMware
Enterprise
IntelliFlex
Product
Analytics Database
Teradata Vantage
Release Number
17.20
Published
June 2022
ft:locale
en-US
ft:lastEdition
2026-03-06
dita:mapPath
iiv1628111441820.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
qnu1472247494689
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 in which to return the metadata information. 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 and the operator. When invoked in the contract function, the routine must use an input stream. When invoked in the operator, the routine 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.

Example using FNC_TblOpGetUDTMetadata

See Example: FNC_TblOpGetUDTMetadata.