FNC_GetXML - Advanced SQL Engine - Teradata Database

Teradata Vantage™ - SQL外部ルーチン プログラミング

Product
Advanced SQL Engine
Teradata Database
Release Number
17.10
Published
2021年7月
Language
日本語
Last Update
2021-09-23
dita:mapPath
ja-JP/rin1593638965306.ditamap
dita:ditavalPath
ja-JP/wrg1590696035526.ditaval
dita:id
B035-1147
Product Category
Software
Teradata Vantage

XML型の値を取得します。

構文

void
FNC_GetXML(XML_HANDLE       xmlHandle,
           unsigned char  *xmlBuffer,
           int              xmlBufferSize,
           int            *xmlSize)

構文要素

xmlHandle
外部ルーチンへの入力パラメータとして定義されたXML型へのハンドル。
xmlBuffer
XML文字列を保持するバッファへのポインタ。
xmlBufferSize
FNC_GetXMLに渡されるxmlBufferのバイト単位のサイズ。
xmlSize
FNC_GetXMLによって返されるXML文字列のサイズ(バイト単位)。

使用上の注意

FNC_GetXMLは、XML型の値を取得するために使用されます。値はUNICODE文字セットになります。XML型のXML_HANDLEはポインタとともに入力としてバッファ(xmlBuffer)、およびそのバッファのサイズ(xmlBufferSize)に渡されます。xmlBufferSizeの大きさはXML値の保持に十分である必要があります。

XML値には整形式ではないXMLデータのみを含めることができることに注意してください。

FNC_GetXMLはインラインXML値(サイズが64K未満のXML値)にのみ使用できます。FNC_GetXMLInfoを使用してXML値の最大長を決定できます。FNC_GetXMLをLOBベースのXML値と使用するとエラーが発生します。