TRIGGERファンクション

TRIGGERファンクションは、トリガー・プログラム(つまり、TRIGGER_DEFINE、TRIGGER_AFTER_UPDATE、TRIGGER_BEFORE_UPDATEのいずれかのプログラム、またはTRIGGERコマンドを使用してトリガー・プログラムとして指定された任意のプログラム)を実行するイベント、サブイベント、オブジェクトまたはアナリティック・ワークスペースの名前のいずれかを検索するファンクションです。

現行のプログラムがトリガー・プログラムの場合、TRIGGERファンクションはプログラムのトリガー情報を返します。そうでない場合、TRIGGERファンクションは、最後に実行されたトリガー・プログラムのトリガー情報を返します。

関連項目:

イベントの詳細は、「トリガー・プログラム」およびTRIGGERコマンドを参照してください。

SUBEVENT

EVENTからの戻り値がMAINTAIN、AFTER_UPDATEまたはBEFORE_UPDATEの場合は、プログラムの実行をトリガーしたOLAP DML文の詳細な情報を返します。AWの有効なサブイベントについては、表8-18「AWイベントのサブイベント」で説明しています。MAINTAINの有効なサブイベントについては、表8-19「MAINTAINイベントのサブイベント」で説明しています。UPDATEの有効なサブイベントについては、表8-20「UPDATEイベントのサブイベント」で説明しています。

表8-18 AWイベントのサブイベント

サブイベント	説明
CREATE	AW CREATE文がプログラムの実行をトリガーすると返される。
ATTACH	AW ATTACH文がプログラムの実行をトリガーすると返される。
DELETE	AW DELETE文がプログラムの実行をトリガーすると返される。
DETACH	AW DETACH文がプログラムの実行をトリガーすると返される。

表8-19 MAINTAINイベントのサブイベント

サブイベント	説明
ADD	MAINTAIN ADD文がプログラムの実行をトリガーすると返される。
DELETE	MAINTAIN DELETE ALL文を除く任意のMAINTAIN DELETE文がプログラムの実行をトリガーすると返される。
DELETE ALL	MAINTAIN DELETE ALL文がプログラムの実行をトリガーすると返される。
MERGE	MAINTAIN MERGE文がプログラムの実行をトリガーすると返される。
MOVE	MAINTAIN MOVE文がプログラムの実行をトリガーすると返される。
RENAME	MAINTAIN RENAME文がプログラムの実行をトリガーすると返される。

表8-20 UPDATEイベントのサブイベント

サブイベント	説明
AW	UPDATEコマンドがTRIGGER_AFTER_UPDATEプログラムまたはTRIGGER_BEFORE_UPDATEプログラムの実行をトリガーすると返される。
MULTI	オブジェクトをマルチライタ・モードで取得したときに、TRIGGERコマンドを使用してトリガー・プログラムとして指定したプログラムの実行をUPDATEコマンドがトリガーすると返される。

例

TRIGGERファンクションの使用例は、例6-3「TRIGGER_BEFORE_UPDATEプログラム」および例10-166「Assignトリガーを使用した代替値の代入」を参照してください。