ESQL ファイルの作成

ESQL がその関数をカスタマイズする必要のあるノード (Compute、 Database、DatabaseInput、および Filter ノード) をメッセージ・フローに含めるときは、そのカスタマイズを提供する ESQL ステートメントを ESQL ファイルの ESQL モジュールにコーディングしなければなりません。 複数のモジュールに対して同じ ESQL ファイルを使用できます。

始める前に:

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

このタスクを完了するには、ESQL ファイルが含まれるメッセージ・フロー・プロジェクトを作成しておく必要があります。

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

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

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

    Ctrl+N を押してダイアログ・ボックスを開き、ここで、新しいオブジェクトを作成するウィザードを選択することもできます。 「メッセージ・ブローカー」をクリックすると、WebSphere Message Broker 用に作成可能なオブジェクトのリストが表示されます。 「メッセージ・フロー ESQL ファイル」をクリックしてから、「次へ」をクリックします。

    「新規メッセージ・フロー ESQL ファイル」ウィザードが開きます。
  2. ESQL ファイルを作成して入れるメッセージ・フロー・プロジェクトの名前を入力します。

    既存のメッセージ・フロー・プロジェクトの名前を入力する必要があります。 プロジェクト名フィールドに現行のプロジェクト名が記入された状態で、ダイアログ・ボックスが開きます。 この値を受け入れるか、または別のプロジェクトを指定して変更することができます。 また、「ブラウズ」をクリックして、有効なプロジェクト (「ナビゲーター」ビューで定義され、表示されるプロジェクト) のリストを表示し、そのリストから適切な値を選択することもできます。 リストは、アクティブな作業セットのプロジェクトのみを表示するようフィルタリングされます。

    存在しないプロジェクトの名前を入力した場合、エラー・メッセージ 「指定されたプロジェクトが存在しません。」がダイアログ・ボックスに表示され、有効なプロジェクト名を指定するまで継続することはできません。

  3. 特定のブローカー・スキーマで ESQL ファイルが定義されるようにするには、適切な入力フィールドでそのブローカー・スキーマの名前を入力するか、「ブラウズ」をクリックして、このプロジェクトに有効なブローカー・スキーマのリストからブローカー・スキーマを選択してください。 (このプロジェクトでデフォルトのブローカー・スキーマだけが定義されている場合は、「ブラウズ」が使用不可になります。)
  4. 新規 ESQL ファイルの名前を入力します。 既にこのプロジェクト内で ESQL ファイル名として使われている名前を入力した場合、「リソース <name>.esql が既に存在する」というエラー・メッセージが表示され、別の名前を指定する必要があります。

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

  5. 「終了」をクリックします。

ESQL ファイルがエディターで開きます。ここでファイルを編集した後、保存できます。

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

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

再使用可能なサブルーチンを (ブローカー・スキーマのレベルで) ESQL ファイルで作成する場合、これらのルーチンを別のプロジェクト内の ESQL モジュールから参照したいことがあるでしょう。 ルーチンを参照するには、サブルーチンを実行するプロジェクトが、それらを含む ESQL ファイルの定義場所であるプロジェクトに依存することを指定します。 2 番目のプロジェクトを作成するときに、この動作を指定できます。またはプロジェクトの依存関係を更新することもできます (プロジェクトを選択して「プロパティー」をクリックし、「プロパティー」ダイアログ・ボックスの「プロジェクト参照」ページでプロジェクト依存関係を更新します)。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        最終更新
        
        最終更新 : 2012-08-03 11:55:20


タスク・トピックタスク・トピック | バージョン 7.0.0.5 | ak09031_