CHARACTER LARGE OBJECT / CLOB - 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
ft:locale
en-US
ft:lastEdition
2023-07-11
dita:mapPath
iiv1628111441820.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
B035-1147
lifecycle
latest
Product Category
Teradata Vantageā„¢

C Data Type Definition

typedef long LOB_LOCATOR;
typedef long LOB_RESULT_LOCATOR;

Usage

CLOBs are passed as locators only, and not automatically loaded into memory. CLOB argument and return types must specify AS LOCATOR in the CREATE FUNCTION statement.

Here is an example using CLOB AS LOCATOR in a UDF definition and LOB_LOCATOR and LOB_RESULT_LOCATOR in the C function declaration.

SQL Function Definition Equivalent C Function Declaration
CREATE FUNCTION F1 (
  A CLOB AS LOCATOR)
RETURNS CLOB AS LOCATOR
 ...;
void f1( LOB_LOCATOR        *a,
         LOB_RESULT_LOCATOR *result,
   ... )
{  ... }