UDMのインストール - Advanced SQL Engine - Teradata Database

UDMを作成してテストした後に、それをサーバーにインストールできます。

CREATE METHOD文

ソース コードのファイル名と位置を指定して、それをサーバーにインストールするには、CREATE METHOD文を使用します。

メソッドがコンパイルされ、メソッドの属するデータベースに関連するダイナミック リンク ライブラリ(DLLまたはSO)とリンクされ、システム内のTeradata Databaseのすべてのノードに配布されます。

特定のデータベース内で定義されているすべてのUDMは、単一のダイナミック リンク ライブラリにリンクされます。

デフォルト パスと一時パス

作成時と実行時にUDMを管理するためにTeradata Databaseで使用されるデフォルト パスと一時パスは、UDFおよび外部ストアド プロシージャ用に使用されるデフォルト パスおよび一時パスと同じです。例えば、UDF、UDM、および外部ストアド プロシージャのコンパイルでは、同じ一時ディレクトリが使用されます。

デフォルト パスと一時パスの詳細は、デフォルト パスと一時パスを参照してください。

ソース ファイルの位置の指定

CREATE METHOD文のEXTERNAL句には、ソース コード ファイルの名前とパスを指定します。

CREATE METHOD toInches()
RETURNS FLOAT
FOR meter
EXTERNAL;

CREATE METHOD toInches()
RETURNS FLOAT
FOR meter
EXTERNAL NAME meter_toInches;

CREATE METHOD toInches()
RETURNS FLOAT
FOR meter
EXTERNAL NAME 'CS!toInches!udmsrc/toInches.c!F!meter_toInches';

CREATE METHODとEXTERNAL句の詳細は、<Teradata Vantage™- SQLデータ定義言語 - 詳細トピック、B035-1184>を参照してください。

ODBCでのソース ファイルの位置

ODBCを使用する場合、サーバーに保存されたファイルからUDMのみを作成できます。

JDBCでのソース ファイルの位置

Teradata JDBCインターフェース ドライバを使用すると、Teradata Databaseサーバー上にあるファイルまたはクライアント上にあるリソースからUDMを作成することができます。

クライアント側のUDMソース ファイルは、クラス パスのリソースとして使用できなければなりません。Teradata JDBCドライバにより、クライアントのファイル システムに直接アクセスすることなく、クラス パスからリソースをロードしてサーバー ノードに転送することができます。

C/C++関数名の指定

CREATE METHOD文中のEXTERNAL句は、ソース コードの場所を指定する以外に、C/C++関数宣言内に出現するC/C++関数名、またはC/C++のソースではなくC/C++のオブジェクトが指定された場合には関数のエントリ名を指定します。

CREATE METHOD toInches()
RETURNS FLOAT
FOR meter
EXTERNAL;

CREATE METHOD toInches()
RETURNS FLOAT
FOR meter
EXTERNAL NAME meter_toInches;

CREATE METHOD toInches()
RETURNS FLOAT
FOR meter
EXTERNAL NAME 'CS!toInches!udmsrc/toInches.c!F!meter_toInches';

非標準インクルード ファイルの指定

UDMに非標準のヘッダー ファイルをインクルードする場合は、CREATE METHOD文のEXTERNAL句に、そのヘッダー ファイルの名前とパスを指定する必要があります。

ヘッダー ファイルssn.hをインクルードしている次のようなUDMがあるとします。

/*****  C source file name: p_ssn.c  *****/

#define SQL_TEXT Latin_Text
#include <sqltypes_td.h>
#include "ssn.h"

void encrypt( UDT_HANDLE    *personalUdt,
              VARCHAR_LATIN *result,
              char           sqlstate[6])
{
     ...
}

以下に、非標準のヘッダー ファイルの名前とパスを指定したCREATE METHODの例を示します。

CREATE METHOD encrypt()
RETURNS VARCHAR(64)
FOR personal
EXTERNAL NAME
'CI!ssn!udm_home/ssn.h!CS!encrypt!udm_home/p_ssn.c!F!encrypt';

説明

ライブラリのインストールの詳細については、<Teradata Vantage™ - SQLデータ定義言語-構文規則および例、B035-1144>の「CREATE METHOD」を参照してください。

関連トピック