2.1 JDBCドライバの準備
- DatabaseTriggerは、それぞれのDBMS用のJDBCドライバを使用してデータベースに接続します。
- xpiをインストールすると、MS-SQL用のJDBCドライバのみインストールされます。
- MS-SQL以外のDBMSを使用する場合は、「2.3 サービスとイベントの定義」の前に、使用するDBMSのJDBCドライバを下記フォルダに配置する必要があります。
<xpi インストールフォルダ>\Runtime\Java\DatabaseDrivers
- 各DBMS用のJDBCドライバの入手方法は下記の通りです。
| DBMS |
JDBCドライバの入手方法 |
| MS-SQL |
xpi のインストール時にインストールされる |
| Oracle |
OracleのHPよりダウンロードする（Oracleプロファイルへのサインインが必要）
https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html |
| DB2 |
IBMのHPよりダウンロードする
https://www.ibm.com/support/pages/db2-jdbc-driver-versions-and-downloads |
| DB2/400 |
接続先のIBM iより取得する
/qibm/ProdData/HTTP/Public/jt400/lib/jt400.jar |
| MySQL |
MySQLのHPよりダウンロードする（Oracleプロファイルへのサインインが必要）
https://dev.mysql.com/downloads/connector/j/ |
| PostgreSQL |
PostgreSQLのHPよりダウンロードする
https://jdbc.postgresql.org/download.html |
※ xpi 4.13は、JDK1.8で動作しています。JDK1.8に対応したJDBCドライバを入手、使用してください。
2.2 設定ファイルのパラメータ設定
- 監視対象のテーブルが変更された順序通りに、xpiのトリガーを起動するためには、xpiの設定ファイルにパラメータを設定する必要があります。
- 設定ファイルの[MAGIC_IBOLT]セクションのDBTriggerSyncModeパラメータを「Y」に設定します。
- プロジェクトごとに個別に設定する場合は ifs.ini ファイルに、全プロジェクトで一括して設定する場合は magic.ini ファイルにパラメータを設定します。
| 設定ファイル |
パス |
| ifs.ini |
<プロジェクトフォルダ>\ifs.ini |
| magic.ini |
<Magic xpi インストールフォルダ>\Runtime\Magic xpa\magic.ini |
※ このパラメータを「Y」に設定すると、パラメータを省略または「N」に設定した場合に比べ、若干、処理速度が遅くなります。
※ 順番を担保しなくてもよい場合は、パラメータを省略または「N」に設定し、パフォーマンスを優先させることもできます。
2.4 DBMSのデータベーストリガーの作成
【データベーストリガーの作成】
- xpiのDatabaseTriggerを使用するためには、対象のDBMSにデータベーストリガーを作成する必要があります（P.9参照）。
- イベントの定義（P.27参照）を行うと、DBMSのデータベーストリガーを作成するためのテンプレートスクリプトが、下記フォルダに作成されます。
<xpi プロジェクトフォルダ>\Service\<サービス名>\EventActionScripts\<イベント名>_trigger.sql
- テンプレートスクリプトを修正し、各DBMSのクライアントツールにてスクリプトを実行します。
| DBMS |
クライアントツール（例） |
| MS-SQL |
SQL Server Management Studio |
| Oracle |
SQL Developer |
| DB2 |
IBM Data Studio |
| DB2/400 |
System i ナビゲーター |
| MySQL |
MySQL Workbench |
| PostgreSQL |
pgAdmin |
【テンプレートスクリプトの修正】
- データベーストリガーはTriggerActionテーブルにレコードを挿入します。
- TriggerActionテーブルの「Payload」列に設定される値を編集します。
TriggerActionテーブル
| 列名 |
データ型（DBMS依存） |
備考 |
| ActionId |
数値 |
1から連番が振られる |
| SchemaName |
文字（200） |
スキーマ名（データベース名）が設定される |
| TriggerTableName |
文字（200） |
監視対象のテーブル名が設定される |
| ActionType |
文字（1） |
アクションタイプが設定される
挿入：「C」、更新：「U」、削除：「D」 |
| TriggerStatus |
数値 |
レコード挿入時はデフォルト値「0:未処理」が設定される
xpiのDatabaseTrigger処理時に「1:処理済」に更新される |
| Payload |
文字（1000）※ |
更新後の列の値（削除時は削除前の列の値）が設定される |
| CreatedDateTime |
日時 |
レコード挿入時のシステム日時が設定される |
※ Payload列の長さは1000文字となっていますが、足りない場合は各DBMSのクライアントツールでテーブル定義を変更してください。
【テンプレートスクリプトの修正】
- 「FieldName1」、「FieldName2」の部分を実際の列名に書き換えます。
- 必要に応じて列を追加します。
- テンプレートの書式は「$$」区切りですが、書式は自由に変更して構いません。
- 文字型以外の列は、関数を使用して文字型に変換しないと実行時にエラーとなることがあります。
< MS-SQLのテンプレートのPayLoadをXML形式に修正する例 >
