ESQL ファイルの作成

ESQL コードでその関数をカスタマイズする必要があるノードをメッセージ・フローに含める場合、そのカスタマイズを提供する ESQL ステートメントを ESQL ファイル内の ESQL モジュールにコーディングする必要があります。 の計算、データベース、データベース入力、 そしてフィルターノードは ESQL コードを使用します。 複数のモジュールに対して同じ ESQL ファイルを使用できます。

始める前に

背景情報については、 ESQL の概要を参照してください。

オプション: ESQL ファイルを作成する前に、アプリケーション、ライブラリー、または 統合プロジェクト を作成できます。 または、ESQL ファイルの作成時に、包含プロジェクトを作成できます。

このタスクの概要

ESQL ファイルは、ファイル・システムまたは共有リポジトリーに保管されます。 ファイル・システムを使用する場合、ローカル・ファイル・システムまたは共有ドライブを使用することができます。 リポジトリー内にファイルを保管する場合、Eclipse によってサポートされる使用可能なリポジトリー (CVS など) を使用できます。

ESQL ファイルを作成するには、以下の手順を完了します。

手順

  1. 「ファイル」 > 「新規」 > 「メッセージ・フロー ESQL ファイル」をクリックします。

    「アプリケーション開発」ビューで 「新規」 をクリックし、 「メッセージ・フロー ESQL ファイル」をクリックすることもできます。

    「新規メッセージ・フロー ESQL ファイル」ウィザードが開きます。
  2. ESQL ファイルを作成する既存のアプリケーション、ライブラリー、または 統合プロジェクト を選択するか、 「新規」 をクリックして新規コンテナーを作成します。

    ESQL ファイルを共有ライブラリーに保管する場合、デフォルトの空のスキーマではないスキーマの内部に ESQL ファイルを配置する必要があります。 詳しくは、 共有ライブラリーを参照してください。

  3. 新規 ESQL ファイルの名前を入力します。
    このプロジェクトの ESQL ファイルに既に使用されている名前を入力すると、エラー・メッセージが表示されます。The resource <name>.esql already existsが表示され, 別の名前を指定しなければなりません。

    ESQL ファイルの作成時には、 Windows ファイル・システムの制限のため、ファイル・パス全体の長さが 256 文字を超えてはなりません。 ESQL を使用して BAR ファイルにメッセージ・フローを追加しようとするか、パス長が 256 文字を超えるファイルをマッピングしようとすると、コンパイル済みメッセージ・フローは生成されず、デプロイできません。 そのため、ESQL ファイル、マッピング・ファイル、プロジェクト、およびブローカー・スキーマの名前は、できる限り短くしてください。

  4. 特定のブローカー・スキーマで ESQL ファイルを定義するには、 「デフォルト・ブローカー・スキーマの使用」 をクリアして、ドロップダウン・リストからブローカー・スキーマを選択するか、ブローカー・スキーマの名前を入力します。
  5. 「終了」をクリックします。

結果

ESQL ファイルがエディターで開きます。ここでファイルを編集した後、保存できます。 ESQL ファイルは、 「アプリケーション開発」ビューの、収容アプリケーション、ライブラリー、または 統合プロジェクトの ESQL フォルダーの下に表示されます。

ESQL ファイルは、自動的に作成することもできます。 右クリックすると計算、データベース、データベース入力、 またはフィルターノードをクリックし、 ESQLを開く。 適切なプロパティーで識別されるモジュールがブローカー・スキーマにまだ存在しない場合、モジュールが自動的に作成されます。 このモジュールは、<message_flow_name>.esql ファイルと同じプロジェクトの、同じブローカー・スキーマ内のファイル <message_flow_name>.msgflow 内に作成されます。 その ESQL ファイルが既に存在しない場合には、それも作成されます。

単一の ESQL ファイルの内容には、メッセージ・フローおよびノードとの特定の関係はなにもありません。 どのファイルにどのモジュールが作成されるかは、ご自分で決定します (上記の説明のように、適切なプロパティーで識別される特定のモジュールがデフォルトでファイル <message_flow_name>.esql に作成される場合以外)。 各ファイルの ESQL のサイズおよび複合度をモニターし、表示や管理が困難になった場合、そのファイルを分割します。

再使用可能なサブルーチンを (ブローカー・スキーマのレベルで) ESQL ファイルで作成する場合、これらのルーチンを別のプロジェクト内の ESQL モジュールから参照したいことがあるでしょう。 ルーチンを参照するには、サブルーチンを実行するプロジェクトが、それらを含む ESQL ファイルの定義場所であるプロジェクトに依存することを指定します。 この動作は、2 番目のプロジェクトを作成するときに指定することも、プロジェクト参照を作成することもできます。 他のライブラリー内のリソースの参照を参照してください。