EVAL ステートメント

EVAL ステートメントのパラメーターは、1 つの文字値です。 それは、SQL ステートメントとして解釈されて処理されます。

EVAL 関数 (それもここで説明します) は、 文字値をパラメーターとしますが、その場合は値を戻す ESQL 式として解釈されます。

注: ユーザー定義関数およびプロシージャーは、 EVAL ステートメントまたは EVAL 関数では定義できません。

構文

EVAL は、式の形式のパラメーターを 1 つ必要とし、その式を評価して、 結果値を文字ストリングにキャストします (すでにそうなっているのでない限り)。 そのため、EVAL に渡される式は、文字ストリングで表せるものでなければなりません。

この最初のステージの評価が完了した後の EVAL の振る舞いは、 それが完全な ESQL ステートメントとして使われているのか、 あるいは ESQL ステートメントの一部を構成する式の代わりに使われているのかによって異なります。
  • 完全な ESQL ステートメントの場合、最初の段階の評価から導出された文字ストリングが、 ESQL ステートメントであるかのように実行されます。
  • ESQL ステートメントの一部を構成する式である場合、 文字ストリングは ESQL 式であるかのように評価されて、EVAL はその結果を戻します。

次の例では、A と B は整数スカラー変数で、 scalarVar1 と OperatorAsString は文字ストリング・スカラー変数です。

EVAL の有効な使用例を次に示します。
  • SET OutputRoot.XML.Data.Result = EVAL(A+B);

    式 A+B は整数値を戻しますが、 整数値は文字ストリングとして表すことができるため、受け入れられます。 必要なキャストは、EVAL が続けて第 2 段階の評価を行う前に実行されます。

  • SET OutputRoot.XML.Data.Result = EVAL('A' || operatorAsString || 'B');
  • EVAL('SET ' || scalarVar1 || ' = 2;');

    最終のストリング・リテラルの最後にあるセミコロンは必要です。 それは、EVAL が ESQL ステートメントの代わりに使われている場合は、 その最初の段階の評価では、終端のセミコロンを含めて、 有効な ESQL ステートメントを表すストリングを戻す必要があるためです。

EVAL ステートメントの内側で宣言される変数は、EVAL ステートメントの外側では使用できません。 この点で、EVAL は関数に似ています。 関数では、ローカルに宣言された変数はローカルでのみ使用され、その関数が終了すると効力を失います。

EVAL の真の能力は、それを使用して ESQL のステートメントや式を動的に構成できることです。 たとえば 2 番目と 3 番目の上記の例では、scalarVar1 または operatorAsString の値は、 送られてくるメッセージ・フィールドの値、または他の動的な値に応じて設定され、 長くなることがある IF THEN の反復を必要とせずに、 ESQL に実行させることを有効に制御することができます。

ただし、EVAL を使った場合のパフォーマンスへの影響を考慮してください。 動的構成およびステートメントや式の実行は、 構成済みのものを単純に実行する場合よりも必然的に時間を要します。 パフォーマンスが非常に重要である場合は、より特定化した高速の ESQL を書くことが望ましいでしょう。

以下の例は EVAL の無効な使用法です。
  • SET EVAL(scalarVar1) = 2;

    この例では、EVAL が、式ではなくフィールド参照を置き換えるために使われています。

  • SET OutputRoot.XML.Data.Result[] = EVAL((SELECT T.x FROM Database.y AS T));

    この例では、EVAL に渡される (SELECT T.x FROM Database.y) は、 文字ストリングとして表せないリストを戻します。

次の例では、(SELECT T.x FROM Database.y AS T) は、 それ自体が式ではなく文字ストリング・リテラルであるため文字ストリングとして表せるので、受け入れ可能です。
SET OutputRoot.XML.Data.Result[]
 = EVAL('(SELECT T.x FROM Database.y AS T)');

関連概念
ESQL

関連タスク
ESQL の開発

関連資料
構文の設定
ESQL のステートメント