UDMのパラメータ リスト - Advanced SQL Engine - Teradata Database

UDMのC/C++関数の最初のパラメータは、常にそのUDMを呼び出す対象となるUDTのハンドルです。UDMは、UDTのハンドルを使用することによって、呼び出し対象であるUDTの値を取得します。

UDTハンドル パラメータの後に続くパラメータは、CREATE TYPE文のMETHOD指定内のパラメータに対応します。

メソッドにおいて引数にNULLを渡せるようにするには、パラメータ スタイルSQLを使用します。それ以外の場合は、パラメータ スタイルTD_GENERALを使用します。

パラメータ スタイルSQLを使用する場合は、各パラメータのインジケータ パラメータを定義する必要があります。

パラメータ スタイルTD_GENERALの構文

void  method_name  ( UDT_HANDLE  *udthandle,
                   type_1      *input_parameter_1,
                    ...,
                   type_n      *input_parameter_n,
                   result_type  *result,
                   char         sqlstate[6] )
{
     ...
}

パラメータ スタイルSQLの構文

void  method_name ( UDT_HANDLE  *udthandle,
                   type_1      *input_parameter_1,
                    ...,
                   type_n      *input_parameter_n,
                   int         *indicator_parameter_1,
                    ...,
                   int         *indicator_parameter_n,
                   char         sqlstate[6],
                   SQL_TEXT     method_name[m],
                   SQL_TEXT     specific_method_name[l],
                   SQL_TEXT     error_message[p] )
{
     ...
}

説明

例: パラメータ スタイルTD_GENERALのUDM

以下に示すのは、パラメータ スタイルTD_GENERALを使用するUDMのC関数を示すコードの一部です。

/*****  C source file name: to_inches.c  *****/
   
#define SQL_TEXT Latin_Text
#include <sqltypes_td.h>
#include <string.h>
   
void meters_toInches( UDT_HANDLE  *meterUDT
                      FLOAT       *result,
                      char         sqlstate[6])
{
     ...
}

C関数の完全な例については、UDMのサンプル コードを参照してください。

メソッドに関連付けられたUDTを作成するCREATE TYPE文は、次のようになります。

CREATE TYPE meter AS FLOAT
FINAL
   INSTANCE METHOD toInches()
   RETURNS FLOAT
   SPECIFIC toInches
   NO SQL
   PARAMETER STYLE TD_GENERAL
   DETERMINISTIC
   LANGUAGE C;

サ―バーにUDMをインストールするための対応するCREATE METHOD文は、以下のようになります。

CREATE METHOD toInches()
RETURNS FLOAT
FOR meter
EXTERNAL NAME 'CS!toinches!udm_src/to_inches.c!F!meters_toInches';

例: パラメータ スタイルSQLのUDM

以下に示すのは、パラメータ スタイルSQLを使用するUDMのC関数の宣言方法を示すサンプルです。

/*****  C source file name: to_inches.c  *****/
  
#define  SQL_TEXT Latin_Text
#include <sqltypes_td.h>
#include <string.h>
   
void meters_toInches( UDT_HANDLE  *meterUDT
                      FLOAT       *result,
                      int         *meterUDTIsNull,
                      int         *resultIsNull,
                      char         sqlstate[6])
                      SQL_TEXT     extname[129],
                      SQL_TEXT     specific_name[129],
                      SQL_TEXT     error_message[257] )
{
     ...
}

C関数の完全な例については、UDMのサンプル コードを参照してください。

メソッドに関連付けられたUDTを作成するCREATE TYPE文は、次のようになります。

CREATE TYPE meter AS FLOAT
FINAL
   INSTANCE METHOD toInches()
   RETURNS FLOAT
   SPECIFIC toInches
   NO SQL
   PARAMETER STYLE SQL
   DETERMINISTIC
   LANGUAGE C;

サ―バーにUDMをインストールするための対応するCREATE METHOD文は、以下のようになります。

CREATE METHOD toInches()
RETURNS FLOAT
FOR meter
EXTERNAL NAME 'CS!toinches!udm_src/to_inches.c!F!meters_toInches';

引数の動作