4.1.1　環境設定手順

(a)　pdplgrgstコマンドの入力形式

pdplgrgstコマンドの入力形式を次に示します。

pdplgrgst　プラグイン定義ファイル名　PICファイル名

HiRDB Text Search Plug-inの場合の指定例

• データ型プラグインの場合：

  pdplgrgst _phsgml.adt _phsgml.pic

  （カレントディレクトリが/TSPlugin/_phsgml/etcの場合）

• インデクス型プラグインの場合：

  pdplgrgst _phngram.idx _phngram.pic

  （カレントディレクトリが/TSPlugin/_phngram/etcの場合）

注意事項

• インデクス型プラグインを登録する場合，あらかじめ対応するデータ型プラグインが登録されていなければなりません。

• データ型プラグインとインデクス型プラグインは，必ず同じスキーマ内に登録してください。

(b)　プラグインの所有者

プラグインの所有者（プラグインが提供する抽象データ型，インデクス型及び関数の所有者）はMASTERになります。したがって，プラグインが提供する関数を呼び出す処理をSQL文に記述する場合，認可識別子を省略できます。

MASTER以外にする場合

所有者をMASTERではなく，pdplgrgstコマンドの実行者にできます。pdplgrgstコマンドに-uオプションを指定すると，プラグインの所有者はpdplgrgstコマンドの実行者（クライアント環境定義のPDUSERオペランドに指定した認可識別子）になります。ただし，この場合，次に示す注意があります。

注意事項

1. pdplgrgstコマンド実行者のスキーマが既に定義されている必要があります。

2. プラグインが抽象データ型及びインデクス型の両方を提供している場合は，必ず同じ所有者にしてください。

3. プラグインの削除又はバージョンアップは，プラグインの所有者しかできません。また，pdplgrgstコマンドに-uオプションを指定してプラグインを削除又はバージョンアップしてください。

4. プラグイン所有者のスキーマを削除すると，プラグインも同時に削除されます。この場合，次に示す作業が必要です。

   ・システム共通定義からpdpluginオペランドを削除します。

   ・すべてのサーバマシンでpdplgset -dコマンドを実行してプラグインをアンセットアップします。

5. 複数のプラグインで，関数名及びパラメタ数が同じである関数を提供している場合，一方のプラグインを登録し，そのプラグインが提供する関数を呼び出す関数をユーザが定義した後，もう一方のプラグインを登録します。このとき，ユーザが定義した関数のパラメタ，又は戻り値のデータ型に抽象データ型を使用し，かつ，その関数をビュー定義に使用している場合は，プラグインの登録時にエラーとなります。この場合，その関数を使用したビュー表を削除した後，再度プラグインの登録を行う必要があります。

(c)　HiRDB Version 5.0（HiRDB Object Option付）01-00を使用していた場合

プラグインの所有者は変わりません

HiRDB Version 5.0（HiRDB Object Option付）01-00では，プラグインの所有者はpdplgrgstコマンドの実行者です。HiRDB Version 6 06-00以降にバージョンアップしても，プラグインの所有者は変わりません（MASTERになりません）。

所有者をMASTERにする方法

所有者をMASTERにするには，いったんプラグインを削除して再登録する必要があります。

なお，プラグインを削除するには，プラグインが提供している抽象データ型，インデクス型及び関数を使用している表やビュー表，インデクスを事前に削除する必要があります。その後，pdplgrgstコマンドを実行します。

また，既存のSQL文でプラグインが提供する関数を呼び出している箇所に認可識別子を記述している場合，それを削除するかMASTERに書き換える必要があります。