FNC_GetDatasetInputLob Function | C Library Functions | Teradata Vantage - FNC_GetDatasetInputLob - Advanced SQL Engine - Teradata Database

SQL External Routine Programming

Product
Advanced SQL Engine
Teradata Database
Release Number
17.10
Published
July 2021
Language
English (United States)
Last Update
2021-07-27
dita:mapPath
rin1593638965306.ditamap
dita:ditavalPath
rin1593638965306.ditaval
dita:id
B035-1147
lifecycle
previous
Product Category
Teradata Vantageā„¢

This routine allows users to read DATASET data that is stored as a LOB using the LOB FNC routines.

Syntax

void
FNC_GetDatasetInputLob( DATASET_HANDLE   datasetHandle,
                        LOB_LOCATOR*     instance  )

Syntax Elements

datasetHandle
A handle to a DATASET data type instance that is defined to be an input parameter to an external routine.
instance
A pointer to a LOB_LOCATOR which will be used to read the LOB data of a DATASET instance.

Usage Notes

Use FNC_GetDatasetInputLob only when the DATASET data is stored as a LOB. If FNC_GetDatasetInfo returns dataLob > 0, you can use FNC_GetDatasetInputLob; otherwise, you should use FNC_GetInternalValue instead.

For Avro instances, this routine returns a LOB_LOCATOR which allows a user to access a buffer that contains the UTF-8 encoded schema, null-terminated, followed by the binary-encoded Avro value. This is equivalent to the transform format.

If the DATASET data is a CSV value, the value does not include any optional schema.