各アプリケーション環境における pureQuery Runtime プロパティーのサポート

pureQuery Runtime を、pureQuery API、pureQuery クライアント最適化、Call Level Interface (CLI) を組み込んだアプリケーションで使用するときにサポートされるプロパティーの要約。
以下の表で、pureQuery Runtime プロパティーとサポートされるアプリケーション環境の一覧を示します。
表 1. pureQuery プロパティーとサポートされるアプリケーション環境
プロパティー 説明 pureQuery API3 を使用する Java アプリケーション pureQuery クライアント最適化を使用する Java アプリケーション pureQuery クライアント最適化を使用する CLI アプリケーション
allowDynamicSQL1 pureQueryXML ファイルに取り込まれていない SQL ステートメント、または取り込まれているがバインドされていない SQL ステートメントをアプリケーションで動的に実行できるようにするかどうかを指定します。   X X
capturedOnly2 pureQueryXML ファイル内に存在する SQL ステートメントのみを実行するようにするかどうかを指定します。 X X X
captureMode SQL ステートメントに関する情報を取り込むかどうかを指定します。 X X X
captureStatementBatchSQL 最大で maxNonParmSQL プロパティーで指定された SQL ステートメント (SELECT ステートメントを除く) の数まで、アプリケーションが Statement.addBatch() メソッドに渡す SQL DML ステートメントを取り込むかどうかを指定します。 X X  
enableDynamicSQLReplacement 元のステートメントと pureQueryXML ファイルに追加された代替 SQL ステートメントの両方がバインドされていない場合に、その代替ステートメントを実行するかどうかを指定します。 X X X
executionMode 以前に pureQuery Runtime によって取り込まれて保管された SQL ステートメントを静的に実行するかどうかを指定します。 X X X
finalRepositoryProperties pureQuery 対応のアプリケーションで使用する pureQuery プロパティーの場所を指定します。   X  
maxNonParmSQL 取り込むパラメーター化されていない SQL ステートメントの最大数を指定します。 このオプションは、captureMode の値が ON である場合にのみ適用されます。 captureMode が OFF である場合、pureQuery はこのパラメーターを無視します。 X X X
maxResultRow ステートメントが照会結果で返す最大行数を指定します。 X    
maxStackTracesCaptured 取り込む SQL ステートメントごとに定義ポイントおよび実行ポイントに対して記録されるスタック・トレースの最大数を指定します。 X X  
outputPureQueryXml SQL ステートメントの取り込みプロセスで作成される 1 つ以上のファイルへの完全修飾パスまたは相対パス、およびそのファイルの名前を指定します。 X X  
outputXmlRepository リポジトリーを含むデータベースを指定します。リポジトリーには、クライアントの最適化のために pureQuery 対応アプリケーションから取り込まれた SQL データが保管されます。   X  
packagePrefixExclusions スタック・トレースに組み込まない Java パッケージのドメインおよびサブドメインのパイプ区切りリストを指定します。 X X  
propertiesGroupId データベースに作成されるリポジトリー内のランタイム・グループ ID を指定します。 pureQuery Runtime は、このランタイム・グループ ID と、リポジトリーを指定する接続情報を使用して、アプリケーションから取り込まれた SQL データを保管するか、pureQuery ランタイム構成情報および pureQueryXML ファイル情報を取得します。   X  
propertiesRefreshInterval pureQuery クライアントの最適化によって、保管されている pureQuery データの場所で pureQuery プロパティーの変更または pureQueryXML データの変更の検査が実行されるまでの待機期間 (分数) を指定します。 更新が検出されると、pureQuery クライアントの最適化によって、更新された pureQuery ランタイム・プロパティーと pureQueryXML データが取得されて、更新された情報が使用されます。   X  
pureQueryXml SQL ステートメントを取り込むプロセスで作成されるファイル、またはそのプロセスの結果として既に存在するファイルへの完全修飾パスまたは相対パスとファイル名を指定します。 X X X
queryTimeoutInSeconds SQL ステートメントが実行するまでの待機秒数。 X    
repositoryRequired pureQuery データの取得時または書き込み時にエラーが発生した場合の、pureQuery クライアントの最適化の動作を指定します。つまり、finalRepositoryProperties プロパティーで指定された場所から pureQuery ランタイム・プロパティーおよび pureQueryXML データを取得できない場合、または取り込まれた SQL が保管されているリポジトリーにアクセスできない場合の pureQuery クライアントの最適化の動作を指定します。   X  
sqlLiteralSubstitution リテラルの置換を実行するかどうかを指定します。pureQuery Runtime は、SQL ステートメント内のリテラル値をパラメーター・マーカーで置き換えて、パラメーター化されたバージョンのステートメントを取り込むことを試みます。 X X X
stackTraceDepth SQL ステートメントごとに記録されるスタック・トレース項目の最大数を指定します。 これらの項目は、pureQueryXML ファイルに記録されます。 X X  
traceFile ログの書き込み先の物理ファイルを指定します。 絶対パス、または pureQuery Log ユーティリティーが実行されるディレクトリーを基準とする相対パスを使用できます。 X X X
traceLevel ログ・ファイルに書き込む詳細のレベルを指定します。 X X X
注:
  1. プロパティーは、executionMode プロパティーの値が STATIC である場合にのみ適用されます。
  2. SQL ステートメントのキャプチャー中に、capturedOnly プロパティーを TRUE に設定することはできません。
  3. pureQuery プロパティーは、pureQuery EnhancedDataSource インターフェースまたは DataFactory クラスで使用できます。
    com.ibm.pdq.runtime.datasource Interface EnhancedDataSource
    capturedOnly
    captureMode
    captureStatementBatchSQL
    enableDynamicSQLReplacement
    maxNonParmSQL
    maxStackTracesCaptured
    outputPureQueryXml
    packagePrefixExclusions
    pureQueryXml
    stackTraceDepth
    sqlLiteralSubstitution
    com.ibm.pdq.runtime.factory.DataFactory
    executionMode
    queryTimeoutInSeconds
    maxResultRows

フィードバック