DBトリガー

オペレーション名

機能概要

発火イメージ

• トリガー発火前
  
  


• トリガー発火時
  
  

監視イベントの種類

挿入時

更新時

削除時

プロパティ

DBトリガーの設定

実行内容の設定

実行オプションの設定

事前設定について

1. ステータスカラムの追加
   監視対象となるテーブルにステータスカラムを追加します。
   
   例:「SAMPLE」テーブルに「STATUS_COLUMN」をステータスカラムとして追加
   
   
   ステータスカラムのデータ型は整数型(INTEGER)である必要があります。サイズは「5」以上にしてください。


2. XML型スクリプト入力変数の作成
   トリガーで実行するスクリプトにXML型のスクリプト入力変数を作成します。
   スクリプト変数の作成については、「スクリプト変数」を参照してください。
   
   例:スクリプト「Script」にXML型のスクリプト入力変数「in_xml」を作成
   
   
   
   トリガーから渡されるXMLデータは実行スクリプトの最上位のスクリプト入力変数に代入されるため、XML型スクリプト入力変数の位置は最上位にしてください。

使用可能なグローバルリソース

入力XMLデータの扱いについて

1. 監視対象のデータベースのテーブル読み取り処理をスクリプトキャンバスに配置します。
2. テーブル読み取り処理のプロパティ設定ダイアログで、DBトリガーで指定するものと同じグローバルリソースとテーブルを選択します。
3. Mapperをスクリプトキャンバスに配置し、Startアイコン(XML型スクリプト入力変数)からデータフローを引きます。
4. Mapperエディタを開き、入力データのルートの右クリックメニュー[スキーマの読み込み]を選択します。
5. [コンポーネントから選択]で1.で配置したコンポーネントを選択します。

実行IDについて

仕様制限

• 削除時の監視イベントで発火したトリガーは、ステータスカラムの更新のみ行い、レコードは削除しません。
  必要であれば、後続の処理で[削除状態]の値が設定されたレコードの削除を行ってください。


• トリガー発火時に実行スクリプトに渡されるXMLデータは、監視イベントのステータス値を持ったレコードのデータになります。データモデルは「テーブルモデル型」です。
  
  例:「カラム1」「カラム2」「ステータスカラム」という3つのカラムで定義されたテーブルの場合、実行スクリプトに渡されるデータは以下の通りです。
  

  <table>
    <row>
      <column>カラム1の値</column>
      <column>カラム2の値</column>
      <column>ステータスカラム値</column>
    </row>
      :
  </table>
  



• [監視間隔]で指定した時間よりも実行スクリプトの処理の時間が長い場合、その処理が終了した直後にステータスカラムの監視を再開します。
  (その場合、スクリプトの実行間隔が監視間隔となります。)
  つまり、トリガー実行中の場合は対象テーブルに監視イベントが発生しても、そのイベントは検知されません。

主な例外

注意事項

• トリガーの登録後、トリガーに設定されているサービスやスクリプトの状態が変更された場合(サービス名・スクリプト名の変更や、スクリプト変数の追加・削除など)、登録済みのトリガーにその変更は反映されません。
  対象のトリガーのプロパティ設定ダイアログを開き、サービスやスクリプトの再選択を行ったあと[完了]ボタンを押下して再登録してください。


• スクリプト終了時のステータスの変更に失敗する場合があります。
  • 例:データベースへの接続ができない
    →サーバコンソールおよびserver.logにエラーが出力されます。
  • 例:変更対象のレコードがロックされている
    →更新を行わず、トリガーの処理が終了します。


• 名前にマルチバイト文字や機種依存文字を含むカラムを[ステータスカラム]に使用する場合は、カラム名を引用符で囲んでください。
  引用符はデータベースによって異なります。引用符の定義については、各データベースベンダーに問い合わせてください。


• [接続]に使用できるグローバルリソースの種別は「デフォルト」のみとなります。