以下のように設定した場合、pureQuery は、特定の条件に従って、SQL ステートメントを静的または動的に実行します。また、pureQuery は、pureQueryXML ファイルに代替 SQL ステートメントがある場合は、その代替ステートメントを実行します。
以下のように設定してアプリケーションを実行した場合、
pureQuery は、その SQL ステートメントを実行する必要がある接続用の pureQueryXML ファイル内にステートメントがあるかどうかを検査します。続いて、
pureQuery は、以下のいずれかのアクションを実行します。
- ステートメントが pureQueryXML ファイルにあり、DB2® パッケージにバインドされている場合、pureQuery はステートメントを静的に実行します。
- ステートメントが pureQueryXML ファイルにあるがバインドされておらず、自動生成されるキーを使用せず、対応する <processedSql> 要素に置換用 SQL ステートメントが含まれている場合、pureQuery は、置換用 SQL ステートメントを動的に実行します。
- ステートメントが pureQueryXML ファイルにあるがバインドされておらず、置換用 SQL ステートメントが含まれた対応する <processedSql> 要素がない場合、pureQuery は、SQL ステートメントを動的に実行します。
- ステートメントが pureQueryXML ファイルにない場合、pureQuery は例外をスローします。
表 1. 必要な設定プロパティー |
設定 |
executionMode |
STATIC |
capturedOnly |
TRUE |
enableDynamicSQLReplacement |
TRUE |
pureQueryXml |
file-name.pdqxml または file-name.xml |
この表には、デフォルト値のままにすることができるプロパティーや、ユーザーが使用する可能性があるその他のプロパティーは示されていません。以下に、SQL ステートメントを実行する際に使用可能なプロパティーの完全なリストを示します。
ロギング・プロパティーも
設定できます。ロギングおよびトレースのプロパティーの説明を参照してください。
このようなプロパティーの設定方法と設定場所については、クライアント最適化に関するプロパティーの設定方法を参照してください。